Pozwól swoim użytkownikom wybierać encje Drupala za pomocą modułu przeglądarki encji

W tym wpisie na blogu pokażę, jak umożliwić użytkownikom Drupala wybieranie encji za pomocą modułu „Entity Browser”.

Ten samouczek został zamówiony przez klienta OSTraining, który tworzy witrynę z recenzjami książek. Klient chciał użyć Entity Browser, aby mógł stworzyć tę funkcję:

• Witryna ma dwa typy zawartości: Książki i Recenzje książek.
• Gdy użytkownicy tworzą nową recenzję książki, mogą użyć widoku, aby wyszukać i wybrać recenzowaną książkę. Na przykład, jeśli przeglądają „Wojna i pokój”, mogą wyszukać istniejący węzeł „Wojna i pokój”.
• Po opublikowaniu recenzji książki wybrany węzeł zostanie osadzony w recenzji książki.

To życzenie klienta można zrealizować za pomocą modułu Entity Browser. Ten moduł zapewnia przeglądarkę, której użytkownicy Drupala mogą używać do osadzania węzłów w innych częściach swojej witryny.

Ten samouczek przeprowadzi Cię przez ćwiczenie budowania witryny i pokaże, jak korzystać z modułu Entity Browser.

Krok 1. Zainstaluj wymagane moduły

Aby korzystać z Entity Browser, musisz zainstalować następujące moduły: Entity Browser i Chaos Tools.

Użyj preferowanej metody, aby pobrać i zainstalować te moduły. Używam Kompozytora:

 composer install drupal/entity_browser

 composer install drupal/ctools

Spowoduje to umieszczenie modułów w Twojej instalacji Drupala. Następnie kliknij Rozszerz , wyszukaj oba moduły, włącz je i kliknij Zainstaluj .

Krok 2. Utwórz terminy taksonomii

W tym przykładzie książki są podzielone na kategorie według ich gatunku, więc będziemy potrzebować słownictwa o nazwie „Gatunek książki”.

• Kliknij opcję Struktura > Taksonomia > Dodaj słownik.
• Nadaj słownikowi odpowiednią nazwę i opis.
• Kliknij Zapisz.

• Na karcie Lista kliknij Dodaj termin.

Dodaj następujące terminy:

• Przygoda
• Książka kucharska
• Dramat
• Fantazja
• Przerażenie

Krok 3. Utwórz typ treści książki

Następnie utworzymy typ treści dla naszych książek. Użyjemy taksonomii gatunku książki, którą utworzyliśmy w poprzednim kroku.

• Kliknij opcję Struktura > Typy zawartości > Dodaj typ zawartości.
• Utwórz typ zawartości o nazwie Książka i dodaj te pola z ich domyślnymi ustawieniami:

• Ponownie kliknij Dodaj pole .
• Z listy rozwijanej w obszarze Odniesienie wybierz Termin taksonomii i nadaj mu odpowiednią etykietę.
• Kliknij Zapisz i kontynuuj.

• Pozostaw Dozwoloną liczbę wartości na 1 i kliknij Zapisz ustawienia pola
• Przewiń w dół ekranu Edytuj i wybierz słownictwo, do którego chcesz się odwoływać w swoim typie treści. W tym przypadku: Książka Gatunek
• Kliknij Zapisz ustawienia

• Kliknij kartę Zarządzaj wyświetlaniem formularza .
• Poszukaj pola Gatunek książki i zmień jego widżet na Pola wyboru / przyciski radiowe.
• Kliknij Zapisz.

Krok 4. Utwórz zawartość książki

Teraz nadszedł czas na stworzenie od 5 do 10 książek i przypisanie każdej z nich do określonego gatunku.

• Kliknij Treść > Dodaj zawartość > Książka.

Krok #5. Utwórz widok

Po utworzeniu przykładowej zawartości możesz teraz utworzyć widok. Ten widok będzie wyświetlany w przeglądarce jednostek, dzięki czemu możesz wybrać książkę podczas tworzenia recenzji książki.

• Kliknij opcję Struktura > Widoki > Dodaj widok.
• Utwórz widok o tytule Dostępne książki.
• Pokaż zawartość typu Książka.
• Pozostaw ustawienia strony i blokowania niezaznaczone.
• Kliknij Zapisz i edytuj.

• Kliknij przycisk Dodaj w sekcji WYŚWIETLACZE .
• Wybierz Przeglądarkę jednostek.

• Kliknij opcję Zmień kolejność obok kryteriów SORTOWANIA i usuń kryterium Treść: utworzona w opisie .
• Kliknij Zastosuj.
• Kliknij DODAJ obok kryteriów FILTR i wybierz pole Gatunek książki .
• Kliknij Dodaj i skonfiguruj kryteria filtrowania.

• Upewnij się, że wybrano Słownictwo gatunku książki .
• Zmień typ wyboru na listę rozwijaną.
• Kliknij Zastosuj i kontynuuj.

• Zaznacz Udostępnij ten filtr odwiedzającym, aby mogli go zmienić.
• Upewnij się, że operator jest wybrany jako jest jednym z.
• Kliknij Zastosuj.

• Dodaj pole Tytuł do kryteriów SORTOWANIA .
• Pozostaw konfigurację domyślną Sortuj rosnąco i kliknij Zastosuj.

Spowoduje to wyświetlenie książek w widoku w kolejności alfabetycznej. Musisz wstawić więcej pól, które mają być wyświetlane w widoku. W tej chwili dostępny jest tylko tytuł węzła.

• Kliknij przycisk Dodaj w sekcji Pola .
• Poszukaj pola okładki książki i kliknij Dodaj i skonfiguruj pola.

• Wybierz Styl obrazu (Miniatura 100x100) i kliknij Zastosuj.
• Kliknij ponownie Dodaj, aby dodać pole formularza wyboru zbiorczego przeglądarki jednostek .
• Kliknij Dodaj i skonfiguruj pola.

• Kliknij Zastosuj.

Użycie tego pola jest obowiązkowe, jeśli chcesz korzystać z przeglądarki Entity, więc zwróć na to szczególną uwagę.

• Zmień format widoku, na przykład na Siatka.
• Kliknij dwukrotnie Zastosuj .

Konfiguracja widoku w interfejsie Views powinna wyglądać jak na poniższym obrazku. Kliknij Zapisz , aby zapisać widok.

Krok 6. Skonfiguruj moduł Przeglądarki jednostek

W tym kroku wybierzemy ustawienie modułu klucza w tym samouczku: Przeglądarka jednostek.

• Kliknij Konfiguracja > Przeglądarki jednostek

• Kliknij Dodaj przeglądarkę jednostek.
• Nadaj mu odpowiednią etykietę, na przykład Przeglądarka książek.
• Jako wtyczkę wyświetlania wybierz iFrame.
• Kliknij Dalej.

• Zaznacz opcję Automatyczne otwieranie przeglądarki Entity i kliknij Dalej.

• Kliknij Dalej jeszcze dwa razy, aż przejdziesz do strony konfiguracji widżetów .
• Kliknij listę rozwijaną, aby wybrać wtyczkę widżetu Widok .
• Zmień etykietę widżetu, na przykład: „Wybierz książkę”.
• Wybierz widok skonfigurowany w kroku 5.
• Kliknij Zakończ.

Krok 7. Utwórz typ treści recenzji książki

Nasza strona jest prawie gotowa. Zanim skończymy, musimy utworzyć typ treści, z którego mogą korzystać recenzenci książek:

• Kliknij opcję Struktura > Typy zawartości > Dodaj typ zawartości.
• Nazwij ten typ zawartości Recenzja książki.
• Dodaj nowe pole, z sekcji Referencje wybierz Treść.
• Nadaj temu polu odpowiednią etykietę, na przykład Książka.
• Kliknij Zapisz i kontynuuj.
• W opcji Typ elementu do odniesienia wybierz Zawartość.
• Kliknij Zapisz ustawienia pola.

• Kliknij Zapisz ustawienia.
• Kliknij kartę Zarządzaj wyświetlaniem formularza dla tego typu zawartości.
• Znajdź pole referencyjne i zmień jego widżet na przeglądarkę jednostek.
• Kliknij koło zębate po prawej stronie i wybierz Przeglądarka książek (lub jakkolwiek nazwałeś przeglądarkę, którą właśnie utworzyłeś w kroku 6.
• Kliknij Aktualizuj.
• Kliknij Zapisz.

Zauważ, że masz również możliwość wyświetlenia tylko etykiety Entity lub Full rendered . Możesz użyć trybów wyświetlania (np. Zwiastun), aby zaprezentować encję w tym nowym typie zawartości recenzji książki .

Krok 8. Utwórz recenzje książek

Teraz nasza strona jest prawie gotowa do użycia. Stwórzmy recenzję książki i zobaczmy, czy wszystko działa poprawnie.

• Kliknij opcję Treść > Dodaj treść > Recenzja książki.
• Nadaj temu węzłowi odpowiedni tytuł i treść.
• Przewiń dalej w dół, a znajdziesz zwiniętą sekcję o nazwie KSIĄŻKA (jest to nazwa pola).
• Kliknij to pole, a zobaczysz Wyszukiwarkę jednostek, w której możesz wybrać książkę, do której odwołujesz się w tej recenzji książki.
• Co więcej, na górze znajduje się odsłonięty filtr, dzięki czemu możesz wybrać książki należące tylko do jednego gatunku.
• Wybierz gatunek i kliknij Zastosuj.

Przeglądarka wyświetli tylko książki z tego gatunku.

• Wybierz księgę i kliknij Wybierz elementy.

• Po osadzeniu encji kliknij Zapisz , a w węźle Recenzja książki zobaczysz przywoływaną encję Książka .

Ten samouczek zademonstrował moc modułu „Entity Browser” dla Drupala 8. Mam nadzieję, że Ci się spodobał. Dziękuje za przeczytanie!