Добавление пользовательского шаблона страницы программным путем

Статья по ссылке движется в правильном направлении, но я упрощу её для вас.. ;)

add_filter( 'page_template', 'catch_plugin_template' );

function catch_plugin_template( $template ) {
    if( 'tp-file.php' == basename( $template ) )
        $template = WP_PLUGIN_DIR . '/yourpluginname/tp-file.php';
    return $template;
}

Этот фильтр проверяет, установлен ли ваш специальный шаблон страницы для текущей страницы, и если да, обновляет путь, указывая на шаблон вашего плагина.

Просто убедитесь, что путь указан верно, иначе вы увидите ошибки подключения... :)

Дополнение #1

Первая проблема заключается в том, что WordPress проверяет любой шаблон, установленный как шаблон страницы, то есть он проверяет, находится ли файл в папке темы и является ли он валидным шаблоном. Если нет, он пропускает его и подключает более общий шаблон, например page.php...

Однако это не меняет того факта, что метаполе всё ещё хранит значение вашего кастомного шаблона, и также is_page_template( 'tp-file.php' ) будет корректно возвращать true, если использовать его вместо моего предыдущего условия, например..

// Фильтр шаблона страницы
add_filter('page_template', 'catch_plugin_template');

// Колбэк фильтра шаблона страницы
function catch_plugin_template($template) {
    // Если tp-file.php установлен как шаблон
    if( is_page_template('tp-file.php') )
        // Обновляем путь (должен быть путь, используем WP_PLUGIN_DIR, а не WP_PLUGIN_URL) 
        $template = WP_PLUGIN_DIR . '/tp-test/tp-file.php';
    // Возвращаем
    return $template;
}

ПРИМЕЧАНИЕ: Я изменил код, чтобы использовать WP_PLUGIN_DIR, так как константа WP_PLUGIN_URL не подходит для путей... (подключение файлов требует пути, а не URL).

Одна проблема, которую нельзя исправить, заключается в том, что при просмотре страницы из админки во время её редактирования, шаблон не будет отображаться как активный, и сохранение изменений может изменить активный шаблон. С этим мало что можно сделать, так как выпадающий список шаблонов страниц генерируется функцией, которая сканирует файлы темы, и нет хуков, которые позволили бы нам расширить этот список шаблонами из плагина.

Лично я бы предложил в качестве обходного решения сохранять дополнительное метаполе для каждой страницы, созданной с помощью вашего специального плагина, затем добавить хук на save_post или wp_insert_post_data и проверять, существует ли это метаполе. Если существует, также проверять, установлен ли шаблон страницы в tp-file.php, и если нет, обновлять его до tp-file.php. Дополнительное метаполе будет просто флагом, указывающим, какие страницы должны использовать шаблон вашего плагина.

Вот ваш плагин в самой базовой форме (да, я тестировал)... :)

<?php
/*
  Plugin Name: TP Test Plugin
  Plugin URI: 
  Description: TP Test Plugin
  Version: 1.0.0
  Author: 
  Author URI: 
*/

global $wp_version;

if( version_compare( $wp_version, "2.9", "<" ) )
    exit( 'Для этого плагина требуется WordPress 2.9 или новее. <a href="http://codex.wordpress.org/Upgrading_WordPress">Пожалуйста, обновитесь!</a>' );

// Добавляем колбэк в меню админки
add_action('admin_menu', 'create_tp_menu');

// Колбэк для добавления пунктов меню
function create_tp_menu() {
    add_management_page('TP Test', 'TP Test', 'manage_options', 'tp-teste', 'wp_tp_test_fnc' );
}

function wp_tp_test_fnc() {

    //include('tp-form-file.php');

    if( !empty( $_POST['tp_name'] ) ) {
        $tp_name = $_POST['tp_name'];

        global $user_ID;
        $new_post = array(
            'post_title' => $tp_name,
            'post_content' => 'Некоторый текст',
            'post_status' => 'publish',
            'post_date' => date('Y-m-d H:i:s'),
            'post_author' => $user_ID,
            'post_type' => 'page',
        );
        $post_id = wp_insert_post($new_post);

        if( !$post_id )
            wp_die('Ошибка при создании страницы шаблона');
        else
            update_post_meta( $post_id, '_wp_page_template', 'tp-file.php' );
        /*
        $pt = get_page_templates();

        $pt['TP file test'] = WP_PLUGIN_URL . '/tp-test/tp-file.php';

        echo "<pre>";
        print_r($pt);
        echo "</pre>";
        */
    }   
    ?>
    <fieldset style="margin: 50px 100px;background-color: #cccccc;padding: 30px;border: 1px solid #ccc">
         <legend style="background-color: #ccccff;padding: 20px;font-weight: bold;font-size: 18px">Создать страницу шаблона</legend>
         <form name="frm_main" action="" method="POSt">
              <input class="text" type="text" name="tp_name" size="50" />
              <br />
              <input class="button" type="submit" value="Создать страницу шаблона" name="btn_submit" />
         </form>
    </fieldset>
    <?php

}


// Фильтр шаблона страницы
add_filter('page_template', 'catch_plugin_template');

// Колбэк фильтра шаблона страницы
function catch_plugin_template($template) {
    // Если tp-file.php установлен как шаблон
    if( is_page_template('tp-file.php') )
        // Обновляем путь (должен быть путь, используем WP_PLUGIN_DIR, а не WP_PLUGIN_URL) 
        $template = WP_PLUGIN_DIR . '/tp-test/tp-file.php';
    // Возвращаем
    return $template;
}

Надеюсь, это поможет прояснить ситуацию.. :)