All settings
All 42 fields with their defaults, whether they are required and what they do.
All settings of an item
Tab by tab, field by field, with the names from the administration. Green shows the value a field has when you create an item, red what must be filled in to save.
Basic Data tab
General card
- Internal name
Only for you, so you can find the item in the list again.
Appears only in the administration, never in the shop. The name the customer sees is the title.
required
- Active
Switches the item on or off.
An inactive item stays saved but never enters a cart.
Default: on
- Product type
Pseudo product or Shopware product.
A pseudo product is maintained entirely in the item. A Shopware product comes from the catalogue, with the product's name, image and price. Depending on the choice, the Pseudo Product or the Shopware Product tab is active.
Default: Pseudo product
- Position
The order in the cart, ascending.
Lower numbers enter the cart first. Because every item is added before the next one, the number also decides what a percentage surcharge is calculated on.
Default: 1
- Maximum purchase quantity
How often a customer gets the item in total, summed over all quantities.
The quantity in the cart is cut to what is left. Once nothing is left, the item no longer enters the cart.
Default: 1
- Maximum purchase per customer
Switches on the limit based on previous orders.
The plugin looks up the customer's previous orders by the item's product number. Cancelled orders do not count. Guests and customers who are not logged in have no history; for them the limit applies to the current cart.
Default: off
Display for customers card
- Display for customers
Whether the customer sees the item while ordering.
Visible: as usual. Hide during checkout: the item is part of the cart and counts for rules, weight and shipping costs; the cart and the checkout do not show it, the finish page and the confirmation mail do. Add only when the order is placed: the item is only added with the order and is also missing on the finish page and in the confirmation mail. Afterwards it appears in the order, on the delivery note and the invoice in both cases. Hiding is only possible for free items.
Default: Visible
- Removable
Whether the customer may remove the item from the cart.
The line gets a cross. Once removed it stays away for the session, even if the cart changes afterwards. If the item is hidden, Removable is locked.
Default: off
Rules card
- Rule
The rule from the Rule Builder that decides.
If the rule applies to the customer and the cart, the item is added. Once it no longer applies, the item disappears at the next recalculation of the cart.
required
- Sales channels
The channels in which the item applies.
At least one sales channel. In all others the item does not exist, whatever the rule says.
required
Pseudo Product tab
Pseudo product card
- Title
The name in the checkout.
This is how the line reads in the cart, in the order and on the invoice. Translatable like any other text.
required
- Number
The number in the checkout.
The maximum purchase finds previous orders by this number. Changing the number starts the count from scratch.
required
- Display
Whether the product number is shown.
Shows or hides the number in the checkout.
Default: off
- Delivery time
A delivery time of its own for the item.
One of the delivery times from Shopware, shown on the line in the checkout.
- Hide delivery time
Shows no delivery time at all.
Hides the information on this line.
Default: off
- Icon
One of 18 symbols if no image is set.
The symbol appears in the cart instead of a product image.
Default: Arrow - right
- Media
An image from the media library.
If the item has an image, the cart shows the image instead of the symbol.
Surcharge/discount card
- Type of surcharge/discount
Absolute or percental.
Absolute is a fixed amount such as €10.00, percental a share of the cart such as 10%.
Default: Percental
- Surcharge/discount (gross)
The amount including tax. With Percental there is one field for the percentage instead.
A negative amount turns the surcharge into a discount; 0 makes the item free of charge.
- Surcharge/discount (net)
The amount excluding tax.
Gross and net are linked through the tax rate, as with any price in Shopware.
- Tax rate
Required for an absolute amount.
With Percental the field is locked: the tax is then split proportionally across the tax rates in the cart.
required for Absolute
Shopware Product tab
- Product
The catalogue product that goes into the cart.
A variant can be chosen too. On ordering it becomes a real product line, and the stock goes down as with any other product.
required
- Product free of charge
Free of charge or at the product's regular price.
Off means: the product carries its standard price.
Default: off
- Product name
The name in the checkout, with Twig.
The Twig variable "product" is available. Unchanged, the field holds the translated product name.
Default: {{ product.translated.name }}
- Product number
The number in the checkout, with Twig.
Unchanged, the field holds the product's own number.
Default: {{ product.productNumber }}
Quantity tab
- Link quantity to products
The quantity follows certain products in the cart.
Not for a percental pseudo product: that one is always added exactly once. If the rule applies, the item is in the cart at least once, even without a matching product.
Default: off
- Products
Individual products that count.
Variants count through their parent product.
- Multiplier
Per piece or per position.
Per piece counts the quantity of the matching products, per position the number of matching cart lines.
Default: Per piece
- Dynamic product groups
All products of these groups count.
Handy for ranges that change, such as all bulky goods.
- Tags
All products with these tags count.
Counting uses the tags of the products in the cart.
Cart Note tab
- Activate note
A message in the cart, including the off-canvas cart.
Appears above the products as soon as the item is in the cart.
Default: off
- Type
Success, note, warning or danger.
Green, blue, yellow or red, in the style of the shop's other messages.
Default: Success (green)
- Display
Once or always.
Once means: once per session. After that the message is not shown again, even when the customer opens the cart again.
Default: Once
- Message
The text of the message.
Without text no message appears. Emphasis such as bold is shown by the shop.
Product Note tab
- Activate note
A message on the product page.
Appears in the buy box of the products you select below.
Default: off
- Products
The products it appears on.
Variants can be chosen too.
- Only display when rule is valid
Only when the rule currently applies.
The product page is cached by Shopware. The option therefore suits general conditions such as customer group or date. Conditions tied to the displayed product may not yet be met on the first visit.
Default: off
- Dynamic product groups
On all products of these groups.
The message follows the group as its products change.
- Tags
On all products with these tags.
The message follows the products' tags.
- Type
Success, note, warning or danger.
Green, blue, yellow or red.
Default: Success (green)
- Display
Above the price, above the cart button or below it.
Three fixed places in the buy box.
Default: Above the price
- Message
The text of the message.
As with the cart note: emphasis such as bold is shown by the shop.
The 18 symbols
Available in the Icon field for items without an image. The names are as shown in the selection list.
- Icon
- Cart
- Cart and product
- Warning
- Alert
- Trophy
- Star
- Plus symbol
- Plus symbol - block
- Plus symbol - circle
- Plus symbol - wide
- Checkmark
- Checkmark - block
- Checkmark - circle
- Checkmark - wide
- Arrow - down
- Arrow - left
- Arrow - right
- Arrow - up
Plugin configuration
- Activate plugin
Should the plugin be enabled for this sales channel? If the switch is off, the plugin adds nothing to the cart there.
Default: on
The chapters.
Cart processing
When the plugin calculates, in which order and with what.
Orders and invoices
What becomes of the items in the order, on the invoice and in stock.
Glossary
What the words on this site mean.