Aplicar plantilla a tipo de publicación personalizada

A partir de WordPress 4.7, se agregó soporte para múltiples plantillas en los Tipos de Entrada Personalizados (Custom Post Types).

Para hacer que una plantilla esté disponible para tu Tipo de Entrada Personalizado, debes agregar este encabezado en la sección de metadatos del archivo de plantilla:

Template Post Type: post, foo, bar 

Por ejemplo, asumamos que tu Tipo de Entrada Personalizado se llama "my_events" y deseas hacer disponible una plantilla llamada "Ancho Completo" tanto para Páginas como para tu Tipo de Entrada Personalizado.

Esto:

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

Se convierte en esto:

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

Más información: Plantillas para Tipos de Entrada en 4.7 del núcleo de WordPress

Sé que esta es una pregunta antigua, pero quería añadir mi respuesta sobre lo que me ayudó a aplicar plantillas a tipos de contenido personalizados.

Creé mi tipo de contenido personalizado manualmente (con mi propio plugin) en lugar de usar el plugin Custom Post Type UI.

El código del plugin se ve así:

<?php
/**
 * Plugin Name: [Tu plugin de tipo de contenido]
 */

defined('ABSPATH') or die(''); // Previene el acceso al archivo a través de su URL en el navegador

function tuFuncionTipoContenido() {
    register_post_type('tu-tipo-contenido', array(
            'labels'=>array(
                'name'=>__('Páginas de tipo de contenido'),
                'singular_name'=>__('Página de tipo de contenido')
            ),
            'description'=>'Tu descripción',
            'public'=>true,
            'hierarchical'=>true, // Permite relaciones padre-hijo
            'show_in_rest'=>true,
            'supports'=>array( // Características que el tipo de contenido debe soportar
                'title',
                'editor',
                'thumbnail',
                'revisions',
                'page-attributes' /* Necesario para mostrar el metabox para establecer relaciones padre-hijo
si no estás usando el método del campo de encabezado 'Template Post Type' */
            ),
            'has_archive'=>true,
        )
    );
}
add_action('init', 'tuFuncionTipoContenido');

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

?>

Consulta aquí para detalles sobre todas las opciones de register_post_type() (y por qué hay un flush_rewrite_rules() al final). Muchas están configuradas como valores predeterminados que no necesitas añadir.

Lo importante para mí fue que 'hierarchical' estuviera configurado como true y que 'supports' incluyera 'page-attributes'.

Después de esto, creé mi archivo de plantilla. El código se ve algo así:

<?php
/*
 * Template Name: [Tu plantilla]
 */

// ... contenido de la página (mayormente copiado de page.php)

?>

¿Notaste que omití el campo "Template Post Type" posterior a WordPress 4.7? Esto es porque este campo es para permitir la visibilidad de una plantilla en el metabox 'Atributos de página' para tipos de contenido específicos. Los tipos de contenido listados podrán elegir la plantilla en su metabox de Atributos de página. (Si haces esto, no necesitarás el soporte 'page-attributes' en tu tipo de contenido – el metabox se creará automáticamente.) Sin él, solo los contenidos del tipo 'página' pueden elegir diferentes plantillas en su metabox 'Atributos de página'.

Esto no es lo que yo quería, ya que deseaba que mi plantilla se aplicara inmediatamente a todas las páginas con el tipo de contenido. Esto se logra nombrando la plantilla "single-[nombre del tipo de contenido].php".

Hay otros esquemas de nombres que puedes usar para otros propósitos, listados aquí.

Esto funcionará para páginas individuales del tipo de contenido. No sé sobre subsecciones, como preguntaba la pregunta original; allí probablemente necesitarías declaraciones condicionales en tus otras plantillas, como "if ('tu-tipo-contenido' === get_post_type()) { ...".

Puedes renombrar libremente la plantilla personalizada a través de su campo "Template Name" sin afectar ninguna página. Si deseas renombrar el archivo, puedes hacerlo, pero luego debes ir a tu base de datos, buscar el nombre del archivo y renombrar las instancias al nuevo nombre.

Además, el plugin Post Type Switcher es útil para cambiar contenidos entre tipos de contenido, incluso en masa. Funcionó perfectamente para mí sin errores.

La respuesta de dswebsme fue una respuesta apropiada de antes de que WordPress permitiera que contenidos que no son 'páginas' eligieran plantillas personalizadas en el cuadro 'Atributos de página'.

Los tipos de entradas personalizados pueden tener plantillas seleccionables, solo tendrás que implementarlas tú mismo. La forma en que WordPress lo hace internamente con el tipo de entrada de página es guardando un slug de plantilla en los metadatos de la entrada, luego verificando si existe un valor allí cuando la plantilla se carga en el front-end según la jerarquía.

El proceso básico sería agregar un meta box a tu tipo de entrada personalizado para permitir a los usuarios seleccionar una plantilla (quizás usando get_page_templates para construir una lista).

El segundo paso es agregar un filtro a single_template para cargar la plantilla seleccionada cuando ese objeto se visualiza en el front-end.

Si miras dentro de los archivos principales wp-includes/template.php y wp-includes/post-template.php, puedes ver el código que WordPress usa (y dónde se aplica el filtro) y adaptarlo a tus necesidades. get_queried_object te dará el post_type del objeto dentro del filtro, así como el ID para permitirte obtener los metadatos de la entrada.

EDIT -

Aquí hay un ejemplo de filtro para el tipo de entrada post que carga lo que esté en la meta clave my_template (como whatever.php). Puedes probarlo creando una nueva entrada e ingresando un nombre de archivo bajo esa clave usando el meta box nativo de Campos Personalizados. Puedes modificar esto para tu tipo personalizado (cambia 'post'), y cualquier esquema que estés usando para almacenar y nombrar archivos.

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' ) ;