Me gustaría ofrecer mi tipo de publicación personalizada como un complemento, para que las personas puedan usarlo sin tocar su carpeta de temas. Pero las plantillas de tipo de publicación personalizadas, como single-movies.php, residen en la carpeta del tema. ¿Hay alguna manera de hacer que WP verifique un single-movies.php en la carpeta del complemento? ¿Enganchando una función en la Jerarquía de Filer ? O get_template_directory (); ?

Puedes usar single_templategancho de filtro.

/* Filter the single_template with our custom function*/
add_filter('single_template', 'my_custom_template');

function my_custom_template($single) {

    global $post;

    /* Checks for single template by post type */
    if ( $post->post_type == 'POST TYPE NAME' ) {
        if ( file_exists( PLUGIN_PATH . '/Custom_File.php' ) ) {
            return PLUGIN_PATH . '/Custom_File.php';
        }
    }

    return $single;

}

Respuesta actualizada

Versión más limpia y corta.

function load_movie_template( $template ) {
    global $post;

    if ( 'movie' === $post->post_type && locate_template( array( 'single-movie.php' ) ) !== $template ) {
        /*
         * This is a 'movie' post
         * AND a 'single movie template' is not found on
         * theme or child theme directories, so load it
         * from our plugin directory.
         */
        return plugin_dir_path( __FILE__ ) . 'single-movie.php';
    }

    return $template;
}

add_filter( 'single_template', 'load_movie_template' );

Vieja respuesta

Se agregó una verificación para una plantilla específica de tipo de publicación personalizada en la carpeta de temas a la respuesta @Brainternet.

function load_cpt_template($template) {
    global $post;

    // Is this a "my-custom-post-type" post?
    if ($post->post_type == "my-custom-post-type"){

        //Your plugin path 
        $plugin_path = plugin_dir_path( __FILE__ );

        // The name of custom post type single template
        $template_name = 'single-my-custom-post-type.php';

        // A specific single template for my custom post type exists in theme folder? Or it also doesn't exist in my plugin?
        if($template === get_stylesheet_directory() . '/' . $template_name
            || !file_exists($plugin_path . $template_name)) {

            //Then return "single.php" or "single-my-custom-post-type.php" from theme directory.
            return $template;
        }

        // If not, return my plugin custom post type template.
        return $plugin_path . $template_name;
    }

    //This is not my custom post type, do nothing with $template
    return $template;
}
add_filter('single_template', 'load_cpt_template');

Ahora puede permitir que los usuarios del complemento copien la plantilla de su complemento a su tema para anularlo.

Con este ejemplo, las plantillas deben estar en el directorio raíz tanto del complemento como del tema.

Me gustaría señalar que cuando utiliza el método de filtro para esto, es extremadamente importante priorizar el filtro de esta manera:

add_filter('single_template', 'my_custom_template', 99);

Si no hace esto, a veces WP intentará volver a verificar después de este filtro. Estuve arrancándome el pelo por eso durante 2 horas.

Hay una manera mucho mejor de hacerlo que estoy usando para mis complementos.

Como @campsjos menciona aquí , en lugar de verificar la existencia del archivo, puede verificar locate_templateque se registrará en el archivo de plantilla anulado del tema. Lo cual es bastante obvio.

function my_plugin_templates() {
    if (is_singular('movie')) {
        if (file_exists($this->template_dir . 'single-movie.php')) {
            return $this->template_dir . 'single-movie.php';
        }
    }
}

Use el template_includegancho de filtro para cargar el código anterior.

add_filter('template_include' , 'my_plugin_templates');

Gracias a esta página pude resolver la misma pregunta para mí.

Como referencia, esto es lo que terminé con:

function pluginName_myposttype_single_template($single_template) {
  $myposttype_template = PLUGIN_DIR . 'templates/single-myposttype.php';
  return get_post_type() === 'myposttype' && file_exists($myposttype_template) ? $myposttype_template : $single_template;
}
add_filter('single_template', 'pluginName_myposttype_single_template');

el {$ type} _template filter hook no funcionó para mí

function pluginName_myposttype_single_template($single_template) {
  $myposttype_template = PLUGIN_DIR . 'templates/single-myposttype.php';

  if ( file_exists($myposttype_template) ) {
    $single_template = $myposttype_template;
  }
  return $single_template;
}
add_filter('single-myposttype_template', 'pluginName_myposttype_single_template');

Lo anterior es una gran respuesta, pero la comprobación de $ single var permite que la plantilla anule una plantilla si el tema / tema secundario proporciona una.

/* Filter the single_template with our custom function*/
add_filter('single_template', 'your_cpt_custom_template');

function your_cpt_custom_template( $single ) {
    global $wp_query, $post;
    /* Checks for single template by post type */
    if ( !$single && $post->post_type == 'cpt' ) {
        if( file_exists( plugin_dir_path( __FILE__ ) . 'single-cpt.php' ) )
            return plugin_dir_path( __FILE__ ) . 'single-cpt.php';
    }
    return $single;
}