# 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…

- Strona: <https://www.datafirefly.com/pl/documentation/admin-bar-front-office-prestashop/>
- Język: pl
- Zaktualizowano: 2026-08-22
- Inne języki: [fr](https://www.datafirefly.com/documentation/admin-bar-front-office-prestashop/index.md), [en](https://www.datafirefly.com/en/documentation/admin-bar-front-office-prestashop/index.md), [es](https://www.datafirefly.com/es/documentation/admin-bar-front-office-prestashop/index.md), [de](https://www.datafirefly.com/de/documentation/admin-bar-front-office-prestashop/index.md), [it](https://www.datafirefly.com/it/documentation/admin-bar-front-office-prestashop/index.md), [nl](https://www.datafirefly.com/nl/documentation/admin-bar-front-office-prestashop/index.md), [pt](https://www.datafirefly.com/pt/documentation/admin-bar-front-office-prestashop/index.md)
- Indeks: <https://www.datafirefly.com/pl/documentation/llms.txt>

## 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.

Pasek jest niewidoczny dla odwiedzających: nie jest dla nich ładowany żaden plik CSS ani JavaScript modułu.

## 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

Cztery 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.
- **Pokaż przyciski Zobacz w back office**: dodaje przycisk Zobacz produkt lub Zobacz kategorię w nagłówku back office, na odpowiednich stronach edycji.

## 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.

### Przyciski Zobacz w back office

Na stronie edycji produktu lub kategorii przycisk Zobacz produkt lub Zobacz kategorię jest dodawany do czarnego nagłówka back office, obok Zobacz mój sklep. Otwiera odpowiadającą stronę front office w nowej karcie. Jeśli nagłówek nie zawiera tego linku (kontekst multisklepu z selektorem sklepów), przycisk pojawia się jako pływająca pigułka w prawym dolnym rogu.

### 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.1.0 (2026-08-22)**: przycisk Zobacz produkt i Zobacz kategorię w nagłówku back office, na odpowiednich stronach edycji. Nowa opcja konfiguracji włączająca lub wyłączająca te przyciski.
- **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.
