integration_documentation:plugin:de:integration:shopware_6
Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
integration_documentation:plugin:de:integration:shopware_6 [2021/11/23 09:34] daniel |
— (current) | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | {{:integration_documentation:plugins:sw6-logo.jpg?nolink&400|}} | ||
- | ===== Shopware 6 Plugin Integration - DE ===== | ||
- | |||
- | ==== Download im Shopware Store ==== | ||
- | * [[https://store.shopware.com/fin6494960032131f/findologic-search-navigation-platform.html|Findologic - Search & Navigation Platform]] | ||
- | |||
- | ==== 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. | ||
- | |||
- | {{:integration_documentation:sw6_de_findologic_plugin.png?direct|}} | ||
- | |||
- | Klicken Sie auf //Konfiguration// | ||
- | |||
- | {{:integration_documentation:sw6_de_plugin_config.png?direct|}} | ||
- | |||
- | Wählen Sie den Verkaufskanal | ||
- | |||
- | {{:integration_documentation:plugin:de:integration:configuration_page_sales_channel_select_de.png}} | ||
- | |||
- | Fügen Sie die benötigten Konfiguration ein | ||
- | |||
- | {{:integration_documentation:plugin:de:integration:configuration_sales_channel_de.png}} | ||
- | |||
- | === 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 [[integration_documentation:direct_integration|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 ===== | ||
- | |||
- | === Standard Export === | ||
- | |||
- | Genaue Informationen zu den exportierten Produkten und Eigenschaften finden Sie unter [[integration_documentation:plugin:en:integration:shopware_6:export_information|Shopware 6 - Export Information]]. | ||
- | |||
- | === Aufruf des Exports === | ||
- | |||
- | Der Export kann über folgende URL aufgerufen werden: | ||
- | <code><SHOP-URL>/findologic?shopkey=<SHOPKEY>&start=<NUMBER>&count=<NUMBER></code> | ||
- | |||
- | * **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 muss im Findologic Account in den Einstellungen des [[https://account.findologic.com/#/app/search-navigation/import-export|Datenabgleich]] hinterlegt sein, siehe [[customer_account:import-export|Dokumentation]]. | ||
- | |||
- | |||
- | === Export eines Produktes === | ||
- | |||
- | Für Testzwecke kann der Export für ein bestimmtes Produkt aufgerufen werden: | ||
- | <code><SHOP-URL>/findologic?shopkey=<SHOPKEY>&productId=<PRODUCT_ID></code> | ||
- | |||
- | * **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|support@findologic.com]]. | ||
- | |||
- | Das generierte XML wird gegen ein [[https://raw.githubusercontent.com/Findologic/xml-export/master/src/main/resources/Findologic.xsd|XSD Schema]] validiert und wird mit unserer Export Library [[https://github.com/Findologic/libflexport|libflexport]] erstellt. | ||
- | |||
- | <markdown> | ||
- | --- | ||
- | |||
- | ## Plugin Erweiterung | ||
- | |||
- | Um das Standardverhalten des Findologic Haupt-Plugins anzupassen und gleichzeitig Update Möglichkeit des Haupt-Plugins bestehen bleibt, haben wir ein [Erweiterungsplugin](https://github.com/findologic/plugin-shopware-6-extension/releases) 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](https://docs.findologic.com/doku.php?id=integration_documentation:plugin:en:integration:shopware_6: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](https://github.com/findologic/plugin-shopware-6) zur Verfügung. | ||
- | |||
- | </markdown> |