Brand Mapping (JTL-Shop 5)

Owned by Pieter van der Vegt, created
Last updated: Jun 24, 2024 by Sebastian Meyer
3 min read

Einleitung

Das s360_brandmapping_shop5 Plugin für JTL-Shop 5 bietet eine effiziente Lösung für die Zuordnung von Herstellern zu Kategorien. Es ermöglicht die einfache Verwaltung dieser Zuordnungen, um die Organisation und Darstellung von Produkten im Online-Shop zu optimieren.

Features

Hersteller-Kategorie Mapping: Das Plugin ermöglicht die Zuordnung von Herstellern zu Kategorien direkt im Admin-Bereich des JTL-Shop 5, was zu einer strukturierten Produktpräsentation führt.

Einstellbare Meta Robots Tags: Shop-Administratoren können Meta Robots Tags für die Herstellerseiten festlegen, um Suchmaschinenanweisungen zu steuern und somit SEO-freundliche Seiten zu gewährleisten.

Erinnerungs-Feature: Es gibt die Möglichkeit, E-Mail-Erinnerungen für bestimmte Aktionen einzustellen, wodurch Shop-Verantwortliche regelmäßige Updates zu den Mappings erhalten können.

Hersteller-Ausschluss: Bestimmte Hersteller können von den Mappings ausgeschlossen werden, was dem Admin ermöglicht, gezielt Hersteller für die Zuweisung zu Kategorien zu ignorieren.

Installation / Update

Systemvoraussetzungen

  • JTL-Shop 5.1.5+ und dessen Voraussetzungen

Plugin-Installation

Die Installation des Plugins erfolgt nach JTL-Standard, wie es hier beschrieben ist oder sie können Ihre vorhandene ZIP-Datei des Plugins auch über den Reiter “Upload“ in der Pluginverwaltung bereitstellen und anschließend im Reiter “Vorhanden“ die Installation starten.

Plugin-Update

Bei einem Update auf eine neuere Version können Sie der allgemeinen Installation folgen mit dem Unterschied, dass Sie direkt in der Pluginverwaltung den Update-Button zur Aktualisierung betätigen müssen.

Konfiguration

Einstellungen

Das Plugin verfügt über folgende Einstellungen

Einstellung

Optionen

 

Einstellung

Optionen

 

Meta Robots Angabe fuer JTL Herstellerseiten

noindex,follow

Welche Metangaben sollen Suchmaschinen-Robots auf den klassichen Herstellerseiten erhalten?

Hersteller-Oberkategorie

Select list Kategorien

Welche Ober-Kategorie enthält die Hersteller-Kategorien? Wird für die Mapping-Pflege genutzt, um die Auswahl einzuschränken.

Erinnerungsmail: Intervall

 

In welchem Intervall soll per E-Mail auf nicht zugeordnete Hersteller hingewiesen werden? (in Sekunden)

Erinnerungsmail: E-Mail-Adresse

 

An welche Adresse sollen die Erinnerungsmails für nicht zugeordnete Hersteller gesendet werden? Leer lassen, um keine Mails zu senden.

Betrieb

Mappings editieren

Sie verwalten Mapping über den Reiter Mappings editieren. Links sehen Sie die Hersteller und rechts Dropdowns zum selektieren der Kategorie.

mappings_verwalten.png

Hersteller-Ausschluss

Auf dem Reiter Hersteller-Ausschluss können Sie die Hersteller im Mapping selektieren die ignoriert werden sollen.

hersteller_ausschuss.png

Troubleshooting

Logs prüfen

Um herauszufinden, wo ein Problem liegt, helfen Ihnen und uns die Logs. Je nach Fehlerbild ist eines der folgenden 3 Logs dafür mehr oder weniger relevant.

Browser-Log

Das Browser-Log ist meist relevant, wenn irgendwas im Frontend des Shops sich merkwürdig verhält oder nicht reagiert. (Beispiel: Sie klicken einen Button und augenscheinlich passiert gar nichts.)

Das Browser-Log sehen Sie, wenn Sie im Browser F12 drücken und dort dann auf Konsole (oder Console) wechseln.

Shop-Log

Das Shop-Log ist immer dann interessant, wenn im Frontend unerwartete Fehlermeldungen ausgegeben werden oder das Plugin zwar auf Eingaben im Frontend reagiert, aber nicht das Ergebnis liefert, was erwartet wurde. Manchmal ergibt sich auch durch das Browser-Log, dass die Informationen eher im Shop-Log zu suchen sind.

Das Shop-Log finden Sie im JTL-Adminbereich unter System → Wartung → Log.

Das JTL-Log arbeitet mit Log-Levels, um nicht die Datenbank unbegrenzt mit Logdaten zu befüllen. Im Umkehrschluss heißt das, dass Sie Logmeldungen aber auch erst dann sehen, wenn diese nach der Änderung des Loglevels erzeugt worden sind.
Das Plugin loggt außer kritischer Fehler fast ausschließlich im Debug-Log-Level. Wenn also etwas nicht klappt, sollten Sie zunächst das Debug-Loglevel aktivieren, dann eine Testbestellung durchführen, dann das Debug-Loglevel wieder deaktivieren und die zwischenzeitlich geloggten Meldungen zurate ziehen.

Webserver-Log

Das Webserver-Log wird dann relevant, wenn Sie irgendwo auf einen Error 500 (= weiße Seite) stoßen.

Das Webserver-Log kann Ihnen Ihr Hoster zur Verfügung stellen.

In der Standardkonfiguration loggt der JTL-Shop überhaupt nichts in das Webserverlog, nicht mal kritische Fehler wie einen Error 500.

Damit der Shop diese Fehler loggt, müssen in der /includes/config.JTL-Shop.ini.php die einzelnen *_LOG_LEVEL Werte von 0 auf E_ERROR geändert werden.

Achtung: Editieren Sie die Config-Datei des Shops nur, wenn Sie wissen, was Sie tun! Fehlerhafte Anpassungen hier können Ihren Shop unerreichbar oder (verschlüsselte) Daten unbrauchbar machen. Im Zweifelsfall sollten Sie Ihren Hoster oder Servicepartner um Hilfe fragen.

Changelog

v1.0.1 (Juni 2024)

  • Bugfix: Verschlüsselung des Options-File führt zu PHP-Fehler

v1.0.0 (Juni 2024)

  • Initiales Release

Support und Kontakt

siehe Support und Kontakt