Wie erstellt man ein Frontend-Plugin in TYPO3?

Lassen Sie uns ein Frontend-Plugin in Ihrer benutzerdefinierten TYPO3-Extension erstellen. Registrieren Sie das Frontend-Plugin und überschreiben Sie die tt_content.php und richten Sie TYPO3 FlexForm ein.

Wie erstellt man ein Frontend-Plugin in TYPO3?

Um ein Frontend-Plugin in einer eigenen TYPO3-Extension zu erstellen, registrieren Sie das Plugin, überschreiben tt_content.php und richten ein TYPO3 FlexForm für die Einstellungen ein. Dieses Tutorial zeigt jeden Schritt mit dem passenden Code.

Aktualisiert am 16. November 2026 | T3Planet-Redaktion

Diese Anleitung zeigt, wie Sie ein Frontend-Plugin in Ihrer eigenen TYPO3-Extension erstellen: Plugin registrieren, konfigurieren, tt_content.php überschreiben und ein FlexForm für die Einstellungen einrichten. Der Code folgt der aktuellen TYPO3-API (ab v12). Bei TYPO3 v11 und älter wird das Plugin über list_type registriert und das FlexForm braucht einen TCEforms-Wrapper.

Schritt 1. Plugin in tt_content.php registrieren

Legen Sie in Ihrer Extension die Datei Configuration/TCA/Overrides/tt_content.php an. Sie registriert das Plugin, zeigt das FlexForm-Feld an und verknüpft die FlexForm-Datei.

<?php
// Configuration/TCA/Overrides/tt_content.php
defined('TYPO3') or die();

use TYPO3\CMS\Core\Utility\ExtensionManagementUtility;
use TYPO3\CMS\Extbase\Utility\ExtensionUtility;

// Register the plugin. The returned value is the plugin signature (CType).
$pluginSignature = ExtensionUtility::registerPlugin(
    'ExtensionName',
    'Pi1',
    'Title'
);

// Show the FlexForm field for this plugin
ExtensionManagementUtility::addToAllTCAtypes(
    'tt_content',
    '--div--;Configuration,pi_flexform',
    $pluginSignature,
    'after:subheader'
);

// Attach the FlexForm file
ExtensionManagementUtility::addPiFlexFormValue(
    '*',
    'FILE:EXT:extension_key/Configuration/FlexForms/pi1_name.xml',
    $pluginSignature
);

Schritt 2. Plugin in ext_localconf.php konfigurieren

Legen Sie fest, welche Controller-Aktionen das Plugin aufrufen darf. Fügen Sie dies in die ext_localconf.php Ihrer Extension ein. Die erste Aktion in der Liste ist die Standardaktion.

<?php
// ext_localconf.php
defined('TYPO3') or die();

use TYPO3\CMS\Extbase\Utility\ExtensionUtility;
use Vendor\ExtensionName\Controller\MyController;

ExtensionUtility::configurePlugin(
    'ExtensionName',
    'Pi1',
    [MyController::class => 'list'],
    [],
    ExtensionUtility::PLUGIN_TYPE_PLUGIN
);

Schritt 3. TYPO3 FlexForm erstellen

Legen Sie Configuration/FlexForms/pi1_name.xml an. Ab TYPO3 v12 ist der TCEforms-Wrapper nicht mehr nötig. Versehen Sie Feldnamen mit dem Präfix settings., damit Extbase die Werte als Einstellungen an Ihren Controller übergibt.

<!-- Configuration/FlexForms/pi1_name.xml -->

<T3DataStructure>
    <sheets>
        <sDEF>
            <ROOT>
                <sheetTitle>Fields</sheetTitle>
                <type>array</type>
                <el>
                    <settings.headline>
                        <label>Headline</label>
                        <config>
                            <type>input</type>
                            <required>1</required>
                        </config>
                    </settings.headline>
                </el>
            </ROOT>
        </sDEF>
    </sheets>
</T3DataStructure>

Schritt 4. Plugin verwenden

Leeren Sie alle Caches, fügen Sie dann auf einer Seite ein neues Inhaltselement hinzu und wählen Sie Ihr Plugin im Reiter „Plugins“. Die FlexForm-Felder erscheinen im Konfigurationsreiter des Plugins. Im Controller lesen Sie sie mit $this->settings['headline'] aus.

  • Ein Frontend-Plugin braucht ein registriertes Plugin, eine Überschreibung von tt_content.php und ein FlexForm für die Einstellungen.
  • Über das FlexForm ändern Redakteure Plugin-Optionen im Backend.
  • Arbeiten Sie in Ihrer eigenen Extension, nie im TYPO3-Core oder in fremden Extensions.
  • Sie suchen fertige Plugins? Sehen Sie sich TYPO3 Extensions an.

Ein Teil einer Extension, der Inhalte auf einer Seite ausgibt und als Inhaltselement eingefügt werden kann.

Eine eigene Extension, die Plugin-Registrierung, eine Überschreibung von tt_content.php und eine FlexForm-Datei für die Einstellungen.

Es legt die Einstellungen fest, die Redakteure im Plugin-Formular im Backend ändern können.

In Ihre Extension, nach Configuration/TCA/Overrides/tt_content.php.

Ja, mit TypoScript. Siehe das zugehörige Tutorial zum Einfügen eines Plugins per TypoScript.

You May Also Like