Surcharges & discounts

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

Active

Switches the item on or off.

An inactive item stays saved but never enters a cart.

Default: on

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

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

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

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.

Default: off

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

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

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.

  • 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.