Documentazione sul componente per la creazione di menu

Accesso al backend

1. Accedi al backend (pannello di amministrazione) del tuo sito web Joomla all'indirizzo yoursite.com/administrator.
2. Accedi al componente Mx Menu Creator tramite il menu principale: Componenti > Mx Menu Creator.

Gestione delle categorie

Le categorie servono a organizzare le voci del menu. Il componente utilizza il sistema di categorie integrato in Joomla.

Aggiunta di una nuova categoria

1. Dal backend di Joomla, vai su Contenuto > Categorie.
2. Nel menu a tendina "Seleziona estensione", scegli "Mx Menu Creator".
3. Fai clic sul pulsante Nuovo (icona con il segno più verde) nella barra degli strumenti.
4. Compila i dettagli della categoria:
- Titolo: inserisci un nome per la categoria (ad es. "Antipasti", "Portate principali").
- Alias: (facoltativo) Una versione del titolo ottimizzata per gli URL.
- Descrizione: (facoltativo) Una descrizione della categoria.
   - Stato: impostare su “Pubblicata” per renderla attiva.
- Accesso: impostare il livello di accesso (ad es. “Pubblico”).
- Lingua: scegliere la lingua o “Tutte”.
5. Fare clic su “Salva e chiudi” per creare la categoria.

Modifica di una categoria

1. Vai su Contenuti > Categorie.
2. Seleziona “Mx Menu Creator” dal menu a tendina delle estensioni.
3. Clicca sul titolo della categoria oppure selezionalo e clicca su Modifica.
4. Apporta le modifiche e salva.

Eliminazione di una categoria

1. Seleziona la categoria nell’elenco delle categorie.
2. Fai clic su Elimina nella barra degli strumenti.
3. Conferma l’eliminazione.

Nota: l’eliminazione di una categoria non eliminerà gli elementi in essa contenuti, ma questi non saranno più classificati in alcuna categoria.

Gestione degli elementi

Gli elementi rappresentano le singole voci del menu (ad es. piatti, prodotti) nel tuo menu creator.

Aggiunta di una nuova voce

1. Dal backend di Joomla, vai su Componenti > Mx Menu Creator > Voci.
2. Clicca sul pulsante Nuovo nella barra degli strumenti.
3. Inserisci i dettagli della voce:

   Informazioni di base:
- Titolo: il nome della voce di menu (obbligatorio).
- Alias: (facoltativo) alias ottimizzato per gli URL.
- Immagine: carica o seleziona l’immagine principale per la voce (obbligatorio). Dimensioni consigliate: 1170px x 800px.
- Layout immagine: Scegli il layout (Quadrato, Rettangolo, Torre o Originale).
- Allergeni: (Facoltativo) Aggiungi immagini relative agli allergeni utilizzando il sottomodulo (pulsanti Aggiungi/Rimuovi/Sposta).
   - Descrizione: Descrizione dettagliata dell’articolo (obbligatoria). Utilizza l’editor per la formattazione.

   Impostazioni aggiuntive (barra laterale):
- Prezzo: inserisci il prezzo (facoltativo).
- Categoria: seleziona la categoria a cui appartiene questo articolo.
- Stato: imposta su "Pubblicato" per renderlo visibile.
- Lingua: scegli la lingua.
- Accesso: imposta il livello di accesso.
   - Data di creazione: (facoltativo) Imposta la data di creazione.
- Autore: (facoltativo) Imposta l’autore.

4. Fai clic su Salva e chiudi per creare l’elemento.

Modifica di un elemento

1. Vai su Componenti > Mx Menu Creator > Elementi.
2. Fai clic sul titolo dell’elemento oppure selezionalo e fai clic su Modifica.
3. Apporta le modifiche e salva.

Eliminazione di una voce

1. Seleziona le voci nell’elenco delle voci.
2. Fai clic su Elimina nella barra degli strumenti.
3. Conferma l’eliminazione.

Creazione di voci di menu (menu Joomla)

Per visualizzare i contenuti del menu creator sul frontend, è necessario creare voci di menu Joomla che rimandino alle viste del componente.

Aggiunta di una voce di menu

1. Dal backend di Joomla, vai su Menu > [Nome del tuo menu] (ad es., Menu principale).
2. Clicca su Nuovo nella barra degli strumenti.
3. Nella sezione "Tipo di voce di menu", clicca su Seleziona accanto a "Mx Menu Creator".
4. Scegli la vista appropriata:
- Predefinita: visualizza un elenco di voci (filtrabile per categoria).
5. Configura la voce di menu:
- Titolo del menu: il testo che appare nel menu.
   - Alias: alias ottimizzato per gli URL.
- Voce padre: (facoltativo) Imposta una voce di menu padre.
- Stato: imposta su “Pubblicato”.
- Accesso: imposta il livello di accesso.
- Link: l’URL verrà generato automaticamente.

6. Per la vista "Voci", configura le impostazioni di visualizzazione:
- Categoria: scegli se mostrare le voci di tutte le categorie o di una specifica.
- Ordinamento: seleziona come ordinare le voci (ad es. per ordine di creazione, titolo).
   - Stile: scegli lo stile di layout (Predefinito, Carosello, Schede, Semplice, Scorrimento, Animato, Sostituisci, Classico).
- Versione: seleziona il tema Scuro o Chiaro.
   - Colonne: numero di colonne da visualizzare (1, 2 o 3).
- Limite: numero massimo di elementi da mostrare (impostazione predefinita: 12).
- Altezza elemento: imposta l’altezza per lo stile carosello (varie opzioni come 600px, 80vh).
   - Opacità: opacità dello sfondo per le sovrapposizioni (da 0,1 a 0,9).
- Stile miniature: miniature quadrate o rotonde.
- Tipo di miniature: layout a mosaico o quadrato.
- Mostra allergeni: abilita/disabilita la visualizzazione degli allergeni.
   - Usa miniature degli allergeni: utilizza le miniature per gli allergeni (se abilitato).
- Immagine popup: layout dell’immagine per i popup (Predefinito, Quadrato, Rettangolo, Torre).
- Mostra “Leggi tutto”: abilita/disabilita i link “Leggi tutto”.

7. Fare clic su «Salva e chiudi» per creare la voce di menu.

Modifica di una voce di menu

1. Vai su Menu > [Nome del tuo menu].
2. Clicca sul titolo della voce di menu oppure selezionala e clicca su Modifica.
3. Apporta le modifiche e salva.

Eliminazione di una voce di menu

1. Seleziona la voce di menu.
2. Fai clic su Elimina nella barra degli strumenti.
3. Conferma l’eliminazione.

Suggerimenti aggiuntivi

- Pubblicazione: assicurati che le categorie, le voci e le voci di menu siano pubblicate affinché appaiano sul frontend
.- Ordinamento: utilizza la funzione di ordinamento negli elenchi per controllare l’ordine di visualizzazione.
- Moduli: il componente include un modulo (mod_mxmenucreator) che può essere utilizzato per visualizzare le voci di menu nelle posizioni dei moduli.
- Autorizzazioni: controlla le autorizzazioni degli utenti se determinate azioni non sono disponibili.
- Cache: svuota la cache di Joomla dopo aver apportato modifiche per vedere immediatamente gli aggiornamenti.

Risoluzione dei problemi

- Se le voci non vengono visualizzate, verificare che siano pubblicate e assegnate a una categoria pubblicata
.- Assicurarsi che le voci di menu siano collegate correttamente e che il menu sia assegnato a un modulo
.- Controllare i log degli errori nella configurazione globale di Joomla per individuare eventuali problemi.

Per una configurazione più avanzata, fare riferimento alle opzioni di configurazione del componente in Componenti > Mx Menu Creator > Opzioni.