GenerateFlexForm

Overview

The GenerateFlexForm class is part of the Theolangstraat\Dailyverses\Configuration\EventListener namespace. It dynamically generates a FlexForm XML configuration file for a TYPO3 site based on available languages and Bible translation options.

This guide explains the structure, purpose, and usage of the class and its generate() method.

Location

The class is located at:

typo3conf/ext/dailyverses/Configuration/EventListener/GenerateFlexForm.php

Dependencies

  • TYPO3 CMS Core Utility (GeneralUtility)

  • Language options file: Configuration/LanguageOptions.php

Purpose

The generate() method creates a FlexForm XML file containing:

  • A tab for each language with a dropdown of Bible translations

  • A default options tab with additional configuration settings

Method Signature

<?php

public function generate($siteIdentifier, $languages)

Parameters

  • siteIdentifier (string): Unique identifier for the site, used to name the output XML file.

  • languages (array): List of language configurations, each containing:

    • locale: Locale string (e.g., en_US)

    • title: Human-readable language name

Workflow

  1. Load Bible Translation Options

<?php

// This file returns an array of available Bible translations per language code.
$languageOptions = require __DIR__ . '/../../../Configuration/LanguageOptions.php';

  1. Create Language-Specific Sheets

    For each language in $languages, a sheet is created with:

    • Sheet title set to the language name

    • A dropdown (selectSingle) listing Bible translations for that language