- Staged matching: the deepest categories are now taken from the navigation of the current sales channel, and the parent category stages stop below the sales channel's navigation entry. In shops whose navigation entry is not the root category, two or three parent levels could otherwise reach the whole catalogue
- Staged matching: within a product family the configured main variant is shown first, then a variant that is available, instead of an arbitrary matching variant
- New: staged matching "Staged: own category, then parent categories". The similar products are filled from the product's own category first and only then from its parent categories, comparing the property groups selected manually, for example a base colour. Each product family appears once, shown in the variant that carries the matching values
- The staged matching examines a fixed number of the newest products per category and step (default 150), read straight from Shopware's category index, so large categories stay fast
- Fix: property based matching now also takes the variant options of the current product into account, so the colour of a variant counts
- Fix: "All properties must match" now requires every selected property group to match. Before, it connected the match through variant options with the match through properties and often found nothing
- Property based similar products are now matched through Shopware's indexed property and option associations instead of the property_ids and option_ids JSON columns, which could not use an index either
- Similar products by category are now looked up through Shopware's indexed product_category_tree table instead of the category_tree JSON column. The previous query could not use an index and scanned the whole product table, which was noticeable in large catalogues and especially with random selection enabled
- Added a setting to exclude a product's own sibling variants from its similar products, for example the same shirt in other colours. Sibling variants keep appearing by default, as before. The product itself and the main product of its family always stay excluded
- Fixed: a product's own variants no longer appear in its similar products, in the category based and property based mode alike
- Added a selection between category based and property based similar products
- The automatic property mode uses all property groups that are marked as filterable in Shopware, so no property groups have to be maintained by hand
- A manually maintained property group selection still wins over the automatic mode
- Fixed: if the property based search does not find any matching products, similar products are now determined by category instead of leaving the block empty
- Added "Customers also bought": products that were ordered together with the current product, based on your own order data. Cancelled orders are ignored, every sales channel is evaluated separately and the analysed timeframe is configurable
- Added "Recently viewed": the products a visitor opened before. The history is kept in the session and loaded through a separate request, so the product detail page stays cacheable
- Both new blocks can be switched on and off separately and reuse the existing layout settings
- Added the selection method "alsoBought" to the SimilarProductsCriteriaEvent
- Fixed: the plugin configuration is now read per sales channel, so every sales channel can use its own settings
- Fixed: all selected property groups are now taken into account, previously only the last one was used
- Changed: the default minimal width of the product boxes is now 300px, matching the Shopware product slider
- Improved: the database queries are fully parameterised and parent categories are loaded in one query instead of one per category
- Improved: the settings are grouped into separate cards
- Added "Customers also bought": products that were ordered together with the current product, based on your own order data. Cancelled orders are ignored, every sales channel is evaluated separately and the analysed timeframe is configurable
- Added "Recently viewed": the products a visitor opened before. The history is kept in the session and loaded through a separate request, so the product detail page stays cacheable
- Both new blocks can be switched on and off separately and reuse the existing layout settings
- Added the selection method "alsoBought" to the SimilarProductsCriteriaEvent
- Fixed: the plugin configuration is now read per sales channel, so every sales channel can use its own settings
- Fixed: all selected property groups are now taken into account, previously only the last one was used
- Changed: the default minimal width of the product boxes is now 300px, matching the Shopware product slider
- Improved: the database queries are fully parameterised and parent categories are loaded in one query instead of one per category
- Improved: the settings are grouped into separate cards
Improved similar results
Adjusted plugin configuration view
New Plugin Configuration
Navigation arrows position
With this setting, you can control whether the navigation arrows are displayed outside or inside the slider.
Show navigation dots (only slider)
With this setting, the navigation dots (pagination indicators) can be enabled or disabled.
Under certain circumstances, the latest adjustment in version 4.2.3 could cause a 500 error. This has now been fixed.
New Plugin Configuration
Automatically display cross-selling (default: enabled)
This setting allows you to disable the automatic display of cross-selling. This makes sense if you only want to integrate cross-selling selectively using the included CMS block in specific layouts.
Style Adjustment
With this update, the custom style margin-left: -20px has been removed from .cms-element-title, as it caused display issues.
In the plugin configuration, there is a fallback option that re-applies this style in case your shop styles were previously adjusted to rely on it.
Bugfix (cache rework)
Revised code to allow caching for similar products.
New: Setting to only show products of the same manufacturer as similar products.
SimilarProductsCriteriaEvent can now be used to adjust the criteria.
Compatibility with Shopware 6.7
- Staged matching: the deepest categories are now taken from the navigation of the current sales channel, and the parent category stages stop below the sales channel's navigation entry. In shops whose navigation entry is not the root category, two or three parent levels could otherwise reach the whole catalogue
- Staged matching: within a product family the configured main variant is shown first, then a variant that is available, instead of an arbitrary matching variant
- New: staged matching "Staged: own category, then parent categories". The similar products are filled from the product's own category first and only then from its parent categories, comparing the property groups selected manually, for example a base colour. Each product family appears once, shown in the variant that carries the matching values
- The staged matching examines a fixed number of the newest products per category and step (default 150), read straight from Shopware's category index, so large categories stay fast
- Fix: property based matching now also takes the variant options of the current product into account, so the colour of a variant counts
- Fix: "All properties must match" now requires every selected property group to match. Before, it connected the match through variant options with the match through properties and often found nothing
- Property based similar products are now matched through Shopware's indexed property and option associations instead of the property_ids and option_ids JSON columns, which could not use an index either
- Similar products by category are now looked up through Shopware's indexed product_category_tree table instead of the category_tree JSON column. The previous query could not use an index and scanned the whole product table, which was noticeable in large catalogues and especially with random selection enabled
- Added a setting to exclude a product's own sibling variants from its similar products, for example the same shirt in other colours. Sibling variants keep appearing by default, as before. The product itself and the main product of its family always stay excluded
- Fixed: a product's own variants no longer appear in its similar products, in the category based and property based mode alike
- Added a selection between category based and property based similar products
- The automatic property mode uses all property groups that are marked as filterable in Shopware, so no property groups have to be maintained by hand
- A manually maintained property group selection still wins over the automatic mode
- Fixed: if the property based search does not find any matching products, similar products are now determined by category instead of leaving the block empty
- Added "Customers also bought": products that were ordered together with the current product, based on your own order data. Cancelled orders are ignored, every sales channel is evaluated separately and the analysed timeframe is configurable
- Added "Recently viewed": the products a visitor opened before. The history is kept in the session and loaded through a separate request, so the product detail page stays cacheable
- Both new blocks can be switched on and off separately and reuse the existing layout settings
- Added the selection method "alsoBought" to the SimilarProductsCriteriaEvent
- Fixed: the plugin configuration is now read per sales channel, so every sales channel can use its own settings
- Added "Customers also bought": products that were ordered together with the current product, based on your own order data. Cancelled orders are ignored, every sales channel is evaluated separately and the analysed timeframe is configurable
- Added "Recently viewed": the products a visitor opened before. The history is kept in the session and loaded through a separate request, so the product detail page stays cacheable
- Both new blocks can be switched on and off separately and reuse the existing layout settings
- Added the selection method "alsoBought" to the SimilarProductsCriteriaEvent
- Fixed: the plugin configuration is now read per sales channel, so every sales channel can use its own settings
New Plugin Configuration
Automatically display cross-selling (default: enabled)
This setting allows you to disable the automatic display of cross-selling. This makes sense if you only want to integrate cross-selling selectively using the included CMS block in specific layouts.
Navigation arrows position
With this setting, you can control whether the navigation arrows are displayed outside or inside the slider.
Show navigation dots (only slider)
With this setting, the navigation dots (pagination indicators) can be enabled or disabled.
Style Adjustment
With this update, the custom style margin-left: -20px has been removed from .cms-element-title, as it caused display issues.
In the plugin configuration, there is a fallback option that re-applies this style in case your shop styles were previously adjusted to rely on it.
Revised code to allow caching for similar products.
Adjust sorting of the plugin configuration
New: Setting to only show products of the same manufacturer as similar products.
SimilarProductsCriteriaEvent can now be used to adjust the criteria.
New function 'Show only one variant' allows filtering the display of variants in the similar products listing by a specific property group, so that only one variant per manifestation of the selected property is displayed per product.
- Fix bug when produts without categories got pulled into result
- Enhanced code quality
- Fix storefront display bugs
For all existing users, please check the new plugin configuration and do adjustments if needed.
Fix:
- missing CMS block element is available in Shopping Experience Layouts again
Compatibility with Shopware 6.6
Fix save error on cms pages
New: Select similiar products based on matching properties
The headline "Similar products" can now be displayed as title instead of a tab title (check layout options).
Saving error occurring since Shopware version 6.5.4.0 was fixed.
CMS-Block "Similar products":
Removes the empty field below the "Similar products" CMS-Block.
Compatibility with Shopware 6.5
New functions:
- Only show main variants
- Display variants by storefront representation settings (set in the variant tab of the main variant)
Compatibility with other 3rd party plugins
New: Select similiar products based on matching properties
The headline "Similar products" can now be displayed as title instead of a tab title (check layout options).
CMS-Block "Similar products":
Removes the empty field below the "Similar products" CMS-Block.
New functions:
- Only show main variants
- Display variants by storefront presentation settings (set in the variant tab of the main variant)
Removed div wrapper with class cms-element-product-listing-wrapper from the cms-element to fix javascript error thrown by wishlist.
Removed div wrapper with class cms-element-product-listing-wrapper to fix javascript error thrown by wishlist.
Compatibility with Shopware 6.4.10.0 and higher.
New option "Don't show sold out products" to not show products in listing that are out of stock.
Similar products is now available as cms block to allow showing similar products on custom product detail layouts.
The cms block can be found in the commerce category.
New option: Don't show in full width
If the similar products are unwillingly diplayed on full width, this option will change the similar products mode to block view.
Changed requirement settings in composer.json
Compatible with Shopware 6.4
Fix error if no category was supplied.
Compatible with Shopware 6.3.5.4
The current product is not shown in the similar product listing anymore.
Only compatible with Shopware version 6.3 and newer
Listing multiple variants of a product is now controlled by the "Storefront presentation" settings.
Shopware