apply_filters( ‘theme_page_templates’, array $page_templates, WP_Theme $this, WP_Post|null $post )

User Contributed Notes

1. Skip to note 4 content

   Julie Kuehl 5 years ago

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

   If you want to remove templates from both Pages and Posts, you will need to also use the `theme_post_templates` in addition to the `theme_page_templates` filter.

   /* Remove parent theme page templates */
   
   function child_remove_page_templates( $page_templates ) {
     unset( $page_templates['template-cover.php'] );
     unset( $page_templates['template-full-width-cover.php'] );
     unset( $page_templates['template-full-width-only-content.php'] );
     unset( $page_templates['template-full-width.php'] );
     unset( $page_templates['template-only-content.php'] );
   
     return $page_templates;
   }
   add_filter( 'theme_page_templates', 'child_remove_page_templates' );
   add_filter( 'theme_post_templates', 'child_remove_page_templates' );
2. Skip to note 5 content

   SpartakusMd 10 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

   Filter page templates by blog id

   Suppose you have the blog `Food` with the id 2 and the template `page-food.php` which should only be used for this blog. The example below removes the page template from dropdowns of other blogs:

   /**
    * Filter the theme page templates.
    *
    * @param array    $page_templates Page templates.
    * @param WP_Theme $this           WP_Theme instance.
    * @param WP_Post  $post           The post being edited, provided for context, or null.
    * @return array (Maybe) modified page templates array.
    */
   function wpdocs_filter_theme_page_templates( $page_templates, $this, $post ) {
   	$current_blog_id = get_current_blog_id();
   	$food_blog_id    = 2;
   
   	if ( $current_blog_id != $food_blog_id ) {
   		if ( isset( $page_templates['page-food.php'] ) ) {
   			unset( $page_templates['page-food.php'] );
   		}
   	}
   	return $page_templates;
   }
   add_filter( 'theme_page_templates', 'wpdocs_filter_theme_page_templates', 20, 3 );
3. Skip to note 6 content

   mrwweb 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

   To filter the “Default template” option in the list of Page Templates, see default_page_template_title.