integration_documentation:plugin:de:integration:shopware_6
This is an old revision of the document!
Shopware 6 Plugin Integration - DE
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
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.
Produkt 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 als null.
- count: <NUMMER> größer als null.
Diese Export-Url muss im Findologic Account in den Einstellungen des Datenabgleich hinterlegt sein, 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.
Plugin Erweiterung
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 (z.B. den Kategoriefilter).
Für eine detailierte Beschreibung mit Code-Beispielen siehe Findologic Shopware 6 plugin extension.
Upgrade Information
Ä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.