Pasek Administracyjny Front Office – Dokumentacja

Przegląd

Pasek Administracyjny Front Office dodaje czarny pasek administracyjny w stylu WordPressa u góry Twojego sklepu PrestaShop 8 lub 9. Pojawia się wyłącznie dla pracowników zalogowanych do back office i daje bezpośredni dostęp do strony edycji wyświetlanego produktu, kategorii lub strony CMS, a także przycisk czyszczenia pamięci podręcznej.

Instalacja

1. W back office otwórz Moduły, a następnie Menedżer modułów.
2. Kliknij Prześlij moduł i wybierz plik dfadminbar.zip.
3. Moduł instaluje się i automatycznie zapisuje nazwę katalogu admin.

Pasek jest aktywny natychmiast: otwórz sklep w tej samej przeglądarce co sesja back office, a pojawi się u góry strony.

Konfiguracja

Trzy ustawienia są dostępne w Moduły, Menedżer modułów, Pasek Administracyjny Front Office, Konfiguruj:

• Włącz pasek administracyjny: główny przełącznik modułu.
• Pokaż przycisk czyszczenia pamięci podręcznej: pokazuje lub ukrywa przycisk Wyczyść pamięć podręczną na pasku.
• Ogranicz do profilu SuperAdmin: gdy ta opcja jest aktywna, pasek widzą tylko pracownicy z profilem SuperAdmin. Wyłączona sprawia, że widzi go każdy zalogowany pracownik.

Użytkowanie

Pasek

Pasek stale wyświetla trzy linki do back office: Kokpit, Katalog i Zamówienia. Imię zalogowanego pracownika pojawia się po prawej stronie. Linki zawierają ważny token back office: trafiasz bezpośrednio na stronę docelową, bez pośredniej strony logowania.

Linki kontekstowe

W zależności od przeglądanej strony do paska dodawany jest link edycji:

• Strona produktu: Edytuj ten produkt otwiera stronę edycji produktu.
• Strona kategorii: Edytuj tę kategorię otwiera edycję kategorii.
• Strona CMS: Edytuj tę stronę otwiera edycję strony CMS.

W PrestaShop 8 i 9 wygenerowany URL jest automatycznie konwertowany na nowoczesną stronę edycji back office.

Czyszczenie pamięci podręcznej

Przycisk Wyczyść pamięć podręczną uruchamia wywołanie AJAX, które czyści pamięć podręczną Smarty i XML, pamięć podręczną Media (CCC) i regeneruje indeks klas. Etykieta przycisku potwierdza operację (Pamięć podręczna wyczyszczona). Pamięć podręczna Symfony pozostaje nietknięta: jej czyszczenie z front office powodowałoby zbyt długie czasy odpowiedzi.

Szczegóły techniczne

Wykrywanie pracownika

Moduł odczytuje cookie pracownika psAdmin PrestaShop, waliduje hash hasła za pomocą Employee::checkPassword() i sprawdza, czy konto jest aktywne. Nie jest tworzona żadna dodatkowa sesja, a moduł nie przechowuje danych logowania.

Linki do back office i tokeny

Każdy link jest budowany z tokenem legacy obliczonym dla zalogowanego pracownika (Tools::getAdminToken). PrestaShop następnie konwertuje URL legacy na odpowiadającą mu nowoczesną trasę. Wywołanie AJAX czyszczenia pamięci podręcznej jest chronione dedykowanym tokenem powiązanym z identyfikatorem pracownika.

Katalog admin

Nazwa katalogu admin jest zapisywana podczas instalacji i odświeżana przy każdym otwarciu strony konfiguracji. Jeśli zmienisz nazwę katalogu admin, po prostu otwórz ponownie konfigurację modułu.

Rozwiązywanie problemów

• Pasek się nie pojawia: sprawdź, czy jesteś zalogowany do back office w tej samej przeglądarce, czy moduł jest włączony w konfiguracji i czy opcja SuperAdmin Cię nie wyklucza.
• Pasek zniknął po zmianie nazwy katalogu admin: otwórz stronę konfiguracji modułu, aby zapisać nową nazwę.
• Back office w innej domenie: cookie pracownika musi być współdzielone między sklepem a back office, co odpowiada standardowej instalacji PrestaShop. Back office hostowany w innej domenie nie jest obsługiwany.
• Własny szablon bez hooka displayAfterBodyOpeningTag: pasek jest wstrzykiwany przez ten hook. Jeśli brakuje go w Twoim szablonie, dodaj jego wywołanie w głównym pliku szablonu.

Changelog

• 1.0.0 (2026-08-12): pierwsza wersja publiczna. Pasek administracyjny front office, kontekstowe linki edycji produktów, kategorii i stron CMS, czyszczenie pamięci podręcznej AJAX, ograniczenie SuperAdmin, tłumaczenia FR, EN, ES, DE, IT, PL.