Nadpisywanie szablonów kreatora DXPR.

Poznaj DXPR BuilderZarządzaj witrynąDopasuj do marki

Kreator DXPR renderuje elementy w przeglądarce, z szablonów skompilowanych do edytora. Nie ma szablonu elementu do skopiowania do motywu. Moduł dostarcza cztery szablony Twig dla własnych stron i nadpisujesz je zwykłym drupalowym sposobem. Ta strona je wymienia, wyjaśnia, dlaczego znaczników elementów nie da się nadpisać, i wskazuje obsługiwane zamiast tego trasy.

Szablony Twig do nadpisania

Szablony znajdują się w katalogu templates/ modułu:

Szablon Używany do Zmienne
dxpr-license-info.html.twig Podsumowanie użycia na stronach User Licenses i Content items oraz informacyjny blok License info. used_count, total_count, limit, block_label, total_label, used_label, more_info_link
page--dxpr-builder--media-library.html.twig Opakowanie strony okna biblioteki mediów w /dxpr_builder/media-library standardowe zmienne page w dokumencie
html--dxpr-builder--media-library.html.twig Opakowanie <html> tego samego okna standardowe zmienne html w dokumencie
page--people-list.html.twig Punkt startowy strony People (/admin/people) z podsumowaniem licencji standardowe zmienne page plus user_license

Pierwsze trzy działają bez zmian. Drupal nie wczytuje page--people-list.html.twig z modułu. Kreator DXPR dodaje tylko sugestię page__people_list i zmienną user_license na stronie People. Aby pokazać tam podsumowanie, skopiuj plik do motywu administracyjnego.

Aby nadpisać szablon:

  1. Skopiuj plik z modules/contrib/dxpr_builder/templates/ do katalogu templates/ motywu, który go renderuje. Strony administracyjne i okno biblioteki mediów używają motywu administracyjnego. Blok License info używa motywu regionu, w którym go umieszczono.
  2. Edytuj kopię.
  3. Wyczyść pamięci podręczne poleceniem drush cr.

Dlaczego znaczników elementów nie da się nadpisać

Znaczniki każdego elementu to szablon twig.js w dxpr_builder/templates/, na przykład elements/alert/alert.twig.html. Kompilacja buduje z tych szablonów dxpr_builder/dxpr_templates.js. Edytor renderuje je w przeglądarce i zapisuje wynikowy HTML do pola. Wynikają z tego dwie rzeczy:

  • Zmieniony szablon wymaga przebudowania edytora. Witryny wczytujące edytor z DXPR CDN wcale nie mogą użyć zmienionego szablonu.
  • Zapisane strony zachowują HTML, z którym je zapisano. Nowy szablon wpływa tylko na elementy renderowane po zmianie.

Moduł nie oferuje więc nadpisania szablonów elementów dla witryny. Użyj jednej z poniższych tras.

Obsługiwane trasy dostosowania

Cel Trasa
Układy wielokrotnego użytku dla redaktorów Szablony stron i szablony użytkowników, oba wybierane w kreatorze
Zmiana wyglądu elementów Własny CSS w motywie, celowany we własne klasy albo w klasy az-* kreatora
Nazwane style dla redaktorów Klasy narzędziowe z .info.yml motywu i własne style dla edytora tekstu
Dodatkowe zestawy ikon Biblioteki ikon
Nowe typy elementów Tworzenie własnych elementów

Co dalej?