apply_filters( “{$type}_template”, string $template, string $type, string[] $templates )

User Contributed Notes

1. Skip to note 6 content

   alordiel 7 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

   We can use this filter in case that we want to add and archive page for our custom taxonomy that we have created from a plugin. In this case the filter we will need is “taxonomy_template”.

   add_filter( "taxonomy_template", 'load_our_custom_tax_template');
   function load_our_custom_tax_template ($tax_template) {
     if (is_tax('custom-tax-name')) {
       $tax_template = dirname(  __FILE__  ) . '/templates/custom-taxonomy-template.php';
     }
     return $tax_template;
   }
2. Skip to note 7 content

   Steven Lin 4 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

   Example Migrated from Codex:

   The example code will load the template file “post-type-template.php” located in your plugins folder for any posts or pages that have the type of ‘my_post_type‘ else uses default template.

   <?php
   add_filter( 'single_template', 'get_custom_post_type_template' );
   
   function get_custom_post_type_template( $single_template ) {
   	global $post;
   
   	if ( 'my_post_type' === $post->post_type ) {
   		$single_template = dirname( __FILE__ ) . '/post-type-template.php';
   	}
   
   	return $single_template;
   }
   ?>
3. Skip to note 8 content

   Steven Lin 4 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

   Example Migrated from Codex:

   This example loads the template file single-{post_type}-{slug}.php (e.g. single-event-wordcamp.php) only if the file exists, otherwise loads default template.

   <?php
   add_filter( 'single_template', 'add_postType_slug_template', 10, 1 );
   
   function add_posttype_slug_template( $single_template ) {
   	$object                            = get_queried_object();
   	$single_posttype_postname_template = locate_template( "single-{$object->post_type}-{$object->post_name}.php" );
   
   	if ( file_exists( $single_posttype_postname_template ) ) {
   		return $single_posttype_postname_template;
   	} else {
   		return $single_template;
   	}
   }
   ?>
4. Skip to note 9 content

   Steven Lin 4 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

   Example Migrated from Codex:

   This example loads a custom category template for categories 62, 65, and 59.

   add_filter( 'category_template', 'filter_category_template', 99 );
   
   function filter_category_template( $template ) {
   
   	 if ( is_category(array( 64,65,59 )  )  ) {
   		$new_template = locate_template( array( 'category-template.php' ) );
   		if ( '' != $new_template ) {
   			return $new_template;
   		}
   	}
   
   	return $template;
   }
5. Skip to note 10 content

   Steven Lin 4 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

   Example Migrated from Codex:

   The example below will load the template file “post-type-template.php” located in your plugins folder for any archive page that has the type of “my_post_type“; otherwise, uses default template.

   add_filter( 'archive_template', 'get_custom_post_type_template' );
   
   function get_custom_post_type_template( $archive_template ) {
        global $post;
   
        if ( is_post_type_archive ( 'my_post_type' ) ) {
             $archive_template = dirname( __FILE__ ) . '/post-type-template.php';
        }
        return $archive_template;
   }