Referenz von Inhaltsattribut und Version #

Die Werte von data_map sind Objekte eZContentObjectAttribute (kernel/classes/ezcontentobjectattribute.php): ein Feld einer Version in einer Sprache. Eine Version ist ein eZContentObjectVersion (kernel/classes/ezcontentobjectversion.php), erreichbar über $object.current oder $object.versions. Diese Seite führt auf, was Templates von beiden lesen können und was content für jeden Datentyp ist.

Inhalt #

1. Inhaltsobjekt-Attribut: Datenbankfelder
2. Inhaltsobjekt-Attribut: Funktionsattribute
3. Was content zurückgibt, pro Datentyp
4. Version: Datenbankfelder
5. Version: Funktionsattribute
6. Hinweise
7. Verwandte Seiten

Die Tabellen entstanden wie die Tabelle der Knotenattribute: definition() aufgeführt und jeder Name auf einer Entwicklungsinstallation gelesen, hier am Attribut title und an der aktuellen Version von Knoten 96 (Objekt 94, ein ng_article).

Inhaltsobjekt-Attribut: Datenbankfelder #

Die Felder data_text, data_int und data_float sind die rohe Speicherung. Welches ein Datentyp nutzt und wie, ist Sache des Datentyps: ezstring behält seinen Text in data_text und lässt data_int leer (null oben); eZContentObjectAttribute::attribute() macht aus einem data_text mit null den Wert '', sodass Templates dort nie null sehen.

Inhaltsobjekt-Attribut: Funktionsattribute #

Ein Beispiel:

{def $attribute = fetch( 'content', 'node', hash( 'node_id', 96 ) ).data_map.title}
id / version / language: {$attribute.id} / {$attribute.version} / {$attribute.language_code}
class attribute:         {$attribute.contentclass_attribute_identifier} "{$attribute.contentclass_attribute_name|wash}" ({$attribute.contentclassattribute_id})
datatype:                {$attribute.data_type_string}, is_a: {$attribute.is_a}
required / translatable: {$attribute.is_required} / {$attribute.can_translate}
templates:               view {$attribute.view_template}, edit {$attribute.edit_template}
stored:                  data_text "{$attribute.data_text|wash}", sort_key_string "{$attribute.sort_key_string|wash}"

Ausgabe:

id / version / language: 580 / 1 / eng-US
class attribute:         title "Title" (334)
datatype:                ezstring, is_a: ezstring
required / translatable: 1 / 1
templates:               view ezstring, edit ezstring
stored:                  data_text "Why Should You Choose Strength Training?", sort_key_string "why should you choose strength training?"

Was content zurückgibt, pro Datentyp #

content ruft eZContentObjectAttribute::content() auf, das einmal objectAttributeContent() des Datentyps fragt und das Ergebnis am Attribut behält. Dieses Template durchlief die ersten 150 Knoten unter der Startseite Fit & Healthy auf einer Entwicklungsinstallation und gab für jeden Datentyp beim ersten Mal mit Inhalt aus, was content zurückgab:

{def $seen = array()}
{foreach fetch( 'content', 'tree', hash( 'parent_node_id', 89, 'limit', 150 ) ) as $node}{foreach $node.data_map as $attribute}{if and( $attribute.has_content, $seen|contains( $attribute.data_type_string )|not )}{set $seen = $seen|append( $attribute.data_type_string )}{$attribute.data_type_string}: {if is_object( $attribute.content )}object {$attribute.content|get_class}{else}{$attribute.content|get_type|explode( '[' )|extract_left( 1 )|implode( '' )}{/if} ({$node.class_identifier}.{$attribute.contentclass_attribute_identifier})

{/if}{/foreach}{/foreach}

Ausgabe:

ezstring: string (ng_article.title)
ezxmltext: object ezxmltext (ng_article.teaser_intro)
xrowmetadata: object xrowmetadata (ng_article.metadata)
eztags: object eztags (ng_landing_page.tags)
ezimage: object ezimagealiashandler (ng_article.image)
ezobjectrelationlist: array (ng_article.authors)
ezdatetime: object ezdatetime (ng_blog_post.publish_date)
ezinteger: integer (ng_gallery.column_count)
ezboolean: integer (ng_category.show_children)
ezemail: string (ng_contact_form.recipient)
ngenhancedlink: object ngenhancedlinkvalue (ng_component_hero.link_1)
ezbinaryfile: object ezbinaryfile (ng_video.video_file)
ezmedia: object ezmedia (ng_audio.file)
eztext: string (ng_htmlbox.html_code)
ezurl: string (ng_site_info.facebook)
ezprice: object ezprice (product.price)
ezsrrating: object ezsrratingobject (product.rating)
ezmatrix: object ezmatrix (product.specifications)

get_class schreibt Klassennamen klein, das Beispiel zeigt also ezimagealiashandler für eZImageAliasHandler. Die Seite Data Map und Inhalt liest mehrere dieser Inhalte im Detail.

Version: Datenbankfelder #

status ist der Status der Version: eZContentObjectVersion::STATUS_DRAFT (0), STATUS_PUBLISHED (1), STATUS_PENDING (2), STATUS_ARCHIVED (3), STATUS_REJECTED (4), STATUS_INTERNAL_DRAFT (5), STATUS_REPEAT (6), STATUS_QUEUED (7).

Version: Funktionsattribute #

Ein Beispiel:

{def $version = fetch( 'content', 'node', hash( 'node_id', 96 ) ).object.current}
version {$version.version}, status {$version.status}, created {$version.created|datetime( 'custom', '%Y-%m-%d' )}
name in this version: {$version.version_name|wash}
translations: {foreach $version.translation_list as $t}{$t.language_code}{delimiter}, {/delimiter}{/foreach}

creator object id: {$version.creator_id}

Ausgabe:

version 1, status 1, created 2020-09-24
name in this version: Why Should You Choose Strength Training?
translations: eng-US
creator object id: 14

Hinweise #

• language gibt dasselbe Attribut in einer anderen Sprache zurück: ohne Sprachcode in der Ausgangssprache des Objekts (eZContentObjectAttribute::language()).
• view_template und edit_template sind die Namen (ohne .tpl), die attribute_view_gui und attribute_edit_gui unter content/datatype/view/ und content/datatype/edit/ suchen; bei einem Attribut zur Informationssammlung gibt view_template stattdessen das Template des Sammlers zurück.
• class_content ist der Inhalt des Klassenattributs (die Einstellungen des Felds, etwa die Optionen einer Auswahl).
• has_content kommt von hasObjectAttributeContent() des Datentyps. Die meisten Datentypen geben einen booleschen Wert zurück; der Datentyp ezimage gab auf einer Entwicklungsinstallation bei einem Bildfeld ohne Bild eine leere Zeichenkette zurück (siehe Der Template-Compiler dazu, warum das bei choose zählt).
• can_read und can_remove einer Version prüfen die Richtlinien content/versionread und content/versionremove des aktuellen Benutzers; als anonymer Benutzer waren beide false.

Verwandte Seiten #

• Das Objektmodell in Templates
• Data Map und Inhalt
• Referenz der Knotenattribute
• Referenz der Attribute von Inhaltsobjekten
• Ansichts-Templates von Datentypen
• Datentypen mit Beispielen
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.