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 bietet direkten Zugriff auf die Bearbeitungsseite des gerade angezeigten Produkts, der Kategorie oder der CMS-Seite sowie einen Button zum Leeren des Caches.

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

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

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.

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