Skip to main content
In this chapter
< Contents
Print

OXID Connector vorbereiten

Bevor Sie OXID eShop mit mailfino verbinden, installieren Sie den mailfino OXID Connector im Shop. Der Connector ist read-only: Er liest Kunden, Bestellungen und Produkte, schreibt aber keine Daten in OXID.

Öffnen Sie in mailfino Connections, wechseln Sie im Assistenten auf Shop-Systeme und wählen Sie OXID eShop aus. Im anschließenden Schritt Zugangsdaten finden Sie den Download für den Connector.

OXID Connector herunterladen
OXID Connector herunterladen

Entpacken Sie die ZIP-Datei auf Ihrem Rechner. Kopieren Sie die enthaltenen Ordner in das Web-Wurzelverzeichnis Ihrer OXID Installation. Dadurch werden diese Pfade angelegt:

  • modules/mailfino/connector: das OXID Modul mit der Konfiguration im Admin-Bereich.
  • mailfino/api: der öffentliche API-Endpunkt für mailfino.

Aktivieren Sie anschließend im OXID Admin-Bereich unter Erweiterungen > Module das Modul mailfino Connector. Öffnen Sie danach die Einstellungen des Moduls und tragen Sie dort ein:

  • Connector aktiv: eingeschaltet.
  • Connector-Benutzer: ein frei gewählter technischer Benutzername, zum Beispiel mailfino.
  • API-Key: ein langer zufälliger API-Key. Verwenden Sie keinen kurzen Testwert im produktiven Shop.
  • Kunden lesen erlauben: erforderlich, wenn mailfino OXID Kunden importieren soll.
  • Bestellungen lesen erlauben: erforderlich, wenn Kaufdaten für Segmente synchronisiert werden sollen.
  • Produkte lesen erlauben: erforderlich, wenn Produktdaten für Produktkarten oder Produktauswahl genutzt werden sollen.

Der Connector nutzt die vorhandene OXID Datenbankverbindung. Sie müssen keine Datenbank-Zugangsdaten in mailfino oder im Connector hinterlegen.

Wenn eine Berechtigung ausgeschaltet ist, blockiert der Connector die passende API-Route mit 403 Forbidden. So kann der Shopbetreiber genau festlegen, welche Daten mailfino lesen darf.

Danach sollte der Connector unter dieser Adresse erreichbar sein:

https://shop.example.com/mailfino/api/health

Testen Sie den Health-Endpunkt mit HTTP Basic Auth. Verwenden Sie als Benutzer den Connector-Benutzer und als Passwort den API-Key aus den Moduleinstellungen. Wenn der Connector korrekt installiert ist, antwortet er mit einem OK-Status.

Bewahren Sie Connector-Benutzer und API-Key in Ihrem Passwortmanager auf. mailfino benötigt später nur Shop-URL, Connector-Benutzer und API-Key.