{"elements":[{"id":7012,"title":"Sistema Menu","body":"
\n
\n

Gestione visuale dei menu<\/h2>\n

In DressAPI, creare e organizzare i menu di navigazione del sito è un'operazione completamente visuale. Dal pannello di amministrazione puoi aggiungere voci, creare sottomenu a più livelli, riordinare gli elementi con il drag-and-drop e controllare la visibilità in base ai ruoli utente. Il sistema supporta anche megamenu e voci generate dinamicamente da query sul database.<\/p>\n

\"Editor<\/div>\n\n

Struttura della tabella cmsmenu<\/h3>\n

La tabella cmsmenu<\/code> memorizza tutte le voci di menu in una singola tabella auto-referenziante:<\/p>\n

\n
Schema cmsmenu<\/div>\nCREATE TABLE<\/span> cmsmenu<\/span> (\n id<\/span> INT UNSIGNED<\/span> NOT NULL AUTO_INCREMENT<\/span>,\n name<\/span> VARCHAR(80)<\/span> NOT NULL<\/span>,\n icon<\/span> VARCHAR(80)<\/span> NOT NULL<\/span>,\n query<\/span> VARCHAR(500)<\/span> NOT NULL<\/span>,\n specialtype<\/span> ENUM('normal','megamenu')<\/span> DEFAULT<\/span> 'normal'<\/span>,\n id_cmsmenu<\/span> INT UNSIGNED<\/span> DEFAULT NULL<\/span>,\n priority<\/span> INT UNSIGNED<\/span> NOT NULL<\/span>,\n id__role<\/span> INT UNSIGNED<\/span> DEFAULT NULL<\/span>,\n PRIMARY KEY<\/span> (id<\/span>),\n FOREIGN KEY<\/span> (id__role<\/span>) REFERENCES<\/span> _role<\/span>(id<\/span>),\n FOREIGN KEY<\/span> (id_cmsmenu<\/span>) REFERENCES<\/span> cmsmenu<\/span>(id<\/span>)\n ON DELETE CASCADE ON UPDATE CASCADE<\/span>\n);<\/div>\n\n
\n \n \n \n
Campo<\/th>Tipo<\/th>Descrizione<\/th><\/tr>\n <\/thead>\n
id<\/code><\/td>INT UNSIGNED<\/td>Chiave primaria, auto-incremento<\/td><\/tr>\n
name<\/code><\/td>VARCHAR(80)<\/td>Nome visualizzato della voce di menu<\/td><\/tr>\n
icon<\/code><\/td>VARCHAR(80)<\/td>Identificativo icona (es. it-home<\/code>, it-burger<\/code> per sprite SVG Bootstrap Italia)<\/td><\/tr>\n
query<\/code><\/td>VARCHAR(500)<\/td>URL, ancora, query speciale ([[...]]<\/code>), o testo statico (#text:...<\/code>)<\/td><\/tr>\n
specialtype<\/code><\/td>ENUM<\/td>normal<\/code> (dropdown standard) o megamenu<\/code> (layout multi-colonna)<\/td><\/tr>\n
id_cmsmenu<\/code><\/td>INT UNSIGNED<\/td>FK auto-referenziante al menu padre. NULL<\/code> per i gruppi di primo livello<\/td><\/tr>\n
priority<\/code><\/td>INT UNSIGNED<\/td>Ordine all'interno dello stesso padre. Valori più bassi appaiono prima (multipli di 10)<\/td><\/tr>\n
id__role<\/code><\/td>INT UNSIGNED<\/td>FK a _role.id<\/code>. NULL<\/code> = visibile a tutti<\/td><\/tr>\n <\/tbody>\n <\/table>\n <\/div>\n\n

Gerarchia del menu<\/h3>\n

Il sistema menu usa una gerarchia a tre livelli<\/strong>:<\/p>\n

    \n
  • Gruppi menu<\/strong> (livello 0): voci di primo livello con id_cmsmenu IS NULL<\/code><\/li>\n
  • Sottomenu<\/strong> (livello 1): figli diretti di un gruppo<\/li>\n
  • Voci<\/strong> (livello 2): figli dei sottomenu (elementi foglia)<\/li>\n <\/ul>\n
    \n
    Esempio gerarchia<\/div>\nMainMenu (id=3, id_cmsmenu=NULL)\n +-- Home (id=300, query=\"\/\", priority=1)\n +-- Amministrazione (id=310, query=\"#\", priority=10)\n | +-- Sindaco e Giunta (id=311, priority=10)\n | +-- Consiglio Comunale (id=312, priority=20)\n | +-- Aree e Uffici (id=313, priority=30)\n +-- Servizi (id=320, query=\"#\", priority=20)\n +-- Pagamenti (id=321, priority=10)<\/div>\n

    Un sottomenu con query=\"#\"<\/code> funge da genitore dropdown senza essere un link navigabile. L'eliminazione di un padre si propaga ai figli grazie a ON DELETE CASCADE<\/code>.<\/p>\n\n

    7 Gruppi menu predefiniti<\/h3>\n
    \n \n \n \n
    ID<\/th>Nome<\/th>Posizione<\/th>Scopo<\/th><\/tr>\n <\/thead>\n
    1<\/td>TopLeftMenu<\/strong><\/td>Header slim, lato sinistro<\/td>Navigazione secondaria (link all'organizzazione)<\/td><\/tr>\n
    2<\/td>TopRightMenu<\/strong><\/td>Header slim, lato destro<\/td>Strumenti admin (Traduttore, ACL, Scheduler, Menu, Tabelle, Moduli, Utenti)<\/td><\/tr>\n
    3<\/td>MainMenu<\/strong><\/td>Navbar primaria<\/td>Navigazione principale del sito (Home, sezioni con dropdown)<\/td><\/tr>\n
    4<\/td>FooterMenu<\/strong><\/td>Footer, sezione superiore<\/td>Link a colonne nel footer; spesso usa query dinamiche [[pages:...]]<\/code><\/td><\/tr>\n
    5<\/td>TextMenu<\/strong><\/td>Footer, sezione centrale<\/td>Contenuti testuali (indirizzi, testi legali via #text:...<\/code>)<\/td><\/tr>\n
    6<\/td>LegalMenu<\/strong><\/td>Footer, barra inferiore<\/td>Link legali (Media policy, Privacy, Sitemap)<\/td><\/tr>\n
    7<\/td>SocialMenu<\/strong><\/td>Barra social header + Footer<\/td>Link ai social media (Facebook, Instagram, YouTube)<\/td><\/tr>\n <\/tbody>\n <\/table>\n <\/div>\n\n

    Tipi di query speciali<\/h3>\n

    Il campo query<\/code> supporta diverse sintassi speciali. Quando CMenuBuilder<\/strong> incontra una query racchiusa in [[ ]]<\/code>, genera dinamicamente le voci del sottomenu.<\/p>\n\n

    [[table-list]]<\/code><\/h4>\n

    Genera una voce di sottomenu per ogni tabella del database accessibile all'utente corrente. Ogni voce generata punta a \/admin\/table\/{nometabella}<\/code>.<\/p>\n

    \n
    Esempio SQL<\/div>\n-- Dropdown \"Tabelle\" visibile solo all'admin (id__role=1)<\/span>\n(209, 'Tables', 'it-piattaforme', '[[table-list]]', 'normal', 2, 70, 1)<\/div>\n\n

    [[module-list]]<\/code><\/h4>\n

    Genera una voce di sottomenu per ogni modulo registrato nella tabella _module<\/code> e accessibile all'utente corrente. Ogni voce punta a \/{nome_modulo}<\/code>.<\/p>\n

    \n
    Esempio SQL<\/div>\n-- Dropdown \"Moduli\" visibile solo all'admin<\/span>\n(7028, 'Modules', 'it-piattaforme', '[[module-list]]', 'normal', 2, 70, 1)<\/div>\n\n

    [[modulo:campo=valore]]<\/code><\/h4>\n

    Genera voci di sottomenu interrogando la tabella del modulo con condizioni di filtro. Le condizioni dopo i due punti diventano una clausola SQL WHERE<\/code>. I risultati sono ordinati per priority ASC, id ASC<\/code>.<\/p>\n

    \n
    Esempio: voci FooterMenu dinamiche<\/div>\n-- Genera voci dal modulo \"pages\" filtrate per gruppo<\/span>\n(401, 'Amministrazione', '', '[[pages:groupname=Amministrazione,visible=yes]]', 'normal', 4, 40, NULL)\n(402, 'Servizi', '', '[[pages:groupname=Servizi,visible=yes]]', 'normal', 4, 50, NULL)<\/div>\n\n

    #text:...<\/code><\/h4>\n

    Il testo dopo #text:<\/code> viene renderizzato direttamente nel footer come contenuto HTML, senza essere racchiuso in un link.<\/p>\n\n

    #<\/code> (Ancora \/ Genitore senza link)<\/h4>\n

    Un valore query<\/code> di #<\/code> indica un genitore di menu che non naviga da nessuna parte. Viene usato per i dropdown.<\/p>\n\n

    Visibilità basata sui ruoli<\/h3>\n

    La visibilità è controllata dalla colonna id__role<\/code> che referenzia la tabella _role<\/code>:<\/p>\n

      \n
    • id__role = NULL<\/code><\/strong>: visibile a tutti<\/strong>, inclusi gli utenti anonimi<\/li>\n
    • id__role = {id_ruolo}<\/code><\/strong>: visibile solo<\/strong> agli utenti con quel ruolo assegnato nella tabella _user_role<\/code><\/li>\n <\/ul>\n
      \n
      Query di filtro per ruolo<\/div>\nSELECT<\/span> * FROM<\/span> cmsmenu<\/span>\nWHERE<\/span> id_cmsmenu<\/span> IS NULL<\/span>\n AND<\/span> (id__role<\/span> IS NULL OR<\/span> id__role<\/span> IN<\/span> (1, 2, 3))\nORDER BY<\/span> priority<\/span> ASC<\/span><\/div>\n

      Per gli utenti anonimi (non autenticati), il modello applica solo id__role IS NULL<\/code>, rendendo visibili esclusivamente le voci pubbliche.<\/p>\n\n

      Supporto Megamenu<\/h3>\n

      Il campo specialtype<\/code> determina come il template header del CMS renderizza una voce del MainMenu:<\/p>\n

        \n
      • normal<\/code><\/strong> (predefinito): dropdown Bootstrap standard con <ul class=\"link-list\"><\/code><\/li>\n
      • megamenu<\/code><\/strong>: layout multi-colonna. Ogni sottomenu diventa una colonna con intestazione e lista di link<\/li>\n <\/ul>\n

        Con i megamenu la gerarchia è effettivamente a tre livelli: il genitore megamenu, le intestazioni di colonna (livello 2), e i link effettivi (livello 3).<\/p>\n

        \n
        Creare una voce megamenu<\/div>\nINSERT INTO<\/span> cmsmenu<\/span> (name<\/span>, icon<\/span>, query<\/span>, specialtype<\/span>, id_cmsmenu<\/span>, priority<\/span>, id__role<\/span>)\nVALUES<\/span> ('MegaSezione', 'it-pa', '#', 'megamenu', 3, 10, NULL);<\/div>\n

        Il template controlla $voice['specialtype'] == 'megamenu'<\/code> per decidere quale layout usare.<\/p>\n\n

        Riordinamento Drag-and-Drop<\/h3>\n

        L'interfaccia di amministrazione menu fornisce un editor drag-and-drop visuale basato su SortableJS<\/strong>.<\/p>\n