Zum Inhalt springen

Plugin-Dokumentation · JTL-Shop 5

Canonical- und Hreflang-Manager — Installation

Setup-Guide für die Installation des Plugins in JTL-Shop 5. Dauer: ca. 5 Minuten.

Voraussetzungen

  • JTL-Shop: Version 5.2.0 oder neuer (getestet bis 5.7.x), NOVA-Template
  • PHP: 8.1 oder neuer, phpQuery (Shop-Standard)
  • Datenbank: keine eigenen Tabellen — das Plugin liest nur die Plugin-Einstellungen und schreibt in das HTML der ausgelieferten Seite
  • Sonstiges: keine externen Dienste, keine API-Keys, keine Cron-Jobs erforderlich. Bei mehreren Shop-Instanzen (Mehrsprachigkeit/Mehrdomain): identische Hreflang-Konfiguration in jeder Instanz erforderlich (siehe Konfigurationsanleitung)

Installation über den JTL-Extension Store

  1. Erwerben Sie die Erweiterung im JTL-Extension Store. Sie wird dadurch mit Ihrer Shop-Lizenz verknüpft.
  2. Öffnen Sie im JTL-Shop-Backend Plugins → Meine Erweiterungen. Die Erweiterung erscheint dort nach kurzer Zeit automatisch.
  3. Klicken Sie auf Installieren.
  4. Aktivieren Sie das Plugin anschließend im Plugin-Manager unter Installiert, falls es nicht bereits aktiv ist.

Alternative: manuelle Installation (ZIP)

  1. Öffnen Sie im JTL-Shop-Backend Plugins → Plugin-Manager und wählen Sie den Tab Upload.
  2. Laden Sie das Plugin-Paket (ZIP) hoch. Der Ordnername im Archiv (webpowers_canonical_manager) darf nicht verändert werden.
  3. Wechseln Sie zum Tab Vorhanden, wählen Sie Canonical- und Hreflang-Manager aus und klicken Sie auf Installieren.
  4. Aktivieren Sie das Plugin unter Installiert.

Nach der Installation

Öffnen Sie Installierte Plugins → Canonical- und Hreflang-Manager → Einstellungen und prüfen Sie, dass „Plugin aktivieren" auf Aktiviert steht. Prüfen Sie anschließend live an einer Kategorie-, Filter- und Suchseite (z. B. per Browser-Ansicht des Quelltexts oder curl), dass jeweils genau ein Canonical-Tag im <head> steht. Alle Einstellungen sowie die Hreflang-Konfiguration sind in der Konfigurationsanleitung unter webpowers.org/docs/jtl-canonical-manager/konfiguration beschrieben.

Deinstallation

Das Plugin kann jederzeit über den Plugin-Manager deinstalliert werden. Es legt keine eigenen Datenbanktabellen an — beim Entfernen bleiben keine plugin-eigenen Daten zurück. Nach der Deinstallation greift wieder ausschließlich die Standard-Canonical-Logik des NOVA-Templates.

Support

webpowers UG (haftungsbeschränkt) · Hillenbrandstr. 9, 86156 Augsburg · E-Mail: max@webpowers.org