Guida allo sviluppo di plugin per wordpress: Introduzione

di Maurizio Tarchini | 7 Set 2011 | in: Guide, Tutorial, Wordpress

Dopo la lunga pausa estiva ho pensato di riprendere con un argomento senz’altro succoso; una guida approfondita sullo sviluppo di plugin per WordPress.
Se hai già provato a guardare com’é fatto un plugin e ti sei subito demoralizzato, questa guida fa per te. Infatti non é così difficile come può sembrare, basta capire il meccanismo. Una volta capito, l’unico limite é la nostra fantasia. Sei pronto? Si parte

Cos’é un plugin?

Un plugin é un’applicazione che estende il core di WordPress aggiungendo delle funzionalità o modificandone il comportamento.
Per fare questo, WordPress mette a disposizione numerose funzioni e ganci.
In questa serie di tutorial vedremo le API principali, il loro funzionamento e le tecniche migliori per utilizzarle. Vi sono infatti una serie di importantissime best practices da osservare al fine di evitare che il plugin che abbiamo sviluppato possa andare in collisione con altri plugin o con funzionalità native di WordPress.
Come sempre, per meglio capire, ci dedicheremo allo sviluppo di qualcosa di reale.

Scenario

Svilupperemo un plugin che, una volta attivato, aggiungerà un box alla fine di ogni articolo contenente le informazioni sulla licenza dell’articolo stesso. Il box potrà essere chiuso (con un effetto di animazione) dal lettore con un semplice click del mouse. Aggiungeremo poi le opzioni del plugin nel pannello amministrativo con possibilità di modificare il testo da mostrare all’interno del box, alcuni elementi dello stile e la scelta del tipo di animazione da utilizzare per la chiusura del box.

Le principali caratteristiche di un plugin

Un plugin può essere costituito anche da un unico file che deve essere posizionato nella cartella wp-content/plugins o in una sottocartella (wp-content/plugins/mio_plugin/plugin_file.php), ma non ad un livello maggiore di profondità.
All’interno della cartella possiamo inserire un numero illimitato di file e cartelle di supporto; l’importante é che il file principale (quello che contiene l’intestazione del plugin – vedremo subito cosa significa) non si trovi in una sottocartella del plugin, altrimenti WordPress non lo troverà. Quindi wp-content/plugins/mio_plugin/altra_cartella/plugin_file.php é un errore.

Come creare l’intestazione del plugin

WordPress riconoscerà automaticamente il file principale del plugin se correttamente intestato.
Vediamo come.

Iniziamo con il creare una nuova cartella chiamata yiw-license-plugin all’interno della cartella plugins.
Ora creiamo il file yiw_license.plugin.php (all’interno della cartella appena creata) e al suo interno scriviamo queste righe:

<?php
/*
Plugin Name: Yiw License Box
Plugin URI: https://www.yourinspirationweb.com
Description: Qui possiamo scrivere una breve descrizione del plugin
Version: 1.0
Author: Maurizio Tarchini
Author URI: https://www.yourinspirationweb.com
 */
?>

Bene. A questo punto andiamo nel pannello amministrativo di WordPress, sezione plugin e vedremo che Yiw License Box sarà presente tra la lista dei plugin disponibili.

Qui possiamo vedere chiaramente in che modo le informazioni passate nell’intestazione vengono utilizzate per creare la lista dei plugin.

Adesso possiamo attivare il plugin, anche se ovviamente non succederà nulla.
Quando attiviamo un plugin, WordPress lo includerà nella lista dei file da eseguire. In questo caso eseguirà una pagina php contenente unicamente dei commenti (per il momento).

Conclusione

In questo primo articolo abbiamo visto le principali caratteristiche di un plugin per WordPress e siamo arrivati fino al punto di renderlo disponibile nella lista del pannello amministrativo.
Nel prossimo articolo vedremo come si utilizzano le due più importanti funzioni che ci permettono di accedere al core di WordPress in modo da poterlo estendere; quindi si comincerà a fare sul serio.

Capitoli di questa guida

**************************
La mascotte dell’articolo è stata fornita da @Fotolia

Scarica articolo in PDF

Tag: plugin, Wordpress

L'autore

Maurizio è sposato con la triade PHP - MySql - Apache e, non pago, ha un'amante chiamata jQuery. Ha un blog dove cerca di descrivere nei minimi particolari sia la moglie che l'amante. La sua vera specialità è la realizzazione di gestionali complessi anche se non rifiuta mai un sito web. +

Sito web dell'autore | Altri articoli scritti da Maurizio Tarchini

33 commenti

MelaS

7 Settembre 2011 a 12:13

# 1

Grande Maurizio…. Mi piace questa guida. Un saluto.

Rispondi
- Maurizio
  
  7 Settembre 2011 a 12:41
  
  # 2
  
  Grazie Salvatore. :-)
  Chissà se qualcuno si é accorto del casino di stamattina….
- MelaS
  
  7 Settembre 2011 a 12:49
  
  # 3
  
  io si :-)
- nando pappalardo
  
  7 Settembre 2011 a 13:16
  
  # 4
  
  in realtà volevo testare la vostra attenzione :)
- MelaS
  
  7 Settembre 2011 a 14:36
  
  # 5
  
  Dai Nando ormai il danno è fatto, pubblicale tutte :-) hihihihihihi
- Maurizio
  
  7 Settembre 2011 a 22:31
  
  # 6
  
  Non dargli suggerimenti, é capace di farlo
nando pappalardo

7 Settembre 2011 a 13:21

# 7

faccio i complimenti ufficiali a maurizio per la chiarezza e la precisione con cui ha realizzato questa grande guida che in tantissimi di voi avevano richiesto :)

Rispondi
- Maurizio
  
  7 Settembre 2011 a 22:33
  
  # 8
  
  Grazie nà.
  Ho pensato di toglierti i diritti amministrativi :-)
Luca

7 Settembre 2011 a 14:25

# 9

Leggerò volentieri tutte le lezioni su come fare un plugins per WP per vedere se ho sbaglaito / dimenticato qualcosa nei plugins che ho sviluppato finora.

Rispondi
- Maurizio Tarchini
  
  7 Settembre 2011 a 22:39
  
  # 10
  
  Ciao Luca. Che genere di plugin hai realizzato? Ne hai pubblicati su WordPress.org?
- Luca
  
  7 Settembre 2011 a 22:44
  
  # 11
  
  Ho creato dei plugin che mi servivano per lavoro e quindi non sono stati pubblicati su wordpress.org perché servivano ad uso e consumo dei siti. Ad esempio per un sito ho fatto un plugins che data una pagina fb mi andava ad importare nei custom post field tutti gli url delle immagini degli album creando il relativo articolo in bozza.
lxn

7 Settembre 2011 a 14:51

# 12

Mi associo ai complimenti di Nando, come al solito Maurizio preciso e “semplice” da leggere! Grande!

Rispondi
- Maurizio Tarchini
  
  7 Settembre 2011 a 22:37
  
  # 13
  
  Grazie mille lxn !
tiziano

7 Settembre 2011 a 16:50

# 14

Complimenti a Maurizio, è sempre chiarissimo nell’esposizione…

Maurì date le nostre passioni comuni (la birra e php) posso tenerti come guru? :)

Rispondi
- Maurizio
  
  7 Settembre 2011 a 22:35
  
  # 15
  
  Certo Tiziano. Dal mio sito puoi anche ordinare le mie statuette in legno. Se ne prendi più di dieci ti mando anche l’altarino in regalo con un set di candele e una cassa di birra
Marco

8 Settembre 2011 a 11:08

# 16

Aaarghh l’attesta! Mi mangio le mani.

Rispondi
- Maurizio
  
  8 Settembre 2011 a 15:06
  
  # 17
  
  L’attesa… il sale della vita :-)
aledesign.it

8 Settembre 2011 a 12:25

# 18

Per chi lo usa e lo mastica tutti i giorni devo dire che è una guida pulita e scorrevole . Un buon lavoro. Mi associo pure io a i complimenti.

Rispondi
- Maurizio
  
  8 Settembre 2011 a 15:07
  
  # 19
  
  Grazie anche a te aledesign!
oly1982

8 Settembre 2011 a 14:50

# 20

F I N A L M E N T E !!!!!!!!!!!!!!!!!!!!!!!!
L’avevi accennato nel forum (http://forum.yourinspirationweb.com/css-dinamici-con-php-t983.html#p5367) e stavo in ansia nell’attesa che iniziassi a pubblicare questa serie di articoli.
Ps: … a ancora non lo leggo!!

Rispondi
- Maurizio
  
  8 Settembre 2011 a 15:08
  
  # 21
  
  Ciao oly,
  come non lo leggi?
- oly1982
  
  8 Settembre 2011 a 15:16
  
  # 22
  
  Intendevo dire che avevo commentato senza nemmeno averlo letto… ho commentato solo leggendo il titolo.
  PS: dovrrei dirti privatamente una cosina in relazione al casino di stamattina.