Includerea unui fișier PHP în Conținut folosind [shortcode]

Am modificat niște cod dintr-un articol vechi de blog pentru a face asta și pentru a permite atașarea de query-strings la fișier.

Creditul original merge către amberpanther.com, și se pare că au făcut și un plug-in din asta.

//crearea shortcode-ului [include] care acceptă o cale de fișier și un șir de interogare
//această funcție a fost modificată dintr-un post pe www.amberpanther.com pe care îl puteți găsi la linkul de mai jos:
//http://www.amberpanther.com/knowledge-base/using-the-wordpress-shortcode-api-to-include-an-external-file-in-the-post-content/
//ÎNCEPUT cod amberpanther.com
function include_file($atts) {
     //dacă a fost specificată calea fișierului
     extract(
          shortcode_atts(
               array(
                    'filepath' => 'NULL'
               ), $atts
          )
     );

     //ÎNCEPUT parte modificată a codului pentru a accepta șiruri de interogare
     //verifică dacă există un șir de interogare după calea fișierului
     if(strpos($filepath,"?")) {
          $query_string_pos = strpos($filepath,"?");
          //crează o variabilă globală pentru șirul de interogare pentru a putea fi accesat în fișierele incluse dacă este necesar
          //de asemenea, extrage-l din numele curat al fișierului pe care îl vom stoca într-o variabilă nouă pentru includere
          global $query_string;
          $query_string = substr($filepath,$query_string_pos + 1);
          $clean_file_path = substr($filepath,0,$query_string_pos);     
          //dacă nu există un șir de interogare
     } else {
          $clean_file_path = $filepath;
     }
     //SFÂRȘIT parte modificată a codului

     //verifică dacă a fost specificată calea fișierului și dacă fișierul există
     if ($filepath != 'NULL' && file_exists(get_stylesheet_directory_uri() . "/" . $clean_file_path)){
          //activează bufferizarea output-ului pentru a captura rezultatul scriptului
          ob_start();
          //include fișierul specificat
          include(TEMPLATEPATH.$clean_file_path);
          //atribuie output-ul fișierului variabilei $content și curăță buffer-ul
          $content = ob_get_clean();
          //returnează $content
          //returnează este important pentru ca output-ul să apară în poziția corectă
          //în conținut
          return $content;
     }
}
//înregistrează handler-ul Shortcode
add_shortcode('include', 'include_file');
//SFÂRȘIT cod amberpanther.com
//shortcode cu șir de interogare exemplu:
//[include filepath="/get-posts.php?format=grid&taxonomy=testing&term=stuff&posttype=work"]

L-am setat să extragă din stylesheet uri (pentru a funcționa cu teme copil și altele asemenea), dar puteți ajusta cu ușurință acel cod pentru a extrage de oriunde (inclusiv din directoarele de plug-in-uri), sau puteți să-l eliminați cu totul și să folosiți calea completă atunci când includeți fișierul. Puteți chiar să adăugați o condițională cu un caracter de declanșare la început care să-i spună să folosească o cale specifică în funcție de primul caracter al numelui fișierului, cum ar fi folosirea unui "#" pentru directorul șablon, etc.

Îl folosesc pentru a include un fișier numit get-posts.php care se află în directorul meu de șablon și formatează output-ul diverselor postări pe baza unei serii de parametri furnizați în șirul de interogare. Mă scapă de nevoia de șabloane speciale pentru că pot include fișierul, să-i trimit un format și va afișa postările cu markup-ul pe care l-am specificat în fișierul get-posts.php.

De asemenea, permite clienților să includă tipuri personalizate de postări în postări de blog reale în formate specifice și este destul de util.

Spuneți-mi dacă aveți nevoie de clarificări la ceva.