Trusted WordPress tutorials, when you need them most.
Beginner’s Guide to WordPress
Coppa WPB
25 Million+
Websites using our plugins
16+
Years of WordPress experience
3000+
WordPress tutorials
by experts

Come creare un plugin per WordPress (passo dopo passo per i principianti)

Nel corso degli anni abbiamo creato molti plugin per WordPress, aiutando noi stessi e migliaia di utenti. Molti dei nostri lettori ci hanno chiesto come poter creare anche loro i propri plugin.

Creare un plugin per WordPress può sembrare difficile all’inizio, ma in realtà è molto divertente e gratificante. Se volete aggiungere una nuova caratteristica al vostro sito o condividere qualcosa di utile con gli altri, la creazione di un plugin è un ottimo modo per farlo.

In questa guida vi mostreremo come creare il vostro primo plugin per WordPress passo dopo passo.

Step by step guide on creating a custom WordPress plugin for beginners

Di cosa avete bisogno per creare il vostro primo plugin per WordPress?

I plugin di WordPress sono come applicazioni per il vostro sito web. Proprio come le app sul vostro telefono, potete installare plugin in WordPress per aggiungere nuove caratteristiche.

Per saperne di più sui plugin di WordPress, consultate la nostra guida sui plugin di WordPress e sul loro funzionamento.

Per creare il vostro primo plugin per WordPress è necessaria una conoscenza di base dei linguaggi di codifica come PHP, CSS, HTML e JavaScript.

Può sembrare molto, ma non preoccupatevi: potete comunque seguire il nostro tutorial. Vi guideremo passo dopo passo attraverso il processo e, alla fine, avrete una conoscenza sufficiente della programmazione di WordPress per creare un semplice plugin per WordPress.

Per questo motivo, ci limiteremo alle nozioni di base e non ci addentreremo in competenze avanzate di codifica di WordPress.

In secondo luogo, avrete bisogno di un ambiente di sviluppo locale per testare il plugin di WordPress sul vostro computer. Per impostarlo, consultate la nostra guida su come installare WordPress sul vostro computer Windows o Mac).

È anche possibile testare il plugin su un sito web di staging. Tuttavia, se si verifica un errore, si può finire per rompere il sito web, rendendolo inaccessibile.

Consultate la nostra guida su come correggere gli errori più comuni di WordPress per risolvere questi problemi.

È inoltre necessario un editor di testo per scrivere il codice. Notepad o TextEdit andranno benissimo. Tuttavia, se volete provare qualcosa di più avanzato, selezionate questi editor del codice per sviluppatori.

Dopo averli preparati, iniziamo l’esercitazione. Potete usare i link rapidi qui sotto per passare a un argomento specifico:

Passo 1: Creare un plugin di base per WordPress

Il primo passo consiste nel creare una nuova cartella sul desktop o nella cartella dei documenti e assegnarle un nome come wpb-plugin-tutorial o my-first-plugin.

Successivamente, è necessario creare un nuovo file nell’editor di testo e salvarlo nella cartella dei plugin come wpb-plugin-tutorial.php o my-first-plugin.php. L’importante è l’estensione .php, ma il file può essere chiamato come si vuole.

Plugin folder and file

È necessario aprire il file PHP con il proprio editor di testo.

La prima cosa da aggiungere al file del plugin è l’header del plugin. Questo blocco di commenti indica semplicemente a WordPress il nome del plugin, la versione, il sito web, il nome dell’autore del plugin e altro ancora:

/*
Plugin Name:  WPBeginner Plugin Tutorial
Plugin URI:   https://www.wpbeginner.com
Description:  A short little description of the plugin. It will be displayed on the Plugins page in WordPress admin area.
Version:      1.0
Author:       WPBeginner
Author URI:   https://www.wpbeginner.com
License:      GPL2
License URI:  https://www.gnu.org/licenses/gpl-2.0.html
Text Domain:  wpb-tutorial
Domain Path:  /languages
*/

Dopo aver aggiunto l’header del plugin, si può iniziare ad aggiungere il codice del plugin sotto di esso.

Per questo tutorial, creeremo un semplice plugin che aggiunge un messaggio alla fine di ogni articolo, chiedendo agli utenti di seguirci su Twitter.

È sufficiente copiare e incollare il seguente codice sotto il blocco header del plugin:

<?php
function wpb_follow_us($content) {

// Only do this when a single post is displayed
if ( is_single() ) { 

// Message you want to display after the post
// Add URLs to your own Twitter and Facebook profiles

$content .= '<p class="follow-us">If you liked this article, then please follow us on <a href="http://twitter.com/wpbeginner" title="WPBeginner on Twitter" target="_blank" rel="nofollow">Twitter</a> and <a href="https://www.facebook.com/wpbeginner" title="WPBeginner on Facebook" target="_blank" rel="nofollow">Facebook</a>.</p>';

}
// Return the content
return $content; 

}
// Hook our function to WordPress the_content filter
add_filter('the_content', 'wpb_follow_us'); 

Non dimenticate di sostituire gli URL dei profili di Twitter e Facebook con i vostri prima di salvare le modifiche.

Ora andate sul desktop del vostro computer e create un file zip per la cartella dei plugin.

Gli utenti Mac possono fare clic con il tasto destro del mouse sulla cartella e selezionare “Comprimi wpb-plugin-tutorial”. Gli utenti Windows possono fare clic con il tasto destro del mouse sulla cartella e selezionare “Comprimi in file zip”.

Creating zip file of your plugin folder

Fase 2: Installazione e attivazione del primo plugin di WordPress

Ora che abbiamo creato il plugin, è il momento di installarlo per poterlo testare. Per istruzioni passo-passo, potete selezionare il nostro articolo su come installare un plugin di WordPress.

Accedete all’area di amministrazione di WordPress sul vostro sito web e visitate la pagina “Plugin ” Aggiungi nuovo.

Upload and install your custom WordPress plugin file

Per effettuare l’upload del plugin, fare clic sul pulsante “Upload Plugin” in alto. Verrà visualizzato il boxed uploader del plugin.

Fare clic sul pulsante “Scegli file” per selezionare il file zip appena creato. Quindi, fare clic sul pulsante “Installa ora” per caricare e installare il plugin.

Una volta installato, procedere all’attivazione del plugin.

Activate WordPress plugin

Ora è possibile visitare il sito web per vedere il plugin in azione.

Sarà possibile vedere il nuovo paragrafo alla fine di tutti i singoli articoli.

Plugin tested

Fase 3: Inviare il plugin al repository dei plugin di WordPress.org

Se volete che il vostro plugin venga scoperto e utilizzato da altri utenti di WordPress, potete inviarlo al repository dei plugin di WordPress.org.

Per farlo, è necessario creare un file “Leggimi” per il plugin. Aprire un file di testo vuoto e salvarlo come readme.txt nella cartella del plugin.

Questo file readme.txt deve rispettare la sintassi dei file readme di WordPress.org. Le informazioni aggiunte nel file readme.txt saranno visualizzate nella pagina del plugin su WordPress.org.

Ecco un file readme.txt di esempio che potete usare come punto di partenza:

=== Your Plugin Name ===
Contributors: WPBeginner
Tags: wpbeginner, plugin tutorial
Requires at least: 6.0
Tested up to: 6.2
Stable tag: 1.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

A WordPress plugin to teach beginners how to write a WordPress plugin. 

== Description ==

This simple plugin is part of our beginner's guide to writing a WordPress plugin. 

== Installation ==

1. Upload the plugin folder to your /wp-content/plugins/ folder.
1. Go to the **Plugins** page and activate the plugin.

== Frequently Asked Questions ==

= How do I use this plugin? =

Answer to the question

= How to uninstall the plugin? =

Simply deactivate and delete the plugin. 

== Screenshots ==
1. Description of the first screenshot.
1. Description of the second screenshot. 

== Changelog ==
= 1.0 =
* Plugin released.

Ora vi spieghiamo un po’ come funziona la sintassi del file readme dei plugin di WordPress, in modo che possiate personalizzarlo per il vostro plugin.

La prima riga del read me del plugin è il nome del plugin. Questo nome apparirà nella directory dei plugin di WordPress.org come titolo del plugin.

La riga successiva è Contributori. Questi sono gli ID utente responsabili della gestione del plugin su WordPress.org. Se non avete già un account utente di WordPress.org, potete creare un account utente gratuito di WordPress.org per ottenere il vostro ID.

I tag “Richiede almeno” e “Testato fino a” si riferiscono alle versioni di WordPress con cui il plugin funziona. Il tag “Stable” è la versione del vostro plugin.

È possibile lasciare i campi “Licenza” come GPL e l’URL invariato.

Poi, si può modificare l’area Descrizione per spiegare cosa fa il plugin.

Dopo aver modificato il file readme del plugin, non dimenticate di salvare le modifiche.

Ora il vostro plugin è pronto per essere esaminato dal team dei plugin di WordPress.org. Per inviare il plugin, è necessario disporre di un account gratuito su WordPress.org.

Visitate la pagina Add Your Plugin e, se non siete già connessi, fate clic sul pulsante “accedi”.

Logging in to WordPress before adding a new plugin

Una volta accedi, potrai fare l’uploader e inviare il tuo plugin per la revisione.

Fai clic sul pulsante “Seleziona file” per scegliere il file zip del tuo plugin. Dopodiché, basta selezionare tutte le caselle pertinenti e fare clic su “Uploader”.

Submitting a plugin to WordPress

Il team di revisione dei plugin di WordPress.org esaminerà il codice del plugin alla ricerca di errori comuni e di controlli di sicurezza. Una volta approvato, riceverete un’email dal team dei plugin.

Questa email conterrà un collega al repository Subversion (SVN) del plugin ospitato su WordPress.org.

Passo 4: Usare Subversion (SVN) per caricare il plugin

Subversion è un software di controllo delle versioni. Permette agli utenti di apportare modifiche a file e directory, conservando un registro delle modifiche, gestendo versioni diverse e consentendo la collaborazione.

Per effettuare l’upload del plugin su WordPress.org è necessario avere un client SVN installato sul computer.

Gli utenti Windows possono utilizzare SilkSVN o TortoiseSVN (gratuiti). Gli utenti Mac possono installare SmartSVN o Versions App sui loro computer.

In questo articolo vi mostreremo degli screenshot dell’applicazione Versions per Mac. Tuttavia, il processo è molto simile in tutte le applicazioni SVN con interfaccia grafica.

Una volta installato, è necessario aprire l’applicazione Versions e controllare una copia del repository del plugin WordPress. Fate clic sul pulsante “Nuovo repository”.

New repository bookmark

Si aprirà una finestra a comparsa in cui è necessario fornire un nome per questo segnalibro. È possibile assegnargli il nome del plugin.

Successivamente, è necessario aggiungere l’URL del repository SVN del plugin di WordPress.

Connect your repository

Fai clic sul pulsante “Crea” per collegarti al tuo repository.

L’applicazione Versions scaricherà una copia del repository del plugin sul computer. Quindi, fare clic con il tasto destro del mouse sul nome del repository nella visualizzazione del browser e selezionare “Paga”.

Check out your repository

Verrà chiesto di fornire un nome per la cartella e di selezionare una posizione in cui memorizzarla sul computer. È possibile utilizzare lo stesso nome della cartella della directory del plugin e fare clic sul pulsante “Paga” per continuare.

L’applicazione Versions creerà ora una copia locale del plugin sul computer. È possibile visualizzarla nel repository del plugin o sfogliarla con l’applicazione Finder.

Show local repository in Finder

Ora è necessario copiare i file del plugin e incollarli nella cartella trunk del repository locale.

In questo modo, noterete un’icona a forma di punto interrogativo accanto ai nuovi file nell’app Versioni.

Poiché questi file non esistevano prima, è necessario “aggiungerli”. Selezionare i nuovi file e fare clic sul pulsante “Add” per aggiungerli alla cartella locale.

Add files

Ora che i file del plugin sono stati aggiunti alla subversione, si è pronti a fare l’uploader. In pratica, si sincronizzeranno le modifiche nella cartella locale e nella directory di subversion.

Fate clic sul vostro repository locale per selezionarlo, quindi fate clic sul pulsante ‘Commit’.

Commit changes

Appare una nuova finestra di dialogo.

Verrà visualizzato l’elenco delle modifiche e una boxed per aggiungere un messaggio di commit. Fate clic su “Impegna” per procedere.

Adding a commit message

L’applicazione SVN ora sincronizzerà le modifiche e le inserirà nel repository del plugin.

Ora che i file del plugin sono stati caricati nel trunk, è il momento di taggarli a una versione.

Andare alla copia locale del plugin e copiare i file all’interno della cartella trunk. Successivamente, è necessario aprire la cartella tagga e, al suo interno, creare una nuova cartella.

Assegnare a questa cartella il nome di una versione. Assicurarsi che corrisponda alla versione inserita nell’header del plugin. Nel codice di esempio qui sopra, abbiamo usato la versione 1.0 per il nostro plugin.

Dopo aver aggiunto la cartella 1.0 nella cartella /tags/. Si noterà l’icona del punto interrogativo accanto al nome della cartella nell’app Versione.

Poiché si tratta di una nuova cartella, è necessario fare clic sul pulsante ‘Add’ per includere la cartella e tutti i suoi file nel repository.

Add files

Dopodiché, si può andare avanti e fare clic sul pulsante “Impegna” per sincronizzare le modifiche. È possibile continuare a modificare i file del plugin nella copia locale.

Una volta terminate le modifiche, fate clic sul pulsante di commit per sincronizzarle con il repository di WordPress.org.

Se sono state apportate modifiche importanti al plugin, è necessario aggiungere una nuova versione aggiungendo una nuova cartella con il numero della versione. Assicurarsi che il numero di versione corrisponda all’header del plugin.

Ora è possibile visualizzare l’anteprima del plugin nella directory dei plugin di WordPress.org.

Passo 5: Add-on al vostro plugin su WordPress.org

MonsterInsights plugin banner image

WordPress.org consente di aggiungere artwork e screenshot ai plugin. Questi elementi devono seguire le pratiche di denominazione standard e devono essere caricati utilizzando Subversion.

Banner dell’header del plugin

È l’immagine grande che appare in alto nella pagina del plugin. Può essere di 772 x 250 o 1544 x 500 pixel nei formati jpeg o png. Dovrebbe sempre essere denominata in questo modo:

  • banner-772×250.jpg o banner-772×250.png
  • banner-1544×500.jpg o banner-1544×500.png

Icona del plugin

Questo file immagine di forma quadrata più piccola viene visualizzato come icona del plugin nei risultati della ricerca e negli elenchi dei plugin. Può essere di 125 x 125 o 250 x 250 pixel nei formati file jpeg o png.

Questo file di icone deve avere il seguente nome:

  • icona-128×128.jpg o icona-128×128..png
  • icona-256×256.jpg o icona-256×256.png

Screenshot

I file di screenshot devono essere denominati nel seguente formato:

  • screenshot-1.png
  • screenshot-2.png

È possibile aggiungerne quante se ne vogliono. Gli screenshot devono apparire nello stesso ordine delle descrizioni degli screenshot nel file readme.txt.

Una volta preparato tutto l’artwork, è possibile inserirlo nella cartella assets della copia locale del plugin.

Successivamente, si noterà un’icona a forma di punto interrogativo accanto alla cartella delle risorse. Fare clic sul pulsante ‘Add’ per aggiungere il nuovo file delle risorse al repository.

Add assets

Infine, fate clic sul pulsante di commit per caricare i file nel repository di WordPress.org. Dopo un po’, sarà possibile vedere l’opera d’arte apparire sulla pagina del plugin.

Guide definitive per Learn WordPress Plugin Development

I plugin di WordPress possono essere semplici come quello che vi abbiamo mostrato sopra. Possono anche essere molto più potenti, come quiz, timer per il conto alla rovescia, RSVP, votazioni, recensioni su Google e molto altro ancora.

Alcuni potenti plugin di WordPress possono avere anche degli add-on. Questi add-on funzionano come plugin che estendono altri plugin.

Ecco alcune risorse che vi aiuteranno ad approfondire i modi per aggiungere funzionalità ai vostri plugin di WordPress:

Speriamo che questo articolo vi abbia aiutato a imparare come creare un plugin per WordPress. Potreste anche dare un’occhiata alla nostra guida su come proporre nuove caratteristiche per WordPress e al nostro elenco delle aziende e società WordPress di maggior successo.

Se questo articolo vi è piaciuto, iscrivetevi al nostro canale YouTube per le esercitazioni video su WordPress. Potete trovarci anche su Twitter e Facebook.

Divulgazione: I nostri contenuti sono sostenuti dai lettori. Ciò significa che se cliccate su alcuni dei nostri link, potremmo guadagnare una commissione. Vedi come WPBeginner è finanziato , perché è importante e come puoi sostenerci. Ecco il nostro processo editoriale .

Avatar

Editorial Staff at WPBeginner is a team of WordPress experts led by Syed Balkhi with over 16 years of experience in WordPress, Web Hosting, eCommerce, SEO, and Marketing. Started in 2009, WPBeginner is now the largest free WordPress resource site in the industry and is often referred to as the Wikipedia for WordPress.

Il kit di strumenti WordPress definitivo

Ottenete l'accesso gratuito al nostro kit di strumenti - una raccolta di prodotti e risorse relative a WordPress che ogni professionista dovrebbe avere!

Reader Interactions

38 commentiLascia una risposta

  1. Syed Balkhi

    Hey WPBeginner readers,
    Did you know you can win exciting prizes by commenting on WPBeginner?
    Every month, our top blog commenters will win HUGE rewards, including premium WordPress plugin licenses and cash prizes.
    You can get more details about the contest from here.
    Start sharing your thoughts below to stand a chance to win!

  2. mohadese esmaeeli

    How interesting that every feature we have in mind can be created as a plugin and installed in WordPress. I’ve installed the Jannah theme on my site, but it has some shortcodes, and I’m planning to change the theme. With the method you provided, maybe I can keep the shortcodes of the previous theme as a plugin alongside the new theme.

    • WPBeginner Support

      It would require some coding knowledge but you could look to add the features to your new theme :)

      Admin

  3. maven

    How do you end the plugin code? with this } or what?

    • WPBeginner Support

      It would depend on the code you are using, you want to use } if there is an opening { that needs to be closed but you do not need a specific end of file marker.

      Admin

  4. andrea vironda

    What would happen if I avoid to use “add_filter(‘the_content’, ‘wpb_follow_us’);”?

    • WPBeginner Support

      If you don’t use that code then the paragraph with your follow links would not be added to the end of the content. The $content is the links to be added and the add_filter is what includes it in the content.

      Admin

  5. andrea vironda

    What’s the meaning of “Text Domain” and “Domain path”?

    • WPBeginner Support

      The Text domain is used to tell where your text is located for translation purposes and must be the same as the folder name.

      The Domain path is where translations for your plugin can be found.

      Admin

  6. Ritik

    Thanks,
    its very helpfull.

    • WPBeginner Support

      Glad we could show how to create a plugin in a beginner friendly way :)

      Admin

  7. Raja Poudel

    Your explanation is very simple to understand for me as a beginner in wordpress plugin development.

    • WPBeginner Support

      Glad you found our guide helpful :)

      Admin

  8. Ahroihan

    Hello,
    I want to make a plugin, can you give me tutorial about it?
    Thank you

  9. mamta

    hi,i’m php developer and wordpress developer.i would like to create custom wordpress plugin.please send tutorials.

  10. Siva

    Hi i am php and wordpress developer, so i want to create custom wordpress plugin

    please give me plugin tutorials and help to create plugin.

  11. ramesh ram

    hi,i’m php developer and wordpress developer.i would like to create custom wordpress plugin.please send tutorials.

  12. Marcy

    I’m a virgin programer, but have decided to create my own plug in for a fund raiser thermometer for my adoption blog because none of the ones I’ve found are comparable with my WP version and have what I want on them… and needless to say, I need help, direction, tips, something similar to what I need that I can tweek… etc. Please help ! :) thanks

  13. suresh

    It’s Good Article and it’s much simple

  14. JasonCrews

    Wordpressmodder is a viagra site now

  15. rakeshtiwary022

    hi am php and wordpress developer, so i want to create custom wordpress plugin

    please give me plugin tutorials and help to create plugin

    email:-rakeshtiwary022@gmail.com

  16. HomeTivi

    hi am php and wordpress developer, so i want to create custom wordpress plugin

    please give me plugin tutorials and help to create plugin

  17. MannuSingh

    hi am php and wordpress developer, so i want to create custom wordpress plugin

    please give me plugin tutorials and help to create plugin

  18. Bagesh Singh

    I am a programmer. From last two days I am trying to create custom plugin and it’s help me better thanks a lot.

  19. Nigel

    Thanks for this great collection of articles. I can’t wait to get started hacking together my own plugin :)

  20. Dadang Iskandar

    I am very grateful to find this article because I’m learning php programming. very nice brother

  21. John Franklin

    Very nice, I’m a huge fan of Wordpress and it’s great to see new really useful plugins getting released. I’ll download and check it out, looks exactly like what I have been looking for for weeks. So, thanks alot!

  22. Kent Tan

    Nice collection of tutorials. Where can I get the more advanced stuff – e.g. creating an options page to configure the plugin etc?

  23. Brad

    Thanks for the article, have always wanted to know a little more about making plugins so now I will give it a try!

  24. Tim Trice

    Two of the first four cover the same function of echoing “Hello World” (the first, at least, let’s you customize the echo statement). I’d like to see some more articles focused on plugin standards, deactivation hooks and removing data from the DB as well as exports.

  25. Marco

    Well, I suggest to change the title from “How to Create a WordPress Plugin” to “A list of the best tutorials to help you create your own WordPress Plugin”. ;-)

    • Anwer

      Well that’s good Idea..!!!Agree with you

Lascia una risposta

Grazie per aver scelto di lasciare un commento. Tenga presente che tutti i commenti sono moderati in base alle nostre politica dei commenti e il suo indirizzo e-mail NON sarà pubblicato. Si prega di NON utilizzare parole chiave nel campo del nome. Avremo una conversazione personale e significativa.