# Benachrichtigungscenter — Vollständige Anleitung

> Überblick Das Modul Benachrichtigungscenter (dfnotificationcenter) fügt eine Benachrichtigungsglocke in den Header Ihres Shops ein, direkt neben dem Warenkorb und dem Link „Mein Konto“. Ein rotes Badge signalisiert ungelesene Benachrichtigungen. Ihre…

- Seite: <https://www.datafirefly.com/de/documentation/dfnotificationcenter/>
- Sprache: de
- Aktualisiert am: 2026-06-27
- Weitere Sprachen: [fr](https://www.datafirefly.com/documentation/dfnotificationcenter/index.md), [en](https://www.datafirefly.com/en/documentation/dfnotificationcenter/index.md), [es](https://www.datafirefly.com/es/documentation/dfnotificationcenter/index.md), [it](https://www.datafirefly.com/it/documentation/dfnotificationcenter/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfnotificationcenter/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfnotificationcenter/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfnotificationcenter/index.md)
- Index: <https://www.datafirefly.com/de/documentation/llms.txt>

## Überblick

Das Modul **Benachrichtigungscenter** (`dfnotificationcenter`) fügt eine **Benachrichtigungsglocke** in den Header Ihres Shops ein, direkt neben dem Warenkorb und dem Link „Mein Konto“. Ein **rotes Badge** signalisiert ungelesene Benachrichtigungen. Ihre **neuen Produkte** erscheinen dort automatisch, und Sie können Ihre **Gutscheincodes** einspielen, die der Kunde mit einem Klick kopiert. Alles ist mehrsprachig, multistore-fähig und mit PrestaShop 8 und 9 kompatibel.

Die Glocke greift einen Reflex auf, den Ihre Besucher bereits aus den sozialen Netzwerken kennen: Ein roter Punkt fällt ins Auge und lädt zum Klick ein – ohne aufdringliches Pop-up und ohne störenden Banner.

## Kompatibilität

- PrestaShop 8.0 bis 9.x
- Einzelshop und Multistore
- PHP 7.2 bis 8.x
- Classic-Theme und individuelle Themes
- Oberfläche in Französisch, Englisch, Spanisch, Deutsch und Italienisch
- Keine Abhängigkeiten (weder Composer noch Framework)

## Installation

1. Öffnen Sie im Back-Office **Module > Modulmanager**.
2. Klicken Sie auf **Modul hochladen** und wählen Sie die Datei `dfnotificationcenter.zip`.
3. Klicken Sie nach der Installation auf **Konfigurieren**.

Bei der Installation legt das Modul seine drei Tabellen an (Benachrichtigungen, Übersetzungen, Lesestatus), registriert seine Hooks (Glocke im Header, Front-Ressourcen, Produktspeicherung, Anlegen einer Warenkorbregel) und fügt den Back-Office-Tab **Notification Center** zur Verwaltung der Benachrichtigungen hinzu.

## Globale Einstellungen

Auf der Seite **Konfigurieren** des Moduls legen Sie das allgemeine Verhalten fest:

- **Automatische Neuprodukt-Benachrichtigungen**: erstellt eine Benachrichtigung bei jedem Speichern eines Produkts.
- **Nur aktive Produkte**: erzeugt die Benachrichtigung nur für aktive, sichtbare Produkte.
- **Auto-Promo bei Warenkorbregel**: erstellt automatisch eine Promo-Benachrichtigung, sobald eine Warenkorbregel mit Code angelegt wird.
- **Lebensdauer der Produktbenachrichtigungen (Tage)**: automatischer Ablauf nach N Tagen. `0` = nie.
- **Aktualisierungsintervall (Sekunden)**: Aktualisierung des Badges im Hintergrund. `0` = deaktiviert.
- **Maximale Elemente im Panel**: Anzahl der in der Glocke angezeigten Benachrichtigungen.
- **Badge-Farbe** und **Glocken-Farbe** (leer = Theme-Farbe).
- **Ton** und **Animation** der Glocke bei einer neuen Benachrichtigung.

## Benachrichtigungen verwalten

Der Tab **Notification Center** (auch über die Schaltfläche „Notification Center öffnen“ auf der Konfigurationsseite erreichbar) listet Ihre Benachrichtigungen mit Typ, Priorität, Anzahl der Aufrufe und Klicks sowie ihrem Aktiv-Status auf. Klicken Sie auf **Benachrichtigung hinzufügen**, um eine zu erstellen.

### Felder einer Benachrichtigung

- **Typ**: Neues Produkt, Gutscheincode, News oder Information. Jeder Typ hat auf Kundenseite sein eigenes Symbol und seine Farbe.
- **Titel** (mehrsprachig, erforderlich) und **Nachricht** (mehrsprachig, Texteditor).
- **Button-Label** (mehrsprachig) und **Link** (Ziel-URL).
- **Produkt-ID**: für den Typ Neues Produkt. Bild und Link werden dann automatisch aufgelöst.
- **Gutscheincode**: für den Typ Gutscheincode. Wird auf Kundenseite mit einer **Kopieren**-Schaltfläche angezeigt.
- **Bild**: optionales Visual (beim Produkttyp ignoriert, dieser nutzt das Titelbild).
- **Zielgruppe**: „Alle Kunden“ oder eine bestimmte Gruppe.
- **Priorität**: je höher der Wert, desto weiter oben erscheint die Benachrichtigung.
- **Startdatum** und **Enddatum**: leer lassen für „sofort sichtbar“ und „läuft nie ab“.
- **Aktiv**: Ein-/Aus-Schalter.

Planung und Targeting lassen sich kombinieren: Sie können zum Beispiel eine Promo-Benachrichtigung planen, die nur für die Gruppe „Treue Kunden“ vom 1. bis 15. des Monats sichtbar ist, mit hoher Priorität, damit sie ganz oben erscheint.

## Automatische neue Produkte

Wenn die Option aktiviert ist, lauscht das Modul auf das Speichern von Produkten (Hook `actionProductSave`) und erstellt eine Benachrichtigung vom Typ Produkt mit Name, Titelbild und Link der Produktseite. Dasselbe Produkt wird nur einmal gemeldet (Deduplizierung über die Produkt-ID).

Bild und Link einer Produktbenachrichtigung werden **bei der Anzeige neu berechnet**. Selbst wenn Sie das Produkt später bearbeiten oder sein Foto ändern, bleibt die Benachrichtigung korrekt. Wird das Produkt inaktiv oder gelöscht, erscheint die Benachrichtigung einfach nicht mehr.

## Gutscheincodes

Erstellen Sie eine Benachrichtigung vom Typ **Gutscheincode**, geben Sie den Code Ihrer Warenkorbregel ein, und er erscheint auf Kundenseite in einem Chip mit einer **Kopieren**-Schaltfläche. Ein Klick, der Code ist in der Zwischenablage, der Kunde kehrt zum Warenkorb zurück, um ihn anzuwenden.

Ist die Option **Auto-Promo bei Warenkorbregel** aktiviert, wird automatisch eine Promo-Benachrichtigung erstellt, sobald eine Warenkorbregel mit Code angelegt wird (Hook `actionObjectCartRuleAddAfter`), wobei deren Gültigkeits-Enddatum übernommen wird.

## Auf Kundenseite

Die Glocke erscheint im Header über den Hook `displayNav2`, neben Warenkorb und „Mein Konto“. Ein rotes Badge zeigt die Anzahl ungelesener Benachrichtigungen an (ab neun zeigt es `9+`). Beim Klick listet ein Dropdown-Panel die Benachrichtigungen auf, die wichtigsten und neuesten zuerst.

- **Als gelesen markieren**: eine Schaltfläche „Alle als gelesen markieren“ und automatisches Lesen beim Klick auf eine Benachrichtigung.
- **Kopieren-Schaltfläche** bei Gutscheincodes.
- **Relativer Zeitstempel** („vor 2 Std.“, „gestern“ …).
- **Responsiv**: Das Panel erscheint auf dem Smartphone am unteren Bildschirmrand (Bottom-Sheet).
- **Barrierefreiheit**: ARIA-Attribute und Schließen per Tastatur (Esc-Taste).

### Gelesen-/Ungelesen-Status

Für **angemeldete Kunden** wird der Gelesen-/Ungelesen-Status serverseitig gespeichert und somit geräteübergreifend geteilt. Für **Gäste** wird er im Browser über `localStorage` gemerkt.

## Statistiken (KPIs)

Jede Benachrichtigung sammelt einen **Aufruf-** und **Klick**-Zähler, sichtbar in der Back-Office-Liste. So erkennen Sie auf einen Blick, welche Benachrichtigungen das meiste Engagement erzeugen.

## PrestaShop-9-Kompatibilität

Das Modul ist von PrestaShop 8.0 bis 9.x konzipiert und getestet:

- der Back-Office-Controller nutzt `ModuleAdminController`, kompatibel mit 8 und 9;
- die Controller vermeiden in PrestaShop 9 entfernte Methoden;
- der Front-AJAX-Controller gibt JSON direkt über `ajaxProcess`-Methoden zurück, ohne inkompatiblen Signatur-Override;
- kein Override des PrestaShop-Kerns.

## FAQ und Fehlerbehebung

### Die Glocke erscheint nicht im Header

Die Glocke wird am Hook `displayNav2` des Classic-Themes eingehängt, wo Warenkorb und Kundenkonto sitzen. Hängen Sie das Modul bei einem individuellen Theme, das diese Position nicht bereitstellt, an den von Ihrem Header genutzten Hook über **Module > Modulmanager**, oder kontaktieren Sie uns.

### Neue Produkte erscheinen nicht

Prüfen Sie, ob die Option **Automatische Neuprodukt-Benachrichtigungen** aktiviert ist. Ist **Nur aktive Produkte** angehakt, muss das Produkt aktiv und sichtbar sein. Ein bereits gemeldetes Produkt wird kein zweites Mal gemeldet.

### Das Badge aktualisiert sich für einen Besucher nicht

Bei Gästen wird der Lesestatus im Browser gespeichert. Das Leeren des Caches oder der Website-Daten setzt diesen Status zurück. Für eine geräteübergreifende Nachverfolgung muss der Kunde angemeldet sein.

### Die Kopieren-Schaltfläche funktioniert nicht

Das Kopieren nutzt die Zwischenablage-API des Browsers, die über HTTPS verfügbar ist. Stellen Sie sicher, dass Ihr Shop über HTTPS ausgeliefert wird; eine Ersatzkopie ist vorgesehen, aber HTTPS garantiert das beste Verhalten.

### Wie übersetze ich die Benachrichtigungen?

Titel, Nachricht und Button-Label sind mehrsprachige Felder: Wählen Sie jede Sprache im Benachrichtigungsformular. Oberflächentexte werden über **Erweiterte Einstellungen > Übersetzungen > Übersetzungen der installierten Module** übersetzt, indem Sie `dfnotificationcenter` auswählen.

### Ist es mit PrestaShop 9 kompatibel?

Ja. Das Modul ist von PrestaShop 8.0 bis 9.x konzipiert und getestet, im Einzelshop wie im Multistore.

## Deinstallation

Die Deinstallation entfernt den Back-Office-Tab, die Einstellungen und die drei Tabellen des Moduls (Benachrichtigungen, Übersetzungen, Lesestatus). Um Ihre Benachrichtigungen zu behalten, deaktivieren Sie das Modul, ohne es zu deinstallieren.
