{"id":167189,"date":"2025-07-21T09:00:00","date_gmt":"2025-07-21T09:00:00","guid":{"rendered":"https:\/\/gtechgroup.it\/blog\/classic-editor-personalizzare-php-filtri\/"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-29T22:00:00","slug":"classic-editor-personalizzare-php-filtri","status":"publish","type":"post","link":"https:\/\/gtechgroup.it\/blog\/classic-editor-personalizzare-php-filtri\/","title":{"rendered":"Personalizzare Classic Editor con Funzioni PHP e Filtri"},"content":{"rendered":"

Personalizzare Classic Editor con Funzioni PHP e Filtri<\/h2>\n

Classic Editor, grazie alla sua architettura basata su TinyMCE e alle numerose API di WordPress, offre un livello di personalizzazione profondo tramite codice PHP. Sviluppatori e amministratori avanzati possono modificare praticamente ogni aspetto dell’editor: dalla barra degli strumenti al comportamento dei contenuti, dalle opzioni di incolla alle dimensioni dell’area di testo. In questa guida tecnica esploreremo i filtri PHP più importanti per personalizzare Classic Editor, con esempi pratici pronti per l’uso nel tuo progetto.<\/p>\n

Dove Inserire il Codice<\/h2>\n

Prima di addentrarci nei filtri e nelle funzioni, è importante stabilire dove posizionare il codice di personalizzazione. Hai due opzioni principali:<\/p>\n

Plugin personalizzato<\/strong> (consigliato): crea un plugin custom dedicato alle personalizzazioni dell’editor. Questo approccio è il più robusto perché le tue modifiche sopravvivranno al cambio di tema. Crea un file PHP nella directory wp-content\/plugins\/<\/code> con l’header standard del plugin e inserisci il tuo codice al suo interno.<\/p>\n

File functions.php del tema<\/strong>: se le personalizzazioni sono strettamente legate al tema attivo, puoi inserirle nel functions.php<\/code>. Ricorda però che queste modifiche andranno perse se cambi tema. Se usi un tema figlio (child theme), inserisci il codice nel functions.php<\/code> del tema figlio per proteggerlo dagli aggiornamenti del tema padre.<\/p>\n

<?php\n\/**\n * Plugin Name: Custom Classic Editor\n * Description: Personalizzazioni per Classic Editor\n * Version: 1.0\n * Author: G Tech Group\n *\/\n\n\/\/ Il codice di personalizzazione va qui<\/code><\/pre>\n
Il Filtro tiny_mce_before_init<\/h2>\n
Il filtro tiny_mce_before_init<\/code> è il più potente e versatile per la personalizzazione di TinyMCE. Viene eseguito prima dell’inizializzazione dell’editor e riceve un array associativo con tutte le opzioni di configurazione. Modificando questo array, puoi controllare praticamente ogni aspetto del comportamento dell’editor.<\/p>\n
function custom_tinymce_settings($init) {\n    \/\/ Imposta l’altezza dell’editor a 500px\n    $init[height] = 500;\n\n    \/\/ Abilita il ridimensionamento verticale dell’editor\n    $init[resize] = true;\n\n    \/\/ Imposta il formato di incolla\n    $init[paste_as_text] = true;\n\n    \/\/ Abilita il conteggio parole\n    $init[wordcount] = true;\n\n    \/\/ Imposta la dimensione font predefinita\n    $init[fontsize_formats] = 10px 12px 14px 16px 18px 20px 24px 28px 32px 36px;\n\n    return $init;\n}\nadd_filter(tiny_mce_before_init, custom_tinymce_settings);<\/code><\/pre>\n
Questo filtro ti permette di configurare decine di opzioni. Tra le più utili: block_formats<\/code> per personalizzare i formati di blocco disponibili nel selettore (Paragrafo, Titolo 1, ecc.), toolbar1<\/code> e toolbar2<\/code> per definire la composizione delle righe della toolbar, content_css<\/code> per caricare fogli di stile personalizzati nell’editor, e valid_elements<\/code> per controllare quali tag HTML sono permessi.<\/p>\n
\"Classic<\/p>\n
Personalizzare i Formati di Blocco<\/h2>\n
Il selettore dei formati di blocco (il dropdown che mostra “Paragrafo”, “Titolo 1”, ecc.) può essere personalizzato per includere o escludere specifici formati. Ad esempio, potresti voler rimuovere “Preformattato” e “Indirizzo” se non vengono mai utilizzati, semplificando l’interfaccia:<\/p>\n
function custom_block_formats($init) {\n    $init[block_formats] = Paragrafo=p;Titolo 2=h2;Titolo 3=h3;Titolo 4=h4;Citazione=blockquote;\n    return $init;\n}\nadd_filter(tiny_mce_before_init, custom_block_formats);<\/code><\/pre>\n
Nota che abbiamo rimosso Titolo 1 (H1) dall’elenco. Questa è una best practice SEO: il tag H1 dovrebbe essere riservato al titolo dell’articolo (che WordPress genera automaticamente) e non dovrebbe essere utilizzato nel corpo del contenuto. Rimuovendolo dal selettore, previeni errori SEO da parte degli autori.<\/p>\n
Stili Personalizzati nell’Editor<\/h2>\n
Puoi aggiungere un selettore di stili personalizzati che applica classi CSS predefinite al testo selezionato. Questo è particolarmente utile per creare elementi stilizzati riutilizzabili come box informativi, testo evidenziato, pulsanti e avvisi:<\/p>\n
function custom_style_formats($init) {\n    $style_formats = array(\n        array(\n            title   => Box Informativo,\n            block   => div,\n            classes => info-box,\n            wrapper => true\n        ),\n        array(\n            title   => Testo Evidenziato,\n            inline  => span,\n            classes => highlight\n        ),\n        array(\n            title   => Pulsante CTA,\n            inline  => a,\n            classes => btn btn-primary\n        ),\n        array(\n            title   => Nota Tecnica,\n            block   => aside,\n            classes => technical-note,\n            wrapper => true\n        ),\n        array(\n            title   => Codice Inline,\n            inline  => code,\n            classes => inline-code\n        )\n    );\n\n    $init[style_formats] = json_encode($style_formats);\n    return $init;\n}\nadd_filter(tiny_mce_before_init, custom_style_formats);<\/code><\/pre>\n
Per vedere l’anteprima di questi stili nell’editor, devi caricare un foglio di stile dedicato con add_editor_style()<\/code>. Questo foglio di stile dovrebbe contenere le regole CSS per le classi che hai definito nei formati personalizzati.<\/p>\n
Il Filtro mce_css<\/h2>\n
Il filtro mce_css<\/code> controlla i fogli di stile CSS caricati all’interno dell’editor TinyMCE. Puoi usarlo per aggiungere CSS personalizzati che rendono l’editor visivamente simile al front-end del tuo sito:<\/p>\n
function custom_editor_css($mce_css) {\n    if (!empty($mce_css)) {\n        $mce_css .= ,;\n    }\n    $mce_css .= plugins_url(css\/editor-custom.css, __FILE__);\n    return $mce_css;\n}\nadd_filter(mce_css, custom_editor_css);<\/code><\/pre>\n
Nel file editor-custom.css<\/code>, definisci le regole CSS per allineare l’aspetto dell’editor al design del tuo sito. Ad esempio, puoi impostare la stessa famiglia di font, le stesse dimensioni del testo, gli stessi colori dei link e gli stessi stili per titoli e paragrafi. Questo offre agli autori un’anteprima accurata del risultato finale mentre scrivono.<\/p>\n
\"Impostazioni<\/p>\n
Controllare gli Elementi HTML Consentiti<\/h2>\n
TinyMCE ha un sistema di filtraggio che controlla quali elementi HTML e attributi sono consentiti nel contenuto. L’opzione valid_elements<\/code> definisce la whitelist degli elementi permessi. Per impostazione predefinita, WordPress configura una lista ragionevolmente permissiva, ma puoi restringerla o espanderla secondo le tue esigenze.<\/p>\n
L’opzione extended_valid_elements<\/code> è più pratica perché aggiunge elementi alla configurazione predefinita senza sovrascriverla:<\/p>\n
function extend_valid_elements($init) {\n    $custom_elements = span[id|class|style|data-*],\n        . div[id|class|style|data-*|role],\n        . iframe[src|width|height|frameborder|allowfullscreen|loading],\n        . script[src|type|async|defer];\n\n    if (isset($init[extended_valid_elements])) {\n        $init[extended_valid_elements] .= , . $custom_elements;\n    } else {\n        $init[extended_valid_elements] = $custom_elements;\n    }\n    return $init;\n}\nadd_filter(tiny_mce_before_init, extend_valid_elements);<\/code><\/pre>\n
Attenzione: consentire elementi come script<\/code> e iframe<\/code> introduce potenziali rischi di sicurezza. Abilita questi elementi solo se gli utenti che editano i contenuti sono affidabili (amministratori e redattori di fiducia). Per siti con molti autori esterni, è meglio mantenere restrizioni più strette.<\/p>\n
Filtri Specifici di Classic Editor<\/h2>\n
Classic Editor fornisce anche filtri specifici del plugin che permettono un controllo aggiuntivo:<\/p>\n
classic_editor_enabled_editors_for_post<\/code>: permette di decidere quale editor usare per un singolo post basandosi su qualsiasi criterio (ID del post, meta dato, autore, ecc.). Utile per forzare un editor specifico per contenuti particolari.<\/p>\n
classic_editor_enabled_editors_for_post_type<\/code>: controlla quali editor sono disponibili per ciascun post type. Puoi disabilitare Gutenberg completamente per alcuni post type e lasciarlo attivo per altri.<\/p>\n
classic_editor_plugin_settings<\/code>: permette di modificare le impostazioni del plugin programmaticamente, utile per configurazioni multi-sito o ambienti dove le impostazioni devono essere forzate dal codice.<\/p>\n
function force_classic_for_products($editors, $post_type) {\n    if ($post_type === product) {\n        $editors[block_editor] = false;\n        $editors[classic_editor] = true;\n    }\n    return $editors;\n}\nadd_filter(classic_editor_enabled_editors_for_post_type,\n    force_classic_for_products, 10, 2);<\/code><\/pre>\n
Personalizzare il Comportamento dell’Incolla<\/h2>\n
Il comportamento dell’incolla è un aspetto cruciale dell’esperienza di editing. Quando un utente incolla testo da un documento Word o da una pagina web, TinyMCE deve decidere quanto della formattazione originale mantenere. Puoi controllare questo comportamento con diverse opzioni:<\/p>\n
function custom_paste_settings($init) {\n    \/\/ Rimuovi la formattazione di Word all’incolla\n    $init[paste_remove_styles] = true;\n    $init[paste_remove_spans] = true;\n    $init[paste_strip_class_attributes] = all;\n\n    \/\/ Converti automaticamente gli URL incollati in link\n    $init[paste_convert_word_fake_lists] = true;\n\n    return $init;\n}\nadd_filter(tiny_mce_before_init, custom_paste_settings);<\/code><\/pre>\n
Queste impostazioni sono particolarmente importanti per siti con molti autori che copiano contenuti da fonti esterne. Senza un filtro appropriato, il testo incollato da Word può portarsi dietro centinaia di righe di stili inline e classi CSS proprietarie di Microsoft che inquinano il codice HTML del sito.<\/p>\n
\"Plugin<\/p>\n
Aggiungere Plugin TinyMCE Personalizzati<\/h2>\n
TinyMCE ha un’architettura a plugin che permette di estendere le sue funzionalità con moduli JavaScript personalizzati. Il filtro mce_external_plugins<\/code> permette di registrare plugin TinyMCE aggiuntivi:<\/p>\n
function register_tinymce_plugins($plugins) {\n    \/\/ Aggiungi il plugin per tabelle\n    $plugins[table] = plugins_url(js\/tinymce\/table\/plugin.min.js, __FILE__);\n    \/\/ Aggiungi un plugin personalizzato\n    $plugins[custom_templates] = plugins_url(js\/tinymce\/custom-templates.js, __FILE__);\n    return $plugins;\n}\nadd_filter(mce_external_plugins, register_tinymce_plugins);<\/code><\/pre>\n
Ogni plugin TinyMCE registrato può aggiungere pulsanti alla toolbar, menu contestuali, dialog personalizzati e funzionalità di elaborazione del contenuto. La creazione di plugin TinyMCE richiede conoscenze di JavaScript e della API TinyMCE, ma offre possibilità di personalizzazione praticamente illimitate.<\/p>\n
Modificare l’Editor per Ruolo Utente<\/h2>\n
Una personalizzazione avanzata molto utile è la differenziazione dell’editor in base al ruolo dell’utente. Puoi mostrare toolbar diverse, abilitare o disabilitare funzionalità e applicare restrizioni specifiche per ogni ruolo:<\/p>\n
function role_based_editor_config($init) {\n    $user = wp_get_current_user();\n\n    if (in_array(contributor, $user->roles)) {\n        \/\/ I collaboratori vedono solo formattazione base\n        $init[toolbar1] = bold,italic,bullist,numlist,link,unlink;\n        $init[toolbar2] = ;\n        $init[block_formats] = Paragrafo=p;Titolo 2=h2;Titolo 3=h3;\n    } elseif (in_array(author, $user->roles)) {\n        \/\/ Gli autori hanno più opzioni\n        $init[toolbar1] = formatselect,bold,italic,bullist,numlist,blockquote,link,unlink,wp_more;\n        $init[toolbar2] = strikethrough,hr,forecolor,pastetext,removeformat,charmap,wp_adv;\n    }\n    \/\/ Gli amministratori e gli editor mantengono la configurazione completa\n\n    return $init;\n}\nadd_filter(tiny_mce_before_init, role_based_editor_config);<\/code><\/pre>\n
Conclusioni<\/h2>\n
La personalizzazione di Classic Editor tramite filtri PHP offre un livello di controllo che pochi altri editor WYSIWYG possono eguagliare. Dalla configurazione della toolbar alla gestione dei contenuti HTML, dalla personalizzazione degli stili al controllo del comportamento per ruolo utente, le possibilità sono vastissime. La chiave è identificare le personalizzazioni che hanno un impatto reale sulla produttività del tuo team e implementarle in modo pulito e manutenibile.<\/p>\n
Ricorda sempre di testare le personalizzazioni in un ambiente di staging prima di applicarle al sito in produzione, e di documentare ogni modifica per facilitare la manutenzione futura.<\/p>\n
\n
Leggi anche gli altri articoli della serie Classic Editor<\/h3>\n