Wiele się zmieniło od szaleństwa, które było http://drupal.org/node/1092444 . Na szczęście tematyczne i ustawianie formatów wyświetlania dla encji plików jest teraz znacznie łatwiejsze i prostsze.
Poniższa dokumentacja dotyczy Media 2.xi Entity pliku , chociaż większość z nich działa z Media 1.x z niewielkimi zmianami (np. W Media 1.x, link do strony „Typy plików” znajduje się w konfiguracji zamiast w strukturze ).
Wyświetlanie mediów
Pliku Entity i mediów moduły współpracują ze sobą w celu zapewnienia jednolitego sposobu przechowywania, zarządzania i wyświetlania Media w Drupal. Pozwalają użytkownikowi tworzyć pola plików, które można skonfigurować do przechowywania i wyświetlania wielu różnych rodzajów multimediów, w tym obrazów, wideo i audio. pośród innych. Aby wyświetlić te różne typy nośników, pola plików wymagają formatowania, często dostarczanego przez moduł udostępniający typ nośnika i trochę dodatkowej konfiguracji.
Definicje
Najpierw wyjaśnię kilka ruchomych części, a następnie dostosuję sposób wyświetlania plików na stronie.
Typy plików
Pliki są pogrupowane w typy plików . Każdy typ pliku jest zdefiniowany przez listę typów MIME , uniwersalny sposób określania formatów plików w Internecie. Domyślne typy plików to Aplikacja, Audio, Obraz, Tekst, Wideo i Inne. Obecnie nie ma możliwości zdefiniowania nowych typów plików w interfejsie użytkownika.
Wyświetl tryby
Tryby wyświetlania służą do informowania Drupala 7 (i wkrótce 8), że fragment treści znajduje się w określonym kontekście. Zawartość można następnie zmienić lub wyświetlić w sposób, który najlepiej pasuje do tego kontekstu. Dwa tryby widoku, które prawdopodobnie znają większość osób, to domyślny zwiastun i tryby pełne . Niestandardowe tryby widoku można zdefiniować za pomocą modułów takich jak Entity View Mode , Display Suite lub w module niestandardowym za pomocą hook_entity_info_alter().
Dobra rzecz lub: Zarządzanie wyświetlaniem pola pliku
Wyświetlaniem pola pliku zarządza się według typu pliku . Przejdź do Struktura -> Typy plików. Zobaczysz listę dostępnych typów plików z linkami do „Zarządzaj polami”, „Zarządzaj wyświetlaniem” i „Zarządzaj wyświetlaniem plików” dla każdego z nich.
Zarządzaj polami
Moduł Podmiot pliku powoduje, że wszystkie pliki stają się pełnymi obiektami polowymi, takimi samymi jak węzły i warunki taksonomiczne. Podobnie jak w sekcji „Typy treści”, możesz dodawać niestandardowe pola do każdego typu pliku.
Zarządzaj wyświetlaczem
Ponownie, podobnie jak w „Typach treści”, możesz zarządzać wyświetlaniem niestandardowych pól dla każdego typu pliku. Ta sekcja nie kontroluje formatowania samych plików , a jedynie wyświetlanie pól dołączonych do encji pliku.
W tej sekcji zobaczysz także przełącznik „Niestandardowe ustawienia wyświetlania”. Po rozwinięciu możesz włączać i wyłączać tryby widoku dostępne dla tego elementu. Tutaj należy sprawdzić tryb widoku, aby był dostępny w „Zarządzaj wyświetlaniem plików”. W tej chwili zaleca się używanie tylko niestandardowych trybów widoku zdefiniowanych przez użytkownika i następujących domyślnych trybów widoku; pozostałe pozostały z integracji modułu Styles i ostatecznie zostaną usunięte :
- „Teaser” (obecnie domyślnie nie jest dołączony. Możesz dodać go wraz z łatką w powyższym wydaniu lub zdefiniować jako niestandardowy tryb widoku)
- "Pełny"
- „Podgląd” (używany w kontekstach administracyjnych, np. Dla symboli zastępczych w polach WYSIWYG, w przeglądarce multimediów i widżecie pola multimediów)
Zarządzaj wyświetlaniem plików
W „Zarządzaj wyświetlaniem plików” możesz skonfigurować formatery dla swoich typów plików (tak!). Wiele modułów dostawców mediów dodaje tutaj własne formaterery; na przykład Media: Youtube i Media: Vimeo zapewniają formater „Preview Image” i „Video”.
Formaterery można włączać i konfigurować dla każdego trybu widoku włączonego w sekcji „Zarządzaj wyświetlaniem” ich typu pliku. Na przykład użytkownik może chcieć wyświetlić obraz podglądu Media: Vimeo, gdy węzeł jest oglądany jako zwiastun, wideo Vimeo, gdy przeglądany jest pełny węzeł, oraz wideo z różnymi ustawieniami formatowania szerokości i wysokości, gdy węzeł jest oglądany za pomocą niestandardowy tryb wyświetlania o nazwie „galeria wideo”. Wiele formatów (zwłaszcza „Obraz”) pozwala użytkownikowi wybrać style obrazu zdefiniowane w Konfiguracja -> Style obrazu.
Ponieważ wielu dostawców mediów może korzystać z tego samego pola, formaterery są ułożone kaskadowo od góry do dołu. Drupal użyje pierwszego formatera, który można zastosować do wyjścia pola. Jeśli pole wideo włącza formaty „Media: Wideo Youtube”, „Media: Wideo Vimeo” i „Ikona dużego typu pliku” dla trybu widoku „Pełny”, Drupal użyje formatera YouTube, jeśli typem pliku jest Mime video/youtube, Vimeo formater, jeśli typ mime jest video/vimeo, i wróć do dużej ikony typu pliku, jeśli typ mime to video/{anything else}.
Konfigurowanie pola pliku do wyświetlania za pomocą ustawień „Zarządzaj wyświetlaniem pliku”
Aby pole pliku wyświetlało się przy użyciu formatów zdefiniowanych w „Zarządzaj wyświetlaniem pliku”, należy ustawić wyświetlanie „renderowanego pliku”. Przejdź do strony „Zarządzaj wyświetlaniem” dla typu zawartości zawierającego pole pliku. Wybierz „Renderowany plik” jako format pola pliku dla wszystkich trybów wyświetlania, w których chcesz używać formatów zdefiniowanych w „Zarządzaj wyświetlaniem pliku”.
Dalszy temat
Możesz tworzyć niestandardowe funkcje motywu i pliki szablonów, aby uzyskać jeszcze większą kontrolę dzięki przesłonięciom zaczepów motywu . Sugestie tematyczne dostarczone przez moduł File Entity to:
file__{file type}
file__{file type}__{view mode}
file__{mime type}
file__{mime type}__{view mode}
file__{file id}
file__{file id}__{view mode}
Zamień wszystkie „/” i „__” w typach MIME na „_” dla funkcji motywu i „-” dla plików szablonów.
Niektóre moduły dostawcy mediów zastępują je własnymi szablonami i sugestiami dotyczącymi motywów. Możesz wyświetlić wszystkie dostępne sugestie dotyczące tematu za pomocą modułu Devel Theme Developer , Mothership's Poor Themer's Helper lub, mam nadzieję, skonsultować się z dokumentacją dostawcy, aby uzyskać więcej informacji.
Outro
Mam nadzieję że to pomoże. Planuję dodać to do dokumentacji medialnej, więc jeśli coś przeoczyłem, gdzieś źle napisałem lub sekcja wymaga wyjaśnienia, daj mi znać.
I kilka krótkich odpowiedzi na szczegółowe pytania PO:
- Media 1.x vs 2.x: chociaż wersja 2.x jest niestabilna, jest tak niezawodna, jak wiele stabilnych modułów wersji na Drupal.org. Myślę, że warto korzystać z znacznie ulepszonych funkcji, ale ponieważ jest tak dużo pracy, obsługa w kolejce problemów jest powolna, i jak w przypadku każdej gałęzi deweloperów, nowe aktualizacje mogą uszkodzić twoją implementację. Mimo to używam go do produkcji.
- Media są w fazie rozwoju. Niektóre rzeczy nie działają tak, jak można się spodziewać (np. Integracja WYSIWYG bez obrazu). Ale nadal działa lepiej w tym, co robi, niż kombinacja modułów, które musisz zainstalować, aby zrobić to bez niego. I jest coraz lepiej.