Molte cose sono cambiate dalla follia che era http://drupal.org/node/1092444 . Per fortuna, il tema e l'impostazione dei formattatori di visualizzazione per le entità file sono ora molto più semplici e intuitivi.
La seguente documentazione è relativa a Media 2.xe Entità file , sebbene gran parte di essa funzioni con Media 1.x con lievi modifiche (ad esempio, in Media 1.x, il collegamento alla pagina "Tipi di file" si trova in Configurazione anziché in Struttura ).
Visualizzazione dei media
I moduli File Entity e Media lavorano insieme per fornire un metodo unificato per l'archiviazione, la gestione e la visualizzazione di Media in Drupal. Consentono a un utente di creare campi di file che possono essere configurati per archiviare e visualizzare molti tipi diversi di media, inclusi immagini, video e audio. tra gli altri. Per visualizzare questi diversi tipi di file multimediali, i campi dei file richiedono formattatori, spesso forniti dal modulo che fornisce il tipo di file multimediale e una piccola configurazione aggiuntiva.
definizioni
Spiegherò prima un paio di parti mobili, quindi entrerò nella personalizzazione della visualizzazione dei file su un sito.
Tipi di file
I file sono raggruppati in Tipi di file . Ogni tipo di file è definito da un elenco di tipi MIME , un modo universale di specificare i formati di file su Internet. I tipi di file predefiniti sono Applicazione, Audio, Immagine, Testo, Video e Altro. Al momento non è possibile definire nuovi tipi di file nell'interfaccia utente.
Visualizza modalità
Le modalità di visualizzazione sono usate per dire a Drupal 7 (e presto 8) che un contenuto è in un certo contesto. Il contenuto può quindi essere modificato o visualizzato nel modo che meglio si adatta a quel contesto. Due modalità di visualizzazione che probabilmente la maggior parte delle persone conoscono sono il teaser predefinito e le modalità complete . Le modalità di visualizzazione personalizzate possono essere definite con moduli come Entity View Mode , Display Suite o in un modulo personalizzato con hook_entity_info_alter().
The Good Stuff o: Gestione della visualizzazione del campo File
La visualizzazione di un campo file viene gestita per tipo di file . Passare a Struttura -> Tipi di file. Verrà visualizzato un elenco di tipi di file disponibili con collegamenti a "Gestisci campi", "Gestisci display" e "Gestisci display file" per ciascuno.
Gestisci campi
Il modulo Entità file rende tutti i file entità completamente fieldable, lo stesso di nodi e termini di tassonomia. Proprio come nella sezione "Tipi di contenuto", puoi aggiungere campi personalizzati a ciascun tipo di file.
Gestisci display
Ancora una volta, come in "Tipi di contenuto", è possibile gestire la visualizzazione di campi personalizzati su ciascun tipo di file. Questa sezione non controlla la formattazione dei file stessi , ma solo la visualizzazione dei campi allegati all'entità file.
In questa sezione vedrai anche un interruttore per "Impostazioni di visualizzazione personalizzate". Se espanso, è possibile abilitare e disabilitare le modalità di visualizzazione disponibili per questa entità. Una modalità di visualizzazione deve essere selezionata qui per essere disponibile in "Gestisci visualizzazione file". Al momento si consiglia di utilizzare solo le modalità di visualizzazione personalizzate definite dall'utente e le seguenti modalità di visualizzazione predefinite; il resto viene lasciato dall'integrazione del modulo Stili e alla fine verrà rimosso :
- "Teaser" (Attualmente non incluso per impostazione predefinita. Puoi aggiungerlo con la patch nel problema sopra o definirlo come modalità di visualizzazione personalizzata)
- "Pieno"
- "Anteprima" (utilizzato in contesti di amministrazione, ad es. Per segnaposto nei campi WYSIWYG, nel browser Media e nel widget del campo Media)
Gestisci visualizzazione file
In "Gestisci visualizzazione file" puoi configurare i formattatori per i tuoi tipi di file (sì!). Molti moduli del provider multimediale aggiungono qui i propri formatter; ad esempio Media: Youtube e Media: Vimeo fornisce entrambi un formattatore "Immagine di anteprima" e "Video".
I formattatori possono essere abilitati e configurati per ciascuna modalità di visualizzazione abilitata nella sezione "Gestisci display" del loro tipo di file. Ad esempio, un utente potrebbe voler visualizzare un'immagine di anteprima Media: Vimeo quando un nodo viene visualizzato come teaser, il video Vimeo quando viene visualizzato il nodo completo e un video con impostazioni di formattazione di larghezza e altezza diverse quando il nodo viene visualizzato con una modalità di visualizzazione personalizzata chiamata "galleria video". Molti formattatori (in particolare "Immagine") consentono all'utente di selezionare gli stili di immagine che hanno definito in Configurazione -> Stili di immagine.
Poiché più fornitori di supporti multimediali possono utilizzare lo stesso campo, i formatter sono disposti in una sequenza dall'alto verso il basso. Drupal utilizzerà il primo formatter che può essere applicato all'output di un campo. Se un campo video abilita i formattatori "Media: Youtube Video", "Media: Vimeo Video" e "Icona filetype grande" per la modalità di visualizzazione "Completa", Drupal utilizzerà il formatter Youtube se il tipo mime del file è video/youtube, il Vimeo formatter se il tipo mime è video/vimeo, e torna all'icona di tipo di file grande se il tipo mime è video/{anything else}.
Configurazione del campo file da visualizzare utilizzando le impostazioni "Gestisci visualizzazione file"
Affinché il campo file venga visualizzato utilizzando i formattatori definiti in "Gestisci visualizzazione file", è necessario impostarlo per visualizzare il "file renderizzato". Passare alla pagina "Gestisci display" per il tipo di contenuto che contiene il campo del file. Scegli "File renderizzato" come formato del campo file per tutte le modalità di visualizzazione in cui desideri utilizzare i formattatori definiti in "Gestisci visualizzazione file".
Ulteriore tema
È possibile creare funzioni tema personalizzate e file modello per un controllo ancora maggiore con le sostituzioni di hook tema . I suggerimenti sul tema forniti dal modulo Entità file sono:
file__{file type}
file__{file type}__{view mode}
file__{mime type}
file__{mime type}__{view mode}
file__{file id}
file__{file id}__{view mode}
Sostituisci tutti '/' e '__' nei tipi mime con '_' per le funzioni del tema e '-' per i file modello.
Alcuni moduli del provider multimediale li sostituiscono con i propri modelli e suggerimenti di hook a tema. Puoi visualizzare tutti i suggerimenti di hook a tema disponibili con il modulo Develop Theme Developer , Mothership's Poor Themer's Helper , o si spera di consultare i documenti del provider per maggiori informazioni.
outro
Spero che sia di aiuto. Ho intenzione di aggiungere questo alla documentazione Media, quindi se ho perso qualcosa, ho sbagliato a parlare da qualche parte, o una sezione ha bisogno di chiarimenti, per favore fatemelo sapere.
E alcune brevi risposte alle domande specifiche del PO:
- Media 1.x vs 2.x: anche se 2.x è instabile, è affidabile come molti moduli di versione stabili su Drupal.org. Penso che valga la pena utilizzarlo per le funzionalità notevolmente migliorate, ma poiché c'è così tanto lavoro da fare per il supporto nella coda dei problemi è lento e, come con qualsiasi ramo di sviluppo, i nuovi aggiornamenti potrebbero interrompere l'implementazione. Tuttavia, lo uso in produzione.
- I media sono in fase di sviluppo. Alcune cose non funzionano come si spera ancora (ad esempio, l'integrazione WYSIWYG senza immagine). Ma funziona ancora meglio in ciò che fa rispetto alla combinazione di moduli che devi installare per fare ciò che fa senza di essa. E sta migliorando.