Wdrożenie CookieOfficer w Drupalu

W systemie Drupal masz do wyboru dwie ścieżki: moduł do wstawiania kodu albo szablon motywu. Pierwsza nie wymaga dostępu do plików motywu, druga daje pełną kontrolę nad kolejnością skryptów. Niezależnie od wyboru pamiętaj o wyczyszczeniu pamięci podręcznej, bo bez tego Drupal będzie dalej serwował stronę kodu CookieOfficer.

Przed rozpoczęciem

Skopiuj kod CookieOfficer ze strony Instalacja w panelu. W sekcji „Sposób wdrożenia” wybierz „Kod na stronie”, a następnie w karcie „Wklej kod na początku <head>” kliknij „Kopiuj” przy bloku „Skrypt CookieOfficer”.

Potrzebujesz konta z uprawnieniami administratora Drupala. W instrukcji znajdziesz nazwy poszczególnych miejsc po polsku, a w nawiasie po angielsku ponieważ w wielu instalacjach Drupal pozostaje nieprzetłumaczony.

Metoda 1: moduł do wstawiania kodu w <head>

To najprostszy sposób i jedyny, który nie wymaga dostępu do plików motywu.

1. Przejdź do Rozszerzenia (Extend) i zainstaluj moduł pozwalający dodać własny kod do nagłówka strony.
2. Włącz moduł i otwórz jego ustawienia.
3. Wklej kod CookieOfficer w polu odpowiadającym sekcji <head>, na samym początku, przed innymi skryptami.
4. Zapisz konfigurację.
5. Wyczyść pamięć podręczną Drupala.

Jeśli moduł pozwala wybrać kolejność albo wagę wstawianego kodu, ustaw ją tak, aby nasz kod trafił przed pozostałe narzędzia śledzące.

Metoda 2: szablon motywu

Ta droga wymaga dostępu do plików i motywu potomnego. Zmiany w motywie nadrzędnym zostaną nadpisane przy jego aktualizacji.

1. Otwórz plik szablonu strony w swoim motywie potomnym, czyli html.html.twig.
2. Wklej kod CookieOfficer tuż po otwierającym znaczniku <head>, przed pozostałymi skryptami i przed miejscem, w którym Drupal wstawia własne zasoby.
3. Zapisz plik.
4. Wyczyść pamięć podręczną Drupala.

Dlaczego trzeba wyczyścić pamięć podręczną?

Drupal buforuje wygenerowane strony i szablony. Do czasu wyczyszczenia pamięci podręcznej użytkownicy dostają wersję strony sprzed zmiany, bez naszego kodu, a test wdrożenia zakończy się niepowodzeniem.

Pamięć podręczną wyczyścisz w Konfiguracja > Programowanie > Wydajność (Configuration > Development > Performance) albo poleceniem drush cr, jeśli korzystasz z konsoli.

Jak sprawdzić wdrożenie?

Wróć na stronę Instalacja w panelu CookieOfficer i kliknij „Zweryfikuj teraz”. Po powodzeniu zobaczysz nagłówek „Skrypt wykryty i aktywny”.

Następnie, w panelu, uruchom skan serwisu i wejdź na stronę Cookies. Nad listą wykrytych pozycji nie powinno być komunikatu o trackerach działających po odrzuceniu zgody przez użytkownika.

Sprawdzaj baner na stronie zawsze jako niezalogowany użytkownik, w trybie incognito. Drupal serwuje zalogowanym administratorom strony z pominięciem części pamięci podręcznej, więc wynik może się różnić od tego, co widzą użytkownicy Twojej strony.

Częste błędy, których warto unikać

• Nie pomijaj czyszczenia pamięci podręcznej. To najczęstsza przyczyna nieudanych wdrożeń w Drupalu. Kod jest poprawnie wdrożony ale strona nadal serwuje starą wersję.
• Nie edytuj motywu nadrzędnego. Przy aktualizacji motywu zmiany znikną razem z banerem.
• Nie wklejaj kodu za zasobami dodawanymi przez Drupala. Wszystko, co uruchomi się przed naszym kodem, pozostaje poza zasięgiem blokowania automatycznego.
• Nie oznaczaj ręcznie skryptów dodawanych przez moduły. Trafiają na stronę przez własne mechanizmy Drupala, więc nie zmienisz ich w szablonie. Wstrzymanie takiego skryptu wymaga zmiany po stronie modułu albo motywu, i to zmiany podwójnej: type musi zostać ustawiony na text/plain, a obok niego ma stanąć data-co-cat. Sam atrybut niczego nie wstrzyma.