Changeset 26556 for trunk/src/wp-content/themes/twentyfourteen/index.php

Timestamp:

12/03/2013 05:05:53 PM (11 years ago)

Author:

lancewillett

Message:

Twenty Fourteen: update comment blocks to match inline docs standards. Props DrewAPicture, see #25837.

File:

• trunk/src/wp-content/themes/twentyfourteen/index.php (modified) (3 diffs)

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

@@ -3 +3 @@
  * 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).
- * 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.
+ * 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
  *
@@ -19 +20 @@
 
 <?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;
 ?>
 
@@ -29 +31 @@
         <?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' );