Seit dem Wahnsinn von http://drupal.org/node/1092444 hat sich viel geändert . Zum Glück ist das Theming und Festlegen von Anzeigeformatierern für Dateientitäten jetzt viel einfacher und unkomplizierter.
Die folgende Dokumentation bezieht sich auf Media 2.x und File Entity , obwohl ein Großteil davon mit Media 1.x mit geringfügigen Änderungen funktioniert (z. B. in Media 1.x befindet sich der Link zur Seite "Dateitypen" in Configuration anstelle von Structure ).
Anzeigen von Medien
Die Module File Entity und Media bilden zusammen eine einheitliche Methode zum Speichern, Verwalten und Anzeigen von Medien in Drupal. Sie ermöglichen es einem Benutzer, Dateifelder zu erstellen, die zum Speichern und Anzeigen vieler verschiedener Medientypen konfiguriert werden können, einschließlich Bildern, Videos und Audiodaten. unter anderen. Um diese verschiedenen Medientypen anzuzeigen, benötigen Dateifelder Formatierer, die häufig von dem Modul bereitgestellt werden, das den Medientyp bereitstellt, und eine zusätzliche Konfiguration.
Definitionen
Ich werde zuerst einige der beweglichen Teile erklären und dann die Anzeige von Dateien auf einer Site anpassen.
Datentypen
Dateien werden in Dateitypen gruppiert . Jeder Dateityp wird durch eine Liste von MIME-Typen definiert , eine universelle Methode zur Angabe von Dateiformaten im Internet. Die Standarddateitypen sind "Anwendung", "Audio", "Bild", "Text", "Video" und "Andere". Es gibt derzeit keine Möglichkeit, neue Dateitypen in der Benutzeroberfläche zu definieren.
Ansichtsmodi
Ansichtsmodi werden verwendet, um Drupal 7 (und bald 8) mitzuteilen, dass sich ein Teil des Inhalts in einem bestimmten Kontext befindet. Der Inhalt kann dann so geändert oder angezeigt werden, dass er am besten zu diesem Kontext passt. Zwei Anzeigemodi , die die meisten Menschen wohl vertraut sind sind die Standard - Teaser und voll Modi. Benutzerdefinierte Ansichtsmodi können mit Modulen wie Entity View Mode , Display Suite oder in einem benutzerdefinierten Modul mit definiert werden hook_entity_info_alter().
The Good Stuff, oder: Verwalten der Anzeige Ihres Dateifelds
Die Anzeige eines Dateifelds wird nach Dateityp verwaltet . Navigieren Sie zu Struktur -> Dateitypen. Sie sehen eine Liste der verfügbaren Dateitypen mit Links zu "Felder verwalten", "Anzeige verwalten" und "Dateianzeige verwalten".
Felder verwalten
Mit dem Modul "Dateieinheit" werden alle Dateien zu vollständig feldfähigen Einheiten, genau wie Knoten und Taxonomiebegriffe. Genau wie im Abschnitt "Inhaltstypen" können Sie jedem Dateityp benutzerdefinierte Felder hinzufügen.
Anzeige verwalten
Wie unter "Inhaltstypen" können Sie auch hier die Anzeige benutzerdefinierter Felder für jeden Dateityp verwalten. In diesem Abschnitt wird nicht die Formatierung der Dateien selbst gesteuert, sondern nur die Anzeige der Felder, die an die Dateientität angehängt sind.
In diesem Abschnitt sehen Sie auch einen Schalter für "Benutzerdefinierte Anzeigeeinstellungen". Wenn diese Option erweitert ist, können Sie die für diese Entität verfügbaren Ansichtsmodi aktivieren und deaktivieren. Ein Anzeigemodus muss hier markiert sein, damit er in "Dateianzeige verwalten" verfügbar ist. Derzeit wird empfohlen, nur benutzerdefinierte Ansichtsmodi und die folgenden Standardansichtsmodi zu verwenden. Der Rest bleibt von der Integration des Styles-Moduls übrig und wird schließlich entfernt :
- "Teaser" (Derzeit nicht standardmäßig enthalten. Sie können es mit dem Patch in der obigen Ausgabe hinzufügen oder als benutzerdefinierten Ansichtsmodus definieren.)
- "Voll"
- "Vorschau" (Wird in Administratorkontexten verwendet, z. B. für Platzhalter in WYSIWYG-Feldern, im Medienbrowser und im Medienfeld-Widget.)
Dateianzeige verwalten
In "Dateianzeige verwalten" können Sie Formatierer für Ihre Dateitypen konfigurieren (ja!). Viele Medienanbieter-Module fügen hier ihre eigenen Formatierer hinzu. Zum Beispiel bieten Media: Youtube und Media: Vimeo ein "Vorschaubild" - und ein "Video" -Formatierer.
Formatierer können für jeden Ansichtsmodus aktiviert und konfiguriert werden, der im Abschnitt "Anzeige verwalten" ihres Dateityps aktiviert ist. Beispielsweise möchte ein Benutzer möglicherweise ein Media: Vimeo-Vorschaubild anzeigen, wenn ein Knoten als Teaser angezeigt wird, das Vimeo-Video, wenn der gesamte Knoten angezeigt wird, und ein Video mit unterschiedlichen Einstellungen für den Formatierer für Breite und Höhe, wenn der Knoten angezeigt wird einen benutzerdefinierten Anzeigemodus namens "Videogalerie". Bei vielen Formatierern (insbesondere "Bild") kann der Benutzer die Bildstile auswählen, die er unter Konfiguration -> Bildstile definiert hat.
Da mehrere Medienanbieter dasselbe Feld verwenden können, werden Formatierer in einer Kaskade von oben nach unten angeordnet. Drupal verwendet den ersten Formatierer, der auf die Ausgabe eines Feldes angewendet werden kann. Wenn in einem Videofeld die Formate "Media: Youtube Video", "Media: Vimeo Video" und "Large Filetype Icon" für den Ansichtsmodus "Voll" aktiviert sind, verwendet Drupal den Youtube-Formatierer, wenn der Mime-Typ der Datei " video/youtubeVimeo" ist Formatierung, wenn der MIME-Typ ist video/vimeo, und Rückgriff auf das große Dateityp-Symbol, wenn der MIME-Typ ist video/{anything else}.
Konfigurieren des Dateifelds für die Anzeige mithilfe der Einstellungen unter "Dateianzeige verwalten"
Damit das Dateifeld mit den unter "Dateianzeige verwalten" definierten Formatierern angezeigt wird, muss es für die Anzeige der "gerenderten Datei" eingestellt sein. Navigieren Sie zur Seite "Anzeige verwalten" für den Inhaltstyp , der Ihr Dateifeld enthält. Wählen Sie "Gerenderte Datei" als Format des Dateifelds für alle Ansichtsmodi, in denen Sie die unter "Dateianzeige verwalten" definierten Formatierer verwenden möchten.
Weiteres Theming
Sie können benutzerdefinierte Designfunktionen und Vorlagendateien erstellen, um die Steuerung durch das Überschreiben von Design-Hooks zu verbessern . Folgende Themenvorschläge werden vom Modul "File Entity" bereitgestellt:
file__{file type}
file__{file type}__{view mode}
file__{mime type}
file__{mime type}__{view mode}
file__{file id}
file__{file id}__{view mode}
Ersetzen Sie alle '/' und '__' in MIME-Typen durch '_' für Themenfunktionen und '-' für Vorlagendateien.
Einige Medienanbieter-Module ersetzen diese durch eigene Vorlagen und Vorschläge für Themen-Hooks. Sie können alle verfügbaren Vorschläge zu Themen- Hooks mit dem Devel Theme Developer- Modul, Mothership's Poor Themer's Helper , anzeigen oder hoffentlich in den Dokumenten des Anbieters nach weiteren Informationen suchen.
Outro
Hoffe das hilft. Ich habe vor, dies in die Mediendokumentation aufzunehmen. Wenn ich also etwas verpasst habe, irgendwo einen Fehler gemacht habe oder ein Abschnitt einer Klärung bedarf, lassen Sie es mich bitte wissen.
Und einige kurze Antworten auf die spezifischen Fragen des OP:
- Media 1.x vs. 2.x: Obwohl 2.x instabil ist, ist es genauso zuverlässig wie viele Module mit stabiler Version auf Drupal.org. Ich denke, es lohnt sich, die stark verbesserten Funktionen zu verwenden, aber da in der Problemwarteschlange so viel Arbeit anfällt, kann es sein, dass neue Updates Ihre Implementierung beschädigen. Trotzdem benutze ich es für die Produktion.
- Medien sind in Entwicklung. Einige Dinge funktionieren noch nicht so, wie Sie es sich erhoffen (z. B. Nicht-Image-WYSIWYG-Integration). Aber es funktioniert immer noch besser als die Kombination von Modulen, die Sie installieren müssen, um das zu tun, was es ohne es tut. Und es wird besser.