3 * Twenty Twelve functions and definitions
5 * Sets up the theme and provides some helper functions, which are used
6 * in the theme as custom template tags. Others are attached to action and
7 * filter hooks in WordPress to change core functionality.
9 * When using a child theme (see http://codex.wordpress.org/Theme_Development and
10 * http://codex.wordpress.org/Child_Themes), you can override certain functions
11 * (those wrapped in a function_exists() call) by defining them first in your child theme's
12 * functions.php file. The child theme's functions.php file is included before the parent
13 * theme's file, so the child theme functions would be used.
15 * Functions that are not pluggable (not wrapped in function_exists()) are instead attached
16 * to a filter or action hook.
18 * For more information on hooks, actions, and filters, @link http://codex.wordpress.org/Plugin_API
21 * @subpackage Twenty_Twelve
22 * @since Twenty Twelve 1.0
25 // Set up the content width value based on the theme's design and stylesheet.
26 if ( ! isset( $content_width ) )
30 * Twenty Twelve setup.
32 * Sets up theme defaults and registers the various WordPress features that
33 * Twenty Twelve supports.
35 * @uses load_theme_textdomain() For translation/localization support.
36 * @uses add_editor_style() To add a Visual Editor stylesheet.
37 * @uses add_theme_support() To add support for post thumbnails, automatic feed links,
38 * custom background, and post formats.
39 * @uses register_nav_menu() To add support for navigation menus.
40 * @uses set_post_thumbnail_size() To set a custom post thumbnail size.
42 * @since Twenty Twelve 1.0
44 function twentytwelve_setup() {
46 * Makes Twenty Twelve available for translation.
48 * Translations can be added to the /languages/ directory.
49 * If you're building a theme based on Twenty Twelve, use a find and replace
50 * to change 'twentytwelve' to the name of your theme in all the template files.
52 load_theme_textdomain( 'twentytwelve', get_template_directory() . '/languages' );
54 // This theme styles the visual editor with editor-style.css to match the theme style.
57 // Adds RSS feed links to <head> for posts and comments.
58 add_theme_support( 'automatic-feed-links' );
60 // This theme supports a variety of post formats.
61 add_theme_support( 'post-formats', array( 'aside', 'image', 'link', 'quote', 'status' ) );
63 // This theme uses wp_nav_menu() in one location.
64 register_nav_menu( 'primary', __( 'Primary Menu', 'twentytwelve' ) );
67 * This theme supports custom background color and image,
68 * and here we also set up the default background color.
70 add_theme_support( 'custom-background', array(
71 'default-color' => 'e6e6e6',
74 // This theme uses a custom image size for featured images, displayed on "standard" posts.
75 add_theme_support( 'post-thumbnails' );
76 set_post_thumbnail_size( 624, 9999 ); // Unlimited height, soft crop
78 add_action( 'after_setup_theme', 'twentytwelve_setup' );
81 * Add support for a custom header image.
83 require( get_template_directory() . '/inc/custom-header.php' );
86 * Return the Google font stylesheet URL if available.
88 * The use of Open Sans by default is localized. For languages that use
89 * characters not supported by the font, the font can be disabled.
91 * @since Twenty Twelve 1.2
93 * @return string Font stylesheet or empty string if disabled.
95 function twentytwelve_get_font_url() {
98 /* translators: If there are characters in your language that are not supported
99 * by Open Sans, translate this to 'off'. Do not translate into your own language.
101 if ( 'off' !== _x( 'on', 'Open Sans font: on or off', 'twentytwelve' ) ) {
102 $subsets = 'latin,latin-ext';
104 /* translators: To add an additional Open Sans character subset specific to your language,
105 * translate this to 'greek', 'cyrillic' or 'vietnamese'. Do not translate into your own language.
107 $subset = _x( 'no-subset', 'Open Sans font: add new subset (greek, cyrillic, vietnamese)', 'twentytwelve' );
109 if ( 'cyrillic' == $subset )
110 $subsets .= ',cyrillic,cyrillic-ext';
111 elseif ( 'greek' == $subset )
112 $subsets .= ',greek,greek-ext';
113 elseif ( 'vietnamese' == $subset )
114 $subsets .= ',vietnamese';
116 $protocol = is_ssl() ? 'https' : 'http';
118 'family' => 'Open+Sans:400italic,700italic,400,700',
119 'subset' => $subsets,
121 $font_url = add_query_arg( $query_args, "$protocol://fonts.googleapis.com/css" );
128 * Enqueue scripts and styles for front-end.
130 * @since Twenty Twelve 1.0
132 function twentytwelve_scripts_styles() {
136 * Adds JavaScript to pages with the comment form to support
137 * sites with threaded comments (when in use).
139 if ( is_singular() && comments_open() && get_option( 'thread_comments' ) )
140 wp_enqueue_script( 'comment-reply' );
142 // Adds JavaScript for handling the navigation menu hide-and-show behavior.
143 wp_enqueue_script( 'twentytwelve-navigation', get_template_directory_uri() . '/js/navigation.js', array( 'jquery' ), '20140318', true );
145 $font_url = twentytwelve_get_font_url();
146 if ( ! empty( $font_url ) )
147 wp_enqueue_style( 'twentytwelve-fonts', esc_url_raw( $font_url ), array(), null );
149 // Loads our main stylesheet.
150 wp_enqueue_style( 'twentytwelve-style', get_stylesheet_uri() );
152 // Loads the Internet Explorer specific stylesheet.
153 wp_enqueue_style( 'twentytwelve-ie', get_template_directory_uri() . '/css/ie.css', array( 'twentytwelve-style' ), '20121010' );
154 $wp_styles->add_data( 'twentytwelve-ie', 'conditional', 'lt IE 9' );
156 add_action( 'wp_enqueue_scripts', 'twentytwelve_scripts_styles' );
159 * Filter TinyMCE CSS path to include Google Fonts.
161 * Adds additional stylesheets to the TinyMCE editor if needed.
163 * @uses twentytwelve_get_font_url() To get the Google Font stylesheet URL.
165 * @since Twenty Twelve 1.2
167 * @param string $mce_css CSS path to load in TinyMCE.
168 * @return string Filtered CSS path.
170 function twentytwelve_mce_css( $mce_css ) {
171 $font_url = twentytwelve_get_font_url();
173 if ( empty( $font_url ) )
176 if ( ! empty( $mce_css ) )
179 $mce_css .= esc_url_raw( str_replace( ',', '%2C', $font_url ) );
183 add_filter( 'mce_css', 'twentytwelve_mce_css' );
186 * Filter the page title.
188 * Creates a nicely formatted and more specific title element text
189 * for output in head of document, based on current view.
191 * @since Twenty Twelve 1.0
193 * @param string $title Default title text for current view.
194 * @param string $sep Optional separator.
195 * @return string Filtered title.
197 function twentytwelve_wp_title( $title, $sep ) {
198 global $paged, $page;
203 // Add the site name.
204 $title .= get_bloginfo( 'name', 'display' );
206 // Add the site description for the home/front page.
207 $site_description = get_bloginfo( 'description', 'display' );
208 if ( $site_description && ( is_home() || is_front_page() ) )
209 $title = "$title $sep $site_description";
211 // Add a page number if necessary.
212 if ( $paged >= 2 || $page >= 2 )
213 $title = "$title $sep " . sprintf( __( 'Page %s', 'twentytwelve' ), max( $paged, $page ) );
217 add_filter( 'wp_title', 'twentytwelve_wp_title', 10, 2 );
220 * Filter the page menu arguments.
222 * Makes our wp_nav_menu() fallback -- wp_page_menu() -- show a home link.
224 * @since Twenty Twelve 1.0
226 function twentytwelve_page_menu_args( $args ) {
227 if ( ! isset( $args['show_home'] ) )
228 $args['show_home'] = true;
231 add_filter( 'wp_page_menu_args', 'twentytwelve_page_menu_args' );
236 * Registers our main widget area and the front page widget areas.
238 * @since Twenty Twelve 1.0
240 function twentytwelve_widgets_init() {
241 register_sidebar( array(
242 'name' => __( 'Main Sidebar', 'twentytwelve' ),
244 'description' => __( 'Appears on posts and pages except the optional Front Page template, which has its own widgets', 'twentytwelve' ),
245 'before_widget' => '<aside id="%1$s" class="widget %2$s">',
246 'after_widget' => '</aside>',
247 'before_title' => '<h3 class="widget-title">',
248 'after_title' => '</h3>',
251 register_sidebar( array(
252 'name' => __( 'First Front Page Widget Area', 'twentytwelve' ),
254 'description' => __( 'Appears when using the optional Front Page template with a page set as Static Front Page', 'twentytwelve' ),
255 'before_widget' => '<aside id="%1$s" class="widget %2$s">',
256 'after_widget' => '</aside>',
257 'before_title' => '<h3 class="widget-title">',
258 'after_title' => '</h3>',
261 register_sidebar( array(
262 'name' => __( 'Second Front Page Widget Area', 'twentytwelve' ),
264 'description' => __( 'Appears when using the optional Front Page template with a page set as Static Front Page', 'twentytwelve' ),
265 'before_widget' => '<aside id="%1$s" class="widget %2$s">',
266 'after_widget' => '</aside>',
267 'before_title' => '<h3 class="widget-title">',
268 'after_title' => '</h3>',
271 add_action( 'widgets_init', 'twentytwelve_widgets_init' );
273 if ( ! function_exists( 'twentytwelve_content_nav' ) ) :
275 * Displays navigation to next/previous pages when applicable.
277 * @since Twenty Twelve 1.0
279 function twentytwelve_content_nav( $html_id ) {
282 $html_id = esc_attr( $html_id );
284 if ( $wp_query->max_num_pages > 1 ) : ?>
285 <nav id="<?php echo $html_id; ?>" class="navigation" role="navigation">
286 <h3 class="assistive-text"><?php _e( 'Post navigation', 'twentytwelve' ); ?></h3>
287 <div class="nav-previous"><?php next_posts_link( __( '<span class="meta-nav">←</span> Older posts', 'twentytwelve' ) ); ?></div>
288 <div class="nav-next"><?php previous_posts_link( __( 'Newer posts <span class="meta-nav">→</span>', 'twentytwelve' ) ); ?></div>
289 </nav><!-- #<?php echo $html_id; ?> .navigation -->
294 if ( ! function_exists( 'twentytwelve_comment' ) ) :
296 * Template for comments and pingbacks.
298 * To override this walker in a child theme without modifying the comments template
299 * simply create your own twentytwelve_comment(), and that function will be used instead.
301 * Used as a callback by wp_list_comments() for displaying the comments.
303 * @since Twenty Twelve 1.0
305 function twentytwelve_comment( $comment, $args, $depth ) {
306 $GLOBALS['comment'] = $comment;
307 switch ( $comment->comment_type ) :
310 // Display trackbacks differently than normal comments.
312 <li <?php comment_class(); ?> id="comment-<?php comment_ID(); ?>">
313 <p><?php _e( 'Pingback:', 'twentytwelve' ); ?> <?php comment_author_link(); ?> <?php edit_comment_link( __( '(Edit)', 'twentytwelve' ), '<span class="edit-link">', '</span>' ); ?></p>
317 // Proceed with normal comments.
320 <li <?php comment_class(); ?> id="li-comment-<?php comment_ID(); ?>">
321 <article id="comment-<?php comment_ID(); ?>" class="comment">
322 <header class="comment-meta comment-author vcard">
324 echo get_avatar( $comment, 44 );
325 printf( '<cite><b class="fn">%1$s</b> %2$s</cite>',
326 get_comment_author_link(),
327 // If current post author is also comment author, make it known visually.
328 ( $comment->user_id === $post->post_author ) ? '<span>' . __( 'Post author', 'twentytwelve' ) . '</span>' : ''
330 printf( '<a href="%1$s"><time datetime="%2$s">%3$s</time></a>',
331 esc_url( get_comment_link( $comment->comment_ID ) ),
332 get_comment_time( 'c' ),
333 /* translators: 1: date, 2: time */
334 sprintf( __( '%1$s at %2$s', 'twentytwelve' ), get_comment_date(), get_comment_time() )
337 </header><!-- .comment-meta -->
339 <?php if ( '0' == $comment->comment_approved ) : ?>
340 <p class="comment-awaiting-moderation"><?php _e( 'Your comment is awaiting moderation.', 'twentytwelve' ); ?></p>
343 <section class="comment-content comment">
344 <?php comment_text(); ?>
345 <?php edit_comment_link( __( 'Edit', 'twentytwelve' ), '<p class="edit-link">', '</p>' ); ?>
346 </section><!-- .comment-content -->
349 <?php comment_reply_link( array_merge( $args, array( 'reply_text' => __( 'Reply', 'twentytwelve' ), 'after' => ' <span>↓</span>', 'depth' => $depth, 'max_depth' => $args['max_depth'] ) ) ); ?>
350 </div><!-- .reply -->
351 </article><!-- #comment-## -->
354 endswitch; // end comment_type check
358 if ( ! function_exists( 'twentytwelve_entry_meta' ) ) :
360 * Set up post entry meta.
362 * Prints HTML with meta information for current post: categories, tags, permalink, author, and date.
364 * Create your own twentytwelve_entry_meta() to override in a child theme.
366 * @since Twenty Twelve 1.0
368 function twentytwelve_entry_meta() {
369 // Translators: used between list items, there is a space after the comma.
370 $categories_list = get_the_category_list( __( ', ', 'twentytwelve' ) );
372 // Translators: used between list items, there is a space after the comma.
373 $tag_list = get_the_tag_list( '', __( ', ', 'twentytwelve' ) );
375 $date = sprintf( '<a href="%1$s" title="%2$s" rel="bookmark"><time class="entry-date" datetime="%3$s">%4$s</time></a>',
376 esc_url( get_permalink() ),
377 esc_attr( get_the_time() ),
378 esc_attr( get_the_date( 'c' ) ),
379 esc_html( get_the_date() )
382 $author = sprintf( '<span class="author vcard"><a class="url fn n" href="%1$s" title="%2$s" rel="author">%3$s</a></span>',
383 esc_url( get_author_posts_url( get_the_author_meta( 'ID' ) ) ),
384 esc_attr( sprintf( __( 'View all posts by %s', 'twentytwelve' ), get_the_author() ) ),
388 // Translators: 1 is category, 2 is tag, 3 is the date and 4 is the author's name.
390 $utility_text = __( 'This entry was posted in %1$s and tagged %2$s on %3$s<span class="by-author"> by %4$s</span>.', 'twentytwelve' );
391 } elseif ( $categories_list ) {
392 $utility_text = __( 'This entry was posted in %1$s on %3$s<span class="by-author"> by %4$s</span>.', 'twentytwelve' );
394 $utility_text = __( 'This entry was posted on %3$s<span class="by-author"> by %4$s</span>.', 'twentytwelve' );
408 * Extend the default WordPress body classes.
410 * Extends the default WordPress body class to denote:
411 * 1. Using a full-width layout, when no active widgets in the sidebar
412 * or full-width template.
413 * 2. Front Page template: thumbnail in use and number of sidebars for
415 * 3. White or empty background color to change the layout and spacing.
416 * 4. Custom fonts enabled.
417 * 5. Single or multiple authors.
419 * @since Twenty Twelve 1.0
421 * @param array $classes Existing class values.
422 * @return array Filtered class values.
424 function twentytwelve_body_class( $classes ) {
425 $background_color = get_background_color();
426 $background_image = get_background_image();
428 if ( ! is_active_sidebar( 'sidebar-1' ) || is_page_template( 'page-templates/full-width.php' ) )
429 $classes[] = 'full-width';
431 if ( is_page_template( 'page-templates/front-page.php' ) ) {
432 $classes[] = 'template-front-page';
433 if ( has_post_thumbnail() )
434 $classes[] = 'has-post-thumbnail';
435 if ( is_active_sidebar( 'sidebar-2' ) && is_active_sidebar( 'sidebar-3' ) )
436 $classes[] = 'two-sidebars';
439 if ( empty( $background_image ) ) {
440 if ( empty( $background_color ) )
441 $classes[] = 'custom-background-empty';
442 elseif ( in_array( $background_color, array( 'fff', 'ffffff' ) ) )
443 $classes[] = 'custom-background-white';
446 // Enable custom font class only if the font CSS is queued to load.
447 if ( wp_style_is( 'twentytwelve-fonts', 'queue' ) )
448 $classes[] = 'custom-font-enabled';
450 if ( ! is_multi_author() )
451 $classes[] = 'single-author';
455 add_filter( 'body_class', 'twentytwelve_body_class' );
458 * Adjust content width in certain contexts.
460 * Adjusts content_width value for full-width and single image attachment
461 * templates, and when there are no active widgets in the sidebar.
463 * @since Twenty Twelve 1.0
465 function twentytwelve_content_width() {
466 if ( is_page_template( 'page-templates/full-width.php' ) || is_attachment() || ! is_active_sidebar( 'sidebar-1' ) ) {
467 global $content_width;
468 $content_width = 960;
471 add_action( 'template_redirect', 'twentytwelve_content_width' );
474 * Register postMessage support.
476 * Add postMessage support for site title and description for the Customizer.
478 * @since Twenty Twelve 1.0
480 * @param WP_Customize_Manager $wp_customize Customizer object.
482 function twentytwelve_customize_register( $wp_customize ) {
483 $wp_customize->get_setting( 'blogname' )->transport = 'postMessage';
484 $wp_customize->get_setting( 'blogdescription' )->transport = 'postMessage';
485 $wp_customize->get_setting( 'header_textcolor' )->transport = 'postMessage';
487 add_action( 'customize_register', 'twentytwelve_customize_register' );
490 * Enqueue Javascript postMessage handlers for the Customizer.
492 * Binds JS handlers to make the Customizer preview reload changes asynchronously.
494 * @since Twenty Twelve 1.0
496 function twentytwelve_customize_preview_js() {
497 wp_enqueue_script( 'twentytwelve-customizer', get_template_directory_uri() . '/js/theme-customizer.js', array( 'customize-preview' ), '20130301', true );
499 add_action( 'customize_preview_init', 'twentytwelve_customize_preview_js' );