Aggiungere programmaticamente una pagina con template personalizzato

L'articolo linkato è sulla strada giusta, ma lo semplificherò per te.. ;)

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;
}

Il filtro fondamentalmente verifica se il tuo template di pagina speciale è impostato per la pagina corrente, se lo è, aggiorna il percorso per puntare al template del tuo plugin.

Assicurati solo che il percorso sia corretto, altrimenti vedrai errori di inclusione... :)

Follow-up #1

Ok, il primo problema è che WordPress convalida qualsiasi template impostato come template di pagina, cioè verifica se il file si trova nella cartella del tema ed è un file di template valido, altrimenti lo salta e include un template più generico, come page.php...

Tuttavia, questo non cambia il fatto che il campo meta conservi ancora il valore del tuo template personalizzato, e anche is_page_template( 'tp-file.php' ) restituirà correttamente true se usato al posto della mia precedente condizione, ad esempio..

// Filtra il template di pagina
add_filter('page_template', 'catch_plugin_template');

// Callback del filtro per il template di pagina
function catch_plugin_template($template) {
    // Se tp-file.php è il template impostato
    if( is_page_template('tp-file.php') )
        // Aggiorna il percorso (deve essere un percorso, usa WP_PLUGIN_DIR e non WP_PLUGIN_URL) 
        $template = WP_PLUGIN_DIR . '/tp-test/tp-file.php';
    // Restituisci
    return $template;
}

NOTA: Ho modificato il codice per usare WP_PLUGIN_DIR poiché la costante WP_PLUGIN_URL non è adatta per i percorsi... (gli include devono usare un percorso, non un URL).

Un problema, e questo non è qualcosa che puoi risolvere, è che quando visualizzi la pagina dall'area di amministrazione, durante la modifica della pagina, il template non sarà elencato come template attivo, e salvare le modifiche potrebbe ovviamente cambiare il template attivo. Non c'è molto che possiamo fare lì, il menu a discesa dei template di pagina è generato da una funzione che scandisce i file del tema, non ci sono hook che permetterebbero di estendere la lista con i template dei plugin.

Personalmente, quello che suggerirei, come soluzione alternativa, sarebbe salvare un campo meta aggiuntivo per ogni pagina creata usando la tua pagina speciale del plugin, poi aggiungere un hook su save_post o wp_insert_post_data e verificare se questo campo meta esiste, se esiste, verificare anche che il template di pagina sia impostato su tp-file.php, e se non lo è, aggiornarlo a tp-file.php. Il campo meta aggiuntivo sarebbe solo un flag, per indicare quali pagine devono avere il template del plugin associato.

Ecco il tuo plugin che funziona nella sua forma più basilare (sì, l'ho testato)... :)

<?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( 'Questo plugin richiede WordPress 2.9 o più recente. <a href="http://codex.wordpress.org/Upgrading_WordPress">Aggiorna per favore!</a>' );

// Aggiungi callback al menu di amministrazione
add_action('admin_menu', 'create_tp_menu');

// Callback per aggiungere voci di 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' => 'Qualche testo',
            '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('Errore nella creazione della pagina template');
        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">Crea Pagina Template</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="Crea Pagina Template" name="btn_submit" />
         </form>
    </fieldset>
    <?php

}


// Filtra il template di pagina
add_filter('page_template', 'catch_plugin_template');

// Callback del filtro per il template di pagina
function catch_plugin_template($template) {
    // Se tp-file.php è il template impostato
    if( is_page_template('tp-file.php') )
        // Aggiorna il percorso (deve essere un percorso, usa WP_PLUGIN_DIR e non WP_PLUGIN_URL) 
        $template = WP_PLUGIN_DIR . '/tp-test/tp-file.php';
    // Restituisci
    return $template;
}

Spero che questo aiuti a chiarire le cose.. :)