Applicare un template a un custom post type

A partire da WordPress 4.7, è stato introdotto il supporto per template multipli nei Custom Post Type.

Per rendere disponibile un template per il tuo Custom Post Type, devi aggiungere questa intestazione nella sezione meta del file del template:

Template Post Type: post, foo, bar 

Ad esempio, supponiamo che il tuo Custom Post Type sia chiamato "my_events" e che tu voglia rendere disponibile un template chiamato "Fullwidth" sia per le Pagine che per il tuo Custom Post Type.

Da questo:

/**
 * Template Name: Fullwidth
 * 
 * Template Description...
 **/

A questo:

/**
 * Template Name: Fullwidth
 * Template Post Type: page, my_events
 * 
 * Template Description...
 **/

Maggiori informazioni: Template per Post Type in 4.7 dal Core di WordPress

So che questa è una vecchia domanda, ma volevo aggiungere la mia risposta su cosa mi ha aiutato ad applicare i template ai tipi di post personalizzati.

Ho creato il mio tipo di post personalizzato manualmente (con il mio plugin) invece di usare il plugin Custom Post Type UI.

Il codice del plugin è questo:

<?php
/**
 * Plugin Name: [Il tuo plugin per il tipo di post]
 */

defined('ABSPATH') or die(''); // Impede l'accesso al file tramite URL nel browser

function yourPostTypeFunction() {
    register_post_type('your-post-type', array(
            'labels'=>array(
                'name'=>__('Pagine del tipo di post'),
                'singular_name'=>__('Pagina del tipo di post')
            ),
            'description'=>'La tua descrizione',
            'public'=>true,
            'hierarchical'=>true, // Permette relazioni genitore-figlio
            'show_in_rest'=>true,
            'supports'=>array( // Caratteristiche supportate dal tipo di post
                'title',
                'editor',
                'thumbnail',
                'revisions',
                'page-attributes' /* Necessario per mostrare il metabox per impostare le relazioni genitore-figlio
se non stai usando il metodo del campo header 'Template Post Type' */
            ),
            'has_archive'=>true,
        )
    );
}
add_action('init', 'yourPostTypeFunction');

function CPTFlushPermalinks() {
    yourPostTypeFunction();
    flush_rewrite_rules();
}
register_activation_hook(__FILE__, 'CPTFlushPermalinks');

?>

Vedi qui per i dettagli su tutte le opzioni di register_post_type() (e perché c'è un flush_rewrite_rules() alla fine). Molte sono impostate come predefinite e non devi aggiungerle.

La cosa importante per me era che 'hierarchical' fosse impostato su true e che 'supports' includesse 'page-attributes'.

Dopo questo, ho creato il mio file template. Il codice è qualcosa del genere:

<?php
/*
 * Template Name: [Il tuo template]
 */

// ... contenuto della pagina (per lo più copiato da page.php)

?>

Nota come ho omesso il campo "Template Post Type" post-WordPress-4.7? Questo perché questo campo serve per permettere la visibilità di un template nel metabox 'Attributi pagina' a specifici tipi di post. I tipi di post elencati potranno scegliere il template nel loro metabox Attributi pagina. (Se fai così, non avrai bisogno del supporto 'page-attributes' nel tuo tipo di post - il metabox verrà creato automaticamente.) Senza di esso, solo i post di tipo 'page' possono scegliere diversi template nel loro metabox 'Attributi pagina'.

Non era quello che volevo, perché volevo che il mio template fosse applicato immediatamente a tutte le pagine con quel tipo di post. Questo si ottiene nominando il template "single-[nome tipo di post].php".

Ci sono altri schemi di nomi che puoi usare per altri scopi, elencati qui.

Questo funzionerà per le pagine singole del tipo di post. Non so per le sottosezioni, come chiedeva la domanda originale; lì probabilmente avrai bisogno di istruzioni condizionali nei tuoi altri template, come "if ('your-post-type' === get_post_type()) { ...".

Puoi rinominare liberamente il template personalizzato tramite il suo campo "Template Name" senza influenzare le pagine. Se vuoi rinominare il file, puoi farlo, ma poi devi andare nel tuo database, cercare il nome del file e rinominare le istanze con il nuovo nome.

Inoltre, il plugin Post Type Switcher è utile per cambiare i post tra tipi di post, anche in blocco. Ha funzionato perfettamente per me senza bug.

La risposta di dswebsme era una risposta appropriata del periodo prima che WordPress permettesse ai non-'pages' di scegliere template personalizzati nel box 'Attributi pagina'.

I tipi di post personalizzati possono avere template selezionabili, dovrai solo implementarli tu stesso. Il modo in cui WordPress lo gestisce internamente con il tipo di post "page" è salvare uno slug del template nei metadati del post, quindi verificare se esiste un valore lì quando il template viene caricato sul front end secondo la gerarchia.

Il processo base consisterebbe nell'aggiungere un meta box al tuo tipo di post personalizzato per permettere agli utenti di selezionare un template (magari utilizzando get_page_templates per creare una lista).

Il secondo passo è aggiungere un filtro a single_template per caricare il template selezionato quando quell'oggetto viene visualizzato sul front end.

Se guardi all'interno dei file core wp-includes/template.php e wp-includes/post-template.php, puoi vedere il codice che WordPress utilizza (e dove viene applicato il filtro) e adattarlo alle tue esigenze. get_queried_object ti fornirà il post_type dell'oggetto all'interno del filtro, oltre all'ID per permetterti di recuperare i metadati del post.

EDIT -

Ecco un esempio di filtro per il tipo di post post che carica qualsiasi cosa si trovi nel meta key my_template (come qualunque.php). Puoi testarlo creando un nuovo post e inserendo un nome file sotto quella chiave utilizzando il meta box nativo Campi Personalizzati. Puoi modificarlo per il tuo tipo personalizzato (cambiando 'post'), e qualsiasi schema tu stia usando per memorizzare e nominare i file.

function wpd_post_type_template( $template ){
    $object = get_queried_object();
    if( ! empty( $object->post_type )
        && 'post' == $object->post_type
        && $slug = get_post_meta( $object->ID, 'my_template', true ) ){
        if( $custom_template = locate_template( $slug, false ) ){
            $template = $custom_template;
        }
    }
    return $template;
}
add_filter( 'single_template', 'wpd_post_type_template' ) ;