Erstellen von benutzerdefinierten Inhaltselementen mit Mask in TYPO3

Sind Sie es leid, den mühsamen Prozess der Erstellung benutzerdefinierter Inhalts elemente in TYPO3 zu durchlaufen? Sagen Sie auf Wiedersehen zu den Komplexitäten des Codierens und heißen Sie Mask willkommen, die innovative Lösung, die die Inhalts erstellung in TYPO3 vereinfacht. In diesem Blogbeitrag werden wir erkunden, wie Mask die Art und Weise revolutioniert, wie Sie benutzerdefinierte Inhalts elemente erstellen und verwalten, wodurch die TYPO3 Entwicklung effizienter und benutzerfreundlicher wird.

Nachdem Sie die einfachen Installations schritte befolgt haben, können Sie sofort mit Mask beginnen.

Installationsanleitung

Diese umfassende Anleitung führt Sie durch die Installations- und Konfigurations­schritte, um problemlos mit Mask zu starten.

Vorbereitungen: Bevor Sie sich in Mask vertiefen, stellen Sie sicher, dass Sie Ihr Seitenpaket eingerichtet haben. Dies ist entscheidend für eine nahtlose Integration und Anpassung.

Hinzufügen von Mask als Abhängigkeit: Das Hinzufügen von Mask als Abhängigkeit in der ext_emconf.php Ihres Seitenpakets ist entscheidend, um sicherzustellen, dass Mask vor Ihrer Themen-Erweiterung geladen wird. Diese Reihenfolge ermöglicht es Ihnen, das generierte TCA von Mask effektiv in Ihrem "Overrides"-Ordner zu überschreiben.

Greifen Sie bequem auf das Backend-Modul zu, das sich direkt unter dem Erweiterungs manager-Modul befindet. Mit nur wenigen Klicks sind Sie bereit, personalisierte Inhalts elemente zu erstellen, die auf Ihre spezifischen Anforderungen zugeschnitten sind.

Für Composer-Installationen sollten Sie auch die Anforderung in der composer.json-Datei Ihrer Erweiterung nicht vergessen. Es ist erwähnenswert, dass in TYPO3 v11 die Datei ext_emconf.php im Composer-Modus nicht mehr erforderlich ist.

{ "require": { "mask/mask": "^8.1" } }
Hinweis: Wenn Sie die Abhängigkeit hinzufügen, nachdem Mask bereits installiert und aktiviert wurde, ist es notwendig, die Lade­reihenfolge durch Neuinstallation Ihrer Erweiterung neu aufzubauen.

• Laden Sie Mask mit Composer herunter, indem Sie den Befehl composer require mask/mask ausführen, oder installieren Sie es über den Erweiterungs-manager.
• Aktivieren Sie Mask im Erweiterungs-manager. (Nicht erforderlich im Composer-Modus von TYPO3 v11)
• Mask benötigt fluid_styled_content, stellen Sie also sicher, dass es in Ihren statischen Einbindungen im Template-Modul enthalten ist.
• Sie können fluid_styled_content im Composer-Modus mit dem Befehl installieren: composer require typo3/cms-fluid-styled-content.
• Fügen Sie außerdem das statische TypoScript von Mask hinzu.
• Wechseln Sie zum Maskenmodul und geben Sie den Schlüssel Ihrer Seitenpaket-Erweiterung für die automatische Konfiguration ein (Ihre Erweiterung muss geladen sein).
• Beginnen Sie mühelos mit der Erstellung Ihrer eigenen Inhalts-elemente!

Manuelle Konfiguration:

Wenn Sie die Ordnerstruktur anpassen möchten, die durch die automatische Konfiguration erstellt wird, können Sie jeden Pfad in der Erweiterungskonfiguration von Mask anpassen.

Tipp: Es wird empfohlen, die Datei LocalConfiguration.php (in der die Erweiterungskonfiguration gespeichert ist) in der Versions­verwaltung zu haben, um das Teilen und die Zusammenarbeit zu erleichtern.

Ähnlich wie beim Elementschlüssel müssen Sie einen eindeutigen Schlüssel für Ihr Feld entwickeln. Benutzerdefinierte Felder beginnen immer mit dem Präfix "tx_mask_", das nicht entfernt werden kann. Dieses Präfix ist entscheidend, um Konflikte mit vorhandenen Feldern zu vermeiden. Darüber hinaus haben Sie die Möglichkeit, aus vorhandenen TYPO3-Kernfeldern oder Maskenfeldern im Dropdown-Menü zu wählen.

Die meisten Felder teilen folgende Optionen:

Feldschlüssel: Dies ist der eindeutige Schlüssel für das Feld, wie zuvor beschrieben. Er bestimmt den Namen der neuen Spalte in der Datenbanktabelle tt_content.
Bezeichnung: Die Bezeichnung ist das, was Redakteure sehen, wenn sie das Inhalts­element bearbeiten. Es kann eine lokalisierte Zeichenfolge sein.
Beschreibung: Dies bietet zusätzliche Informationen für Redakteure und erscheint unterhalb der Bezeichnung. Es ist hilfreich, um Redakteure beim Verwenden des Feldes zu führen.
Auf Standard zurücksetzen: Diese Option setzt alle TCA (Table Configuration Array) Optionen auf ihre Standardwerte zurück, mit Ausnahme der Bezeichnung und Beschreibung.

Das Tabellenkonfigurationsarray (TCA) ist für Mask in der TYPO3-Entwicklung wichtig. Das TCA definiert die Struktur und das Verhalten von Datenbanktabellen, die von TYPO3 verwendet werden, um Inhalts­elemente zu speichern, einschließlich benutzerdefinierter Inhalts­elemente, die mit Mask erstellt wurden.

Hier ist, warum das TCA für Mask wichtig ist:

Datenbankstruktur:
Das TCA legt die Struktur der Datenbanktabellen fest, in denen Inhalts­elemente gespeichert werden. Wenn Sie benutzerdefinierte Inhalts­elemente mit Mask erstellen, definiert das TCA, wie die Daten für diese Elemente in der Datenbank gespeichert werden.

Feldkonfiguration:
Das TCA ermöglicht es Ihnen, verschiedene Eigenschaften von Feldern innerhalb von Inhalts­elementen zu konfigurieren, wie ihren Typ, ihre Bezeichnung, Beschreibung und Validierungsregeln. Diese Konfiguration gewährleistet Konsistenz und Integrität der in der Datenbank gespeicherten Daten.

Integration mit TYPO3 Core:
Das TCA bietet Integration mit den Kernfunktionen von TYPO3, sodass von Mask generierte Inhalts­elemente nahtlos mit anderen TYPO3-Funktionen und -Erweiterungen interagieren können.

Anpassung und Erweiterbarkeit:
Das TCA bietet umfangreiche Anpassungsmöglichkeiten, mit denen Sie das Verhalten und das Erscheinungsbild von Inhalts­elementen entsprechend Ihren spezifischen Anforderungen anpassen können. Diese Flexibilität ermöglicht es Entwicklern, reiche und dynamische Benutzererfahrungen innerhalb von TYPO3 zu schaffen.

Die Registerkarte "Element-Metadaten" bietet wesentliche Details zu Ihrem Inhalts­element in TYPO3. Hier finden Sie allgemeine Informationen wie die Bezeichnung und den Schlüssel, die Sie möglicherweise bei der Erstellung definiert haben. Darüber hinaus finden Sie die folgenden Felder:

Kurztitel: Dieses Feld bietet einen prägnanten Titel für Ihr Element, der beim Auswählen des Elementtyps sichtbar ist. Wenn es leer gelassen wird, wird der Standardtitel verwendet.

Beschreibung: Durch das Hinzufügen einer Beschreibung können Redakteure den Zweck des Elements besser verstehen. Es erscheint neben dem Titel und dem Vorschaubild im Erstellungs-Assistenten.

Symbol: Fügen Sie Ihrem Element schnell ein Vorschausymbol hinzu, indem Sie aus einer Reihe von FontAwesome-Symbolen auswählen. Wählen Sie aus verschiedenen Kategorien oder suchen Sie nach Stichworten. Wenn kein Symbol angegeben ist, wird ein Fallback-Symbol generiert, das den ersten Buchstaben Ihrer Bezeichnung verwendet.

Farbe: Passen Sie die Farbe des Symbols an, um die visuelle Unterscheidung zu verbessern.

Mask revolutioniert die Inhalts-erstellung in TYPO3 und bietet eine benutzerfreundliche Lösung für die einfache Erstellung benutzerdefinierter Inhalts-elemente. Mit seiner intuitiven Benutzeroberfläche, flexiblen Anpassungsmöglichkeiten und nahtlosen Integration in TYPO3 ermöglicht Mask Entwicklern, dynamische und ansprechende Websites effizient zu erstellen. Verabschieden Sie sich von mühsamem Codieren und sagen Sie hallo zu Mask – Ihrem ultimativen Werkzeug für die benutzerdefinierte Inhalts-erstellung in TYPO3.