Changeset 38755

Timestamp:

10/07/2016 09:02:39 PM (8 years ago)

Author:

johnbillion

Message:

Themes: Remove paged.php from the theme template hierarchy.

The position of this template within the hierarchy is of so little use that zero themes in the WordPress.org theme directory make use of it. It's second only to index.php in the hierarchy, meaning that any archive template such as category.php or archive.php will be chosen before it.

Fixes #38162
Props ryankienstra for initial patch

Location:

trunk

Files:

• src/wp-includes/deprecated.php (modified) (1 diff)
• src/wp-includes/template-loader.php (modified) (1 diff)
• src/wp-includes/template.php (modified) (1 diff)
• tests/phpunit/tests/theme.php (modified) (1 diff)

trunk/src/wp-includes/deprecated.php

@@ -3759 +3759 @@
     return '';
 }
+
+/**
+ * Retrieve path of paged template in current or parent template.
+ *
+ * @since 1.5.0
+ * @deprecated 4.7.0 The paged.php template is no longer part of the theme template heirarchy.
+ *
+ * @return string Full path to paged template file.
+ */
+function get_paged_template() {
+    _deprecated_function( __FUNCTION__, '4.7.0' );
+
+    return get_query_template( 'paged' );
+}

trunk/src/wp-includes/template-loader.php

@@ -61 +61 @@
     elseif ( is_date()           && $template = get_date_template()           ) :
     elseif ( is_archive()        && $template = get_archive_template()        ) :
-    elseif ( is_paged()          && $template = get_paged_template()          ) :
     else :
         $template = get_index_template();

trunk/src/wp-includes/template.php

@@ -380 +380 @@
 
     return get_query_template( 'page', $templates );
-}
-
-/**
- * Retrieve path of paged template in current or parent template.
- *
- * The template hierarchy is filterable via the {@see 'paged_template_hierarchy'} hook.
- * The template path is filterable via the {@see 'paged_template'} hook.
- *
- * @since 1.5.0
- *
- * @see get_query_template()
- *
- * @return string Full path to paged template file.
- */
-function get_paged_template() {
-    return get_query_template('paged');
 }
 

trunk/tests/phpunit/tests/theme.php

@@ -268 +268 @@
                 $this->assertEquals(get_home_template(), get_query_template('home', array('home.php','index.php')));
                 $this->assertEquals(get_page_template(), get_query_template('page'));
-                $this->assertEquals(get_paged_template(), get_query_template('paged'));
                 $this->assertEquals(get_search_template(), get_query_template('search'));
                 $this->assertEquals(get_single_template(), get_query_template('single'));