{"id":167181,"date":"2025-05-26T09:00:00","date_gmt":"2025-05-26T09:00:00","guid":{"rendered":"https:\/\/gtechgroup.it\/blog\/classic-editor-tinymce-personalizzare-barra\/"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-29T22:00:00","slug":"classic-editor-tinymce-personalizzare-barra","status":"publish","type":"post","link":"https:\/\/gtechgroup.it\/blog\/classic-editor-tinymce-personalizzare-barra\/","title":{"rendered":"Classic Editor e TinyMCE: Personalizzare la Barra degli Strumenti"},"content":{"rendered":"

Classic Editor e TinyMCE: Personalizzare la Barra degli Strumenti<\/h2>\n

La barra degli strumenti di TinyMCE è il cuore dell’esperienza di editing con Classic Editor. Personalizzarla significa adattare l’editor alle proprie esigenze, aggiungendo i pulsanti più utilizzati, rimuovendo quelli superflui e organizzando gli strumenti in modo logico ed efficiente. In questa guida esploreremo tutte le possibilità di personalizzazione della toolbar di TinyMCE, dalle opzioni più semplici accessibili dalla dashboard fino alle modifiche avanzate tramite codice PHP.<\/p>\n

La Struttura della Barra degli Strumenti di TinyMCE<\/h2>\n

TinyMCE, il motore che alimenta Classic Editor, organizza la sua barra degli strumenti in righe (chiamate anche “toolbar”). WordPress configura di default due righe di strumenti. La prima riga, sempre visibile, contiene i pulsanti più utilizzati: grassetto, corsivo, elenchi puntati e numerati, citazione, allineamento del testo, inserimento link, tag “Leggi tutto” e il pulsante per mostrare\/nascondere la seconda riga.<\/p>\n

La seconda riga, inizialmente nascosta e accessibile tramite il pulsante “Barra degli strumenti” (l’icona con le righe orizzontali), contiene strumenti aggiuntivi: selettore di formato (Paragrafo, Titolo 1-6), sottolineato, testo barrato, colore del testo, incolla come testo semplice, rimuovi formattazione, caratteri speciali, diminuisci\/aumenta rientro, annulla\/ripeti e scorciatoia da tastiera.<\/p>\n

Ogni pulsante è identificato da un nome interno univoco che viene utilizzato nei filtri PHP per aggiungere o rimuovere elementi dalla toolbar. Conoscere questi nomi è fondamentale per qualsiasi personalizzazione avanzata.<\/p>\n

\"La<\/p>\n

Il Pulsante Kitchen Sink<\/h2>\n

Il pulsante “Kitchen Sink” (letteralmente “lavello della cucina”, un’espressione inglese che significa “tutto il possibile”) è il toggle che mostra o nasconde la seconda riga della toolbar. Il suo nome interno è wp_adv<\/code>. Quando l’utente clicca su questo pulsante, la seconda riga si espande rivelando gli strumenti aggiuntivi.<\/p>\n

Un suggerimento utile: WordPress ricorda lo stato del Kitchen Sink tra le sessioni. Se un utente lo apre, resterà aperto anche nelle sessioni successive. Questa preferenza è salvata nel profilo utente tramite un meta dato chiamato wp_user_settings<\/code>.<\/p>\n

Personalizzazione Base: Il Filtro mce_buttons<\/h2>\n

Il modo più diretto per personalizzare la toolbar è utilizzare i filtri mce_buttons<\/code> e mce_buttons_2<\/code> nel file functions.php<\/code> del tema attivo o in un plugin personalizzato. Il filtro mce_buttons<\/code> controlla la prima riga della toolbar, mentre mce_buttons_2<\/code> controlla la seconda riga.<\/p>\n

Per aggiungere un pulsante alla prima riga, puoi usare un codice simile a questo nel tuo functions.php<\/code>:<\/p>\n

function custom_mce_buttons_row1($buttons) {\n    $buttons[] = superscript;\n    $buttons[] = subscript;\n    return $buttons;\n}\nadd_filter(mce_buttons, custom_mce_buttons_row1);<\/code><\/pre>\n
Questo esempio aggiunge i pulsanti per apice e pedice alla fine della prima riga. Per rimuovere un pulsante, cerca il suo nome nell’array e rimuovilo con array_diff<\/code> o unset<\/code>. Ad esempio, per rimuovere il pulsante del testo barrato dalla seconda riga:<\/p>\n
function custom_mce_buttons_row2($buttons) {\n    $remove = array(strikethrough);\n    return array_diff($buttons, $remove);\n}\nadd_filter(mce_buttons_2, custom_mce_buttons_row2);<\/code><\/pre>\n
Aggiungere una Terza e Quarta Riga<\/h2>\n
TinyMCE supporta fino a quattro righe di strumenti, ma WordPress ne utilizza solo due per impostazione predefinita. Puoi aggiungere una terza e quarta riga utilizzando i filtri mce_buttons_3<\/code> e mce_buttons_4<\/code>. Queste righe aggiuntive sono sempre visibili (non sono controllate dal Kitchen Sink) e appaiono sotto la seconda riga.<\/p>\n
function custom_mce_buttons_row3($buttons) {\n    $buttons[] = fontselect;\n    $buttons[] = fontsizeselect;\n    $buttons[] = styleselect;\n    return $buttons;\n}\nadd_filter(mce_buttons_3, custom_mce_buttons_row3);<\/code><\/pre>\n
Aggiungere righe extra è utile quando hai molti pulsanti personalizzati e vuoi mantenere l’organizzazione della toolbar chiara e ordinata. Tuttavia, troppe righe possono ridurre lo spazio disponibile per la scrittura, specialmente su schermi più piccoli.<\/p>\n
\"Impostazioni<\/p>\n
Nomi dei Pulsanti TinyMCE Predefiniti<\/h2>\n
Per personalizzare efficacemente la toolbar, devi conoscere i nomi interni dei pulsanti. Ecco l’elenco completo dei pulsanti più comuni disponibili in TinyMCE con WordPress:<\/p>\n
Formattazione testo<\/strong>: bold<\/code> (grassetto), italic<\/code> (corsivo), underline<\/code> (sottolineato), strikethrough<\/code> (barrato), superscript<\/code> (apice), subscript<\/code> (pedice), removeformat<\/code> (rimuovi formattazione).<\/p>\n
Allineamento<\/strong>: alignleft<\/code>, aligncenter<\/code>, alignright<\/code>, alignjustify<\/code>.<\/p>\n
Elenchi<\/strong>: bullist<\/code> (elenco puntato), numlist<\/code> (elenco numerato), indent<\/code> (aumenta rientro), outdent<\/code> (diminuisci rientro).<\/p>\n
Inserimento<\/strong>: link<\/code> (inserisci link), unlink<\/code> (rimuovi link), charmap<\/code> (caratteri speciali), hr<\/code> (linea orizzontale), wp_more<\/code> (tag Leggi tutto), wp_page<\/code> (interruzione di pagina).<\/p>\n
Cronologia<\/strong>: undo<\/code> (annulla), redo<\/code> (ripeti).<\/p>\n
Visualizzazione<\/strong>: wp_adv<\/code> (Kitchen Sink), fullscreen<\/code> (schermo intero), wp_help<\/code> (scorciatoie da tastiera).<\/p>\n
Tabelle<\/strong>: table<\/code> (inserisci tabella — richiede il plugin TinyMCE table).<\/p>\n
Riordinare i Pulsanti<\/h2>\n
L’ordine dei pulsanti nella toolbar corrisponde all’ordine degli elementi nell’array. Per riordinare i pulsanti, puoi ricostruire l’intero array nell’ordine desiderato:<\/p>\n
function reorder_mce_buttons($buttons) {\n    return array(\n        formatselect, bold, italic, underline,\n        separator,\n        bullist, numlist,\n        separator,\n        link, unlink,\n        separator,\n        wp_adv\n    );\n}\nadd_filter(mce_buttons, reorder_mce_buttons);<\/code><\/pre>\n
Nota l’uso di separator<\/code> per aggiungere separatori visivi tra gruppi logici di pulsanti. I separatori aiutano gli utenti a trovare rapidamente lo strumento che cercano, migliorando l’usabilità dell’editor.<\/p>\n
Personalizzazione del Selettore Formati<\/h2>\n
Il selettore dei formati (il menu a tendina che mostra “Paragrafo”, “Titolo 1”, “Titolo 2”, ecc.) può essere personalizzato tramite il filtro tiny_mce_before_init<\/code>. Puoi aggiungere formati personalizzati che applicano classi CSS specifiche al testo selezionato:<\/p>\n
function custom_mce_formats($init) {\n    $style_formats = array(\n        array(\n            title => Evidenziato,\n            inline => span,\n            classes => text-highlight\n        ),\n        array(\n            title => Nota,\n            block => div,\n            classes => content-note,\n            wrapper => true\n        )\n    );\n    $init[style_formats] = json_encode($style_formats);\n    return $init;\n}\nadd_filter(tiny_mce_before_init, custom_mce_formats);<\/code><\/pre>\n
Per vedere questi formati personalizzati nell’editor, devi aggiungere il pulsante styleselect<\/code> alla toolbar e creare le corrispondenti regole CSS sia nel front-end che nell’editor tramite add_editor_style()<\/code>.<\/p>\n
\"Plugin<\/p>\n
Aggiungere Stili CSS all’Editor<\/h2>\n
Per rendere visibili le personalizzazioni di formattazione direttamente nell’editor, WordPress offre la funzione add_editor_style()<\/code>. Questa funzione carica un file CSS aggiuntivo all’interno dell’iframe di TinyMCE, permettendo di stilizzare i contenuti esattamente come appariranno nel front-end.<\/p>\n
function custom_editor_style() {\n    add_editor_style(css\/editor-style.css);\n}\nadd_action(admin_init, custom_editor_style);<\/code><\/pre>\n
Nel file editor-style.css<\/code>, definisci le regole CSS per i tuoi formati personalizzati. In questo modo, quando un autore applica il formato “Evidenziato” al testo nell’editor, vedrà immediatamente lo stile applicato, ottenendo un’anteprima accurata del risultato finale.<\/p>\n
Personalizzazione per Ruolo Utente<\/h2>\n
Una personalizzazione avanzata molto utile è mostrare toolbar diverse in base al ruolo dell’utente. Ad esempio, potresti voler dare agli amministratori accesso a tutti i pulsanti mentre gli autori vedono solo una selezione semplificata:<\/p>\n
function role_based_mce_buttons($buttons) {\n    $user = wp_get_current_user();\n    if (!in_array(administrator, $user->roles)) {\n        $remove = array(wp_more, charmap, hr);\n        $buttons = array_diff($buttons, $remove);\n    }\n    return $buttons;\n}\nadd_filter(mce_buttons, role_based_mce_buttons);<\/code><\/pre>\n
Questa tecnica è particolarmente utile in contesti editoriali dove vuoi semplificare l’interfaccia per i collaboratori occasionali mantenendo tutte le funzionalità per gli utenti avanzati.<\/p>\n
Best Practice per la Personalizzazione<\/h2>\n
Quando personalizzi la toolbar di TinyMCE, tieni a mente alcune best practice fondamentali. Evita di sovraccaricare la toolbar con troppi pulsanti: una barra degli strumenti affollata è controproducente perché rende difficile trovare lo strumento giusto. Raggruppa i pulsanti in modo logico usando i separatori. Testa sempre le personalizzazioni su schermi di diverse dimensioni per assicurarti che la toolbar rimanga usabile anche su laptop con schermi più piccoli.<\/p>\n
Inserisci le personalizzazioni in un plugin personalizzato piuttosto che nel functions.php<\/code> del tema: in questo modo, le tue modifiche sopravvivranno al cambio di tema. Documenta le personalizzazioni effettuate per facilitare la manutenzione futura e l’eventuale passaggio a un altro sviluppatore.<\/p>\n
Conclusioni<\/h2>\n
La personalizzazione della barra degli strumenti di TinyMCE in Classic Editor è un’operazione che può migliorare significativamente l’efficienza del tuo flusso di lavoro editoriale. Che tu scelga di utilizzare un plugin come TinyMCE Advanced per una personalizzazione visuale o preferisca il controllo granulare offerto dai filtri PHP, le possibilità sono ampie e flessibili. L’obiettivo è creare un’interfaccia che contenga esattamente gli strumenti di cui hai bisogno, né più né meno.<\/p>\n
\n
Leggi anche gli altri articoli della serie Classic Editor<\/h3>\n