Compatibility catalogues
A compatibility catalogue records what the products fit: a car’s make, model and year, a printer’s series and model, a machine and its serial range. The shopper chooses an object step by step, and the shop shows the products that fit it. The catalogue belongs to the shop, not to an industry: its levels, their names and the shop’s texts are set per catalogue.
Typical catalogues:
| Catalogue | Levels |
|---|---|
| Vehicles | Make › Model › Version, then the year |
| Printers and cartridges | Brand › Series › Model |
| Spare parts for machines | Manufacturer › Machine, then the power in kW |
Every catalogue is managed under Filters → Compatibility → Catalogues.
Levels
Section titled “Levels”A catalogue has two kinds of levels, set on the Levels tab:
- a tree level holds the catalogue’s nodes (make, model, version). The levels follow one another in the order of the list; each node belongs to one tree level;
- a number level narrows the choice by one value the shopper’s object has (a year, a power, a size). A catalogue has at most three number levels. Precision sets how the value reads (Year, Month and year, Whole number, Decimal), Unit what it counts in.
Each level has a Name in every language, a Look for the shop (a tree level: List, Tiles, Logos, Options; a number level: List, Slider, Number field) and the Required switch: a required level makes the shop wait for a choice there before it shows the products.
A level’s Key is fixed once the catalogue is saved; imports and the nodes name the level by it.
The tree of nodes
Section titled “The tree of nodes”The Tree tab shows the nodes level by level, in columns. A node has a name, an optional URL name and text, and Other names: further names the shop’s search knows it by (for example “Golf 5” for “Golf V”). The nodes are moved by dragging, as in the core’s category tree.
The top node of the tree is the catalogue’s own. A product fitted to it is universal: it fits every object of the catalogue.
A fit says that a product fits one node, optionally only within a range of each number level (“2008–2012”) and with a condition (“only with the sport package”).
- Catalogues → Products → select product → Compatibility tab: the fits of one product. A variant without fits of its own takes its parent’s.
- Filters → Compatibility → Fits: the fits of every product, filtered and changed in bulk (delete, move to another node, change the ranges).
A fit to a node also counts for the nodes under it: a product fitted to a model fits each version of that model.
Import and export
Section titled “Import and export”Filters → Compatibility → Import and export imports and exports nodes and fits through Shopware’s own import and export, with two profiles: Compatibility: nodes and Compatibility: fits. The page lists the columns of both files and each catalogue’s range columns (range_1, range_2, range_3, in the order of its number levels).
- A node is found by its id, its external id or its path of names (
BMW>3 Series>E90). - A product is found by its product number;
*instead of a node fits the product to the whole catalogue (universal). - A range reads
2005-2011,2005-or-2011; a month and year as03/2005. - With Fits make the nodes they name on the catalogue’s General tab, a fit whose path names a node the tree lacks creates it; without it such a row is left out with its reason.
A file exported and imported again changes nothing: the rows are recognised and updated, not added twice.
The Texts tab holds the catalogue’s own words for the shop in each language, for example the line over the products or the product page’s badges. An empty field uses the shop’s standard text. %name% stands for the shopper’s choice or a node’s way, %note% for a fit’s condition, %catalog% for the catalogue and %count% for the products that fit.