SEO-URLs (JTL-Shop 5)
- 1 Einleitung
- 1.1 Features
- 2 Installation / Update
- 3 Konfiguration
- 3.1 Einstellungen
- 4 Betrieb
- 4.1 SEO-URLs Übersicht
- 4.2 SEO-URL Anlegen
- 4.3 Import/Export
- 5 Troubleshooting
- 5.1 Logs prüfen
- 5.1.1 Browser-Log
- 5.1.2 Shop-Log
- 5.1.3 Webserver-Log
- 5.1 Logs prüfen
- 6 Changelog
- 7 Support und Kontakt
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
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) | 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) | 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 | 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
Einstellung | Optionen | Standardwerte |
|
---|---|---|---|
Dateityp | TSV |
| 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
v1.0.1 (Oktober 2024)
Bugfix: Fehlende Übersetzung
Support und Kontakt
siehe Support und Kontakt