From installation to diagnosis: set the tag, adapt the notice text, cover the special cases and find out why a notice is missing when in doubt.
Shopware 6.7 with Storefront, PHP 8.2 or newer. No theme build is required; installation runs by upload in the admin without SSH.
Upload the ZIP in the admin under Extensions, My Extensions, Upload extension, then install and activate it.
Afterwards enter the licence key in the General section. Without a valid key the remaining settings stay hidden and no notice appears in the shop.
First: open the image in the media manager and set the tag. The default is "KI".
Second: nothing. The image carries the notice wherever it is output in the shop.
In the General section you decide which tag counts as the label. The picker lists every tag present in the media manager, with a search field.
If the tag you want does not exist yet, it can be entered as free text. It takes effect as soon as it is set on an image in the media manager.
The text lives as a snippet named stawKiImageBadge.label. The defaults are "KI generiert" in German and "AI generated" in English.
Changes are possible in two places: under Settings, Snippets per language, or directly in the plugin through its own text field. The entry in the plugin takes precedence.
Covered without further action are product listings, detail pages, galleries, sliders, product sliders and image elements in shopping experiences. All of these output paths run through the central Shopware image output.
Two special cases have their own switches. The first covers images sitting as raw HTML in a product description or a text element; they are matched by filename. The second is a safety net for images a theme outputs itself, for example from a custom field on a category.
The notice is aligned to the image, not to the surrounding box. The offset between the two is measured and subtracted, border widths included. Notices on images side by side therefore sit at the same height.
Repositioning happens when the image loads, when the window is resized, and when the image itself changes size where the browser provides a resize observer.
If several images share one container, each gets its own notice.
The notice can be switched on or off separately per sales channel. That is useful when you run several brands and do not want to handle labelling the same way everywhere.
The diagnosis takes the channel selected above into account, so it checks exactly the combination you are looking at.
The check button answers the most common questions in one go: does the tag exist at all, how many images carry it, is the notice effective in the selected sales channel, has the configuration ever been saved.
On top come up to five example files and a list of similarly spelled tags with image counts. That immediately reveals cases where the tag in the media manager reads "KI-generiert" instead of "KI".
Since version 1.1.0 the diagnosis also states the licence status in plain words.
The check is deliberately strict: without a valid, active key matching the domain, no notice appears in the shop. This rules out an expired licence quietly continuing to work.
If the licence server is unreachable, a grace period of three days from the last valid check applies. The result is cached for six hours, so no network call happens per page view.
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.2.0).
Activation and the tag that marks an image as AI generated.
Shows or hides the notice on images marked as AI images in the shop.
The licence key from your Stone & Water customer account. Without a valid licence the shop shows no notice.
Only change if instructed by Stone & Water. Empty = default server.
Images in the media library that carry this tag get the notice in the shop. List of existing tags from the media library. Free input in case the tag does not exist yet. Default: KI
Additionally covers images inserted into the text element of a shopping experience or into the product description. Those do not go through the Shopware image output and are matched by file name.
Safety net for images rendered directly by a theme or another plugin, for example media from category custom fields. The tagged files of the requested page are handed to the storefront and matched there.
The text comes from a snippet and can be overridden here.
Empty = the text comes from the snippet and can be maintained per language under Settings, Snippets:
Position, style and size of the badge in the storefront.
Which corner of the image the notice sits in: bottom right, bottom left, top right or top left.
Look of the notice: dark or light with transparency, in the accent colour, or outline only.
Font size of the notice text in pixels. Allowed range: 8 to 24.
Opacity of the notice in percent. Lower values let more of the image show through. Allowed range: 10 to 100.
Rounding of the notice's corners in pixels. Allowed range: 0 to 24.
Distance of the notice from the image edge in pixels. Allowed range: 0 to 40.
Smaller images, for example in the cart or in search, stay without a badge. 0 = always show. Allowed range: 0 to 2000.
Shows a small sparkle icon in front of the notice text.
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.