Inhaltsklassen für Builder #

Teil 2, Kapitel 17. Eine Inhaltsklasse ist eine Art von Inhalt: Artikel, Veranstaltung, Produkt. Ihre Attribute sind die Felder, jedes mit einem Datentyp (eine Textzeile, Rich Text, Bild, Relation ...). Alles, was ein Builder mit Templates tut, beruht auf diesem Modell; ein wenig Sorgfalt hier erspart später viel Template-Code. Wie Sie eine Klasse Schritt für Schritt anlegen, steht in Das Inhaltsmodell und das Bearbeiten von Inhalten.

Die Begriffe #

Die Datentypen, die beim Hinzufügen eines Attributs angeboten werden, stehen in content.ini [DataTypeSettings] AvailableDataTypes[]; Erweiterungen fügen ihre eigenen hinzu (eztags zum Beispiel ein Tag-Feld).

Bezeichner sind der Vertrag #

Der Klassenbezeichner (article) und die Attributbezeichner (title, intro, body, image) sind das, was Templates, Overrides und Fetches verwenden:

{$node.data_map.title.content|wash}
{attribute_view_gui attribute=$node.data_map.body}

Match[class_identifier]=article

Wählen Sie sie deshalb einmal und mit Sorgfalt:

• Kleinbuchstaben, Ziffern und Unterstriche; englische Wörter, die sagen, was das Feld ist,
• benennen Sie nie einen Bezeichner um, den Templates verwenden (ändern Sie stattdessen den lesbaren Namen; der Bezeichner kann bleiben),
• derselbe Bezeichner für dieselbe Bedeutung in jeder Klasse (title, image, intro), damit ein Template-Teil das Bild eines Artikels, einer Nachricht und einer Veranstaltung gleichermaßen zeichnen kann.

Das Muster für den Objektnamen #

Jede Klasse hat ein Objektnamensmuster wie <title> oder <first_name> <last_name>. Es bildet den Namen, der im Baum, in Listen und in URLs erscheint. Verwenden Sie das Attribut, an dem man den Inhalt erkennt; URL-Aliase werden aus dem Namen gebildet.

Container #

Eine als Container markierte Klasse kann Unterelemente haben. Ordner, Startseiten und Bereiche einer Website sind Container; Artikel meist nicht. Die Listen eines Builders (fetch( 'content', 'list' )) ergeben nur unterhalb von Containern einen Sinn.

Gute Modelle sind langweilig #

Modellieren Sie die Inhalte so, wie Redakteure über sie denken; die Templates folgen.

Klassen in einer Erweiterung #

Eine in der Administration angelegte Klasse liegt in der Datenbank. Um sie mit einer Erweiterung auszuliefern (damit eine andere Installation sie anlegen kann), gibt es zwei Wege:

• exportieren Sie sie als Paket (Setup > Pakete, Klassenexport) und legen Sie das Paket in die Erweiterung; siehe Pakete,
• schreiben Sie sie als Skript, das die Klasse anlegt: Der RAD-Assistent Content extension (/setup/contentextension) schreibt eines für Sie (RAD-Werkzeuge).

Verwandte Seiten #

• Zurück: Caching und Templates
• Weiter: Sektionen, Rollen und Zugriff für Builder
• Das Inhaltsmodell und das Bearbeiten von Inhalten
• Klassengruppen
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.