FFWEB-3430: Add cart button in record list

Rayn93 · web-flow · commit 2063bfb48eb3 · 2025-08-04T18:59:23.000+02:00
Add cart button in record list
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,4 +1,8 @@
 # Changelog
+## Unreleased
+### Add
+- Add to cart button for record list
+
 ## [v7.0.0] - 2025.07.23
 ### BREAKING
 - IMPORTANT! Drop Shopware 6.6 compatibility
diff --git a/README.md b/README.md
@@ -133,6 +133,7 @@ This section contains a plugin configuration, which is optional and provides add
   details about implementation [here](#enrich-data-received-from-fact-finder-in-proxycontroller).
 Note: Sending each request to FACT-Finder instance trough Shopware, you lose on performance as each request need to be handled first by HTTP server and then, by Shopware itself. This additional traffic could be easily avoided by not activating this feature if there's no clear reason to use it.
 
+* Add cart button - select this option if you want the Add to cart button on the product list
 * Scenario how to count single click on "Add to cart" button
 * Redirect mapping for selected queries - put each pair `query=url` in separate row. If the phrase appears twice, the first one from the top of the list will be taken. Url can be relative path `/some/page` or absolute url `https://domain.com/some/page?someParameter=1`. If provided pair has an invalid format then it will be ignored.
 
diff --git a/spec/Subscriber/ConfigurationSubscriberSpec.php b/spec/Subscriber/ConfigurationSubscriberSpec.php
@@ -68,6 +68,7 @@ public function it_will_return_factfinderchannel_for_specific_sales_channel_id(
         $communication->getApiKey()->willReturn('abc-123');
         $communication->isSsrActive()->willReturn(false);
         $communication->isProxyEnabled()->willReturn(false);
+        $communication->isCartBtnEnabled()->willReturn(false);
         $communication->getFactFinderFeatures()->willReturn([]);
         $communication->getChannel('main_sales_channel')->willReturn('some_ff_channel');
         $communication->getFieldRoles(Argument::any())->willReturn([]);
@@ -115,6 +116,7 @@ public function it_will_add_page_extension_for_storefront_render_event(
         $communication->getApiKey()->willReturn('abc-123');
         $communication->isSsrActive()->willReturn(false);
         $communication->isProxyEnabled()->willReturn(false);
+        $communication->isCartBtnEnabled()->willReturn(false);
         $event->getRequest()->willReturn($request);
         $request->get('_route', Argument::any())->willReturn('factfinder');
         $request->getLocale()->willReturn('en');
@@ -157,6 +159,7 @@ public function it_will_throw_exception_when_event_does_not_have_page(
         $communication->getApiKey()->willReturn('abc-123');
         $communication->isSsrActive()->willReturn(false);
         $communication->isProxyEnabled()->willReturn(false);
+        $communication->isCartBtnEnabled()->willReturn(false);
         $event->getRequest()->willReturn($request);
         $request->get('_route', Argument::any())->willReturn('factfinder');
         $request->getLocale()->willReturn('en');
diff --git a/src/Config/Communication.php b/src/Config/Communication.php
@@ -61,6 +61,11 @@ public function isSsrPdpEnabled(): bool
         return (bool) $this->config('useSsrPdp');
     }
 
+    public function isCartBtnEnabled(): bool
+    {
+        return (bool) $this->config('addCartBtn');
+    }
+
     public function getFactFinderFeatures(): array
     {
         return [
diff --git a/src/Resources/app/storefront/dist/storefront/js/omikron-fact-finder/omikron-fact-finder.js b/src/Resources/app/storefront/dist/storefront/js/omikron-fact-finder/omikron-fact-finder.js
diff --git a/src/Resources/app/storefront/dist/storefront/js/omikron-fact-finder/omikron-fact-finder.offcanvas-filter.plugin.8e362a.js b/src/Resources/app/storefront/dist/storefront/js/omikron-fact-finder/omikron-fact-finder.offcanvas-filter.plugin.8e362a.js
diff --git a/src/Resources/config/config.xml b/src/Resources/config/config.xml
@@ -62,6 +62,13 @@
             <helpText lang="de-DE">Mit Proxy können Sie die von FACT-Finder zurückkommenden Daten innerhalb des SDK-Codes verfeinern. Weitere Informationen finden Sie in der Dokumentation.</helpText>
         </input-field>
 
+        <input-field type="bool">
+            <name>addCartBtn</name>
+            <label>Add Cart button for product list</label>
+            <label lang="de-DE">Schaltfläche „In den Warenkorb“ für die Produktliste</label>
+            <defaultValue>false</defaultValue>
+        </input-field>
+
         <input-field type="single-select">
             <name>trackingAddToCartCount</name>
             <options>
diff --git a/src/Resources/config/services.xml b/src/Resources/config/services.xml
@@ -142,6 +142,12 @@
         <service id="Omikron\FactFinder\Shopware6\Api\UpdateFieldRolesController" />
         <service id="Omikron\FactFinder\Shopware6\Api\TestConnectionController" />
 
+        <service id="Omikron\FactFinder\Shopware6\Storefront\Controller\AddToCartController" public="true">
+            <argument type="service" id="Shopware\Core\Checkout\Cart\SalesChannel\CartService"/>
+            <argument type="service" id="product.repository"/>
+            <tag name="controller.service_arguments"/>
+        </service>
+
         <service id="Omikron\FactFinder\Shopware6\MessageQueue\FeedExportHandler">
             <tag name="messenger.message_handler" />
         </service>
diff --git a/src/Resources/views/storefront/components/factfinder/record.html.twig b/src/Resources/views/storefront/components/factfinder/record.html.twig
@@ -25,6 +25,14 @@
                  data-redirect="{{ '{{masterValues.Deeplink}}' }}" data-anchor="{{ '{{masterValues.Deeplink}}' }}">
                 {{ 'listing.boxProductDetails'|trans|sw_sanitize }}
               </a>
+
+              {% if page.extensions.factfinder.addCartBtn %}
+                <a class="btn btn-primary"
+                   href="/fact-finder/cart/add-by-number/{{ '{{variantValues.0.ProductNumber}}' }}"
+                   title="{{ 'listing.boxAddToCart'|trans|sw_sanitize }}">
+                  {{ 'listing.boxAddProduct'|trans|sw_sanitize }}
+                </a>
+              {% endif %}
             </div>
           </div>
         </div>
diff --git a/src/Resources/views/storefront/layout/factfinder/suggest.html.twig b/src/Resources/views/storefront/layout/factfinder/suggest.html.twig
@@ -1,15 +1,17 @@
 {% block layout_search_suggest %}
   <div class="search-suggest js-search-result">
     <ff-suggest layout="list" unresolved>
+      {% block layout_search_suggest_popular_searches %}
+        <template data-role="popularSearches">
+          <div class="ff-popular-searches">
+            <h3>{{ "ff.suggest.PopularSearches"|trans }}</h3>
+            <div data-template>{{ '{{name}}' }} </div>
+          </div>
+        </template>
+      {% endblock %}
+
       {% block layout_search_suggest_result_suggest_container %}
         <section class="ff-suggest-container row pb-4">
-          <template data-role="popularSearches">
-            <div class="ff-popular-searches">
-              <h3>{{ "ff.suggest.PopularSearches"|trans }}</h3>
-              <div data-template>{{ '{{name}}' }} </div>
-            </div>
-          </template>
-
           <div data-container="searchTerm" class="col">
             <h3 class="h5 container-caption">{{ 'ff.suggest.SearchTerms'|trans|striptags }}</h3>
             <ff-suggest-item type="searchTerm">
diff --git a/src/Storefront/Controller/AddToCartController.php b/src/Storefront/Controller/AddToCartController.php
@@ -0,0 +1,71 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Omikron\FactFinder\Shopware6\Storefront\Controller;
+
+use Shopware\Core\Checkout\Cart\LineItem\LineItem;
+use Shopware\Core\Checkout\Cart\SalesChannel\CartService;
+use Shopware\Core\Content\Product\SalesChannel\SalesChannelProductEntity;
+use Shopware\Core\Framework\DataAbstractionLayer\EntityRepository;
+use Shopware\Core\Framework\DataAbstractionLayer\Search\Criteria;
+use Shopware\Core\Framework\DataAbstractionLayer\Search\Filter\EqualsFilter;
+use Shopware\Core\System\SalesChannel\SalesChannelContext;
+use Shopware\Storefront\Controller\StorefrontController;
+use Symfony\Component\HttpFoundation\RedirectResponse;
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\Routing\Annotation\Route;
+
+#[Route(defaults: ['_routeScope' => ['storefront']])]
+class AddToCartController extends StorefrontController
+{
+    public function __construct(
+        private readonly CartService $cartService,
+        private readonly EntityRepository $productRepository,
+    ) {
+    }
+
+    #[Route(
+        '/fact-finder/cart/add-by-number/{productNumber}',
+        name: 'frontend.cart.add.by.number',
+        defaults: ['XmlHttpRequest' => true],
+        methods: ['GET', 'POST']
+    )]
+    public function addToCartByNumber(
+        string $productNumber,
+        Request $request,
+        SalesChannelContext $context,
+    ): RedirectResponse {
+        $referer  = $request->headers->get('referer');
+        $criteria = new Criteria();
+        $criteria->addFilter(new EqualsFilter('productNumber', $productNumber));
+        $criteria->setLimit(1);
+
+        /** @var SalesChannelProductEntity|null $product */
+        $product = $this->productRepository->search($criteria, $context->getContext())->first();
+
+        if (!$product) {
+            $this->addFlash('danger', "Invalid product number: $productNumber");
+
+            return $this->redirectToRoute('frontend.home.page');
+        }
+
+        $lineItem = (new LineItem($product->getId(), LineItem::PRODUCT_LINE_ITEM_TYPE, $product->getId(), 1))
+            ->setStackable(true)
+            ->setRemovable(true);
+        $cart = $this->cartService->getCart($context->getToken(), $context);
+        $this->cartService->add($cart, $lineItem, $context);
+        $this->addFlash('success', "Product {$product->getName()} was added to the cart successfully.");
+
+        return $this->redirectToRefererOrToHomePage($referer);
+    }
+
+    private function redirectToRefererOrToHomePage(?string $referer): RedirectResponse
+    {
+        if ($referer && filter_var($referer, FILTER_VALIDATE_URL)) {
+            return new RedirectResponse($referer);
+        }
+
+        return $this->redirectToRoute('frontend.home.page');
+    }
+}
diff --git a/src/Subscriber/ConfigurationSubscriber.php b/src/Subscriber/ConfigurationSubscriber.php
@@ -72,6 +72,7 @@ public function onPageLoaded(ShopwareSalesChannelEvent $event): void
                 'communicationAttributes' => $this->getCommunicationAttributes($communicationConfig),
                 'categoryPathFieldName'   => $this->categoryPathFieldName,
                 'features'                => $this->config->getFactFinderFeatures(),
+                'addCartBtn'              => $this->config->isCartBtnEnabled(),
             ]));
         }
     }

Original file line number	Diff line number	Diff line change
`@@ -61,6 +61,11 @@ public function isSsrPdpEnabled(): bool`
`61`	`61`	`return (bool) $this->config('useSsrPdp');`
`62`	`62`	`}`
`63`	`63`
	`64`	`+ public function isCartBtnEnabled(): bool`
	`65`	`+ {`
	`66`	`+ return (bool) $this->config('addCartBtn');`
	`67`	`+ }`
	`68`	`+`
`64`	`69`	`public function getFactFinderFeatures(): array`
`65`	`70`	`{`
`66`	`71`	`return [`