Configuration 

LLM provider setup 

The Cowriter extension uses the nr-llm extension for LLM provider configuration. Configure your preferred provider in the nr-llm backend module.

RTE configuration 

There are two ways to configure the CKEditor integration:

Option 1: Using the shipped preset 

If you don't have a custom RTE configuration, point the RTE at the preset this extension registers:

1. Go to your root page
2. Open Page Properties > Page TSconfig

3. Add this line:

   RTE.default.preset = cowriter

   Copied!

The preset is inherited by every page below, and brings all four toolbar items with it.

editor:
  config:
    importModules:
      - { module: '@netresearch/t3_cowriter/cowriter', exports: ['Cowriter'] }
    toolbar:
      items:
        - cowriter
        - cowriterVision
        - cowriterTranslate
        - cowriterTemplates

Translation languages and formality 

The Translate dropdown offers the languages of the site the edited record belongs to: every language of the site configuration, labelled with its title. Languages hidden from the frontend (enabled: false) are included, so editors can translate into a language before it goes live. When the record belongs to no site (a record on the root page, pid 0, or in a folder outside every site), the dropdown keeps its fixed list: German, English, French, Spanish, Italian, Dutch, Portuguese, Polish, Japanese and Chinese. The same list appears when none of the site's languages has a target code (for example a site whose only language is fil_PH, see below).

The target language is taken from the language's locale:

• The two-letter language code is used, the region is dropped: de_DE.UTF-8 and de_CH.UTF-8 both translate into de.
• English and Portuguese keep the region, because DeepL translates into their regional variants: en_GB gives en-GB, en_US gives en-US, pt_BR gives pt-BR, pt_PT gives pt-PT. Other regions of these languages (en_AU) give en or pt.
• Chinese gives zh. DeepL translates zh into Simplified Chinese; the language model receives only "Chinese" and chooses the script itself. The regions that write Traditional Chinese keep their region: zh_TW gives zh-TW, zh_HK gives zh-HK, zh_MO gives zh-MO; a locale with the script Hant and no region gives zh-TW, one with the script Hans gives zh. DeepL has no target for these codes, so nr-llm translates them with the language model.
• A language without a two-letter code (fil_PH) is not offered, nor is the C or POSIX locale.

languages:
  - languageId: 0
    title: English
    locale: en_US.UTF-8
    base: /
  - languageId: 1
    title: Deutsch
    locale: de_DE.UTF-8
    base: /de/
    cowriterFormality: formal

Task configuration 

The Cowriter dialog shows tasks from the nr-llm extension with category = 'content'. Default tasks (Improve, Summarize, Extend, Fix Grammar, Translate EN/DE) are seeded during installation.

Rewrite the following text in a more engaging tone, suitable for
a marketing audience. Output ONLY the rewritten text without
explanations.

{{input}}

Field suggestions 

The fields that get the Suggest values with AI button are set in the extension configuration (Admin Tools > Settings > Extension Configuration > t3_cowriter):

The list is extension configuration rather than page TSconfig because the button is added to the TCA, which is the same for the whole installation. After changing either setting, flush the caches so the TCA is rebuilt.

Saved prompts 

Editors save prompts from the Cowriter dialog (usage). The records are stored in the table tx_cowriter_prompt on the root level (page 0), one owner each; an editor can have up to 100. Only the owner sees an unshared prompt and only the owner deletes one in the dialog.

Hiding or deleting the record in the List module takes a prompt away from every editor, its owner included.

Alt text 

The Generate alt text button sends the selected image with an instruction to the vision model. The instruction is set in the extension configuration:

The Cowriter adds the language of the edited record to the instruction, for example Answer in German (Germany).. The language comes from the record's language field and the locale of that language in the site configuration, and is resolved on the server. There is no language hint when the record has not been saved yet, has no language field, belongs to no site, is set to "all languages", or when the editor may not read the record, its page or its language.

A request to the AJAX route may still send its own instruction in the prompt field; it replaces the configured one, as it did before the setting existed. The button in the editor sends none. The language hint is added in both cases.

Audience, tone and target length 

The Audience and Tone of voice selectors in the Cowriter dialog list the active nr-llm prompt snippets tagged audience and tone_of_voice. Maintain them in the nr-llm backend module, prompt snippets; the same snippets steer nr_repurpose. A selector without snippets is not shown.

The length step is relative to the input, or to a target length per content type set in page TSconfig:

tx_cowriter.targetLength {
    text = 150
    textmedia = 120
}

Rate limiting 

The Cowriter enforces a rate limit of 20 requests per minute per backend user. When the limit is exceeded, the API returns HTTP 429 with a Retry-After header.

Security considerations 

The Cowriter extension routes all LLM requests through the TYPO3 backend, ensuring that:

• API keys are never exposed to the frontend
• All requests are authenticated via TYPO3's backend session
• Error conditions are logged for debugging

Troubleshooting