Documentazione relativa alle componenti dell'orario

MX Timetable gestisce gli eventi settimanali ricorrenti e li visualizza in un calendario interattivo. Gli amministratori possono organizzare gli eventi in calendari, configurare l'aspetto di ciascun calendario e creare voci di menu Joomla per il calendario, un singolo evento o un modulo di evento.

Installazione o aggiornamento

1. Nell’area di amministrazione di Joomla, apri Sistema → Installa → Estensioni.
2. Carica il pacchetto di installazione del componente (com_mxtimetable.zip) e completare la procedura di installazione.
3. In caso di aggiornamento, installare il nuovo pacchetto sovrascrivendo il componente esistente. Eseguire un backup del sito prima degli aggiornamenti come precauzione generale di manutenzione di Joomla.
4. Apri Componenti → Calendario per gestire i calendari e gli eventi.

Configurare un orario

1. Vai su Componenti → Timetable → Orari e crea un orario. Assegnagli un nome e pubblicalo.
2. Configurare le opzioni di visualizzazione specifiche dell’orario descritte di seguito, oppure lasciarle impostate su Usa impostazioni del componente per ereditare le impostazioni predefinite globali.
3. Vai su Componenti → Timetable → Eventi dell’orario e crea un evento.
4. Inserisci un titolo, scegli l’orario, seleziona un giorno della settimana e imposta l’ora di inizio e di fine. Usa il formato 24 ore (ad esempio, 08:30). L’ora di fine deve essere successiva all’ora di inizio.
5. Aggiungi eventuali informazioni opzionali sull’evento, pubblicalo e salva.
6. Ripetere l’operazione per gli altri eventi del programma settimanale.

Gli eventi a cui non è assegnato alcun orario compaiono solo nella vista "Tutti gli orari". Una voce di menu relativa a un orario mostra gli eventi assegnati a quell'orario.

Campi dell’evento

• Titolo: Nome dell’evento. Gli eventi con lo stesso titolo vengono raggruppati in base al filtro del titolo dell’orario; gli eventi pubblicati con lo stesso titolo vengono inoltre visualizzati come eventi correlati nelle rispettive pagine delle voci.
• Orario: l’orario a cui appartiene questo evento.
• Giorno e ora: Giorno della settimana e orari di inizio/fine in formato 24 ore. Gli eventi si ripetono settimanalmente; questo componente non assegna date del calendario.
• Colore dell’evento: Scegliere “Auto” (in base al giorno), uno dei colori predefiniti o “Colore personalizzato”. L’opzione “Colore personalizzato” consente anche di scegliere il colore del testo dell’evento.
• Luogo: Nome del luogo (facoltativo).
• Latitudine e longitudine: coordinate decimali facoltative. Inserisci entrambe le coordinate valide per posizionare un indicatore sulla mappa OpenStreetMap incorporata nella scheda quando la mappa è abilitata.
• Foto della località: immagine facoltativa per la località.
• Istruttore e foto dell’istruttore: nome e immagine dell’istruttore facoltativi. L’impostazione di visibilità della foto è indipendente dalla visualizzazione del nome dell’istruttore.
• Prezzo: importo non negativo facoltativo. Il simbolo della valuta viene configurato nelle impostazioni di visualizzazione.
• Descrizione: Dettagli in formato rich text facoltativi visualizzati quando si aprono i dettagli di un evento.
• Pubblicato: solo gli eventi pubblicati compaiono nel calendario pubblico e negli eventi correlati.

Creazione di pagine frontend

In Menu, creare una voce di menu e selezionare il tipo di componente MX Timetable:

• Orario settimanale mostra gli eventi di tutti gli orari o di un unico orario selezionato.
• Singola voce visualizza un singolo evento. Selezionare l’evento nelle impostazioni richieste della voce di menu.
• ItemForm fornisce un modulo frontend per l’aggiunta o la modifica di un evento. Impostare l’ID della voce come indicato dall’impostazione della voce di menu; utilizzare 0 per un modulo di aggiunta.

Il modulo frontend include gli stessi dettagli dell’evento presenti nel modulo di amministrazione. I permessi dei componenti di Joomla controllano chi può creare, modificare, pubblicare o eliminare gli eventi. Concedi solo i permessi appropriati per il tuo sito e prova la voce di menu dopo aver effettuato l’accesso come utente previsto.

I titoli degli eventi nel calendario possono rimandare alle relative pagine degli elementi quando è abilitata l’opzione Collega i titoli degli eventi alle pagine degli elementi. Le pagine degli elementi forniscono anche la navigazione «Precedente/Successivo» quando nel calendario settimanale sono presenti eventi pubblicati adiacenti. Gli utenti con autorizzazioni sufficienti possono visualizzare i controlli di modifica, registrazione o eliminazione sulle pagine degli elementi.

Impostazioni di visualizzazione

Le impostazioni predefinite globali si trovano in Componenti → Calendario → Opzioni. Le voci del calendario e le voci di menu possono sovrascrivere le impostazioni applicabili; selezionare Usa impostazione del componente (o lasciare il campo vuoto) per ereditarle. Per le opzioni del calendario che riportano la dicitura Usa impostazione del calendario o del componente, viene utilizzata l’impostazione predefinita del componente se il calendario stesso non ha alcun valore.

Orario settimanale

• Mostra titolo dell’orario: mostra o nasconde l’intestazione.
• Mostra categoria dell’orario: mostra o nasconde il nome dell’orario selezionato.
• Attivazione dei dettagli: apri i dettagli dell’evento cliccandoci sopra, oppure mostra un tooltip al passaggio del mouse dove è disponibile.
• Mostra ora dell’evento, sede, foto della sede, istruttore, foto dell’istruttore, descrizione e prezzo: controlla in modo indipendente quali dettagli vengono visualizzati.
• Numero massimo di caratteri della descrizione: limita la lunghezza della descrizione nei dettagli dell’evento. 0 significa mostrare la descrizione completa.
• Simbolo della valuta del prezzo: testo visualizzato dopo i prezzi degli eventi (l'impostazione predefinita globale è €).
• Sostituzioni delle etichette nel frontend: sostituisci etichette quali Titolo, Giorno, Ora, Luogo, Istruttore, Prezzo e Descrizione. Lascia un’etichetta vuota per utilizzare il testo predefinito della lingua.

Quando gli eventi si sovrappongono, condividono la larghezza disponibile della colonna del giorno. Gli eventi che non si sovrappongono possono espandersi nello spazio libero adiacente, fino a occupare l’intera colonna del giorno. Sugli schermi stretti, l’orario settimanale diventa un elenco di giorni ed eventi impilati verticalmente. Un menu a tendina "Titolo" filtra gli eventi in base al titolo.

Pagina dei dettagli dell’evento

• Mostra categoria dell’orario: mostra o nascondi il nome dell’orario nei dettagli dell’evento.
• Mostra ora, luogo, foto del luogo, istruttore, foto dell’istruttore, descrizione e prezzo: gestisci i campi corrispondenti dell’evento nella pagina della voce.
• Mostra eventi correlati: visualizza altri eventi pubblicati con lo stesso titolo, ordinati per giorno della settimana e ora di inizio. I loro titoli rimandano alle rispettive pagine di dettaglio.
• Mostra OpenStreetMap nelle pagine degli eventi: visualizza una mappa quando l’evento dispone di coordinate di latitudine e longitudine valide.
• Numero massimo di caratteri per la descrizione, simbolo della valuta del prezzo e sostituzioni delle etichette nel frontend: configura la pagina dell’evento come descritto sopra.

Autorizzazioni e accesso

Il componente utilizza le azioni ACL di Joomla per l’amministrazione, la gestione, la creazione, l’eliminazione, la modifica, le modifiche di stato e la modifica dei propri eventi. Configurale in Utenti → Gestisci → Gruppi (o nelle impostazioni dei permessi del sito). I moduli di creazione/modifica nel frontend richiedono le autorizzazioni pertinenti; ai visitatori pubblici non dovrebbe essere concesso l’accesso in scrittura a meno che ciò non sia intenzionale.