Smart Favicon: Einrichtung und Hilfe

Voraussetzungen

Erfordert PrestaShop 1.6.0.4 oder neuer und PHP 7.1 oder neuer.

Die Browserfunktionen hängen von JavaScript und den standardmäßigen Header-/Media-Hooks des aktiven Themes ab.

Laden Sie die Release-ZIP-Datei über "Modules > Module Manager > Upload a module" hoch und installieren Sie sie. Öffnen Sie "Favicon > Configuration" oder klicken Sie im "Module Manager" auf "Configure". Wählen Sie im Multistore vor dem Bearbeiten normaler Einstellungen einen bestimmten Shop aus.

"Enable Smart Favicon" ist anfangs eingeschaltet. Zähler-Badge und Erinnerung im Hintergrund sind ebenfalls eingeschaltet. "Prefix the tab title with the count" ist anfangs ausgeschaltet. Ohne hochgeladenes Symbol kann das Modul das vorhandene Shop-Favicon für das Badge verwenden.

Symboldateien

Legen Sie "Light-mode favicon" und "Dark-mode favicon" fest. Sie können ICO, PNG, SVG oder WebP hochladen. Verwenden Sie für ein einfaches Symbol ein quadratisches PNG mit mindestens 32 mal 32 Pixeln. Verwenden Sie eine größere Rasterquelle, wenn Sie größere App-Symbole generieren möchten.

Uploads sind auf 1 MB begrenzt. PNG/WebP-Bilder dürfen in keiner Dimension 1.024 Pixel überschreiten. SVG-Dateien benötigen eine viewBox oder explizite Breiten- und Höhenangaben; die Bereinigung baut das akzeptierte SVG vor dem Speichern neu auf. Nicht unterstützte oder unsichere Dateien werden abgelehnt.

Klicken Sie auf "Save" und prüfen Sie "Current light icon" und "Current dark icon". Uploads werden unter neuen Dateinamen in img/mprfavicon/ gespeichert, damit die bisherige zwischengespeicherte URL nicht erneut verwendet wird. Das Verzeichnis muss für den Webserver beschreibbar sein.

Verwenden Sie "Remove light icon on save" oder "Remove dark icon on save", um eine Variante zu entfernen. Diese Schalter sind anfangs ausgeschaltet.

Verhalten bei Farbschemata

Browser mit Unterstützung für Favicon-Media-Queries wählen die Hell-/Dunkel-Links über prefers-color-scheme. Das Modul folgt auch Änderungen des Systemfarbschemas. Ein Schema ohne eigenen Upload greift auf das native Shop-Favicon zurück. Ohne hochgeladene Varianten fügt das Modul keine Ersatzlinks für die Farbschemata hinzu; das aktive Badge kann dennoch ein verwaltetes Symbol erzeugen.

Der Generator verwendet die erste decodierbare Rasterquelle und prüft die helle vor der dunklen Variante. Er erstellt PNGs mit 16, 32, 48, 180, 192, 256 und 512 Pixeln sowie eine ICO-Datei mit mehreren Größen. Das Frontoffice kann Symbol-Links für 16/32/48 Pixel, ein Apple-Touch-Symbol und die 192/512-Symbole des Manifests ausgeben. Das Modul liefert das Manifest mit dem für ein Web-Manifest erforderlichen Inhaltstyp aus.

Die Bildgenerierung benötigt GD mit dem passenden PNG/WebP-Decoder. Wenn das Backoffice meldet, dass eine Rasterquelle benötigt wird, laden Sie PNG oder WebP hoch und speichern Sie erneut.

Globales Stammsymbol im Multistore

Die Installation hat eine einzige favicon.ico im Stammverzeichnis. Diese kann jeden Shop betreffen, der dieses Stammverzeichnis nutzt. Der Shop, der das Überschreiben aktiviert, ist ihr Eigentümer. Ein anderer Shop kann die Datei des Eigentümers nicht über seine eigenen Einstellungen ersetzen oder wiederherstellen.

Das Modul sichert das Original vor dem Ersetzen. Der Eigentümer kann den Schalter deaktivieren und speichern, um eine Wiederherstellung anzufordern. Unter "All shops" gibt "Release global favicon.ico ownership" die gemeinsame Eigentümerschaft frei und versucht die Wiederherstellung. Normale Einstellungen pro Shop werden im Kontext eines bestimmten Shops bearbeitet.

Wenn jemand das Stammsymbol außerhalb des Moduls geändert hat, behält die Wiederherstellung diese neuere Datei bei. Wenn Sicherung, Eigentumsverwaltung, Sperren oder Wiederherstellung fehlschlagen, bewahrt das Modul den Wiederherstellungsstatus und meldet das Problem. Löschen Sie die Sicherung nicht, um einen Fehler zu beseitigen.

Suchdienste entscheiden selbst, welches Symbol sie anzeigen und wann sie es aktualisieren.

"Custom back-office favicon" ist anfangs eingeschaltet. Laden Sie "Back-office favicon" für ein eigenes Administrationssymbol hoch oder lassen Sie es leer, um das helle Symbol wiederzuverwenden. Ist keines vorhanden, bleibt das native Administrationssymbol verfügbar.

Prüfen Sie nach dem Speichern "Current admin icon". Verwenden Sie "Remove admin icon on save", um die separate Datei zu entfernen. Das Backoffice-Symbol zeigt kein Warenkorb-Badge des Frontoffice an.

Andere Module können Quellenschalter hinzufügen. Deaktivieren Sie Quellen, die nicht mitgezählt werden sollen. Badge, Zählerpräfix und Standarderinnerung verwenden den gewählten kombinierten Zählerstand, sodass eine andere aktivierte Quelle sie auch bei leerem Warenkorb aktiv halten kann.

Unter PrestaShop 1.7/8/9 lauscht die Laufzeitlogik auf Warenkorbereignisse. Unter PrestaShop 1.6 beobachtet sie den alten Warenkorbzähler und umschließt unterstützte ajaxCart-Methoden. Testen Sie Hinzufügen, Entfernen und Mengenänderungen mit Ihrem Theme.

Zählerpräfix

Aktivieren Sie "Prefix the tab title with the count", wenn der Zähler im Titel erscheinen soll. "Title format" ist anfangs ({count}) {title}. Behalten Sie {title} im Format bei, damit der Seitentitel erhalten bleibt. Ein leeres Format oder eines ohne {title} fällt auf den Standard zurück.

Erinnerung im Hintergrund

"Attention nudge when the tab is in the background" ist anfangs eingeschaltet. Füllen Sie "Nudge messages" für jede Shop-Sprache aus, eine Nachricht pro Zeile. Die mitgelieferten englischen Nachrichten lauten „🛒 Still thinking it over?“ und „Your items are waiting“; mitgelieferte Übersetzungen werden verwendet, sofern verfügbar.

"Rotation interval" beträgt anfangs 4 Sekunden und ist auf 2 bis 60 Sekunden begrenzt. Die Standarderinnerung läuft, solange der Tab nicht fokussiert und der gewählte Zählerstand positiv ist. Die Rückkehr zum Tab stoppt die Erinnerung und stellt den normalen Titel einschließlich des aktuellen Zählerpräfixes wieder her, sofern aktiviert.

Titeländerungen erfolgen nach dem Laden der Seite in JavaScript. Der serverseitig gerenderte Titel bleibt unverändert. Die Laufzeitlogik überspringt erkannte Bots und Browser, die navigator.webdriver melden. Testen Sie daher neben automatisierten Werkzeugen auch in einer normalen Browsersitzung.

Öffnen Sie "Favicon > Engagement campaigns", um eigene Interaktionsregeln hinzuzufügen. Die grundlegenden Einstellungen für Badge, Farbschema und Titel benötigen keine Kampagne.

Legen Sie "Name" fest, wählen Sie einen "Trigger" und dann "Match mode" als "All conditions" oder "Any condition". Verwenden Sie die verfügbaren Bedingungs- und Aktionslisten des Editors. Legen Sie "Minimum re-entry delay on this page" in Millisekunden fest; der Wert beginnt bei 0 und wird bei der Navigation zurückgesetzt. "Priority" beginnt bei 0, höhere Werte gewinnen exklusive Aktionskanäle. Der zulässige Bereich ist -1000 bis 1000. Neue Kampagnen sind anfangs deaktiviert; schalten Sie nach der Prüfung der Regel "Enabled" ein und klicken Sie auf "Save".

Kampagnen gehören zum ausgewählten Shop. Testen Sie den Auslöser und prüfen Sie Überschneidungen mit den Standardaktionen für Titel und Favicon. Deaktivieren Sie eine Kampagne in der Liste, wenn Sie ihre Konfiguration behalten möchten, ohne sie auszuführen.

Eine aktivierte Quelle registrieren

Registrieren Sie Ihr bereitstellendes Modul auf actionRegisterFaviconBadge und geben Sie einen Deskriptor zurück:

public function hookActionRegisterFaviconBadge($params)
{
    return [
        'id' => 'tickets',
        'label' => $this->l('Unread replies'),
        'script' => 'modules/yourmodule/views/js/source.js',
    ];
}

Quellen-IDs verwenden Kleinbuchstaben, Ziffern, _ oder - und höchstens 40 Zeichen. Verwenden Sie nicht die reservierte ID cart. Ein Skriptpfad ist optional und muss relativ zum Shop-Stammverzeichnis sein. Das Modul erstellt einen Schalter für die deklarierte Quelle; beigesteuerte Quellen sind anfangs aktiviert.

Registrieren Sie den passenden Zähler im Skript:

window.mprFavicon.registerSource('tickets', function () {
    return 3; // A number or a Promise resolving to a number.
});
window.mprFavicon.update();

Rufen Sie nach einer Änderung des zugrunde liegenden Werts update() auf. Die serverseitige Liste aktivierter Quellen ist maßgeblich. Allein die Registrierung einer beliebigen JavaScript-Quelle fügt diese weder zu dieser Liste hinzu noch umgeht sie eine vom Händler deaktivierte Quelle. Dieselbe Quellen-ID muss deklariert, aktiviert und zur Laufzeit registriert sein.

Erste Prüfung

1. Speichern Sie Ihre Symbole und prüfen Sie deren Vorschauen im Backoffice.
2. Öffnen Sie den Shop in einem normalen Browser, fügen Sie ein Produkt hinzu und prüfen Sie das Badge.
3. Ändern Sie die Menge, entfernen Sie das Produkt und bestätigen Sie, dass das Badge verschwindet.
4. Wechseln Sie zwischen hellem und dunklem Systemmodus und prüfen Sie das Basissymbol.
5. Wechseln Sie bei positivem Zählerstand zu einem anderen Tab, prüfen Sie die Erinnerung und kehren Sie zurück, um die Wiederherstellung des Titels zu bestätigen.
6. Testen Sie gegebenenfalls Zählerpräfix, Administrationssymbol, generierte Links und Manifest separat.

Häufige Probleme

• Ein hochgeladenes Symbol scheint unverändert. Laden Sie ohne Cache neu und öffnen Sie den Tab erneut. Browser speichern Favicons unabhängig vom Seiteninhalt zwischen.
• Das Badge aktualisiert sich unter PrestaShop 1.6 nicht. Prüfen Sie, ob das Theme einen unterstützten Block-Cart-Zähler oder eine ajaxCart-Integration hat.
• Eine eigene Quelle wird ignoriert. Prüfen Sie ihren PHP-Deskriptor, Händlerschalter, ihre Quellen-ID und Laufzeitregistrierung.
• Der Symbolsatz fehlt. Prüfen Sie Rasterquelle, GD-Unterstützung und das beschreibbare Verzeichnis img/mprfavicon/. ICO/SVG bleiben als Quellsymbole nutzbar, können jedoch keinen generierten Satz erzeugen.
• Das Stammsymbol lässt sich nicht ändern. Lesen Sie die Eigentumsmeldung, wechseln Sie zum Eigentümer-Shop und prüfen Sie Dateisystemberechtigungen. Verwenden Sie die Freigabeaktion unter "All shops", wenn Sie die globale Eigentümerschaft freigeben möchten.
• Bei der Automatisierung passiert nichts. Die Laufzeitlogik überspringt WebDriver und erkannte Bot-User-Agents absichtlich. Prüfen Sie das Ergebnis manuell.
• Infrastruktur fehlt. Öffnen Sie "Favicon > Integrity".

Deaktivieren Sie das Überschreiben im Stammverzeichnis im Eigentümer-Shop und bestätigen Sie die Wiederherstellung vor dem Entfernen des Moduls, wenn Sie diese ausdrücklich prüfen möchten. Die Deinstallation versucht ebenfalls die Wiederherstellung im Stammverzeichnis und entfernt normale Favicon-Konfigurationen/-Dateien, wenn dieser Übergang gelingt.

Wenn die Wiederherstellung nicht abgeschlossen werden kann, behält die Deinstallation die für einen erneuten Versuch benötigte Konfiguration und Sicherungsdateien bei und protokolliert das Problem. Eine extern ersetzte Datei bleibt erhalten. Prüfen Sie nach der Deinstallation /favicon.ico und alle gemeldeten Wiederherstellungsfehler; gehen Sie nicht davon aus, dass jeder Dateisystemvorgang erfolgreich war.