Instalacja i konfiguracja widżetu dostępności (WCAG) w systemie Drupal

Poniższa instrukcja przeprowadzi Cię przez proces instalacji modułu oraz jego konfigurację w panelu administracyjnym.

Krok 1: Instalacja modułu

W środowisku Drupal zalecaną metodą instalacji rozszerzeń jest użycie menedżera pakietów Composer.

1. Pobranie plików:
   Uruchom terminal w katalogu głównym swojej instalacji Drupala i wpisz polecenie:

   composer require drupal/assist_for_wcag
   

2. Włączenie modułu:
   Po pobraniu plików zaloguj się do panelu administracyjnego Drupala.
   • Przejdź do zakładki Rozszerzenia w górnym menu.
   • Znajdź na liście moduł o nazwie Assist for WCAG.
   • Zaznacz checkbox przy module i kliknij przycisk Zainstaluj na dole strony.

Krok 2: Rejestracja witryny i uzyskanie tokenu

Aby widżet mógł połączyć się z usługą, niezbędne jest wygenerowanie unikalnego klucza API (tokenu).

Jeżeli instalujesz wtyczkę po raz pierwszy, zarejestruj się za pomocą Google, Facebooka lub użyj własnego adresu e-mail i hasła. Po założeniu konta przejdź do zakładki "Moje strony", a następnie kliknij przycisk "Dodaj nową". W formularzu dodawania nowego strony podaj adresy stron internetowych, na których chcesz zastosować token. Jeśli twoja strona działa na domenie np. example.com i np. www.example.com to konieczne jest dodanie obu adresów. Więcej na ten temat w dokumentacji. Na koniec kliknij przycisk "Zapisz" i skopiuj wygenerowany token.

Krok 3: Konfiguracja i aktywacja widżetu

Gdy posiadasz już wygenerowany token, musisz wprowadzić go w ustawieniach modułu w Drupalu.

1. W panelu administracyjnym przejdź do sekcji Konfiguracja.
2. Znajdź sekcję powiązaną z modułem (zazwyczaj w bloku „System” lub „Interfejs użytkownika”) i kliknij w link konfiguracyjny wtyczki.
3. W polu formularza wklej skopiowany wcześniej token.
4. Kliknij przycisk Zapisz konfigurację.

Krok 4: Czyszczenie pamięci podręcznej i weryfikacja

Po zapisaniu ustawień, zaleca się wyczyszczenie pamięci podręcznej Drupala, aby zmiany były natychmiast widoczne dla użytkowników końcowych.

1. Przejdź do menu Konfiguracja > Wydajność.
2. Kliknij przycisk Wyczyść wszystkie pamięci podręczne.

Krok 5: Podgląd witryny

Po zakończeniu instalacji i wyczyszczeniu cache, przejdź na stronę główną swojej witryny. Przetestuj widżet, aby upewnić się, że ładuje się poprawnie, a wszystkie funkcje ułatwień dostępu działają zgodnie z wymogami WCAG.

---

Alternatywa: Ręczna instalacja (bez użycia modułu)

Jeśli z jakiegoś powodu nie możesz użyć dedykowanego modułu, możesz zintegrować widżet ręcznie, edytując pliki szablonu.

Uwaga: Ta metoda wymaga edycji plików szablonu .html.twig. Zalecamy utworzenie kopii zapasowej przed wprowadzeniem zmian.

1. Uzyskaj token: Wykonaj kroki opisane w sekcji „Krok 2” powyżej.
2. Skopiuj kod skryptu:
   

   
   <script>
       (function (d, s, t) {
           var f = d.getElementsByTagName(s)[0],
               j = d.createElement(s);
           j.async = true;
           j.src = '//wcag.dock.codes/accessibility/' + t + '/start.js';
           f.parentNode.insertBefore(j, f);
       })(document, 'script', '_TOKEN_');
   </script>
   

3. Edycja szablonu:
   • Przejdź do folderu swojego aktywnego motywu: /themes/[twoj_motyw]/templates/.
   • Znajdź plik html.html.twig (odpowiada on za strukturę HTML całej strony).
   • Wklej skrypt przed znacznikiem zamykającym </body>.
   • Zastąp ciąg _TOKEN_ swoim unikalnym tokenem.
4. Wyczyść cache: Tak jak w Kroku 4 powyżej, wyczyść pamięć podręczną Drupala, aby zmiany w plikach szablonu zostały załadowane.