---
title: "Developer"
manual: "Ai3 Quickmeta"
version: "0.9"
permalink: "https://docs.typo3.org/permalink/wegewerk/ai3_quickmeta:developer@0.9"
source: "Developer/Index.rst"
rendered: "2026-10-23T16:31:01+00:00"
---

# Developer {#developer}

## PHP API {#developer-php-api}

ai3-quickmeta follows the capability pattern introduced by
[`wegewerk/ai3_core`](https://packagist.org/packages/wegewerk/ai3_core). The central pieces are:

-   **class ZakAiQuickmeta**

    -   *Fully qualified name:* `\Wegewerk\Ai3Quickmeta\Api\ZakAiQuickmeta`

    Extends `Wegewerk\Ai3Core\Api\AbstractZakAiEndpoint` (implementing
    `ZakAiEndpointInterface`). Implements the API endpoint for metadata generation.

    -   **generate(array $options = \[\]) : string**

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

        -   *param array $options:*

            Associative array of options:
             *\`\`text\`\` (string, required): The content of the page to analyze.*
             `language` (string, optional): The target language for the metadata (default: 'de').

        -   *returntype:* string

        *Returns:* JSON-encoded string containing the generated metadata fields.

## Ajax Endpoints {#developer-ajax-endpoints}

Ai3 Quickmeta provides backend Ajax routes for its JavaScript application.

### `ai3_articlemeta` {#developer-ajax-fetch-page-row}

Fetches the current page row and checks if it has content.

-   **Path**: `/ai3/articlemeta`
-   **Method**: `GET`
-   **Parameters**:
    \*   `page_id` (int): The UID of the page.

### `ai3_articlemeta_suggestion` {#developer-ajax-get-suggestion}

Generates metadata suggestions based on page content.

-   **Path**: `/ai3/articlemetasuggestion`
-   **Method**: `GET`
-   **Parameters**:
    \*   `page_id` (int): The UID of the page.

## FormEngine Integration {#developer-formengine}

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`.