Classic Editor e i Shortcode: Inserire Contenuti Dinamici

Shortcode dei Plugin Più Popolari

La maggior parte dei plugin WordPress utilizza shortcode per inserire le proprie funzionalità nei contenuti. Ecco alcuni degli shortcode più diffusi che probabilmente utilizzerai con Classic Editor:

Contact Form 7: [contact-form-7 id="123" title="Contatti"] inserisce un modulo di contatto. Ogni modulo ha un ID univoco che puoi trovare nella pagina di gestione del plugin.

WooCommerce: offre numerosi shortcode come [products] per mostrare prodotti, [product_page id="99"] per una singola scheda prodotto, [woocommerce_cart] per il carrello e [woocommerce_checkout] per il checkout. Questi shortcode sono fondamentali per le pagine critiche del negozio online.

Yoast SEO: utilizza shortcode come [wpseo_breadcrumb] per inserire le breadcrumb in posizioni personalizzate al di fuori del template del tema.

TablePress: [table id=1 /] inserisce tabelle create e gestite tramite l’interfaccia dedicata del plugin, con ordinamento, filtri e paginazione.

Creare Shortcode Personalizzati

Creare i propri shortcode è sorprendentemente semplice e apre possibilità infinite. La funzione add_shortcode() di WordPress è tutto ciò che serve. Ecco un esempio di shortcode che inserisce un box informativo stilizzato:

function gtg_info_box_shortcode($atts, $content = null) {
    $atts = shortcode_atts(array(
        tipo => info,
        titolo => 
    ), $atts, info_box);

    $class = info-box info-box-- . esc_attr($atts[tipo]);
    $titolo = !empty($atts[titolo])
        ? <h4 class="info-box__title"> . esc_html($atts[titolo]) . </h4>
        : ;

    return <div class=" . $class . ">
        . $titolo
        . <div class="info-box__content"> . do_shortcode($content) . </div>
        . </div>;
}
add_shortcode(info_box, gtg_info_box_shortcode);

Questo shortcode si usa così nell’editor classico: [info_box tipo="avviso" titolo="Importante"]Il contenuto del box[/info_box]. Nota l’uso di do_shortcode($content) che permette di annidare altri shortcode all’interno del contenuto.

Best Practice per gli Shortcode in Classic Editor

Quando lavori con gli shortcode nell’editor classico, segui queste best practice per evitare problemi comuni:

Usa la modalità Testo per gli shortcode complessi: se uno shortcode ha molti attributi o contiene HTML, passare alla modalità Testo ti offre un controllo più preciso. La modalità Visuale a volte può aggiungere tag <p> o <br> indesiderati attorno agli shortcode.

Verifica gli shortcode in anteprima: gli shortcode non vengono eseguiti nell’editor; vedrai solo il testo tra parentesi quadre. Usa sempre l’anteprima per verificare che l’output sia corretto prima di pubblicare.

Documenta i tuoi shortcode: se crei shortcode personalizzati, crea una pagina di documentazione interna per il tuo team con la sintassi, gli attributi disponibili e gli esempi d’uso. Questo è particolarmente importante in ambienti multi-autore.

Il Problema degli Shortcode e il Cambio tra Visuale e Testo

Uno dei problemi più insidiosi quando si usano shortcode con Classic Editor riguarda il passaggio tra la modalità Visuale e la modalità Testo. WordPress applica una funzione chiamata wpautop che aggiunge automaticamente tag <p> ai blocchi di testo e <br> alle interruzioni di riga. Questa funzione può interferire con gli shortcode, soprattutto quelli enclosing che contengono HTML.

La soluzione più comune è posizionare gli shortcode su righe separate, senza testo prima o dopo sulla stessa riga. In alternativa, puoi utilizzare il plugin TinyMCE Advanced con l’opzione “Mantieni i tag paragrafo” attivata, che previene le conversioni automatiche di wpautop. Per gli sviluppatori, è possibile rimuovere completamente wpautop con remove_filter(the_content, wpautop), ma questa è una soluzione drastica che influisce su tutti i contenuti.

Shortcode con Anteprima Visuale

Un limite degli shortcode nell’editor classico è che vengono visualizzati come testo semplice: l’autore non vede l’output effettivo fino all’anteprima. Per migliorare l’esperienza, puoi registrare un plugin TinyMCE che sostituisce visivamente gli shortcode con un’anteprima stilizzata nell’editor. WordPress fa già questo per alcuni shortcode nativi come e , mostrando un placeholder interattivo invece del testo grezzo.

Per i tuoi shortcode personalizzati, puoi creare anteprime simili registrando una “view” TinyMCE che renderizza una rappresentazione visiva dello shortcode nell’editor. Questo richiede la creazione di un file JavaScript con la logica di rendering e la registrazione del view tramite wp.mce.views.register().

Shortcode e Performance

Ogni shortcode presente in un articolo viene elaborato dal server al momento della visualizzazione della pagina. Se un articolo contiene molti shortcode complessi (ad esempio, shortcode che eseguono query al database), il tempo di caricamento può aumentare. Per mitigare questo problema, considera l’uso di un plugin di caching come WP Super Cache o W3 Total Cache, che salva l’output HTML generato e lo serve ai visitatori successivi senza rielaborare gli shortcode.

Per gli shortcode che generano contenuti raramente modificati (come tabelle di pricing o sezioni informative), puoi anche considerare l’uso del Transient API di WordPress per cachare l’output dello shortcode nel database, riducendo il carico sul server ad ogni visualizzazione della pagina.

Migrare gli Shortcode a Gutenberg

Se in futuro deciderai di migrare da Classic Editor a Gutenberg, i tuoi shortcode continueranno a funzionare. Gutenberg include un blocco “Shortcode” dedicato che accetta qualsiasi shortcode. Tuttavia, i blocchi Gutenberg offrono un’esperienza più moderna con anteprime in tempo reale, pannelli di impostazioni laterali e un’interfaccia visuale più ricca. Se crei shortcode personalizzati oggi, considera la possibilità di sviluppare anche i corrispondenti blocchi Gutenberg per una futura migrazione più agevole.

Conclusioni

Gli shortcode e Classic Editor formano un binomio collaudato e potente per la creazione di contenuti dinamici in WordPress. La loro semplicità sintattica, la flessibilità degli attributi e la possibilità di creare shortcode personalizzati rendono questa tecnologia ancora perfettamente attuale nel 2026. Che tu utilizzi shortcode di plugin popolari o ne crei di personalizzati per il tuo progetto, Classic Editor offre l’ambiente ideale per lavorare con questi strumenti in modo rapido ed efficiente.

Vuoi creare shortcode personalizzati per il tuo sito WordPress o hai bisogno di assistenza per integrare plugin con shortcode nel tuo editor classico? Il team di G Tech Group è specializzato nello sviluppo WordPress e può aiutarti a realizzare soluzioni su misura. Contattaci oggi stesso.

Migliora il Tuo Sito WordPress

Scopri le nostre guide complete sugli altri plugin essenziali per WordPress:

• Come Installare Elementor su WordPress
• Come Installare e Configurare WP Rocket
• Come Installare e Configurare SEOPress
• Come Installare e Configurare UpdraftPlus