From the first block to the awkward case: know the positions, create content with Twig and AI, control visibility - and know what to do when a theme gets in the way.
Shopware 6.7 with Storefront, PHP 8.2 or newer. For AI generation you need your own API key with OpenAI, Anthropic, Google or Mistral; billing happens directly there.
Upload the ZIP in the admin under Extensions, install and activate it. Then enter the licence key on the licence screen. The module is reachable through the Plugin Suite and additionally under Settings.
The block appears in the shop straight away. Clearing the cache is usually not necessary.
The 52 positions are grouped into areas. You pick the area first, then the position within it - that keeps the list manageable.
Besides sales channel, device and time window, a block can be limited to individual page types. Without a selection it still appears everywhere, otherwise only on the selected ones.
Every block carries three fields: the content, its own CSS and optionally its own JavaScript. Everything hangs off the block - delete it and the extras go with it.
All three fields accept Twig expressions and Shopware variables. Available at every position are: the product (on the detail page), the context, the sales channel, the currency and the customer.
{{ product.name }} in the content inserts the article name, {{ context.currency.symbol }} the currency symbol. That allows a notice that names the article being viewed.The content is stored per language. A block can read differently in the German channel than in the English one, without maintaining two blocks.
In the block window you describe in one sentence what the block should show. One button, and the AI delivers content, CSS and JavaScript together.
The instruction is stored on the block and shown again the next time you open it. That allows refining instead of rewriting from scratch every time.
Images as a template: up to four images can be attached - a draft, a screenshot of the look you want, or an example from another site. The AI rebuilds the block from them.Normally the block is inserted at its position while the page is being built. That is the clean route and the default.
Some themes replace the same Twig blocks this plugin uses. The content would then never arrive. For that case a second output mode places the block by script instead.
The block list filters by area and shows 25 entries per page. Multi-select allows activating, deactivating or deleting several blocks together.
Deactivating takes the block out of the shop without losing it - useful for campaigns that return later.
Questions and requests come straight to us - support is from the developer, not from a queue. You can also request a feature through the Plugin Suite in the admin.
Every setting of the plugin with its default value and explanation, in the same order as in the administration. The texts come straight from the plugin (version 1.33.1).
Defines which sales channel the settings apply to. Without a selection they apply to all.
All further settings on this page apply to the channel selected here.
Determines how the blocks reach the page.
Through the templates is the default. If a theme replaces the same Twig blocks, the script output can help.
Store provider, key and model here. If no key is set, the plugin falls back to the credentials of the AI product advisor.
Which company supplies the language model. The choice determines the available models.
The access key of the provider. It is stored encrypted and never output in the storefront.
The language model in use. Smaller models answer faster, larger ones write more carefully.
Sends a short request to the provider and reports whether access and model are correct.
Saves all blocks to a file and reads them back in another shop.
On import the blocks are created anew, existing ones remain unchanged.
A block without a sales channel applies to all shops. A block with a sales channel replaces the general block at the same position. Product custom fields exist only for blocks on the detail page.
Internal name of the block for the overview. It only helps to find your way around the block list.
A block without a sales channel applies to all shops. A block with a sales channel replaces the general block at the same position. Product custom fields exist only for blocks on the detail page.
The area of the page where the block appears: free position with its own CSS selector, design (CSS), head and scripts, detail page, header, footer, category, search results, wishlist, customer account, cart and checkout, or content area. It determines which positions are available.
The exact spot within the area, on the detail page for example above the price, below the add-to-cart button or at the end of the description. The list depends on the chosen area.
The block is attached to the first matching element in the browser. Example: .product-detail-buy or #myArea
Where the block goes relative to the matched element: before, after, at the start inside or at the end inside. Only with a custom CSS selector.
Order when several blocks share the same position. The lower number is output first.
By default the blocks are rendered through the templates. If a theme replaces the same Twig blocks without parent(), they will not appear. In that case choose the script output, which places them at fixed anchor points in the browser.
Switches the block on or off. Inactive blocks stay stored but do not appear in the shop.
Defines whether the block runs on all products or only where it was switched on for the product.
Shows or hides the block depending on screen width. Mobile up to 767 pixels, tablet up to 991 pixels, desktop above.
Without a selection the block appears on all pages. Otherwise only on the selected ones.
The block runs on all products. Products assigned here can get different content or be switched off. The block only runs on products assigned here or matching the product group or category.
Several languages possible. Content is written for all selected ones, the highlighted chip marks the language being edited.
May stay empty if only CSS or JavaScript is needed. Twig is allowed. Always available are context, salesChannel, currency and customer, on the detail page also product, in the page areas page.
In the styling area the CSS applies to the whole page, otherwise with the block. The HTML field may stay empty, then only the CSS applies, for example to hide existing elements. Selector for this block:
Runs right after the block. Only the code, the plugin adds the script tag. A complete tag with src is taken as is.
Leave empty for permanent display. With page caching enabled the change may appear slightly delayed.
Leave empty for permanent display. With page caching enabled the change may appear slightly delayed.
Twig expressions are filled with sample values here. The shop shows the real data.
All prices net, plus VAT.
You buy the licence directly from us and receive an invoice from us. Installation by upload in the admin without SSH, updates through our licence platform, support straight from the developer.
The plugin will be listed in the official Shopware Community Store. Installation and automatic updates then run through the plugin manager in the backend, billing through your Shopware account. We will link it here as soon as it is available.