如何使用插件将模板添加到主题?

时间:2016-02-01 作者:dcp3450

我需要一个页面模板来使用我的插件。我不需要替换主题模板,例如single或archive。

通常我会使用

/*
* Template Name: Blah Blah Blah
*/
然而,要将模板添加到页面选项中,插件中的这项操作并没有像预期的那样起作用。我知道如何在插件中为自定义帖子类型添加模板。然而,我需要这是一个选项的模板下拉在页面选项。

3 个回复
SO网友:jg314

这是一个非常简单的方法,我可以在插件中工作。您将要引用https://developer.wordpress.org/reference/hooks/theme_page_templates/https://developer.wordpress.org/reference/hooks/template_include/ 当您查看下面的代码时。

<?php
//Add our custom template to the admin\'s templates dropdown
add_filter( \'theme_page_templates\', \'pluginname_template_as_option\', 10, 3 );
function pluginname_template_as_option( $page_templates, $theme, $post ){

    $page_templates[\'template-landing.php\'] = \'Example Landing Page\';

    return $page_templates;

}

//When our custom template has been chosen then display it for the page
add_filter( \'template_include\', \'pluginname_load_template\', 99 );
function pluginname_load_template( $template ) {

    global $post;
    $custom_template_slug   = \'template-landing.php\';
    $page_template_slug     = get_page_template_slug( $post->ID );

    if( $page_template_slug == $custom_template_slug ){
        return plugin_dir_path( __FILE__ ) . $custom_template_slug;
    }

    return $template;

}

SO网友:тнє Sufi

据我所知,这方面没有直接的方法。我也尝试过搜索,没有找到比下面更好的解决方案。

以下代码将为您提供所需的准确信息:

class PageTemplater {

    /**
     * A Unique Identifier
     */
     protected $plugin_slug;

    /**
     * A reference to an instance of this class.
     */
    private static $instance;

    /**
     * The array of templates that this plugin tracks.
     */
    protected $templates;


    /**
     * Returns an instance of this class. 
     */
    public static function get_instance() {

            if( null == self::$instance ) {
                    self::$instance = new PageTemplater();
            } 

            return self::$instance;

    } 

    /**
     * Initializes the plugin by setting filters and administration functions.
     */
    private function __construct() {

            $this->templates = array();


            // Add a filter to the attributes metabox to inject template into the cache.
            add_filter(
                \'page_attributes_dropdown_pages_args\',
                 array( $this, \'register_project_templates\' ) 
            );


            // Add a filter to the save post to inject out template into the page cache
            add_filter(
                \'wp_insert_post_data\', 
                array( $this, \'register_project_templates\' ) 
            );


            // Add a filter to the template include to determine if the page has our 
            // template assigned and return it\'s path
            add_filter(
                \'template_include\', 
                array( $this, \'view_project_template\') 
            );


            // Add your templates to this array.
            $this->templates = array(
                    \'goodtobebad-template.php\'     => \'It\\\'s Good to Be Bad\',
            );

    } 


    /**
     * Adds our template to the pages cache in order to trick WordPress
     * into thinking the template file exists where it doens\'t really exist.
     *
     */

    public function register_project_templates( $atts ) {

            // Create the key used for the themes cache
            $cache_key = \'page_templates-\' . md5( get_theme_root() . \'/\' . get_stylesheet() );

            // Retrieve the cache list. 
            // If it doesn\'t exist, or it\'s empty prepare an array
            $templates = wp_get_theme()->get_page_templates();
            if ( empty( $templates ) ) {
                    $templates = array();
            } 

            // New cache, therefore remove the old one
            wp_cache_delete( $cache_key , \'themes\');

            // Now add our template to the list of templates by merging our templates
            // with the existing templates array from the cache.
            $templates = array_merge( $templates, $this->templates );

            // Add the modified cache to allow WordPress to pick it up for listing
            // available templates
            wp_cache_add( $cache_key, $templates, \'themes\', 1800 );

            return $atts;

    } 

    /**
     * Checks if the template is assigned to the page
     */
    public function view_project_template( $template ) {

            global $post;

            if (!isset($this->templates[get_post_meta( 
                $post->ID, \'_wp_page_template\', true 
            )] ) ) {

                    return $template;

            } 

            $file = plugin_dir_path(__FILE__). get_post_meta( 
                $post->ID, \'_wp_page_template\', true 
            );

            // Just to be safe, we check if the file exist first
            if( file_exists( $file ) ) {
                    return $file;
            } 
            else { echo $file; }

            return $template;

    } 


}
add_action( \'plugins_loaded\', array( \'PageTemplater\', \'get_instance\' ) );
Here is the full tutorial 详细说明正在发生的事情以及原因。

SO网友:Welcher

您可以使用theme_page_templates 筛选以插入页面模板。

例如:

add_filter( \'theme_page_templates\', \'filter_inject_page_templates\' );

filter_inject_page_templates( $templates ) {
    $path               = \'path/to/the/template/relative/to/the/theme/folder\';
    $templates[ $path ] = \'Name of the template that displays in dropdown;
    return $templates;
}
你可能不得不和$path 值以使其正确,但这应该是可行的。

希望有帮助!

相关推荐

Can I make plugins required?

我正在开发自己的Wordpress主题,将用于多个客户端。它有一个主题选项页面,这样我每次都可以轻松自定义网站,但我也会在我制作的每个网站上使用一些插件(如SEO插件、安全性等)。有没有办法让它们成为“必需的”,这样我就可以得到这些插件的列表,这样当我在新网站上安装主题时就不必在插件目录中找到它们了?