Changeset 3705284

oznaczai-image-labeling/tags/1.7.0/assets/css/admin.css

-              r3641997
+              r3705284
+}
+/* Image symbol variants inside the admin previews. Mirrors the frontend rule so
+   the preview keeps its WYSIWYG promise. */
+.oznaczai-preset-demo b.oznaczai-preview-symbol--image,
+.oznaczai-preview-badge b.oznaczai-preview-symbol--image,
+.oznaczai-symbol-preview b.oznaczai-preview-symbol--image {
+        min-width: 0;
+        width: calc(18px * var(--oznaczai-preview-icon-ratio, 1));
+        height: 18px;
+        border-radius: 0;
+        background-color: transparent;
+        background-image: var(--oznaczai-preview-icon-on-light);
+        background-repeat: no-repeat;
+        background-position: center;
+        background-size: contain;
+        font-size: 0;
+}
+.oznaczai-preview-badge--minimal b.oznaczai-preview-symbol--image,
+.oznaczai-preview-badge--dark b.oznaczai-preview-symbol--image,
+.oznaczai-preview-badge--contrast-light b.oznaczai-preview-symbol--image {
+        background-image: var(--oznaczai-preview-icon-on-dark);
+}
 .oznaczai-preview-badge--icon-only {
         width: 24px;
 …
         border-top: 1px solid #e4e8ef;
         align-items: start;
+}
+.oznaczai-shortcode {
+        display: inline-block;
+        padding: 4px 8px;
+        border: 1px solid #e4e8ef;
+        border-radius: 4px;
+        background: #f6f7f9;
+        font-size: 12px;
+}
+.oznaczai-symbol-row {
+        display: grid;
+        grid-template-columns: minmax(0, 280px) minmax(0, 1fr);
+        gap: 12px 24px;
+        align-items: start;
+        margin-top: 18px;
+        padding-top: 16px;
+        border-top: 1px solid #e4e8ef;
+}
+.oznaczai-symbol-row > .description {
+        margin: 0;
+        align-self: center;
+        color: #6b7280;
+        font-size: 12px;
+        line-height: 1.5;
+}
+.oznaczai-symbol-row > .oznaczai-toggle {
+        grid-column: 1 / -1;
+}
+@media (max-width: 782px) {
+        .oznaczai-symbol-row {
+                grid-template-columns: minmax(0, 1fr);
+        }
+}

oznaczai-image-labeling/tags/1.7.0/assets/css/frontend.css

-              r3641997
+              r3705284
+}
+/* AI transparency legend ([oznaczai_transparency_legend]).
+   Deliberately plain: it inherits the theme's typography and colours so it
+   reads as part of the page rather than as a plugin widget. */
+.oznaczai-legend {
+        margin: 0 0 1.5em;
+}
+.oznaczai-legend__title {
+        margin: 0 0 0.75em;
+        font-size: 1.15em;
+}
+.oznaczai-legend__list {
+        margin: 0;
+        padding: 0;
+        list-style: none;
+}
+.oznaczai-legend__item {
+        display: flex;
+        align-items: flex-start;
+        gap: 0.75em;
+        padding: 0.6em 0;
+        border-bottom: 1px solid rgba(127, 127, 127, 0.22);
+}
+.oznaczai-legend__item:last-child {
+        border-bottom: 0;
+}
+.oznaczai-legend__symbol {
+        display: inline-flex;
+        align-items: center;
+        justify-content: center;
+        flex: 0 0 auto;
+        width: 20px;
+        height: 20px;
+        margin-top: 0.15em;
+        border-radius: 3px;
+        background: rgba(127, 127, 127, 0.16);
+        font-size: 9px;
+        font-weight: 600;
+        line-height: 1;
+}
+.oznaczai-legend__symbol--image {
+        width: auto;
+        max-width: 100%;
+        border-radius: 0;
+        background: none;
+}
+.oznaczai-legend__body {
+        display: flex;
+        flex-direction: column;
+        gap: 0.15em;
+        min-width: 0;
+}
+.oznaczai-legend__name {
+        font-weight: 600;
+}
+.oznaczai-legend__description {
+        opacity: 0.85;
+}
+.oznaczai-legend__note {
+        margin: 0.9em 0 0;
+        font-size: 0.875em;
+        opacity: 0.75;
+}
+/* Image symbol variants (official EU icons).
+   The artwork is a fixed two-tone drawing, so it is placed as an image rather
+   than recoloured. The white artwork is the default because the default preset
+   draws a light label on a dark translucent surface; the black artwork is used
+   wherever the label sits on a light surface. */
+.oznaczai-badge__icon--image {
+        width: calc(var(--oznaczai-icon-size, 13px) * var(--oznaczai-icon-ratio, 1));
+        height: var(--oznaczai-icon-size, 13px);
+        border-radius: 0;
+        background-color: transparent;
+        background-image: var(--oznaczai-icon-on-dark);
+        background-repeat: no-repeat;
+        background-position: center;
+        background-size: contain;
+        font-size: 0;
+}
+.oznaczai-badge--light .oznaczai-badge__icon--image,
+.oznaczai-badge--glass .oznaczai-badge__icon--image,
+.oznaczai-badge--caption .oznaczai-badge__icon--image,
+.oznaczai-badge--icon-only .oznaczai-badge__icon--image,
+.oznaczai-badge--contrast-dark .oznaczai-badge__icon--image,
+.oznaczai-bg-note.oznaczai-badge--contrast-dark .oznaczai-badge__icon--image {
+        background-color: transparent;
+        background-image: var(--oznaczai-icon-on-light);
+}
+.oznaczai-badge--contrast-light .oznaczai-badge__icon--image,
+.oznaczai-bg-note.oznaczai-badge--contrast-light .oznaczai-badge__icon--image {
+        background-color: transparent;
+        background-image: var(--oznaczai-icon-on-dark);
+}
+/* When the symbol already spells out its own meaning there is no text node to
+   space away from it. */
+.oznaczai-badge--symbol-lockup {
+        gap: 0;
+}
 .oznaczai-badge__text {
         min-width: 0;

oznaczai-image-labeling/tags/1.7.0/assets/js/admin.js

-              r3641997
+              r3705284
+                }
+                function renderBadge(element, template, label, forceIcon) {
+                function escapeAttribute(value) {
+                        return escapeText(value).replace(/"/g, '&quot;');
+                }
+                function activeSymbol(status) {
+                        var variants = window.oznaczaiImageLabelingAdmin && window.oznaczaiImageLabelingAdmin.iconVariants
+                                ? window.oznaczaiImageLabelingAdmin.iconVariants
+                                : {};
+                        var variant = variants[fieldValue('icon_variant', 'oznaczai')] || variants.oznaczai;
+                        if (!variant || !variant.symbols) {
+                                return null;
+                        }
+                        return variant.symbols[status] || variant.symbols.generated || null;
+                }
+                function symbolMarkup(status) {
+                        var symbol = activeSymbol(status);
+                        if (symbol && symbol.onLight && symbol.onDark) {
+                                return '<b aria-hidden="true" class="oznaczai-preview-symbol--image" style="' +
+                                        '--oznaczai-preview-icon-on-light:url(&quot;' + escapeAttribute(symbol.onLight) + '&quot;);' +
+                                        '--oznaczai-preview-icon-on-dark:url(&quot;' + escapeAttribute(symbol.onDark) + '&quot;);' +
+                                        '--oznaczai-preview-icon-ratio:' + (parseFloat(symbol.ratio) || 1) + '"></b>';
+                        }
+                        return '<b aria-hidden="true">' + escapeText(symbol && symbol.text ? symbol.text : 'AI') + '</b>';
+                }
+                // Mirrors shouldRenderText() in frontend.js so the preview cannot promise
+                // something the published label will not do.
+                function symbolCarriesWording(status) {
+                        var symbol = activeSymbol(status);
+                        return !!(symbol && symbol.onLight && symbol.ratio && parseFloat(symbol.ratio) > 1.5);
+                }
+                function renderBadge(element, template, label, forceIcon, status) {
                         var config = applyPresetConfig(element, template);
                         var showIcon = forceIcon || (iconInput && iconInput.checked);
+                        var text = config.iconOnly ? '' : escapeText(label);
+                        var hideText = showIcon && !checked('icon_show_text') && symbolCarriesWording(status || previewType);
+                        var text = (config.iconOnly || hideText) ? '' : escapeText(label);
                         var isPresetDemo = element.hasAttribute('data-oznaczai-preset-preview');
                         var baseClass = isPresetDemo ? 'oznaczai-preset-demo' : 'oznaczai-preview-badge';
 …
                                 element.classList.add('oznaczai-preview-badge--icon-only');
+                        }
                         element.innerHTML = (showIcon ? '<b aria-hidden="true">AI</b>' : '') + text;
+                        element.innerHTML = (showIcon ? symbolMarkup(status || previewType) : '') + text;
                         element.setAttribute('aria-label', label);
                         return config;
 …
+                        }
                         if (behavior === 'icon' && !previewLabel.querySelector('b')) {
                                 previewLabel.innerHTML = '<b aria-hidden="true">AI</b>';
+                                previewLabel.innerHTML = symbolMarkup(previewType);
+                        }
                         previewLabel.classList.toggle('oznaczai-preview-badge--short-label', behavior === 'short');
 …
                         input.addEventListener('change', refreshPreview);
                 });
+                // Symbol variant and its text toggle change both the live preview and the
+                // preset cards, so the cards are re-rendered too.
+                Array.prototype.forEach.call(
+                        document.querySelectorAll('[data-oznaczai-icon-variant], input[name$="[icon_show_text]"]'),
+                        function (input) {
+                                input.addEventListener('change', function () {
+                                        renderPresetCards();
+                                        refreshPreview();
+                                });
+                        }
+                );
                 document.addEventListener('click', function (event) {

oznaczai-image-labeling/tags/1.7.0/assets/js/frontend.js

-              r3641997
+              r3705284
                 '[style*="background-image"]'
         ].join(',');
+        var revolutionSelector = 'sr7-module, rs-module';
+        var ownNodeSelector = '.oznaczai-badge, .oznaczai-bg-note, .oznaczai-popover';
         var scheduled = false;
         var config = window.oznaczaiImageLabelingFrontend || {};
         var mediaMap = config.mediaMap || {};
         var schemaEntries = {};
+        var schemaDirty = false;
+        // Scan scheduling state. The observer collects the smallest useful roots
+        // instead of forcing a full document rescan for every unrelated mutation.
+        var pendingRoots = [];
+        var pendingFull = false;
+        var maxPendingRoots = 60;
+        // Guards against the observer reacting to OznaczAI's own DOM writes.
+        var applying = 0;
+        var observer = null;
+        // Caches. WeakMap/WeakSet keep entries collectable with their elements.
+        var revolutionCache = new WeakMap();
+        var revolutionEpoch = 0;
+        var contrastKeys = new WeakMap();
+        var noteSignatures = new WeakMap();
+        var inlineBackgrounds = new WeakMap();
+        var loadWatched = new WeakSet();
+        var sliderScanQueued = new WeakSet();
+        var resizeTimer = null;
         function meaningfulChildren(element) {
 …
+        }
+        function buildIcon() {
+        function iconVariant() {
+                var variants = config.iconVariants || {};
+                var key = config.iconVariant || 'oznaczai';
+                return variants[key] || variants.oznaczai || null;
+        }
+        function resolveSymbol(status) {
+                var variant = iconVariant();
+                if (!variant || !variant.symbols) {
+                        return null;
+                }
+                return variant.symbols[status] || variant.symbols.generated || null;
+        }
+        function buildIcon(status) {
                 var icon = document.createElement('span');
+                var symbol = resolveSymbol(status);
                 icon.className = 'oznaczai-badge__icon';
                 icon.setAttribute('aria-hidden', 'true');
+                icon.textContent = 'AI';
+                // Image symbols are drawn from a file rather than inlined, so the same
+                // asset is cached once and the markup stays small on every page.
+                if (symbol && symbol.onLight && symbol.onDark) {
+                        icon.classList.add('oznaczai-badge__icon--image');
+                        icon.style.setProperty('--oznaczai-icon-on-light', 'url("' + symbol.onLight + '")');
+                        icon.style.setProperty('--oznaczai-icon-on-dark', 'url("' + symbol.onDark + '")');
+                        icon.style.setProperty('--oznaczai-icon-ratio', symbol.ratio || 1);
+                        return icon;
+                }
+                icon.textContent = symbol && symbol.text ? symbol.text : 'AI';
                 return icon;
+        }
+        function fillLabel(element, label, showIcon) {
+        /**
+         * Decide whether the wording is drawn beside the symbol. It is always kept
+         * when there is no symbol, and it is only dropped for symbols that already
+         * spell out their own meaning.
+         */
+        function shouldRenderText(status, showIcon) {
+                var symbol;
+                if (!showIcon || config.iconShowText !== false) {
+                        return true;
+                }
+                symbol = resolveSymbol(status);
+                return !(symbol && symbol.onLight && symbol.ratio && symbol.ratio > 1.5);
+        }
+        function fillLabel(element, label, showIcon, status) {
+                var withText = shouldRenderText(status, showIcon);
                 element.textContent = '';
                 if (showIcon) {
+                        element.appendChild(buildIcon());
+                }
+                element.appendChild(buildBadgeTextElement(label));
+                        element.appendChild(buildIcon(status));
+                }
+                if (withText) {
+                        element.appendChild(buildBadgeTextElement(label));
+                }
+                element.classList.toggle('oznaczai-badge--symbol-lockup', !withText);
+                // The accessible name always carries the full wording, including when the
+                // visible text is suppressed or the symbol is image-only.
                 element.setAttribute('role', 'note');
                 element.setAttribute('aria-label', label);
 …
+        }
+        /**
+         * Build a cheap key describing every input the contrast result depends on.
+         * Canvas sampling only runs again when one of these actually changed.
+         */
+        function contrastKey(badge, source) {
+                var badgeRect = badge.getBoundingClientRect();
+                var sourceKey = '';
+                if (source && source.tagName === 'IMG') {
+                        sourceKey = (source.currentSrc || source.getAttribute('src') || '') + ':' + (source.complete ? '1' : '0');
+                }
+                return [
+                        sourceKey,
+                        Math.round(badgeRect.width),
+                        Math.round(badgeRect.height),
+                        Math.round(badgeRect.left),
+                        Math.round(badgeRect.top)
+                ].join('|');
+        }
         function applyAutoContrast(badge, source, fallbackElement) {
                 var level;
+                var key;
+                if (!config.autoContrast || !badge || badge.classList.contains('oznaczai-badge--caption')) {
+                        clearContrastClasses(badge);
+                        return;
+                }
+                if (badge.classList.contains('oznaczai-badge--custom') && badge.style.getPropertyValue('--oznaczai-bg-color') === 'transparent') {
+                        clearContrastClasses(badge);
+                        return;
+                }
+                key = contrastKey(badge, source);
+                if (contrastKeys.get(badge) === key) {
+                        return;
+                }
                 clearContrastClasses(badge);
+                if (!config.autoContrast || !badge || badge.classList.contains('oznaczai-badge--caption')) {
+                        return;
+                }
+                if (badge.classList.contains('oznaczai-badge--custom') && badge.style.getPropertyValue('--oznaczai-bg-color') === 'transparent') {
+                        return;
+                }
+                // Record the attempt before sampling. A sample that cannot succeed for
+                // these inputs (tainted canvas, fully transparent ancestry) will not
+                // succeed on a retry either, so retrying costs work and changes nothing.
+                // A genuine change produces a different key and is picked up normally.
+                contrastKeys.set(badge, key);
                 if (source && source.tagName === 'IMG') {
 …
         function getCurrentTemplate() {
                 return config.template || 'minimal';
+        }
-        function templateClasses() {
-                return [
-                        'oznaczai-badge--minimal',
-                        'oznaczai-badge--compact',
-                        'oznaczai-badge--subtle',
-                        'oznaczai-badge--light',
-                        'oznaczai-badge--caption',
-                        'oznaczai-badge--glass',
-                        'oznaczai-badge--dark',
-                        'oznaczai-badge--icon-only'
-                ];
+        }
-        function containerTemplateClasses() {
-                return [
-                        'oznaczai-template--minimal',
-                        'oznaczai-template--compact',
-                        'oznaczai-template--subtle',
-                        'oznaczai-template--light',
-                        'oznaczai-template--caption',
-                        'oznaczai-template--glass',
-                        'oznaczai-template--dark',
-                        'oznaczai-template--icon-only'
-                ];
+        }
 …
         function resolveContextPosition(context, fallback, status, presetOverride) {
-                var style = config.style || {};
-                var hero = style.hero || {};
                 var presetConfigs = config.presetConfigs || {};
                 var custom = resolveStyleCustom(context);
 …
+                }
+                if (schemaEntries[absoluteUrl]) {
+                        return;
+                }
                 schemaEntries[absoluteUrl] = {
                         '@type': 'ImageObject',
 …
                         digitalSourceType: sourceType
                 };
+                schemaDirty = true;
+        }
 …
                 var graph;
                 if (!config.schemaMarkup) {
+                if (!config.schemaMarkup || !schemaDirty) {
                         return;
+                }
 …
                         '@graph': graph
                 });
+                schemaDirty = false;
+        }
 …
                 var device;
                 var behavior;
+                var status;
                 if (!badge) {
 …
+                }
+                status = getImageStatus(image);
                 badge.classList.remove('oznaczai-badge--symbol-only', 'oznaczai-badge--short-label');
                 badge.removeAttribute('title');
 …
                 if (behavior === 'icon') {
                         if (!badge.querySelector('.oznaczai-badge__icon')) {
                                 badge.insertBefore(buildIcon(), badge.firstChild);
+                                badge.insertBefore(buildIcon(status), badge.firstChild);
+                        }
                         badge.classList.add('oznaczai-badge--symbol-only');
 …
                 if (width > 0 && width <= 160) {
                         if (!badge.querySelector('.oznaczai-badge__icon')) {
                                 badge.insertBefore(buildIcon(), badge.firstChild);
+                                badge.insertBefore(buildIcon(status), badge.firstChild);
+                        }
                         badge.classList.remove('oznaczai-badge--short-label');
 …
+        }
+        function refreshResponsiveSymbols() {
+                var images = document.querySelectorAll(imageSelector);
+        function findImageBadge(image) {
+                var container = image.closest('.oznaczai-wrapper, .oznaczai-container, .woocommerce-product-gallery__image');
+                return container ? getDirectBadge(container) : null;
+        }
+        /**
+         * Re-evaluate responsive behaviour for already labeled images. This depends on
+         * viewport and element width, so it runs on resize and after image load only.
+         */
+        function refreshResponsiveSymbols(root) {
+                var scope = root && root.querySelectorAll ? root : document;
+                var images = scope.querySelectorAll(imageSelector);
                 Array.prototype.forEach.call(images, function (image) {
+                        var container = image.closest('.oznaczai-wrapper, .oznaczai-container, .woocommerce-product-gallery__image');
+                        var badge = container ? getDirectBadge(container) : null;
+                        var template = resolveTemplate(getImageStatus(image), image, null);
+                        var showIcon = getCurrentShowIcon();
+                        updateResponsiveBadge(image, badge, template, showIcon, getCurrentImageLabel(image));
+                        var badge = findImageBadge(image);
+                        var template;
+                        if (!badge) {
+                                return;
+                        }
+                        template = resolveTemplate(getImageStatus(image), image, null);
+                        updateResponsiveBadge(image, badge, template, getCurrentShowIcon(), getCurrentImageLabel(image));
+                        applyAutoContrast(badge, image, badge.parentElement);
                 });
+        }
 …
                         return false;
+                }
+                return !!image.closest('sr7-module, rs-module');
+                return !!image.closest(revolutionSelector);
+        }
+        /**
+         * Everything the rendered badge depends on. When this is unchanged there is
+         * nothing to rebuild, so the expensive path is skipped entirely.
+         */
+        function imageSignature(image) {
+                return [
+                        image.getAttribute('data-oznaczai-type') || '',
+                        image.getAttribute('data-oznaczai-label') || '',
+                        image.getAttribute('data-oznaczai-custom-label') || '',
+                        image.getAttribute('data-oznaczai-preset') || ''
+                ].join('|');
+        }
+        function watchImageLoad(image) {
+                if (loadWatched.has(image) || image.complete) {
+                        return;
+                }
+                loadWatched.add(image);
+                image.addEventListener('load', function () {
+                        var badge = findImageBadge(image);
+                        if (!badge) {
+                                return;
+                        }
+                        withOwnMutations(function () {
+                                updateResponsiveBadge(image, badge, resolveTemplate(getImageStatus(image), image, null), getCurrentShowIcon(), getCurrentImageLabel(image));
+                                applyAutoContrast(badge, image, badge.parentElement);
+                        });
+                }, { once: true });
+        }
         function createBadge(image) {
+                var label = getCurrentImageLabel(image);
+                var position = getCurrentPosition();
+                var status = getImageStatus(image);
+                var context = resolveContext(image, null);
+                var template = resolveTemplate(status, image, context);
+                var showIcon = getCurrentShowIcon();
+                var signature = imageSignature(image);
+                var label;
+                var position;
+                var status;
+                var context;
+                var template;
+                var showIcon;
                 var target;
                 var parent;
 …
                 var originalImageWidth;
+                if (image.getAttribute('data-oznaczai-ready') === '1' && image.getAttribute('data-oznaczai-sig') === signature) {
+                        return;
+                }
+                label = getCurrentImageLabel(image);
+                position = getCurrentPosition();
+                status = getImageStatus(image);
+                context = resolveContext(image, null);
+                template = resolveTemplate(status, image, context);
+                showIcon = getCurrentShowIcon();
                 if (!label) {
                         return;
 …
                 if (isManagedByRevolution(image)) {
                         image.setAttribute('data-oznaczai-ready', '1');
+                        return;
+                }
+                registerSchemaEntry(image.currentSrc || image.getAttribute('src'), getImageStatus(image));
+                        image.setAttribute('data-oznaczai-sig', signature);
+                        return;
+                }
+                registerSchemaEntry(image.currentSrc || image.getAttribute('src'), status);
                 originalParentWidth = image.parentElement ? image.parentElement.getBoundingClientRect().width : 0;
 …
                 );
                 badge.classList.add('oznaczai-badge--' + template);
                 fillLabel(badge, label, showIcon);
+                fillLabel(badge, label, showIcon, status);
                 applyStyleData(badge, status, template, context);
                 applyAutoContrast(badge, image, container);
                 updateResponsiveBadge(image, badge, template, showIcon, label);
                 setupPopover(badge, label);
+                watchImageLoad(image);
                 image.setAttribute('data-oznaczai-ready', '1');
+                image.setAttribute('data-oznaczai-sig', signature);
+        }
 …
+        }
+        /**
+         * mediaMap entries no longer carry the label text. Resolve it the same way a
+         * regular image does so background and slider labels stay identical.
+         */
+        function resolveMapLabel(data) {
+                var status = data && data.status ? data.status : 'generated';
+                if (data && data.label) {
+                        return data.label;
+                }
+                return (config.labels && config.labels[status]) || '';
+        }
+        function mapEntryToData(data, url) {
+                if (!data) {
+                        return null;
+                }
+                // NOTE: `preset` is deliberately not carried over. Up to and including
+                // 1.6.24 the background and Slider Revolution extractors never passed the
+                // per-image preset through, so hero/slider labels have always used the
+                // hero preset. Propagating it here would silently restyle existing sites
+                // on upgrade, so the change is left for a release that can announce it.
+                return {
+                        id: data.id,
+                        status: data.status,
+                        label: resolveMapLabel(data),
+                        url: url
+                };
+        }
         function addUniqueUrl(urls, value) {
                 var clean = typeof value === 'string' ? value.trim() : '';
 …
+        }
+        /**
+         * Cheap fingerprint used to decide whether the expensive full slide walk has
+         * to run again. Slider Revolution swaps sources and markup on slide change,
+         * so those are exactly the inputs worth watching.
+         */
+        function revolutionSlideKey(slide) {
+                var image = slide.querySelector ? slide.querySelector('img, sr7-bg, rs-bg') : null;
+                return [
+                        revolutionEpoch,
+                        slide.childElementCount,
+                        image ? (image.getAttribute('src') || image.getAttribute('data-src') || image.getAttribute('data-lazyload') || '') : '',
+                        slide.getAttribute('data-key') || slide.getAttribute('data-skey') || ''
+                ].join('|');
+        }
         function findAutomaticRevolutionSlideData(slide) {
+                var urls = extractRevolutionSlideUrls(slide);
+                var key = revolutionSlideKey(slide);
+                var cached = revolutionCache.get(slide);
+                var urls;
                 var i;
                 var data;
+                var result = null;
+                if (cached && cached.key === key) {
+                        return cached.data;
+                }
+                urls = extractRevolutionSlideUrls(slide);
                 for (i = 0; i < urls.length; i += 1) {
                         data = lookupMedia(urls[i]);
                         if (data) {
+                                return {
+                                        id: data.id,
+                                        status: data.status,
+                                        label: data.label,
+                                        url: urls[i]
+                                };
+                        }
+                }
+                return null;
+                                result = mapEntryToData(data, urls[i]);
+                                break;
+                        }
+                }
+                revolutionCache.set(slide, { key: key, data: result });
+                return result;
+        }
 …
                         data = lookupMedia(urls[i]);
                         if (data) {
+                                return {
+                                        id: data.id,
+                                        status: data.status,
+                                        label: data.label,
+                                        url: urls[i]
+                                };
+                                return mapEntryToData(data, urls[i]);
+                        }
+                }
 …
         function findSliderOwner(element) {
                 var revolution = element.closest('sr7-module, rs-module');
+                var revolution = element.closest(revolutionSelector);
                 if (revolution) {
                         return revolution;
 …
         function findSectionOwner(element) {
                 var revolution = element.closest('sr7-module, rs-module');
+                var revolution = element.closest(revolutionSelector);
                 if (revolution) {
                         return revolution;
 …
                 var note;
                 var template;
+                var signature;
                 if (!owner || !owner.parentNode) {
                         return null;
 …
                         owner.parentNode.insertBefore(note, owner.nextSibling);
+                }
+                setBelowNoteAlignment(note, position);
+                fillLabel(note, label, config.showIcon !== false);
                 status = status || 'generated';
                 context = context || 'background';
                 template = preset || resolveTemplate(status, null, context);
+                signature = [label, position, status, template, context].join('|');
+                // Slider libraries mutate slide classes on every transition frame. Without
+                // this guard the note would be torn down and rebuilt each time.
+                if (noteSignatures.get(note) === signature) {
+                        return note;
+                }
+                noteSignatures.set(note, signature);
+                setBelowNoteAlignment(note, position);
+                fillLabel(note, label, config.showIcon !== false, status);
                 note.classList.remove('oznaczai-badge--minimal', 'oznaczai-badge--compact', 'oznaczai-badge--subtle', 'oznaczai-badge--light', 'oznaczai-badge--caption', 'oznaczai-badge--glass', 'oznaczai-badge--dark', 'oznaczai-badge--icon-only');
                 note.classList.add('oznaczai-badge--' + template);
 …
                 if (active) {
                         labeled = active.hasAttribute('data-oznaczai-slide-label') ? active : null;
                 } else if (slider.matches('sr7-module, rs-module')) {
+                } else if (slider.matches(revolutionSelector)) {
                         labeled = null;
                 } else {
 …
                 if ('MutationObserver' in window) {
                         new MutationObserver(function () {
+                                updateSliderNote(slider);
+                                // Slide transitions fire dozens of records per second. Collapse them
+                                // into one update per frame.
+                                if (sliderScanQueued.has(slider)) {
+                                        return;
+                                }
+                                sliderScanQueued.add(slider);
+                                window.requestAnimationFrame(function () {
+                                        sliderScanQueued.delete(slider);
+                                        withOwnMutations(function () {
+                                                updateSliderNote(slider);
+                                        });
+                                });
                         }).observe(slider, {
                                 attributes: true,
 …
         function createOverlayLabel(target, data, display, context) {
                 var badge = target.querySelector(':scope > .oznaczai-badge.oznaczai-badge--bg');
+                var status = data.status || 'generated';
+                var template;
+                var signature;
                 context = context || 'background';
+                var template = data.preset || resolveTemplate(data.status || 'generated', null, context);
+                template = data.preset || resolveTemplate(status, null, context);
+                signature = [data.label, display, status, template, context].join('|');
+                if (badge && noteSignatures.get(badge) === signature) {
+                        return;
+                }
                 target.classList.add('oznaczai-bg-target');
 …
+                }
+                noteSignatures.set(badge, signature);
                 badge.classList.remove('oznaczai-badge--minimal', 'oznaczai-badge--compact', 'oznaczai-badge--subtle', 'oznaczai-badge--light', 'oznaczai-badge--caption', 'oznaczai-badge--glass', 'oznaczai-badge--dark', 'oznaczai-badge--icon-only', 'oznaczai-badge--hero-bar');
                 badge.classList.add('oznaczai-badge--' + template);
 …
                         badge.classList.add('oznaczai-badge--hero-bar');
+                }
                 fillLabel(badge, data.label, config.showIcon !== false);
                 applyStyleData(badge, data.status || 'generated', template, context);
+                fillLabel(badge, data.label, config.showIcon !== false, status);
+                applyStyleData(badge, status, template, context);
                 applyAutoContrast(badge, null, target);
                 setupPopover(badge, data.label);
 …
                         return;
+                }
+                // A negative result is remembered too. Without this, every generic
+                // hero/banner/Elementor node was re-measured with getComputedStyle on
+                // every single scan.
+                if (target.getAttribute('data-oznaczai-bg-checked') === '1') {
+                        return;
+                }
                 // Real content images are handled by createBadge(). A generic hero/banner
                 // selector must never promote an <img> into a second background disclosure.
                 if (target.matches && target.matches('img, picture, source')) {
+                        target.setAttribute('data-oznaczai-bg-checked', '1');
                         return;
+                }
 …
                 if (data) {
                         applyBackgroundLabel(target, data);
+                }
+                        return;
+                }
+                target.setAttribute('data-oznaczai-bg-checked', '1');
+        }
 …
+        }
+        function scan(root) {
+                var images;
+                var manualBackgrounds;
+                var automaticBackgrounds;
+                var monitoredSliders;
+                var revolutionSliders;
+                root = root || document;
+                images = collect(root, imageSelector);
+                manualBackgrounds = collect(root, manualBackgroundSelector);
+                automaticBackgrounds = config.autoBackgrounds ? collect(root, autoBackgroundSelector) : [];
+                monitoredSliders = collect(root, '[data-oznaczai-slider-observed="1"]');
+                revolutionSliders = config.autoBackgrounds ? collect(root, 'sr7-module, rs-module') : [];
+        function scanRoot(root) {
+                var images = collect(root, imageSelector);
+                var manualBackgrounds = collect(root, manualBackgroundSelector);
+                var automaticBackgrounds = config.autoBackgrounds ? collect(root, autoBackgroundSelector) : [];
+                var revolutionSliders = config.autoBackgrounds ? collect(root, revolutionSelector) : [];
+                var monitoredSliders = collect(root, '[data-oznaczai-slider-observed="1"]');
                 images.forEach(createBadge);
 …
                 revolutionSliders.forEach(scanRevolutionSlider);
                 monitoredSliders.forEach(updateSliderNote);
+                refreshResponsiveSymbols();
+                flushSchemaMarkup();
+        }
+        function scheduleScan() {
+        }
+        /**
+         * Run a callback with the global observer detached so OznaczAI never reacts
+         * to its own DOM writes. disconnect() also empties the pending record queue,
+         * which is what actually breaks the observer -> scan -> observer loop.
+         */
+        function withOwnMutations(callback) {
+                applying += 1;
+                if (observer) {
+                        observer.disconnect();
+                }
+                try {
+                        callback();
+                } finally {
+                        applying -= 1;
+                        if (observer && applying === 0) {
+                                startObserving();
+                        }
+                }
+        }
+        function scan(root) {
+                withOwnMutations(function () {
+                        scanRoot(root || document);
+                        flushSchemaMarkup();
+                });
+        }
+        function isOwnNode(node) {
+                return !!(node && node.nodeType === 1 && node.closest && node.closest(ownNodeSelector));
+        }
+        /**
+         * Compare only the inline background-image declaration. This reads the
+         * element's own style object, so unlike getComputedStyle it does not force
+         * the browser to flush pending style or layout work.
+         */
+        function inlineBackgroundChanged(element) {
+                var current;
+                if (!element || !element.style) {
+                        return true;
+                }
+                current = element.style.backgroundImage || '';
+                if (inlineBackgrounds.get(element) === current) {
+                        return false;
+                }
+                inlineBackgrounds.set(element, current);
+                return true;
+        }
+        function queueRoot(node) {
+                var scopeRoot;
+                if (pendingFull || !node || node.nodeType !== 1 || isOwnNode(node)) {
+                        return;
+                }
+                // Anything inside a Slider Revolution module has to be evaluated at module
+                // level, because slide detection works on the whole module.
+                scopeRoot = node.closest ? node.closest(revolutionSelector) : null;
+                scopeRoot = scopeRoot || node;
+                if (pendingRoots.indexOf(scopeRoot) !== -1) {
+                        return;
+                }
+                if (pendingRoots.length >= maxPendingRoots) {
+                        pendingFull = true;
+                        pendingRoots.length = 0;
+                        return;
+                }
+                pendingRoots.push(scopeRoot);
+        }
+        function runScheduledScan() {
+                var roots = pendingRoots.slice();
+                var full = pendingFull;
+                scheduled = false;
+                pendingRoots.length = 0;
+                pendingFull = false;
+                withOwnMutations(function () {
+                        if (full) {
+                                scanRoot(document);
+                        } else {
+                                roots.forEach(function (root) {
+                                        if (root === document || (root.isConnected !== false)) {
+                                                scanRoot(root);
+                                        }
+                                });
+                        }
+                        flushSchemaMarkup();
+                });
+        }
+        function scheduleScan(full) {
+                if (full === true) {
+                        pendingFull = true;
+                        pendingRoots.length = 0;
+                }
                 if (scheduled) {
                         return;
+                }
                 scheduled = true;
+                window.requestAnimationFrame(function () {
+                        scheduled = false;
+                        scan(document);
+                });
+                window.requestAnimationFrame(runScheduledScan);
+        }
+        function scheduleFullScan() {
+                scheduleScan(true);
+        }
+        function startObserving() {
+                if (!observer) {
+                        return;
+                }
+                observer.observe(document.body, {
+                        childList: true,
+                        subtree: true,
+                        attributes: true,
+                        // `class` is intentionally not observed globally. Slider state classes
+                        // are handled by the per-slider observer in ensureSliderMonitoring(),
+                        // and every other class change on the page is irrelevant to labeling.
+                        attributeFilter: ['style', 'src', 'srcset', 'data-src', 'data-lazyload', 'data-lazysrc', 'data-lazy-src', 'data-bg', 'data-thumb']
+                });
+        }
+        function handleMutations(mutations) {
+                var queued = false;
+                var i;
+                var mutation;
+                var j;
+                var node;
+                if (applying > 0) {
+                        return;
+                }
+                for (i = 0; i < mutations.length; i += 1) {
+                        mutation = mutations[i];
+                        if (mutation.type === 'attributes') {
+                                if (isOwnNode(mutation.target)) {
+                                        continue;
+                                }
+                                // Scroll animations and motion effects rewrite `style` on every
+                                // frame without ever touching the background. Reading the inline
+                                // value is cheap and avoids forcing a style recalculation for
+                                // changes that cannot affect labeling.
+                                if (mutation.attributeName === 'style' && !inlineBackgroundChanged(mutation.target)) {
+                                        continue;
+                                }
+                                // A background source may have just been swapped in, so the cached
+                                // negative result for this element is no longer trustworthy.
+                                if (mutation.target.hasAttribute && mutation.target.hasAttribute('data-oznaczai-bg-checked')) {
+                                        mutation.target.removeAttribute('data-oznaczai-bg-checked');
+                                }
+                                queueRoot(mutation.target);
+                                queued = true;
+                                continue;
+                        }
+                        if (mutation.addedNodes) {
+                                for (j = 0; j < mutation.addedNodes.length; j += 1) {
+                                        node = mutation.addedNodes[j];
+                                        if (node.nodeType !== 1 || isOwnNode(node)) {
+                                                continue;
+                                        }
+                                        queueRoot(node);
+                                        queued = true;
+                                }
+                        }
+                }
+                if (queued) {
+                        scheduleScan();
+                }
+        }
+        function handleResize() {
+                if (resizeTimer) {
+                        window.clearTimeout(resizeTimer);
+                }
+                resizeTimer = window.setTimeout(function () {
+                        resizeTimer = null;
+                        withOwnMutations(function () {
+                                refreshResponsiveSymbols(document);
+                        });
+                }, 200);
+        }
+        function handleRevolutionEvent() {
+                // Slide media changed, so the per-slide URL cache has to be rebuilt.
+                revolutionEpoch += 1;
+                scheduleFullScan();
+        }
         function init() {
                 scan(document);
+                withOwnMutations(function () {
+                        refreshResponsiveSymbols(document);
+                });
+                // Themes and lazy-loaders often finish late. These two passes are cheap
+                // now because processed images short-circuit on their signature.
                 window.setTimeout(function () { scan(document); }, 700);
                 window.setTimeout(function () { scan(document); }, 1800);
                 window.addEventListener('resize', scheduleScan, { passive: true });
+                window.addEventListener('resize', handleResize, { passive: true });
                 // Slider Revolution 7 exposes native lifecycle events. Re-scan after a
 …
                 // current-slide disclosure stay synchronized. Legacy SR6 remains covered
                 // by the DOM observer and data-slideactive monitoring below.
                 document.addEventListener('sr.module.ready', scheduleScan);
                 document.addEventListener('sr.slide.afterChange', scheduleScan);
+                document.addEventListener('sr.module.ready', handleRevolutionEvent);
+                document.addEventListener('sr.slide.afterChange', handleRevolutionEvent);
                 if ('MutationObserver' in window) {
+                        new MutationObserver(function (mutations) {
+                                var shouldScan = mutations.some(function (mutation) {
+                                        return (mutation.addedNodes && mutation.addedNodes.length > 0) || mutation.type === 'attributes';
+                                });
+                                if (shouldScan) {
+                                        scheduleScan();
+                                }
+                        }).observe(document.body, {
+                                childList: true,
+                                subtree: true,
+                                attributes: true,
+                                attributeFilter: ['class', 'style', 'src', 'srcset', 'data-src', 'data-lazyload', 'data-lazysrc', 'data-lazy-src', 'data-bg', 'data-thumb', 'data-current', 'data-slideactive']
+                        });
+                        observer = new MutationObserver(handleMutations);
+                        startObserving();
+                }

oznaczai-image-labeling/tags/1.7.0/changelog.txt

-              r3641997
+              r3705284
+= 1.7.0 =
+* Fixed a feedback loop where the page observer reacted to the plugin's own DOM updates and kept re-scanning the page after it had settled.
+* Labeled images are no longer reprocessed on every scan, so contrast sampling now runs once per image instead of repeatedly.
+* Added a per-slide cache for Slider Revolution detection and stopped re-measuring hero, banner and Elementor elements that were already checked.
+* Narrowed the page observer and made it scan only the changed part of the page. Dynamically added Elementor content, lazy-loaded backgrounds and Slider Revolution 6/7 are still detected.
+* Stopped rebuilding the labeled media cache after uploads and thumbnail regeneration of media that carries no label.
+* Removed a database write that could happen while a public page was being rendered.
+* Bulk labeling now writes the labeled media index once instead of once per image.
+* Reduced the size of the labeled media data passed to the browser by removing duplicated entries.
+* The legacy storage migration now runs only on install and version change instead of on every request.
+* Fixed a migration from very old versions that could store a label preset that no longer exists.
+* Added an AI label filter to the Media Library list view, including images with no label and images with a metadata hint.
+* Added the [oznaczai_transparency_legend] shortcode, and an optional action that creates a draft page containing it.
+* Added optional official European Commission icons for labelling AI-generated content as an alternative label symbol. The OznaczAI symbol remains the default and existing labels are unchanged.
+* Removed settings screen code that was no longer used by the current panel.
 = 1.6.24 =
 * Rebuilt preset cards with a simple flex column flow so title, description and preview badge can never overlap.

oznaczai-image-labeling/tags/1.7.0/includes/class-oznaczai-image-labeling-plugin.php

-              r3641997
+              r3705284
         const OPTION_LABELED_IDS        = 'oznaczai_image_labeling_labeled_media_ids';
         const OPTION_VERSION            = 'oznaczai_image_labeling_version';
+        const OPTION_TRANSPARENCY_PAGE  = 'oznaczai_image_labeling_transparency_page_id';
         const TRANSIENT_MEDIA_MAP       = 'oznaczai_image_labeling_media_map_v1';
 …
         /**
+         * Cached labeled attachment index for the current request.
+         *
+         * @var array<int>|null
+         */
+        private $labeled_ids = null;
+        /**
+         * Stale index entries detected while building the media map on a public
+         * request. They are written out on the next administrative save.
+         *
+         * @var array<int>|null
+         */
+        private $labeled_ids_pending_cleanup = null;
+        /**
          * Get singleton instance.
+         *
 …
                 add_filter( 'manage_media_columns', array( $this, 'add_media_column' ) );
                 add_action( 'manage_media_custom_column', array( $this, 'render_media_column' ), 10, 2 );
+                add_action( 'restrict_manage_posts', array( $this, 'render_media_library_filter' ), 10, 2 );
+                add_action( 'pre_get_posts', array( $this, 'filter_media_library_query' ) );
                 add_filter( 'bulk_actions-upload', array( $this, 'add_bulk_actions' ) );
                 add_filter( 'handle_bulk_actions-upload', array( $this, 'handle_bulk_actions' ), 10, 3 );
                 add_action( 'admin_notices', array( $this, 'show_bulk_action_notice' ) );
+                add_action( 'admin_notices', array( $this, 'show_transparency_page_notice' ) );
                 add_action( 'wp_ajax_oznaczai_image_labeling_update_media_status', array( $this, 'ajax_update_media_status' ) );
+                add_action( 'admin_post_oznaczai_image_labeling_create_transparency_page', array( $this, 'handle_create_transparency_page' ) );
                 add_action( 'edit_attachment', array( $this, 'clear_media_map_cache' ) );
 …
          */
         public function maybe_upgrade() {
-                self::migrate_legacy_storage();
                 $stored_version = (string) get_option( self::OPTION_VERSION, '' );
                 if ( '' !== $stored_version && ! version_compare( $stored_version, OZNACZAI_IMAGE_LABELING_VERSION, '<' ) ) {
                         return;
+                }
+                // Only reached on a fresh install or a version change. Installations that
+                // are already up to date no longer pay for the legacy lookup on every
+                // request. Activation still calls this directly, so upgrades that skip
+                // deactivation are covered either way.
+                self::migrate_legacy_storage();
                 if ( '' === $stored_version || version_compare( $stored_version, '1.6.0', '<' ) ) {
 …
                 add_shortcode( 'oznaczai_image_label', array( $this, 'render_badge_shortcode' ) );
                 add_shortcode( 'oznaczai_image_label_background', array( $this, 'render_background_badge_shortcode' ) );
+                add_shortcode( 'oznaczai_transparency_legend', array( $this, 'render_transparency_legend_shortcode' ) );
+        }
 …
                         'hero_position'       => 'below',
                         'show_icon'           => 1,
+                        'icon_variant'        => 'oznaczai',
+                        'icon_show_text'      => 1,
                         'bg_display'          => 'below',
                         'auto_backgrounds'    => 1,
 …
                         if ( empty( $stored['template'] ) && ! empty( $stored['style'] ) ) {
+                                $stored['template'] = 'light' === $stored['style'] ? 'light' : 'subtle';
+                                // 'subtle' was dropped from the preset list, so it resolved to no
+                                // preset configuration and the frontend already fell back to the
+                                // 'minimal' custom properties. Storing 'minimal' keeps exactly the
+                                // same rendered label while making the stored value valid again.
+                                $stored['template'] = 'light' === $stored['style'] ? 'light' : 'minimal';
+                        }
 …
         /**
+         * Label symbol variants.
+         *
+         * A preset controls how the label looks. A symbol variant controls which
+         * mark appears inside it. They are independent on purpose, so every existing
+         * preset keeps working with every symbol.
+         *
+         * The default variant reproduces the historical OznaczAI "AI" mark exactly,
+         * so an upgrade never changes an existing site's labels on its own.
+         *
+         * The bundled EU assets are the official European Commission icons. See
+         * assets/icons/eu/README.txt for their source and terms of use.
+         *
+         * @return array<string,array<string,mixed>>
+         */
+        private static function get_icon_variants() {
+                $base = OZNACZAI_IMAGE_LABELING_URL . 'assets/icons/eu/';
+                $basic = array(
+                        'onLight' => $base . 'eu-ai-black.svg',
+                        'onDark'  => $base . 'eu-ai-white.svg',
+                        'ratio'   => 1,
+                );
+                return array(
+                        'oznaczai'  => array(
+                                'label'   => __( 'OznaczAI symbol', 'oznaczai-image-labeling' ),
+                                'symbols' => array(
+                                        'generated'     => array( 'text' => 'AI' ),
+                                        'modified'      => array( 'text' => 'AI' ),
+                                        'visualization' => array( 'text' => 'AI' ),
+                                ),
+                        ),
+                        'eu-basic'  => array(
+                                'label'   => __( 'EU AI icon', 'oznaczai-image-labeling' ),
+                                'symbols' => array(
+                                        'generated'     => $basic,
+                                        'modified'      => $basic,
+                                        'visualization' => $basic,
+                                ),
+                        ),
+                        'eu-status' => array(
+                                'label'   => __( 'EU AI icons per label type', 'oznaczai-image-labeling' ),
+                                'symbols' => array(
+                                        'generated'     => array(
+                                                'onLight' => $base . 'eu-ai-generated-black.svg',
+                                                'onDark'  => $base . 'eu-ai-generated-white.svg',
+                                                'ratio'   => 3.157,
+                                        ),
+                                        'modified'      => array(
+                                                'onLight' => $base . 'eu-ai-modified-black.svg',
+                                                'onDark'  => $base . 'eu-ai-modified-white.svg',
+                                                'ratio'   => 3,
+                                        ),
+                                        // There is no official variant meaning "visualization", so this
+                                        // status intentionally falls back to the neutral basic icon
+                                        // instead of being presented as fully generated or modified.
+                                        'visualization' => $basic,
+                                ),
+                        ),
+                );
+        }
+        /**
+         * Validate a symbol variant key.
+         *
+         * @param string $variant Variant key.
+         * @return string
+         */
+        private function sanitize_icon_variant( $variant ) {
+                $variant = sanitize_key( $variant );
+                return array_key_exists( $variant, self::get_icon_variants() ) ? $variant : 'oznaczai';
+        }
+        /**
+         * Whether the active symbol variant already carries its own wording.
+         *
+         * The EU per-type assets are wide lockups that spell out their meaning as
+         * vector outlines, so repeating the label text beside them is redundant.
+         *
+         * @param string $variant Variant key.
+         * @return bool
+         */
+        private function icon_variant_has_wording( $variant ) {
+                return 'eu-status' === $variant;
+        }
+        /**
          * Validate a preset key.
+         *
 …
         /**
-         * Return custom style config for a supported visual context.
+         *
-         * @param string $context  Context key.
-         * @param array  $settings Current settings.
-         * @return array
-         */
-        private function get_context_custom_style_config( $context, $settings ) {
-                return array(
-                        'textColor'    => $settings[ 'context_' . $context . '_text_color' ],
-                        'noBackground' => ! empty( $settings[ 'context_' . $context . '_no_background' ] ),
-                        'bgColor'      => $settings[ 'context_' . $context . '_bg_color' ],
-                        'bgOpacity'    => (int) $settings[ 'context_' . $context . '_bg_opacity' ],
-                        'borderColor'  => $settings[ 'context_' . $context . '_border_color' ],
-                        'borderWidth'  => (int) $settings[ 'context_' . $context . '_border_width' ],
-                        'radius'       => (int) $settings[ 'context_' . $context . '_radius' ],
-                        'fontSize'     => (int) $settings[ 'context_' . $context . '_font_size' ],
-                        'fontWeight'   => (int) $settings[ 'context_' . $context . '_font_weight' ],
-                        'paddingX'     => (int) $settings[ 'context_' . $context . '_padding_x' ],
-                        'paddingY'     => (int) $settings[ 'context_' . $context . '_padding_y' ],
-                        'iconColor'    => $settings[ 'context_' . $context . '_icon_color' ],
-                        'iconSize'     => (int) $settings[ 'context_' . $context . '_icon_size' ],
-                        'shadow'       => ! empty( $settings[ 'context_' . $context . '_shadow' ] ),
-                        'position'     => $settings[ 'context_' . $context . '_position' ],
-                );
+        }
-        /**
          * Localized default public labels.
+         *
 …
                         $valid_ids[] = $attachment_id;
+                        $full_url    = wp_get_attachment_url( $attachment_id );
                         $urls        = array_filter(
                                 array(
                                         wp_get_attachment_url( $attachment_id ),
+                                        $full_url,
                                         function_exists( 'wp_get_original_image_url' ) ? wp_get_original_image_url( $attachment_id ) : '',
+                                )
 …
                         $metadata = wp_get_attachment_metadata( $attachment_id );
-                        $full_url = wp_get_attachment_url( $attachment_id );
                         if ( $full_url && is_array( $metadata ) && ! empty( $metadata['sizes'] ) ) {
                                 $base_url = trailingslashit( dirname( $full_url ) );
 …
                                         continue;
+                                }
+                                $map[ $path ]           = $data;
+                                $map[ $path . '.webp' ] = $data;
+                                $webp_path              = preg_replace( '/\.(?:jpe?g|png)$/i', '.webp', $path );
+                                $map[ $path ] = $data;
+                                // A "<file>.webp" companion path is intentionally not stored. The
+                                // frontend lookup already strips a trailing .webp and retries, so
+                                // the extra key was pure duplication of every entry. The variant
+                                // where the extension is replaced is still needed, because that
+                                // form cannot be derived by stripping.
+                                $webp_path = preg_replace( '/\.(?:jpe?g|png)$/i', '.webp', $path );
                                 if ( is_string( $webp_path ) && $webp_path !== $path ) {
                                         $map[ $webp_path ] = $data;
 …
+                }
+                // Stale entries are recorded for the next admin-side write instead of
+                // being flushed here. This method runs on public page views, which must
+                // never issue a database write.
                 if ( $valid_ids !== $ids ) {
                         update_option( self::OPTION_LABELED_IDS, $valid_ids, false );
+                        $this->labeled_ids_pending_cleanup = $valid_ids;
+                }
 …
          */
         private function get_labeled_media_ids() {
+                if ( is_array( $this->labeled_ids ) ) {
+                        return $this->labeled_ids;
+                }
                 $ids = get_option( self::OPTION_LABELED_IDS, null );
                 if ( ! is_array( $ids ) ) {
+                        return $this->rebuild_labeled_media_index();
+                        $this->labeled_ids = $this->rebuild_labeled_media_index();
+                        return $this->labeled_ids;
+                }
                 $ids = array_values( array_unique( array_filter( array_map( 'absint', $ids ) ) ) );
                 sort( $ids, SORT_NUMERIC );
+                $this->labeled_ids = $ids;
                 return $ids;
 …
                 $ids = array_values( array_unique( $ids ) );
                 sort( $ids, SORT_NUMERIC );
+                $this->labeled_ids = $ids;
                 update_option( self::OPTION_LABELED_IDS, $ids, false );
 …
          * @param int    $attachment_id Attachment ID.
          * @param string $status        Sanitized status.
+         * @param bool   $defer         Keep the change in memory instead of writing.
          * @return void
          */
         private function update_labeled_media_index( $attachment_id, $status ) {
+        private function update_labeled_media_index( $attachment_id, $status, $defer = false ) {
                 $attachment_id = absint( $attachment_id );
                 if ( ! $attachment_id ) {
 …
                 sort( $ids, SORT_NUMERIC );
+                $this->labeled_ids = $ids;
+                if ( $defer ) {
+                        return;
+                }
+                $this->persist_labeled_media_index();
+        }
+        /**
+         * Write the labeled media index once.
+         *
+         * Bulk actions collect every change first and call this at the end, so a
+         * 200-image selection performs one write instead of 200.
+         *
+         * @return void
+         */
+        private function persist_labeled_media_index() {
+                $ids = $this->get_labeled_media_ids();
+                if ( is_array( $this->labeled_ids_pending_cleanup ) ) {
+                        $ids = array_values( array_intersect( $ids, $this->labeled_ids_pending_cleanup ) );
+                        sort( $ids, SORT_NUMERIC );
+                        $this->labeled_ids                 = $ids;
+                        $this->labeled_ids_pending_cleanup = null;
+                }
                 update_option( self::OPTION_LABELED_IDS, $ids, false );
+        }
 …
                 $this->update_labeled_media_index( absint( $attachment_id ), 'none' );
                 $this->clear_media_map_cache();
+        }
+        /**
+         * Check whether an attachment currently carries an OznaczAI label.
+         *
+         * @param int $attachment_id Attachment ID.
+         * @return bool
+         */
+        private function is_labeled_attachment( $attachment_id ) {
+                $attachment_id = absint( $attachment_id );
+                if ( ! $attachment_id ) {
+                        return false;
+                }
+                return in_array( $attachment_id, $this->get_labeled_media_ids(), true );
+        }
 …
          */
         public function clear_media_map_cache_after_metadata_update( $data, $attachment_id ) {
+                unset( $attachment_id );
+                // This filter also runs for every plain upload and every thumbnail
+                // regeneration. Rebuilding the whole map for media that carries no label
+                // turned a 500-image import into 500 cold rebuilds on the next page view.
+                if ( ! $this->is_labeled_attachment( $attachment_id ) ) {
+                        return $data;
+                }
                 $this->clear_media_map_cache();
                 return $data;
 …
                                 ),
                                 'presetConfigs'   => self::get_preset_configs(),
+                                'iconVariants'   => self::get_icon_variants(),
+                                'iconVariant'    => $this->sanitize_icon_variant( $settings['icon_variant'] ),
+                                'iconShowText'   => ! empty( $settings['icon_show_text'] ),
                                 'showIcon'       => ! empty( $settings['show_icon'] ),
                                 'template'       => $settings['template'],
 …
                                         array(
                                                 'presetConfigs' => self::get_preset_configs(),
+                                                'iconVariants'  => self::get_icon_variants(),
+                                        )
                                 );
 …
         /**
+         * Register settings and fields.
+         * Register the settings option.
+         *
+         * The screen is rendered by render_settings_page() rather than through
+         * do_settings_sections(), so only the option registration is needed here.
+         * It provides the options.php allow-list entry and the sanitize callback.
+         *
          * @return void
 …
                                 'default'           => self::default_settings(),
+                        )
-                );
-                add_settings_section(
-                        'oznaczai_image_labeling_labels_section',
-                        __( 'Label text', 'oznaczai-image-labeling' ),
-                        '__return_false',
-                        'oznaczai-image-labeling'
-                );
-                $this->register_text_setting_field( 'label_generated', __( 'AI-generated image', 'oznaczai-image-labeling' ) );
-                $this->register_text_setting_field( 'label_modified', __( 'AI-modified image', 'oznaczai-image-labeling' ) );
-                $this->register_text_setting_field( 'label_visualization', __( 'AI visualization', 'oznaczai-image-labeling' ) );
-                add_settings_section(
-                        'oznaczai_image_labeling_appearance_section',
-                        __( 'Label appearance', 'oznaczai-image-labeling' ),
-                        '__return_false',
-                        'oznaczai-image-labeling'
-                );
-                add_settings_field(
-                        'position',
-                        __( 'Position', 'oznaczai-image-labeling' ),
-                        array( $this, 'render_position_field' ),
-                        'oznaczai-image-labeling',
-                        'oznaczai_image_labeling_appearance_section'
-                );
-                add_settings_field(
-                        'template',
-                        __( 'Template', 'oznaczai-image-labeling' ),
-                        array( $this, 'render_template_field' ),
-                        'oznaczai-image-labeling',
-                        'oznaczai_image_labeling_appearance_section'
-                );
-                add_settings_field(
-                        'show_icon',
-                        __( 'AI icon', 'oznaczai-image-labeling' ),
-                        array( $this, 'render_icon_field' ),
-                        'oznaczai-image-labeling',
-                        'oznaczai_image_labeling_appearance_section'
-                );
-                add_settings_field(
-                        'responsive_symbol',
-                        __( 'Small-image symbol', 'oznaczai-image-labeling' ),
-                        array( $this, 'render_responsive_symbol_field' ),
-                        'oznaczai-image-labeling',
-                        'oznaczai_image_labeling_appearance_section'
-                );
-                add_settings_section(
-                        'oznaczai_image_labeling_background_section',
-                        __( 'Hero and background images', 'oznaczai-image-labeling' ),
-                        '__return_false',
-                        'oznaczai-image-labeling'
-                );
-                add_settings_field(
-                        'bg_display',
-                        __( 'Hero / background display', 'oznaczai-image-labeling' ),
-                        array( $this, 'render_bg_display_field' ),
-                        'oznaczai-image-labeling',
-                        'oznaczai_image_labeling_background_section'
-                );
-                add_settings_field(
-                        'auto_backgrounds',
-                        __( 'Automatic detection', 'oznaczai-image-labeling' ),
-                        array( $this, 'render_auto_backgrounds_field' ),
-                        'oznaczai-image-labeling',
-                        'oznaczai_image_labeling_background_section'
-                );
-                add_settings_section(
-                        'oznaczai_image_labeling_metadata_section',
-                        __( 'Metadata and automation', 'oznaczai-image-labeling' ),
-                        '__return_false',
-                        'oznaczai-image-labeling'
-                );
-                add_settings_field(
-                        'detect_metadata',
-                        __( 'Upload metadata hints', 'oznaczai-image-labeling' ),
-                        array( $this, 'render_detect_metadata_field' ),
-                        'oznaczai-image-labeling',
-                        'oznaczai_image_labeling_metadata_section'
-                );
-                add_settings_field(
-                        'schema_markup',
-                        __( 'Schema.org metadata', 'oznaczai-image-labeling' ),
-                        array( $this, 'render_schema_markup_field' ),
-                        'oznaczai-image-labeling',
-                        'oznaczai_image_labeling_metadata_section'
-                );
+        }
-        /**
-         * Register one text option field.
+         *
-         * @param string $key   Setting key.
-         * @param string $label Field label.
-         * @return void
-         */
-        private function register_text_setting_field( $key, $label ) {
-                add_settings_field(
-                        $key,
-                        $label,
-                        array( $this, 'render_text_field' ),
-                        'oznaczai-image-labeling',
-                        'oznaczai_image_labeling_labels_section',
-                        array( 'key' => $key )
                 );
+        }
 …
                         'hero_position'       => isset( $input['hero_position'] ) && in_array( $input['hero_position'], $context_positions, true ) ? sanitize_key( $input['hero_position'] ) : $defaults['hero_position'],
                         'show_icon'           => empty( $input['show_icon'] ) ? 0 : 1,
+                        'icon_variant'        => $this->sanitize_icon_variant( isset( $input['icon_variant'] ) ? $input['icon_variant'] : $defaults['icon_variant'] ),
+                        'icon_show_text'      => empty( $input['icon_show_text'] ) ? 0 : 1,
                         'bg_display'          => isset( $input['bg_display'] ) && in_array( $input['bg_display'], $bg_displays, true ) ? $input['bg_display'] : ( isset( $input['hero_position'] ) && in_array( $input['hero_position'], $bg_displays, true ) ? sanitize_key( $input['hero_position'] ) : $defaults['bg_display'] ),
                         'auto_backgrounds'    => empty( $input['auto_backgrounds'] ) ? 0 : 1,
 …
                 $value = is_numeric( $value ) ? (int) $value : (int) $default;
                 return max( $min, min( $max, $value ) );
+        }
-        /**
-         * Render settings text field.
+         *
-         * @param array $args Field arguments.
-         * @return void
-         */
-        public function render_text_field( $args ) {
-                $settings = $this->get_settings();
-                $key      = $args['key'];
-                $status   = str_replace( 'label_', '', $key );
-                $defaults = $this->get_default_label_texts();
-                $placeholder = isset( $defaults[ $status ] ) ? $defaults[ $status ] : '';
-                printf(
-                        '<input type="text" class="regular-text" maxlength="160" name="%1$s[%2$s]" value="%3$s" placeholder="%4$s">',
-                        esc_attr( self::OPTION_SETTINGS ),
-                        esc_attr( $key ),
-                        esc_attr( $settings[ $key ] ),
-                        esc_attr( $placeholder )
-                );
-                echo '<p class="description">' . esc_html__( 'Leave empty to use the translated default for the active site language.', 'oznaczai-image-labeling' ) . '</p>';
+        }
-        /**
-         * Render position field.
+         *
-         * @return void
-         */
-        public function render_position_field() {
-                $settings = $this->get_settings();
-                $options  = array(
-                        'bottom-left'  => __( 'Bottom left', 'oznaczai-image-labeling' ),
-                        'bottom-right' => __( 'Bottom right', 'oznaczai-image-labeling' ),
-                        'top-left'     => __( 'Top left', 'oznaczai-image-labeling' ),
-                        'top-right'    => __( 'Top right', 'oznaczai-image-labeling' ),
-                );
-                echo '<select name="' . esc_attr( self::OPTION_SETTINGS ) . '[position]">';
-                foreach ( $options as $value => $label ) {
-                        printf(
-                                '<option value="%1$s"%2$s>%3$s</option>',
-                                esc_attr( $value ),
-                                selected( $settings['position'], $value, false ),
-                                esc_html( $label )
-                        );
+                }
-                echo '</select>';
-                echo '<p class="description">' . esc_html__( 'For the Caption below image template, this setting controls left or right caption alignment.', 'oznaczai-image-labeling' ) . '</p>';
+        }
-        /**
-         * Render template field.
+         *
-         * @return void
-         */
-        public function render_template_field() {
-                $settings = $this->get_settings();
-                $options  = array(
-                        'minimal' => array(
-                                'label'       => __( 'Minimal', 'oznaczai-image-labeling' ),
-                                'description' => __( 'The least prominent option. Very light background, without borders or shadows.', 'oznaczai-image-labeling' ),
-                        ),
-                        'compact' => array(
-                                'label'       => __( 'Compact', 'oznaczai-image-labeling' ),
-                                'description' => __( 'A small dark label with restrained visual weight.', 'oznaczai-image-labeling' ),
-                        ),
-                        'subtle'  => array(
-                                'label'       => __( 'Subtle', 'oznaczai-image-labeling' ),
-                                'description' => __( 'A semi-transparent label without shadow or bold text.', 'oznaczai-image-labeling' ),
-                        ),
-                        'light'    => array(
-                                'label'       => __( 'Light', 'oznaczai-image-labeling' ),
-                                'description' => __( 'Light, delicate text with an almost invisible background.', 'oznaczai-image-labeling' ),
-                        ),
-                        'caption'  => array(
-                                'label'       => __( 'Caption below image', 'oznaczai-image-labeling' ),
-                                'description' => __( 'A lightweight caption directly below the image. It does not cover the image.', 'oznaczai-image-labeling' ),
-                        ),
-                );
-                echo '<div class="oznaczai-template-grid">';
-                foreach ( $options as $value => $option ) {
-                        printf(
-                                '<label class="oznaczai-template-option"><input type="radio" name="%1$s[template]" value="%2$s"%3$s><span class="oznaczai-template-card"><span class="oznaczai-template-card__title">%4$s</span><span class="oznaczai-template-preview oznaczai-template-preview--%2$s"><span class="oznaczai-template-preview__icon" aria-hidden="true">AI</span><span>%6$s</span></span><span class="oznaczai-template-card__description">%5$s</span></span></label>',
-                                esc_attr( self::OPTION_SETTINGS ),
-                                esc_attr( $value ),
-                                checked( $settings['template'], $value, false ),
-                                esc_html( $option['label'] ),
-                                esc_html( $option['description'] ),
-                                esc_html__( 'AI-generated image', 'oznaczai-image-labeling' )
-                        );
+                }
-                echo '</div>';
-                echo '<p class="description">' . esc_html__( 'Minimal is the least prominent template. You can also disable the AI icon for an even lighter result.', 'oznaczai-image-labeling' ) . '</p>';
+        }
-        /**
-         * Render icon checkbox.
+         *
-         * @return void
-         */
-        public function render_icon_field() {
-                $settings = $this->get_settings();
-                printf(
-                        '<label><input type="checkbox" name="%1$s[show_icon]" value="1"%2$s> %3$s</label>',
-                        esc_attr( self::OPTION_SETTINGS ),
-                        checked( ! empty( $settings['show_icon'] ), true, false ),
-                        esc_html__( 'Show a small icon next to the text', 'oznaczai-image-labeling' )
-                );
+        }
-        /**
-         * Render small-image symbol setting.
+         *
-         * @return void
-         */
-        public function render_responsive_symbol_field() {
-                $settings = $this->get_settings();
-                printf(
-                        '<label><input type="checkbox" name="%1$s[responsive_symbol]" value="1"%2$s> %3$s</label>',
-                        esc_attr( self::OPTION_SETTINGS ),
-                        checked( ! empty( $settings['responsive_symbol'] ), true, false ),
-                        esc_html__( 'Use a compact AI symbol on small images instead of the full text label', 'oznaczai-image-labeling' )
-                );
-                echo '<p class="description">' . esc_html__( 'The symbol expands to the full label on hover or keyboard focus. The accessible label remains available to assistive technology. Caption below image is never collapsed.', 'oznaczai-image-labeling' ) . '</p>';
+        }
-        /**
-         * Render hero/background display field.
+         *
-         * @return void
-         */
-        public function render_bg_display_field() {
-                $settings = $this->get_settings();
-                $options  = array(
-                        'below'        => __( 'Below image / section', 'oznaczai-image-labeling' ),
-                        'bar'          => __( 'Subtle bar at the bottom of the hero', 'oznaczai-image-labeling' ),
-                        'bottom-left'  => __( 'Bottom left in hero', 'oznaczai-image-labeling' ),
-                        'bottom-right' => __( 'Bottom right in hero', 'oznaczai-image-labeling' ),
-                );
-                echo '<select name="' . esc_attr( self::OPTION_SETTINGS ) . '[bg_display]">';
-                foreach ( $options as $value => $label ) {
-                        printf(
-                                '<option value="%1$s"%2$s>%3$s</option>',
-                                esc_attr( $value ),
-                                selected( $settings['bg_display'], $value, false ),
-                                esc_html( $label )
-                        );
+                }
-                echo '</select>';
-                echo '<p class="description">' . esc_html__( 'For a custom section background, add the CSS class oznaczai-bg-generated, oznaczai-bg-modified, or oznaczai-bg-visualization. The Below image / section option is the safest choice for heroes with their own text.', 'oznaczai-image-labeling' ) . '</p>';
+        }
-        /**
-         * Render automatic background detection field.
+         *
-         * @return void
-         */
-        public function render_auto_backgrounds_field() {
-                $settings = $this->get_settings();
-                printf(
-                        '<label><input type="checkbox" name="%1$s[auto_backgrounds]" value="1"%2$s> %3$s</label>',
-                        esc_attr( self::OPTION_SETTINGS ),
-                        checked( ! empty( $settings['auto_backgrounds'] ), true, false ),
-                        esc_html__( 'Automatically detect labeled images in hero sections, section backgrounds, and Elementor sliders', 'oznaczai-image-labeling' )
-                );
-                echo '<p class="description">' . esc_html__( 'Mark the file in the Media Library. No CSS classes or shortcode are required for supported layouts.', 'oznaczai-image-labeling' ) . '</p>';
+        }
-        /**
-         * Render upload metadata detection setting.
+         *
-         * @return void
-         */
-        public function render_detect_metadata_field() {
-                $settings = $this->get_settings();
-                printf(
-                        '<label><input type="checkbox" name="%1$s[detect_metadata]" value="1"%2$s> %3$s</label>',
-                        esc_attr( self::OPTION_SETTINGS ),
-                        checked( ! empty( $settings['detect_metadata'] ), true, false ),
-                        esc_html__( 'Check newly uploaded images for AI-related IPTC/XMP, Content Credentials markers, and common generator signatures', 'oznaczai-image-labeling' )
-                );
-                echo '<p class="description">' . esc_html__( 'Detection only creates a review hint. It never labels an image automatically and does not validate C2PA signatures.', 'oznaczai-image-labeling' ) . '</p>';
+        }
-        /**
-         * Render Schema.org setting.
+         *
-         * @return void
-         */
-        public function render_schema_markup_field() {
-                $settings = $this->get_settings();
-                printf(
-                        '<label><input type="checkbox" name="%1$s[schema_markup]" value="1"%2$s> %3$s</label>',
-                        esc_attr( self::OPTION_SETTINGS ),
-                        checked( ! empty( $settings['schema_markup'] ), true, false ),
-                        esc_html__( 'Add Schema.org digitalSourceType JSON-LD for labeled images found on the page', 'oznaczai-image-labeling' )
-                );
-                echo '<p class="description">' . esc_html__( 'This is machine-readable publisher metadata. It is separate from Content Credentials and does not provide or guarantee legal compliance.', 'oznaczai-image-labeling' ) . '</p>';
+        }
 …
                                                                         <?php endforeach; ?>
                                                                 </div>
+                                                                <div class="oznaczai-symbol-row">
+                                                                        <label class="oznaczai-field">
+                                                                                <span><?php esc_html_e( 'Label symbol', 'oznaczai-image-labeling' ); ?></span>
+                                                                                <select name="<?php echo esc_attr( self::OPTION_SETTINGS ); ?>[icon_variant]" data-oznaczai-icon-variant>
+                                                                                        <?php foreach ( self::get_icon_variants() as $variant_key => $variant ) : ?>
+                                                                                                <option value="<?php echo esc_attr( $variant_key ); ?>" <?php selected( $this->sanitize_icon_variant( $settings['icon_variant'] ), $variant_key ); ?>><?php echo esc_html( $variant['label'] ); ?></option>
+                                                                                        <?php endforeach; ?>
+                                                                                </select>
+                                                                        </label>
+                                                                        <p class="description">
+                                                                                <?php esc_html_e( 'The OznaczAI symbol is the default. The EU options use the official European Commission icons for labelling AI-generated content. AI visualization always uses the neutral EU AI icon, because no official variant carries that meaning.', 'oznaczai-image-labeling' ); ?>
+                                                                        </p>
+                                                                        <?php $this->render_toggle_control( 'icon_show_text', __( 'Show text next to the symbol', 'oznaczai-image-labeling' ), __( 'Turn this off to show only the symbol when it already contains its own wording.', 'oznaczai-image-labeling' ), $settings ); ?>
+                                                                </div>
                                                                 <div class="oznaczai-advanced-grid">
                                                                         <?php $this->render_toggle_control( 'show_icon', __( 'Show AI icon', 'oznaczai-image-labeling' ), __( 'Display the small AI mark next to the label text.', 'oznaczai-image-labeling' ), $settings ); ?>
                                                                         <?php $this->render_toggle_control( 'schema_markup', __( 'Schema.org JSON-LD', 'oznaczai-image-labeling' ), __( 'Add digitalSourceType metadata for labeled images found on the page.', 'oznaczai-image-labeling' ), $settings ); ?>
                                                                 </div>
+                                                        </section>
+                                                        <section class="oznaczai-card" id="oznaczai-transparency">
+                                                                <div class="oznaczai-card-head">
+                                                                        <h2><?php esc_html_e( '7. AI transparency legend', 'oznaczai-image-labeling' ); ?></h2>
+                                                                        <span aria-hidden="true">i</span>
+                                                                </div>
+                                                                <p class="oznaczai-card-intro">
+                                                                        <?php esc_html_e( 'Place this shortcode on any page to explain what your AI labels mean. It follows your current label texts and symbol automatically.', 'oznaczai-image-labeling' ); ?>
+                                                                </p>
+                                                                <p><code class="oznaczai-shortcode">[oznaczai_transparency_legend]</code></p>
+                                                                <?php $transparency_page = $this->get_transparency_page(); ?>
+                                                                <?php if ( $transparency_page instanceof WP_Post ) : ?>
+                                                                        <p class="description">
+                                                                                <?php
+                                                                                printf(
+                                                                                        /* translators: %s: link to the existing page. */
+                                                                                        esc_html__( 'A page already exists: %s', 'oznaczai-image-labeling' ),
+                                                                                        '<a href="' . esc_url( (string) get_edit_post_link( $transparency_page->ID, 'url' ) ) . '">' . esc_html( get_the_title( $transparency_page ) ) . '</a>'
+                                                                                );
+                                                                                ?>
+                                                                        </p>
+                                                                <?php elseif ( current_user_can( 'publish_pages' ) ) : ?>
+                                                                        <p class="description"><?php esc_html_e( 'You can also create a draft page containing this legend. It is never published automatically.', 'oznaczai-image-labeling' ); ?></p>
+                                                                        <p>
+                                                                                <a class="button button-secondary" href="<?php echo esc_url( wp_nonce_url( admin_url( 'admin-post.php?action=oznaczai_image_labeling_create_transparency_page' ), 'oznaczai_image_labeling_create_transparency_page' ) ); ?>">
+                                                                                        <?php esc_html_e( 'Create AI transparency page', 'oznaczai-image-labeling' ); ?>
+                                                                                </a>
+                                                                        </p>
+                                                                <?php endif; ?>
                                                         </section>
 …
         /**
-         * Render context appearance controls.
+         *
-         * @param string $context  Context key.
-         * @param string $label    Context label.
-         * @param array  $settings Current settings.
-         * @return void
-         */
-        private function render_context_appearance_controls( $context, $label, $settings ) {
-                $prefix = 'context_' . $context;
-                $positions = array(
-                        'top-left'     => __( 'Top left', 'oznaczai-image-labeling' ),
-                        'top-right'    => __( 'Top right', 'oznaczai-image-labeling' ),
-                        'bottom-left'  => __( 'Bottom left', 'oznaczai-image-labeling' ),
-                        'bottom-right' => __( 'Bottom right', 'oznaczai-image-labeling' ),
-                        'below'        => __( 'Below image / section', 'oznaczai-image-labeling' ),
-                        'bar'          => __( 'Subtle bar', 'oznaczai-image-labeling' ),
-                );
-                ?>
-                <div class="oznaczai-context-style-card" data-oznaczai-context-style="<?php echo esc_attr( $context ); ?>">
-                        <h3><?php echo esc_html( $label ); ?></h3>
-                        <div class="oznaczai-mode-row">
-                                <label><input type="radio" name="<?php echo esc_attr( self::OPTION_SETTINGS ); ?>[<?php echo esc_attr( $prefix ); ?>_mode]" value="global" <?php checked( $settings[ $prefix . '_mode' ], 'global' ); ?> data-oznaczai-context-mode="<?php echo esc_attr( $context ); ?>"> <?php esc_html_e( 'Use global settings', 'oznaczai-image-labeling' ); ?></label>
-                                <label><input type="radio" name="<?php echo esc_attr( self::OPTION_SETTINGS ); ?>[<?php echo esc_attr( $prefix ); ?>_mode]" value="preset" <?php checked( $settings[ $prefix . '_mode' ], 'preset' ); ?> data-oznaczai-context-mode="<?php echo esc_attr( $context ); ?>"> <?php esc_html_e( 'Use separate preset', 'oznaczai-image-labeling' ); ?></label>
-                                <label><input type="radio" name="<?php echo esc_attr( self::OPTION_SETTINGS ); ?>[<?php echo esc_attr( $prefix ); ?>_mode]" value="custom" <?php checked( $settings[ $prefix . '_mode' ], 'custom' ); ?> data-oznaczai-context-mode="<?php echo esc_attr( $context ); ?>"> <?php esc_html_e( 'Customize manually', 'oznaczai-image-labeling' ); ?></label>
-                        </div>
-                        <div data-oznaczai-context-preset="<?php echo esc_attr( $context ); ?>">
-                                <label class="oznaczai-field">
-                                        <span><?php esc_html_e( 'Preset', 'oznaczai-image-labeling' ); ?></span>
-                                        <?php $this->render_preset_select( $prefix . '_preset', $settings[ $prefix . '_preset' ] ); ?>
-                                </label>
-                        </div>
-                        <div class="oznaczai-style-grid" data-oznaczai-context-custom="<?php echo esc_attr( $context ); ?>">
-                                <?php
-                                $this->render_style_input( $prefix . '_text_color', __( 'Text color', 'oznaczai-image-labeling' ), 'color', $settings );
-                                ?>
-                                <div class="oznaczai-background-tools">
-                                        <p class="oznaczai-label"><?php esc_html_e( 'Background', 'oznaczai-image-labeling' ); ?></p>
-                                        <label class="oznaczai-checkline">
-                                                <input type="checkbox" name="<?php echo esc_attr( self::OPTION_SETTINGS ); ?>[<?php echo esc_attr( $prefix ); ?>_no_background]" value="1" <?php checked( ! empty( $settings[ $prefix . '_no_background' ] ) ); ?> data-oznaczai-context-input>
-                                                <?php esc_html_e( 'No background', 'oznaczai-image-labeling' ); ?>
-                                        </label>
-                                </div>
-                                <?php
-                                $this->render_style_input( $prefix . '_bg_color', __( 'Background color', 'oznaczai-image-labeling' ), 'color', $settings );
-                                ?>
-                                <label class="oznaczai-field oznaczai-range-field">
-                                        <span><?php esc_html_e( 'Background opacity', 'oznaczai-image-labeling' ); ?></span>
-                                        <input type="range" min="0" max="100" name="<?php echo esc_attr( self::OPTION_SETTINGS ); ?>[<?php echo esc_attr( $prefix ); ?>_bg_opacity]" value="<?php echo esc_attr( $settings[ $prefix . '_bg_opacity' ] ); ?>" data-oznaczai-context-input>
-                                        <output><?php echo esc_html( absint( $settings[ $prefix . '_bg_opacity' ] ) ); ?>%</output>
-                                </label>
-                                <?php
-                                $this->render_style_input( $prefix . '_border_color', __( 'Border color', 'oznaczai-image-labeling' ), 'color', $settings );
-                                $this->render_style_input( $prefix . '_border_width', __( 'Border width', 'oznaczai-image-labeling' ), 'number', $settings, 0, 6 );
-                                $this->render_style_input( $prefix . '_radius', __( 'Radius', 'oznaczai-image-labeling' ), 'number', $settings, 0, 16 );
-                                $this->render_style_input( $prefix . '_font_size', __( 'Font size', 'oznaczai-image-labeling' ), 'number', $settings, 8, 18 );
-                                $this->render_style_input( $prefix . '_font_weight', __( 'Font weight', 'oznaczai-image-labeling' ), 'number', $settings, 300, 800 );
-                                $this->render_style_input( $prefix . '_padding_x', __( 'Horizontal padding', 'oznaczai-image-labeling' ), 'number', $settings, 0, 24 );
-                                $this->render_style_input( $prefix . '_padding_y', __( 'Vertical padding', 'oznaczai-image-labeling' ), 'number', $settings, 0, 16 );
-                                $this->render_style_input( $prefix . '_icon_color', __( 'AI icon color', 'oznaczai-image-labeling' ), 'color', $settings );
-                                $this->render_style_input( $prefix . '_icon_size', __( 'AI icon size', 'oznaczai-image-labeling' ), 'number', $settings, 8, 24 );
-                                ?>
-                                <?php $this->render_toggle_control( $prefix . '_shadow', __( 'Subtle shadow', 'oznaczai-image-labeling' ), __( 'Add a restrained shadow to this context label.', 'oznaczai-image-labeling' ), $settings ); ?>
-                                <?php if ( in_array( $context, array( 'background', 'slider' ), true ) ) : ?>
-                                        <label class="oznaczai-field">
-                                                <span><?php esc_html_e( 'Label position', 'oznaczai-image-labeling' ); ?></span>
-                                                <select name="<?php echo esc_attr( self::OPTION_SETTINGS ); ?>[<?php echo esc_attr( $prefix ); ?>_position]" data-oznaczai-context-input>
-                                                        <?php foreach ( $positions as $value => $position_label ) : ?>
-                                                                <option value="<?php echo esc_attr( $value ); ?>" <?php selected( $settings[ $prefix . '_position' ], $value ); ?>><?php echo esc_html( $position_label ); ?></option>
-                                                        <?php endforeach; ?>
-                                                </select>
-                                        </label>
-                                <?php endif; ?>
-                        </div>
-                </div>
-                <?php
+        }
-        /**
          * Render a compact style input.
+         *
 …
         /**
+         * Explanations shown in the transparency legend.
+         *
+         * These describe what the site owner stated about an image. They are not
+         * legal statements and must not be worded as any kind of compliance claim.
+         *
+         * @return array<string,string>
+         */
+        private function get_legend_descriptions() {
+                return array(
+                        'generated'     => __( 'The site owner has marked this image as generated using AI.', 'oznaczai-image-labeling' ),
+                        'modified'      => __( 'The site owner has marked this image as modified using AI.', 'oznaczai-image-labeling' ),
+                        'visualization' => __( 'The site owner has marked this image as a visualization created using AI.', 'oznaczai-image-labeling' ),
+                );
+        }
+        /**
+         * Render the symbol used for a status inside the legend.
+         *
+         * @param string $status  Image status.
+         * @param string $variant Active symbol variant.
+         * @return string
+         */
+        private function render_legend_symbol( $status, $variant ) {
+                $variants = self::get_icon_variants();
+                $symbols  = isset( $variants[ $variant ]['symbols'] ) ? $variants[ $variant ]['symbols'] : array();
+                $symbol   = isset( $symbols[ $status ] ) ? $symbols[ $status ] : array();
+                if ( ! empty( $symbol['onLight'] ) ) {
+                        return sprintf(
+                                '<img class="oznaczai-legend__symbol oznaczai-legend__symbol--image" src="%1$s" alt="" width="%2$d" height="20" loading="lazy" decoding="async">',
+                                esc_url( $symbol['onLight'] ),
+                                absint( round( 20 * ( isset( $symbol['ratio'] ) ? (float) $symbol['ratio'] : 1 ) ) )
+                        );
+                }
+                return sprintf(
+                        '<span class="oznaczai-legend__symbol" aria-hidden="true">%s</span>',
+                        esc_html( isset( $symbol['text'] ) ? $symbol['text'] : 'AI' )
+                );
+        }
+        /**
+         * Render the "AI transparency" legend.
+         *
+         * The legend is built from the statuses, label texts and symbol variant that
+         * are actually in use, so it never drifts from what visitors see on images.
+         *
+         * @param array $atts Shortcode attributes.
+         * @return string
+         */
+        public function render_transparency_legend_shortcode( $atts ) {
+                $atts = shortcode_atts(
+                        array(
+                                'title' => '',
+                        ),
+                        $atts,
+                        'oznaczai_transparency_legend'
+                );
+                $settings     = $this->get_settings();
+                $variant      = $this->sanitize_icon_variant( $settings['icon_variant'] );
+                $descriptions = $this->get_legend_descriptions();
+                $title        = $this->sanitize_label( $atts['title'] );
+                $output       = '<div class="oznaczai-legend">';
+                if ( '' !== $title ) {
+                        $output .= '<h2 class="oznaczai-legend__title">' . esc_html( $title ) . '</h2>';
+                }
+                $output .= '<ul class="oznaczai-legend__list">';
+                foreach ( array( 'generated', 'modified', 'visualization' ) as $status ) {
+                        $output .= sprintf(
+                                '<li class="oznaczai-legend__item oznaczai-legend__item--%1$s">%2$s<span class="oznaczai-legend__body"><span class="oznaczai-legend__name">%3$s</span><span class="oznaczai-legend__description">%4$s</span></span></li>',
+                                esc_attr( $status ),
+                                $this->render_legend_symbol( $status, $variant ),
+                                esc_html( $this->get_configured_label( $status ) ),
+                                esc_html( isset( $descriptions[ $status ] ) ? $descriptions[ $status ] : '' )
+                        );
+                }
+                $output .= '</ul>';
+                $output .= '<p class="oznaczai-legend__note">' . esc_html__( 'Labels are applied by the site owner. Not every image created or edited with AI carries a label, and these markings do not constitute a legal assessment.', 'oznaczai-image-labeling' ) . '</p>';
+                $output .= '</div>';
+                return $output;
+        }
+        /**
+         * Return the existing transparency page, if one is still usable.
+         *
+         * @return WP_Post|null
+         */
+        private function get_transparency_page() {
+                $page_id = absint( get_option( self::OPTION_TRANSPARENCY_PAGE, 0 ) );
+                if ( ! $page_id ) {
+                        return null;
+                }
+                $page = get_post( $page_id );
+                if ( ! $page instanceof WP_Post || 'page' !== $page->post_type || 'trash' === $page->post_status ) {
+                        return null;
+                }
+                return $page;
+        }
+        /**
+         * Create a draft "AI transparency" page containing the legend shortcode.
+         *
+         * The page is only ever created on an explicit administrator action and is
+         * always left as a draft, so nothing is published without review.
+         *
+         * @return void
+         */
+        public function handle_create_transparency_page() {
+                if ( ! current_user_can( 'manage_options' ) || ! current_user_can( 'publish_pages' ) ) {
+                        wp_die(
+                                esc_html__( 'You do not have permission to create this page.', 'oznaczai-image-labeling' ),
+                                '',
+                                array( 'response' => 403 )
+                        );
+                }
+                check_admin_referer( 'oznaczai_image_labeling_create_transparency_page' );
+                $settings_url = admin_url( 'admin.php?page=oznaczai-image-labeling' );
+                $existing     = $this->get_transparency_page();
+                if ( $existing instanceof WP_Post ) {
+                        wp_safe_redirect( add_query_arg( 'oznaczai_image_labeling_page', 'exists', $settings_url ) );
+                        exit;
+                }
+                $page_id = wp_insert_post(
+                        array(
+                                'post_title'   => __( 'AI transparency', 'oznaczai-image-labeling' ),
+                                'post_content' => '[oznaczai_transparency_legend]',
+                                'post_status'  => 'draft',
+                                'post_type'    => 'page',
+                        ),
+                        true
+                );
+                if ( is_wp_error( $page_id ) || ! $page_id ) {
+                        wp_safe_redirect( add_query_arg( 'oznaczai_image_labeling_page', 'error', $settings_url ) );
+                        exit;
+                }
+                update_option( self::OPTION_TRANSPARENCY_PAGE, absint( $page_id ), false );
+                wp_safe_redirect( add_query_arg( 'oznaczai_image_labeling_page', 'created', $settings_url ) );
+                exit;
+        }
+        /**
+         * Show the result of the transparency page action.
+         *
+         * @return void
+         */
+        public function show_transparency_page_notice() {
+                // The notice belongs to the OznaczAI settings screen, which is where the
+                // action redirects back to. Restricting it here stops the query parameter
+                // from surfacing the notice on unrelated wp-admin screens.
+                $screen = function_exists( 'get_current_screen' ) ? get_current_screen() : null;
+                if ( ! $screen || 'toplevel_page_oznaczai-image-labeling' !== $screen->id ) {
+                        return;
+                }
+                // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only admin notice flag; value is sanitized, whitelisted, and does not mutate data.
+                if ( ! isset( $_GET['oznaczai_image_labeling_page'] ) || ! current_user_can( 'manage_options' ) ) {
+                        return;
+                }
+                // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only admin notice flag; value is sanitized, whitelisted, and does not mutate data.
+                $result = sanitize_key( wp_unslash( $_GET['oznaczai_image_labeling_page'] ) );
+                $page   = $this->get_transparency_page();
+                if ( 'error' === $result ) {
+                        printf(
+                                '<div class="notice notice-error is-dismissible"><p>%s</p></div>',
+                                esc_html__( 'The AI transparency page could not be created.', 'oznaczai-image-labeling' )
+                        );
+                        return;
+                }
+                if ( ! in_array( $result, array( 'created', 'exists' ), true ) || ! $page instanceof WP_Post ) {
+                        return;
+                }
+                $message = 'created' === $result
+                        ? __( 'Draft page created. Review the wording and publish it when you are ready.', 'oznaczai-image-labeling' )
+                        : __( 'The AI transparency page already exists.', 'oznaczai-image-labeling' );
+                printf(
+                        '<div class="notice notice-success is-dismissible"><p>%1$s <a href="%2$s">%3$s</a></p></div>',
+                        esc_html( $message ),
+                        esc_url( (string) get_edit_post_link( $page->ID, 'url' ) ),
+                        esc_html__( 'Edit the page', 'oznaczai-image-labeling' )
+                );
+        }
+        /**
          * Add media list column.
+         *
 …
         /**
+         * Available Media Library filter choices.
+         *
+         * @return array<string,string>
+         */
+        private function get_media_filter_choices() {
+                return array(
+                        'generated'     => __( 'AI label: AI-generated', 'oznaczai-image-labeling' ),
+                        'modified'      => __( 'AI label: AI-modified', 'oznaczai-image-labeling' ),
+                        'visualization' => __( 'AI label: AI visualization', 'oznaczai-image-labeling' ),
+                        'unlabeled'     => __( 'AI label: no label', 'oznaczai-image-labeling' ),
+                        'hint'          => __( 'AI label: metadata hint found', 'oznaczai-image-labeling' ),
+                );
+        }
+        /**
+         * Read the requested Media Library filter.
+         *
+         * @return string Empty string when no supported filter is active.
+         */
+        private function get_requested_media_filter() {
+                // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only list table filter, mirrors the core media type and date filters.
+                if ( ! isset( $_GET['oznaczai_image_labeling_filter'] ) ) {
+                        return '';
+                }
+                // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only list table filter, mirrors the core media type and date filters.
+                $filter = sanitize_key( wp_unslash( $_GET['oznaczai_image_labeling_filter'] ) );
+                return array_key_exists( $filter, $this->get_media_filter_choices() ) ? $filter : '';
+        }
+        /**
+         * Render the OznaczAI filter next to the native Media Library filters.
+         *
+         * @param string $post_type Current list table post type.
+         * @param string $which     Tablenav position.
+         * @return void
+         */
+        public function render_media_library_filter( $post_type, $which ) {
+                global $pagenow;
+                if ( 'attachment' !== $post_type || 'upload.php' !== $pagenow || ! current_user_can( 'upload_files' ) ) {
+                        return;
+                }
+                // The media list table renders this action twice; only the top bar carries
+                // the native filter controls and the Filter submit button.
+                if ( 'bar' !== $which ) {
+                        return;
+                }
+                $current = $this->get_requested_media_filter();
+                echo '<label class="screen-reader-text" for="oznaczai-image-labeling-filter">';
+                esc_html_e( 'Filter by AI label', 'oznaczai-image-labeling' );
+                echo '</label>';
+                echo '<select name="oznaczai_image_labeling_filter" id="oznaczai-image-labeling-filter">';
+                printf(
+                        '<option value=""%1$s>%2$s</option>',
+                        selected( $current, '', false ),
+                        esc_html__( 'All AI labels', 'oznaczai-image-labeling' )
+                );
+                foreach ( $this->get_media_filter_choices() as $value => $label ) {
+                        printf(
+                                '<option value="%1$s"%2$s>%3$s</option>',
+                                esc_attr( $value ),
+                                selected( $current, $value, false ),
+                                esc_html( $label )
+                        );
+                }
+                echo '</select>';
+        }
+        /**
+         * Apply the OznaczAI filter to the Media Library list query.
+         *
+         * Filtering happens in the WordPress query so large libraries are never
+         * transferred to the browser.
+         *
+         * @param WP_Query $query Current query.
+         * @return void
+         */
+        public function filter_media_library_query( $query ) {
+                global $pagenow;
+                if ( ! is_admin() || ! $query instanceof WP_Query || ! $query->is_main_query() ) {
+                        return;
+                }
+                if ( 'upload.php' !== $pagenow || ! current_user_can( 'upload_files' ) ) {
+                        return;
+                }
+                $filter = $this->get_requested_media_filter();
+                if ( '' === $filter ) {
+                        return;
+                }
+                $meta_query = $query->get( 'meta_query' );
+                $meta_query = is_array( $meta_query ) ? $meta_query : array();
+                if ( 'hint' === $filter ) {
+                        $meta_query[] = array(
+                                'key'     => self::META_DETECTION_STATUS,
+                                'compare' => 'EXISTS',
+                        );
+                } elseif ( 'unlabeled' === $filter ) {
+                        // Current releases delete the meta row when a label is removed, but an
+                        // installation upgraded from an older version can still hold an empty
+                        // or explicit 'none' value, so both shapes count as unlabeled.
+                        $meta_query[] = array(
+                                'relation' => 'OR',
+                                array(
+                                        'key'     => self::META_STATUS,
+                                        'compare' => 'NOT EXISTS',
+                                ),
+                                array(
+                                        'key'     => self::META_STATUS,
+                                        'value'   => array( '', 'none' ),
+                                        'compare' => 'IN',
+                                ),
+                        );
+                } else {
+                        $meta_query[] = array(
+                                'key'     => self::META_STATUS,
+                                'value'   => $filter,
+                                'compare' => '=',
+                        );
+                }
+                $query->set( 'meta_query', $meta_query );
+                // OznaczAI only labels images. Without this, every PDF and video would
+                // appear under "no label". An explicit media type choice still wins.
+                if ( in_array( $filter, array( 'unlabeled', 'hint' ), true ) && ! $query->get( 'post_mime_type' ) ) {
+                        $query->set( 'post_mime_type', 'image' );
+                }
+        }
+        /**
          * Save status changed directly in the Media list.
+         *
 …
                         unset( $this->status_cache[ $post_id ], $this->label_cache[ $post_id ] );
                         $this->update_labeled_media_index( $post_id, $status );
+                        $this->update_labeled_media_index( $post_id, $status, true );
                         ++$count;
+                }
                 if ( $count > 0 ) {
+                        $this->persist_labeled_media_index();
                         $this->clear_media_map_cache();
                         $this->purge_page_cache();

oznaczai-image-labeling/tags/1.7.0/oznaczai.php

-              r3641997
+              r3705284
  * Plugin Name: OznaczAI – AI Image Disclosure for EU AI Act
  * Description: Adds visible labels to AI-generated and AI-modified images to support transparency disclosures, including EU AI Act use cases.
  * Version:     1.6.24
+ * Version:     1.7.0
  * Author:      Golden Pixel
  * License:     GPL-2.0-or-later
 …
  * Text Domain: oznaczai-image-labeling
  * Requires at least: 6.2
  * Tested up to: 7.0
+ * Tested up to: 7.1
  * Requires PHP: 7.4
  */
 …
+}
 define( 'OZNACZAI_IMAGE_LABELING_VERSION', '1.6.24' );
+define( 'OZNACZAI_IMAGE_LABELING_VERSION', '1.7.0' );
 define( 'OZNACZAI_IMAGE_LABELING_FILE', __FILE__ );
 define( 'OZNACZAI_IMAGE_LABELING_DIR', plugin_dir_path( __FILE__ ) );

oznaczai-image-labeling/tags/1.7.0/readme.txt

-              r3641997
+              r3705284
 Tags: eu ai act, ai disclosure, ai transparency, deepfake, image labeling
 Requires at least: 6.2
 Tested up to: 7.0
+Tested up to: 7.1
 Requires PHP: 7.4
 Stable tag: 1.6.24
+Stable tag: 1.7.0
 License: GPLv2 or later
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
 …
 * No label
-== Screenshots ==
-. Label AI-generated and AI-modified images directly from the WordPress Media Library.
-. Configure label presets, custom styling, hero and slider labels, and live preview.
-. Visible AI disclosure labels on a real website, including hero images and images inside page content.
-. Responsive AI labels automatically adapt between full text and a compact AI symbol on smaller screens.
 = Main features =
 * Quick status selection in the Media Library list view
 * Automatic saving without opening each attachment
+* Filter the Media Library by AI label, including images with no label
 * Bulk labeling for multiple images
 * Custom label wording
 …
 The Caption below image preset places the disclosure outside the image so it does not cover visual content.
+= Label symbol =
+The label symbol is separate from the label preset, so any symbol can be combined with any preset.
+* OznaczAI symbol (default)
+* EU AI icon
+* EU AI icons per label type
+The EU options use the official European Commission icons for labelling AI-generated content. AI-generated uses the Fully AI-Generated icon and AI-modified uses the Partially AI-Modified icon. AI visualization always uses the neutral EU AI icon, because no official variant carries that meaning.
+Choosing an EU icon does not change what your labels mean and is not a statement about legal compliance. Existing installations keep the OznaczAI symbol until the setting is changed.
+= AI transparency legend =
+The shortcode below outputs a short, neutral legend that explains the labels used on your site. It follows your current label texts and symbol automatically.
+[oznaczai_transparency_legend]
+You can optionally create a draft page containing this legend from the plugin settings screen. The page is never published automatically.
 == Installation ==
 …
 No WordPress plugin can provide or guarantee complete legal compliance. Site owners should assess their own content, role, audience, and applicable legal requirements.
+== Third-party assets ==
+The optional EU label symbols are the official icons for labelling AI-generated content published by the European Commission at https://digital-strategy.ec.europa.eu/en/policies/eu-icons-labelling-ai-generated-content
+The published terms state that the icons "are made publicly available for everyone to use freely, without the need for attribution to the Commission or the AI Office". The files bundled with OznaczAI are unmodified copies of the official SVG assets; only their file names were changed. See assets/icons/eu/README.txt in the plugin folder for the recorded source and terms.
+OznaczAI is not affiliated with, endorsed by, or approved by the European Commission or the AI Office. Displaying an icon does not establish that any legal obligation applies to an image or that it has been met.
 == Privacy ==
 …
 It automatically detects many common WordPress and Elementor implementations, including Slider Revolution 6/7 image layers and slide backgrounds. Custom themes or other third-party widgets may require one of the fallback CSS classes or the background label shortcode.
+== Screenshots ==
+. Label AI-generated and AI-modified images directly from the WordPress Media Library.
+. Configure label presets, custom styling, hero and slider labels, and live preview.
+. Visible AI disclosure labels on a real website, including hero images and images inside page content.
+. Responsive AI labels automatically adapt between full text and a compact AI symbol on smaller screens.
 == Changelog ==
+= 1.7.0 =
+* Fixed a feedback loop where the page observer reacted to the plugin's own DOM updates and kept re-scanning the page after it had settled.
+* Labeled images are no longer reprocessed on every scan, so contrast sampling now runs once per image instead of repeatedly.
+* Added a per-slide cache for Slider Revolution detection and stopped re-measuring hero, banner and Elementor elements that were already checked.
+* Narrowed the page observer and made it scan only the changed part of the page. Dynamically added Elementor content, lazy-loaded backgrounds and Slider Revolution 6/7 are still detected.
+* Stopped rebuilding the labeled media cache after uploads and thumbnail regeneration of media that carries no label.
+* Removed a database write that could happen while a public page was being rendered.
+* Bulk labeling now writes the labeled media index once instead of once per image.
+* Reduced the size of the labeled media data passed to the browser by removing duplicated entries.
+* The legacy storage migration now runs only on install and version change instead of on every request.
+* Fixed a migration from very old versions that could store a label preset that no longer exists.
+* Added an AI label filter to the Media Library list view, including images with no label and images with a metadata hint.
+* Added the [oznaczai_transparency_legend] shortcode, and an optional action that creates a draft page containing it.
+* Added optional official European Commission icons for labelling AI-generated content as an alternative label symbol. The OznaczAI symbol remains the default and existing labels are unchanged.
+* Removed settings screen code that was no longer used by the current panel.
 = 1.6.24 =

oznaczai-image-labeling/tags/1.7.0/uninstall.php

-              r3641997
+              r3705284
 delete_option( 'oznaczai_image_labeling_labeled_media_ids' );
 delete_option( 'oznaczai_image_labeling_version' );
+/*
+ * Only the stored reference is removed. Any page created through the
+ * "AI transparency" action is ordinary site content that the administrator
+ * owns and may have edited or published, so it is never deleted here.
+ */
+delete_option( 'oznaczai_image_labeling_transparency_page_id' );
 delete_transient( 'oznaczai_image_labeling_media_map_v1' );

oznaczai-image-labeling/trunk/assets/css/admin.css

-              r3641997
+              r3705284
+}
+/* Image symbol variants inside the admin previews. Mirrors the frontend rule so
+   the preview keeps its WYSIWYG promise. */
+.oznaczai-preset-demo b.oznaczai-preview-symbol--image,
+.oznaczai-preview-badge b.oznaczai-preview-symbol--image,
+.oznaczai-symbol-preview b.oznaczai-preview-symbol--image {
+        min-width: 0;
+        width: calc(18px * var(--oznaczai-preview-icon-ratio, 1));
+        height: 18px;
+        border-radius: 0;
+        background-color: transparent;
+        background-image: var(--oznaczai-preview-icon-on-light);
+        background-repeat: no-repeat;
+        background-position: center;
+        background-size: contain;
+        font-size: 0;
+}
+.oznaczai-preview-badge--minimal b.oznaczai-preview-symbol--image,
+.oznaczai-preview-badge--dark b.oznaczai-preview-symbol--image,
+.oznaczai-preview-badge--contrast-light b.oznaczai-preview-symbol--image {
+        background-image: var(--oznaczai-preview-icon-on-dark);
+}
 .oznaczai-preview-badge--icon-only {
         width: 24px;
 …
         border-top: 1px solid #e4e8ef;
         align-items: start;
+}
+.oznaczai-shortcode {
+        display: inline-block;
+        padding: 4px 8px;
+        border: 1px solid #e4e8ef;
+        border-radius: 4px;
+        background: #f6f7f9;
+        font-size: 12px;
+}
+.oznaczai-symbol-row {
+        display: grid;
+        grid-template-columns: minmax(0, 280px) minmax(0, 1fr);
+        gap: 12px 24px;
+        align-items: start;
+        margin-top: 18px;
+        padding-top: 16px;
+        border-top: 1px solid #e4e8ef;
+}
+.oznaczai-symbol-row > .description {
+        margin: 0;
+        align-self: center;
+        color: #6b7280;
+        font-size: 12px;
+        line-height: 1.5;
+}
+.oznaczai-symbol-row > .oznaczai-toggle {
+        grid-column: 1 / -1;
+}
+@media (max-width: 782px) {
+        .oznaczai-symbol-row {
+                grid-template-columns: minmax(0, 1fr);
+        }
+}

oznaczai-image-labeling/trunk/assets/css/frontend.css

-              r3641997
+              r3705284
+}
+/* AI transparency legend ([oznaczai_transparency_legend]).
+   Deliberately plain: it inherits the theme's typography and colours so it
+   reads as part of the page rather than as a plugin widget. */
+.oznaczai-legend {
+        margin: 0 0 1.5em;
+}
+.oznaczai-legend__title {
+        margin: 0 0 0.75em;
+        font-size: 1.15em;
+}
+.oznaczai-legend__list {
+        margin: 0;
+        padding: 0;
+        list-style: none;
+}
+.oznaczai-legend__item {
+        display: flex;
+        align-items: flex-start;
+        gap: 0.75em;
+        padding: 0.6em 0;
+        border-bottom: 1px solid rgba(127, 127, 127, 0.22);
+}
+.oznaczai-legend__item:last-child {
+        border-bottom: 0;
+}
+.oznaczai-legend__symbol {
+        display: inline-flex;
+        align-items: center;
+        justify-content: center;
+        flex: 0 0 auto;
+        width: 20px;
+        height: 20px;
+        margin-top: 0.15em;
+        border-radius: 3px;
+        background: rgba(127, 127, 127, 0.16);
+        font-size: 9px;
+        font-weight: 600;
+        line-height: 1;
+}
+.oznaczai-legend__symbol--image {
+        width: auto;
+        max-width: 100%;
+        border-radius: 0;
+        background: none;
+}
+.oznaczai-legend__body {
+        display: flex;
+        flex-direction: column;
+        gap: 0.15em;
+        min-width: 0;
+}
+.oznaczai-legend__name {
+        font-weight: 600;
+}
+.oznaczai-legend__description {
+        opacity: 0.85;
+}
+.oznaczai-legend__note {
+        margin: 0.9em 0 0;
+        font-size: 0.875em;
+        opacity: 0.75;
+}
+/* Image symbol variants (official EU icons).
+   The artwork is a fixed two-tone drawing, so it is placed as an image rather
+   than recoloured. The white artwork is the default because the default preset
+   draws a light label on a dark translucent surface; the black artwork is used
+   wherever the label sits on a light surface. */
+.oznaczai-badge__icon--image {
+        width: calc(var(--oznaczai-icon-size, 13px) * var(--oznaczai-icon-ratio, 1));
+        height: var(--oznaczai-icon-size, 13px);
+        border-radius: 0;
+        background-color: transparent;
+        background-image: var(--oznaczai-icon-on-dark);
+        background-repeat: no-repeat;
+        background-position: center;
+        background-size: contain;
+        font-size: 0;
+}
+.oznaczai-badge--light .oznaczai-badge__icon--image,
+.oznaczai-badge--glass .oznaczai-badge__icon--image,
+.oznaczai-badge--caption .oznaczai-badge__icon--image,
+.oznaczai-badge--icon-only .oznaczai-badge__icon--image,
+.oznaczai-badge--contrast-dark .oznaczai-badge__icon--image,
+.oznaczai-bg-note.oznaczai-badge--contrast-dark .oznaczai-badge__icon--image {
+        background-color: transparent;
+        background-image: var(--oznaczai-icon-on-light);
+}
+.oznaczai-badge--contrast-light .oznaczai-badge__icon--image,
+.oznaczai-bg-note.oznaczai-badge--contrast-light .oznaczai-badge__icon--image {
+        background-color: transparent;
+        background-image: var(--oznaczai-icon-on-dark);
+}
+/* When the symbol already spells out its own meaning there is no text node to
+   space away from it. */
+.oznaczai-badge--symbol-lockup {
+        gap: 0;
+}
 .oznaczai-badge__text {
         min-width: 0;

oznaczai-image-labeling/trunk/assets/js/admin.js

-              r3641997
+              r3705284
+                }
+                function renderBadge(element, template, label, forceIcon) {
+                function escapeAttribute(value) {
+                        return escapeText(value).replace(/"/g, '&quot;');
+                }
+                function activeSymbol(status) {
+                        var variants = window.oznaczaiImageLabelingAdmin && window.oznaczaiImageLabelingAdmin.iconVariants
+                                ? window.oznaczaiImageLabelingAdmin.iconVariants
+                                : {};
+                        var variant = variants[fieldValue('icon_variant', 'oznaczai')] || variants.oznaczai;
+                        if (!variant || !variant.symbols) {
+                                return null;
+                        }
+                        return variant.symbols[status] || variant.symbols.generated || null;
+                }
+                function symbolMarkup(status) {
+                        var symbol = activeSymbol(status);
+                        if (symbol && symbol.onLight && symbol.onDark) {
+                                return '<b aria-hidden="true" class="oznaczai-preview-symbol--image" style="' +
+                                        '--oznaczai-preview-icon-on-light:url(&quot;' + escapeAttribute(symbol.onLight) + '&quot;);' +
+                                        '--oznaczai-preview-icon-on-dark:url(&quot;' + escapeAttribute(symbol.onDark) + '&quot;);' +
+                                        '--oznaczai-preview-icon-ratio:' + (parseFloat(symbol.ratio) || 1) + '"></b>';
+                        }
+                        return '<b aria-hidden="true">' + escapeText(symbol && symbol.text ? symbol.text : 'AI') + '</b>';
+                }
+                // Mirrors shouldRenderText() in frontend.js so the preview cannot promise
+                // something the published label will not do.
+                function symbolCarriesWording(status) {
+                        var symbol = activeSymbol(status);
+                        return !!(symbol && symbol.onLight && symbol.ratio && parseFloat(symbol.ratio) > 1.5);
+                }
+                function renderBadge(element, template, label, forceIcon, status) {
                         var config = applyPresetConfig(element, template);
                         var showIcon = forceIcon || (iconInput && iconInput.checked);
+                        var text = config.iconOnly ? '' : escapeText(label);
+                        var hideText = showIcon && !checked('icon_show_text') && symbolCarriesWording(status || previewType);
+                        var text = (config.iconOnly || hideText) ? '' : escapeText(label);
                         var isPresetDemo = element.hasAttribute('data-oznaczai-preset-preview');
                         var baseClass = isPresetDemo ? 'oznaczai-preset-demo' : 'oznaczai-preview-badge';
 …
                                 element.classList.add('oznaczai-preview-badge--icon-only');
+                        }
                         element.innerHTML = (showIcon ? '<b aria-hidden="true">AI</b>' : '') + text;
+                        element.innerHTML = (showIcon ? symbolMarkup(status || previewType) : '') + text;
                         element.setAttribute('aria-label', label);
                         return config;
 …
+                        }
                         if (behavior === 'icon' && !previewLabel.querySelector('b')) {
                                 previewLabel.innerHTML = '<b aria-hidden="true">AI</b>';
+                                previewLabel.innerHTML = symbolMarkup(previewType);
+                        }
                         previewLabel.classList.toggle('oznaczai-preview-badge--short-label', behavior === 'short');
 …
                         input.addEventListener('change', refreshPreview);
                 });
+                // Symbol variant and its text toggle change both the live preview and the
+                // preset cards, so the cards are re-rendered too.
+                Array.prototype.forEach.call(
+                        document.querySelectorAll('[data-oznaczai-icon-variant], input[name$="[icon_show_text]"]'),
+                        function (input) {
+                                input.addEventListener('change', function () {
+                                        renderPresetCards();
+                                        refreshPreview();
+                                });
+                        }
+                );
                 document.addEventListener('click', function (event) {

oznaczai-image-labeling/trunk/assets/js/frontend.js

-              r3641997
+              r3705284
                 '[style*="background-image"]'
         ].join(',');
+        var revolutionSelector = 'sr7-module, rs-module';
+        var ownNodeSelector = '.oznaczai-badge, .oznaczai-bg-note, .oznaczai-popover';
         var scheduled = false;
         var config = window.oznaczaiImageLabelingFrontend || {};
         var mediaMap = config.mediaMap || {};
         var schemaEntries = {};
+        var schemaDirty = false;
+        // Scan scheduling state. The observer collects the smallest useful roots
+        // instead of forcing a full document rescan for every unrelated mutation.
+        var pendingRoots = [];
+        var pendingFull = false;
+        var maxPendingRoots = 60;
+        // Guards against the observer reacting to OznaczAI's own DOM writes.
+        var applying = 0;
+        var observer = null;
+        // Caches. WeakMap/WeakSet keep entries collectable with their elements.
+        var revolutionCache = new WeakMap();
+        var revolutionEpoch = 0;
+        var contrastKeys = new WeakMap();
+        var noteSignatures = new WeakMap();
+        var inlineBackgrounds = new WeakMap();
+        var loadWatched = new WeakSet();
+        var sliderScanQueued = new WeakSet();
+        var resizeTimer = null;
         function meaningfulChildren(element) {
 …
+        }
+        function buildIcon() {
+        function iconVariant() {
+                var variants = config.iconVariants || {};
+                var key = config.iconVariant || 'oznaczai';
+                return variants[key] || variants.oznaczai || null;
+        }
+        function resolveSymbol(status) {
+                var variant = iconVariant();
+                if (!variant || !variant.symbols) {
+                        return null;
+                }
+                return variant.symbols[status] || variant.symbols.generated || null;
+        }
+        function buildIcon(status) {
                 var icon = document.createElement('span');
+                var symbol = resolveSymbol(status);
                 icon.className = 'oznaczai-badge__icon';
                 icon.setAttribute('aria-hidden', 'true');
+                icon.textContent = 'AI';
+                // Image symbols are drawn from a file rather than inlined, so the same
+                // asset is cached once and the markup stays small on every page.
+                if (symbol && symbol.onLight && symbol.onDark) {
+                        icon.classList.add('oznaczai-badge__icon--image');
+                        icon.style.setProperty('--oznaczai-icon-on-light', 'url("' + symbol.onLight + '")');
+                        icon.style.setProperty('--oznaczai-icon-on-dark', 'url("' + symbol.onDark + '")');
+                        icon.style.setProperty('--oznaczai-icon-ratio', symbol.ratio || 1);
+                        return icon;
+                }
+                icon.textContent = symbol && symbol.text ? symbol.text : 'AI';
                 return icon;
+        }
+        function fillLabel(element, label, showIcon) {
+        /**
+         * Decide whether the wording is drawn beside the symbol. It is always kept
+         * when there is no symbol, and it is only dropped for symbols that already
+         * spell out their own meaning.
+         */
+        function shouldRenderText(status, showIcon) {
+                var symbol;
+                if (!showIcon || config.iconShowText !== false) {
+                        return true;
+                }
+                symbol = resolveSymbol(status);
+                return !(symbol && symbol.onLight && symbol.ratio && symbol.ratio > 1.5);
+        }
+        function fillLabel(element, label, showIcon, status) {
+                var withText = shouldRenderText(status, showIcon);
                 element.textContent = '';
                 if (showIcon) {
+                        element.appendChild(buildIcon());
+                }
+                element.appendChild(buildBadgeTextElement(label));
+                        element.appendChild(buildIcon(status));
+                }
+                if (withText) {
+                        element.appendChild(buildBadgeTextElement(label));
+                }
+                element.classList.toggle('oznaczai-badge--symbol-lockup', !withText);
+                // The accessible name always carries the full wording, including when the
+                // visible text is suppressed or the symbol is image-only.
                 element.setAttribute('role', 'note');
                 element.setAttribute('aria-label', label);
 …
+        }
+        /**
+         * Build a cheap key describing every input the contrast result depends on.
+         * Canvas sampling only runs again when one of these actually changed.
+         */
+        function contrastKey(badge, source) {
+                var badgeRect = badge.getBoundingClientRect();
+                var sourceKey = '';
+                if (source && source.tagName === 'IMG') {
+                        sourceKey = (source.currentSrc || source.getAttribute('src') || '') + ':' + (source.complete ? '1' : '0');
+                }
+                return [
+                        sourceKey,
+                        Math.round(badgeRect.width),
+                        Math.round(badgeRect.height),
+                        Math.round(badgeRect.left),
+                        Math.round(badgeRect.top)
+                ].join('|');
+        }
         function applyAutoContrast(badge, source, fallbackElement) {
                 var level;
+                var key;
+                if (!config.autoContrast || !badge || badge.classList.contains('oznaczai-badge--caption')) {
+                        clearContrastClasses(badge);
+                        return;
+                }
+                if (badge.classList.contains('oznaczai-badge--custom') && badge.style.getPropertyValue('--oznaczai-bg-color') === 'transparent') {
+                        clearContrastClasses(badge);
+                        return;
+                }
+                key = contrastKey(badge, source);
+                if (contrastKeys.get(badge) === key) {
+                        return;
+                }
                 clearContrastClasses(badge);
+                if (!config.autoContrast || !badge || badge.classList.contains('oznaczai-badge--caption')) {
+                        return;
+                }
+                if (badge.classList.contains('oznaczai-badge--custom') && badge.style.getPropertyValue('--oznaczai-bg-color') === 'transparent') {
+                        return;
+                }
+                // Record the attempt before sampling. A sample that cannot succeed for
+                // these inputs (tainted canvas, fully transparent ancestry) will not
+                // succeed on a retry either, so retrying costs work and changes nothing.
+                // A genuine change produces a different key and is picked up normally.
+                contrastKeys.set(badge, key);
                 if (source && source.tagName === 'IMG') {
 …
         function getCurrentTemplate() {
                 return config.template || 'minimal';
+        }
-        function templateClasses() {
-                return [
-                        'oznaczai-badge--minimal',
-                        'oznaczai-badge--compact',
-                        'oznaczai-badge--subtle',
-                        'oznaczai-badge--light',
-                        'oznaczai-badge--caption',
-                        'oznaczai-badge--glass',
-                        'oznaczai-badge--dark',
-                        'oznaczai-badge--icon-only'
-                ];
+        }
-        function containerTemplateClasses() {
-                return [
-                        'oznaczai-template--minimal',
-                        'oznaczai-template--compact',
-                        'oznaczai-template--subtle',
-                        'oznaczai-template--light',
-                        'oznaczai-template--caption',
-                        'oznaczai-template--glass',
-                        'oznaczai-template--dark',
-                        'oznaczai-template--icon-only'
-                ];
+        }
 …
         function resolveContextPosition(context, fallback, status, presetOverride) {
-                var style = config.style || {};
-                var hero = style.hero || {};
                 var presetConfigs = config.presetConfigs || {};
                 var custom = resolveStyleCustom(context);
 …
+                }
+                if (schemaEntries[absoluteUrl]) {
+                        return;
+                }
                 schemaEntries[absoluteUrl] = {
                         '@type': 'ImageObject',
 …
                         digitalSourceType: sourceType
                 };
+                schemaDirty = true;
+        }
 …
                 var graph;
                 if (!config.schemaMarkup) {
+                if (!config.schemaMarkup || !schemaDirty) {
                         return;
+                }
 …
                         '@graph': graph
                 });
+                schemaDirty = false;
+        }
 …
                 var device;
                 var behavior;
+                var status;
                 if (!badge) {
 …
+                }
+                status = getImageStatus(image);
                 badge.classList.remove('oznaczai-badge--symbol-only', 'oznaczai-badge--short-label');
                 badge.removeAttribute('title');
 …
                 if (behavior === 'icon') {
                         if (!badge.querySelector('.oznaczai-badge__icon')) {
                                 badge.insertBefore(buildIcon(), badge.firstChild);
+                                badge.insertBefore(buildIcon(status), badge.firstChild);
+                        }
                         badge.classList.add('oznaczai-badge--symbol-only');
 …
                 if (width > 0 && width <= 160) {
                         if (!badge.querySelector('.oznaczai-badge__icon')) {
                                 badge.insertBefore(buildIcon(), badge.firstChild);
+                                badge.insertBefore(buildIcon(status), badge.firstChild);
+                        }
                         badge.classList.remove('oznaczai-badge--short-label');
 …
+        }
+        function refreshResponsiveSymbols() {
+                var images = document.querySelectorAll(imageSelector);
+        function findImageBadge(image) {
+                var container = image.closest('.oznaczai-wrapper, .oznaczai-container, .woocommerce-product-gallery__image');
+                return container ? getDirectBadge(container) : null;
+        }
+        /**
+         * Re-evaluate responsive behaviour for already labeled images. This depends on
+         * viewport and element width, so it runs on resize and after image load only.
+         */
+        function refreshResponsiveSymbols(root) {
+                var scope = root && root.querySelectorAll ? root : document;
+                var images = scope.querySelectorAll(imageSelector);
                 Array.prototype.forEach.call(images, function (image) {
+                        var container = image.closest('.oznaczai-wrapper, .oznaczai-container, .woocommerce-product-gallery__image');
+                        var badge = container ? getDirectBadge(container) : null;
+                        var template = resolveTemplate(getImageStatus(image), image, null);
+                        var showIcon = getCurrentShowIcon();
+                        updateResponsiveBadge(image, badge, template, showIcon, getCurrentImageLabel(image));
+                        var badge = findImageBadge(image);
+                        var template;
+                        if (!badge) {
+                                return;
+                        }
+                        template = resolveTemplate(getImageStatus(image), image, null);
+                        updateResponsiveBadge(image, badge, template, getCurrentShowIcon(), getCurrentImageLabel(image));
+                        applyAutoContrast(badge, image, badge.parentElement);
                 });
+        }
 …
                         return false;
+                }
+                return !!image.closest('sr7-module, rs-module');
+                return !!image.closest(revolutionSelector);
+        }
+        /**
+         * Everything the rendered badge depends on. When this is unchanged there is
+         * nothing to rebuild, so the expensive path is skipped entirely.
+         */
+        function imageSignature(image) {
+                return [
+                        image.getAttribute('data-oznaczai-type') || '',
+                        image.getAttribute('data-oznaczai-label') || '',
+                        image.getAttribute('data-oznaczai-custom-label') || '',
+                        image.getAttribute('data-oznaczai-preset') || ''
+                ].join('|');
+        }
+        function watchImageLoad(image) {
+                if (loadWatched.has(image) || image.complete) {
+                        return;
+                }
+                loadWatched.add(image);
+                image.addEventListener('load', function () {
+                        var badge = findImageBadge(image);
+                        if (!badge) {
+                                return;
+                        }
+                        withOwnMutations(function () {
+                                updateResponsiveBadge(image, badge, resolveTemplate(getImageStatus(image), image, null), getCurrentShowIcon(), getCurrentImageLabel(image));
+                                applyAutoContrast(badge, image, badge.parentElement);
+                        });
+                }, { once: true });
+        }
         function createBadge(image) {
+                var label = getCurrentImageLabel(image);
+                var position = getCurrentPosition();
+                var status = getImageStatus(image);
+                var context = resolveContext(image, null);
+                var template = resolveTemplate(status, image, context);
+                var showIcon = getCurrentShowIcon();
+                var signature = imageSignature(image);
+                var label;
+                var position;
+                var status;
+                var context;
+                var template;
+                var showIcon;
                 var target;
                 var parent;
 …
                 var originalImageWidth;
+                if (image.getAttribute('data-oznaczai-ready') === '1' && image.getAttribute('data-oznaczai-sig') === signature) {
+                        return;
+                }
+                label = getCurrentImageLabel(image);
+                position = getCurrentPosition();
+                status = getImageStatus(image);
+                context = resolveContext(image, null);
+                template = resolveTemplate(status, image, context);
+                showIcon = getCurrentShowIcon();
                 if (!label) {
                         return;
 …
                 if (isManagedByRevolution(image)) {
                         image.setAttribute('data-oznaczai-ready', '1');
+                        return;
+                }
+                registerSchemaEntry(image.currentSrc || image.getAttribute('src'), getImageStatus(image));
+                        image.setAttribute('data-oznaczai-sig', signature);
+                        return;
+                }
+                registerSchemaEntry(image.currentSrc || image.getAttribute('src'), status);
                 originalParentWidth = image.parentElement ? image.parentElement.getBoundingClientRect().width : 0;
 …
                 );
                 badge.classList.add('oznaczai-badge--' + template);
                 fillLabel(badge, label, showIcon);
+                fillLabel(badge, label, showIcon, status);
                 applyStyleData(badge, status, template, context);
                 applyAutoContrast(badge, image, container);
                 updateResponsiveBadge(image, badge, template, showIcon, label);
                 setupPopover(badge, label);
+                watchImageLoad(image);
                 image.setAttribute('data-oznaczai-ready', '1');
+                image.setAttribute('data-oznaczai-sig', signature);
+        }
 …
+        }
+        /**
+         * mediaMap entries no longer carry the label text. Resolve it the same way a
+         * regular image does so background and slider labels stay identical.
+         */
+        function resolveMapLabel(data) {
+                var status = data && data.status ? data.status : 'generated';
+                if (data && data.label) {
+                        return data.label;
+                }
+                return (config.labels && config.labels[status]) || '';
+        }
+        function mapEntryToData(data, url) {
+                if (!data) {
+                        return null;
+                }
+                // NOTE: `preset` is deliberately not carried over. Up to and including
+                // 1.6.24 the background and Slider Revolution extractors never passed the
+                // per-image preset through, so hero/slider labels have always used the
+                // hero preset. Propagating it here would silently restyle existing sites
+                // on upgrade, so the change is left for a release that can announce it.
+                return {
+                        id: data.id,
+                        status: data.status,
+                        label: resolveMapLabel(data),
+                        url: url
+                };
+        }
         function addUniqueUrl(urls, value) {
                 var clean = typeof value === 'string' ? value.trim() : '';
 …
+        }
+        /**
+         * Cheap fingerprint used to decide whether the expensive full slide walk has
+         * to run again. Slider Revolution swaps sources and markup on slide change,
+         * so those are exactly the inputs worth watching.
+         */
+        function revolutionSlideKey(slide) {
+                var image = slide.querySelector ? slide.querySelector('img, sr7-bg, rs-bg') : null;
+                return [
+                        revolutionEpoch,
+                        slide.childElementCount,
+                        image ? (image.getAttribute('src') || image.getAttribute('data-src') || image.getAttribute('data-lazyload') || '') : '',
+                        slide.getAttribute('data-key') || slide.getAttribute('data-skey') || ''
+                ].join('|');
+        }
         function findAutomaticRevolutionSlideData(slide) {
+                var urls = extractRevolutionSlideUrls(slide);
+                var key = revolutionSlideKey(slide);
+                var cached = revolutionCache.get(slide);
+                var urls;
                 var i;
                 var data;
+                var result = null;
+                if (cached && cached.key === key) {
+                        return cached.data;
+                }
+                urls = extractRevolutionSlideUrls(slide);
                 for (i = 0; i < urls.length; i += 1) {
                         data = lookupMedia(urls[i]);
                         if (data) {
+                                return {
+                                        id: data.id,
+                                        status: data.status,
+                                        label: data.label,
+                                        url: urls[i]
+                                };
+                        }
+                }
+                return null;
+                                result = mapEntryToData(data, urls[i]);
+                                break;
+                        }
+                }
+                revolutionCache.set(slide, { key: key, data: result });
+                return result;
+        }
 …
                         data = lookupMedia(urls[i]);
                         if (data) {
+                                return {
+                                        id: data.id,
+                                        status: data.status,
+                                        label: data.label,
+                                        url: urls[i]
+                                };
+                                return mapEntryToData(data, urls[i]);
+                        }
+                }
 …
         function findSliderOwner(element) {
                 var revolution = element.closest('sr7-module, rs-module');
+                var revolution = element.closest(revolutionSelector);
                 if (revolution) {
                         return revolution;
 …
         function findSectionOwner(element) {
                 var revolution = element.closest('sr7-module, rs-module');
+                var revolution = element.closest(revolutionSelector);
                 if (revolution) {
                         return revolution;
 …
                 var note;
                 var template;
+                var signature;
                 if (!owner || !owner.parentNode) {
                         return null;
 …
                         owner.parentNode.insertBefore(note, owner.nextSibling);
+                }
+                setBelowNoteAlignment(note, position);
+                fillLabel(note, label, config.showIcon !== false);
                 status = status || 'generated';
                 context = context || 'background';
                 template = preset || resolveTemplate(status, null, context);
+                signature = [label, position, status, template, context].join('|');
+                // Slider libraries mutate slide classes on every transition frame. Without
+                // this guard the note would be torn down and rebuilt each time.
+                if (noteSignatures.get(note) === signature) {
+                        return note;
+                }
+                noteSignatures.set(note, signature);
+                setBelowNoteAlignment(note, position);
+                fillLabel(note, label, config.showIcon !== false, status);
                 note.classList.remove('oznaczai-badge--minimal', 'oznaczai-badge--compact', 'oznaczai-badge--subtle', 'oznaczai-badge--light', 'oznaczai-badge--caption', 'oznaczai-badge--glass', 'oznaczai-badge--dark', 'oznaczai-badge--icon-only');
                 note.classList.add('oznaczai-badge--' + template);
 …
                 if (active) {
                         labeled = active.hasAttribute('data-oznaczai-slide-label') ? active : null;
                 } else if (slider.matches('sr7-module, rs-module')) {
+                } else if (slider.matches(revolutionSelector)) {
                         labeled = null;
                 } else {
 …
                 if ('MutationObserver' in window) {
                         new MutationObserver(function () {
+                                updateSliderNote(slider);
+                                // Slide transitions fire dozens of records per second. Collapse them
+                                // into one update per frame.
+                                if (sliderScanQueued.has(slider)) {
+                                        return;
+                                }
+                                sliderScanQueued.add(slider);
+                                window.requestAnimationFrame(function () {
+                                        sliderScanQueued.delete(slider);
+                                        withOwnMutations(function () {
+                                                updateSliderNote(slider);
+                                        });
+                                });
                         }).observe(slider, {
                                 attributes: true,
 …
         function createOverlayLabel(target, data, display, context) {
                 var badge = target.querySelector(':scope > .oznaczai-badge.oznaczai-badge--bg');
+                var status = data.status || 'generated';
+                var template;
+                var signature;
                 context = context || 'background';
+                var template = data.preset || resolveTemplate(data.status || 'generated', null, context);
+                template = data.preset || resolveTemplate(status, null, context);
+                signature = [data.label, display, status, template, context].join('|');
+                if (badge && noteSignatures.get(badge) === signature) {
+                        return;
+                }
                 target.classList.add('oznaczai-bg-target');
 …
+                }
+                noteSignatures.set(badge, signature);
                 badge.classList.remove('oznaczai-badge--minimal', 'oznaczai-badge--compact', 'oznaczai-badge--subtle', 'oznaczai-badge--light', 'oznaczai-badge--caption', 'oznaczai-badge--glass', 'oznaczai-badge--dark', 'oznaczai-badge--icon-only', 'oznaczai-badge--hero-bar');
                 badge.classList.add('oznaczai-badge--' + template);
 …
                         badge.classList.add('oznaczai-badge--hero-bar');
+                }
                 fillLabel(badge, data.label, config.showIcon !== false);
                 applyStyleData(badge, data.status || 'generated', template, context);
+                fillLabel(badge, data.label, config.showIcon !== false, status);
+                applyStyleData(badge, status, template, context);
                 applyAutoContrast(badge, null, target);
                 setupPopover(badge, data.label);
 …
                         return;
+                }
+                // A negative result is remembered too. Without this, every generic
+                // hero/banner/Elementor node was re-measured with getComputedStyle on
+                // every single scan.
+                if (target.getAttribute('data-oznaczai-bg-checked') === '1') {
+                        return;
+                }
                 // Real content images are handled by createBadge(). A generic hero/banner
                 // selector must never promote an <img> into a second background disclosure.
                 if (target.matches && target.matches('img, picture, source')) {
+                        target.setAttribute('data-oznaczai-bg-checked', '1');
                         return;
+                }
 …
                 if (data) {
                         applyBackgroundLabel(target, data);
+                }
+                        return;
+                }
+                target.setAttribute('data-oznaczai-bg-checked', '1');
+        }
 …
+        }
+        function scan(root) {
+                var images;
+                var manualBackgrounds;
+                var automaticBackgrounds;
+                var monitoredSliders;
+                var revolutionSliders;
+                root = root || document;
+                images = collect(root, imageSelector);
+                manualBackgrounds = collect(root, manualBackgroundSelector);
+                automaticBackgrounds = config.autoBackgrounds ? collect(root, autoBackgroundSelector) : [];
+                monitoredSliders = collect(root, '[data-oznaczai-slider-observed="1"]');
+                revolutionSliders = config.autoBackgrounds ? collect(root, 'sr7-module, rs-module') : [];
+        function scanRoot(root) {
+                var images = collect(root, imageSelector);
+                var manualBackgrounds = collect(root, manualBackgroundSelector);
+                var automaticBackgrounds = config.autoBackgrounds ? collect(root, autoBackgroundSelector) : [];
+                var revolutionSliders = config.autoBackgrounds ? collect(root, revolutionSelector) : [];
+                var monitoredSliders = collect(root, '[data-oznaczai-slider-observed="1"]');
                 images.forEach(createBadge);
 …
                 revolutionSliders.forEach(scanRevolutionSlider);
                 monitoredSliders.forEach(updateSliderNote);
+                refreshResponsiveSymbols();
+                flushSchemaMarkup();
+        }
+        function scheduleScan() {
+        }
+        /**
+         * Run a callback with the global observer detached so OznaczAI never reacts
+         * to its own DOM writes. disconnect() also empties the pending record queue,
+         * which is what actually breaks the observer -> scan -> observer loop.
+         */
+        function withOwnMutations(callback) {
+                applying += 1;
+                if (observer) {
+                        observer.disconnect();
+                }
+                try {
+                        callback();
+                } finally {
+                        applying -= 1;
+                        if (observer && applying === 0) {
+                                startObserving();
+                        }
+                }
+        }
+        function scan(root) {
+                withOwnMutations(function () {
+                        scanRoot(root || document);
+                        flushSchemaMarkup();
+                });
+        }
+        function isOwnNode(node) {
+                return !!(node && node.nodeType === 1 && node.closest && node.closest(ownNodeSelector));
+        }
+        /**
+         * Compare only the inline background-image declaration. This reads the
+         * element's own style object, so unlike getComputedStyle it does not force
+         * the browser to flush pending style or layout work.
+         */
+        function inlineBackgroundChanged(element) {
+                var current;
+                if (!element || !element.style) {
+                        return true;
+                }
+                current = element.style.backgroundImage || '';
+                if (inlineBackgrounds.get(element) === current) {
+                        return false;
+                }
+                inlineBackgrounds.set(element, current);
+                return true;
+        }
+        function queueRoot(node) {
+                var scopeRoot;
+                if (pendingFull || !node || node.nodeType !== 1 || isOwnNode(node)) {
+                        return;
+                }
+                // Anything inside a Slider Revolution module has to be evaluated at module
+                // level, because slide detection works on the whole module.
+                scopeRoot = node.closest ? node.closest(revolutionSelector) : null;
+                scopeRoot = scopeRoot || node;
+                if (pendingRoots.indexOf(scopeRoot) !== -1) {
+                        return;
+                }
+                if (pendingRoots.length >= maxPendingRoots) {
+                        pendingFull = true;
+                        pendingRoots.length = 0;
+                        return;
+                }
+                pendingRoots.push(scopeRoot);
+        }
+        function runScheduledScan() {
+                var roots = pendingRoots.slice();
+                var full = pendingFull;
+                scheduled = false;
+                pendingRoots.length = 0;
+                pendingFull = false;
+                withOwnMutations(function () {
+                        if (full) {
+                                scanRoot(document);
+                        } else {
+                                roots.forEach(function (root) {
+                                        if (root === document || (root.isConnected !== false)) {
+                                                scanRoot(root);
+                                        }
+                                });
+                        }
+                        flushSchemaMarkup();
+                });
+        }
+        function scheduleScan(full) {
+                if (full === true) {
+                        pendingFull = true;
+                        pendingRoots.length = 0;
+                }
                 if (scheduled) {
                         return;
+                }
                 scheduled = true;
+                window.requestAnimationFrame(function () {
+                        scheduled = false;
+                        scan(document);
+                });
+                window.requestAnimationFrame(runScheduledScan);
+        }
+        function scheduleFullScan() {
+                scheduleScan(true);
+        }
+        function startObserving() {
+                if (!observer) {
+                        return;
+                }
+                observer.observe(document.body, {
+                        childList: true,
+                        subtree: true,
+                        attributes: true,
+                        // `class` is intentionally not observed globally. Slider state classes
+                        // are handled by the per-slider observer in ensureSliderMonitoring(),
+                        // and every other class change on the page is irrelevant to labeling.
+                        attributeFilter: ['style', 'src', 'srcset', 'data-src', 'data-lazyload', 'data-lazysrc', 'data-lazy-src', 'data-bg', 'data-thumb']
+                });
+        }
+        function handleMutations(mutations) {
+                var queued = false;
+                var i;
+                var mutation;
+                var j;
+                var node;
+                if (applying > 0) {
+                        return;
+                }
+                for (i = 0; i < mutations.length; i += 1) {
+                        mutation = mutations[i];
+                        if (mutation.type === 'attributes') {
+                                if (isOwnNode(mutation.target)) {
+                                        continue;
+                                }
+                                // Scroll animations and motion effects rewrite `style` on every
+                                // frame without ever touching the background. Reading the inline
+                                // value is cheap and avoids forcing a style recalculation for
+                                // changes that cannot affect labeling.
+                                if (mutation.attributeName === 'style' && !inlineBackgroundChanged(mutation.target)) {
+                                        continue;
+                                }
+                                // A background source may have just been swapped in, so the cached
+                                // negative result for this element is no longer trustworthy.
+                                if (mutation.target.hasAttribute && mutation.target.hasAttribute('data-oznaczai-bg-checked')) {
+                                        mutation.target.removeAttribute('data-oznaczai-bg-checked');
+                                }
+                                queueRoot(mutation.target);
+                                queued = true;
+                                continue;
+                        }
+                        if (mutation.addedNodes) {
+                                for (j = 0; j < mutation.addedNodes.length; j += 1) {
+                                        node = mutation.addedNodes[j];
+                                        if (node.nodeType !== 1 || isOwnNode(node)) {
+                                                continue;
+                                        }
+                                        queueRoot(node);
+                                        queued = true;
+                                }
+                        }
+                }
+                if (queued) {
+                        scheduleScan();
+                }
+        }
+        function handleResize() {
+                if (resizeTimer) {
+                        window.clearTimeout(resizeTimer);
+                }
+                resizeTimer = window.setTimeout(function () {
+                        resizeTimer = null;
+                        withOwnMutations(function () {
+                                refreshResponsiveSymbols(document);
+                        });
+                }, 200);
+        }
+        function handleRevolutionEvent() {
+                // Slide media changed, so the per-slide URL cache has to be rebuilt.
+                revolutionEpoch += 1;
+                scheduleFullScan();
+        }
         function init() {
                 scan(document);
+                withOwnMutations(function () {
+                        refreshResponsiveSymbols(document);
+                });
+                // Themes and lazy-loaders often finish late. These two passes are cheap
+                // now because processed images short-circuit on their signature.
                 window.setTimeout(function () { scan(document); }, 700);
                 window.setTimeout(function () { scan(document); }, 1800);
                 window.addEventListener('resize', scheduleScan, { passive: true });
+                window.addEventListener('resize', handleResize, { passive: true });
                 // Slider Revolution 7 exposes native lifecycle events. Re-scan after a
 …
                 // current-slide disclosure stay synchronized. Legacy SR6 remains covered
                 // by the DOM observer and data-slideactive monitoring below.
                 document.addEventListener('sr.module.ready', scheduleScan);
                 document.addEventListener('sr.slide.afterChange', scheduleScan);
+                document.addEventListener('sr.module.ready', handleRevolutionEvent);
+                document.addEventListener('sr.slide.afterChange', handleRevolutionEvent);
                 if ('MutationObserver' in window) {
+                        new MutationObserver(function (mutations) {
+                                var shouldScan = mutations.some(function (mutation) {
+                                        return (mutation.addedNodes && mutation.addedNodes.length > 0) || mutation.type === 'attributes';
+                                });
+                                if (shouldScan) {
+                                        scheduleScan();
+                                }
+                        }).observe(document.body, {
+                                childList: true,
+                                subtree: true,
+                                attributes: true,
+                                attributeFilter: ['class', 'style', 'src', 'srcset', 'data-src', 'data-lazyload', 'data-lazysrc', 'data-lazy-src', 'data-bg', 'data-thumb', 'data-current', 'data-slideactive']
+                        });
+                        observer = new MutationObserver(handleMutations);
+                        startObserving();
+                }

oznaczai-image-labeling/trunk/changelog.txt

-              r3641997
+              r3705284
+= 1.7.0 =
+* Fixed a feedback loop where the page observer reacted to the plugin's own DOM updates and kept re-scanning the page after it had settled.
+* Labeled images are no longer reprocessed on every scan, so contrast sampling now runs once per image instead of repeatedly.
+* Added a per-slide cache for Slider Revolution detection and stopped re-measuring hero, banner and Elementor elements that were already checked.
+* Narrowed the page observer and made it scan only the changed part of the page. Dynamically added Elementor content, lazy-loaded backgrounds and Slider Revolution 6/7 are still detected.
+* Stopped rebuilding the labeled media cache after uploads and thumbnail regeneration of media that carries no label.
+* Removed a database write that could happen while a public page was being rendered.
+* Bulk labeling now writes the labeled media index once instead of once per image.
+* Reduced the size of the labeled media data passed to the browser by removing duplicated entries.
+* The legacy storage migration now runs only on install and version change instead of on every request.
+* Fixed a migration from very old versions that could store a label preset that no longer exists.
+* Added an AI label filter to the Media Library list view, including images with no label and images with a metadata hint.
+* Added the [oznaczai_transparency_legend] shortcode, and an optional action that creates a draft page containing it.
+* Added optional official European Commission icons for labelling AI-generated content as an alternative label symbol. The OznaczAI symbol remains the default and existing labels are unchanged.
+* Removed settings screen code that was no longer used by the current panel.
 = 1.6.24 =
 * Rebuilt preset cards with a simple flex column flow so title, description and preview badge can never overlap.

oznaczai-image-labeling/trunk/includes/class-oznaczai-image-labeling-plugin.php

-              r3641997
+              r3705284
         const OPTION_LABELED_IDS        = 'oznaczai_image_labeling_labeled_media_ids';
         const OPTION_VERSION            = 'oznaczai_image_labeling_version';
+        const OPTION_TRANSPARENCY_PAGE  = 'oznaczai_image_labeling_transparency_page_id';
         const TRANSIENT_MEDIA_MAP       = 'oznaczai_image_labeling_media_map_v1';
 …
         /**
+         * Cached labeled attachment index for the current request.
+         *
+         * @var array<int>|null
+         */
+        private $labeled_ids = null;
+        /**
+         * Stale index entries detected while building the media map on a public
+         * request. They are written out on the next administrative save.
+         *
+         * @var array<int>|null
+         */
+        private $labeled_ids_pending_cleanup = null;
+        /**
          * Get singleton instance.
+         *
 …
                 add_filter( 'manage_media_columns', array( $this, 'add_media_column' ) );
                 add_action( 'manage_media_custom_column', array( $this, 'render_media_column' ), 10, 2 );
+                add_action( 'restrict_manage_posts', array( $this, 'render_media_library_filter' ), 10, 2 );
+                add_action( 'pre_get_posts', array( $this, 'filter_media_library_query' ) );
                 add_filter( 'bulk_actions-upload', array( $this, 'add_bulk_actions' ) );
                 add_filter( 'handle_bulk_actions-upload', array( $this, 'handle_bulk_actions' ), 10, 3 );
                 add_action( 'admin_notices', array( $this, 'show_bulk_action_notice' ) );
+                add_action( 'admin_notices', array( $this, 'show_transparency_page_notice' ) );
                 add_action( 'wp_ajax_oznaczai_image_labeling_update_media_status', array( $this, 'ajax_update_media_status' ) );
+                add_action( 'admin_post_oznaczai_image_labeling_create_transparency_page', array( $this, 'handle_create_transparency_page' ) );
                 add_action( 'edit_attachment', array( $this, 'clear_media_map_cache' ) );
 …
          */
         public function maybe_upgrade() {
-                self::migrate_legacy_storage();
                 $stored_version = (string) get_option( self::OPTION_VERSION, '' );
                 if ( '' !== $stored_version && ! version_compare( $stored_version, OZNACZAI_IMAGE_LABELING_VERSION, '<' ) ) {
                         return;
+                }
+                // Only reached on a fresh install or a version change. Installations that
+                // are already up to date no longer pay for the legacy lookup on every
+                // request. Activation still calls this directly, so upgrades that skip
+                // deactivation are covered either way.
+                self::migrate_legacy_storage();
                 if ( '' === $stored_version || version_compare( $stored_version, '1.6.0', '<' ) ) {
 …
                 add_shortcode( 'oznaczai_image_label', array( $this, 'render_badge_shortcode' ) );
                 add_shortcode( 'oznaczai_image_label_background', array( $this, 'render_background_badge_shortcode' ) );
+                add_shortcode( 'oznaczai_transparency_legend', array( $this, 'render_transparency_legend_shortcode' ) );
+        }
 …
                         'hero_position'       => 'below',
                         'show_icon'           => 1,
+                        'icon_variant'        => 'oznaczai',
+                        'icon_show_text'      => 1,
                         'bg_display'          => 'below',
                         'auto_backgrounds'    => 1,
 …
                         if ( empty( $stored['template'] ) && ! empty( $stored['style'] ) ) {
+                                $stored['template'] = 'light' === $stored['style'] ? 'light' : 'subtle';
+                                // 'subtle' was dropped from the preset list, so it resolved to no
+                                // preset configuration and the frontend already fell back to the
+                                // 'minimal' custom properties. Storing 'minimal' keeps exactly the
+                                // same rendered label while making the stored value valid again.
+                                $stored['template'] = 'light' === $stored['style'] ? 'light' : 'minimal';
+                        }
 …
         /**
+         * Label symbol variants.
+         *
+         * A preset controls how the label looks. A symbol variant controls which
+         * mark appears inside it. They are independent on purpose, so every existing
+         * preset keeps working with every symbol.
+         *
+         * The default variant reproduces the historical OznaczAI "AI" mark exactly,
+         * so an upgrade never changes an existing site's labels on its own.
+         *
+         * The bundled EU assets are the official European Commission icons. See
+         * assets/icons/eu/README.txt for their source and terms of use.
+         *
+         * @return array<string,array<string,mixed>>
+         */
+        private static function get_icon_variants() {
+                $base = OZNACZAI_IMAGE_LABELING_URL . 'assets/icons/eu/';
+                $basic = array(
+                        'onLight' => $base . 'eu-ai-black.svg',
+                        'onDark'  => $base . 'eu-ai-white.svg',
+                        'ratio'   => 1,
+                );
+                return array(
+                        'oznaczai'  => array(
+                                'label'   => __( 'OznaczAI symbol', 'oznaczai-image-labeling' ),
+                                'symbols' => array(
+                                        'generated'     => array( 'text' => 'AI' ),
+                                        'modified'      => array( 'text' => 'AI' ),
+                                        'visualization' => array( 'text' => 'AI' ),
+                                ),
+                        ),
+                        'eu-basic'  => array(
+                                'label'   => __( 'EU AI icon', 'oznaczai-image-labeling' ),
+                                'symbols' => array(
+                                        'generated'     => $basic,
+                                        'modified'      => $basic,
+                                        'visualization' => $basic,
+                                ),
+                        ),
+                        'eu-status' => array(
+                                'label'   => __( 'EU AI icons per label type', 'oznaczai-image-labeling' ),
+                                'symbols' => array(
+                                        'generated'     => array(
+                                                'onLight' => $base . 'eu-ai-generated-black.svg',
+                                                'onDark'  => $base . 'eu-ai-generated-white.svg',
+                                                'ratio'   => 3.157,
+                                        ),
+                                        'modified'      => array(
+                                                'onLight' => $base . 'eu-ai-modified-black.svg',
+                                                'onDark'  => $base . 'eu-ai-modified-white.svg',
+                                                'ratio'   => 3,
+                                        ),
+                                        // There is no official variant meaning "visualization", so this
+                                        // status intentionally falls back to the neutral basic icon
+                                        // instead of being presented as fully generated or modified.
+                                        'visualization' => $basic,
+                                ),
+                        ),
+                );
+        }
+        /**
+         * Validate a symbol variant key.
+         *
+         * @param string $variant Variant key.
+         * @return string
+         */
+        private function sanitize_icon_variant( $variant ) {
+                $variant = sanitize_key( $variant );
+                return array_key_exists( $variant, self::get_icon_variants() ) ? $variant : 'oznaczai';
+        }
+        /**
+         * Whether the active symbol variant already carries its own wording.
+         *
+         * The EU per-type assets are wide lockups that spell out their meaning as
+         * vector outlines, so repeating the label text beside them is redundant.
+         *
+         * @param string $variant Variant key.
+         * @return bool
+         */
+        private function icon_variant_has_wording( $variant ) {
+                return 'eu-status' === $variant;
+        }
+        /**
          * Validate a preset key.
+         *
 …
         /**
-         * Return custom style config for a supported visual context.
+         *
-         * @param string $context  Context key.
-         * @param array  $settings Current settings.
-         * @return array
-         */
-        private function get_context_custom_style_config( $context, $settings ) {
-                return array(
-                        'textColor'    => $settings[ 'context_' . $context . '_text_color' ],
-                        'noBackground' => ! empty( $settings[ 'context_' . $context . '_no_background' ] ),
-                        'bgColor'      => $settings[ 'context_' . $context . '_bg_color' ],
-                        'bgOpacity'    => (int) $settings[ 'context_' . $context . '_bg_opacity' ],
-                        'borderColor'  => $settings[ 'context_' . $context . '_border_color' ],
-                        'borderWidth'  => (int) $settings[ 'context_' . $context . '_border_width' ],
-                        'radius'       => (int) $settings[ 'context_' . $context . '_radius' ],
-                        'fontSize'     => (int) $settings[ 'context_' . $context . '_font_size' ],
-                        'fontWeight'   => (int) $settings[ 'context_' . $context . '_font_weight' ],
-                        'paddingX'     => (int) $settings[ 'context_' . $context . '_padding_x' ],
-                        'paddingY'     => (int) $settings[ 'context_' . $context . '_padding_y' ],
-                        'iconColor'    => $settings[ 'context_' . $context . '_icon_color' ],
-                        'iconSize'     => (int) $settings[ 'context_' . $context . '_icon_size' ],
-                        'shadow'       => ! empty( $settings[ 'context_' . $context . '_shadow' ] ),
-                        'position'     => $settings[ 'context_' . $context . '_position' ],
-                );
+        }
-        /**
          * Localized default public labels.
+         *
 …
                         $valid_ids[] = $attachment_id;
+                        $full_url    = wp_get_attachment_url( $attachment_id );
                         $urls        = array_filter(
                                 array(
                                         wp_get_attachment_url( $attachment_id ),
+                                        $full_url,
                                         function_exists( 'wp_get_original_image_url' ) ? wp_get_original_image_url( $attachment_id ) : '',
+                                )
 …
                         $metadata = wp_get_attachment_metadata( $attachment_id );
-                        $full_url = wp_get_attachment_url( $attachment_id );
                         if ( $full_url && is_array( $metadata ) && ! empty( $metadata['sizes'] ) ) {
                                 $base_url = trailingslashit( dirname( $full_url ) );
 …
                                         continue;
+                                }
+                                $map[ $path ]           = $data;
+                                $map[ $path . '.webp' ] = $data;
+                                $webp_path              = preg_replace( '/\.(?:jpe?g|png)$/i', '.webp', $path );
+                                $map[ $path ] = $data;
+                                // A "<file>.webp" companion path is intentionally not stored. The
+                                // frontend lookup already strips a trailing .webp and retries, so
+                                // the extra key was pure duplication of every entry. The variant
+                                // where the extension is replaced is still needed, because that
+                                // form cannot be derived by stripping.
+                                $webp_path = preg_replace( '/\.(?:jpe?g|png)$/i', '.webp', $path );
                                 if ( is_string( $webp_path ) && $webp_path !== $path ) {
                                         $map[ $webp_path ] = $data;
 …
+                }
+                // Stale entries are recorded for the next admin-side write instead of
+                // being flushed here. This method runs on public page views, which must
+                // never issue a database write.
                 if ( $valid_ids !== $ids ) {
                         update_option( self::OPTION_LABELED_IDS, $valid_ids, false );
+                        $this->labeled_ids_pending_cleanup = $valid_ids;
+                }
 …
          */
         private function get_labeled_media_ids() {
+                if ( is_array( $this->labeled_ids ) ) {
+                        return $this->labeled_ids;
+                }
                 $ids = get_option( self::OPTION_LABELED_IDS, null );
                 if ( ! is_array( $ids ) ) {
+                        return $this->rebuild_labeled_media_index();
+                        $this->labeled_ids = $this->rebuild_labeled_media_index();
+                        return $this->labeled_ids;
+                }
                 $ids = array_values( array_unique( array_filter( array_map( 'absint', $ids ) ) ) );
                 sort( $ids, SORT_NUMERIC );
+                $this->labeled_ids = $ids;
                 return $ids;
 …
                 $ids = array_values( array_unique( $ids ) );
                 sort( $ids, SORT_NUMERIC );
+                $this->labeled_ids = $ids;
                 update_option( self::OPTION_LABELED_IDS, $ids, false );
 …
          * @param int    $attachment_id Attachment ID.
          * @param string $status        Sanitized status.
+         * @param bool   $defer         Keep the change in memory instead of writing.
          * @return void
          */
         private function update_labeled_media_index( $attachment_id, $status ) {
+        private function update_labeled_media_index( $attachment_id, $status, $defer = false ) {
                 $attachment_id = absint( $attachment_id );
                 if ( ! $attachment_id ) {
 …
                 sort( $ids, SORT_NUMERIC );
+                $this->labeled_ids = $ids;
+                if ( $defer ) {
+                        return;
+                }
+                $this->persist_labeled_media_index();
+        }
+        /**
+         * Write the labeled media index once.
+         *
+         * Bulk actions collect every change first and call this at the end, so a
+         * 200-image selection performs one write instead of 200.
+         *
+         * @return void
+         */
+        private function persist_labeled_media_index() {
+                $ids = $this->get_labeled_media_ids();
+                if ( is_array( $this->labeled_ids_pending_cleanup ) ) {
+                        $ids = array_values( array_intersect( $ids, $this->labeled_ids_pending_cleanup ) );
+                        sort( $ids, SORT_NUMERIC );
+                        $this->labeled_ids                 = $ids;
+                        $this->labeled_ids_pending_cleanup = null;
+                }
                 update_option( self::OPTION_LABELED_IDS, $ids, false );
+        }
 …
                 $this->update_labeled_media_index( absint( $attachment_id ), 'none' );
                 $this->clear_media_map_cache();
+        }
+        /**
+         * Check whether an attachment currently carries an OznaczAI label.
+         *
+         * @param int $attachment_id Attachment ID.
+         * @return bool
+         */
+        private function is_labeled_attachment( $attachment_id ) {
+                $attachment_id = absint( $attachment_id );
+                if ( ! $attachment_id ) {
+                        return false;
+                }
+                return in_array( $attachment_id, $this->get_labeled_media_ids(), true );
+        }
 …
          */
         public function clear_media_map_cache_after_metadata_update( $data, $attachment_id ) {
+                unset( $attachment_id );
+                // This filter also runs for every plain upload and every thumbnail
+                // regeneration. Rebuilding the whole map for media that carries no label
+                // turned a 500-image import into 500 cold rebuilds on the next page view.
+                if ( ! $this->is_labeled_attachment( $attachment_id ) ) {
+                        return $data;
+                }
                 $this->clear_media_map_cache();
                 return $data;
 …
                                 ),
                                 'presetConfigs'   => self::get_preset_configs(),
+                                'iconVariants'   => self::get_icon_variants(),
+                                'iconVariant'    => $this->sanitize_icon_variant( $settings['icon_variant'] ),
+                                'iconShowText'   => ! empty( $settings['icon_show_text'] ),
                                 'showIcon'       => ! empty( $settings['show_icon'] ),
                                 'template'       => $settings['template'],
 …
                                         array(
                                                 'presetConfigs' => self::get_preset_configs(),
+                                                'iconVariants'  => self::get_icon_variants(),
+                                        )
                                 );
 …
         /**
+         * Register settings and fields.
+         * Register the settings option.
+         *
+         * The screen is rendered by render_settings_page() rather than through
+         * do_settings_sections(), so only the option registration is needed here.
+         * It provides the options.php allow-list entry and the sanitize callback.
+         *
          * @return void
 …
                                 'default'           => self::default_settings(),
+                        )
-                );
-                add_settings_section(
-                        'oznaczai_image_labeling_labels_section',
-                        __( 'Label text', 'oznaczai-image-labeling' ),
-                        '__return_false',
-                        'oznaczai-image-labeling'
-                );
-                $this->register_text_setting_field( 'label_generated', __( 'AI-generated image', 'oznaczai-image-labeling' ) );
-                $this->register_text_setting_field( 'label_modified', __( 'AI-modified image', 'oznaczai-image-labeling' ) );
-                $this->register_text_setting_field( 'label_visualization', __( 'AI visualization', 'oznaczai-image-labeling' ) );
-                add_settings_section(
-                        'oznaczai_image_labeling_appearance_section',
-                        __( 'Label appearance', 'oznaczai-image-labeling' ),
-                        '__return_false',
-                        'oznaczai-image-labeling'
-                );
-                add_settings_field(
-                        'position',
-                        __( 'Position', 'oznaczai-image-labeling' ),
-                        array( $this, 'render_position_field' ),
-                        'oznaczai-image-labeling',
-                        'oznaczai_image_labeling_appearance_section'
-                );
-                add_settings_field(
-                        'template',
-                        __( 'Template', 'oznaczai-image-labeling' ),
-                        array( $this, 'render_template_field' ),
-                        'oznaczai-image-labeling',
-                        'oznaczai_image_labeling_appearance_section'
-                );
-                add_settings_field(
-                        'show_icon',
-                        __( 'AI icon', 'oznaczai-image-labeling' ),
-                        array( $this, 'render_icon_field' ),
-                        'oznaczai-image-labeling',
-                        'oznaczai_image_labeling_appearance_section'
-                );
-                add_settings_field(
-                        'responsive_symbol',
-                        __( 'Small-image symbol', 'oznaczai-image-labeling' ),
-                        array( $this, 'render_responsive_symbol_field' ),
-                        'oznaczai-image-labeling',
-                        'oznaczai_image_labeling_appearance_section'
-                );
-                add_settings_section(
-                        'oznaczai_image_labeling_background_section',
-                        __( 'Hero and background images', 'oznaczai-image-labeling' ),
-                        '__return_false',
-                        'oznaczai-image-labeling'
-                );
-                add_settings_field(
-                        'bg_display',
-                        __( 'Hero / background display', 'oznaczai-image-labeling' ),
-                        array( $this, 'render_bg_display_field' ),
-                        'oznaczai-image-labeling',
-                        'oznaczai_image_labeling_background_section'
-                );
-                add_settings_field(
-                        'auto_backgrounds',
-                        __( 'Automatic detection', 'oznaczai-image-labeling' ),
-                        array( $this, 'render_auto_backgrounds_field' ),
-                        'oznaczai-image-labeling',
-                        'oznaczai_image_labeling_background_section'
-                );
-                add_settings_section(
-                        'oznaczai_image_labeling_metadata_section',
-                        __( 'Metadata and automation', 'oznaczai-image-labeling' ),
-                        '__return_false',
-                        'oznaczai-image-labeling'
-                );
-                add_settings_field(
-                        'detect_metadata',
-                        __( 'Upload metadata hints', 'oznaczai-image-labeling' ),
-                        array( $this, 'render_detect_metadata_field' ),
-                        'oznaczai-image-labeling',
-                        'oznaczai_image_labeling_metadata_section'
-                );
-                add_settings_field(
-                        'schema_markup',
-                        __( 'Schema.org metadata', 'oznaczai-image-labeling' ),
-                        array( $this, 'render_schema_markup_field' ),
-                        'oznaczai-image-labeling',
-                        'oznaczai_image_labeling_metadata_section'
-                );
+        }
-        /**
-         * Register one text option field.
+         *
-         * @param string $key   Setting key.
-         * @param string $label Field label.
-         * @return void
-         */
-        private function register_text_setting_field( $key, $label ) {
-                add_settings_field(
-                        $key,
-                        $label,
-                        array( $this, 'render_text_field' ),
-                        'oznaczai-image-labeling',
-                        'oznaczai_image_labeling_labels_section',
-                        array( 'key' => $key )
                 );
+        }
 …
                         'hero_position'       => isset( $input['hero_position'] ) && in_array( $input['hero_position'], $context_positions, true ) ? sanitize_key( $input['hero_position'] ) : $defaults['hero_position'],
                         'show_icon'           => empty( $input['show_icon'] ) ? 0 : 1,
+                        'icon_variant'        => $this->sanitize_icon_variant( isset( $input['icon_variant'] ) ? $input['icon_variant'] : $defaults['icon_variant'] ),
+                        'icon_show_text'      => empty( $input['icon_show_text'] ) ? 0 : 1,
                         'bg_display'          => isset( $input['bg_display'] ) && in_array( $input['bg_display'], $bg_displays, true ) ? $input['bg_display'] : ( isset( $input['hero_position'] ) && in_array( $input['hero_position'], $bg_displays, true ) ? sanitize_key( $input['hero_position'] ) : $defaults['bg_display'] ),
                         'auto_backgrounds'    => empty( $input['auto_backgrounds'] ) ? 0 : 1,
 …
                 $value = is_numeric( $value ) ? (int) $value : (int) $default;
                 return max( $min, min( $max, $value ) );
+        }
-        /**
-         * Render settings text field.
+         *
-         * @param array $args Field arguments.
-         * @return void
-         */
-        public function render_text_field( $args ) {
-                $settings = $this->get_settings();
-                $key      = $args['key'];
-                $status   = str_replace( 'label_', '', $key );
-                $defaults = $this->get_default_label_texts();
-                $placeholder = isset( $defaults[ $status ] ) ? $defaults[ $status ] : '';
-                printf(
-                        '<input type="text" class="regular-text" maxlength="160" name="%1$s[%2$s]" value="%3$s" placeholder="%4$s">',
-                        esc_attr( self::OPTION_SETTINGS ),
-                        esc_attr( $key ),
-                        esc_attr( $settings[ $key ] ),
-                        esc_attr( $placeholder )
-                );
-                echo '<p class="description">' . esc_html__( 'Leave empty to use the translated default for the active site language.', 'oznaczai-image-labeling' ) . '</p>';
+        }
-        /**
-         * Render position field.
+         *
-         * @return void
-         */
-        public function render_position_field() {
-                $settings = $this->get_settings();
-                $options  = array(
-                        'bottom-left'  => __( 'Bottom left', 'oznaczai-image-labeling' ),
-                        'bottom-right' => __( 'Bottom right', 'oznaczai-image-labeling' ),
-                        'top-left'     => __( 'Top left', 'oznaczai-image-labeling' ),
-                        'top-right'    => __( 'Top right', 'oznaczai-image-labeling' ),
-                );
-                echo '<select name="' . esc_attr( self::OPTION_SETTINGS ) . '[position]">';
-                foreach ( $options as $value => $label ) {
-                        printf(
-                                '<option value="%1$s"%2$s>%3$s</option>',
-                                esc_attr( $value ),
-                                selected( $settings['position'], $value, false ),
-                                esc_html( $label )
-                        );
+                }
-                echo '</select>';
-                echo '<p class="description">' . esc_html__( 'For the Caption below image template, this setting controls left or right caption alignment.', 'oznaczai-image-labeling' ) . '</p>';
+        }
-        /**
-         * Render template field.
+         *
-         * @return void
-         */
-        public function render_template_field() {
-                $settings = $this->get_settings();
-                $options  = array(
-                        'minimal' => array(
-                                'label'       => __( 'Minimal', 'oznaczai-image-labeling' ),
-                                'description' => __( 'The least prominent option. Very light background, without borders or shadows.', 'oznaczai-image-labeling' ),
-                        ),
-                        'compact' => array(
-                                'label'       => __( 'Compact', 'oznaczai-image-labeling' ),
-                                'description' => __( 'A small dark label with restrained visual weight.', 'oznaczai-image-labeling' ),
-                        ),
-                        'subtle'  => array(
-                                'label'       => __( 'Subtle', 'oznaczai-image-labeling' ),
-                                'description' => __( 'A semi-transparent label without shadow or bold text.', 'oznaczai-image-labeling' ),
-                        ),
-                        'light'    => array(
-                                'label'       => __( 'Light', 'oznaczai-image-labeling' ),
-                                'description' => __( 'Light, delicate text with an almost invisible background.', 'oznaczai-image-labeling' ),
-                        ),
-                        'caption'  => array(
-                                'label'       => __( 'Caption below image', 'oznaczai-image-labeling' ),
-                                'description' => __( 'A lightweight caption directly below the image. It does not cover the image.', 'oznaczai-image-labeling' ),
-                        ),
-                );
-                echo '<div class="oznaczai-template-grid">';
-                foreach ( $options as $value => $option ) {
-                        printf(
-                                '<label class="oznaczai-template-option"><input type="radio" name="%1$s[template]" value="%2$s"%3$s><span class="oznaczai-template-card"><span class="oznaczai-template-card__title">%4$s</span><span class="oznaczai-template-preview oznaczai-template-preview--%2$s"><span class="oznaczai-template-preview__icon" aria-hidden="true">AI</span><span>%6$s</span></span><span class="oznaczai-template-card__description">%5$s</span></span></label>',
-                                esc_attr( self::OPTION_SETTINGS ),
-                                esc_attr( $value ),
-                                checked( $settings['template'], $value, false ),
-                                esc_html( $option['label'] ),
-                                esc_html( $option['description'] ),
-                                esc_html__( 'AI-generated image', 'oznaczai-image-labeling' )
-                        );
+                }
-                echo '</div>';
-                echo '<p class="description">' . esc_html__( 'Minimal is the least prominent template. You can also disable the AI icon for an even lighter result.', 'oznaczai-image-labeling' ) . '</p>';
+        }
-        /**
-         * Render icon checkbox.
+         *
-         * @return void
-         */
-        public function render_icon_field() {
-                $settings = $this->get_settings();
-                printf(
-                        '<label><input type="checkbox" name="%1$s[show_icon]" value="1"%2$s> %3$s</label>',
-                        esc_attr( self::OPTION_SETTINGS ),
-                        checked( ! empty( $settings['show_icon'] ), true, false ),
-                        esc_html__( 'Show a small icon next to the text', 'oznaczai-image-labeling' )
-                );
+        }
-        /**
-         * Render small-image symbol setting.
+         *
-         * @return void
-         */
-        public function render_responsive_symbol_field() {
-                $settings = $this->get_settings();
-                printf(
-                        '<label><input type="checkbox" name="%1$s[responsive_symbol]" value="1"%2$s> %3$s</label>',
-                        esc_attr( self::OPTION_SETTINGS ),
-                        checked( ! empty( $settings['responsive_symbol'] ), true, false ),
-                        esc_html__( 'Use a compact AI symbol on small images instead of the full text label', 'oznaczai-image-labeling' )
-                );
-                echo '<p class="description">' . esc_html__( 'The symbol expands to the full label on hover or keyboard focus. The accessible label remains available to assistive technology. Caption below image is never collapsed.', 'oznaczai-image-labeling' ) . '</p>';
+        }
-        /**
-         * Render hero/background display field.
+         *
-         * @return void
-         */
-        public function render_bg_display_field() {
-                $settings = $this->get_settings();
-                $options  = array(
-                        'below'        => __( 'Below image / section', 'oznaczai-image-labeling' ),
-                        'bar'          => __( 'Subtle bar at the bottom of the hero', 'oznaczai-image-labeling' ),
-                        'bottom-left'  => __( 'Bottom left in hero', 'oznaczai-image-labeling' ),
-                        'bottom-right' => __( 'Bottom right in hero', 'oznaczai-image-labeling' ),
-                );
-                echo '<select name="' . esc_attr( self::OPTION_SETTINGS ) . '[bg_display]">';
-                foreach ( $options as $value => $label ) {
-                        printf(
-                                '<option value="%1$s"%2$s>%3$s</option>',
-                                esc_attr( $value ),
-                                selected( $settings['bg_display'], $value, false ),
-                                esc_html( $label )
-                        );
+                }
-                echo '</select>';
-                echo '<p class="description">' . esc_html__( 'For a custom section background, add the CSS class oznaczai-bg-generated, oznaczai-bg-modified, or oznaczai-bg-visualization. The Below image / section option is the safest choice for heroes with their own text.', 'oznaczai-image-labeling' ) . '</p>';
+        }
-        /**
-         * Render automatic background detection field.
+         *
-         * @return void
-         */
-        public function render_auto_backgrounds_field() {
-                $settings = $this->get_settings();
-                printf(
-                        '<label><input type="checkbox" name="%1$s[auto_backgrounds]" value="1"%2$s> %3$s</label>',
-                        esc_attr( self::OPTION_SETTINGS ),
-                        checked( ! empty( $settings['auto_backgrounds'] ), true, false ),
-                        esc_html__( 'Automatically detect labeled images in hero sections, section backgrounds, and Elementor sliders', 'oznaczai-image-labeling' )
-                );
-                echo '<p class="description">' . esc_html__( 'Mark the file in the Media Library. No CSS classes or shortcode are required for supported layouts.', 'oznaczai-image-labeling' ) . '</p>';
+        }
-        /**
-         * Render upload metadata detection setting.
+         *
-         * @return void
-         */
-        public function render_detect_metadata_field() {
-                $settings = $this->get_settings();
-                printf(
-                        '<label><input type="checkbox" name="%1$s[detect_metadata]" value="1"%2$s> %3$s</label>',
-                        esc_attr( self::OPTION_SETTINGS ),
-                        checked( ! empty( $settings['detect_metadata'] ), true, false ),
-                        esc_html__( 'Check newly uploaded images for AI-related IPTC/XMP, Content Credentials markers, and common generator signatures', 'oznaczai-image-labeling' )
-                );
-                echo '<p class="description">' . esc_html__( 'Detection only creates a review hint. It never labels an image automatically and does not validate C2PA signatures.', 'oznaczai-image-labeling' ) . '</p>';
+        }
-        /**
-         * Render Schema.org setting.
+         *
-         * @return void
-         */
-        public function render_schema_markup_field() {
-                $settings = $this->get_settings();
-                printf(
-                        '<label><input type="checkbox" name="%1$s[schema_markup]" value="1"%2$s> %3$s</label>',
-                        esc_attr( self::OPTION_SETTINGS ),
-                        checked( ! empty( $settings['schema_markup'] ), true, false ),
-                        esc_html__( 'Add Schema.org digitalSourceType JSON-LD for labeled images found on the page', 'oznaczai-image-labeling' )
-                );
-                echo '<p class="description">' . esc_html__( 'This is machine-readable publisher metadata. It is separate from Content Credentials and does not provide or guarantee legal compliance.', 'oznaczai-image-labeling' ) . '</p>';
+        }
 …
                                                                         <?php endforeach; ?>
                                                                 </div>
+                                                                <div class="oznaczai-symbol-row">
+                                                                        <label class="oznaczai-field">
+                                                                                <span><?php esc_html_e( 'Label symbol', 'oznaczai-image-labeling' ); ?></span>
+                                                                                <select name="<?php echo esc_attr( self::OPTION_SETTINGS ); ?>[icon_variant]" data-oznaczai-icon-variant>
+                                                                                        <?php foreach ( self::get_icon_variants() as $variant_key => $variant ) : ?>
+                                                                                                <option value="<?php echo esc_attr( $variant_key ); ?>" <?php selected( $this->sanitize_icon_variant( $settings['icon_variant'] ), $variant_key ); ?>><?php echo esc_html( $variant['label'] ); ?></option>
+                                                                                        <?php endforeach; ?>
+                                                                                </select>
+                                                                        </label>
+                                                                        <p class="description">
+                                                                                <?php esc_html_e( 'The OznaczAI symbol is the default. The EU options use the official European Commission icons for labelling AI-generated content. AI visualization always uses the neutral EU AI icon, because no official variant carries that meaning.', 'oznaczai-image-labeling' ); ?>
+                                                                        </p>
+                                                                        <?php $this->render_toggle_control( 'icon_show_text', __( 'Show text next to the symbol', 'oznaczai-image-labeling' ), __( 'Turn this off to show only the symbol when it already contains its own wording.', 'oznaczai-image-labeling' ), $settings ); ?>
+                                                                </div>
                                                                 <div class="oznaczai-advanced-grid">
                                                                         <?php $this->render_toggle_control( 'show_icon', __( 'Show AI icon', 'oznaczai-image-labeling' ), __( 'Display the small AI mark next to the label text.', 'oznaczai-image-labeling' ), $settings ); ?>
                                                                         <?php $this->render_toggle_control( 'schema_markup', __( 'Schema.org JSON-LD', 'oznaczai-image-labeling' ), __( 'Add digitalSourceType metadata for labeled images found on the page.', 'oznaczai-image-labeling' ), $settings ); ?>
                                                                 </div>
+                                                        </section>
+                                                        <section class="oznaczai-card" id="oznaczai-transparency">
+                                                                <div class="oznaczai-card-head">
+                                                                        <h2><?php esc_html_e( '7. AI transparency legend', 'oznaczai-image-labeling' ); ?></h2>
+                                                                        <span aria-hidden="true">i</span>
+                                                                </div>
+                                                                <p class="oznaczai-card-intro">
+                                                                        <?php esc_html_e( 'Place this shortcode on any page to explain what your AI labels mean. It follows your current label texts and symbol automatically.', 'oznaczai-image-labeling' ); ?>
+                                                                </p>
+                                                                <p><code class="oznaczai-shortcode">[oznaczai_transparency_legend]</code></p>
+                                                                <?php $transparency_page = $this->get_transparency_page(); ?>
+                                                                <?php if ( $transparency_page instanceof WP_Post ) : ?>
+                                                                        <p class="description">
+                                                                                <?php
+                                                                                printf(
+                                                                                        /* translators: %s: link to the existing page. */
+                                                                                        esc_html__( 'A page already exists: %s', 'oznaczai-image-labeling' ),
+                                                                                        '<a href="' . esc_url( (string) get_edit_post_link( $transparency_page->ID, 'url' ) ) . '">' . esc_html( get_the_title( $transparency_page ) ) . '</a>'
+                                                                                );
+                                                                                ?>
+                                                                        </p>
+                                                                <?php elseif ( current_user_can( 'publish_pages' ) ) : ?>
+                                                                        <p class="description"><?php esc_html_e( 'You can also create a draft page containing this legend. It is never published automatically.', 'oznaczai-image-labeling' ); ?></p>
+                                                                        <p>
+                                                                                <a class="button button-secondary" href="<?php echo esc_url( wp_nonce_url( admin_url( 'admin-post.php?action=oznaczai_image_labeling_create_transparency_page' ), 'oznaczai_image_labeling_create_transparency_page' ) ); ?>">
+                                                                                        <?php esc_html_e( 'Create AI transparency page', 'oznaczai-image-labeling' ); ?>
+                                                                                </a>
+                                                                        </p>
+                                                                <?php endif; ?>
                                                         </section>
 …
         /**
-         * Render context appearance controls.
+         *
-         * @param string $context  Context key.
-         * @param string $label    Context label.
-         * @param array  $settings Current settings.
-         * @return void
-         */
-        private function render_context_appearance_controls( $context, $label, $settings ) {
-                $prefix = 'context_' . $context;
-                $positions = array(
-                        'top-left'     => __( 'Top left', 'oznaczai-image-labeling' ),
-                        'top-right'    => __( 'Top right', 'oznaczai-image-labeling' ),
-                        'bottom-left'  => __( 'Bottom left', 'oznaczai-image-labeling' ),
-                        'bottom-right' => __( 'Bottom right', 'oznaczai-image-labeling' ),
-                        'below'        => __( 'Below image / section', 'oznaczai-image-labeling' ),
-                        'bar'          => __( 'Subtle bar', 'oznaczai-image-labeling' ),
-                );
-                ?>
-                <div class="oznaczai-context-style-card" data-oznaczai-context-style="<?php echo esc_attr( $context ); ?>">
-                        <h3><?php echo esc_html( $label ); ?></h3>
-                        <div class="oznaczai-mode-row">
-                                <label><input type="radio" name="<?php echo esc_attr( self::OPTION_SETTINGS ); ?>[<?php echo esc_attr( $prefix ); ?>_mode]" value="global" <?php checked( $settings[ $prefix . '_mode' ], 'global' ); ?> data-oznaczai-context-mode="<?php echo esc_attr( $context ); ?>"> <?php esc_html_e( 'Use global settings', 'oznaczai-image-labeling' ); ?></label>
-                                <label><input type="radio" name="<?php echo esc_attr( self::OPTION_SETTINGS ); ?>[<?php echo esc_attr( $prefix ); ?>_mode]" value="preset" <?php checked( $settings[ $prefix . '_mode' ], 'preset' ); ?> data-oznaczai-context-mode="<?php echo esc_attr( $context ); ?>"> <?php esc_html_e( 'Use separate preset', 'oznaczai-image-labeling' ); ?></label>
-                                <label><input type="radio" name="<?php echo esc_attr( self::OPTION_SETTINGS ); ?>[<?php echo esc_attr( $prefix ); ?>_mode]" value="custom" <?php checked( $settings[ $prefix . '_mode' ], 'custom' ); ?> data-oznaczai-context-mode="<?php echo esc_attr( $context ); ?>"> <?php esc_html_e( 'Customize manually', 'oznaczai-image-labeling' ); ?></label>
-                        </div>
-                        <div data-oznaczai-context-preset="<?php echo esc_attr( $context ); ?>">
-                                <label class="oznaczai-field">
-                                        <span><?php esc_html_e( 'Preset', 'oznaczai-image-labeling' ); ?></span>
-                                        <?php $this->render_preset_select( $prefix . '_preset', $settings[ $prefix . '_preset' ] ); ?>
-                                </label>
-                        </div>
-                        <div class="oznaczai-style-grid" data-oznaczai-context-custom="<?php echo esc_attr( $context ); ?>">
-                                <?php
-                                $this->render_style_input( $prefix . '_text_color', __( 'Text color', 'oznaczai-image-labeling' ), 'color', $settings );
-                                ?>
-                                <div class="oznaczai-background-tools">
-                                        <p class="oznaczai-label"><?php esc_html_e( 'Background', 'oznaczai-image-labeling' ); ?></p>
-                                        <label class="oznaczai-checkline">
-                                                <input type="checkbox" name="<?php echo esc_attr( self::OPTION_SETTINGS ); ?>[<?php echo esc_attr( $prefix ); ?>_no_background]" value="1" <?php checked( ! empty( $settings[ $prefix . '_no_background' ] ) ); ?> data-oznaczai-context-input>
-                                                <?php esc_html_e( 'No background', 'oznaczai-image-labeling' ); ?>
-                                        </label>
-                                </div>
-                                <?php
-                                $this->render_style_input( $prefix . '_bg_color', __( 'Background color', 'oznaczai-image-labeling' ), 'color', $settings );
-                                ?>
-                                <label class="oznaczai-field oznaczai-range-field">
-                                        <span><?php esc_html_e( 'Background opacity', 'oznaczai-image-labeling' ); ?></span>
-                                        <input type="range" min="0" max="100" name="<?php echo esc_attr( self::OPTION_SETTINGS ); ?>[<?php echo esc_attr( $prefix ); ?>_bg_opacity]" value="<?php echo esc_attr( $settings[ $prefix . '_bg_opacity' ] ); ?>" data-oznaczai-context-input>
-                                        <output><?php echo esc_html( absint( $settings[ $prefix . '_bg_opacity' ] ) ); ?>%</output>
-                                </label>
-                                <?php
-                                $this->render_style_input( $prefix . '_border_color', __( 'Border color', 'oznaczai-image-labeling' ), 'color', $settings );
-                                $this->render_style_input( $prefix . '_border_width', __( 'Border width', 'oznaczai-image-labeling' ), 'number', $settings, 0, 6 );
-                                $this->render_style_input( $prefix . '_radius', __( 'Radius', 'oznaczai-image-labeling' ), 'number', $settings, 0, 16 );
-                                $this->render_style_input( $prefix . '_font_size', __( 'Font size', 'oznaczai-image-labeling' ), 'number', $settings, 8, 18 );
-                                $this->render_style_input( $prefix . '_font_weight', __( 'Font weight', 'oznaczai-image-labeling' ), 'number', $settings, 300, 800 );
-                                $this->render_style_input( $prefix . '_padding_x', __( 'Horizontal padding', 'oznaczai-image-labeling' ), 'number', $settings, 0, 24 );
-                                $this->render_style_input( $prefix . '_padding_y', __( 'Vertical padding', 'oznaczai-image-labeling' ), 'number', $settings, 0, 16 );
-                                $this->render_style_input( $prefix . '_icon_color', __( 'AI icon color', 'oznaczai-image-labeling' ), 'color', $settings );
-                                $this->render_style_input( $prefix . '_icon_size', __( 'AI icon size', 'oznaczai-image-labeling' ), 'number', $settings, 8, 24 );
-                                ?>
-                                <?php $this->render_toggle_control( $prefix . '_shadow', __( 'Subtle shadow', 'oznaczai-image-labeling' ), __( 'Add a restrained shadow to this context label.', 'oznaczai-image-labeling' ), $settings ); ?>
-                                <?php if ( in_array( $context, array( 'background', 'slider' ), true ) ) : ?>
-                                        <label class="oznaczai-field">
-                                                <span><?php esc_html_e( 'Label position', 'oznaczai-image-labeling' ); ?></span>
-                                                <select name="<?php echo esc_attr( self::OPTION_SETTINGS ); ?>[<?php echo esc_attr( $prefix ); ?>_position]" data-oznaczai-context-input>
-                                                        <?php foreach ( $positions as $value => $position_label ) : ?>
-                                                                <option value="<?php echo esc_attr( $value ); ?>" <?php selected( $settings[ $prefix . '_position' ], $value ); ?>><?php echo esc_html( $position_label ); ?></option>
-                                                        <?php endforeach; ?>
-                                                </select>
-                                        </label>
-                                <?php endif; ?>
-                        </div>
-                </div>
-                <?php
+        }
-        /**
          * Render a compact style input.
+         *
 …
         /**
+         * Explanations shown in the transparency legend.
+         *
+         * These describe what the site owner stated about an image. They are not
+         * legal statements and must not be worded as any kind of compliance claim.
+         *
+         * @return array<string,string>
+         */
+        private function get_legend_descriptions() {
+                return array(
+                        'generated'     => __( 'The site owner has marked this image as generated using AI.', 'oznaczai-image-labeling' ),
+                        'modified'      => __( 'The site owner has marked this image as modified using AI.', 'oznaczai-image-labeling' ),
+                        'visualization' => __( 'The site owner has marked this image as a visualization created using AI.', 'oznaczai-image-labeling' ),
+                );
+        }
+        /**
+         * Render the symbol used for a status inside the legend.
+         *
+         * @param string $status  Image status.
+         * @param string $variant Active symbol variant.
+         * @return string
+         */
+        private function render_legend_symbol( $status, $variant ) {
+                $variants = self::get_icon_variants();
+                $symbols  = isset( $variants[ $variant ]['symbols'] ) ? $variants[ $variant ]['symbols'] : array();
+                $symbol   = isset( $symbols[ $status ] ) ? $symbols[ $status ] : array();
+                if ( ! empty( $symbol['onLight'] ) ) {
+                        return sprintf(
+                                '<img class="oznaczai-legend__symbol oznaczai-legend__symbol--image" src="%1$s" alt="" width="%2$d" height="20" loading="lazy" decoding="async">',
+                                esc_url( $symbol['onLight'] ),
+                                absint( round( 20 * ( isset( $symbol['ratio'] ) ? (float) $symbol['ratio'] : 1 ) ) )
+                        );
+                }
+                return sprintf(
+                        '<span class="oznaczai-legend__symbol" aria-hidden="true">%s</span>',
+                        esc_html( isset( $symbol['text'] ) ? $symbol['text'] : 'AI' )
+                );
+        }
+        /**
+         * Render the "AI transparency" legend.
+         *
+         * The legend is built from the statuses, label texts and symbol variant that
+         * are actually in use, so it never drifts from what visitors see on images.
+         *
+         * @param array $atts Shortcode attributes.
+         * @return string
+         */
+        public function render_transparency_legend_shortcode( $atts ) {
+                $atts = shortcode_atts(
+                        array(
+                                'title' => '',
+                        ),
+                        $atts,
+                        'oznaczai_transparency_legend'
+                );
+                $settings     = $this->get_settings();
+                $variant      = $this->sanitize_icon_variant( $settings['icon_variant'] );
+                $descriptions = $this->get_legend_descriptions();
+                $title        = $this->sanitize_label( $atts['title'] );
+                $output       = '<div class="oznaczai-legend">';
+                if ( '' !== $title ) {
+                        $output .= '<h2 class="oznaczai-legend__title">' . esc_html( $title ) . '</h2>';
+                }
+                $output .= '<ul class="oznaczai-legend__list">';
+                foreach ( array( 'generated', 'modified', 'visualization' ) as $status ) {
+                        $output .= sprintf(
+                                '<li class="oznaczai-legend__item oznaczai-legend__item--%1$s">%2$s<span class="oznaczai-legend__body"><span class="oznaczai-legend__name">%3$s</span><span class="oznaczai-legend__description">%4$s</span></span></li>',
+                                esc_attr( $status ),
+                                $this->render_legend_symbol( $status, $variant ),
+                                esc_html( $this->get_configured_label( $status ) ),
+                                esc_html( isset( $descriptions[ $status ] ) ? $descriptions[ $status ] : '' )
+                        );
+                }
+                $output .= '</ul>';
+                $output .= '<p class="oznaczai-legend__note">' . esc_html__( 'Labels are applied by the site owner. Not every image created or edited with AI carries a label, and these markings do not constitute a legal assessment.', 'oznaczai-image-labeling' ) . '</p>';
+                $output .= '</div>';
+                return $output;
+        }
+        /**
+         * Return the existing transparency page, if one is still usable.
+         *
+         * @return WP_Post|null
+         */
+        private function get_transparency_page() {
+                $page_id = absint( get_option( self::OPTION_TRANSPARENCY_PAGE, 0 ) );
+                if ( ! $page_id ) {
+                        return null;
+                }
+                $page = get_post( $page_id );
+                if ( ! $page instanceof WP_Post || 'page' !== $page->post_type || 'trash' === $page->post_status ) {
+                        return null;
+                }
+                return $page;
+        }
+        /**
+         * Create a draft "AI transparency" page containing the legend shortcode.
+         *
+         * The page is only ever created on an explicit administrator action and is
+         * always left as a draft, so nothing is published without review.
+         *
+         * @return void
+         */
+        public function handle_create_transparency_page() {
+                if ( ! current_user_can( 'manage_options' ) || ! current_user_can( 'publish_pages' ) ) {
+                        wp_die(
+                                esc_html__( 'You do not have permission to create this page.', 'oznaczai-image-labeling' ),
+                                '',
+                                array( 'response' => 403 )
+                        );
+                }
+                check_admin_referer( 'oznaczai_image_labeling_create_transparency_page' );
+                $settings_url = admin_url( 'admin.php?page=oznaczai-image-labeling' );
+                $existing     = $this->get_transparency_page();
+                if ( $existing instanceof WP_Post ) {
+                        wp_safe_redirect( add_query_arg( 'oznaczai_image_labeling_page', 'exists', $settings_url ) );
+                        exit;
+                }
+                $page_id = wp_insert_post(
+                        array(
+                                'post_title'   => __( 'AI transparency', 'oznaczai-image-labeling' ),
+                                'post_content' => '[oznaczai_transparency_legend]',
+                                'post_status'  => 'draft',
+                                'post_type'    => 'page',
+                        ),
+                        true
+                );
+                if ( is_wp_error( $page_id ) || ! $page_id ) {
+                        wp_safe_redirect( add_query_arg( 'oznaczai_image_labeling_page', 'error', $settings_url ) );
+                        exit;
+                }
+                update_option( self::OPTION_TRANSPARENCY_PAGE, absint( $page_id ), false );
+                wp_safe_redirect( add_query_arg( 'oznaczai_image_labeling_page', 'created', $settings_url ) );
+                exit;
+        }
+        /**
+         * Show the result of the transparency page action.
+         *
+         * @return void
+         */
+        public function show_transparency_page_notice() {
+                // The notice belongs to the OznaczAI settings screen, which is where the
+                // action redirects back to. Restricting it here stops the query parameter
+                // from surfacing the notice on unrelated wp-admin screens.
+                $screen = function_exists( 'get_current_screen' ) ? get_current_screen() : null;
+                if ( ! $screen || 'toplevel_page_oznaczai-image-labeling' !== $screen->id ) {
+                        return;
+                }
+                // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only admin notice flag; value is sanitized, whitelisted, and does not mutate data.
+                if ( ! isset( $_GET['oznaczai_image_labeling_page'] ) || ! current_user_can( 'manage_options' ) ) {
+                        return;
+                }
+                // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only admin notice flag; value is sanitized, whitelisted, and does not mutate data.
+                $result = sanitize_key( wp_unslash( $_GET['oznaczai_image_labeling_page'] ) );
+                $page   = $this->get_transparency_page();
+                if ( 'error' === $result ) {
+                        printf(
+                                '<div class="notice notice-error is-dismissible"><p>%s</p></div>',
+                                esc_html__( 'The AI transparency page could not be created.', 'oznaczai-image-labeling' )
+                        );
+                        return;
+                }
+                if ( ! in_array( $result, array( 'created', 'exists' ), true ) || ! $page instanceof WP_Post ) {
+                        return;
+                }
+                $message = 'created' === $result
+                        ? __( 'Draft page created. Review the wording and publish it when you are ready.', 'oznaczai-image-labeling' )
+                        : __( 'The AI transparency page already exists.', 'oznaczai-image-labeling' );
+                printf(
+                        '<div class="notice notice-success is-dismissible"><p>%1$s <a href="%2$s">%3$s</a></p></div>',
+                        esc_html( $message ),
+                        esc_url( (string) get_edit_post_link( $page->ID, 'url' ) ),
+                        esc_html__( 'Edit the page', 'oznaczai-image-labeling' )
+                );
+        }
+        /**
          * Add media list column.
+         *
 …
         /**
+         * Available Media Library filter choices.
+         *
+         * @return array<string,string>
+         */
+        private function get_media_filter_choices() {
+                return array(
+                        'generated'     => __( 'AI label: AI-generated', 'oznaczai-image-labeling' ),
+                        'modified'      => __( 'AI label: AI-modified', 'oznaczai-image-labeling' ),
+                        'visualization' => __( 'AI label: AI visualization', 'oznaczai-image-labeling' ),
+                        'unlabeled'     => __( 'AI label: no label', 'oznaczai-image-labeling' ),
+                        'hint'          => __( 'AI label: metadata hint found', 'oznaczai-image-labeling' ),
+                );
+        }
+        /**
+         * Read the requested Media Library filter.
+         *
+         * @return string Empty string when no supported filter is active.
+         */
+        private function get_requested_media_filter() {
+                // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only list table filter, mirrors the core media type and date filters.
+                if ( ! isset( $_GET['oznaczai_image_labeling_filter'] ) ) {
+                        return '';
+                }
+                // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only list table filter, mirrors the core media type and date filters.
+                $filter = sanitize_key( wp_unslash( $_GET['oznaczai_image_labeling_filter'] ) );
+                return array_key_exists( $filter, $this->get_media_filter_choices() ) ? $filter : '';
+        }
+        /**
+         * Render the OznaczAI filter next to the native Media Library filters.
+         *
+         * @param string $post_type Current list table post type.
+         * @param string $which     Tablenav position.
+         * @return void
+         */
+        public function render_media_library_filter( $post_type, $which ) {
+                global $pagenow;
+                if ( 'attachment' !== $post_type || 'upload.php' !== $pagenow || ! current_user_can( 'upload_files' ) ) {
+                        return;
+                }
+                // The media list table renders this action twice; only the top bar carries
+                // the native filter controls and the Filter submit button.
+                if ( 'bar' !== $which ) {
+                        return;
+                }
+                $current = $this->get_requested_media_filter();
+                echo '<label class="screen-reader-text" for="oznaczai-image-labeling-filter">';
+                esc_html_e( 'Filter by AI label', 'oznaczai-image-labeling' );
+                echo '</label>';
+                echo '<select name="oznaczai_image_labeling_filter" id="oznaczai-image-labeling-filter">';
+                printf(
+                        '<option value=""%1$s>%2$s</option>',
+                        selected( $current, '', false ),
+                        esc_html__( 'All AI labels', 'oznaczai-image-labeling' )
+                );
+                foreach ( $this->get_media_filter_choices() as $value => $label ) {
+                        printf(
+                                '<option value="%1$s"%2$s>%3$s</option>',
+                                esc_attr( $value ),
+                                selected( $current, $value, false ),
+                                esc_html( $label )
+                        );
+                }
+                echo '</select>';
+        }
+        /**
+         * Apply the OznaczAI filter to the Media Library list query.
+         *
+         * Filtering happens in the WordPress query so large libraries are never
+         * transferred to the browser.
+         *
+         * @param WP_Query $query Current query.
+         * @return void
+         */
+        public function filter_media_library_query( $query ) {
+                global $pagenow;
+                if ( ! is_admin() || ! $query instanceof WP_Query || ! $query->is_main_query() ) {
+                        return;
+                }
+                if ( 'upload.php' !== $pagenow || ! current_user_can( 'upload_files' ) ) {
+                        return;
+                }
+                $filter = $this->get_requested_media_filter();
+                if ( '' === $filter ) {
+                        return;
+                }
+                $meta_query = $query->get( 'meta_query' );
+                $meta_query = is_array( $meta_query ) ? $meta_query : array();
+                if ( 'hint' === $filter ) {
+                        $meta_query[] = array(
+                                'key'     => self::META_DETECTION_STATUS,
+                                'compare' => 'EXISTS',
+                        );
+                } elseif ( 'unlabeled' === $filter ) {
+                        // Current releases delete the meta row when a label is removed, but an
+                        // installation upgraded from an older version can still hold an empty
+                        // or explicit 'none' value, so both shapes count as unlabeled.
+                        $meta_query[] = array(
+                                'relation' => 'OR',
+                                array(
+                                        'key'     => self::META_STATUS,
+                                        'compare' => 'NOT EXISTS',
+                                ),
+                                array(
+                                        'key'     => self::META_STATUS,
+                                        'value'   => array( '', 'none' ),
+                                        'compare' => 'IN',
+                                ),
+                        );
+                } else {
+                        $meta_query[] = array(
+                                'key'     => self::META_STATUS,
+                                'value'   => $filter,
+                                'compare' => '=',
+                        );
+                }
+                $query->set( 'meta_query', $meta_query );
+                // OznaczAI only labels images. Without this, every PDF and video would
+                // appear under "no label". An explicit media type choice still wins.
+                if ( in_array( $filter, array( 'unlabeled', 'hint' ), true ) && ! $query->get( 'post_mime_type' ) ) {
+                        $query->set( 'post_mime_type', 'image' );
+                }
+        }
+        /**
          * Save status changed directly in the Media list.
+         *
 …
                         unset( $this->status_cache[ $post_id ], $this->label_cache[ $post_id ] );
                         $this->update_labeled_media_index( $post_id, $status );
+                        $this->update_labeled_media_index( $post_id, $status, true );
                         ++$count;
+                }
                 if ( $count > 0 ) {
+                        $this->persist_labeled_media_index();
                         $this->clear_media_map_cache();
                         $this->purge_page_cache();

oznaczai-image-labeling/trunk/oznaczai.php

-              r3641997
+              r3705284
  * Plugin Name: OznaczAI – AI Image Disclosure for EU AI Act
  * Description: Adds visible labels to AI-generated and AI-modified images to support transparency disclosures, including EU AI Act use cases.
  * Version:     1.6.24
+ * Version:     1.7.0
  * Author:      Golden Pixel
  * License:     GPL-2.0-or-later
 …
  * Text Domain: oznaczai-image-labeling
  * Requires at least: 6.2
  * Tested up to: 7.0
+ * Tested up to: 7.1
  * Requires PHP: 7.4
  */
 …
+}
 define( 'OZNACZAI_IMAGE_LABELING_VERSION', '1.6.24' );
+define( 'OZNACZAI_IMAGE_LABELING_VERSION', '1.7.0' );
 define( 'OZNACZAI_IMAGE_LABELING_FILE', __FILE__ );
 define( 'OZNACZAI_IMAGE_LABELING_DIR', plugin_dir_path( __FILE__ ) );

oznaczai-image-labeling/trunk/readme.txt

-              r3641997
+              r3705284
 Tags: eu ai act, ai disclosure, ai transparency, deepfake, image labeling
 Requires at least: 6.2
 Tested up to: 7.0
+Tested up to: 7.1
 Requires PHP: 7.4
 Stable tag: 1.6.24
+Stable tag: 1.7.0
 License: GPLv2 or later
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
 …
 * No label
-== Screenshots ==
-. Label AI-generated and AI-modified images directly from the WordPress Media Library.
-. Configure label presets, custom styling, hero and slider labels, and live preview.
-. Visible AI disclosure labels on a real website, including hero images and images inside page content.
-. Responsive AI labels automatically adapt between full text and a compact AI symbol on smaller screens.
 = Main features =
 * Quick status selection in the Media Library list view
 * Automatic saving without opening each attachment
+* Filter the Media Library by AI label, including images with no label
 * Bulk labeling for multiple images
 * Custom label wording
 …
 The Caption below image preset places the disclosure outside the image so it does not cover visual content.
+= Label symbol =
+The label symbol is separate from the label preset, so any symbol can be combined with any preset.
+* OznaczAI symbol (default)
+* EU AI icon
+* EU AI icons per label type
+The EU options use the official European Commission icons for labelling AI-generated content. AI-generated uses the Fully AI-Generated icon and AI-modified uses the Partially AI-Modified icon. AI visualization always uses the neutral EU AI icon, because no official variant carries that meaning.
+Choosing an EU icon does not change what your labels mean and is not a statement about legal compliance. Existing installations keep the OznaczAI symbol until the setting is changed.
+= AI transparency legend =
+The shortcode below outputs a short, neutral legend that explains the labels used on your site. It follows your current label texts and symbol automatically.
+[oznaczai_transparency_legend]
+You can optionally create a draft page containing this legend from the plugin settings screen. The page is never published automatically.
 == Installation ==
 …
 No WordPress plugin can provide or guarantee complete legal compliance. Site owners should assess their own content, role, audience, and applicable legal requirements.
+== Third-party assets ==
+The optional EU label symbols are the official icons for labelling AI-generated content published by the European Commission at https://digital-strategy.ec.europa.eu/en/policies/eu-icons-labelling-ai-generated-content
+The published terms state that the icons "are made publicly available for everyone to use freely, without the need for attribution to the Commission or the AI Office". The files bundled with OznaczAI are unmodified copies of the official SVG assets; only their file names were changed. See assets/icons/eu/README.txt in the plugin folder for the recorded source and terms.
+OznaczAI is not affiliated with, endorsed by, or approved by the European Commission or the AI Office. Displaying an icon does not establish that any legal obligation applies to an image or that it has been met.
 == Privacy ==
 …
 It automatically detects many common WordPress and Elementor implementations, including Slider Revolution 6/7 image layers and slide backgrounds. Custom themes or other third-party widgets may require one of the fallback CSS classes or the background label shortcode.
+== Screenshots ==
+. Label AI-generated and AI-modified images directly from the WordPress Media Library.
+. Configure label presets, custom styling, hero and slider labels, and live preview.
+. Visible AI disclosure labels on a real website, including hero images and images inside page content.
+. Responsive AI labels automatically adapt between full text and a compact AI symbol on smaller screens.
 == Changelog ==
+= 1.7.0 =
+* Fixed a feedback loop where the page observer reacted to the plugin's own DOM updates and kept re-scanning the page after it had settled.
+* Labeled images are no longer reprocessed on every scan, so contrast sampling now runs once per image instead of repeatedly.
+* Added a per-slide cache for Slider Revolution detection and stopped re-measuring hero, banner and Elementor elements that were already checked.
+* Narrowed the page observer and made it scan only the changed part of the page. Dynamically added Elementor content, lazy-loaded backgrounds and Slider Revolution 6/7 are still detected.
+* Stopped rebuilding the labeled media cache after uploads and thumbnail regeneration of media that carries no label.
+* Removed a database write that could happen while a public page was being rendered.
+* Bulk labeling now writes the labeled media index once instead of once per image.
+* Reduced the size of the labeled media data passed to the browser by removing duplicated entries.
+* The legacy storage migration now runs only on install and version change instead of on every request.
+* Fixed a migration from very old versions that could store a label preset that no longer exists.
+* Added an AI label filter to the Media Library list view, including images with no label and images with a metadata hint.
+* Added the [oznaczai_transparency_legend] shortcode, and an optional action that creates a draft page containing it.
+* Added optional official European Commission icons for labelling AI-generated content as an alternative label symbol. The OznaczAI symbol remains the default and existing labels are unchanged.
+* Removed settings screen code that was no longer used by the current panel.
 = 1.6.24 =

oznaczai-image-labeling/trunk/uninstall.php

-              r3641997
+              r3705284
 delete_option( 'oznaczai_image_labeling_labeled_media_ids' );
 delete_option( 'oznaczai_image_labeling_version' );
+/*
+ * Only the stored reference is removed. Any page created through the
+ * "AI transparency" action is ordinary site content that the administrator
+ * owns and may have edited or published, so it is never deleted here.
+ */
+delete_option( 'oznaczai_image_labeling_transparency_page_id' );
 delete_transient( 'oznaczai_image_labeling_media_map_v1' );

Plugin Directory

WordPress Plugin Repository

Context Navigation

Legend:

oznaczai-image-labeling/tags/1.7.0/assets/css/admin.css

oznaczai-image-labeling/tags/1.7.0/assets/css/frontend.css

oznaczai-image-labeling/tags/1.7.0/assets/js/admin.js

oznaczai-image-labeling/tags/1.7.0/assets/js/frontend.js

oznaczai-image-labeling/tags/1.7.0/changelog.txt

oznaczai-image-labeling/tags/1.7.0/includes/class-oznaczai-image-labeling-plugin.php

oznaczai-image-labeling/tags/1.7.0/oznaczai.php

oznaczai-image-labeling/tags/1.7.0/readme.txt

oznaczai-image-labeling/tags/1.7.0/uninstall.php

oznaczai-image-labeling/trunk/assets/css/admin.css

oznaczai-image-labeling/trunk/assets/css/frontend.css

oznaczai-image-labeling/trunk/assets/js/admin.js

oznaczai-image-labeling/trunk/assets/js/frontend.js

oznaczai-image-labeling/trunk/changelog.txt

oznaczai-image-labeling/trunk/includes/class-oznaczai-image-labeling-plugin.php

oznaczai-image-labeling/trunk/oznaczai.php

oznaczai-image-labeling/trunk/readme.txt

oznaczai-image-labeling/trunk/uninstall.php

Download in other formats: