Product Lists feature integration
Edit on GitHubThis 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 | 202404.0 | Install the Spryker Core feature |
Product | 202404.0 | Install the Product feature |
Category Management | 202404.0 | Install the Category Management feature |
1) Install the required modules
composer require spryker-feature/product-lists:"202404.0" --update-with-dependencies
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
- 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>
- 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>
- 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>
- Apply database changes and generate entity and transfer changes:
console propel:install
console transfer:generate
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) Add translations
- 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
- Import data:
console data:import glossary
Make sure that the configured data has been added to the spy_glossary
table in the database.
4) 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;
}
}
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 (see the preceding one). |
Spryker\Zed\ProductListSearch\Communication\Plugin\ProductPageSearch\DataExpander |
ProductListMapExpanderPlugin | Maps product list data to 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 database to Redis. | None | Spryker\Zed\ProductListStorage\Communication\Plugin\Synchronization |
ProductConcreteProductListSynchronizationDataPlugin | Can be executed to synchronize all product_concrete_product_list entries from 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 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(),
];
}
}
4) Import product lists
- 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. |
- 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(),
];
}
}
- Import data:
console data:import product-list
Make sure that the configured data has been added to the spy_product_list
table in the database.
Import product list category assignments
Import product list category assignments:
- 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. |
- 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(),
];
}
}
- Import data:
console data:import product-list-category
Make sure that the configured data has been added to the spy_product_list_category
table in the database.
5) Import product list concrete product assignments
- 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. |
- 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(),
];
}
}
- Import data:
console data:import product-list-product-concrete
Make sure that the configured data has been added to the spy_product_list_product_concrete
table in the database.
6) 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(),
];
}
}
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(),
];
}
}
Make sure that no restricted products can be added to a cart, and if they were already in the cart, they get removed properly once a product becomes restricted for the customer.
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.
Thank you!
For submitting the form