Die persistent variable #

Diese Seite ist für Designer, deren Inhalts-Template den Rahmen beeinflussen muss: eine Seitenspalte auf einer Landingpage ausblenden, für eine Klasse eine Klasse am body hinzufügen, den Seitentitel ändern. Das View-Template läuft vor dem Pagelayout und kann es nicht direkt erreichen; die persistent variable überbringt die Nachricht.

Inhalt #

1. Sie setzen
2. Sie lesen
3. Warum „persistent“
4. Helfer
5. Beispiele in den mitgelieferten Designs

Sie setzen #

Setzen Sie in einer Vollansicht (oder einem Override davon) die Template-Variable persistent_variable im Wurzel-Gültigkeitsbereich auf einen Hash:

{set scope=global persistent_variable=hash( 'body_class', 'landing', 'left_menu', false() )}

Die Inhaltsansicht liest sie nach dem Rendern (kernel/classes/eznodeviewfunctions.php: Der Kernel setzt sie vor dem Lauf der View auf false und kopiert jeden anderen Wert in content_info).

Sie lesen #

Im Pagelayout:

{def $pv = cond( and( is_array( $module_result.content_info ), is_set( $module_result.content_info.persistent_variable ) ),
                 $module_result.content_info.persistent_variable, false() )}
<body class="{if and( $pv, is_set( $pv.body_class ) )}{$pv.body_class|wash}{/if}">

Warum „persistent“ #

Der Wert wird mit dem Eintrag im View-Cache gespeichert (der Kernel fügt ihn den Cache-Schlüsseln hinzu), sodass eine Seite, die aus dem View-Cache kommt, denselben Wert liefert wie beim Rendern. Eine auf andere Weise gesetzte Variable ginge bei einem Cache-Treffer verloren.

Helfer #

• ezcss_require und ezscript_require verwenden die persistent variable, um Listen von Stylesheets und Skripten zu übergeben.
• ezpagedata_set( 'key', value ) und ezpagedata_append der Erweiterung ezwebin schreiben hinein, und ezpagedata() liest sie zurück (Das Design ezwebin als Grundlage).

Beispiele in den mitgelieferten Designs #

Das Pagelayout von admin4 liest persistent_variable.left_menu und extra_menu, sodass das Template einer Bearbeitungsseite eine eigene linke Spalte verlangen kann (design/admin4/templates/pagelayout.tpl).

Verwandte Seiten #

• Module result und content info
• Vollansicht
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.