SEO-URLs (JTL-Shop 5)

Einleitung

Dieses Plugin gibt Ihnen neue Möglichkeiten zur SEO (Search Engine Optimierung) in Ihrem JTL-Shop.

Features

Das Plugin bietet Ihnen folgende Möglichkeiten und Funktionen:

  • Ersetzen von technischen URLs (z.B. von beliebigen Filterkombinationen) mit sprechenden, schönen Custom SEO-URLs

  • Eigene Metadaten speziell für Custom SEO-URLs

    • Titel

    • Beschreibung

  • Eigener Inhalt für Custom SEO-URLs

    • bis zu zwei ansteuerbare Bereiche mit HTML Editor

  • Eigener Sitemap-Export für Custom SEO-URLs

  • Import/Export-Funktionen für Custom SEO-URL-Einstellungen für einfachere externe Bearbeitung

  • Individuelle Steuerung von Robots-Tag und Canonical URL für Produkte über JTL Wawi-Attribute (inkl. optionalem Export der individuellen Canonical URL in Standard-Sitemap)

  • Individuelle Steuerung vom Robots-Tag für Kategorien über JTL-Wawi-Attribute

  • Optionaler automatischer Ausschluss von Produkten und Kategorien aus der Standard-Sitemap, wenn deren Robots-Tag auf “noindex” steht

Installation / Update

Systemvoraussetzungen

  • JTL-Shop 5 (und die beinhalteten Bibliotheken und dessen Systemvoraussetzungen)

Weitere Voraussetzungen

Plugin-Installation

Die Installation des Plugins erfolgt im Standardverfahren für JTL-Shop 5, wie es hier beschrieben ist.

Plugin-Update

Für ein Update laden Sie das Plugin wie bei einer Installation in der neuesten Version hoch (und überschreiben ggf. alle vorhandenen Plugin Dateien) oder folgen Sie den Hinweisen des Extension Stores.

Gehen Sie dann in die Plugin Verwaltung und betätigen Sie den Update-Button.

Konfiguration

Einstellungen

Das Plugin verfügt über folgende Seo-Einstellungen

image-20240521-073532.png

Einstellung

Optionen

 

Einstellung

Optionen

 

Zu entfernende Selektoren

<css selektor>

Welche Selektoren sollen auf Custom-URLs komplett entfernt werden? (Zur Vermeidung von Near Duplicate Content.)

Content-Selektor oben

<css selektor>

CSS-Selektor für den oberen Custom-Content.

Content-Einfügemethode oben

Vorstellen (before)
Anstellen (after)
Vorhängen (prepend)
Anhängen (append)
Ersetzen (replaceWith)
Inhalt ersetzen (html)

Einfügemethode für den oberen Custom-Content

Content-Wrapper CSS-Klassen oben

 

Zusätzliche CSS-Klassen für den SEO-Content-Wrapper oben

Content-Selektor unten

<css selektor>

CSS-Selektor für den unteren Custom-Content.

Content-Einfügemethode unten

Vorstellen (before)
Anstellen (after)
Vorhängen (prepend)
Anhängen (append)
Ersetzen (replaceWith)
Inhalt ersetzen (html)

Einfügemethode für den unteren Custom-Content

Content-Wrapper CSS-Klassen unten

 

Zusätzliche CSS-Klassen für den SEO-Content-Wrapper unten

Content-Trenner

 

Mit welchem Trenner ist der obere Inhalt vom unteren Inhalt im Custom-URL-Inhalt getrennt?

Artikel-Attribut für Artikel-Canonical-URLs

 

Wie heißt das Attribut für Canonical URLs für Artikel in der Wawi?

Sitemap-Custom-URL über Artikel-Attribut

ja/nein

Sollen Artikel in der Standard-Sitemap vom Shop die über das Artikel-Attribut gesetzte Canonical URL bekommen?

Artikel-Attribut für Artikel-Robots-Tag

 

Wie heißt das Attribut für Robots-Tags für Artikel in der Wawi?

Sitemap-Ausschluss über Artikel-Attribut

ja/nein

Sollen Artikel aus der Standard-Sitemap vom Shop ausgeschlossen werden, wenn deren Artikel-Attribut für den Robots-Tag noindex beinhaltet?

Kategorie-Attribut für Kategorie-Robots-Tag

 

Wie heißt das Attribut für Robots-Tags für Kategorien in der Wawi?

Sitemap-Ausschluss über Kategorie-Attribut

ja/nein

Sollen Kategorien aus der Standard-Sitemap vom Shop ausgeschlossen werden, wenn deren Kategorie-Attribut für den Robots-Tag noindex beinhaltet?

Meta-Keywords entfernen

Ja, leeren
Ja, ganz entfernen
Nein

Soll auf Custom-Content-Seiten der Meta-Keywords-Tag geleert/entfernt werden?

Slashes am Ende von URLs erlauben

ja/nein

Sollen Slashes ('/') am Ende von URLs erlaubt sein? Im Normalfall ist dies nicht erlaubt und Slashes am Ende der URL werden bei der Normalisierung von URLs entfernt.

 

 

 

Das Plugin verfügt über folgende Import/Export-Einstellungen

image-20240521-073643.png

Einstellung

Optionen

Standardwerte

 

Einstellung

Optionen

Standardwerte

 

Dateityp

TSV
CSV

 

Sollen Tab-separierte (TSV) oder Komma-separierte (CSV) Dateien genutzt werden? Empfohlen sind TSV-Dateien, da das Tab-Zeichen im Gegensatz zum Komma in HTML-Content nicht vorkommt.

 

Spalte: ID

 

ID

Wie heißt die Spalte mit der ID?

Spalte: Interner Name

 

Name

Wie heißt die Spalte mit dem internen Namen?

Spalte: Original-URL

 

OriginalUrl

Wie heißt die Spalte mit der Original-URL?

Spalte: Custom-URL

 

CustomUrl

Wie heißt die Spalte mit der Custom-URL?

Spalte: Meta-Title

 

MetaTitle

Wie heißt die Spalte mit dem Meta-Title?

Spalte: Meta-Description

 

MetaDescription

Wie heißt die Spalte mit der Meta-Description?

Spalte: HTML-Content oben

 

ContentUpper

Wie heißt die Spalte mit dem oberen HTML-Content?

Spalte: HTML-Content

 

Content

Wie heißt die Spalte mit dem HTML-Content?

Spalte: HTML-Content unten

 

ContentLower

Wie heißt die Spalte mit dem unteren HTML-Content?

Spalte: Aktiv

 

Active

Wie heißt die Spalte mit der aktiv-Flag (0 oder 1)?

Sitemap-Dateiname

 

 

Wie soll die exportierte Sitemap heißen (ohne Dateiendung!)? Leer lassen für dynamische Generierung mit Zeitstempel. Der Standard-Ablageort ist plugins/s360_seo_urls_shop5/files/sitemap/.

Betrieb

SEO-URLs Übersicht

Die Benutzeroberfläche enthält folgende Elemente:

  • Suchfeld: Zum Filtern der angezeigten SEO-URLs.

  • SEO-URLs Tabelle: Zeigt die vorhandenen SEO-URLs.

  • Seitennavigation: Um zwischen den Seiten der Tabelle zu wechseln.

  • Aktionsicons: Ermöglichen das Bearbeiten, Kopieren und Löschen von SEO-URLs.

  • Aktiv-Schalter: Ein Toggle-Button, um den Status der SEO-URL zu aktivieren oder zu deaktivieren.

  • Grüner Plus-Button: Zum Hinzufügen einer neuen SEO-URL


SEO-URL Anlegen

Zum Anlegen der neuen SEO-URL dient der grüne Plus-Button rechts oben.

Die Benutzeroberfläche für den Abschnitt "Neue SEO-URL anlegen" besteht aus mehreren Feldern, die vom Benutzer ausgefüllt werden können:

  • Interne ID: Ein Textfeld, in das eine eindeutige Kennung eingetragen wird, z.B. "JTL-12345".

  • Interner Name: Ein Feld für einen internen Namen oder eine Bezeichnung der SEO-URL, wie "Produktgruppe X mit Merkmal Y".

  • Original-URL: Hier soll die ursprüngliche URL eingegeben werden, die umgeschrieben werden soll, beispielsweise "/KategorieX_Y".

  • Custom-URL: Das Feld, in das die benutzerdefinierte SEO-optimierte URL eingegeben wird, wie "/Produkte-mit-Y".

  • Meta-Titel: Ein Eingabefeld für den Meta-Titel, der in den Suchergebnissen angezeigt werden soll.

  • Meta-Description: Ein Feld für die Meta-Beschreibung, welche eine kurze Beschreibung der Seite für Suchergebnisse enthält.

  • HTML-Content Oben: HTML Inhalte oben.

  • HTML-Content Unten: HTML Inhalte unten

Vergessen sie nach dem anlegen nicht die Url aktiv zu schalten.

Import/Export

Im Bereich "Import/Export" des S360 SEO URLs Plugins finden Sie folgende Funktionen:

  • Neue Import-Datei hochladen: Durch Klicken auf "Datei auswählen" können Sie eine neue *.csv oder *.tsv Datei für den Import auswählen. Mit dem grünen Button "Hochladen" starten Sie den Upload-Prozess.

  • Import-Dateien: Hier wird Ihnen eine Liste bereits hochgeladener Import-Dateien angezeigt. Für jede Datei werden der Name, die Dateigröße und das Datum der letzten Änderung dargestellt. In der Spalte "Aktionen" haben Sie folgende Möglichkeiten:

    • Ein grüner Button mit einem Pfeil nach oben zum Importieren der ausgewählten Datei in das System.

    • Ein blauer Button mit einem Download-Symbol, um die Datei auf Ihren Rechner herunterzuladen.

    • Ein roter Button mit einem Mülleimer-Symbol, um die Datei aus der Liste zu entfernen.

  • Export-Dateien: In dieser Sektion sind die für den Export erstellten Dateien aufgelistet. Neben den Informationen zu Dateiname, Größe und Änderungsdatum finden Sie auch hier die gleichen Aktionen-Buttons für den Import, Download und das Löschen der Dateien.

  • Sitemap Export: Sollten Sitemap-Exportdateien vorhanden sein, werden diese hier mit denselben Details und Aktionen wie die Import- und Export-Dateien angezeigt.

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.0 (Mai 2024)

  • Initiales Release

Support und Kontakt

siehe Support und Kontakt