Come creare un plugin per WordPress: guida passo passo

Guida Completa: Come Creare un Plugin per WordPress da Zero

Creare un plugin per WordPress può sembrare un compito complesso, soprattutto se è la tua prima esperienza come sviluppatore. Tuttavia, con questa guida passo-passo, imparerai a costruire un plugin WordPress funzionante, ben strutturato e ottimizzato per SEO.

Introduzione: Cos’è un Plugin WordPress?

Un plugin è un componente software che estende le funzionalità di base di WordPress senza modificare il core. Grazie ai plugin, puoi aggiungere nuove caratteristiche al tuo sito web, come moduli di contatto, gallerie di immagini o strumenti di SEO.

Prerequisiti

Prima di iniziare, assicurati di avere:

1. Conoscenza base di PHP: WordPress si basa su PHP.
2. Accesso al tuo sito WordPress: Puoi utilizzare un ambiente di sviluppo locale (come XAMPP, MAMP o Local by Flywheel) o un server remoto.
3. Editor di testo: Consigliato Visual Studio Code o Sublime Text.
4. Familiarità con WordPress: Conoscere l’architettura dei file e il backend.

Passo 1: Configurazione dell’Ambiente

1. Crea una cartella per il tuo plugin:
   • Vai nella directory wp-content/plugins/ del tuo sito WordPress.
   • Crea una nuova cartella con il nome del tuo plugin, ad esempio mio-plugin.
2. Crea il file principale del plugin:
   • All’interno della cartella appena creata, aggiungi un file PHP con il nome del plugin. Ad esempio, mio-plugin.php.
3. Aggiungi l’intestazione del plugin: Ogni plugin WordPress richiede un’intestazione specifica per essere riconosciuto. Apri il file mio-plugin.php e aggiungi il seguente codice:

   <?php
   /*
   Plugin Name: Mio Primo Plugin
   Plugin URI: https://esempio.com/mio-plugin
   Description: Un plugin di esempio per imparare a creare plugin WordPress.
   Version: 1.0
   Author: Il Tuo Nome
   Author URI: https://esempio.com
   License: GPL2
   */
   ?>

   Questo codice fornisce a WordPress le informazioni necessarie per identificare e visualizzare il tuo plugin nella dashboard.

4. Attiva il plugin:
   • Vai nella dashboard di WordPress > Plugin.
   • Troverai il tuo plugin nella lista. Clicca su Attiva.

Passo 2: Aggiungere Funzionalità di Base

Ora che il plugin è attivo, puoi iniziare ad aggiungere funzionalità.

2.1 Creare un Hook per Visualizzare un Messaggio

Gli hook sono fondamentali in WordPress. Possono essere action hook (eseguono codice in un punto specifico) o filter hook (modificano i dati).

Esempio di action hook per visualizzare un messaggio nel footer:

<?php
function mio_plugin_messaggio_footer() {
    echo '<p style="text-align: center; color: blue;">Grazie per aver visitato il nostro sito!</p>';
}
add_action('wp_footer', 'mio_plugin_messaggio_footer');
?>

2.2 Creare uno Shortcode

Gli shortcode permettono di inserire contenuti dinamici all’interno delle pagine o dei post.

Aggiungi il seguente codice per creare uno shortcode che visualizza un messaggio:

<?php
function mio_plugin_shortcode() {
    return '<h3 style="color: green;">Questo è un contenuto generato dal mio plugin!</h3>';
}
add_shortcode('mio_shortcode', 'mio_plugin_shortcode');
?>

Puoi ora usare [mio_shortcode] nei post o pagine per visualizzare il messaggio.

Passo 3: Creare una Pagina di Impostazioni del Plugin

Per plugin più avanzati, è utile avere una pagina dedicata alle impostazioni.

1. Aggiungere un menu nella dashboard:

   <?php
   function mio_plugin_menu() {
       add_menu_page(
           'Impostazioni Mio Plugin', // Titolo della pagina
           'Mio Plugin', // Nome nel menu
           'manage_options', // Permessi richiesti
           'mio-plugin-settings', // Slug
           'mio_plugin_settings_page' // Funzione che renderizza la pagina
       );
   }
   add_action('admin_menu', 'mio_plugin_menu');
   function mio_plugin_settings_page() {
       ?>
       <div class="wrap">
           <h1>Impostazioni del Mio Plugin</h1>
           <form method="post" action="options.php">
               <?php
               settings_fields('mio_plugin_options_group');
               do_settings_sections('mio-plugin-settings');
               submit_button();
               ?>
           </form>
       </div>
       <?php
   }
   ?>

    

2. Aggiungere opzioni di impostazione:

   <?php
   function mio_plugin_register_settings() {
       register_setting('mio_plugin_options_group', 'mio_plugin_option_name');
       add_settings_section('mio_plugin_main_section', 'Sezione Principale', null, 'mio-plugin-settings');
       add_settings_field('mio_plugin_option_field', 'Opzione Esempio', 'mio_plugin_option_callback', 'mio-plugin-settings', 'mio_plugin_main_section');
   }
   add_action('admin_init', 'mio_plugin_register_settings');
   function mio_plugin_option_callback() {
       $option = get_option('mio_plugin_option_name');
       echo '<input type="text" name="mio_plugin_option_name" value="' . esc_attr($option) . '" />';
   }
   ?>

   Ora avrai una pagina di impostazioni con un campo input salvato nel database.

Passo 4: Sicurezza e Best Practices

1. Sanitizzare i dati: Usa sanitize_text_field() per pulire i dati prima di salvarli.
2. Validare i dati: Controlla i dati prima di utilizzarli.
3. Escapare output: Usa esc_html() o esc_attr() per evitare attacchi XSS.
4. Proteggere i file PHP: Aggiungi un controllo all’inizio di ogni file:

   if (!defined('ABSPATH')) {
       exit; // Exit if accessed directly
   }

    

5. Utilizzare nonce per form: Protegge i form da CSRF.

Passo 5: Testare e Distribuire il Plugin

1. Test locale: Utilizza strumenti come WP_DEBUG per individuare errori.
2. Validare il codice: Usa PHP CodeSniffer con le regole di WordPress.
3. Crea un file ZIP: Comprimi la cartella del plugin.
4. Distribuzione: Puoi caricare il plugin su WordPress.org seguendo le linee guida ufficiali.

Conclusione

Creare un plugin per WordPress è un ottimo modo per imparare a sviluppare funzionalità avanzate e contribuire all’ecosistema WordPress. Seguendo questa guida passo-passo, hai costruito un plugin funzionante con funzionalità di base, una pagina di impostazioni e misure di sicurezza.

Ora è il momento di sperimentare e aggiungere nuove caratteristiche al tuo plugin!

Non esitare a contattarci per qualsiasi informazione