Differences

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

--- integration_documentation:plugin:en:integration:shopware_6:extension [2022/06/21 14:36]
tobi
+++ integration_documentation:plugin:en:integration:shopware_6:extension [2022/12/13 13:42] (current)
tobi
@@ Line 15: / Line 15: @@
 </markdown>
-<note tip>Please make sure to use the same major version as the base Findologic plugin. This means that ''2.x'' is compatible with ''2.x'' and ''3.x'' is compatible with ''3.x'', etc.</note>
+<note tip>Please make sure to use the same major version as the base Findologic plugin. This means that ''3.x'' is compatible with ''3.x'' and ''4.x'' is compatible with ''4.x'', etc.</note>
 <markdown>
@@ Line 25: / Line 25: @@
 By default the extension plugin decorates the `AttributeAdapter` and `DefaultPropertiesAdapter`, which are responsible to generate the attributes and properties of a product.
-Any adapter in `FINDOLOGIC\FinSearch\Export\Adapters` can be decorated.
+Any adapter in `FINDOLOGIC\Shopware6Common\Export\Adapters` can be decorated. The original files are located within `vendor/findologic/shopware6-common/src/Export/Adapters`.
 `src/Resources/config/services.xml`
@@ Line 38: / Line 38: @@
         <service
             id="FINDOLOGIC\ExtendFinSearch\Export\Adapters\AttributeAdapter"
-            decorates="FINDOLOGIC\FinSearch\Export\Adapters\AttributeAdapter"
+            decorates="FINDOLOGIC\Shopware6Common\Export\Adapters\AttributeAdapter"
             public="true"
             decoration-on-invalid="ignore"
+            autowire="true"
         >
-            <argument type="service" id="service_container" />
+            <argument key="$dynamicProductGroupService" type="service" id="FINDOLOGIC\FinSearch\Export\Services\DynamicProductGroupService" />
-            <argument type="service" id="FINDOLOGIC\FinSearch\Struct\Config" />
+            <argument key="$catUrlBuilderService" type="service" id="FINDOLOGIC\FinSearch\Export\Services\CatUrlBuilderService" />
-            <argument type="service" id="Shopware\Core\Framework\Adapter\Translation\Translator" />
+            <argument key="$translator" type="service" id="Shopware\Core\Framework\Adapter\Translation\Translator" />
-            <argument type="service" id="fin_search.sales_channel_context" />
-            <argument type="service" id="FINDOLOGIC\FinSearch\Export\UrlBuilderService" />
-            <argument type="service" id="fin_search.export_context" />
         </service>
         <service
             id="FINDOLOGIC\ExtendFinSearch\Export\Adapters\DefaultPropertiesAdapter"
-            decorates="FINDOLOGIC\FinSearch\Export\Adapters\DefaultPropertiesAdapter"
+            decorates="FINDOLOGIC\Shopware6Common\Export\Adapters\DefaultPropertiesAdapter"
             public="true"
             decoration-on-invalid="ignore"
+            autowire="true"
         >
-            <argument type="service" id="FINDOLOGIC\FinSearch\Struct\Config" />
+            <argument key="$translator" type="service" id="Shopware\Core\Framework\Adapter\Translation\Translator" />
-            <argument type="service" id="fin_search.sales_channel_context" />
-            <argument type="service" id="Shopware\Core\Framework\Adapter\Translation\Translator" />
         </service>
@@ Line 78: / Line 75: @@
 use FINDOLOGIC\Export\Data\Attribute;
-use FINDOLOGIC\FinSearch\Export\Adapters\AttributeAdapter as OriginalAttributeAdapter;
+use FINDOLOGIC\Shopware6Common\Export\Adapters\AttributeAdapter as OriginalAttributeAdapter;
-use Shopware\Core\Content\Product\ProductEntity;
+use Vin\ShopwareSdk\Data\Entity\Product\ProductEntity;
 class AttributeAdapter extends OriginalAttributeAdapter
@@ Line 110: / Line 107: @@
 use FINDOLOGIC\Export\Data\Property;
-use FINDOLOGIC\FinSearch\Export\Adapters\DefaultPropertiesAdapter as OriginalDefaultPropertiesAdapter;
+use FINDOLOGIC\Shopware6Common\Export\Adapters\DefaultPropertiesAdapter as OriginalDefaultPropertiesAdapter;
-use Shopware\Core\Content\Product\ProductEntity;
+use Vin\ShopwareSdk\Data\Entity\Product\ProductEntity;
 class DefaultPropertiesAdapter extends OriginalDefaultPropertiesAdapter
@@ Line 210: / Line 207: @@
 use FINDOLOGIC\Export\Data\Property;
-use FINDOLOGIC\FinSearch\Export\Adapters\AdapterFactory;
+use FINDOLOGIC\Shopware6Common\Export\Adapters\AdapterFactory;
-use FINDOLOGIC\FinSearch\Export\Events\AfterItemBuildEvent;
+use FINDOLOGIC\Shopware6Common\Export\Events\AfterItemBuildEvent;
-use FINDOLOGIC\FinSearch\Export\Events\AfterVariantAdaptEvent;
+use FINDOLOGIC\Shopware6Common\Export\Events\AfterVariantAdaptEvent;
-use FINDOLOGIC\FinSearch\Export\Events\BeforeItemAdaptEvent;
+use FINDOLOGIC\Shopware6Common\Export\Events\BeforeItemAdaptEvent;
-use Shopware\Core\Content\Product\ProductEntity;
 use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+use Vin\ShopwareSdk\Data\Entity\Product\ProductEntity;
 class ProductSubscriber implements EventSubscriberInterface
@@ Line 232: / Line 229: @@
     {
         return [
-            BeforeItemAdaptEvent::NAME => 'beforeItemAdapt',
             AfterVariantAdaptEvent::NAME => 'afterVariantAdapted',
             AfterItemBuildEvent::NAME => 'afterItemCompleted'
         ];
-    }
-    public function beforeItemAdapt()
-    {
-        $this->variantData = [];
     }
@@ Line 263: / Line 254: @@
             );
         }
+        $this->variantData = [];
     }
 }
@@ Line 282: / Line 275: @@
         >
             <tag name="kernel.event_subscriber" />
-            <argument type="service" id="FINDOLOGIC\FinSearch\Export\Adapters\AdapterFactory" />
+            <argument type="service" id="FINDOLOGIC\Shopware6Common\Export\Adapters\AdapterFactory" />
         </service>
@@ Line 400: / Line 393: @@
     $product = $event->getProduct();
-    foreach ($product->getProperties() as $variantProperty) {
+    foreach ($product->properties as $variantProperty) {
         // Ignore all properties except the property we want to export our variants off.
         if (
-            !$variantProperty->getGroup() ||
+            !$variantProperty->group ||
-            $variantProperty->getGroup()->getTranslation('name') !== self::VARIANT_PROPERTY)
+            $variantProperty->group->getTranslation('name') !== self::VARIANT_PROPERTY)
         {
             continue;
@@ Line 469: / Line 462: @@
         );
-        $this->variantData[array_key_first($values)] = json_encode($variantData);
+        $this->variantData[array_key_first($values)][] = json_encode($variantData);
     }
 }
@@ Line 475: / Line 468: @@
 public function afterItemCompleted(AfterItemBuildEvent $event)
 {
+    $variantData = [];
+    foreach ($this->variantData as $usergroup => $userGroupVariantData) {
+        $variantData[$usergroup] = json_encode($userGroupVariantData);
+    }
     $item = $event->getItem();
     if (count($this->variantData)) {
         $item->addProperty(
-            new Property('variants', $this->variantData)
+            new Property('variants', $variantData)
         );
     }
@@ Line 575: / Line 573: @@
 use FINDOLOGIC\FinSearch\Export\Search\ProductCriteriaBuilder as OriginalProductCriteriaBuilder;
-use FINDOLOGIC\FinSearch\Utils\Utils;
 class ProductCriteriaBuilder extends OriginalProductCriteriaBuilder
@@ Line 581: / Line 578: @@
     public function withProductAssociations(): OriginalProductCriteriaBuilder
     {
-        Utils::addProductAssociations($this->criteria);
+        parent::withProductAssociations();
         $this->criteria->addAssociations([
@@ Line 592: / Line 589: @@
     public function withVariantAssociations(): OriginalProductCriteriaBuilder
     {
-        Utils::addVariantAssociations($this->criteria);
+        parent::withVariantAssociations();
         $this->criteria->addAssociations([
@@ Line 619: / Line 616: @@
             decorates="FINDOLOGIC\FinSearch\Export\Search\ProductCriteriaBuilder"
             public="true"
-        >
+            decoration-on-invalid="ignore"
-            <argument type="service" id="fin_search.sales_channel_context" />
+            autowire="true"
-            <argument type="service" id="Shopware\Core\System\SystemConfig\SystemConfigService" />
+        />
-        </service>
         <!-- ... -->
@@ Line 629: / Line 625: @@
 </container>
 ```
+## Cookie Consent for Direct Integration
+In case it's required by the integration, you are required to add a cookie consent. Please see the Shopware 6 documentation about [Adding a cookie to the cookie manager]( https://developer.shopware.com/docs/guides/plugins/plugins/storefront/add-cookie-to-manager).
+There is also an [example](https://github.com/findologic/plugin-shopware-6-extension/commit/cf1a0b68a8f590f8eaf818dc038b5903edfbfd80) available in our GitHub repository.
+## Add custom sorting options for API Integration
+The Findologic base plugin already provides sorting options for the most common use-cases. The plugin uses `SortingHandler` to send the currently selected sorting option via API parameters to the Findologic Search-API (see [all available SortingHandlers](https://github.com/findologic/plugin-shopware-6/tree/develop/src/Core/Content/Product/SalesChannel/Listing/SortingHandler)).
+Therefore to handle custom sorting options, create a custom `SortingHandler` in the extension plugin, and override the responsible `SortingHandlerService` to include the created `SortingHandler`.
+### Prerequisites
+Before a custom sorting can be used, make sure to export the value for the custom sort in the `<sort>` field in the export. See the [XML Format documentation](:xml_export_documentation:xml_format#sorts) for further details.
+### Implementation
+**Step 1: Create a `SortingHandler`**
+Create the folder structure `Core/Content/Product/SalesChannel/Listing/SortingHandler` in the extension plugin, and add a custom sorting handler class. In this example it will be `ThirdPartySortingHandler`:
+```php
+use FINDOLOGIC\Api\Requests\SearchNavigation\SearchNavigationRequest;
+use FINDOLOGIC\FinSearch\Core\Content\Product\SalesChannel\Listing\SortingHandler\SortingHandlerInterface;
+use Shopware\Core\Framework\DataAbstractionLayer\Search\Sorting\FieldSorting;
+class ThirdPartySortingHandler implements SortingHandlerInterface
+{
+    public function supportsSorting(FieldSorting $fieldSorting): bool
+    {
+        // Enter your custom sort here.
+        // To get the name of the sort, select the sort in the storefront and
+        // add a dd($fieldSorting) here and refresh the page.
+        return $fieldSorting->getField() === 'product.third_party_extension.field';
+    }
+    public function generateSorting(FieldSorting $fieldSorting, SearchNavigationRequest $searchNavigationRequest): void
+    {
+        $searchNavigationRequest->setOrder('shopsort ' . $fieldSorting->getDirection());
+    }
+}
+```
+**Step 2: Decorate the `SortingHandlerService`**
+The `SortingHandlerService` holds all available sorting options. Therefore, you want to add your custom sort to this service. The service can be found in `Findologic/Request/Handler`. Simply override the `getSortingHandlers` method to include your own custom sorting handler.
+```php
+namespace FINDOLOGIC\ExtendFinSearch\Findologic\Request\Handler;
+use FINDOLOGIC\ExtendFinSearch\Core\Content\Product\SalesChannel\Listing\SortingHandler\ThirdPartySortingHandler;
+use FINDOLOGIC\FinSearch\Core\Content\Product\SalesChannel\Listing\SortingHandler\SortingHandlerInterface;
+use FINDOLOGIC\FinSearch\Findologic\Request\Handler\SortingHandlerService as OriginalSortingHandlerService;
+class SortingHandlerService extends OriginalSortingHandlerService
+{
+    /**
+     * @return SortingHandlerInterface[]
+     */
+    protected function getSortingHandlers(): array
+    {
+        return array_merge(
+            parent::getSortingHandlers(),
+            [
+                new ThirdPartySortingHandler()
+            ]
+        );
+    }
+}
+```
+**Step 3: Add the decorated service to the services.xml**
+As a last step, simply decorate in your `src/Resources/config/services.xml` the service of the main plugin:
+```xml
+<?xml version="1.0" ?>
+<container xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xmlns="http://symfony.com/schema/dic/services"
+    xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd">
+    <services>
+        <service
+            id="FINDOLOGIC\ExtendFinSearch\Findologic\Request\Handler\SortingHandlerService"
+            decorates="FINDOLOGIC\FinSearch\Findologic\Request\Handler\SortingHandlerService"
+            decoration-on-invalid="ignore"
+        />
+    </services>
+</container>
+```
+Once this step is done, selecting your relevant sorting option will send the order parameter to the Findologic API.
 </markdown>

integration_documentation:plugin:en:integration:shopware_6:extension

Differences

Documentation overview

Useful links