TYPO3 Translation Handling Initiative Extension

This repository contains the TYPO3 Translation Handling Initiative Extension, a testing tool to quickly reproduce translation‑handling related scenarios on current TYPO3 Core versions. The extension is inspired by the official styleguide extension.

---

Purpose

Provide a fast, reproducible setup of TYPO3 demo sites with predefined, translation‑focused test cases. It helps developers and integrators validate concepts, cover edge cases, and experiment with different translation models.

---

Scope

• Generates demo page trees and content structures for translation handling
• Provides CLI commands to create and remove test datasets
• Ships example setups for common and advanced scenarios

---

CLI Commands

The extension registers two commands in the translation-handling namespace. Both commands accept an optional type argument to select which scenario(s) to operate on.

Both commands initialize backend authentication for the _cli_ user via TYPO3’s bootstrap before executing their actions.

Create page trees

Create page tree(s) with translation handling examples.

Signature

typo3 translation-handling:create [type]

Argument

• type — Which scenario to create. Valid values:

  • fallback – Generate a site/tree demonstrating a fallback model
  • strict – Generate a site/tree demonstrating a strict model
  • free – Generate a site/tree demonstrating a free model
  • all – Generate all of the above

Delete page trees

Delete page tree(s) previously created by the create command.

Signature

typo3 translation-handling:delete [type]

Argument

• type — Which scenario to delete. Valid values:

  • fallback – Delete the site/tree demonstrating a fallback model
  • strict – Delete the site/tree demonstrating a strict model
  • free – Delete the site/tree demonstrating a free model
  • all – Delete all of the above

---

Target Audience

• TYPO3 Core developers working on translation features
• Extension developers validating multilingual behavior
• Integrators testing translation handling in projects

---

Contribution

We welcome input from the TYPO3 community:

• Open issues
• Share real‑world use cases
• Join discussions at TYPO3 Camps, DevDays, or Slack huddles

---

Status

This repository is work in progress. It is a playground for experiments and not intended for production use.

---

Related Links

• Official Initiative Page on typo3.org
• Slack Channel #typo3-translation-handling
• Meeting Notes

---

License

This repository is licensed under the GPL v2 or later. See LICENSE for details.