scrivim un plugin worpdres
- User
scrivim un plugin worpdres
Assistant
Certamente! Ti guiderò passo dopo passo nella creazione di un plugin WordPress semplice ma funzionale.
L'idea è questa: creeremo un plugin che aggiunge un box di "Call to Action" (invito all'azione) alla fine di ogni singolo articolo del tuo blog. Questo è un ottimo esempio per iniziare perché tocca i concetti fondamentali dello sviluppo di plugin.
Segui questi passaggi.
Passo 1: L'idea e la preparazione
- Cosa farà il plugin? Aggiungerà un blocco di testo e un pulsante personalizzabili alla fine di ogni post (ma non sulle pagine o nell'elenco degli articoli).
- Cosa ti serve?
- Un sito WordPress su cui fare dei test (preferibilmente un'installazione locale come LocalWP o MAMP, ma va bene anche un sito di prova online).
- Un editor di testo (come Visual Studio Code, Sublime Text, o anche il Blocco Note di Windows).
Passo 2: Creare i file del plugin
WordPress riconosce i plugin tramite una cartella e un file PHP al suo interno.
- Vai nella cartella di installazione di WordPress.
- Naviga in
wp-content/plugins/. - Crea una nuova cartella. Chiamiamola
mio-primo-plugin. - All'interno di questa cartella, crea un file PHP. Chiamiamolo
mio-primo-plugin.php.
La tua struttura sarà così:
wp-content/plugins/mio-primo-plugin/mio-primo-plugin.php
Passo 3: L'intestazione (Header) del Plugin
Questo è il passo più importante. WordPress identifica il tuo file come un plugin leggendo uno speciale blocco di commenti all'inizio del file.
Apri il file
mio-primo-plugin.phpe incolla questo codice all'inizio:<?php /** * Plugin Name: Il Mio Primo Plugin * Plugin URI: https://esempio.com/plugin * Description: Aggiunge un box "Call to Action" alla fine di ogni articolo. * Version: 1.0 * Author: Il Tuo Nome * Author URI: https://esempio.com * License: GPL v2 or later * License URI: https://www.gnu.org/licenses/gpl-2.0.html * Text Domain: mio-primo-plugin */ // Impedisce l'accesso diretto al file if ( ! defined( 'ABSPATH' ) ) { exit; }Spiegazione:
- Plugin Name: Il nome che vedrai nella bacheca di WordPress.
- Description: Una breve descrizione di ciò che fa.
- Version: Utile per gestire gli aggiornamenti.
- Author: Il tuo nome.
- La riga
if ( ! defined( 'ABSPATH' ) )è una misura di sicurezza standard per impedire che qualcuno possa accedere al tuo file PHP direttamente dal browser.
A questo punto, se vai nella bacheca di WordPress > Plugin, vedrai già il tuo plugin nell'elenco! Puoi anche già attivarlo, ma ovviamente non farà ancora nulla.
Passo 4: Scrivere la funzione principale (la logica)
Ora scriviamo il codice che fa il lavoro. Useremo un "hook", in particolare un "filtro" chiamato
the_content. Questo filtro permette di modificare il contenuto di un articolo prima che venga mostrato a schermo.Aggiungi questo codice nel tuo file
mio-primo-plugin.php, subito dopo l'intestazione:/** * Aggiunge il box CTA alla fine del contenuto dell'articolo. * * @param string $content Il contenuto originale dell'articolo. * @return string Il contenuto modificato con il box CTA. */ function mpp_aggiungi_box_cta($content) { // Vogliamo mostrare il box solo negli articoli singoli ("post") // e non nella home page o negli archivi. if ( is_single() && in_the_loop() && is_main_query() ) { // Il nostro HTML per il box CTA $cta_html = ' <div class="mpp-cta-box"> <h3>Ti è piaciuto questo articolo?</h3> <p>Iscriviti alla nostra newsletter per non perdere i prossimi contenuti!</p> <a href="#" class="mpp-cta-button">Iscriviti Ora</a> </div>'; // Aggiungiamo il nostro box alla fine del contenuto originale return $content . $cta_html; } // Se non siamo in un articolo singolo, restituiamo il contenuto senza modifiche. return $content; } // "Agganciamo" la nostra funzione al filtro 'the_content' di WordPress. add_filter('the_content', 'mpp_aggiungi_box_cta');Spiegazione:
function mpp_aggiungi_box_cta($content): Definiamo una funzione che accetta un parametro,$content. WordPress passerà automaticamente il contenuto dell'articolo a questa variabile.if ( is_single() ): Questa è una funzione di WordPress che controlla se la pagina visualizzata è un singolo articolo. Questo è fondamentale per evitare di mostrare il box ovunque.$cta_html: Una semplice variabile che contiene il codice HTML del nostro box.return $content . $cta_html;: Concatena il contenuto originale dell'articolo con il nostro HTML e lo restituisce. La parola chiavereturnè essenziale.add_filter('the_content', 'mpp_aggiungi_box_cta');: Questa è la magia. Dice a WordPress: "Ogni volta che stai per mostrare il contenuto di un post (the_content), prima passalo attraverso la mia funzionempp_aggiungi_box_cta".
Passo 5: Aggiungere un po' di stile (CSS)
Il box ora appare, ma probabilmente è brutto. Aggiungiamo un po' di CSS per renderlo più carino. Il modo corretto per aggiungere CSS in WordPress è "accodare" uno stylesheet.
- Nella tua cartella
mio-primo-plugin, crea una nuova sottocartella chiamatacss. - Dentro
css, crea un file chiamatostyle.css.
La struttura ora è:
wp-content/plugins/mio-primo-plugin/css/style.cssApri
style.csse incolla questo stile:.mpp-cta-box { border: 2px solid #0073aa; background-color: #f3f5f6; padding: 20px; margin-top: 30px; border-radius: 8px; text-align: center; } .mpp-cta-box h3 { margin-top: 0; color: #1d2327; } .mpp-cta-box p { font-size: 16px; } .mpp-cta-button { display: inline-block; background-color: #0073aa; color: #ffffff; padding: 10px 20px; text-decoration: none; border-radius: 5px; font-weight: bold; transition: background-color 0.3s; } .mpp-cta-button:hover { background-color: #005a87; color: #ffffff; }Ora, torna al tuo file
mio-primo-plugin.phpe aggiungi questo nuovo pezzo di codice per dire a WordPress di caricare il file CSS:/** * Accoda lo stylesheet del plugin. */ function mpp_enqueue_styles() { // Registra e accoda il nostro file CSS. wp_enqueue_style( 'mpp-style', // un nome univoco per il nostro stile plugin_dir_url(__FILE__) . 'css/style.css', // il percorso del file [], // nessuna dipendenza '1.0' // la versione del file ); } // "Agganciamo" la funzione all'hook 'wp_enqueue_scripts'. add_action('wp_enqueue_scripts', 'mpp_enqueue_styles');Spiegazione:
wp_enqueue_style(): È la funzione corretta di WordPress per caricare i file CSS.plugin_dir_url(__FILE__): Una funzione magica che restituisce l'URL della cartella del tuo plugin. Questo garantisce che il percorso sia sempre corretto, indipendentemente da dove è installato WordPress.add_action('wp_enqueue_scripts', ...): Usiamo un'altra azione,wp_enqueue_scripts, che è il momento giusto nel caricamento di WordPress per aggiungere CSS e JavaScript.
Passo 6: Attivazione e Test
Se non l'hai già fatto, vai in Bacheca > Plugin:
- Trova "Il Mio Primo Plugin" e clicca su Attiva.
- Ora visita uno qualsiasi degli articoli del tuo blog.
- Scorri fino in fondo e... voilà! Dovresti vedere il tuo box "Call to Action" con lo stile che abbiamo definito.
Il codice completo finale
Ecco come dovrebbe apparire il tuo file
mio-primo-plugin.phpcompleto:<?php /** * Plugin Name: Il Mio Primo Plugin * Plugin URI: https://esempio.com/plugin * Description: Aggiunge un box "Call to Action" alla fine di ogni articolo. * Version: 1.0 * Author: Il Tuo Nome * Author URI: https://esempio.com * License: GPL v2 or later * License URI: https://www.gnu.org/licenses/gpl-2.0.html * Text Domain: mio-primo-plugin */ // Impedisce l'accesso diretto al file if ( ! defined( 'ABSPATH' ) ) { exit; } /** * Aggiunge il box CTA alla fine del contenuto dell'articolo. * * @param string $content Il contenuto originale dell'articolo. * @return string Il contenuto modificato con il box CTA. */ function mpp_aggiungi_box_cta($content) { // Vogliamo mostrare il box solo negli articoli singoli ("post") if ( is_single() && in_the_loop() && is_main_query() ) { // Il nostro HTML per il box CTA $cta_html = ' <div class="mpp-cta-box"> <h3>Ti è piaciuto questo articolo?</h3> <p>Iscriviti alla nostra newsletter per non perdere i prossimi contenuti!</p> <a href="#" class="mpp-cta-button">Iscriviti Ora</a> </div>'; // Aggiungiamo il nostro box alla fine del contenuto originale return $content . $cta_html; } // Se non siamo in un articolo singolo, restituiamo il contenuto senza modifiche. return $content; } // "Agganciamo" la nostra funzione al filtro 'the_content' di WordPress. add_filter('the_content', 'mpp_aggiungi_box_cta'); /** * Accoda lo stylesheet del plugin. */ function mpp_enqueue_styles() { // Registra e accoda il nostro file CSS. wp_enqueue_style( 'mpp-style', // un nome univoco per il nostro stile plugin_dir_url(__FILE__) . 'css/style.css', // il percorso del file [], // nessuna dipendenza '1.0' // la versione del file ); } // "Agganciamo" la funzione all'hook 'wp_enqueue_scripts'. add_action('wp_enqueue_scripts', 'mpp_enqueue_styles');Congratulazioni, hai appena scritto il tuo primo plugin per WordPress!
Prossimi passi per migliorare
- Creare una pagina di impostazioni: Potresti creare una pagina nella bacheca di WordPress dove l'utente può personalizzare il testo e il link del box CTA.
- Usare uno Shortcode: Invece di aggiungerlo automaticamente, potresti creare uno shortcode (es.
[mioplugin_cta]) che l'utente può inserire manualmente dove vuole. - Internazionalizzazione: Rendere il plugin traducibile in altre lingue.
Other models, same or similar prompt
Responses were produced in different, uncontrolled contexts (system prompts, settings, prior turns). This is not a benchmark.