README

Beta: This package is under active development.

Adds an exclusive AI classification selector to the asset inspector in flowpack/media-ui.

Behaviour

The selector is available for every asset type and maps its options to regular Neos Media tags:

Option	Assigned tags
`Without AI`	Neither AI tag
`AI-generated`	`AI-generated` only
`AI-modified`	`AI-modified` only

Existing unrelated tags are preserved. Missing classification tags are created when first needed. The tag chips, tag tree, filtered asset grid, and result count update without reloading the module.

The field label and option labels follow the Neos backend interface language: German (de, de_AT, or de-DE) uses German labels, while English and all other languages use the English fallback. The persisted tag labels remain language-independent.

The integration is loaded only in the Media UI module. It does not affect the asset selector used by the Neos content module.

Fusion EEL helpers

The package registers AiClassification in the default Fusion context. Use it with a single image, image variant, video, or other Neos media asset:

aiClassification = ${AiClassification.fromAsset(asset)}

For responsive video sources or other asset collections, use:

aiClassification = ${AiClassification.fromAssets(assets)}

Both methods return AI-generated, AI-modified, or null. Image variants inherit their original asset's classification. If a collection contains both classifications, AI-generated takes precedence.

When Sitegeist Kaleidoscope is installed, its image sources also expose the classification directly:

aiClassification = ${imageSource.aiClassification()}

Asset-backed image sources resolve their original Neos media asset. Dummy, resource, and URI image sources return null.

Rendering an image with Schema.org microdata

This complete Fusion example renders a Neos image and discloses its digital source when it is AI-classified:

prototype(Vendor.Site:AiClassifiedImage) < prototype(Neos.Fusion:Component) {
    asset = null
    alternativeText = ''

    @private {
        aiClassification = ${AiClassification.fromAsset(props.asset)}
        digitalSourceType = ${AiClassification.schemaOrgDigitalSourceType(private.aiClassification)}
    }

    renderer = afx`
        <figure itemscope="" itemtype="https://schema.org/ImageObject">
            <Neos.Neos:ImageTag
                asset={props.asset}
                attributes.alt={props.alternativeText}
                attributes.itemprop="contentUrl"
            />
            <meta
                @if.has={private.digitalSourceType}
                itemprop="digitalSourceType"
                content={private.digitalSourceType}
            />
        </figure>
    `
}

schemaOrgDigitalSourceType() also accepts an asset or asset collection directly when the classification value is not otherwise needed.

Zebra and Content API integration

If the website uses Zebra, add the optional neosidekick/content-api-asset-ai-labeling package. It adds the classification to Networkteam.Neos.ContentApi output while keeping the Media UI package free of Content API dependencies:

composer require neosidekick/content-api-asset-ai-labeling

Requirements

Neos 8.4
Flowpack Media UI 1.4 or 2.x
PHP 8.3

Installation

Require the package from the Neos distribution and publish its resources:

composer require neosidekick/media-ui-asset-ai-labeling
./flow resource:publish

For a local path repository, add the package directory to the distribution and require it from the site or root package as usual.

Implementation notes

The package registers one JavaScript resource through additionalResources.javaScripts and one EEL helper in the default Fusion context. The script uses the existing Media UI GraphQL endpoint and Apollo cache, so no fork or frontend build is required.

The classification tag labels are part of the data contract. If either tag is renamed or deleted, the package recreates the expected label on the next classification change.

neosidekick / media-ui-asset-ai-labeling

Maintainers

Package info

Statistics

Security