brandcom / silverstripe-ai-generated-assets
Adds AI-generated metadata to Silverstripe managed assets.
Package info
github.com/brandcom/silverstripe-ai-generated-assets
Type:silverstripe-vendormodule
pkg:composer/brandcom/silverstripe-ai-generated-assets
Requires
- silverstripe/asset-admin: ^2.0 || ^3.0
- silverstripe/assets: ^2.0 || ^3.0
- silverstripe/framework: ^5.0 || ^6.2
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-09-16 10:10:09 UTC
README
Ein Silverstripe-Modul zur Kennzeichnung KI-generierter Dateien.
- Dropdown KI-Inhalt (Kein KI-Inhalt / KI-generiert / KI-bearbeitet) 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
- Bereich Files im CMS öffnen.
- Datei auswählen.
- Im Dropdown KI-Inhalt KI-generiert oder KI-bearbeitet auswählen.
- 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
Dateien werden als KI-bearbeitet erkannt, wenn der Dateiname vor der Endung exakt mit folgendem Marker endet:
_AI_MODIFIED
| 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
Das Dropdown KI-Inhalt wird automatisch auf „KI-generiert“ bzw. „KI-bearbeitet“ gesetzt. Beide Marker sind groß-/kleinschreibungssensitiv und müssen exakt _AI_GENERATED bzw. _AI_MODIFIED lauten.
Template-API
Das Modul erweitert File- und Image-Objekte um folgende Template-Hilfen:
| Template-Ausdruck | Ergebnis |
|---|---|
$Image.IsAIGenerated |
true oder false |
$Image.IsAIModified |
true oder false |
$Image.IsAIContent |
true oder false |
$Image.AIContentNotice |
Hinweis-Markup oder leer |
$Image.AIContentCssClass |
is-ai-generated oder leer |
Sichtbaren Hinweis ausgeben
<img src="$Image.URL" alt="$Image.Title.ATT"> $Image.AIContentNotice
CSS-Klasse verwenden
class="image $Image.AIContentCssClass"
KI-generierte Bilder erhalten die Klasse:
is-ai-generated
Hintergrundbilder
Bei CSS-Hintergrundbildern wird die Information am umgebenden Element ausgegeben:
<section
class="hero $BackgroundImage.AIContentCssClass"
style="background-image: url('$BackgroundImage.URL')"
>
$BackgroundImage.AIContentNotice
</section>
Hinweis-Template überschreiben
Standard-Template des Moduls:
templates/Brandcom/AIGeneratedAssets/AIContentNotice.ss
Website-spezifisches Override:
app/templates/AIContentNotice.ss
Beispiel:
<% if $isAIGenerated %> <img src="/img/label_ai_generated.svg" width="100" alt="AI generated" class="ai-content ai-generated"> <% else_if $isAIModified %> <img src="/img/label_ai_modified.svg" width="100" alt="AI modified" class="ai-content ai-modified"> <% end_if %>