Install the Product Lists feature

Edit on GitHub

This document describes how to install the Product Lists feature.

Install feature core

Follow the steps below to install the Product Lists feature core.

Prerequisites

Install the required features:

NAME VERSION INSTALLATION GUIDE
Spryker Core 202410.0 Install the Spryker Сore feature
Product 202410.0 Install the Product feature
Category Management 202410.0 Install the Category Management feature

1) Install the required modules

composer require spryker-feature/product-lists:"202410.0" --update-with-dependencies
Verification

Make sure that the following modules have been installed:

MODULE EXPECTED DIRECTORY
ProductList vendor/spryker/product-list
ProductListDataImport vendor/spryker/product-list-data-import
ProductListGui vendor/spryker/product-list-gui
ProductListGuiExtension vendor/spryker/product-list-gui-extension
ProductListSearch vendor/spryker/product-list-search
ProductListStorage vendor/spryker/product-list-storage
ProductStorageExtension vendor/spryker/product-storage-extension

2) Set up database schema and transfer objects

  1. Define the following transfer objects:

src/Pyz/Shared/ProductList/Transfer/product_list.transfer.xml

<?xml version="1.0"?>
<transfers xmlns="spryker:transfer-01"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="spryker:transfer-01 http://static.spryker.com/transfer-01.xsd">

    <transfer name="ProductListCollection">
        <property name="productLists" type="ProductList[]" singular="productList"/>
    </transfer>

    <transfer name="Customer">
        <property name="customerProductListCollection" type="CustomerProductListCollection"/>
        <property name="companyUserTransfer" type="CompanyUser"/>
    </transfer>

    <transfer name="CustomerProductListCollection">
        <property name="blacklistIds" type="int[]" singular="blacklistId"/>
        <property name="whitelistIds" type="int[]" singular="whitelistId"/>
    </transfer>

</transfers>
  1. Adjust the schema definition so that entity changes trigger events.
AFFECTED ENTITY TRIGGERED EVENTS
spy_product_list Entity.spy_product_list.create
Entity.spy_product_list.update
Entity.spy_product_list.delete
spy_product_list_product_concrete Entity.spy_product_list_product_concrete.create
Entity.spy_product_list_product_concrete.update
Entity.spy_product_list_product_concrete.delete
spy_product_list_category Entity.spy_product_list_category.create
Entity.spy_product_list_category.update
Entity.spy_product_list_category.delete

src/Pyz/Zed/ProductList/Persistence/Propel/Schema/spy_product_list.schema.xml

<?xml version="1.0"?>
<database xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        name="zed"
        xsi:noNamespaceSchemaLocation="http://static.spryker.com/schema-01.xsd"
        namespace="Orm\Zed\ProductList\Persistence"
        package="src.Orm.Zed.ProductList.Persistence">
    <table name="spy_product_list" identifierQuoting="true">
        <behavior name="event">
            <parameter name="spy_product_list_all" column="*"/>
        </behavior>
    </table>
    <table name="spy_product_list_product_concrete" isCrossRef="true">
        <behavior name="event">
            <parameter name="spy_product_list_product_concrete_all" column="*"/>
        </behavior>
    </table>
    <table name="spy_product_list_category" isCrossRef="true">
        <behavior name="event">
            <parameter name="spy_product_list_category_all" column="*"/>
        </behavior>
    </table>
 </database>
  1. Set up synchronization queue pools so that non-multi-store entities (not store-specific entities) are synchronized among stores:

src/Pyz/Zed/ProductListStorage/Persistence/Propel/Schema/spy_product_list_storage.schema.xml

<?xml version="1.0"?>
<database xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        name="zed"
        xsi:noNamespaceSchemaLocation="http://static.spryker.com/schema-01.xsd"
        namespace="Orm\Zed\ProductListStorage\Persistence"
        package="src.Orm.Zed.ProductListStorage.Persistence">
     <table name="spy_product_abstract_product_list_storage">
        <behavior name="synchronization">
            <parameter name="queue_pool" value="synchronizationPool"/>
        </behavior>
     </table>
     <table name="spy_product_concrete_product_list_storage">
        <behavior name="synchronization">
            <parameter name="queue_pool" value="synchronizationPool"/>
        </behavior>
    </table>
 </database>
  1. Apply database changes and generate entity and transfer changes:
console propel:install
console transfer:generate
Verification

Make sure that the following changes have been applied in the transfer objects:

TRANSFER TYPE EVENT PATH
ProductList class created src/Generated/Shared/Transfer/ProductListTransfer
ProductListCollection class created src/Generated/Shared/Transfer/ProductListCollectionTransfer
ProductListCriteria class created src/Generated/Shared/Transfer/ProductListCriteriaTransfer
Pagination class created src/Generated/Shared/Transfer/PaginationTransfer
ProductListCategoryRelation class created src/Generated/Shared/Transfer/ProductListCategoryRelationTransfer
ProductListProductConcreteRelation class created src/Generated/Shared/Transfer/ProductListProductConcreteRelationTransfer
CartChange class created src/Generated/Shared/Transfer/CartChangeTransfer
ProductListAggregateForm class created src/Generated/Shared/Transfer/ProductListAggregateFormTransfer
QueryCriteria class created src/Generated/Shared/Transfer/QueryCriteriaTransfer
QueryJoin class created src/Generated/Shared/Transfer/QueryJoinTransfer
PageMap class created src/Generated/Shared/Transfer/PageMapTransfer
ProductListMap class created src/Generated/Shared/Transfer/ProductListMapTransfer
ProductPageSearch class created src/Generated/Shared/Transfer/ProductPageSearchTransfer
ProductConcretePageSearch class created src/Generated/Shared/Transfer/ProductConcretePageSearchTransfer
ProductPayload class created src/Generated/Shared/Transfer/ProductPayloadTransfer
ProductAbstractProductListStorage class created src/Generated/Shared/Transfer/ProductAbstractProductListStorageTransfer
ProductConcreteProductListStorage class created src/Generated/Shared/Transfer/ProductConcreteProductListStorageTransfer
CustomerProductListCollection class created src/Generated/Shared/Transfer/CustomerProductListCollectionTransfer
Customer.companyUserTransfer property created src/Generated/Shared/Transfer/CustomerTransfer
Customer.customerProductListCollection property created src/Generated/Shared/Transfer/CustomerTransfer

Make sure that the following changes have been applied by checking your database:

DATABASE ENTITY TYPE EVENT
spy_product_list table created
spy_product_list_product_concrete table created
spy_product_list_category table created
spy_product_abstract_product_list_storage table created
spy_product_concrete_product_list_storage table created

Make sure that propel entities have been generated successfully by checking their existence. Also, change the generated entity classes to extend from Spryker core classes.

CLASS PATH EXTENDS
src/Orm/Zed/ProductList/Persistence/Base/SpyProductList.php Spryker\Zed\ProductList\Persistence\Propel\AbstractSpyProductList
src/Orm/Zed/ProductList/Persistence/Base/SpyProductListQuery.php Spryker\Zed\ProductList\Persistence\Propel\AbstractSpyProductListQuery
src/Orm/Zed/ProductList/Persistence/Base/SpyProductListProductConcrete.php Spryker\Zed\ProductList\Persistence\Propel\AbstractSpyProductListProductConcrete
src/Orm/Zed/ProductList/Persistence/Base/SpyProductListProductConcreteQuery.php Spryker\Zed\ProductList\Persistence\Propel\AbstractSpyProductListProductConcreteQuery
src/Orm/Zed/ProductList/Persistence/Base/SpyProductListCategory.php Spryker\Zed\ProductList\Persistence\Propel\AbstractSpyProductListCategory
src/Orm/Zed/ProductList/Persistence/Base/SpyProductListCategoryQuery.php Spryker\Zed\ProductList\Persistence\Propel\AbstractSpyProductListCategoryQuery
src/Orm/Zed/ProductListStorage/Persistence/Base/SpyProductAbstractProductListStorage Spryker\Zed\ProductListStorage\Persistence\Propel\AbstractSpyProductAbstractProductListStorage
src/Orm/Zed/ProductListStorage/Persistence/Base/SpyProductAbstractProductListStorageQuery Spryker\Zed\ProductListStorage\Persistence\Propel\AbstractSpyProductAbstractProductListStorageQuery
src/Orm/Zed/ProductListStorage/Persistence/Base/SpyProductConcreteProductListStorage Spryker\Zed\ProductListStorage\Persistence\Propel\AbstractSpyProductConcreteProductListStorage
src/Orm/Zed/ProductListStorage/Persistence/Base/SpyProductConcreteProductListStorageQuery Spryker\Zed\ProductListStorage\Persistence\Propel\AbstractSpyProductConcreteProductListStorageQuery

Make sure that the changes have been implemented successfully. For this purpose, trigger the following methods and make sure that the preceding events have been triggered:

PATH METHOD NAME
src/Orm/Zed/ProductList/Persistence/Base/SpyProductList.php prepareSaveEventName()
addSaveEventToMemory()
addDeleteEventToMemory()
src/Orm/Zed/ProductList/Persistence/Base/SpyProductListProductConcrete.php prepareSaveEventName()
addSaveEventToMemory()
addDeleteEventToMemory()
src/Orm/Zed/ProductList/Persistence/Base/SpyProductListCategory.php prepareSaveEventName()
addSaveEventToMemory()
addDeleteEventToMemory()
src/Orm/Zed/ProductListStorage/Persistence/Base/SpyProductAbstractProductListStorage.php sendToQueue()
src/Orm/Zed/ProductListStorage/Persistence/Base/SpyProductConcreteProductListStorage.php sendToQueue()

3) Set up the configuration

Add the following configuration to your project:

src/Pyz/Zed/ProductListGui/ProductListGuiConfig.php

<?php

namespace Pyz\Zed\ProductListGui;

use Spryker\Zed\ProductListGui\ProductListGuiConfig as SprykerProductListGuiConfig;

class ProductListGuiConfig extends SprykerProductListGuiConfig
{
    /**
     * @var bool
     */
    protected const IS_FILE_EXTENSION_VALIDATION_ENABLED = true;
}

4) Add translations

  1. Append glossary according to your language configuration:

src/data/import/glossary.csv

product-cart.info.restricted-product.removed,"Unavailable item %sku% was removed from your shopping cart.",en_US
product-cart.info.restricted-product.removed,"Der nicht verfügbare Artikel% sku% wurde aus Ihrem Einkaufswagen entfernt.",de_DE
  1. Import data:
console data:import glossary
Verification

Make sure that the configured data has been added to the spy_glossary table in the database.

5) Configure export to Redis and Elasticsearch

Configure export to Redis and Elasticsearch as follows.

Set up event listeners

With this step, you publish tables on change (create, edit, or delete) to spy_product_abstract_product_list_storage and spy_product_concrete_product_list_storage and synchronize the data to Storage and Search.

PLUGIN SPECIFICATION PREREQUISITES NAMESPACE
ProductListStorageEventSubscriber Registers listeners that are responsible for publishing product list information to storage when a related entity changes. None Spryker\Zed\ProductListStorage\Communication\Plugin\Event\Subscriber
ProductListSearchEventSubscriber Registers listeners that are responsible for publishing product list information to search when a related entity changes. None Spryker\Zed\ProductListSearch\Communication\Plugin\Event\Subscriber

src/Pyz/Zed/Event/EventDependencyProvider.php

<?php

namespace Pyz\Zed\Event;

use Spryker\Zed\Event\EventDependencyProvider as SprykerEventDependencyProvider;
use Spryker\Zed\ProductListSearch\Communication\Plugin\Event\Subscriber\ProductListSearchEventSubscriber;
use Spryker\Zed\ProductListStorage\Communication\Plugin\Event\Subscriber\ProductListStorageEventSubscriber;

class EventDependencyProvider extends SprykerEventDependencyProvider
{
    public function getEventSubscriberCollection()
    {
        $eventSubscriberCollection = parent::getEventSubscriberCollection();
        $eventSubscriberCollection->add(new ProductListStorageEventSubscriber());
        $eventSubscriberCollection->add(new ProductListSearchEventSubscriber());

        return $eventSubscriberCollection;
    }
}
Verification

Make sure that when a product list is created, updated, or deleted, they are exported or removed to Redis and Elasticsearch accordingly.

STORAGE TYPE TARGET ENTITY EXAMPLE EXPECTED DATA IDENTIFIER
Redis Product Abstract Product List kv:product_abstract_product_lists:1
Redis Product Concrete Product List kv:product_concrete_product_list:1
Elasticsearch Product Abstract product_abstract:de:en_us:1
Elasticsearch Product Concrete product_concrete:de:en_us:1

Example expected data fragment for Product Abstract Product List

{
    "id_product_abstract": 1,
    "id_whitelists": [1,2],
    "id_blacklists": [3]
}

Example expected data fragment for Product Concrete Product List

{
    "id_product_concrete": 1,
    "id_whitelists": [1,2],
    "id_blacklists": [3]
}

Example expected data fragment for Product Abstract

{
    "product-lists": {
      "whitelists": [1,2],
      "blacklists": [3]
    }
}

Example expected data fragment for Product Concrete

{
    "product-lists": {
      "whitelists": [1,2],
      "blacklists": [3]
    }
}

Prepare search data for export

With this step, you extend Elasticsearch documents with product list data.

Add the following plugins to your project:

PLUGIN SPECIFICATION PREREQUISITES NAMESPACE
ProductListDataLoaderPlugin Loads product list data as payload for the publishing process. None Spryker\Zed\ProductListSearch\Communication\Plugin\ProductPageSearch\DataLoader
ProductListDataLoadExpanderPlugin Expands product page data with all its product lists for publishing based on the previously collected product information. Product list data must be available in the product payload. Suggestion: use ProductListDataLoaderPlugin (the first plugin in the table). Spryker\Zed\ProductListSearch\Communication\Plugin\ProductPageSearch\DataExpander
ProductListMapExpanderPlugin Maps product list data to the Elasticsearch document structure. Product list data must be available. Suggestion: use ProductListDataLoadExpanderPlugin (see the preceding one). Spryker\Zed\ProductListSearch\Communication\Plugin\ProductPageSearch
ProductAbstractProductListSynchronizationDataPlugin Can be executed to synchronize all product_abstract_product_list entries from the database to Redis. None Spryker\Zed\ProductListStorage\Communication\Plugin\Synchronization
ProductConcreteProductListSynchronizationDataPlugin Can be executed to synchronize all product_concrete_product_list entries from the database to Redis. None Spryker\Zed\ProductListStorage\Communication\Plugin\Synchronization
ProductConcreteProductListPageDataExpanderPlugin Expands ProductConcretePageSearchTransfer with product lists data and returns the modified object. None Spryker\Zed\ProductListSearch\Communication\Plugin\ProductPageSearch
ProductConcreteProductListPageMapExpanderPlugin Maps product list data related to concrete products to the Elasticsearch document structure. Product list data must be available. Suggestion: use ProductConcreteProductListPageDataExpanderPlugin (see the preceding one). Spryker\Zed\ProductListSearch\Communication\Plugin\ProductPageSearch
src/Pyz/Zed/ProductPageSearch/ProductPageSearchDependencyProvider.php
<?php

namespace Pyz\Zed\ProductPageSearch;

use Spryker\Shared\ProductListSearch\ProductListSearchConfig;
use Spryker\Zed\ProductListSearch\Communication\Plugin\ProductPageSearch\DataExpander\ProductListDataLoadExpanderPlugin;
use Spryker\Zed\ProductListSearch\Communication\Plugin\ProductPageSearch\DataLoader\ProductListDataLoaderPlugin;
use Spryker\Zed\ProductListSearch\Communication\Plugin\ProductPageSearch\ProductConcreteProductListPageDataExpanderPlugin;
use Spryker\Zed\ProductListSearch\Communication\Plugin\ProductPageSearch\ProductConcreteProductListPageMapExpanderPlugin;
use Spryker\Zed\ProductListSearch\Communication\Plugin\ProductPageSearch\ProductListMapExpanderPlugin;
use Spryker\Zed\ProductPageSearch\ProductPageSearchDependencyProvider as SprykerProductPageSearchDependencyProvider;

class ProductPageSearchDependencyProvider extends SprykerProductPageSearchDependencyProvider
{
    public const PLUGIN_PRODUCT_LABEL_DATA = 'PLUGIN_PRODUCT_LABEL_DATA';

    /**
     * @return \Spryker\Zed\ProductPageSearch\Dependency\Plugin\ProductPageDataExpanderInterface[]
     */
    protected function getDataExpanderPlugins()
    {
        return [
            ProductListSearchConfig::PLUGIN_PRODUCT_LIST_DATA => new ProductListDataLoadExpanderPlugin(),
        ];
    }

    /**
     * @return \Spryker\Zed\ProductPageSearch\Dependency\Plugin\ProductPageMapExpanderInterface[]
     */
    protected function getMapExpanderPlugins()
    {
        return [
            new ProductListMapExpanderPlugin(),
        ];
    }

    /**
     * @return \Spryker\Zed\ProductPageSearchExtension\Dependency\Plugin\ProductPageDataLoaderPluginInterface[]
     */
    protected function getDataLoaderPlugins()
    {
        return [
            new ProductListDataLoaderPlugin(),
        ];
    }

    /**
     * @return \Spryker\Zed\ProductPageSearchExtension\Dependency\Plugin\ProductConcretePageMapExpanderPluginInterface[]
     */
    protected function getConcreteProductPageMapExpanderPlugins(): array
    {
        return [
            new ProductConcreteProductListPageMapExpanderPlugin(),
        ];
    }

    /**
     * @return \Spryker\Zed\ProductPageSearchExtension\Dependency\Plugin\ProductConcretePageDataExpanderPluginInterface[]
     */
    protected function getProductConcretePageDataExpanderPlugins(): array
    {
        return [
            new ProductConcreteProductListPageDataExpanderPlugin(),
        ];
    }
}

src/Pyz/Zed/Synchronization/SynchronizationDependencyProvider.php

<?php

namespace Pyz\Zed\Synchronization;

use Spryker\Zed\ProductListStorage\Communication\Plugin\Synchronization\ProductAbstractProductListSynchronizationDataPlugin;
use Spryker\Zed\ProductListStorage\Communication\Plugin\Synchronization\ProductConcreteProductListSynchronizationDataPlugin;
use Spryker\Zed\Synchronization\SynchronizationDependencyProvider as SprykerSynchronizationDependencyProvider;

class SynchronizationDependencyProvider extends SprykerSynchronizationDependencyProvider
{
    /**
     * @return \Spryker\Zed\SynchronizationExtension\Dependency\Plugin\SynchronizationDataPluginInterface[]
     */
    protected function getSynchronizationDataPlugins(): array
    {
        return [
            new ProductAbstractProductListSynchronizationDataPlugin(),
            new ProductConcreteProductListSynchronizationDataPlugin(),
        ];
    }
}

Set up publisher trigger plugins

Add the following plugins to your project:

PLUGIN SPECIFICATION PREREQUISITES NAMESPACE
ProductListSearchPublisherTriggerPlugin Allows publishing or republishing product list search data manually. None Spryker\Zed\ProductListSearch\Communication\Plugin\Publisher
ProductListPublisherTriggerPlugin Allows publishing or republishing product list data manually. None Spryker\Zed\ProductListStorage\Communication\Plugin\Publisher

src/Pyz/Zed/Publisher/PublisherDependencyProvider.php

<?php

namespace Pyz\Zed\Publisher;

use Spryker\Zed\ProductListSearch\Communication\Plugin\Publisher\ProductListSearchPublisherTriggerPlugin;
use Spryker\Zed\ProductListStorage\Communication\Plugin\Publisher\ProductListPublisherTriggerPlugin;
use Spryker\Zed\Publisher\PublisherDependencyProvider as SprykerPublisherDependencyProvider;

class PublisherDependencyProvider extends SprykerPublisherDependencyProvider
{
    /**
     * @return array<\Spryker\Zed\PublisherExtension\Dependency\Plugin\PublisherTriggerPluginInterface>
     */
    protected function getPublisherTriggerPlugins(): array
    {
        return [
            new ProductListSearchPublisherTriggerPlugin(),
            new ProductListPublisherTriggerPlugin(),
        ];
    }
}

6) Import product lists

  1. Prepare your data according to your requirements using our demo data:

vendor/spryker/product-list-data-import/data/import/product_list.csv

"product_list_key","name","type"
"pl-001","All computers","whitelist"
"pl-002","No ASUS","blacklist"
"pl-003","All tablets","blacklist"
"pl-004","Cameras, Wearables & Phones","whitelist"
"pl-005","Camcorders over 400€","blacklist"
"pl-006","All cameras","whitelist"
"pl-007","Tablets with enough storage","whitelist"
"pl-008","No Smartwatches","blacklist"
COLUMN REQUIRED DATA TYPE DATA EXAMPLE DATA EXPLANATION
product_list_key string (unique) pl-001 A unique identifier used to identify a product list.
name mandatory string All computers A custom product list name used to provide a readable title or sentence of what the list contains. Used only for internal representation.
type mandatory string (“blacklist”/“whitelist”) whitelist Defines whether the list is a denylist or allowlist.
  1. Register the following plugin to enable data import:
PLUGIN SPECIFICATION PREREQUISITES NAMESPACE
ProductListDataImportPlugin Imports basic product list data into the database. None Spryker\Zed\ProductListDataImport\Communication\Plugin

src/Pyz/Zed/DataImport/DataImportDependencyProvider.php

<?php

namespace Pyz\Zed\DataImport;

use Spryker\Zed\DataImport\DataImportDependencyProvider as SprykerDataImportDependencyProvider;
use Spryker\Zed\ProductListDataImport\Communication\Plugin\ProductListDataImportPlugin;

class DataImportDependencyProvider extends SprykerDataImportDependencyProvider
{
    /**
     * @return array
     */
    protected function getDataImporterPlugins(): array
    {
        return [
            //...
            new ProductListDataImportPlugin(),
        ];
    }
}
  1. Import data:
console data:import product-list
Verification

Make sure that the configured data has been added to the spy_product_listtable in the database.

Import product list category assignments

  1. Prepare your data according to your requirements using our demo data:

vendor/spryker/product-list-data-import/data/import/product_list_to_category.csv

product_list_key,category_key
pl-001,computer
pl-003,tablets
pl-004,cameras-and-camcorder
pl-004,smart-wearables
pl-004,smartphones
pl-008,smartwatches
COLUMN REQUIRED DATA TYPE DATA EXAMPLE DATA EXPLANATION
product_list_key string pl-001 An existing product list identifier for the assignment.
category_key mandatory string computer An existing category identifier to be assigned to the product list.
  1. Register the following plugin to enable data import:
PLUGIN SPECIFICATION PREREQUISITES NAMESPACE
ProductListCategoryDataImportPlugin Imports category assignments for product lists. Product list data and category data must exist before this installer plugin runs. Spryker\Zed\ProductListDataImport\Communication\Plugin

src/Pyz/Zed/DataImport/DataImportDependencyProvider.php

<?php

namespace Pyz\Zed\DataImport;

use Spryker\Zed\DataImport\DataImportDependencyProvider as SprykerDataImportDependencyProvider;
use Spryker\Zed\ProductListDataImport\Communication\Plugin\ProductListCategoryDataImportPlugin;

class DataImportDependencyProvider extends SprykerDataImportDependencyProvider
{
    /**
     * @return array
     */
    protected function getDataImporterPlugins(): array
    {
        return [
            new ProductListCategoryDataImportPlugin(),
        ];
    }
}
  1. Import data:
console data:import product-list-category
Verification

Make sure that the configured data has been added to the spy_product_list_category table in the database.

7) Import product list concrete product assignments

  1. Prepare your data according to your requirements using our demo data:
vendor/spryker/product-list-data-import/data/import/product_list_to_concrete_product.csv
product_list_key,concrete_sku
pl-002,166_30230575
pl-002,166_29565389
pl-002,165_29879507
pl-002,165_29879528
pl-002,099_27207215
pl-002,114_29911081
pl-002,114_30580483
pl-002,139_24699831
pl-002,140_22766487
pl-002,141_29380410
pl-002,142_30943081
pl-002,143_31035196
pl-002,144_29804740
pl-002,144_30312874
pl-002,144_29804741
pl-002,157_29525342
pl-002,158_29885222
pl-002,159_29885260
pl-002,159_29885269
pl-002,160_29533301
pl-002,161_29533300
pl-002,162_29533299
pl-002,163_29728850
pl-002,164_29565390
pl-002,165_29879507
pl-002,165_29879528
pl-002,166_30230575
pl-002,166_29565389
pl-002,215_123
pl-002,215_124
pl-005,204_29851280
pl-005,187_26306352
pl-005,188_26306353
pl-005,194_25904145
pl-005,195_25904159
pl-007,161_29533300
pl-007,177_24867659
pl-007,177_25913296
COLUMN REQUIRED DATA TYPE DATA EXAMPLE DATA EXPLANATION
product_list_key string pl-002 An existing product list identifier for the assignment.
concrete_sku mandatory string 166_30230575 An existing concrete product SKU to assign to the product list.
  1. Register the following plugin to enable data import:
PLUGIN SPECIFICATION PREREQUISITES NAMESPACE
ProductListProductConcreteDataImportPlugin Imports concrete product assignments for product lists. Product list data and concrete product data must exist before this importer plugin runs. vendor/spryker/product-list-data-import/src/Spryker/Zed/ProductListDataImport/Communication/Plugin/ProductListProductConcreteDataImportPlugin.php

src/Pyz/Zed/DataImport/DataImportDependencyProvider.php

<?php

namespace Pyz\Zed\DataImport;

use Spryker\Zed\DataImport\DataImportDependencyProvider as SprykerDataImportDependencyProvider;
use Spryker\Zed\ProductListDataImport\Communication\Plugin\ProductListCategoryDataImportPlugin;

class DataImportDependencyProvider extends SprykerDataImportDependencyProvider
{
    /**
     * @return array
     */
    protected function getDataImporterPlugins(): array
    {
        return [
            new ProductListProductConcreteDataImportPlugin(),
        ];
    }
}
  1. Import data:
console data:import product-list-product-concrete
Verification

Make sure that the configured data has been added to the spy_product_list_product_concrete table in the database.

8) Set up behavior

Set up the following behaviors.

Reading from product storage

Add the following plugins to your project:

PLUGIN SPECIFICATION PREREQUISITES NAMESPACE
ProductAbstractRestrictionPlugin Responsible for determining whether an abstract product is restricted for the current customer or not. None Spryker\Client\ProductListStorage\Plugin\ProductStorageExtension
ProductConcreteRestrictionPlugin Responsible for determining whether a concrete product is restricted for the current customer or not. None Spryker\Client\ProductListStorage\Plugin\ProductStorageExtension
ProductViewVariantRestrictionPlugin Responsible for filtering out product variants of a product view object. The product view object must contain all available variant information.
Suggestion: to collect variant data, use ProductViewVariantExpanderPlugin before .
Spryker\Client\ProductListStorage\Plugin\ProductStorageExtension
ProductAbstractListStorageRestrictionFilterPlugin Responsible for filtering abstract product IDs based on allowlists and denylists. None Spryker\Client\ProductListStorage\Plugin\ProductStorageExtension
ProductConcreteListStorageRestrictionFilterPlugin Responsible for filtering concrete product IDs based on allowlists and denylists. None Spryker\Client\ProductListStorage\Plugin\ProductStorageExtension
src/Pyz/Client/ProductStorage/ProductStorageDependencyProvider.php
<?php

namespace Pyz\Client\ProductStorage;

use Spryker\Client\ProductListStorage\Plugin\ProductStorageExtension\ProductAbstractRestrictionPlugin;
use Spryker\Client\ProductListStorage\Plugin\ProductStorageExtension\ProductConcreteRestrictionPlugin;
use Spryker\Client\ProductListStorage\Plugin\ProductStorageExtension\ProductViewVariantRestrictionPlugin;
use Spryker\Client\ProductStorage\ProductStorageDependencyProvider as SprykerProductStorageDependencyProvider;

class ProductStorageDependencyProvider extends SprykerProductStorageDependencyProvider
{
    /**
     * @return \Spryker\Client\ProductStorage\Dependency\Plugin\ProductViewExpanderPluginInterface[]
     */
    protected function getProductViewExpanderPlugins()
    {
        return [
            new ProductViewVariantRestrictionPlugin(),
        ];
    }

    /**
     * @return \Spryker\Client\ProductStorageExtension\Dependency\Plugin\ProductAbstractRestrictionPluginInterface[]
     */
    protected function getProductAbstractRestrictionPlugins(): array
    {
        return [
            new ProductAbstractRestrictionPlugin(),
        ];
    }

    /**
     * @return \Spryker\Client\ProductStorageExtension\Dependency\Plugin\ProductConcreteRestrictionPluginInterface[]
     */
    protected function getProductConcreteRestrictionPlugins(): array
    {
        return [
            new ProductConcreteRestrictionPlugin(),
        ];
    }

    /**
     * @return \Spryker\Client\ProductStorageExtension\Dependency\Plugin\ProductAbstractRestrictionFilterPluginInterface[]
     */
    protected function getProductAbstractRestrictionFilterPlugins(): array
    {
        return [
            new ProductAbstractListStorageRestrictionFilterPlugin(),
        ];
    }

    /**
     * @return \Spryker\Client\ProductStorageExtension\Dependency\Plugin\ProductConcreteRestrictionFilterPluginInterface[]
     */
    protected function getProductConcreteRestrictionFilterPlugins(): array
    {
        return [
            new ProductConcreteListStorageRestrictionFilterPlugin(),
        ];
    }
}
Verification

Make sure that features that use Redis to read product data—for example, the product details page or product relations—don’t show it when a product is restricted for the customer.

Product restrictions in the cart

Add the following plugins to handle product restrictions for cart items:

PLUGIN SPECIFICATION PREREQUISITES NAMESPACE
ProductListRestrictedItemsPreCheckPlugin Checks all cart items and adds violations to the cart precheck response when they are restricted for the current customer. None Spryker\Zed\ProductList\Communication\Plugin\CartExtension
RemoveRestrictedItemsPreReloadPlugin Checks and removes restricted cart items from the quote and adds a message for each removed item. None Spryker\Zed\ProductList\Communication\Plugin\CartExtension

src/Pyz/Zed/Cart/CartDependencyProvider.php

<?php

namespace Pyz\Zed\Cart;

use Spryker\Zed\Cart\CartDependencyProvider as SprykerCartDependencyProvider;
use Spryker\Zed\Kernel\Container;
use Spryker\Zed\ProductList\Communication\Plugin\CartExtension\ProductListRestrictedItemsPreCheckPlugin;
use Spryker\Zed\ProductList\Communication\Plugin\CartExtension\RemoveRestrictedItemsPreReloadPlugin;

class CartDependencyProvider extends SprykerCartDependencyProvider
{
    /**
     * @param \Spryker\Zed\Kernel\Container $container
     *
     * @return \Spryker\Zed\CartExtension\Dependency\Plugin\CartPreCheckPluginInterface[]
     */
    protected function getCartPreCheckPlugins(Container $container)
    {
        return [
            new ProductListRestrictedItemsPreCheckPlugin(),
        ];
    }

    /**
     * @param \Spryker\Zed\Kernel\Container $container
     *
     * @return \Spryker\Zed\CartExtension\Dependency\Plugin\PreReloadItemsPluginInterface[]
     */
    protected function getPreReloadPlugins(Container $container)
    {
        return [
            new RemoveRestrictedItemsPreReloadPlugin(),
        ];
    }
}
Verification

Make sure that no restricted products can be added to a cart. If they were already in the cart, they get removed properly once a product becomes restricted for the customer.

Info

After completing the integration of this feature, you need to extend it further to provide one or many owner types for product lists to be able to assign them. A product list can only be fully functional when a user, who browses the catalog, gets product lists assigned, and this can be fulfilled by providing owners with product lists.

To add this functionality for merchant relationships, see Install the Merchant Product Restrictions feature.