Questo tutorial vi guida alla scoperta di cosa sono questi campi, come usarli e come funzionano sia nel back-end che nel front-end del vostro sito.
Novità nei campi personalizzati di Joomla 6.1
Con Joomla 6.1, il plugin di base Media custom field è stato esteso per supportare più tipi di file:
- Audio
- Video
- Documenti
- Immagini (supporto continuato)
Questi sono esposti come quattro tipi di campo nell'interfaccia dei campi personalizzati:
| Tipo di campo | Nome campo | Output |
|---|---|---|
| Immagine | media | Restituisce un tag <img> |
| Audio | media_audio | Visualizza un lettore HTML5 <audio> |
| Video | media_video | Visualizza un lettore HTML5 <video> |
| Documento | media_document | Visualizza un link per il download |
Creazione dei nuovi campi multimediali
- Vai a Campi personalizzati: Vai su Contenuto → Campi (o Contatti → Campi).
- Aggiungi un nuovo campo: Clicca su Nuovo per creare un campo personalizzato.
- Seleziona il tipo di campo: Scegli uno dei nuovi tipi di campo multimediale:
- Audio (media_audio)
- Video (media_video)
- Documento (media_document)
- Immagine (media)
- Configurare il campo: Impostare un'etichetta, un nome, un valore predefinito, una descrizione e assegnarlo alla posizione appropriata.
- Opzioni aggiuntive per il campo audio
Sono disponibili opzioni aggiuntive per Mostra controlli, Riproduzione automatica, Ripetizione e Precaricamento
- Opzioni del campo Documenti
Nessuna opzione aggiuntiva - Opzioni del campo Video
Sono disponibili opzioni aggiuntive per aggiungere un'immagine di copertina, Mostra controlli, Riproduzione automatica, Riproduzione in loop, riproduzione in linea e precaricamento
Opzioni aggiuntive per il campo video
- Opzioni aggiuntive per il campo audio
- Salva e assegna ai layout: Facoltativamente, assegna il campo a layout o moduli specifici.
Esperienza back-end
Durante la modifica di un articolo (o di un altro elemento con campi personalizzati), il campo ora apre un selettore di file modale filtrato in base al tipo scelto:
- Audio → mostra solo file audio
- Video → mostra solo file video e offre l'opzione di aggiungere un'immagine di copertina
- Documento → mostra documenti come PDF o file Word e consente di personalizzare il link da visualizzare
- Immagine → si comporta come prima
Output front-end
Questi nuovi campi possono essere visualizzati esattamente come tutti gli altri campi personalizzati di Joomla. Possono essere visualizzati in una posizione specifica all'interno dell'articolo, come tutti i campi personalizzati, oppure possono essere inseriti direttamente nel contenuto
{ field 1 } visualizzerà il campo con l'ID 1
{ field 1,foo } visualizzerà il campo selezionato utilizzando il layout alternativo ‘foo’.
{ fieldgroup 2 } visualizzerà tutti i campi all'interno del gruppo di campi con l'ID 2.
Campi audio
Visualizzati come lettore audio HTML5:
Campi video
Visualizzati come lettore video HTML5:
Campi documento
Visualizzato come semplice link per il download:
Sezione sviluppatori: più campi in un unico plugin
Tecnicamente, tutti e quattro i tipi di media sono gestiti da un unico plugin per i campi, plg_fields_media. Questo è significativo per gli sviluppatori perché:
- Dimostra come implementare più tipi di campi correlati in un unico plugin.
- Ogni tipo ha il proprio identificatore (
media_audio,media_video,media_document,media) ma riutilizza la stessa logica del plugin. - Funge da modello/esempio per la creazione di plugin per campi multi-tipo personalizzati, riducendo la duplicazione e semplificando la manutenzione.
Conclusione
Il supporto esteso di Joomla 6.1 per i media nei campi personalizzati rappresenta un grande vantaggio in termini di flessibilità dei contenuti. Che si tratti di creare un archivio di podcast, una galleria video o risorse scaricabili, questi nuovi tipi di campo rendono la gestione dei contenuti multimediali semplice e intuitiva.
Gli sviluppatori dispongono ora di un esempio concreto di un singolo plugin di campo che supporta più tipi, aprendo nuove opportunità per la creazione di plugin di campo sofisticati e di facile manutenzione.
Alcuni articoli pubblicati sulla rivista Joomla Community Magazine rappresentano l'opinione personale o l'esperienza dell'autore su un argomento specifico e potrebbero non essere in linea con la posizione ufficiale del progetto Joomla.