Konfiguration Überblick
Jedem CustomCatalog liegt eine Konfiguration zu Grunde, die maßgeblich für die Integration in das System verantwortlich ist.
Mit Aktivierung des CustomCatalog-Plugins hat jedes CustomElement einen neuen "CustomCatalog"-Button erhalten. Dahinter verbergen sich die Konfigurationen des jeweiligen CustomElements.
In der Konfigurations-Maske werden die Kernfunktionen des CustomCatalogs festgelegt.
Neben der Integration in der Datenbankstruktur, werden in der Konfiguration auch die Backend-bezogenen Einstellungen vorgenommen und spezifische Einstellungen wie Mehrsprachigkeit oder Kommentar-Funktion für den CustomCatalog aktiviert.
Schritt 3: Konfiguration anlegen
3.1 Konfiguration anlegen
Meine Inhaltselemente > Konfiguration bearbeiten > Neue Konfiguration anlegen
In diesem Tutorial soll das CustomElement Mein erster Katalog als Neue Tabelle in der Contao Datenbank etabliert werden und im System als neues Backend-Modul zugänglich gemacht werden.
Folgende Einstellungen nutzen wir für unsere Konfiguration:
Zusätzliche Informationen zu den Einstellungen finden sich auch im Contao Handbuch.
CustomCatalog interagiert nahtlos mit dem Contao DataContainer Array und kann daher auch direkt über diesen angesprochen werden.
Hinweis: Wir empfehlen Tabellennamen zu wählen, die nicht mit tl_ beginnen. Es kann sonst zu Überschneidungen mit existierenden Tabellen aus dem Contao Core oder anderen externen Erweiterungen kommen. Wir persönlich nutzen als Prefexi "cc_", da es einen direkten Bezug auf einen CustomCatalog gibt.
Konfiguration aktiviert
Nach dem Speichern ist der CustomCatalog aktiv.
Ab jetzt wird der CustomCatalog sowohl als neue Datenbanktabelle erkannt, als auch als neues Backend-Modul.
CustomCatalog informiert, wenn ein Datenbankupdate ausgeführt werden sollte. Zum Beispiel, wenn neue Felder angelegt oder gelöscht wurden.
3.2 Die Datenbank updaten
System > Erweiterungsverwaltung > Datenbank aktualisieren
CustomCatalog untersucht regelmäßig (zum Beispiel nach dem Speichern eines neuen Attributes), ob die Datenbankstruktur der CC Tabellen aktuell ist.
CustomCatalog erstellt dabei nicht ungesehen oder automatisch die neuen Felder in der Datenbank, sondern nutzt den sicheren Weg über das Contao Datenbankupdate (hier über die Erweiterungsverwaltung).
Es wird die neue Tabelle cc_mein_erster_katalog und die dazugehörigen Felder (entsprechend den Alias) für das Update vorgeschlagen.