Referenz der Knotenattribute #

$node in einem Knoten-Template ist ein eZContentObjectTreeNode (kernel/classes/ezcontentobjecttreenode.php). Was ein Template daraus lesen kann, ist genau das, was eZContentObjectTreeNode::definition() aufführt: die Datenbankfelder fields der Tabelle ezcontentobject_tree und die function_attributes, die bei jedem Lesen eine PHP-Methode aufrufen (siehe Das Objektmodell in Templates zum Protokoll).

Inhalt #

1. Wie diese Tabelle entstand
2. Datenbankfelder
3. Funktionsattribute
4. Ein Beispiel
5. Hinweise
6. Verwandte Seiten

Wie diese Tabelle entstand #

Ein nur lesendes CLI-Skript auf einer Entwicklungsinstallation (mit bin/php/ezexec.php -s site als Benutzer des Webservers ausgeführt) rief eZContentObjectTreeNode::definition() auf, führte fields und function_attributes auf und las jeden Namen mit $node->attribute( $name ) an Knoten 96, einem ng_article. Die Spalte „Wert auf einer Entwicklungsinstallation“ ist der PHP-Typ und, bei kurzen Werten, der zurückgegebene Wert. Das Skript läuft als anonymer Benutzer, die Prüfungen can_* zeigen also, was ein anonymer Besucher tun darf. Sein Kern:

$node = eZContentObjectTreeNode::fetch( 96 );
$def = $node->definition();
foreach ( $def['fields'] as $name => $field )
    echo $name, ' ', $field['name'], ' ', $field['datatype'], "\n";
foreach ( $def['function_attributes'] as $name => $method )
    echo $name, ' ', $method, ' ', gettype( $node->attribute( $name ) ), "\n";

Datenbankfelder #

Funktionsattribute #

remote_id steht in beiden Listen; ein Template liest das Funktionsattribut (remoteID()).

Ein Beispiel #

Einige dieser Attribute an Knoten 89, der Startseite „Fit & Healthy“:

{def $node = fetch( 'content', 'node', hash( 'node_id', 89 ) )}
name:            {$node.name|wash}
class:           {$node.class_identifier} ({$node.class_name|wash})
url_alias:       {$node.url_alias}
path_string:     {$node.path_string}
depth:           {$node.depth}
children_count:  {$node.children_count}
sort_array:      {$node.sort_array.0|implode( ', ' )}
is_main:         {cond( $node.is_main, 'yes', 'no' )}
hidden status:   {$node.hidden_status_string}
can_read:        {cond( $node.can_read, 'yes', 'no' )}, can_edit: {cond( $node.can_edit, 'yes', 'no' )}
current user:    {fetch( 'user', 'current_user' ).login}

Ausgabe:

name:            Fit & Healthy
class:           ng_frontpage (NG Frontpage)
url_alias:       
path_string:     /1/2/89/
depth:           2
children_count:  16
sort_array:      published, 1
is_main:         yes
hidden status:   Visible
can_read:        yes, can_edit: no
current user:    anonymous

Hinweise #

• url_alias von Knoten 89 ist leer. Der Siteaccess site hat ein Pfadpräfix ([SiteAccessSettings] PathPrefix), und urlAlias() entfernt dieses Präfix vom Anfang des Alias; Knoten 89 ist der Knoten am Präfix selbst. path_with_names ist der vollständige Aliaspfad ohne diesen Schritt, und url gibt url_alias zurück, solange [URLTranslator] Translation eingeschaltet ist, sonst content/view/full/<node id>:

{def $node = fetch( 'content', 'node', hash( 'node_id', 96 ) )}
PathPrefix:      {ezini( 'SiteAccessSettings', 'PathPrefix' )}
path_with_names: {$node.path_with_names}
url_alias:       {$node.url_alias}
url:             {$node.url}

Ausgabe:

PathPrefix:      fit-healthy
path_with_names: fit-healthy/fitness/why-should-you-choose-strength-training
url_alias:       fitness/why-should-you-choose-strength-training
url:             fitness/why-should-you-choose-strength-training

• sort_array ist eine Liste von Paaren array( sort field, ascending ), die Sortierung der Kinder des Knotens, wie fetch( 'content', 'list' ) sie versteht (hier: nach Veröffentlichungsdatum, aufsteigend ist 1).
• children, subtree und children_count führen bei jedem Lesen eine Abfrage aus. Nutzen Sie in einer Liste mit vielen Einträgen stattdessen fetch( 'content', 'list', ... ) mit limit (siehe Leistung von fetch).
• can_read, can_edit, can_hide, can_remove, can_move, can_create prüfen die Richtlinien des aktuellen Benutzers an diesem Ort; ihre Ergebnisse hängen davon ab, wer die Seite ansieht, weshalb solche Prüfungen außerhalb von Ausgaben im View-Cache gehören oder in Templates, deren Cache nach Rolle variiert (die Schlüssel des Content-View-Cache enthalten die Rollen-IDs des Benutzers).
• classes_js_array gibt eine Zeichenkette mit einem JavaScript-Array für das Menü zum Anlegen an dieser Stelle in der Administration zurück; Templates der Website brauchen es nicht.
• creator gibt das Inhaltsobjekt des Benutzers zurück, der die an diesem Knoten gespeicherte Version angelegt hat.

Verwandte Seiten #

• Das Objektmodell in Templates
• Referenz der Attribute von Inhaltsobjekten
• Referenz von Inhaltsattribut und Version
• Knoten, Objekte und Attribute
• Knoten und Listen holen
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.