Kurz gefasst
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.
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.
Wichtigste Punkte
- 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.
FAQs
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.
Sanjay Chauhan
Sanjay Chauhan A young technology enthusiast and entrepreneur. At 24, he co-founded NITSAN – a TYPO3 Agency in Bhavnagar, India. I love TYPO3, I would like to furnish TYPO3 people with informative content, tutorials, and experiences by composing regular TYPO3 blogs “as to give back to the community”. Today Sanjay is CTO and a TYPO3 innovator at NITSAN.
More From Author