Ticket #25257: 25257.diff

src/wp-content/themes/twentyfourteen/archive.php

@@ -45 +45 @@
                         </header><!-- .page-header -->
 
                         <?php
-                                        while ( have_posts() ) :
-                                                the_post();
+                                        // Start the Loop.
+                                        while ( have_posts() ) : the_post();
 
+                                                /*
+                                                 * Include the post format-specific template for the content. If you want to
+                                                 * use this in a child theme, then include a file called called content-___.php
+                                                 * (where ___ is the post format) and that will be used instead.
+                                                 */
                                                 get_template_part( 'content', get_post_format() );
+
                                         endwhile;
+                                        // Previous/next page navigation.
                                         twentyfourteen_paging_nav();
 
                                 else :
+                                        // If no content, include the "No posts found" template.
                                         get_template_part( 'content', 'none' );
 
                                 endif;

src/wp-content/themes/twentyfourteen/author.php

@@ -45 +45 @@
                                          */
                                         rewind_posts();
 
-                                        while ( have_posts() ) :
-                                                the_post();
+                                        // Start the Loop.
+                                        while ( have_posts() ) : the_post();
 
+                                                /*
+                                                 * Include the post format-specific template for the content. If you want to
+                                                 * use this in a child theme, then include a file called called content-___.php
+                                                 * (where ___ is the post format) and that will be used instead.
+                                                 */
                                                 get_template_part( 'content', get_post_format() );
+
                                         endwhile;
+                                        // Previous/next page navigation.
                                         twentyfourteen_paging_nav();
 
                                 else :
+                                        // If no content, include the "No posts found" template.
                                         get_template_part( 'content', 'none' );
 
                                 endif;

src/wp-content/themes/twentyfourteen/category.php

@@ -29 +29 @@
                         </header><!-- .archive-header -->
 
                         <?php
-                                        while ( have_posts() ) :
-                                                the_post();
+                                        // Start the Loop.
+                                        while ( have_posts() ) : the_post();
 
-                                                get_template_part( 'content', get_post_format() );
+                                        /*
+                                         * Include the post format-specific template for the content. If you want to
+                                         * use this in a child theme, then include a file called called content-___.php
+                                         * (where ___ is the post format) and that will be used instead.
+                                         */
+                                        get_template_part( 'content', get_post_format() );
+
                                         endwhile;
+                                        // Previous/next page navigation.
                                         twentyfourteen_paging_nav();
 
                                 else :
+                                        // If no content, include the "No posts found" template.
                                         get_template_part( 'content', 'none' );
 
                                 endif;

src/wp-content/themes/twentyfourteen/comments.php

@@ -25 +25 @@
         <h2 class="comments-title">
                 <?php
                         printf( _n( 'One thought on &ldquo;%2$s&rdquo;', '%1$s thoughts on &ldquo;%2$s&rdquo;', get_comments_number(), 'twentyfourteen' ),
-                                number_format_i18n( get_comments_number() ), get_the_title() );
+                                number_format_i18n( get_comments_number() ),
+                                get_the_title()
+                        );
                 ?>
         </h2>
 
         <?php if ( get_comment_pages_count() > 1 && get_option( 'page_comments' ) ) : ?>
-        <nav id="comment-nav-above" class="navigation comment-navigation" role="navigation">
-                <h1 class="screen-reader-text"><?php _e( 'Comment navigation', 'twentyfourteen' ); ?></h1>
-                <div class="nav-previous"><?php previous_comments_link( __( '&larr; Older Comments', 'twentyfourteen' ) ); ?></div>
-                <div class="nav-next"><?php next_comments_link( __( 'Newer Comments &rarr;', 'twentyfourteen' ) ); ?></div>
-        </nav><!-- #comment-nav-above -->
+                <nav id="comment-nav-above" class="navigation comment-navigation" role="navigation">
+                        <h1 class="screen-reader-text"><?php _e( 'Comment navigation', 'twentyfourteen' ); ?></h1>
+                        <div class="nav-previous"><?php previous_comments_link( __( '&larr; Older Comments', 'twentyfourteen' ) ); ?></div>
+                        <div class="nav-next"><?php next_comments_link( __( 'Newer Comments &rarr;', 'twentyfourteen' ) ); ?></div>
+                </nav><!-- #comment-nav-above -->
         <?php endif; // Check for comment navigation. ?>
 
         <ol class="comment-list">
@@ -48 +50 @@
         </ol><!-- .comment-list -->
 
         <?php if ( get_comment_pages_count() > 1 && get_option( 'page_comments' ) ) : ?>
-        <nav id="comment-nav-below" class="navigation comment-navigation" role="navigation">
-                <h1 class="screen-reader-text"><?php _e( 'Comment navigation', 'twentyfourteen' ); ?></h1>
-                <div class="nav-previous"><?php previous_comments_link( __( '&larr; Older Comments', 'twentyfourteen' ) ); ?></div>
-                <div class="nav-next"><?php next_comments_link( __( 'Newer Comments &rarr;', 'twentyfourteen' ) ); ?></div>
-        </nav><!-- #comment-nav-below -->
+                <nav id="comment-nav-below" class="navigation comment-navigation" role="navigation">
+                        <h1 class="screen-reader-text"><?php _e( 'Comment navigation', 'twentyfourteen' ); ?></h1>
+                        <div class="nav-previous"><?php previous_comments_link( __( '&larr; Older Comments', 'twentyfourteen' ) ); ?></div>
+                        <div class="nav-next"><?php next_comments_link( __( 'Newer Comments &rarr;', 'twentyfourteen' ) ); ?></div>
+                </nav><!-- #comment-nav-below -->
         <?php endif; // Check for comment navigation. ?>
 
         <?php if ( ! comments_open() ) : ?>
-        <p class="no-comments"><?php _e( 'Comments are closed.', 'twentyfourteen' ); ?></p>
+                <p class="no-comments"><?php _e( 'Comments are closed.', 'twentyfourteen' ); ?></p>
         <?php endif; ?>
 
         <?php endif; // have_comments() ?>

src/wp-content/themes/twentyfourteen/content-aside.php

@@ -34 +34 @@
                         <?php twentyfourteen_posted_on(); ?>
 
                         <?php if ( ! post_password_required() && ( comments_open() || get_comments_number() ) ) : ?>
-                        <span class="comments-link"><?php comments_popup_link( __( 'Leave a comment', 'twentyfourteen' ), __( '1 Comment', 'twentyfourteen' ), __( '% Comments', 'twentyfourteen' ) ); ?></span>
+                                <span class="comments-link"><?php comments_popup_link( __( 'Leave a comment', 'twentyfourteen' ), __( '1 Comment', 'twentyfourteen' ), __( '% Comments', 'twentyfourteen' ) ); ?></span>
                         <?php endif; ?>
 
                         <?php edit_post_link( __( 'Edit', 'twentyfourteen' ), '<span class="edit-link">', '</span>' ); ?>

src/wp-content/themes/twentyfourteen/content-audio.php

@@ -34 +34 @@
                         <?php twentyfourteen_posted_on(); ?>
 
                         <?php if ( ! post_password_required() && ( comments_open() || get_comments_number() ) ) : ?>
-                        <span class="comments-link"><?php comments_popup_link( __( 'Leave a comment', 'twentyfourteen' ), __( '1 Comment', 'twentyfourteen' ), __( '% Comments', 'twentyfourteen' ) ); ?></span>
+                                <span class="comments-link"><?php comments_popup_link( __( 'Leave a comment', 'twentyfourteen' ), __( '1 Comment', 'twentyfourteen' ), __( '% Comments', 'twentyfourteen' ) ); ?></span>
                         <?php endif; ?>
 
                         <?php edit_post_link( __( 'Edit', 'twentyfourteen' ), '<span class="edit-link">', '</span>' ); ?>

src/wp-content/themes/twentyfourteen/content-featured-post.php

@@ -11 +11 @@
 <article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
         <a class="post-thumbnail" href="<?php the_permalink(); ?>" rel="<?php the_ID(); ?>">
         <?php
+                // Output the featured image.
                 if ( has_post_thumbnail() ) :
                         if ( 'grid' == get_theme_mod( 'featured_content_layout' ) ) {
                                 the_post_thumbnail();
@@ -23 +24 @@
 
         <header class="entry-header">
                 <?php if ( in_array( 'category', get_object_taxonomies( get_post_type() ) ) && twentyfourteen_categorized_blog() ) : ?>
-                <div class="entry-meta">
-                        <span class="cat-links"><?php echo get_the_category_list( _x( ', ', 'Used between list items, there is a space after the comma.', 'twentyfourteen' ) ); ?></span>
-                </div><!-- .entry-meta -->
+                        <div class="entry-meta">
+                                <span class="cat-links"><?php echo get_the_category_list( _x( ', ', 'Used between list items, there is a space after the comma.', 'twentyfourteen' ) ); ?></span>
+                        </div><!-- .entry-meta -->
                 <?php endif; ?>
 
                 <?php the_title( '<h1 class="entry-title"><a href="' . esc_url( get_permalink() ) . '" rel="bookmark">','</a></h1>' ); ?>

src/wp-content/themes/twentyfourteen/content-gallery.php

@@ -13 +13 @@
 
         <header class="entry-header">
                 <?php if ( in_array( 'category', get_object_taxonomies( get_post_type() ) ) && twentyfourteen_categorized_blog() ) : ?>
-                <div class="entry-meta">
-                        <span class="cat-links"><?php echo get_the_category_list( _x( ', ', 'Used between list items, there is a space after the comma.', 'twentyfourteen' ) ); ?></span>
-                </div><!-- .entry-meta -->
+                        <div class="entry-meta">
+                                <span class="cat-links"><?php echo get_the_category_list( _x( ', ', 'Used between list items, there is a space after the comma.', 'twentyfourteen' ) ); ?></span>
+                        </div><!-- .entry-meta -->
                 <?php
-                        endif;
+                endif;
 
                         if ( is_single() ) :
                                 the_title( '<h1 class="entry-title">', '</h1>' );
@@ -34 +34 @@
                         <?php twentyfourteen_posted_on(); ?>
 
                         <?php if ( ! post_password_required() && ( comments_open() || get_comments_number() ) ) : ?>
-                        <span class="comments-link"><?php comments_popup_link( __( 'Leave a comment', 'twentyfourteen' ), __( '1 Comment', 'twentyfourteen' ), __( '% Comments', 'twentyfourteen' ) ); ?></span>
+                                <span class="comments-link"><?php comments_popup_link( __( 'Leave a comment', 'twentyfourteen' ), __( '1 Comment', 'twentyfourteen' ), __( '% Comments', 'twentyfourteen' ) ); ?></span>
                         <?php endif; ?>
 
                         <?php edit_post_link( __( 'Edit', 'twentyfourteen' ), '<span class="edit-link">', '</span>' ); ?>

src/wp-content/themes/twentyfourteen/content-image.php

@@ -13 +13 @@
 
         <header class="entry-header">
                 <?php if ( in_array( 'category', get_object_taxonomies( get_post_type() ) ) && twentyfourteen_categorized_blog() ) : ?>
-                <div class="entry-meta">
-                        <span class="cat-links"><?php echo get_the_category_list( _x( ', ', 'Used between list items, there is a space after the comma.', 'twentyfourteen' ) ); ?></span>
-                </div><!-- .entry-meta -->
+                        <div class="entry-meta">
+                                <span class="cat-links"><?php echo get_the_category_list( _x( ', ', 'Used between list items, there is a space after the comma.', 'twentyfourteen' ) ); ?></span>
+                        </div><!-- .entry-meta -->
                 <?php
                         endif;
 
@@ -34 +34 @@
                         <?php twentyfourteen_posted_on(); ?>
 
                         <?php if ( ! post_password_required() && ( comments_open() || get_comments_number() ) ) : ?>
-                        <span class="comments-link"><?php comments_popup_link( __( 'Leave a comment', 'twentyfourteen' ), __( '1 Comment', 'twentyfourteen' ), __( '% Comments', 'twentyfourteen' ) ); ?></span>
+                                <span class="comments-link"><?php comments_popup_link( __( 'Leave a comment', 'twentyfourteen' ), __( '1 Comment', 'twentyfourteen' ), __( '% Comments', 'twentyfourteen' ) ); ?></span>
                         <?php endif; ?>
 
                         <?php edit_post_link( __( 'Edit', 'twentyfourteen' ), '<span class="edit-link">', '</span>' ); ?>

src/wp-content/themes/twentyfourteen/content-link.php

@@ -13 +13 @@
 
         <header class="entry-header">
                 <?php if ( in_array( 'category', get_object_taxonomies( get_post_type() ) ) && twentyfourteen_categorized_blog() ) : ?>
-                <div class="entry-meta">
-                        <span class="cat-links"><?php echo get_the_category_list( _x( ', ', 'Used between list items, there is a space after the comma.', 'twentyfourteen' ) ); ?></span>
-                </div><!-- .entry-meta -->
+                        <div class="entry-meta">
+                                <span class="cat-links"><?php echo get_the_category_list( _x( ', ', 'Used between list items, there is a space after the comma.', 'twentyfourteen' ) ); ?></span>
+                        </div><!-- .entry-meta -->
                 <?php
                         endif;
 
@@ -34 +34 @@
                         <?php twentyfourteen_posted_on(); ?>
 
                         <?php if ( ! post_password_required() && ( comments_open() || get_comments_number() ) ) : ?>
-                        <span class="comments-link"><?php comments_popup_link( __( 'Leave a comment', 'twentyfourteen' ), __( '1 Comment', 'twentyfourteen' ), __( '% Comments', 'twentyfourteen' ) ); ?></span>
+                                <span class="comments-link"><?php comments_popup_link( __( 'Leave a comment', 'twentyfourteen' ), __( '1 Comment', 'twentyfourteen' ), __( '% Comments', 'twentyfourteen' ) ); ?></span>
                         <?php endif; ?>
 
                         <?php edit_post_link( __( 'Edit', 'twentyfourteen' ), '<span class="edit-link">', '</span>' ); ?>

src/wp-content/themes/twentyfourteen/content-none.php

@@ -14 +14 @@
 
 <div class="page-content">
         <?php if ( is_home() && current_user_can( 'publish_posts' ) ) : ?>
-
-        <p><?php printf( __( 'Ready to publish your first post? <a href="%1$s">Get started here</a>.', 'twentyfourteen' ), admin_url( 'post-new.php' ) ); ?></p>
-
+                <p><?php printf( __( 'Ready to publish your first post? <a href="%1$s">Get started here</a>.', 'twentyfourteen' ), admin_url( 'post-new.php' ) ); ?></p>
         <?php elseif ( is_search() ) : ?>
-
-        <p><?php _e( 'Sorry, but nothing matched your search terms. Please try again with some different keywords.', 'twentyfourteen' ); ?></p>
-        <?php get_search_form(); ?>
-
+                <p><?php _e( 'Sorry, but nothing matched your search terms. Please try again with some different keywords.', 'twentyfourteen' ); ?></p>
+                <?php get_search_form(); ?>
         <?php else : ?>
-
-        <p><?php _e( 'It seems we can&rsquo;t find what you&rsquo;re looking for. Perhaps searching can help.', 'twentyfourteen' ); ?></p>
-        <?php get_search_form(); ?>
-
+                <p><?php _e( 'It seems we can&rsquo;t find what you&rsquo;re looking for. Perhaps searching can help.', 'twentyfourteen' ); ?></p>
+                <?php get_search_form(); ?>
         <?php endif; ?>
 </div><!-- .page-content -->

src/wp-content/themes/twentyfourteen/content-page.php

@@ -10 +10 @@
 
 <article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
         <?php
+                // Page thumbnail and title.
                 twentyfourteen_post_thumbnail();
                 the_title( '<header class="entry-header"><h1 class="entry-title">', '</h1></header><!-- .entry-header -->' );
         ?>

src/wp-content/themes/twentyfourteen/content-quote.php

@@ -13 +13 @@
 
         <header class="entry-header">
                 <?php if ( in_array( 'category', get_object_taxonomies( get_post_type() ) ) && twentyfourteen_categorized_blog() ) : ?>
-                <div class="entry-meta">
-                        <span class="cat-links"><?php echo get_the_category_list( _x( ', ', 'Used between list items, there is a space after the comma.', 'twentyfourteen' ) ); ?></span>
-                </div><!-- .entry-meta -->
+                        <div class="entry-meta">
+                                <span class="cat-links"><?php echo get_the_category_list( _x( ', ', 'Used between list items, there is a space after the comma.', 'twentyfourteen' ) ); ?></span>
+                        </div><!-- .entry-meta -->
                 <?php
                         endif;
 
@@ -34 +34 @@
                         <?php twentyfourteen_posted_on(); ?>
 
                         <?php if ( ! post_password_required() && ( comments_open() || get_comments_number() ) ) : ?>
-                        <span class="comments-link"><?php comments_popup_link( __( 'Leave a comment', 'twentyfourteen' ), __( '1 Comment', 'twentyfourteen' ), __( '% Comments', 'twentyfourteen' ) ); ?></span>
+                                <span class="comments-link"><?php comments_popup_link( __( 'Leave a comment', 'twentyfourteen' ), __( '1 Comment', 'twentyfourteen' ), __( '% Comments', 'twentyfourteen' ) ); ?></span>
                         <?php endif; ?>
 
                         <?php edit_post_link( __( 'Edit', 'twentyfourteen' ), '<span class="edit-link">', '</span>' ); ?>

src/wp-content/themes/twentyfourteen/content-video.php

@@ -13 +13 @@
 
         <header class="entry-header">
                 <?php if ( in_array( 'category', get_object_taxonomies( get_post_type() ) ) && twentyfourteen_categorized_blog() ) : ?>
-                <div class="entry-meta">
-                        <span class="cat-links"><?php echo get_the_category_list( _x( ', ', 'Used between list items, there is a space after the comma.', 'twentyfourteen' ) ); ?></span>
-                </div><!-- .entry-meta -->
+                        <div class="entry-meta">
+                                <span class="cat-links"><?php echo get_the_category_list( _x( ', ', 'Used between list items, there is a space after the comma.', 'twentyfourteen' ) ); ?></span>
+                        </div><!-- .entry-meta -->
                 <?php
                         endif;
 
@@ -34 +34 @@
                         <?php twentyfourteen_posted_on(); ?>
 
                         <?php if ( ! post_password_required() && ( comments_open() || get_comments_number() ) ) : ?>
-                        <span class="comments-link"><?php comments_popup_link( __( 'Leave a comment', 'twentyfourteen' ), __( '1 Comment', 'twentyfourteen' ), __( '% Comments', 'twentyfourteen' ) ); ?></span>
+                                <span class="comments-link"><?php comments_popup_link( __( 'Leave a comment', 'twentyfourteen' ), __( '1 Comment', 'twentyfourteen' ), __( '% Comments', 'twentyfourteen' ) ); ?></span>
                         <?php endif; ?>
 
                         <?php edit_post_link( __( 'Edit', 'twentyfourteen' ), '<span class="edit-link">', '</span>' ); ?>

src/wp-content/themes/twentyfourteen/content.php

@@ -30 +30 @@
 
                 <div class="entry-meta">
                         <?php
-                                if ( 'post' == get_post_type() )
+                                if ( 'post' == get_post_type() ) :
                                         twentyfourteen_posted_on();
+                                endif;
 
                                 if ( ! post_password_required() && ( comments_open() || get_comments_number() ) ) :
                         ?>

src/wp-content/themes/twentyfourteen/featured-content.php

@@ -11 +11 @@
 <div id="featured-content" class="featured-content">
         <div class="featured-content-inner">
         <?php
+                /**
+                 * Fires before the Twenty Fourteen featured content.
+                 *
+                 * @since Twenty Fourteen 1.0
+                 */
                 do_action( 'twentyfourteen_featured_posts_before' );
 
                 $featured_posts = twentyfourteen_get_featured_posts();
                 foreach ( (array) $featured_posts as $order => $post ) :
                         setup_postdata( $post );
 
+                         // Include the featured content template.
                         get_template_part( 'content', 'featured-post' );
                 endforeach;
 
+                /**
+                 * Fires after the Twenty Fourteen featured content.
+                 *
+                 * @since Twenty Fourteen 1.0
+                 */
                 do_action( 'twentyfourteen_featured_posts_after' );
 
                 wp_reset_postdata();

src/wp-content/themes/twentyfourteen/functions.php

@@ -6 +6 @@
  * theme as custom template tags. Others are attached to action and filter
  * hooks in WordPress to change core functionality.
  *
- * 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.
+ * When using a child theme 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.
  *
+ * @link http://codex.wordpress.org/Theme_Development
+ * @link http://codex.wordpress.org/Child_Themes
+ *
  * Functions that are not pluggable (not wrapped in function_exists()) are
  * instead attached to a filter or action hook.
  *
@@ -27 +28 @@
 /**
  * Set up the content width value based on the theme's design.
  *
- * @link twentyfourteen_content_width()
+ * @see twentyfourteen_content_width()
  *
  * @since Twenty Fourteen 1.0
  */
@@ -138 +139 @@
  * @return array An array of WP_Post objects.
  */
 function twentyfourteen_get_featured_posts() {
+        /**
+         * Filter the featured posts to return in Twenty Fourteen.
+         *
+         * @since Twenty Fourteen 1.0
+         *
+         * @param array|bool $posts Array of featured posts, otherwise false.
+         */
         return apply_filters( 'twentyfourteen_get_featured_posts', array() );
 }
 
@@ -149 +157 @@
  * @return bool Whether there are featured posts.
  */
 function twentyfourteen_has_featured_posts() {
+        /** This filter is documented in functions.php */
         return ! is_paged() && (bool) apply_filters( 'twentyfourteen_get_featured_posts', false );
 }
 
 /**
- * Register two widget areas.
+ * Register two Twenty Fourteen widget areas.
  *
  * @since Twenty Fourteen 1.0
  *
@@ -214 +223 @@
 }
 
 /**
- * Enqueue scripts and styles for front end.
+ * Enqueue scripts and styles for the front end.
  *
  * @since Twenty Fourteen 1.0
  *
@@ -280 +289 @@
  */
 function twentyfourteen_the_attached_image() {
         $post                = get_post();
+        /**
+         * Filter the default Twenty Fourteen attachment size.
+         *
+         * @since Twenty Fourteen 1.0
+         *
+         * @param array $dimensions {
+         *     An array of height and width dimensions.
+         *
+         *     @type int $height Height of the image in pixels. Default 1200.
+         *     @type int $width  Width of the image in pixels. Default 1200.
+         * }
+         */
         $attachment_size     = apply_filters( 'twentyfourteen_attachment_size', array( 1200, 1200 ) );
         $next_attachment_url = wp_get_attachment_url();
 

src/wp-content/themes/twentyfourteen/header.php

@@ -21 +21 @@
 <head>
         <meta charset="<?php bloginfo( 'charset' ); ?>" />
         <meta name="viewport" content="width=device-width" />
+
         <title><?php wp_title( '|', true, 'right' ); ?></title>
+
         <link rel="profile" href="http://gmpg.org/xfn/11" />
         <link rel="pingback" href="<?php bloginfo( 'pingback_url' ); ?>" />
+
         <!--[if lt IE 9]>
-        <script src="<?php echo get_template_directory_uri(); ?>/js/html5.js" type="text/javascript"></script>
+                <script src="<?php echo get_template_directory_uri(); ?>/js/html5.js" type="text/javascript"></script>
         <![endif]-->
+
         <?php wp_head(); ?>
 </head>
 
 <body <?php body_class(); ?>>
 <div id="page" class="hfeed site">
         <?php if ( get_header_image() ) : ?>
-        <div id="site-header">
-                <a href="<?php echo esc_url( home_url( '/' ) ); ?>" rel="home">
-                        <img src="<?php header_image(); ?>" width="<?php echo get_custom_header()->width; ?>" height="<?php echo get_custom_header()->height; ?>" alt="" />
-                </a>
-        </div>
+                <div id="site-header">
+                        <a href="<?php echo esc_url( home_url( '/' ) ); ?>" rel="home">
+                                <img src="<?php header_image(); ?>" width="<?php echo get_custom_header()->width; ?>" height="<?php echo get_custom_header()->height; ?>" alt="" />
+                        </a>
+                </div>
         <?php endif; ?>
 
         <header id="masthead" class="site-header" role="banner">

src/wp-content/themes/twentyfourteen/image.php

@@ -7 +7 @@
  * @since Twenty Fourteen 1.0
  */
 
+// Retrieve attachment metadata.
 $metadata = wp_get_attachment_metadata();
 
 get_header();
@@ -15 +16 @@
         <section id="primary" class="content-area image-attachment">
                 <div id="content" class="site-content" role="main">
 
-                <?php while ( have_posts() ) : the_post(); ?>
-
+        <?php
+                // Start the Loop.
+                while ( have_posts() ) : the_post();
+        ?>
                         <article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
                                 <header class="entry-header">
                                         <?php the_title( '<h1 class="entry-title">', '</h1>' ); ?>
@@ -39 +42 @@
                                                 </div><!-- .attachment -->
 
                                                 <?php if ( has_excerpt() ) : ?>
-                                                <div class="entry-caption">
-                                                        <?php the_excerpt(); ?>
-                                                </div><!-- .entry-caption -->
+                                                        <div class="entry-caption">
+                                                                <?php the_excerpt(); ?>
+                                                        </div><!-- .entry-caption -->
                                                 <?php endif; ?>
                                         </div><!-- .entry-attachment -->
 

src/wp-content/themes/twentyfourteen/inc/custom-header.php

@@ -17 +17 @@
  * @uses twentyfourteen_admin_header_image()
  */
 function twentyfourteen_custom_header_setup() {
+        /**
+         * Filter Twenty Fourteen custom-header support arguments.
+         *
+         * @since Twenty Fourteen 1.0
+         *
+         * @param array $args {
+         *     An array of custom-header support arguments.
+         *
+         *     @type bool   $header_text            Whether to display custom header text. Default false.
+         *     @type int    $width                  Width in pixels of the custom header image. Default 1260.
+         *     @type int    $height                 Height in pixels of the custom header image. Default 240.
+         *     @type bool   $flex_height            Whether to allow flexible-height header images. Default true.
+         *     @type string $admin_head_callback    Callback function used to style the image displayed in
+         *                                          the Appearance > Header screen.
+         *     @type string $admin_preview_callback Callback function used to create the custom header markup in
+         *                                          the Appearance > Header screen.
+         * }
+         */
         add_theme_support( 'custom-header', apply_filters( 'twentyfourteen_custom_header_args', array(
                 'header-text'            => false,
                 'width'                  => 1260,
@@ -30 +48 @@
 
 if ( ! function_exists( 'twentyfourteen_admin_header_style' ) ) :
 /**
- * Style the header image displayed on the Appearance > Header admin panel.
+ * Style the header image displayed on the Appearance > Header screen.
  *
- * @link twentyfourteen_custom_header_setup().
+ * @see twentyfourteen_custom_header_setup()
  *
  * @since Twenty Fourteen 1.0
  */
@@ -65 +83 @@
 
 if ( ! function_exists( 'twentyfourteen_admin_header_image' ) ) :
 /**
- * Create the custom header image markup displayed on the Appearance > Header admin panel.
+ * Create the custom header image markup displayed on the Appearance > Header screen.
  *
- * @link twentyfourteen_custom_header_setup().
+ * @see twentyfourteen_custom_header_setup()
  *
  * @since Twenty Fourteen 1.0
  */
@@ -75 +93 @@
 ?>
         <div id="headimg">
                 <?php if ( get_header_image() ) : ?>
-                <img src="<?php header_image(); ?>" alt="">
+                        <img src="<?php header_image(); ?>" alt="">
                 <?php endif; ?>
                 <h1><a id="name" onclick="return false;" href="<?php echo esc_url( home_url( '/' ) ); ?>"><?php bloginfo( 'name' ); ?></a></h1>
         </div>

src/wp-content/themes/twentyfourteen/inc/customizer.php

@@ -72 +72 @@
 add_action( 'customize_preview_init', 'twentyfourteen_customize_preview_js' );
 
 /**
- * Tweak the brightness of a color by adjusting the RGB values by the given interval.
+ * Tweak the brightness of a color by adjusting the RGB
+ * values by the given interval.
  *
- * Use positive values of $steps to brighten the color and negative values to darken the color.
- * All three RGB values are modified by the specified steps, within the range of 0-255. The hue
- * is generally maintained unless the number of steps causes one value to be capped at 0 or 255.
+ * Use positive values of $steps to brighten the color and negative
+ * values to darken the color. All three RGB values are modified by
+ * the specified steps, within the range of 0-255. The hue is generally
+ * maintained unless the number of steps causes one value to be capped
+ * at 0 or 255.
  *
  * @since Twenty Fourteen 1.0
  *
  * @param string $color The original color, in 3- or 6-digit hexadecimal form.
- * @param int $steps The number of steps to adjust the color by, in RGB units.
+ * @param int    $steps The number of steps to adjust the color by, in RGB units.
  * @return string $color The new color, in 6-digit hexadecimal form.
  */
 function twentyfourteen_adjust_color( $color, $steps ) {
@@ -109 +112 @@
 }
 
  /**
- * Returns a slightly lighter color than what is set as the theme's
+ * Return a slightly lighter color than what is set as the theme's
  * accent color.
  *
  * @since Twenty Fourteen 1.0
  *
- * @return string
+ * @return string Hex color.
  */
 function twentyfourteen_accent_mid() {
         return twentyfourteen_adjust_color( get_theme_mod( 'accent_color' ), 29 );
 }
 
 /**
- * Returns a lighter color than what is set as the theme's accent color.
+ * Return a lighter color than what is set as the theme's accent color.
  *
  * @since Twenty Fourteen 1.0
  *
- * @return string
+ * @return string Hex color.
  */
 function twentyfourteen_accent_light() {
         return twentyfourteen_adjust_color( get_theme_mod( 'accent_color' ), 49 );
 }
 
 /**
- * Caches the generated variants of the theme's accent color.
+ * Cache the generated variants of the theme's accent color.
  *
  * @since Twenty Fourteen 1.0
  *
@@ -324 +327 @@
 add_action( 'wp_enqueue_scripts', 'twentyfourteen_customizer_styles' );
 
 /**
- * Adds contextual help to the Themes and Post edit screens.
+ * Add contextual help to the Themes and Post edit screens.
  *
  * @since Twenty Fourteen 1.0
  *

src/wp-content/themes/twentyfourteen/inc/featured-content.php

@@ -2 +2 @@
 /**
  * Twenty Fourteen Featured Content
  *
- * This module allows you to define a subset of posts to be displayed in the
- * theme's Featured Content area.
+ * This module allows you to define a subset of posts to be displayed
+ * in the theme's Featured Content area.
  *
- * For maximum compatibility with different methods of posting users will
- * designate a featured post tag to associate posts with. Since this tag now
- * has special meaning beyond that of a normal tags, users will have the
- * ability to hide it from the front-end of their site.
+ * For maximum compatibility with different methods of posting users
+ * will designate a featured post tag to associate posts with. Since
+ * this tag now has special meaning beyond that of a normal tags, users
+ * will have the ability to hide it from the front-end of their site.
  */
 class Featured_Content {
 
         /**
-         * The maximum number of posts that a Featured Content area can contain. We
-         * define a default value here but themes can override this by defining a
-         * "max_posts" entry in the second parameter passed in the call to
-         * add_theme_support( 'featured-content' ).
+         * The maximum number of posts a Featured Content area can contain.
          *
+         * We define a default value here but themes can override
+         * this by defining a "max_posts" entry in the second parameter
+         * passed in the call to add_theme_support( 'featured-content' ).
+         *
          * @see Featured_Content::init()
+         *
+         * @since Twenty Fourteen 1.0
+         *
+         * @static
+         * @access public
+         * @var int
          */
         public static $max_posts = 15;
 
         /**
-         * Instantiate
+         * Instantiate.
          *
          * All custom functionality will be hooked into the "init" action.
+         *
+         * @static
+         * @access public
+         * @since Twenty Fourteen 1.0
          */
         public static function setup() {
                 add_action( 'init', array( __CLASS__, 'init' ), 30 );
         }
 
         /**
-         * Conditionally hook into WordPress
+         * Conditionally hook into WordPress.
          *
          * Theme must declare that they support this module by adding
          * add_theme_support( 'featured-content' ); during after_setup_theme.
@@ -40 +51 @@
          * If no theme support is found there is no need to hook into WordPress.
          * We'll just return early instead.
          *
-         * @uses Featured_Content::$max_posts
+         * @static
+         * @access public
+         * @since Twenty Fourteen 1.0
          */
         public static function init() {
                 $theme_support = get_theme_support( 'featured-content' );
@@ -85 +98 @@
          *
          * Has to run on wp_loaded so that the preview filters of the customizer
          * have a chance to alter the value.
+         *
+         * @static
+         * @access public
+         * @since Twenty Fourteen 1.0
          */
         public static function wp_loaded() {
                 if ( self::get_setting( 'hide-tag' ) ) {
@@ -94 +111 @@
         }
 
         /**
-         * Get featured posts
+         * Get featured posts.
          *
-         * @uses Featured_Content::get_featured_post_ids()
+         * @static
+         * @access public
+         * @since Twenty Fourteen 1.0
          *
-         * @return array
+         * @return array Array of featured posts.
          */
         public static function get_featured_posts() {
                 $post_ids = self::get_featured_post_ids();
@@ -124 +143 @@
          *
          * Sets the "featured_content_ids" transient.
          *
-         * @return array Array of post IDs
+         * @static
+         * @access public
+         * @since Twenty Fourteen 1.0
+         *
+         * @return array Array of post IDs.
          */
         public static function get_featured_post_ids() {
                 // Return array of cached results if they exist.
@@ -170 +193 @@
         }
 
         /**
-         * Returns an array with IDs of posts maked as sticky.
+         * Return an array with IDs of posts maked as sticky.
          *
-         * @return array
+         * @static
+         * @access public
+         * @since Twenty Fourteen 1.0
+         *
+         * @return array Array of sticky posts.
          */
         public static function get_sticky_posts() {
                 $settings = self::get_setting();
@@ -180 +207 @@
         }
 
         /**
-         * Delete transient
+         * Delete featured content ids transient.
          *
          * Hooks in the "save_post" action.
+         *
          * @see Featured_Content::validate_settings().
+         *
+         * @static
+         * @access public
+         * @since Twenty Fourteen 1.0
          */
         public static function delete_transient() {
                 delete_transient( 'featured_content_ids' );
         }
 
         /**
-         * Exclude featured posts from the home page blog query
+         * Exclude featured posts from the home page blog query.
          *
-         * Filter the home page posts, and remove any featured post ID's from it. Hooked
-         * onto the 'pre_get_posts' action, this changes the parameters of the query
-         * before it gets any posts.
+         * Filter the home page posts, and remove any featured post ID's from it.
+         * Hooked onto the 'pre_get_posts' action, this changes the parameters of
+         * the query before it gets any posts.
          *
-         * @uses Featured_Content::get_featured_post_ids();
-         * @param WP_Query $query
-         * @return WP_Query Possibly modified WP_Query
+         * @static
+         * @access public
+         * @since Twenty Fourteen 1.0
+         *
+         * @param WP_Query $query WP_Query object.
+         * @return WP_Query Possibly-modified WP_Query.
          */
         public static function pre_get_posts( $query ) {
 
@@ -233 +268 @@
         }
 
         /**
-         * Reset tag option when the saved tag is deleted
+         * Reset tag option when the saved tag is deleted.
          *
-         * It's important to mention that the transient needs to be deleted, too.
-         * While it may not be obvious by looking at the function alone, the transient
-         * is deleted by Featured_Content::validate_settings().
+         * It's important to mention that the transient needs to be deleted,
+         * too. While it may not be obvious by looking at the function alone,
+         * the transient is deleted by Featured_Content::validate_settings().
          *
          * Hooks in the "delete_post_tag" action.
+         *
          * @see Featured_Content::validate_settings().
          *
+         * @static
+         * @access public
+         * @since Twenty Fourteen 1.0
+         *
          * @param int $tag_id The term_id of the tag that has been deleted.
          * @return void
          */
@@ -258 +298 @@
         }
 
         /**
-         * Hide featured tag from displaying when global terms are queried from the front-end
+         * Hide featured tag from displaying when global terms are queried from the front-end.
          *
          * Hooks into the "get_terms" filter.
          *
-         * @param array $terms A list of term objects. This is the return value of get_terms().
+         * @static
+         * @access public
+         * @since Twenty Fourteen 1.0
+         *
+         * @param array $terms      List of term objects. This is the return value of get_terms().
          * @param array $taxonomies An array of taxonomy slugs.
-         * @return array $terms
+         * @return array A filtered array of terms.
          *
          * @uses Featured_Content::get_setting()
          */
@@ -295 +339 @@
         }
 
         /**
-         * Hide featured tag from display when terms associated with a post object are queried from the front-end
+         * Hide featured tag from display when terms associated with a post object
+         * are queried from the front-end.
          *
          * Hooks into the "get_the_terms" filter.
          *
-         * @param array $terms A list of term objects. This is the return value of get_the_terms().
-         * @param int $id The ID field for the post object that terms are associated with.
+         * @static
+         * @access public
+         * @since Twenty Fourteen 1.0
+         *
+         * @param array $terms    A list of term objects. This is the return value of get_the_terms().
+         * @param int   $id       The ID field for the post object that terms are associated with.
          * @param array $taxonomy An array of taxonomy slugs.
-         * @return array $terms
+         * @return array Filtered array of terms.
          *
          * @uses Featured_Content::get_setting()
          */
@@ -333 +382 @@
         }
 
         /**
-         * Register custom setting on the Settings -> Reading screen
+         * Register custom setting on the Settings -> Reading screen.
          *
-         * @uses Featured_Content::render_form()
-         * @uses Featured_Content::validate_settings()
+         * @static
+         * @access public
+         * @since Twenty Fourteen 1.0
          *
          * @return void
          */
@@ -347 +397 @@
         /**
          * Add settings to the Customizer.
          *
+         * @static
+         * @access public
+         * @since Twenty Fourteen 1.0
+         *
          * @param WP_Customize_Manager $wp_customize Theme Customizer object.
          */
         public static function customize_register( $wp_customize ) {
@@ -386 +440 @@
         /**
          * Enqueue the tag suggestion script.
          *
+         * @static
+         * @access public
          * @since Twenty Fourteen 1.0
          */
         public static function enqueue_scripts() {
@@ -393 +449 @@
         }
 
         /**
-         * Get settings
+         * Get featured content settings.
          *
-         * Get all settings recognized by this module. This function will return
-         * all settings whether or not they have been stored in the database yet.
-         * This ensures that all keys are available at all times.
+         * Get all settings recognized by this module. This function
+         * will return all settings whether or not they have been stored
+         * in the database yet. This ensures that all keys are available
+         * at all times.
          *
-         * In the event that you only require one setting, you may pass its name
-         * as the first parameter to the function and only that value will be returned.
+         * In the event that you only require one setting, you may pass
+         * its name as the first parameter to the function and only that
+         * value will be returned.
          *
-         * @uses Featured_Content::sanitize_quantity()
+         * @static
+         * @access public
+         * @since Twenty Fourteen 1.0
          *
          * @param string $key The key of a recognized setting.
          * @return mixed Array of all settings by default. A single value if passed as first parameter.
@@ -429 +489 @@
         }
 
         /**
-         * Validate settings
+         * Validate featured content settings.
          *
-         * Make sure that all user supplied content is in an
-         * expected format before saving to the database. This
-         * function will also delete the transient set in
-         * Featured_Content::get_featured_content().
+         * Make sure that all user supplied content is in an expected
+         * format before saving to the database. This function will also
+         * delete the transient set in Featured_Content::get_featured_content().
          *
-         * @uses Featured_Content::self::sanitize_quantity()
-         * @uses Featured_Content::self::delete_transient()
+         * @static
+         * @access public
+         * @since Twenty Fourteen 1.0
          *
-         * @param array $input
-         * @return array $output
+         * @param array $input Array of settings input.
+         * @return array Validated settings output.
          */
         public static function validate_settings( $input ) {
                 $output = array();
@@ -469 +529 @@
 
                 $output['hide-tag'] = isset( $input['hide-tag'] ) && $input['hide-tag'] ? 1 : 0;
 
+                // Delete the featured post ids transient.
                 self::delete_transient();
 
                 return $output;
         }
 
         /**
-         * Sanitize quantity
+         * Sanitize quantity of featured posts.
          *
+         * @static
+         * @access public
+         * @since Twenty Fourteen 1.0
+         *
          * @param int $input The value to sanitize.
          * @return int A number between 1 and FeaturedContent::$max_posts.
-         *
-         * @uses Featured_Content::$max_posts
          */
         public static function sanitize_quantity( $input ) {
                 $quantity = absint( $input );
@@ -493 +556 @@
 
                 return $quantity;
         }
-}
 
+} // Featured_Content
+
 Featured_Content::setup();

src/wp-content/themes/twentyfourteen/inc/template-tags.php

@@ -36 +36 @@
         $format  = $GLOBALS['wp_rewrite']->using_index_permalinks() && ! strpos( $pagenum_link, 'index.php' ) ? 'index.php/' : '';
         $format .= $GLOBALS['wp_rewrite']->using_permalinks() ? user_trailingslashit( 'page/%#%', 'paged' ) : '?paged=%#%';
 
-        $links   = paginate_links( array(
+        // Setup paginated links.
+        $links = paginate_links( array(
                 'base'     => $pagenum_link,
                 'format'   => $format,
                 'total'    => $GLOBALS['wp_query']->max_num_pages,
@@ -109 +110 @@
                 echo '<span class="featured-post">' . __( 'Sticky', 'twentyfourteen' ) . '</span>';
         }
 
+        // Setup and print post meta information.
         printf( __( '<span class="entry-date"><a href="%1$s" rel="bookmark"><time class="entry-date" datetime="%2$s">%3$s</time></a></span> <span class="byline"><span class="author vcard"><a class="url fn n" href="%4$s" rel="author">%5$s</a></span></span>', 'twentyfourteen' ),
                 esc_url( get_permalink() ),
                 esc_attr( get_the_date( 'c' ) ),
@@ -149 +151 @@
 }
 
 /**
- * Flush out the transients used in twentyfourteen_categorized_blog
+ * Flush out the transients used in twentyfourteen_categorized_blog.
  *
  * @since Twenty Fourteen 1.0
  *
@@ -163 +165 @@
 add_action( 'save_post',     'twentyfourteen_category_transient_flusher' );
 
 /**
- * Displays an optional post thumbnail, with an anchor element
- * when on index views, and a div element when on a single view.
+ * Display an optional post thumbnail on a single view.
  *
+ * Adds an anchor element to the post thumbnail, when on
+ * index views, and a div element when on a single view.
+ *
  * @since Twenty Fourteen 1.0
  *
  * @return void
@@ -176 +180 @@
         }
 
         if ( is_singular() ) :
-        ?>
+                ?>
+                <div class="post-thumbnail">
+                <?php
+                        if ( ( ! is_active_sidebar( 'sidebar-2' ) || is_page_template( 'page-templates/full-width.php' ) ) && ! wp_is_mobile() ) {
+                                the_post_thumbnail( 'twentyfourteen-full-width' );
+                        } else {
+                                the_post_thumbnail();
+                        }
+                ?>
+                </div>
 
-        <div class="post-thumbnail">
-        <?php
-                if ( ( ! is_active_sidebar( 'sidebar-2' ) || is_page_template( 'page-templates/full-width.php' ) ) && ! wp_is_mobile() ) {
-                        the_post_thumbnail( 'twentyfourteen-full-width' );
-                } else {
-                        the_post_thumbnail();
-                }
-        ?>
-        </div>
-
         <?php else : ?>
 
         <a class="post-thumbnail" href="<?php the_permalink(); ?>" rel="<?php the_ID(); ?>">

src/wp-content/themes/twentyfourteen/inc/widgets.php

@@ -16 +16 @@
         /**
          * The supported post formats.
          *
+         * @access private
          * @since Twenty Fourteen 1.0
          *
          * @var array
@@ -25 +26 @@
         /**
          * Pluralized post format strings.
          *
+         * @access private
          * @since Twenty Fourteen 1.0
          *
          * @var array
@@ -65 +67 @@
         /**
          * Output the HTML for this widget.
          *
+         * @access public
          * @since Twenty Fourteen 1.0
          *
-         * @param array $args An array of standard parameters for widgets in this theme.
+         * @param array $args     An array of standard parameters for widgets in this theme.
          * @param array $instance An array of settings for this widget instance.
          * @return void Echoes its output.
          */
@@ -219 +222 @@
         }
 
         /**
-         * Deal with the settings when they are saved by the admin. Here is where
-         * any validation should happen.
+         * Deal with the settings when they are saved by the admin.
          *
+         * Here is where any validation should happen.
+         *
          * @since Twenty Fourteen 1.0
          *
-         * @param array $new_instance
-         * @param array $instance
-         * @return array
+         * @param array $new_instance New widget instance.
+         * @param array $instance     Original widget instance.
+         * @return array Updated widget instance.
          */
         function update( $new_instance, $instance ) {
                 $instance['title']  = strip_tags( $new_instance['title'] );

src/wp-content/themes/twentyfourteen/index.php

@@ -2 +2 @@
 /**
  * The main template file
  *
- * This is the most generic template file in a WordPress theme
- * and one of the two required files for a theme (the other being style.css).
+ * This is the most generic template file in a WordPress theme and one
+ * of the two required files for a theme (the other being style.css).
  * It is used to display a page when nothing more specific matches a query.
  * E.g., it puts together the home page when no home.php file exists.
+ *
  * @link http://codex.wordpress.org/Template_Hierarchy
  *
  * @package WordPress
@@ -18 +19 @@
 <div id="main-content" class="main-content">
 
 <?php
-        if ( is_front_page() && twentyfourteen_has_featured_posts() ) {
+        if ( is_front_page() && twentyfourteen_has_featured_posts() ) :
+                // Include the featured content template.
                 get_template_part( 'featured-content' );
-        }
+        endif;
 ?>
 
         <div id="primary" class="content-area">
@@ -28 +30 @@
 
                 <?php
                         if ( have_posts() ) :
-                                while ( have_posts() ) :
-                                        the_post();
+                                // Start the Loop.
+                                while ( have_posts() ) : the_post();
 
+                                        /*
+                                         * Include the post format-specific template for the content. If you want to
+                                         * use this in a child theme, then include a file called called content-___.php
+                                         * (where ___ is the post format) and that will be used instead.
+                                         */
                                         get_template_part( 'content', get_post_format() );
+
                                 endwhile;
+                                // Previous/next post navigation.
                                 twentyfourteen_paging_nav();
 
                         else :
+                                // If no content, include the "No posts found" template.
                                 get_template_part( 'content', 'none' );
 
                         endif;

src/wp-content/themes/twentyfourteen/page-templates/contributors.php

@@ -13 +13 @@
 
 <?php
         if ( is_front_page() && twentyfourteen_has_featured_posts() ) {
+                // Include the featured content template.
                 get_template_part( 'featured-content' );
         }
 ?>
@@ -20 +21 @@
         <div id="primary" class="content-area">
                 <div id="content" class="site-content" role="main">
                         <?php
-                                while ( have_posts() ) :
-                                        the_post();
+                                // Start the Loop.
+                                while ( have_posts() ) : the_post();
                         ?>
 
                         <article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
                                 <?php
                                         the_title( '<header class="entry-header"><h1 class="entry-title">', '</h1></header><!-- .entry-header -->' );
 
+                                        // Output the authors list.
                                         twentyfourteen_list_authors();
 
                                         edit_post_link( __( 'Edit', 'twentyfourteen' ), '<footer class="entry-meta"><span class="edit-link">', '</span></footer>' );

src/wp-content/themes/twentyfourteen/page-templates/full-width.php

@@ -13 +13 @@
 
 <?php
         if ( is_front_page() && twentyfourteen_has_featured_posts() ) {
+                // Include the featured content template.
                 get_template_part( 'featured-content' );
         }
 ?>
@@ -20 +21 @@
         <div id="primary" class="content-area">
                 <div id="content" class="site-content" role="main">
                         <?php
-                                while ( have_posts() ) :
-                                        the_post();
+                                // Start the Loop.
+                                while ( have_posts() ) : the_post();
 
+                                        // Include the page content template.
                                         get_template_part( 'content', 'page' );
 
                                         // If comments are open or we have at least one comment, load up the comment template.

src/wp-content/themes/twentyfourteen/page.php

@@ -3 +3 @@
  * The template for displaying all pages
  *
  * This is the template that displays all pages by default.
- * Please note that this is the WordPress construct of pages and that other 'pages'
- * on your WordPress site will use a different template.
+ * Please note that this is the WordPress construct of pages and that
+ * other 'pages' on your WordPress site will use a different template.
  *
  * @package WordPress
  * @subpackage Twenty_Fourteen
@@ -16 +16 @@
 <div id="main-content" class="main-content">
 
 <?php
-        if ( is_front_page() && twentyfourteen_has_featured_posts() ) {
+        if ( is_front_page() && twentyfourteen_has_featured_posts() ) :\
+                // Include the featured content template.
                 get_template_part( 'featured-content' );
-        }
+        endif;
 ?>
         <div id="primary" class="content-area">
                 <div id="content" class="site-content" role="main">
 
                         <?php
-                                while ( have_posts() ) :
-                                        the_post();
+                                // Start the Loop.
+                                while ( have_posts() ) : the_post();
 
+                                        // Include the page content template.
                                         get_template_part( 'content', 'page' );
 
                                         // If comments are open or we have at least one comment, load up the comment template.
-                                        if ( comments_open() || get_comments_number() ) {
+                                        if ( comments_open() || get_comments_number() ) :
                                                 comments_template();
-                                        }
+                                        endif;
                                 endwhile;
                         ?>
 

src/wp-content/themes/twentyfourteen/search.php

@@ -14 +14 @@
 
                         <?php if ( have_posts() ) : ?>
 
-                        <header class="page-header">
-                                <h1 class="page-title"><?php printf( __( 'Search Results for: %s', 'twentyfourteen' ), get_search_query() ); ?></h1>
-                        </header><!-- .page-header -->
+                                <header class="page-header">
+                                        <h1 class="page-title"><?php printf( __( 'Search Results for: %s', 'twentyfourteen' ), get_search_query() ); ?></h1>
+                                </header><!-- .page-header -->
 
-                        <?php
-                                        while ( have_posts() ) :
-                                                the_post();
+                                <?php
+                                        // Start the Loop.
+                                        while ( have_posts() ) : the_post();
 
+                                                /*
+                                                 * Include the post format-specific template for the content. If you want to
+                                                 * use this in a child theme, then include a file called called content-___.php
+                                                 * (where ___ is the post format) and that will be used instead.
+                                                 */
                                                 get_template_part( 'content', get_post_format() );
+
                                         endwhile;
+                                        // Previous/next post navigation.
                                         twentyfourteen_paging_nav();
 
                                 else :
+                                        // If no content, include the "No posts found" template.
                                         get_template_part( 'content', 'none' );
 
                                 endif;

src/wp-content/themes/twentyfourteen/sidebar-content.php

@@ -7 +7 @@
  * @since Twenty Fourteen 1.0
  */
 
-if ( ! is_active_sidebar( 'sidebar-2' ) ) {
+if ( ! is_active_sidebar( 'sidebar-2' ) ) :
         return;
-}
+endif;
 ?>
 <div id="content-sidebar" class="content-sidebar widget-area" role="complementary">
         <?php dynamic_sidebar( 'sidebar-2' ); ?>

src/wp-content/themes/twentyfourteen/sidebar-footer.php

@@ -7 +7 @@
  * @since Twenty Fourteen 1.0
  */
 
-if ( ! is_active_sidebar( 'sidebar-3' ) ) {
+if ( ! is_active_sidebar( 'sidebar-3' ) ) :
         return;
-}
+endif;
 ?>
 
 <div id="supplementary">

src/wp-content/themes/twentyfourteen/sidebar.php

@@ -12 +12 @@
                 $description = get_bloginfo( 'description' );
                 if ( ! empty ( $description ) ) :
         ?>
-        <h2 class="site-description"><?php echo esc_html( $description ); ?></h2>
+                <h2 class="site-description"><?php echo esc_html( $description ); ?></h2>
         <?php endif; ?>
 
         <?php if ( has_nav_menu( 'secondary' ) ) : ?>
-        <nav role="navigation" class="navigation site-navigation secondary-navigation">
-                <?php wp_nav_menu( array( 'theme_location' => 'secondary' ) ); ?>
-        </nav>
+                <nav role="navigation" class="navigation site-navigation secondary-navigation">
+                        <?php wp_nav_menu( array( 'theme_location' => 'secondary' ) ); ?>
+                </nav>
         <?php endif; ?>
 
         <?php if ( is_active_sidebar( 'sidebar-1' ) ) : ?>
-        <div id="primary-sidebar" class="primary-sidebar widget-area" role="complementary">
-                <?php dynamic_sidebar( 'sidebar-1' ); ?>
-        </div><!-- #primary-sidebar -->
+                <div id="primary-sidebar" class="primary-sidebar widget-area" role="complementary">
+                        <?php dynamic_sidebar( 'sidebar-1' ); ?>
+                </div><!-- #primary-sidebar -->
         <?php endif; ?>
 </div><!-- #secondary -->

src/wp-content/themes/twentyfourteen/single.php

@@ -12 +12 @@
         <div id="primary" class="content-area">
                 <div id="content" class="site-content" role="main">
                         <?php
-                                while ( have_posts() ) :
-                                        the_post();
+                                // Start the Loop.
+                                while ( have_posts() ) : the_post();
 
+                                        /*
+                                         * Include the post format-specific template for the content. If you want to
+                                         * use this in a child theme, then include a file called called content-___.php
+                                         * (where ___ is the post format) and that will be used instead.
+                                         */
                                         get_template_part( 'content', get_post_format() );
 
+                                        // Previous/next post navigation.
                                         twentyfourteen_post_nav();
 
                                         // If comments are open or we have at least one comment, load up the comment template.
-                                        if ( comments_open() || get_comments_number() ) {
+                                        if ( comments_open() || get_comments_number() ) :
                                                 comments_template();
-                                        }
+                                        endif;
                                 endwhile;
                         ?>
                 </div><!-- #content -->

src/wp-content/themes/twentyfourteen/tag.php

@@ -18 +18 @@
 
                         <?php if ( have_posts() ) : ?>
 
-                        <header class="archive-header">
-                                <h1 class="archive-title"><?php single_tag_title(); ?></h1>
+                                <header class="archive-header">
+                                        <h1 class="archive-title"><?php single_tag_title(); ?></h1>
 
-                                <?php
-                                        // Show an optional term description.
-                                        $term_description = term_description();
-                                        if ( ! empty( $term_description ) ) :
-                                                printf( '<div class="taxonomy-description">%s</div>', $term_description );
-                                        endif;
-                                ?>
-                        </header><!-- .archive-header -->
+                                        <?php
+                                                // Show an optional term description.
+                                                $term_description = term_description();
+                                                if ( ! empty( $term_description ) ) :
+                                                        printf( '<div class="taxonomy-description">%s</div>', $term_description );
+                                                endif;
+                                        ?>
+                                </header><!-- .archive-header -->
 
                         <?php
-                                        while ( have_posts() ) :
-                                                the_post();
+                                        // Start the Loop.
+                                        while ( have_posts() ) : the_post();
 
+                                                /*
+                                                 * Include the post format-specific template for the content. If you want to
+                                                 * use this in a child theme, then include a file called called content-___.php
+                                                 * (where ___ is the post format) and that will be used instead.
+                                                 */
                                                 get_template_part( 'content', get_post_format() );
+
                                         endwhile;
+                                        // Previous/next page navigation.
                                         twentyfourteen_paging_nav();
 
                                 else :
+                                        // If no content, include the "No posts found" template.
                                         get_template_part( 'content', 'none' );
 
                                 endif;

src/wp-content/themes/twentyfourteen/taxonomy-post_format.php

@@ -20 +20 @@
 
                         <?php if ( have_posts() ) : ?>
 
-                        <header class="archive-header">
-                                <h1 class="archive-title">
-                                        <?php
-                                                if ( is_tax( 'post_format', 'post-format-aside' ) ) :
-                                                        _e( 'Asides', 'twentyfourteen' );
+                                <header class="archive-header">
+                                        <h1 class="archive-title">
+                                                <?php
+                                                        if ( is_tax( 'post_format', 'post-format-aside' ) ) :
+                                                                _e( 'Asides', 'twentyfourteen' );
+                                                        elseif ( is_tax( 'post_format', 'post-format-image' ) ) :
+                                                                _e( 'Images', 'twentyfourteen' );
+                                                        elseif ( is_tax( 'post_format', 'post-format-video' ) ) :
+                                                                _e( 'Videos', 'twentyfourteen' );
+                                                        elseif ( is_tax( 'post_format', 'post-format-audio' ) ) :
+                                                                _e( 'Audio', 'twentyfourteen' );
+                                                        elseif ( is_tax( 'post_format', 'post-format-quote' ) ) :
+                                                                _e( 'Quotes', 'twentyfourteen' );
+                                                        elseif ( is_tax( 'post_format', 'post-format-link' ) ) :
+                                                                _e( 'Links', 'twentyfourteen' );
+                                                        elseif ( is_tax( 'post_format', 'post-format-gallery' ) ) :
+                                                                _e( 'Galleries', 'twentyfourteen' );
+                                                        else :
+                                                                _e( 'Archives', 'twentyfourteen' );
+                                                        endif;
+                                                ?>
+                                        </h1>
+                                </header><!-- .archive-header -->
 
-                                                elseif ( is_tax( 'post_format', 'post-format-image' ) ) :
-                                                        _e( 'Images', 'twentyfourteen' );
-
-                                                elseif ( is_tax( 'post_format', 'post-format-video' ) ) :
-                                                        _e( 'Videos', 'twentyfourteen' );
-
-                                                elseif ( is_tax( 'post_format', 'post-format-audio' ) ) :
-                                                        _e( 'Audio', 'twentyfourteen' );
-
-                                                elseif ( is_tax( 'post_format', 'post-format-quote' ) ) :
-                                                        _e( 'Quotes', 'twentyfourteen' );
-
-                                                elseif ( is_tax( 'post_format', 'post-format-link' ) ) :
-                                                        _e( 'Links', 'twentyfourteen' );
-
-                                                elseif ( is_tax( 'post_format', 'post-format-gallery' ) ) :
-                                                        _e( 'Galleries', 'twentyfourteen' );
-
-                                                else :
-                                                        _e( 'Archives', 'twentyfourteen' );
-
-                                                endif;
-                                        ?>
-                                </h1>
-                        </header><!-- .archive-header -->
-
                         <?php
-                                        while ( have_posts() ) :
-                                                the_post();
+                                        // Start the Loop.
+                                        while ( have_posts() ) : the_post();
 
+                                                /*
+                                                 * Include the post format-specific template for the content. If you want to
+                                                 * use this in a child theme, then include a file called called content-___.php
+                                                 * (where ___ is the post format) and that will be used instead.
+                                                 */
                                                 get_template_part( 'content', get_post_format() );
+
                                         endwhile;
+                                        // Previous/next page navigation.
                                         twentyfourteen_paging_nav();
 
                                 else :
+                                        // If no content, include the "No posts found" template.
                                         get_template_part( 'content', 'none' );
 
                                 endif;