letone/contao-ai-image-marker-bundle

AI Image Marker adds visible watermarks and embedded AI notices to images managed by Contao.

0.4.2 2026-08-03 22:37 UTC

Requires

• php: ^8.2
• ext-gd: *
• ext-simplexml: *
• contao/core-bundle: ^5.3 || ^5.4 || ^5.5 || ^5.6 || ^5.7
• doctrine/dbal: ^3.6 || ^4.0
• meyfa/php-svg: ^0.16.1

Requires (Dev)

• contao/manager-plugin: ^2.0

Conflicts

• contao/manager-plugin: <2.0 || >=3.0

MIT

• LETONE

• metadata
• image
• watermark
• contao
• ai

Published on Packagist.org on 2026-08-04 01:18 UTC

README

AI Image Marker labels AI-generated images in the Contao file manager. It embeds a visible watermark and a machine-readable notice in the image file itself.

Features

• Checkbox for AI-generated images in the Contao file manager
• Central configuration under KI → Medienhinweise
• PNG, WebP and SVG watermark files with transparency
• Exact watermark width as a percentage of the source image width
• Configurable position, margin and opacity
• Embedded metadata notice for JPEG, PNG and WebP
• Protected originals and reversible processing
• Regeneration of marked images and responsive image variants
• Batch processing command for larger media libraries
• German and English backend labels

Requirements

• PHP 8.2 or newer
• Contao 5.3–5.7
• PHP extensions GD and SimpleXML

Installation

Install the bundle with Composer or through the Contao Manager:

composer require letone/contao-ai-image-marker-bundle

Then update the Contao database schema and clear the application cache.

Configuration

1. Open KI → Medienhinweise in the Contao backend.
2. Select a PNG, WebP or SVG watermark.
3. Set its width, position, margin and opacity.
4. Open an image in the file manager and enable the AI image checkbox.
5. Save the file record. AI Image Marker regenerates the image automatically.

Disabling the checkbox restores the protected original. Backups are stored below var/ai-watermark-originals; this path is intentionally retained for compatibility with earlier releases.

Batch processing

Use the included command to process marked files in batches:

php vendor/bin/contao-console ai-watermark:process --limit=1000 --offset=0

Increase the offset for subsequent batches. Always test bulk processing on a staging copy first.

The backend button processes all marked images synchronously. For several hundred images, use the batch command to avoid web-server execution time limits. Responsive image caches are purged once after a successful backend run.

Supported metadata

AI Image Marker writes an AI-content notice to JPEG IPTC, PNG text or WebP XMP metadata, depending on the image format. Some web services and image optimizers deliberately strip metadata during delivery; the original file managed by Contao remains the authoritative source.

Upgrading from the Acme package

Database fields, DCA identifiers, the backend module key, command name and backup directory remain compatible. Replace the old package with letone/contao-ai-image-marker-bundle, run the database migration and clear the Contao cache. Do not delete var/ai-watermark-originals.

Support and security

Please use GitHub Issues for reproducible bug reports. Report security issues privately as described in SECURITY.md.

License

Released under the MIT License.

This extension provides technical image labels. It is not legal advice and does not by itself guarantee regulatory compliance.