Wdrożenie CookieOfficer w Joomli

Na platformie Joomla kod CookieOfficer dodasz za pomocą rozszerzenia do wstawiania kodu w nagłówku albo bezpośrednio w pliku szablonu. Pierwsza metoda nie wymaga edycji plików, druga daje pełną kontrolę nad kolejnością skryptów. Po każdej z nich trzeba wyczyścić pamięć podręczną, bo Joomla buforuje wygenerowane strony i do tego czasu serwuje wersję bez naszego kodu.

Nazwy pozycji w panelu podajemy po polsku, a w nawiasie po angielsku, bo w wielu instalacjach Joomla pozostaje nieprzetłumaczona.

Przed rozpoczęciem

Skopiuj kod ze strony Instalacja w panelu CookieOfficer. 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 Joomli.

Metoda 1: rozszerzenie do wstawiania kodu

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

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

Jeśli rozszerzenie pozwala ustawić kolejność albo priorytet wstawiania, wybierz taki, żeby nasz kod trafił przed pozostałe narzędzia śledzące.

Metoda 2: plik index.php w szablonie potomnym

1. Przejdź do System > Szablony witryny (System > Site Templates) i otwórz swój szablon.
2. Na liście plików otwórz index.php.
3. Wklej kod CookieOfficer tuż po otwierającym znaczniku <head>, przed wywołaniem <jdoc:include type="head" /> i przed pozostałymi skryptami.
4. Zapisz plik.
5. Wyczyść pamięć podręczną Joomli.

Znacznik <jdoc:include type="head" /> wstawia arkusze stylów i skrypty Joomli oraz jej rozszerzeń, więc kod umieszczony za nim nie zdąży ich zatrzymać.

Pracuj na szablonie potomnym. Zmiany w szablonie nadrzędnym zostaną nadpisane przy jego najbliższej aktualizacji, a baner zniknie ze strony bez ostrzeżenia. Jeśli Twoja wersja Joomli nie obsługuje szablonów potomnych, zduplikuj szablon przed edycją.

Dlaczego należy wyczyścić pamięć podręczną?

Joomla przechowuje wygenerowane strony i zwraca je użytkownikom bez ponownego składania szablonu. Do czasu wyczyszczenia pamięci podręcznej widzą oni wersję sprzed zmiany, bez naszego kodu, a test wdrożenia zakończy się niepowodzeniem.

Pamięć podręczną wyczyścisz w System > Wyczyść pamięć podręczną (System > Clear Cache). Jeśli korzystasz z dodatkowego buforowania po stronie serwera albo z wtyczki przyspieszającej, wyczyść je również.

Jak zweryfikować wdrożenie?

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

Otwórz witrynę w oknie incognito, jako niezalogowany użytkownik. W zwykłym oknie masz już zapisaną własną decyzję, a Joomla inaczej buforuje strony dla zalogowanych.

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

Jeśli po wdrożeniu coś na stronie przestanie działać, wejdź na stronę Cookies i przy pozycji tego dostawcy przełącz „Blokuj przed zgodą” na „Nie blokujemy”. Blokowanie pozostałych pozycji działa dalej.

Częste błędy, których należy unikać

• Nie pomijaj czyszczenia pamięci podręcznej w Joomla. To najczęstsza przyczyna nieudanych wdrożeń w Joomli. Kod jest na miejscu, a strona nadal serwuje starą wersję.
• Nie edytuj szablonu nadrzędnego. Przy aktualizacji szablonu zmiany znikną razem z banerem.
• Nie wklejaj kodu za <jdoc:include type="head" />. Skrypty Joomli i rozszerzeń zdążą wtedy wystartować przed naszym kodem.
• Nie oznaczaj ręcznie skryptów dodawanych przez rozszerzenia. Trafiają na stronę przez własne mechanizmy Joomli, więc nie zmienisz ich w szablonie. Wstrzymanie takiego skryptu wymaga zmiany podwójnej: type musi zostać ustawiony na text/plain, a obok niego ma stanąć data-co-cat. Sam atrybut niczego nie wstrzyma.