Includere un file PHP nel contenuto usando [shortcode]

Ho modificato del codice da un vecchio post del blog per fare questo, e permettere anche di allegare query-string al file.

Il merito originale va a amberpanther.com, e a quanto pare hanno anche creato un plug-in con questa funzionalità.

//crea lo shortcode [include] che accetta un percorso file e una query string
//questa funzione è stata modificata da un post su www.amberpanther.com che puoi trovare al link sotto:
//http://www.amberpanther.com/knowledge-base/using-the-wordpress-shortcode-api-to-include-an-external-file-in-the-post-content/
//INIZIO codice amberpanther.com
function include_file($atts) {
     //se è specificato un percorso file
     extract(
          shortcode_atts(
               array(
                    'filepath' => 'NULL'
               ), $atts
          )
     );

     //INIZIO porzione di codice modificata per accettare query string
     //controlla presenza di query string dopo il percorso file
     if(strpos($filepath,"?")) {
          $query_string_pos = strpos($filepath,"?");
          //crea variabile globale per la query string per accedervi nei file inclusi
          //e separala dal percorso file pulito che memorizzeremo in una nuova variabile
          global $query_string;
          $query_string = substr($filepath,$query_string_pos + 1);
          $clean_file_path = substr($filepath,0,$query_string_pos);     
          //se non c'è query string
     } else {
          $clean_file_path = $filepath;
     }
     //FINE porzione modificata

     //controlla se il percorso è specificato e se il file esiste
     if ($filepath != 'NULL' && file_exists(get_stylesheet_directory_uri() . "/" . $clean_file_path)){
          //attiva output buffering per catturare l'output
          ob_start();
          //includi il file specificato
          include(TEMPLATEPATH.$clean_file_path);
          //assegna l'output a $content e pulisci il buffer
          $content = ob_get_clean();
          //restituisci $content
          //il return è importante per far apparire l'output nella posizione corretta
          //nel contenuto
          return $content;
     }
}
//registra l'handler dello shortcode
add_shortcode('include', 'include_file');
//FINE codice amberpanther.com
//esempio di shortcode con query string:
//[include filepath="/get-posts.php?format=grid&taxonomy=testing&term=stuff&posttype=work"]

Ho impostato il mio codice per prelevare dall'URI del tema figlio (così funziona con i child theme e simili), ma potresti facilmente modificare quel codice per prelevare da qualsiasi posizione (incluso le directory dei plugin), o rimuoverlo del tutto e usare semplicemente il percorso completo quando includi il file. Potresti anche aggiungere una condizione con un carattere trigger all'inizio che indica di usare un percorso specifico basato sul primo carattere del nome file, come usare "#" per la directory del template, ecc.

Lo uso per includere un file chiamato get-posts.php che si trova nella mia directory del template e formatta l'output di vari post basandosi su una serie di parametri forniti nella query string. Mi evita di dover creare template speciali perché posso includere il file, inviargli un formato e restituirà i post con il markup che ho specificato nel file get-posts.php.

Permette anche ai clienti di includere custom post type all'interno di post del blog veri e propri in formati specifici ed è molto utile.

Fammi sapere se hai bisogno di chiarimenti su qualcosa.