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

Timestamp:

12/03/2013 05:05:53 PM (13 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' );