brandcom/silverstripe-ai-generated-assets

Adds AI-generated metadata to Silverstripe managed assets.

dev-master 2026-08-04 14:21 UTC

Requires

• silverstripe/asset-admin: ^2.0 || ^3.0
• silverstripe/assets: ^2.0 || ^3.0
• silverstripe/framework: ^5.0 || ^6.2

MIT

Published on Packagist.org on 2026-08-12 10:16 UTC

README

Ein Silverstripe-Modul zur Kennzeichnung KI-generierter Dateien.

• Checkbox AI-generated für alle Assets, inklusive Bilder, PDFs und SVGs
• Automatische Erkennung beim Upload über einen Dateinamen-Marker
• Template-Hilfen für sichtbare Hinweise, CSS und JavaScript
• Website-spezifische Überschreibung des Hinweis-Templates

Voraussetzungen

• Silverstripe CMS ^5.0 || ^6.0

Installation

composer require brandcom/silverstripe-ai-generated-assets
vendor/bin/sake dev/build flush=all

Für Redakteure

Bestehende Dateien markieren

1. Bereich Files im CMS öffnen.
2. Datei auswählen.
3. Checkbox AI-generated aktivieren oder deaktivieren.
4. Speichern und bei Bedarf veröffentlichen.

Neue Uploads automatisch markieren

Dateien werden als KI-generiert erkannt, wenn der Dateiname vor der Endung exakt mit folgendem Marker endet:

_AI_GENERATED

Upload-Datei	Ergebnis
bild_AI_GENERATED.jpg	Wird automatisch markiert
bild_ai_generated.jpg	Wird nicht automatisch markiert

Nach dem Upload wird der Marker aus dem gespeicherten Dateinamen entfernt:

Upload:      bild_AI_GENERATED.jpg
Gespeichert: bild.jpg

Die Checkbox AI-generated bleibt aktiviert. Der Marker ist groß-/kleinschreibungssensitiv und muss exakt _AI_GENERATED lauten.

Template-API

Das Modul erweitert File- und Image-Objekte um folgende Template-Hilfen:

Template-Ausdruck	Ergebnis
$Image.IsAIGenerated	true oder false
$Image.AIGeneratedNotice	Hinweis-Markup oder leer
$Image.AIGeneratedCssClass	is-ai-generated oder leer

Sichtbaren Hinweis ausgeben

<img src="$Image.URL" alt="$Image.Title.ATT">

$Image.AIGeneratedNotice

CSS-Klasse verwenden

class="image $Image.AIGeneratedCssClass"

KI-generierte Bilder erhalten die Klasse:

is-ai-generated

Hintergrundbilder

Bei CSS-Hintergrundbildern wird die Information am umgebenden Element ausgegeben:

<section
    class="hero $BackgroundImage.AIGeneratedCssClass"
    style="background-image: url('$BackgroundImage.URL')"
>
    $BackgroundImage.AIGeneratedNotice
</section>

Hinweis-Template überschreiben

Standard-Template des Moduls:

templates/Brandcom/AIGeneratedAssets/AIGeneratedNotice.ss

Website-spezifisches Override:

app/templates/AIGeneratedAssetNotice.ss

Beispiel:

<span class="ai-generated-notice">
    KI-generiertes Bild
</span>