Fatchip GmbH Wiki

Diese Seite ist nicht editierbar. Sie können den Quelltext sehen, jedoch nicht verändern. Kontaktieren Sie den Administrator, wenn Sie glauben, dass hier ein Fehler vorliegt.
====== OXID Plugin - Redirect ======

Das Plugin bei FATCHIP: https://www.fatchip.de/Plugins/OXID-eShop/OXID-Plugin-Redirect.html \\
Das Plugin auf Github:  https://github.com/FATCHIP-GmbH/plugin-oxid6-redirect (private)

===== Voraussetzungen =====

  * OXID CE/PE/EE ab Version 6.0.x
  * (s)FTP-Zugang zur Shopinstallation
  * **Ab der OXID-Version 6.2** wird ein SSH-Zugang zur Shopinstallation benötigt.

----

===== Installation =====
==== Composer ====
Öffnen Sie die Datei **composer.json** im Stammverzeichnis Ihres Shops und fügen Sie das Repository hinzu oder vervollständigen Sie die vorhandene Konfiguration: \\
<code yaml>
"repositories": [{
  "type": "composer",
  "url": "https://packages.fatchip.de/packages"
}]
</code>

Nach erfolgter Ergänzung der Datei //composer.json// können Sie da Plugin installieren.\\ Melden Sie sich dazu per SSH an dem Server an, auf dem sich die Shop-Installation befindet, und navigieren Sie zu dem Verzeichnis, in dem sich der Source- und Vendorornder befinden.\\ 
Führen Sie folgenden Befehl aus, um das Plugin zu installieren
    composer require fatchip-gmbh/plugin-oxid6-redirect
Beachten Sie, dass der genaue Aufruf des Composers für Ihre konkrete OXID-Installation abweichen kann. \\

Sie werden nun nach einem Benutzer und einem Passwort gefragt. Geben Sie die Zugangsdaten ein, welche Ihnen per E-Mail übersandt wurden.\\
\\
Nach korrekter Eingabe der Zugangsdaten wird das Plugin installiert.


==== Manuell ====
=== Inhalt aus dem Ordner „fc“ kopieren ===
In dem Pluginpaket fcRedirect_oxid_source befindet sich der Ordner //fc//, kopieren Sie den Inhalt aus diesem Ordner in das Modulverzeichnis Ihres OXID eShops (bei FTP - binären Übertragungsmodus nutzen).

{{:public:redirect_1.1.png?nolink&800|}}

=== composer.json aktualisieren ===
Öffnen Sie die Datei **composer.json** im Stammverzeichnis Ihres Shops und fügen Sie diese Autoload-Konfiguration hinzu oder vervollständigen Sie die vorhandene Konfiguration: \\ <code javascript>
  "autoload": {
    "psr-4": {
      "FC\\Redirect\\": "./source/modules/fc/fcRedirect"
    }
  },
</code> Nach erfolgter Ergänzung der Datei //composer.json// müssen die Änderungen dem OXID-System mitgeteilt werden.\\ Melden Sie sich dazu per SSH an dem Server an, auf dem sich die Shop-Installation befindet, und navigieren Sie zu dem Verzeichnis, in dem sich der Source- und Vendorornder befinden.\\ 
Führen Sie folgenden Befehl aus, um die Autoloader-Dateien neu zu generieren
    vendor/bin/composer dump-autoload
Beachten Sie, dass der genaue Aufruf des Composers für Ihre konkrete OXID-Installation abweichen kann. \\ \\ Nach erfolgreicher Aktion wird folgende Meldung angezeigt:\\ //Generating autoload files//\\ //Generated autoload files//


**In OXID-Versionen ab 6.2 (ältere Versionen können den Schritt überspringen)** muss die Modulkonfiguration eingelesen werden.\\
Melden Sie sich dazu per SSH an dem Server an, auf dem sich die Shop-Installation befindet, und navigieren Sie zu dem Verzeichnis, in dem sich der Source- und Vendorornder befinden. Führen Sie die folgenden Befehle aus:\\
<code>vendor/bin/oe-console oe:module:install-configuration source/modules/fc/fcRedirect
vendor/bin/oe-console oe:module:apply-configuration </code>
Bei erfolgreichem Einlesen/Import erscheint die Nachricht\\
**Module configuration has been installed**


=== Redirect Plugin aktivieren === 
Aktivieren Sie das Redirect Plugin im OXID Administrationsbereich unter //Erweiterungen -> Module -> FATCHIP Module OXID Redirect//. Bei der OXID Enterprise Edition müssen Sie das Redirect Plugin in jedem Subshop einzeln aktivieren!

{{:public:redirect_1.2.png?nolink&800|}}

----


===== Konfiguration =====
=== Allgemeine Parameter ===
Die Redirect Plugineinstellungen können Sie unter //Erweiterungen -> Module -> FATCHIP Module OXID Redirect -> Einstellungen -> Allgemein// aufrufen.

{{:public:redirect_2.1.png?nolink&800|}}

^ Konfiguration ^ Beschreibung ^
|Supportkey|Den Supportkey finden Sie in der E-Mail mit Ihrem Plugin. Ohne Nennung dieses Keys kann Ihnen die FATCHIP GmbH keinen Support leisten.|
|Bei Weiterleitungen die gesamte Shop-URL verwenden statt nur den URI|Durch das Aktivieren dieser Funktion wird im Header der Weiterleitung die komplette URL ausgegeben, anstatt der URI.|
|Weiterleitungen mit Regulären Ausdrücken erlauben|Wenn Sie diese Option aktivieren, können Sie reguläre Ausdrücke weiterleiten.|
|Bei regulären Ausdrücken auf Groß- und Kleinschreibung achten.|Mit dieser Option wird bei regulären Ausdrücken auch auf Groß- und Kleinschreibung geachtet.|
|Begrenzungszeichen für reguläre Ausdrücke|Das Zeichen für das Maskieren der regulären Ausdrücke (escapen)|
|Pfad in welchem Exporte der Weiterleitungen abgespeichert werden sollen (ab Shop-Hauptverzeichnis)|Hier können Sie den Datei-Pfad angeben, in welchem Exporte der Weiterleitungen abgespeichert werden sollen.|

=== Neue Weiterleitungen anlegen===
Die Weiterleitungen können unter //Stammdaten -> Weiterleitungen// angelegt und bearbeitet werden. Neben dem manuellen Anlegen von Weiterleitungen, können Sie die Weiterleitungen auch über eine CSV-Datei importieren.

{{:public:redirect_2.2.png?nolink&800|}}

^ Konfiguration ^ Beschreibung ^
|Aktiv|Schaltet die Weiterleitung aktiv oder inaktiv.|
|Als regulären Ausdruck behandeln|Wenn Sie reguläre Ausdrücke weiterleiten wollen, müssen Sie diese Option in den Plugineinstellungen aktivieren. Bitte verwenden Sie nur reguläre Ausdrücke im PCRE Format (http://www.php.net/manual/de/reference.pcre.pattern.syntax.php).|
|Weiterleiten von|Die Seite, von der weitergeleitet werden soll. Hier darf nicht die komplette URL eingegeben werden, sondern nur die URI.|
|Weiterleiten auf|Die Seite, auf die weitergeleitet werden soll. Hier darf nicht die komplette URL eingegeben werden, sondern nur die URI.|
|Alternativer Weiterleitungscode (z. B. 307)|Bitte verwenden Sie nur valide Statuscodes vom W3C im HTTP-Protokoll Version 1.1 (http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html). \\ Möchten Sie eine Weiterleitung erreichen, so müssen Sie auch hierzu passende Statuscodes verwenden (z. B. 307 oder 303). Andere Codes wie z. B. 410 Gone führen zu einer weißen Seite, was unter Umständen jedoch gewollt sein könnte. Die alternative Weiterleitungsnachricht wird in vielen Fällen auch automatisch erkannt und muss nicht zwangsläufig gesetzt werden.|
|Alternative Weiterleitungsnachricht (z. B. Temporary Redirect)|Hier können Sie eine alternative Weiterleitungsnachricht festlegen.|
|CSV-Liste hochladen|Hier können Sie eine CSV-Datei hochladen mit deren Hilfe sich mehrere Weiterleitungen auf einmal eintragen lassen. Erstellen Sie hierzu eine Textdatei die pro Zeile eine Weiterleitung in folgender Form enthält: ///Weiterleiten/von/,/Weiterleiten/nach/,weitere Spalten//. \\  Das Spaltentrennzeichen ist in der Standardkonfiguration das Komma. Alternativ kann jedoch auch das Semikolon oder das Pipe-Symbol als Trennzeichen gewählt werden. \\ Die Spalten „weiterleiten von“ und „weiterleiten nach“ müssen mindestens angegeben werden. \\ Zusätzlich können Sie bis zu drei weitere Spalten angeben. Die dritte Spalte ist dabei der alternative Weiterleitungscode. Die vierte Spalte der alternative Weiterleitungstext und die fünfte Spalte ist eine Markierung (1) für reguläre Ausdrücke.|
|Spaltentrennzeichen der CSV|Hier können Sie das Spaltenkennzeichen für den CSV-Import festlegen.|
|Alle Weiterleitungen dieses Shops löschen|Über diesen Button werden alle angelegten Weiterleitungen gelöscht.|
|Alle Weiterleitungen dieses Shops exportieren|Über diesen Button werden alle angelegten Weiterleitungen exportiert.|

----

===== FAQs =====

  - [[#Welche OXID eShop Versionen sind mit dem Redirect Plugin von FATCHIP kompatibel?]]
  - [[#Wenn ein bestimmtes Keyword auftritt, möchte ich eine Weiterleitung per Regulären Ausdruck machen.]]
  - [[#Funktioniert mit dem Redirect Plugin auch die Weiterleitung mit Parametern wie "?" und "&". Beispielsweise "/bsp-Shop/shop_content.php/?coID=28"?]]
  - [[#Warum wird das Plugin nach der Installation in OXID 6.2 nicht in der Pluginliste angezeigt?]]

=== 1. Welche OXID eShop Versionen sind mit dem Redirect Plugin von FATCHIP kompatibel? ===
Die aktuellsten Informationen hierzu erhalten Sie in der [[https://www.fatchip.de/Plugins/OXID-eShop/OXID-Plugin-Redirect.html#matrix|Kompatibilitätsmatrix]] in unserem Shop.

=== 2. Wenn ein bestimmtes Keyword auftritt, möchte ich eine Weiterleitung per Regulären Ausdruck machen. ===
Die gewünschte Weiterleitung ist per regulärem Ausdruck machbar. In dem Beispiel könnte die Lösung folgendermaßen aussehen:

weiterleiten von:
<code>^\/.Keyword.</code>
 
weiterleiten nach:
<code>/Zielseite</code>

Der Punkt ist im PCRE-Format ein Platzhalter für keins oder beliebig viele Zeichen.\\ 
Wenn Sie reguläre Ausdrücke verwenden wollen, muss dieses Feature im Plugin zunächst aktivieren werden.\\ 
Im Anschluss kann bei jeder Weiterleitung das Häkchen "Als regulären Ausdruck behandeln" gesetzt werden, dann wird diese entsprechend ausgewertet.\\ 
Bitte verwenden Sie nur reguläre Ausdrücke im [[http://www.php.net/manual/de/reference.pcre.pattern.syntax.php|PCRE Format]].\\ 
Bitte testen Sie zudem die reguläre Ausdrücke ausführlich, da unerwünschte Nebeneffekten (Weiterleitungen) auftreten könnten.

=== 3. Funktioniert mit dem Redirect Plugin auch die Weiterleitung mit Parametern wie "?" und "&". Beispielsweise "/bsp-Shop/shop_content.php/?coID=28"? ===
Die Weiterleitung mit Parametern wie "?" und "&" funktioniert mit unserem Redirect Plugin. Auf Grund von Oxid eigenem Verhalten muss die URI / URL etwas anders angegeben werden. In dem Beispiel "/bsp-shop/shop_content.php/?coID=28" müsste die "weiterleiten von Seite" lediglich ohne Schrägstrich folgendermaßen eingetragen werden:
<code>/bsp-shop/shop_content.php?coID=28</code>

Die "weiterleiten nach Seite" muss nicht verändert werden. Dieser Weiterleitung könnte alternativ auch mit einem regulärem Ausdruck gelöst werden.

**Beispiel Weiterleitung mit einem regulärem Ausdruck:**

Weiterleiten von
<code>\/bsp-shop\/shop_content\.php.*</code>

Das Begrenzungszeichen für reguläre Ausdrücke im Standard ist auf "/" gesetzt, daher müssen alle Slashes in der "weiterleiten von" URL escaped werden. Der reguläre Ausdruck "**.***" schließt alle folgenden Zeichen in der URL ein, sprich wird diese URL mit einem beliebigen Parameter aufgerufen, findet ebenfalls eine Weiterleitung statt.

=== 4. Warum wird das Plugin nach der Installation in OXID 6.2 nicht in der Pluginliste angezeigt? ===

Ab OXID 6.2 wird die Pluginkonfiguration //(metadata.php)// nicht mehr automatisch eingelesen. 
Dafür müssen Sie den folgenden Befehl über die SSH Kommandozeile in dem Shopverzeichnis (wo der //"vendor"// Ordner liegt) ausführen:
<code>./vendor/bin/oe-console oe:module:install-configuration source/modules/fc/fcRedirect/</code>

Nach der Ausgabe von //"Module configuration has been installed."// wird das Plugin unter //Erweiterungen -> Module// aufgelistet und kann aktiviert werden.

----

===== Support =====

Sollten Sie Hilfe von FATCHIP benötigen, schicken Sie bitte eine detaillierte Fehlerbeschreibung inkl. Plugin- und Shopversion an //support@fatchip.de//.

----

===== Weitere Informationen =====
Sollte das OXID Plugin Redirect nach der Installation nicht wie erwartet funktionieren, prüfen Sie ob alle Installationsschritte richtig durchgeführt worden sind.\\ 
Weitere Informationen finden Sie in unserem Online Shop unter: https://www.fatchip.de/Plugins/OXID-eShop/OXID-Plugin-Redirect.html

Außerdem bietet FATCHIP einen Plugin-Installationsservice an. Weitere Informationen hierzu finden Sie unter:\\ 
https://www.fatchip.de/Servicepakete/Plugin-Installationsservice-OXID-eShop-PE.html\\ 
https://www.fatchip.de/Servicepakete/Plugin-Installationsservice-OXID-eShop-EE.html
Fatchip GmbH Wiki

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Seiten-Werkzeuge
