# Front-Office Admin-Leiste - Dokumentation

> Überblick Front-Office Admin-Leiste fügt eine schwarze Admin-Leiste im WordPress-Stil am oberen Rand Ihres PrestaShop 8 oder 9 Shops hinzu. Sie erscheint nur für Mitarbeiter, die im Back-Office angemeldet sind, und…

- Seite: <https://www.datafirefly.com/de/documentation/admin-bar-front-office-prestashop/>
- Sprache: de
- Aktualisiert am: 2026-08-22
- Weitere Sprachen: [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), [it](https://www.datafirefly.com/it/documentation/admin-bar-front-office-prestashop/index.md), [pl](https://www.datafirefly.com/pl/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)
- Index: <https://www.datafirefly.com/de/documentation/llms.txt>

## Überblick

Front-Office Admin-Leiste fügt eine schwarze Admin-Leiste im WordPress-Stil am oberen Rand Ihres PrestaShop 8 oder 9 Shops hinzu. Sie erscheint nur für Mitarbeiter, die im Back-Office angemeldet sind, und bietet direkten Zugriff auf die Bearbeitungsseite des gerade angezeigten Produkts, der Kategorie oder der CMS-Seite sowie einen Button zum Leeren des Caches.

Die Leiste ist für Ihre Besucher unsichtbar: Für sie wird keine CSS- oder JavaScript-Datei des Moduls geladen.

## Installation

1. Öffnen Sie im Back-Office Module und dann Modul-Manager.
2. Klicken Sie auf Modul hochladen und wählen Sie die Datei dfadminbar.zip.
3. Das Modul wird installiert und speichert automatisch den Namen Ihres Admin-Ordners.

Die Leiste ist sofort aktiv: Öffnen Sie Ihren Shop im selben Browser wie Ihre Back-Office-Sitzung und sie erscheint am oberen Seitenrand.

## Konfiguration

Vier Einstellungen stehen unter Module, Modul-Manager, Front-Office Admin-Leiste, Konfigurieren zur Verfügung:

- **Admin-Leiste aktivieren**: Hauptschalter des Moduls.
- **Button zum Leeren des Caches anzeigen**: zeigt oder verbirgt den Button Cache leeren in der Leiste.
- **Auf SuperAdmin-Profil beschränken**: Ist diese Option aktiv, sehen nur Mitarbeiter mit dem SuperAdmin-Profil die Leiste. Deaktiviert sieht sie jeder angemeldete Mitarbeiter.
- **Ansehen-Buttons im Back-Office anzeigen**: fügt einen Button Produkt ansehen oder Kategorie ansehen im Back-Office-Header hinzu, auf den entsprechenden Bearbeitungsseiten.

## Verwendung

### Die Leiste

Die Leiste zeigt dauerhaft drei Back-Office-Links: Dashboard, Katalog und Bestellungen. Der Vorname des angemeldeten Mitarbeiters erscheint rechts. Die Links tragen ein gültiges Back-Office-Token: Sie landen direkt auf der Zielseite, ohne zwischengeschaltete Anmeldeseite.

### Kontextbezogene Links

Je nach angezeigter Seite wird der Leiste ein Bearbeitungslink hinzugefügt:

- Produktseite: Dieses Produkt bearbeiten öffnet die Produktbearbeitung.
- Kategorieseite: Diese Kategorie bearbeiten öffnet die Kategoriebearbeitung.
- CMS-Seite: Diese Seite bearbeiten öffnet die Bearbeitung der CMS-Seite.

Auf PrestaShop 8 und 9 wird die erzeugte URL automatisch in die moderne Bearbeitungsseite des Back-Office umgewandelt.

### Ansehen-Buttons im Back-Office

Auf der Bearbeitungsseite eines Produkts oder einer Kategorie wird ein Button Produkt ansehen oder Kategorie ansehen im schwarzen Back-Office-Header neben Meinen Shop ansehen hinzugefügt. Er öffnet die passende Front-Office-Seite in einem neuen Tab. Enthält der Header diesen Link nicht (Multishop-Kontext mit Shop-Auswahl), erscheint der Button als schwebende Pille unten rechts.

### Cache leeren

Der Button Cache leeren löst einen AJAX-Aufruf aus, der die Smarty- und XML-Caches sowie den Media-Cache (CCC) leert und den Klassenindex regeneriert. Die Beschriftung des Buttons bestätigt den Vorgang (Cache geleert). Der Symfony-Cache bleibt unberührt: Ihn aus dem Front-Office zu leeren würde zu lange Antwortzeiten verursachen.

## Technische Details

### Mitarbeitererkennung

Das Modul liest das psAdmin-Mitarbeiter-Cookie von PrestaShop, validiert den Passwort-Hash mit Employee::checkPassword() und prüft, ob das Konto aktiv ist. Es wird keine zusätzliche Session erstellt und das Modul speichert keine Zugangsdaten.

### Back-Office-Links und Tokens

Jeder Link wird mit einem Legacy-Token gebaut, das für den angemeldeten Mitarbeiter berechnet wird (Tools::getAdminToken). PrestaShop wandelt die Legacy-URL anschließend in die passende moderne Route um. Der AJAX-Aufruf zum Leeren des Caches ist durch ein dediziertes Token geschützt, das an die Mitarbeiter-ID gebunden ist.

### Admin-Ordner

Der Name des Admin-Ordners wird bei der Installation gespeichert und bei jedem Öffnen der Konfigurationsseite aktualisiert. Wenn Sie den Admin-Ordner umbenennen, öffnen Sie einfach die Modulkonfiguration erneut.

## Fehlerbehebung

- **Die Leiste erscheint nicht**: Prüfen Sie, ob Sie im selben Browser im Back-Office angemeldet sind, ob das Modul in seiner Konfiguration aktiviert ist und ob die SuperAdmin-Option Sie nicht ausschließt.
- **Die Leiste verschwand nach dem Umbenennen des Admin-Ordners**: Öffnen Sie die Konfigurationsseite des Moduls, um den neuen Namen zu speichern.
- **Back-Office auf einer anderen Domain**: Das Mitarbeiter-Cookie muss zwischen Shop und Back-Office geteilt werden, was der Standardinstallation von PrestaShop entspricht. Ein Back-Office auf einer anderen Domain wird nicht unterstützt.
- **Individuelles Theme ohne den Hook displayAfterBodyOpeningTag**: Die Leiste wird über diesen Hook eingefügt. Fehlt er in Ihrem Theme, ergänzen Sie den Hook-Aufruf im Haupttemplate.

## Changelog

- **1.1.0 (2026-08-22)**: Button Produkt ansehen und Kategorie ansehen im Back-Office-Header, auf den entsprechenden Bearbeitungsseiten. Neue Konfigurationsoption zum Aktivieren oder Deaktivieren dieser Buttons.
- **1.0.0 (2026-08-12)**: erste öffentliche Version. Front-Office-Admin-Leiste, kontextbezogene Bearbeitungslinks für Produkte, Kategorien und CMS-Seiten, AJAX-Cache-Leerung, SuperAdmin-Beschränkung, Übersetzungen FR, EN, ES, DE, IT, PL.
