Changeset 14708 for trunk/wp-content/themes/twentyten/loop.php

Timestamp:

05/17/2010 06:36:11 AM (16 years ago)

Author:

nacin

Message:

In Twenty Ten, documentation and code improvements. see #12695.

File:

• trunk/wp-content/themes/twentyten/loop.php (modified) (8 diffs)

trunk/wp-content/themes/twentyten/loop.php

@@ -10 +10 @@
  * @package WordPress
  * @subpackage Twenty_Ten
- * @since 3.0.0
+ * @since Twenty Ten 1.0
  */
 ?>
@@ -27 +27 @@
         <h1 class="entry-title"><?php _e( 'Not Found', 'twentyten' ); ?></h1>
         <div class="entry-content">
-            <p><?php _e( 'Apologies, but no results were found for the requested Archive. Perhaps searching will help find a related post.', 'twentyten' ); ?></p>
+            <p><?php _e( 'Apologies, but no results were found for the requested archive. Perhaps searching will help find a related post.', 'twentyten' ); ?></p>
             <?php get_search_form(); ?>
         </div><!-- .entry-content -->
@@ -33 +33 @@
 <?php endif; ?>
 
-<?php /* Start the Loop */ ?>
+<?php
+    /* Start the Loop.
+     *
+     * In Twenty Ten we use the same loop in multiple contexts.
+     * It is broken into three main parts: when we're displaying
+     * posts that are in the gallery category, when we're displaying
+     * posts in the asides category, and finally all other posts.
+     *
+     * Additionally, we sometimes check for whether we are on an
+     * archive page, a search page, etc., allowing for small differences
+     * in the loop on each template without actually duplicating
+     * the rest of the loop that is shared.
+     *
+     * Without further ado, the loop:
+     */ ?>
 <?php while ( have_posts() ) : the_post(); ?>
 
-<?php /* How to Display posts in the Gallery Category */ ?>
+<?php /* How to display posts in the Gallery category. */ ?>
+
     <?php if ( in_category( _x('gallery', 'gallery category slug', 'twentyten') ) ) : ?>
         <div id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
@@ -72 +87 @@
 
 <?php /* How to display posts in the asides category */ ?>
+
     <?php elseif ( in_category( _x('asides', 'asides category slug', 'twentyten') ) ) : ?>
         <div id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
-    <?php if ( is_archive() || is_search() ) : // Only display Excerpts for archives & search ?>
+
+        <?php if ( is_archive() || is_search() ) : // Display excerpts for archives and search. ?>
             <div class="entry-summary">
-                <?php the_excerpt( __( 'Continue reading <span class="meta-nav">&rarr;</span>', 'twentyten' ) ); ?>
+                <?php the_excerpt(); ?>
             </div><!-- .entry-summary -->
-    <?php else : ?>
+        <?php else : ?>
             <div class="entry-content">
                 <?php the_content( __( 'Continue reading <span class="meta-nav">&rarr;</span>', 'twentyten' ) ); ?>
             </div><!-- .entry-content -->
-    <?php endif; ?>
+        <?php endif; ?>
 
             <div class="entry-utility">
@@ -90 +107 @@
                 <?php edit_post_link( __( 'Edit', 'twentyten' ), '<span class="meta-sep">|</span> <span class="edit-link">', '</span>' ); ?>
             </div><!-- #entry-utility -->
-        </div><!-- #post-<?php the_ID(); ?> -->
+        </div><!-- #post-(id) -->
 
-<?php /* How to display all other posts */ ?>
+<?php /* How to display all other posts. */ ?>
+
     <?php else : ?>
         <div id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
@@ -101 +119 @@
             </div><!-- .entry-meta -->
 
-    <?php if ( is_archive() || is_search() ) : // Only display Excerpts for archives & search ?>
+    <?php if ( is_archive() || is_search() ) : // Only display excerpts for archives and search. ?>
             <div class="entry-summary">
                 <?php the_excerpt( __( 'Continue reading <span class="meta-nav">&rarr;</span>', 'twentyten' ) ); ?>
@@ -115 +133 @@
                 <?php if ( count( get_the_category() ) ) : ?>
                     <span class="cat-links">
-                        <span class="entry-utility-prep entry-utility-prep-cat-links"><?php printf( __('Posted in %s', 'twentyten' ), '</span> '.get_the_category_list( ', ' ) ); ?>
+                        <span class="entry-utility-prep entry-utility-prep-cat-links"><?php printf( __('Posted in %s', 'twentyten' ), '</span> ' . get_the_category_list( ', ' ) ); ?>
                     </span>
                     <span class="meta-sep">|</span>
@@ -135 +153 @@
         <?php comments_template( '', true ); ?>
 
-    <?php endif; // if different categories queried ?>
-<?php endwhile; ?>
+    <?php endif; // This was the if statement that broke the loop into three parts based on categories. ?>
+
+<?php endwhile; // End the loop. Whew. ?>
 
 <?php /* Display navigation to next/previous pages when applicable */ ?>