Features 

• AI-Generated Metadata: Automatically generate page titles and descriptions based on page content.
• FormEngine Integration: Seamlessly integrated into the TYPO3 page properties.
• Multi-language Support: Works across different languages supported by your TYPO3 installation.
• Ai3 Suite Integration: Leverages the central Ai3 Core for AI provider connections.

Screenshots 

Composer 

The recommended way to install Ai3 Quickmeta is via Composer:

composer require wegewerk/ai3_quickmeta

Dependencies 

Ai3 Quickmeta requires the following extensions:

• Ai3 Core (`ai3_core`): Provides central AI capabilities and configuration.
• TYPO3 CMS Core: Version 13.4.0 or higher.

Activation 

After installation, ensure the extension is activated via CLI:

./vendor/bin/typo3 extension:setup

Ai3 Core 

Ai3 Quickmeta relies on the configuration of Ai3 Core. Ensure that Ai3 Core is properly configured with a valid API key and secret for the Zak-AI service.

API Credentials 

The API credentials for the Zak-AI service are typically provided via environment variables:

• ZAKAI_API_KEY: Your Zak-AI API key.
• ZAKAI_SECRET: Your Zak-AI secret.

These are consumed by WegewerkAi3CoreApiZakAiClient.

Accessing the Assistant 

1. Open the Page Properties of the page you want to edit.
2. Navigate to the Quickmeta tab.

Workflow 

1. Generate Suggestions: Click the button "Generate metadata". The assistant will analyze the page content and provide suggestions for various fields.
2. Review Suggestions: The suggested values will appear in the right column. You can manually edit these suggestions if needed.
3. Transfer Values: **Transfer All**: Copies all suggestions to the corresponding TYPO3 fields. Transfer Empty: Copies suggestions only to fields that are currently empty. * Single Field Transfer: Click the arrow button next to a specific field to transfer only that value.

4. Save: Click "Save" in the top bar of the page properties to persist

   the changes.

Supported Fields 

The assistant can provide suggestions for the following fields:

• Page Title
• Navigation Title
• SEO Title
• Abstract
• Description
• Open Graph (Facebook) Title and Description
• X/ Twitter Card Title and Description

PHP API 

ai3-quickmeta follows the capability pattern introduced by wegewerk/ai3_core . The central pieces are:

class ZakAiQuickmeta

Fully qualified name

\Wegewerk\Ai3Quickmeta\Api\ZakAiQuickmeta

Implements the API endpoint for metadata generation.

generate ( string $imagePath, string $description, string $language) : array

Sends a request to the Zak-AI service to generate metadata.

param string $imagePath

Not used in this implementation (can be empty).

param string $description

The content of the page to analyze.

param string $language

The target language for the metadata (default: 'de').

returntype

array

Returns

An array containing the generated metadata fields.

Ajax Endpoints 

Ai3 Quickmeta provides backend Ajax routes for its JavaScript application.

FormEngine Integration 

The assistant is integrated via a custom FormEngine element: WegewerkAi3QuickmetaFormEngineAi3QuickmetaElement.

It is added to the pages TCA via an override in Configuration/TCA/Overrides/page_quickmeta.php.