Plugins werden in der Magento2-Umgebung als Module bezeichnet. Diese Seite zeigt Dir den gesamten Installationsprozess eines Moduls in Magento2.

Speziell für Benutzer eines Composers bietet diese Seite weitere Hilfe:

https://belvg.com/blog/how-to-install-module-manually-on-magento-2.html

Schritt 1: Installiere das Plugin/Modul im Shop

Schritt 1 wird nur benötigt, wenn Tracking verfügbar sein soll.

Wenn nur die Bestellabwicklung oder der Export benötigt wird, kannst Du direkt zu Schritt 2 springen.

Wenn Du das Modul per ZIP-Archiv auf Ihrem Webserver installierst, musst Du der besitzende Benutzer des Magento-Verzeichnisses sein (wahrscheinlich www-data).

Kopiere den Inhalt des angehängten Install-Ordners in den entsprechenden Ordner Deiner Magento-Installation. Dieser sollte standardmäßig lauten:
```
<magentoRoot>/app/code/
```
Falls dieser Ordner nicht existiert, lege ihn bitte an. Am Ende sollte er wie folgt aussehen:
```
<magentoRoot>/app/code/ChannelpilotSolutions/
             Tracking/
             API/
             Payment/
             Shipping/
```
Danach muss das Plugin noch in Ihrem System aktiviert werden.
1. Wenn Du einen Modul-Manager in Deinem Magento Backend hast, navigiere bitte zu der Seite und aktiviere alle Einträge, die "channelpilotsolutions" oder ähnlich heißen:
```
System -> Web Setup Wizard -> Component Manager
OR
System -> Tool -> Web Setup Wizard -> Module-Manager
```
2. Falls kein Modul- oder Komponenten-Manager installiert ist, musst Du die Magento-Kommandozeile verwenden, um das Modul zu aktivieren. Dieser Befehl prüft, installiert und aktiviert alle verfügbaren Module in Deinem Magento-Backend:
```
php bin/magento setup:upgrade
```

Schritt 2: Einrichten des Moduls in Magento2

Es gibt einige Schritte, die notwendig sind, um die Funktionen des Moduls zu aktivieren:

einen Shop erstellen: der StoreCode wird benötigt
eine Integration erstellen: API-Rechte müssen gesetzt werden und accessToken wird benötigt
Bestellstatus erstellen: für die korrekte Verarbeitung von Bestellungen
Magento URL: wird für die Registrierung benötigt (es wird die URL aus dem Magento Backend benötigt, nicht die URL des Shops)

Erstelle einen Shop, generiere einen StoreCode und aktiviere OAuth

Prüfe ob mindestens ein Shop in Deinem Backend angelegt und aktiv ist:
```
Stores -> Settings -> All Stores
```
Für die Aktivierung benötigst Du den "Code" aus "Store view". Wenn nur ein Shop vorhanden ist, sollte dieser "default" sein.
Nach diesem Schritt musst Du hier die Option "Allow OAuth Access Tokens to be used as standalone Bearer tokens" (seit Magento 2.4.5) aktivieren:
```
Stores -> Configuration -> Services -> OAuth
```
Unter "Configuration" findest Du die Option, die auf "Yes" gesetzt werden muss.
Nachdem die Konfigurationsoption aktiviert ist, muss der Cache-Typ "Configuration" erneuert werden:
```
System -> Tools -> Cache Management
```
Klicke auf "Configuration", wähle die Zeile aus. Stelle sicher, dass die Aktion auf "Refresh" gesetzt ist und klicke auf "Submit". Damit wird die Konfiguration von oben final aktiviert.

Tracking einrichten

Dieser Schritt für "Tracking einrichten" ist nur notwendig, wenn das Tracking verfügbar sein soll und das Modul unter Schritt 1: "Plugin/Modul im Shop installieren" installiert wurde.

Wenn Du das Tracking nicht nutzen willst, kannst Du diesen Schritt überspringen.

Um das Tracking zu nutzen, musst Du das installierte Modul konfigurieren. Dazu benötigst Du den Tracking-Schlüssel aus deinem Channel Pilot Pro Shop, der konfiguriert werden muss. Bitte wende dich dazu an Deinen Kundenbetreuer.

Stores -> Configuration -> Channel Pilot

Nimm die folgenden Einstellungen vor, um diese Informationen an das Sales Tracking Script zu übertragen:

Tracking Key: ein Schlüssel aus Deinem Channel Pilot Pro Shop (frage Deinen Kundenbetreuer)
Artikelnummer: Wähle ID oder SKU
Cookie-Mode: Wähle "Erster" oder "Letzter" Cookie-Modus
Marge: alle Datenfelder vom Typ Dezimal oder Text können hier ausgewählt werden (auch benutzerdefinierte Produktattribute)

Erstellen einer Integration, Festlegen der API-Rechte und Abrufen des Zugriffstokens

Erstelle eine neue Integration mit einem eindeutigen Namen wie "Channel Pilot Pro" und den notwendigen "API - Zugriffsrechten" unter:
```
System -> Extensions -> Integrations
```
In den Einstellungen jeder Integration hast Du die Möglichkeit, "API-Rechte" zu aktivieren.
Die notwendigen Einstellungen sind unten aufgelistet., Wir empfehlen vollen Zugriff (alle Rechte) zu gewähren, um sicherzustellen, dass kein anderer Prozess etwas blockiert.
Wenn Du Vollzugriff gewähren willst, gibt es in Magento2 ein bekanntes Problem, wenn Du die Option auf "ALL" setzt. Verwende "Benutzerdefiniert" und aktiviere die höchste Stufe von "Alle Rechte". Dies schließt alle folgenden Rechte ein.
Wenn alle notwendigen Rechte erteilt sind, musst Du die Integration speichern. Danach stehen Dir unter "Integration Details" 4 Schlüssel zur Verfügung.
Für den nächsten Schritt benötigen Sie das "Access Token".

Auftragsstatus anlegen und korrekt zuweisen

Als nächstes musst Du einen neuen Bestellstatus anlegen und die richtigen Einstellungen zuweisen.

Stores -> Settings -> Order Status

Der anzulegende Status benötigt die folgenden Einstellungen:

Statuscode: imported
Status Label: Successfully imported from Channel Pilot Pro (kann aber frei definiert werden)
Order Status: Successfully imported from Channel Pilot Pro
Order State: Pending
Use order status as default: false (nicht aktiviert)
Visible on Storefront: false (nicht aktiviert)

Registriere Deine Installation

Wenn alle oben genannten Schritte durchgeführt wurden, musst Du Deine Installation registrieren. Dadurch erhältst Du die Informationen, die Dein Kundenbetreuer benötigt, um Deine Magento2-Anbindung auf der Channel Pilot Pro Seite zu aktivieren.

Öffne folgende Seite: https://magento.channelpilot.com/install
Gib die Informationen ein:
1. shopUrl: die Url zu Deiner Magento2-Installation (nicht die Shop-URL)
2. shopCode: der Shopcode, den Du bei der Einrichtung des Shops erhalten hast
3. accessToken: denAccess-Token, den Du bei der Einrichtung der Integration erhalten hast
Klicke auf "Senden". Anschließend erhältst Du zwei Links:
1. exportUrl: Über diese URL erhältst Du einen Produktexport aus Deinem Magento 2 Shop (der Shop dessen shopCode verwendet wurde)
2. registrationUrl: Dein Account Manager benötigt diese URL, um Dein Magento 2 Setup bei Channel Pilot Pro zu registrieren

Exportieren:

Der Export wird nur für maximal ~ 1000 SKU empfohlen. Da die Verbindung über die Magento-API läuft, unterstützt die API keine großen Datenmengen an Produktdaten über diesen Verbindungspunkt.

Verwandte Artikel