Questa guida spiega come realizzare in maniera semplice e veloce il proprio primo plugin per WordPress.

Lo scopo è quello di fornire a chi legge un’idea su come si sviluppano i plugin per WordPress, con un esempio assolutamente basilare, non esaustivo sull’argomento, ma che serva come approccio iniziale alla API di WordPress, per chi vuole imparare a creare plugin utili, più complessi e completi.

Ciò che vogliamo realizzare è un plugin che sostituisca, nei contenuti del blog, i commenti html
<!–hello_world–> con questo codice html <h1>Hello World</h1>

Supponiamo di voler chiamare il nostro plugin: hello_world

Tutti i plugin di un blog wordpress, devono essere uploadati
nella cartella wp-content/plugins, per essere riconosciuti dalla piattaforma. Tutti i plugin devono utilizzare il PHP come linguaggio server-side, dunque il file principale del plugin deve avere estenzione .php
Se il plugin è piccolo possiamo decidere di mettere tutto il codice in un solo file (nome_plugin.php) e
mettere questo file direttamente nella directory wp-content/plugins. Più spesso invece si avrà bisogno
di suddividere il codice del plugin in vari file. In questo caso dobbiamo mettere tutti i file in una
directory che si chiama nome_plugin che andrà posizionata nella cartella wp-content/plugins. Il file
principale dovrà comunque chiamarsi nome_plugin.php; è consigliabile dare un nome al plugin che non sia molto comune e che però non contenga il numero della versione.

Noi realizzeremo il plugin con un solo file, senza usare una directory. Il file si chiamerà hello_world.php
Ok, non è un nome molto originale, ma questo è solo un esempio, questo plugin non verrà effettivamente distribuito e usato dalla comunità di wordpress.

All’inizio del file dobbiamo inserire il codice seguente, ovvero un commento contenente delle informazioni sul plugin (preceduto dallo pseudo-tag di apertura del php)

<?php
/*

Plugin Name: nome_plugin
Plugin URI: URI_della_pagina_che_descrive_il_plugin
Description: descrizione_del_plugin
Version: numero_di_versione_del_plugin
Author: nome_autore
Author URI: URI_autore_del_plugin
*/

di seguito possiamo inserire un commento contenente la licenza. Nel caso vogliamo distribuire il plugin è
consigliabile inserire una licenza open source (es. GPL).

La parte iniziale del plugin è completa, ora dobbiamo scrivere il codice che permette al plugin di svolgere la sua funzione. Ciò che vogliamo fare è filtrare i contenuti del blog in modo che tutte le stringe “” vengono trasformate nella stringa “

Hello World

“. Per fare questo dobbiamo realizzare una funzione filtro che chiamiamo filter_hello_world e aggiungerla ai filtri di wordpress. Di seguito il codice…

add_filter(”the_content”, “filter_hello_world”, 1);

function filter_hello_world($the_content){
$the_content = str_replace(”<!–hello_world–>”, “<h1>Hello World</h1>”, $the_content);
return $the_content;
}

?>

Il gioco è fatto, se avete seguito alla lettera tutti i passi, il plugin dovrebbe funzionare.
Naturalmente si può fare molto dippiù che sostituire stringhe nel contenuto dei post del blog.
Questa guida a mio parere è un riferimento abbastanza completo, in italiano, sull’argomento, per chi volesse realizzare qualcosa di più sofisticato.