integration_documentation:plugin:de:integration:shopware_6

integration_documentation:plugin:de:integration:shopware_6

This is an old revision of the document!


Download im Shopware Store

Installation

  • Shopware >= 6.4: Gehen Sie auf Erweiterungen → Meine Erweiterungen.
  • Shopware < 6.4: Gehen Sie auf Einstellungen → System → Plugins.

Installieren und aktivieren Sie das Findologic Plugin.

Klicken Sie auf Konfiguration

Wählen Sie den Verkaufskanal und Sprache

Fügen Sie die benötigten Konfiguration ein

Konfiguration

  • Shopkey: Fügen Sie den von Findologic erhaltenen Shopkey ein.
  • Aktiv: Aktivieren um die Findologic Suche im Shop zu nutzen.
  • Aktiv auf Kategorieseiten: Aktivieren um Findologic auf Kategorieseiten zu verwenden - for API integration.
  • Testmodus: Dieser Button wird angezeigt wenn sich die Findologic Integration im Staging Modus befindet. Bei Klick auf diesen werden Sie auf den Shop weitergeleitet und die Findologic Integration kann getestet werden.
  • Integration (schreibgeschützt): Dieses Feld wird automatisch gefüllt und zeigt die Integrationsart an, entweder Direct Integration oder API.

Direct Integration

Nur relevant wenn Integration Typ Direct Integration genutzt wird, siehe Integration (schreibgeschützt)

  • CSS Klasse für Suchresultat/Navigation: Klasse einfügen wenn andere HTML Container für Direct Integration verwendet werden, siehe Dokumentation.

API

Nur relevant wenn Integration Typ API genutzt wird, siehe Integration (schreibgeschützt)

  • Position der Filter auf Suchergebnisseiten: Die Findologic Filter können über oder links von den Suchresultaten dargestellt werden.

Wenn die Konfiguration abgeschlossen ist klicken Sie auf den Speichern Button.

Standard Export

Genaue Informationen zu den exportierten Produkten und Eigenschaften finden Sie unter Shopware 6 - Export Information.

Aufruf des Exports

Der Export kann über folgende URL aufgerufen werden:

<SHOP-URL>/findologic?shopkey=<SHOPKEY>&start=<NUMBER>&count=<NUMBER>
  • shopkey: <SHOPKEY> von Findologic bereitgestellt.
  • start: <NUMMER> größer oder gleich null, Standard: 0.
  • count: <NUMMER> größer als null, Standard: 20.

Diese Export-Url ist automatisch für den Datenabgleich im Findologic Account hinterlegt, siehe Dokumentation.

Export eines Produktes

Für Testzwecke kann der Export für ein bestimmtes Produkt aufgerufen werden:

<SHOP-URL>/findologic?shopkey=<SHOPKEY>&productId=<PRODUCT_ID>
  • shopkey: <SHOPKEY> von Findologic bereitgestellt.
  • productId: <PRODUCT_ID> ist ein 32-stellige Hex-Wert von Shopware erstellt.

Sollte es zu Problemen mit dem Datenabgleich geben kontaktieren Sie uns unter support@findologic.com.

Das generierte XML wird gegen ein XSD Schema validiert und wird mit unserer Export Library libflexport erstellt.

Um das Standardverhalten des Findologic Haupt-Plugins anzupassen und gleichzeitig Update Möglichkeit des Haupt-Plugins bestehen bleibt, haben wir ein Erweiterungsplugin entwickelt. Es enthält bereits etwas Code um die Exportlogik zu erweitern, allerdings kann man damit auch die Suchlogik, oder sogar die Templates der Filter erweitern.

Für eine detailierte Beschreibung mit Code-Beispielen siehe Findologic Shopware 6 plugin extension.

Änderungen die das Erweiterungsplugin möglicherweise brechen könnten, werden nur in Major releases (z.B. 1.x.x => 2.x.x) veröffentlicht. Wir stellen hier eine Anleitung (UPGRADE-x.x) zum Aktualisieren auf GitHub zur Verfügung.