mirror of
https://github.com/WordPress/WordPress.git
synced 2024-11-16 15:46:04 +01:00
d39c16594b
git-svn-id: http://core.svn.wordpress.org/trunk@21542 1a063a9b-81f0-0310-95a4-ce76da25c4cd
392 lines
14 KiB
PHP
392 lines
14 KiB
PHP
<?php
|
|
/**
|
|
* Twenty Twelve functions and definitions
|
|
*
|
|
* Sets up the theme and provides some helper functions. Some helper functions
|
|
* are used in the theme as custom template tags. Others are attached to action and
|
|
* filter hooks in WordPress to change core functionality.
|
|
*
|
|
* The first function, twentytwelve_setup(), sets up the theme by registering support
|
|
* for various features in WordPress, such as a custom background and a navigation menu.
|
|
*
|
|
* When using a child theme (see http://codex.wordpress.org/Theme_Development and
|
|
* http://codex.wordpress.org/Child_Themes), you can override certain functions
|
|
* (those wrapped in a function_exists() call) by defining them first in your child theme's
|
|
* functions.php file. The child theme's functions.php file is included before the parent
|
|
* theme's file, so the child theme functions would be used.
|
|
*
|
|
* Functions that are not pluggable (not wrapped in function_exists()) are instead attached
|
|
* to a filter or action hook.
|
|
*
|
|
* For more information on hooks, actions, and filters, see http://codex.wordpress.org/Plugin_API.
|
|
*
|
|
* @package WordPress
|
|
* @subpackage Twenty_Twelve
|
|
* @since Twenty Twelve 1.0
|
|
*/
|
|
|
|
/**
|
|
* Set the content width based on the theme's design and stylesheet.
|
|
*/
|
|
if ( ! isset( $content_width ) )
|
|
$content_width = 625;
|
|
|
|
/**
|
|
* Sets up theme defaults and registers support for various WordPress features.
|
|
*
|
|
* @uses load_theme_textdomain() For translation/localization support.
|
|
* @uses add_theme_support() To add support for post thumbnails, automatic feed links, custom headers
|
|
* and backgrounds, and post formats.
|
|
* @uses register_nav_menu() To add support for navigation menus.
|
|
* @uses set_post_thumbnail_size() To set a custom post thumbnail size.
|
|
*
|
|
* @since Twenty Twelve 1.0
|
|
*/
|
|
function twentytwelve_setup() {
|
|
global $twentytwelve_options;
|
|
|
|
/**
|
|
* Make Twenty Twelve available for translation.
|
|
* Translations can be added to the /languages/ directory.
|
|
* If you're building a theme based on Twenty Twelve, use a find and replace
|
|
* to change 'twentytwelve' to the name of your theme in all the template files.
|
|
*/
|
|
load_theme_textdomain( 'twentytwelve', get_template_directory() . '/languages' );
|
|
|
|
// Load up our theme options page and related code.
|
|
require( get_template_directory() . '/inc/theme-options.php' );
|
|
$twentytwelve_options = new Twenty_Twelve_Options();
|
|
|
|
// This theme styles the visual editor with editor-style.css to match the theme style.
|
|
add_editor_style();
|
|
|
|
// Add default posts and comments RSS feed links to <head>.
|
|
add_theme_support( 'automatic-feed-links' );
|
|
|
|
// Add support for a variety of post formats
|
|
add_theme_support( 'post-formats', array( 'aside', 'image', 'link', 'quote' ) );
|
|
|
|
// This theme uses wp_nav_menu() in one location.
|
|
register_nav_menu( 'primary', __( 'Primary Menu', 'twentytwelve' ) );
|
|
|
|
// Add support for custom background.
|
|
add_theme_support( 'custom-background', array(
|
|
'default-color' => 'e6e6e6',
|
|
) );
|
|
|
|
// Add custom image size for featured image use, displayed on "standard" posts.
|
|
add_theme_support( 'post-thumbnails' );
|
|
set_post_thumbnail_size( 624, 9999 ); // Unlimited height, soft crop
|
|
}
|
|
add_action( 'after_setup_theme', 'twentytwelve_setup' );
|
|
|
|
/**
|
|
* Add support for a custom header image.
|
|
*/
|
|
require( get_template_directory() . '/inc/custom-header.php' );
|
|
|
|
/**
|
|
* Enqueue scripts and styles for front-end.
|
|
*
|
|
* @since Twenty Twelve 1.0
|
|
*/
|
|
function twentytwelve_scripts_styles() {
|
|
global $twentytwelve_options;
|
|
|
|
/**
|
|
* Add JavaScript to pages with the comment form to support
|
|
* sites with threaded comments (when in use).
|
|
*/
|
|
if ( is_singular() && comments_open() && get_option( 'thread_comments' ) )
|
|
wp_enqueue_script( 'comment-reply' );
|
|
|
|
/**
|
|
* JavaScript for handling navigation menus and the resized
|
|
* styles for small screen sizes.
|
|
*/
|
|
wp_enqueue_script( 'twentytwelve-navigation', get_template_directory_uri() . '/js/theme.js', array( 'jquery' ), '20120802', true );
|
|
|
|
/**
|
|
* Load special font CSS file.
|
|
* Depends on Theme Options setting.
|
|
*/
|
|
$options = $twentytwelve_options->get_theme_options();
|
|
if ( $options['enable_fonts'] )
|
|
wp_enqueue_style( 'twentytwelve-fonts', $twentytwelve_options->custom_fonts_url(), array(), null );
|
|
|
|
/**
|
|
* Load our main CSS file.
|
|
*/
|
|
wp_enqueue_style( 'twentytwelve-style', get_stylesheet_uri() );
|
|
|
|
/**
|
|
* Load HTML5 shiv for older IE version support for HTML5 elements.
|
|
* Ideally, should load after main CSS file.
|
|
*
|
|
* See html5.js link in header.php.
|
|
*
|
|
* TODO depends on IE dependency being in core for JS enqueuing
|
|
* before we can move here properly: see http://core.trac.wordpress.org/ticket/16024
|
|
*/
|
|
}
|
|
add_action( 'wp_enqueue_scripts', 'twentytwelve_scripts_styles' );
|
|
|
|
/**
|
|
* Creates a nicely formatted and more specific title element text
|
|
* for output in head of document, based on current view.
|
|
*
|
|
* @since Twenty Twelve 1.0
|
|
*
|
|
* @param string $title Default title text for current view.
|
|
* @param string $sep Optional separator.
|
|
* @return string Filtered title.
|
|
*/
|
|
function twentytwelve_wp_title( $title, $sep ) {
|
|
global $paged, $page;
|
|
|
|
if ( is_feed() )
|
|
return $title;
|
|
|
|
// Add the blog name.
|
|
$title .= get_bloginfo( 'name' );
|
|
|
|
// Add the blog description for the home/front page.
|
|
$site_description = get_bloginfo( 'description', 'display' );
|
|
if ( $site_description && ( is_home() || is_front_page() ) )
|
|
$title = "$title $sep $site_description";
|
|
|
|
// Add a page number if necessary.
|
|
if ( $paged >= 2 || $page >= 2 )
|
|
$title = "$title $sep " . sprintf( __( 'Page %s', 'twentytwelve' ), max( $paged, $page ) );
|
|
|
|
return $title;
|
|
}
|
|
add_filter( 'wp_title', 'twentytwelve_wp_title', 10, 2 );
|
|
|
|
/**
|
|
* Get our wp_nav_menu() fallback, wp_page_menu(), to show a home link.
|
|
*
|
|
* @since Twenty Twelve 1.0
|
|
*/
|
|
function twentytwelve_page_menu_args( $args ) {
|
|
$args['show_home'] = true;
|
|
return $args;
|
|
}
|
|
add_filter( 'wp_page_menu_args', 'twentytwelve_page_menu_args' );
|
|
|
|
/**
|
|
* Register our single widget area.
|
|
*
|
|
* @since Twenty Twelve 1.0
|
|
*/
|
|
function twentytwelve_widgets_init() {
|
|
register_sidebar( array(
|
|
'name' => __( 'Main Sidebar', 'twentytwelve' ),
|
|
'id' => 'sidebar-1',
|
|
'description' => __( 'Appears on posts and pages except the optional Homepage template, which uses its own set of widgets', 'twentytwelve' ),
|
|
'before_widget' => '<aside id="%1$s" class="widget %2$s">',
|
|
'after_widget' => '</aside>',
|
|
'before_title' => '<h3 class="widget-title">',
|
|
'after_title' => '</h3>',
|
|
) );
|
|
|
|
register_sidebar( array(
|
|
'name' => __( 'Homepage Widgets', 'twentytwelve' ),
|
|
'id' => 'sidebar-home',
|
|
'description' => __( 'Appears when using the optional homepage template with a page set as Static Front Page', 'twentytwelve' ),
|
|
'before_widget' => '<aside id="%1$s" class="widget %2$s">',
|
|
'after_widget' => '</aside>',
|
|
'before_title' => '<h3 class="widget-title">',
|
|
'after_title' => '</h3>',
|
|
) );
|
|
}
|
|
add_action( 'widgets_init', 'twentytwelve_widgets_init' );
|
|
|
|
if ( ! function_exists( 'twentytwelve_content_nav' ) ) :
|
|
/**
|
|
* Display navigation to next/previous pages when applicable.
|
|
*
|
|
* @since Twenty Twelve 1.0
|
|
*/
|
|
function twentytwelve_content_nav( $nav_id ) {
|
|
global $wp_query;
|
|
|
|
if ( $wp_query->max_num_pages > 1 ) : ?>
|
|
<nav id="<?php echo $nav_id; ?>" class="navigation" role="navigation">
|
|
<h3 class="assistive-text"><?php _e( 'Post navigation', 'twentytwelve' ); ?></h3>
|
|
<div class="nav-previous alignleft"><?php next_posts_link( __( '<span class="meta-nav">←</span> Older posts', 'twentytwelve' ) ); ?></div>
|
|
<div class="nav-next alignright"><?php previous_posts_link( __( 'Newer posts <span class="meta-nav">→</span>', 'twentytwelve' ) ); ?></div>
|
|
</nav><!-- #<?php echo $nav_id; ?> .navigation -->
|
|
<?php endif;
|
|
}
|
|
endif;
|
|
|
|
if ( ! function_exists( 'twentytwelve_comment' ) ) :
|
|
/**
|
|
* Template for comments and pingbacks.
|
|
*
|
|
* To override this walker in a child theme without modifying the comments template
|
|
* simply create your own twentytwelve_comment(), and that function will be used instead.
|
|
*
|
|
* Used as a callback by wp_list_comments() for displaying the comments.
|
|
*
|
|
* @since Twenty Twelve 1.0
|
|
*/
|
|
function twentytwelve_comment( $comment, $args, $depth ) {
|
|
$GLOBALS['comment'] = $comment;
|
|
switch ( $comment->comment_type ) :
|
|
case 'pingback' :
|
|
case 'trackback' :
|
|
// Display trackbacks differently than normal comments.
|
|
?>
|
|
<li <?php comment_class(); ?> id="comment-<?php comment_ID(); ?>">
|
|
<p><?php _e( 'Pingback:', 'twentytwelve' ); ?> <?php comment_author_link(); ?> <?php edit_comment_link( __( '(Edit)', 'twentytwelve' ), '<span class="edit-link">', '</span>' ); ?></p>
|
|
<?php
|
|
break;
|
|
default :
|
|
// Proceed with normal comments.
|
|
global $post;
|
|
?>
|
|
<li <?php comment_class(); ?> id="li-comment-<?php comment_ID(); ?>">
|
|
<article id="comment-<?php comment_ID(); ?>" class="comment">
|
|
<header class="comment-meta comment-author vcard">
|
|
<?php
|
|
echo get_avatar( $comment, 44 );
|
|
printf( '<cite class="fn">%1$s %2$s</cite>',
|
|
get_comment_author_link(),
|
|
// If current post author is also comment author, make it known visually.
|
|
( $comment->user_id === $post->post_author ) ? '<span> ' . __( 'Post author', 'twentytwelve' ) . '</span>' : ''
|
|
);
|
|
printf( '<a href="%1$s"><time pubdate datetime="%2$s">%3$s</time></a>',
|
|
esc_url( get_comment_link( $comment->comment_ID ) ),
|
|
get_comment_time( 'c' ),
|
|
/* translators: 1: date, 2: time */
|
|
sprintf( __( '%1$s at %2$s', 'twentytwelve' ), get_comment_date(), get_comment_time() )
|
|
);
|
|
?>
|
|
</header>
|
|
|
|
<?php if ( '0' == $comment->comment_approved ) : ?>
|
|
<p class="comment-awaiting-moderation"><?php _e( 'Your comment is awaiting moderation.', 'twentytwelve' ); ?></p>
|
|
<?php endif; ?>
|
|
|
|
<section class="comment comment-content">
|
|
<?php comment_text(); ?>
|
|
<?php edit_comment_link( __( 'Edit', 'twentytwelve' ), '<p class="edit-link">', '</p>' ); ?>
|
|
</section>
|
|
|
|
<div class="reply">
|
|
<?php comment_reply_link( array_merge( $args, array( 'reply_text' => __( 'Reply <span>↓</span>', 'twentytwelve' ), 'depth' => $depth, 'max_depth' => $args['max_depth'] ) ) ); ?>
|
|
</div><!-- .reply -->
|
|
</article><!-- #comment-## -->
|
|
<?php
|
|
break;
|
|
endswitch; // end comment_type check
|
|
}
|
|
endif;
|
|
|
|
if ( ! function_exists( 'twentytwelve_entry_meta' ) ) :
|
|
/**
|
|
* Prints HTML with meta information for current post: categories, tags, permalink, author, and date.
|
|
*
|
|
* Create your own twentytwelve_entry_meta() to override in a child theme.
|
|
*
|
|
* @since Twenty Twelve 1.0
|
|
*/
|
|
function twentytwelve_entry_meta() {
|
|
// Translators: used between list items, there is a space after the comma.
|
|
$categories_list = get_the_category_list( __( ', ', 'twentytwelve' ) );
|
|
|
|
// Translators: used between list items, there is a space after the comma.
|
|
$tag_list = get_the_tag_list( '', __( ', ', 'twentytwelve' ) );
|
|
|
|
$date = sprintf( '<a href="%1$s" title="%2$s" rel="bookmark"><time class="entry-date" datetime="%3$s" pubdate>%4$s</time></a>',
|
|
esc_url( get_permalink() ),
|
|
esc_attr( get_the_time() ),
|
|
esc_attr( get_the_date( 'c' ) ),
|
|
esc_html( get_the_date() )
|
|
);
|
|
|
|
$author = sprintf( '<span class="author vcard"><a class="url fn n" href="%1$s" title="%2$s" rel="author">%3$s</a></span>',
|
|
esc_url( get_author_posts_url( get_the_author_meta( 'ID' ) ) ),
|
|
esc_attr( sprintf( __( 'View all posts by %s', 'twentytwelve' ), get_the_author() ) ),
|
|
get_the_author()
|
|
);
|
|
|
|
// Translators: 1 is category, 2 is tag, 3 is the date and 4 is the author's name.
|
|
if ( '' != $tag_list ) {
|
|
$utility_text = __( 'This entry was posted in %1$s and tagged %2$s on %3$s by %4$s.', 'twentytwelve' );
|
|
} elseif ( ! empty( $categories_list ) && twentytwelve_is_categorized_site() ) {
|
|
$utility_text = __( 'This entry was posted in %1$s on %3$s by %4$s.', 'twentytwelve' );
|
|
} else {
|
|
$utility_text = __( 'This entry was posted on %3$s by %4$s.', 'twentytwelve' );
|
|
}
|
|
|
|
printf(
|
|
$utility_text,
|
|
$categories_list,
|
|
$tag_list,
|
|
$date,
|
|
$author
|
|
);
|
|
}
|
|
endif;
|
|
|
|
if ( ! function_exists( 'twentytwelve_is_categorized_site' ) ) :
|
|
/**
|
|
* Returns true if a blog has more than one category.
|
|
*
|
|
* @since Twenty Twelve 1.0
|
|
*/
|
|
function twentytwelve_is_categorized_site() {
|
|
$non_empty_categories = get_categories( array(
|
|
'hide_empty' => 1,
|
|
) );
|
|
|
|
if ( is_wp_error( $non_empty_categories ) || empty( $non_empty_categories ) || count( $non_empty_categories ) < 1 )
|
|
return false;
|
|
|
|
return true;
|
|
}
|
|
endif;
|
|
|
|
/**
|
|
* Extends the default WordPress body class to denote:
|
|
* 1. Using a full-width layout, when no active widgets in the sidebar
|
|
* or full-width template.
|
|
* 2. A thumbnail in the Homepage page template.
|
|
* 3. White or empty background color to change the layout and spacing.
|
|
*
|
|
* @since Twenty Twelve 1.0
|
|
*/
|
|
function twentytwelve_body_class( $classes ) {
|
|
$background_color = get_background_color();
|
|
|
|
if ( ! is_active_sidebar( 'sidebar-1' ) || is_page_template( 'full-width-page.php' ) )
|
|
$classes[] = 'full-width';
|
|
|
|
if ( is_page_template( 'homepage.php' ) && has_post_thumbnail() )
|
|
$classes[] = 'has-post-thumbnail';
|
|
|
|
if ( empty( $background_color ) )
|
|
$classes[] = 'custom-background-empty';
|
|
elseif ( in_array( $background_color, array( 'fff', 'ffffff' ) ) )
|
|
$classes[] = 'custom-background-white';
|
|
|
|
return $classes;
|
|
}
|
|
add_filter( 'body_class', 'twentytwelve_body_class' );
|
|
|
|
/**
|
|
* Adjust $content width for full-width and single image attachment templates
|
|
* and when there are no active widgets in the sidebar.
|
|
*
|
|
* @since Twenty Twelve 1.0
|
|
*/
|
|
function twentytwelve_content_width() {
|
|
if ( is_page_template( 'full-width-page.php' ) || is_attachment() || ! is_active_sidebar( 'sidebar-1' ) ) {
|
|
global $content_width;
|
|
$content_width = 960;
|
|
}
|
|
}
|
|
add_action( 'template_redirect', 'twentytwelve_content_width' );
|