Come Creare un Plugin Personalizzato per WordPress da Zero

Vuoi creare un plugin per WordPress ma non sai da dove iniziare? Sei nel posto giusto! In questa guida, ti spiegherò passo dopo passo come creare un plugin WordPress da zero.

Seguendo questa guida imparerai a:
Strutturare il tuo plugin e renderlo compatibile con WordPress.
Aggiungere funzionalità personalizzate con shortcode e menu di amministrazione.
Ottimizzare e testare il plugin per evitare errori.

Se sei pronto, prendiamo il nostro editor di codice e iniziamo! 🔥

WordPress Creare Plugin: Cosa Significa e Perché Farlo?

Un plugin di WordPress è un pacchetto di codice che aggiunge nuove funzionalità al tuo sito senza dover modificare direttamente il core di WordPress.

I vantaggi di creare un plugin per WordPress sono tanti:
Personalizzazione totale: puoi creare funzionalità esattamente come servono a te.
Manutenzione più facile: separando le funzionalità dal tema, non rischi di perderle con gli aggiornamenti.
Possibilità di condividerlo: puoi anche pubblicarlo nella directory WordPress o venderlo!

Ora che sappiamo perché un plugin è utile, vediamo come crearlo da zero.

Preparazione: Strumenti Necessari

Per creare il nostro primo plugin, abbiamo bisogno di:
Un sito WordPress installato (in locale con LocalWP, XAMPP o su un hosting).
Un editor di codice come Visual Studio Code o Sublime Text.
Conoscenze base di PHP, HTML e CSS (ma niente paura, ti guiderò passo dopo passo).

Pronto? Partiamo! 🚀

Struttura Base del Plugin

La prima cosa da fare è creare una cartella nella directory dei plugin di WordPress:

Vai nella cartella:
/wp-content/plugins/

Crea una nuova cartella e chiamala:
mio-plugin-personalizzato

Dentro questa cartella, crea un file PHP principale, ad esempio:
mio-plugin-personalizzato.php

Apri il file e incolla questo codice base:

<?php
/**
 * Plugin Name: Mio Plugin Personalizzato
 * Plugin URI: https://tuosito.it
 * Description: Un semplice plugin di esempio per WordPress.
 * Version: 1.0
 * Author: Il Tuo Nome
 * Author URI: https://tuosito.it
 * License: GPL2
 */

if (!defined('ABSPATH')) {
    exit; // Impedisce accessi diretti al file
}

Cosa fa questo codice?

Definisce il nome del plugin e i dettagli e protegge il file da accessi diretti usando if (!defined('ABSPATH')).

Ora, vai su WordPress → Plugin e vedrai il tuo plugin nella lista! 🥳

Aggiungere Funzionalità al Plugin

Ora che abbiamo la struttura base, aggiungiamo qualche funzionalità.

Aggiungere un Messaggio Personalizzato nella Dashboard

Vuoi che WordPress mostri un messaggio personalizzato nella dashboard? Aggiungiamo questo codice:

function mio_plugin_messaggio_dashboard() {
    echo '<div class="notice notice-success is-dismissible">
        <p>Ciao! Il mio plugin personalizzato è attivo! 🎉</p>
    </div>';
}
add_action('admin_notices', 'mio_plugin_messaggio_dashboard');

Quando attivi il plugin, vedrai un messaggio nella dashboard di WordPress.

Aggiungere uno Shortcode

Gli shortcode sono piccoli codici che puoi usare nei post e nelle pagine. Creiamo uno shortcode che mostra un messaggio personalizzato:

function mio_plugin_shortcode() {
    return "<p style='color: blue; font-weight: bold;'>Questo è un messaggio dal mio plugin! 🔥</p>";
}
add_shortcode('mio_shortcode', 'mio_plugin_shortcode');

Come usarlo?
Basta scrivere [mio_shortcode] in un articolo o una pagina.

Creare Plugin per WordPress con una Pagina di Impostazioni

Vuoi aggiungere un’opzione nel menu di amministrazione? Facciamolo!

function mio_plugin_aggiungi_menu() {
    add_menu_page(
        'Mio Plugin',
        'Mio Plugin',
        'manage_options',
        'mio-plugin',
        'mio_plugin_pagina_admin',
        'dashicons-admin-generic',
        20
    );
}

function mio_plugin_pagina_admin() {
    echo '<div class="wrap"><h1>Impostazioni del Mio Plugin</h1></div>';
}

add_action('admin_menu', 'mio_plugin_aggiungi_menu');

Cosa succede?

Creiamo un nuovo menu nella dashboard di WordPress con un’icona personalizzata.
Quando lo clicchi, ti porta a una pagina con un titolo.

Salvare le Impostazioni del Plugin

Aggiungiamo un campo di input per salvare delle impostazioni!

function mio_plugin_form() {
    ?>
    <div class="wrap">
        <h1>Impostazioni del Mio Plugin</h1>
        <form method="post" action="options.php">
            <?php
            settings_fields('mio_plugin_opzioni');
            do_settings_sections('mio_plugin');
            submit_button();
            ?>
        </form>
    </div>
    <?php
}

function mio_plugin_registra_opzioni() {
    register_setting('mio_plugin_opzioni', 'mio_plugin_testo');
    
    add_settings_section(
        'mio_plugin_sezione',
        'Personalizza il tuo Plugin',
        null,
        'mio_plugin'
    );

    add_settings_field(
        'mio_plugin_testo',
        'Testo personalizzato',
        'mio_plugin_testo_callback',
        'mio_plugin',
        'mio_plugin_sezione'
    );
}

function mio_plugin_testo_callback() {
    $valore = get_option('mio_plugin_testo', '');
    echo "<input type='text' name='mio_plugin_testo' value='$valore'>";
}

add_action('admin_menu', 'mio_plugin_aggiungi_menu');
add_action('admin_init', 'mio_plugin_registra_opzioni');

Ora puoi salvare un valore personalizzato direttamente dalla dashboard! 🎯

Salvare i Dati del Plugin nel Database di WordPress

Molti plugin hanno bisogno di memorizzare informazioni per funzionare correttamente, come impostazioni personalizzate o dati utente. Ma dove vengono salvati questi dati?

WordPress utilizza un database MySQL, che archivia contenuti, utenti, impostazioni e molto altro. Se vuoi approfondire come WordPress utilizza il database, leggi il nostro articolo dedicato:
👉 Perché WordPress richiede un database?

Come Salvare le Impostazioni del Plugin

Se vuoi che il tuo plugin salvi dati nel database, puoi usare la funzione update_option() per memorizzare valori personalizzati. Ad esempio:

update_option('mio_plugin_testo', 'Questo è il mio valore salvato!');

Per recuperarlo successivamente, basta usare get_option():

$valore = get_option('mio_plugin_testo');
echo "Il valore salvato è: " . $valore;

Perché è utile?

• Evita di dover creare manualmente nuove tabelle nel database.
• I dati vengono gestiti in modo sicuro e ottimizzato da WordPress.

Conclusione e Prossimi Passi

Abbiamo visto come creare un plugin WordPress da zero, aggiungere shortcode, creare una pagina di impostazioni e personalizzare il backend. Questo è solo l’inizio! 🚀

Dove trovo la documentazione ufficiale per lo sviluppo di plugin WordPress?

La documentazione ufficiale si trova sul sito di WordPress: https://developer.wordpress.org/plugins/

Prossimi passi:

• Migliorare la sicurezza con funzioni di validazione.
• Creare tabelle personalizzate nel database.
• Integrare il plugin con API esterne.

Se hai domande o vuoi approfondire, scrivimi nei commenti! 👇💬

👉 Hai mai provato a creare un plugin per WordPress? Raccontami la tua esperienza! 😊

FAQ