Zum Inhalt springen

TYPO3 12 Backend-Modul – Wie speichere ich eine Checkbox und rufe sie im Frontend ab?

Erstellt am 6. März 2025 · 1 Antwort · letzte Antwort am 7. November 2026

Tags: Fluid, TYPO3 12, Frage

lenjka ·

Hallo TYPO3-Community,

ich erstelle aktuell ein eigenes Backend-Modul in TYPO3 12 und möchte dort eine Checkbox speichern, sodass ich ihren Wert im Frontend (Fluid) abrufen kann.

Ich habe das Backend-Modul erfolgreich erstellt mit Hilfe dieses Videos:
https://www.youtube.com/watch?v=hnksXYtFgbY

Allerdings wird im Video (und auch sonst nirgends) erläutert, wie man Eingaben speichert und weiterverarbeitet.

Meine aktuelle Konfiguration:

BackendController.php

<?php

namespace LjBarrierefrei\Controller;

use TYPO3\CMS\Backend\Attribute\AsController;
use TYPO3\CMS\Backend\Template\ModuleTemplateFactory;
use TYPO3\CMS\Extbase\Mvc\Controller\ActionController;
use Psr\Http\Message\ResponseInterface;

#[AsController]
final class BackendController extends ActionController
{
    public function __construct(
        protected readonly ModuleTemplateFactory $moduleTemplateFactory,
    ) {
    }

    public function indexAction(): ResponseInterface
    {
        $this->view->assign('someVar', 'someContent');
        $moduleTemplate = $this->moduleTemplateFactory->create($this->request);

        $moduleTemplate->setContent($this->view->render());
        return $this->htmlResponse($moduleTemplate->renderContent());
    }
}

Fluid-Template Index.html (Backend-Modul UI)

<div class="m-lg-5 border p-4">
    <h1>Barrierefrei Einstellungen</h1>
    <p>Hier können Sie die Moduleinstellungen konfigurieren.</p>
    <f:form action="save">
        <label>
            <f:form.checkbox name="enable_barrierefrei" value="1" checked="{enableBarrierefrei}" />
            Barrierefreiheit aktivieren
        </label>
        <f:form.submit value="Speichern" />
    </f:form>
</div>

Meine Frage:

Wie kann ich den Wert der Checkbox richtig speichern, sodass:
✅ Die Einstellung auch nach einem Speichern erhalten bleibt
✅ Ich den Wert im Frontend abfragen kann (z. B. mit Fluid {settings.enableBarrierefrei})

Ich bin mir nicht sicher, wo und wie ich die Checkbox am besten speichere:

Soll ich die Einstellung in einer TYPO3-Datenbanktabelle speichern?
Kann ich sie auch über die TYPO3-Konfiguration ($GLOBALS['TYPO3_CONF_VARS']) setzen?
Gibt es einen Best Practice für TYPO3 12 Backend-Module, um solche Einstellungen zu speichern?

Falls jemand eine klare Anleitung oder ein Beispiel hat, wäre ich sehr dankbar!

Edit: Hm, leider funktioniert der gedöns nicht

Forumsbote ·

🤖 KI-Antwort des Forumsboten · automatisch erstellt und von einer zweiten KI gegengeprüft, ohne Gewähr.

Für einen einzelnen globalen Schalter brauchst du keine eigene Tabelle. Die System-Registry von TYPO3 passt gut: Sie ist ein einfacher Schlüssel-Wert-Speicher in der Datenbank (Tabelle sys_registry). In $GLOBALS['TYPO3_CONF_VARS'] solltest du zur Laufzeit nichts speichern. Diese Werte stehen in Konfigurationsdateien und sind nicht für Eingaben aus einem Modul gedacht.

1. Die save-Action im Modul freigeben (Configuration/Backend/Modules.php):

'controllerActions' => [
    \LjBarrierefrei\Controller\BackendController::class => ['index', 'save'],
],

2. Den Controller erweitern:

use TYPO3\CMS\Core\Registry;

public function __construct(
    protected readonly ModuleTemplateFactory $moduleTemplateFactory,
    protected readonly Registry $registry,
) {}

public function indexAction(): ResponseInterface
{
    $this->view->assign(
        'enableBarrierefrei',
        (bool)$this->registry->get('tx_ljbarrierefrei', 'enable', false)
    );
    $moduleTemplate = $this->moduleTemplateFactory->create($this->request);
    $moduleTemplate->setContent($this->view->render());
    return $this->htmlResponse($moduleTemplate->renderContent());
}

public function saveAction(): ResponseInterface
{
    $enabled = $this->request->hasArgument('enable_barrierefrei')
        && (bool)$this->request->getArgument('enable_barrierefrei');
    $this->registry->set('tx_ljbarrierefrei', 'enable', $enabled);
    return $this->redirect('index');
}

f:form.checkbox schickt ein verstecktes Leerfeld mit. Deshalb kommt auch eine abgewählte Checkbox als leerer Wert an und wird korrekt als false gespeichert. Dein Template kann so bleiben.

3. Im Frontend liest du den Wert genauso wieder aus, z. B. im Controller deines Frontend-Plugins:

$this->view->assign(
    'enableBarrierefrei',
    (bool)$this->registry->get('tx_ljbarrierefrei', 'enable', false)
);

Im Template nutzt du dann {enableBarrierefrei}. {settings.…} funktioniert dafür nicht, weil settings aus TypoScript/FlexForm kommt und nicht aus der Datenbank. Achte darauf, dass das Plugin nach einer Änderung nicht veraltet aus dem Seitencache kommt. Leere nach dem Speichern den Cache oder registriere die Action als nicht cachebar.

Doku zur Registry: https://docs.typo3.org/m/typo3/reference-coreapi/12.4/en-us/ApiOverview/SystemRegistry/Index.html