Changeset 60994

Timestamp:

10/20/2025 10:11:23 PM (5 weeks ago)

Author:

jorbin

Message:

Themes: Add a new taxonomy template.

This uses the same cascade as tags and categories so the check will first be for the slug first, then the term ID,

In classic themes, you can now use term IDs when creating taxonomy templates. With taxonomy-$taxonomy-{$term->term_id}.php templates you don't need to worry about templates breaking if you rename the Oakland Athletics term to Athletics the way you do if you use slug based template names.

Props swissspidy, sebastian.pisula, jorbin, theMikeD.
Fixes #35326.

File:

• trunk/src/wp-includes/template.php (modified) (3 diffs)

trunk/src/wp-includes/template.php

@@ -324 +324 @@
  *
  * 1. taxonomy-{taxonomy_slug}-{term_slug}.php
- * 2. taxonomy-{taxonomy_slug}.php
- * 3. taxonomy.php
+ * 2. taxonomy-{taxonomy_slug}-{term_id}.php
+ * 3. taxonomy-{taxonomy_slug}.php
+ * 4. taxonomy.php
  *
  * An example of this is:
  *
  * 1. taxonomy-location-texas.php
- * 2. taxonomy-location.php
- * 3. taxonomy.php
+ * 2. taxonomy-location-67.php
+ * 3. taxonomy-location.php
+ * 4. taxonomy.php
  *
  * The template hierarchy and template path are filterable via the {@see '$type_template_hierarchy'}
@@ -339 +341 @@
  * @since 4.7.0 The decoded form of `taxonomy-{taxonomy_slug}-{term_slug}.php` was added to the top of the
  *              template hierarchy when the term slug contains multibyte characters.
+ * @since 6.9.0 Added `taxonomy-{taxonomy_slug}-{term_id}.php` to the hierarchy.
  *
  * @see get_query_template()
@@ -358 +361 @@
 
         $templates[] = "taxonomy-$taxonomy-{$term->slug}.php";
+        $templates[] = "taxonomy-$taxonomy-{$term->term_id}.php";
         $templates[] = "taxonomy-$taxonomy.php";
     }