integration_documentation:shopware_6_ger

integration_documentation:shopware_6_ger

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
integration_documentation:shopware_6_ger [2020/05/28 15:25]
florian created
integration_documentation:shopware_6_ger [2021/01/25 14:29]
dominik removed
Line 1: Line 1:
-===== Shopware 6 Plugin Integration =====+===== Shopware 6 Plugin Integration ​- DE ===== 
 + 
 +==== Download im Shopware Store ==== 
 +  * [[https://​store.shopware.com/​fin6494960032131f/​findologic-search-navigation-platform.html|Findologic - Search & Navigation Platform]] 
 + 
 +==== Installation ==== 
 + 
 +Im Shopware Backend 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|}} 
 + 
 +Fügen Sie die benötigten Konfiguration ein 
 + 
 +{{:​integration_documentation:​plugins:​sw6_plugin_config_de.png?​direct|}} 
 + 
 +=== 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 ==== 
 + 
 +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 als null. 
 +  * **count:** <​NUMMER>​ größer als null. 
 + 
 +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]]. 
 + 
 +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>​ 
 +### Erweitern des Plugins 
 + 
 +Manchmal möchte man das Standardverhalten des Plugins zu seinen eigenen Bedürfnissen anpassen. Damit das möglich ist und man trotzdem die Möglichkeit hat die neuesten Plugin-Updates zu erhalten, 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). 
 + 
 +#### Autoloading 
 + 
 +</​markdown>​ 
 + 
 +<note tip>​Autoloading wird nur benötigt, wenn [[https://​getcomposer.org/​doc/​03-cli.md#​require|zusätzliche Composer Bibliotheken]] benötigt werden.</​note>​ 
 + 
 +<​markdown>​ 
 +![https://​docs.findologic.com/​lib/​exe/​fetch.php?​t=1603273975&​tok=ddd8c2&​media=integration_documentation:​extension.png](https://​docs.findologic.com/​lib/​exe/​fetch.php?​t=1603273975&​tok=ddd8c2&​media=integration_documentation:​extension.png) ​  
 + 
 +Obwohl das Composer autoloading standardmäßig deaktiviert ist, kann es jederzeit aktiviert werden, indem die markierte Zeile in der Datei `\FINDOLOGIC\ExtendFinSearch\ExtendFinSearch` auskommentiert wird. 
 + 
 +#### Upgrading 
 + 
 +Änderungen die das Erweiterungsplugin möglicherweise brechen könnten, werden nur in sogenannten "major releases"​ (z.B. 1.x.x => 2.x.x) veröffentlicht. Bei solch einem Release, stellen wir auch eine Anleitung (`UPGRADE-x.x`) zum Aktualisieren auf [GitHub](https://​github.com/​findologic/​plugin-shopware-6) zur Verfügung. 
 + 
 +</​markdown>​