attribute_view_gui #

This page is for designers who print fields of content. {attribute_view_gui} hands a field to the template of its datatype, which knows how to draw it: rich text as HTML, an image in an alias, a date in the locale's format.

Contents #

1. Basic use
2. Which template it uses
3. Extra parameters
4. Restyling one field with an override
5. Information collector fields

Basic use #

{attribute_view_gui attribute=$node.data_map.body}
{attribute_view_gui attribute=$node.data_map.image image_class='medium'}

Test optional fields first: {if $node.data_map.image.has_content}...{/if}.

Which template it uses #

The function is defined in kernel/common/eztemplateautoload.php (eZObjectForwardInit). It takes the template folder content/datatype/view/ and the field's view template name, which is its datatype: a text line uses content/datatype/view/ezstring.tpl, rich text ezxmltext.tpl, an image ezimage.tpl (the folder lists them all). Like every template, these are found through the design cascade, so your design can replace the one for a datatype.

Extra parameters #

Every other parameter is passed to the datatype template. The kernel's ezimage.tpl documents its own at the top: image_class (the alias, default large), css_class, alignment, link_to_image, href, alt_text, title and more. Read the header of a datatype template to see what it accepts.

Restyling one field with an override #

The function sets override keys you can match on: attribute_identifier, attribute (the class attribute id), class_identifier, class. To draw the image field of articles differently:

[mytheme_article_image]
Source=content/datatype/view/ezimage.tpl
MatchFile=datatype/article_image.tpl
Subdir=templates
Match[class_identifier]=article
Match[attribute_identifier]=image

The override template receives $attribute like the original (Override basics).

Information collector fields #

A field marked as an information collector (a feedback form) is drawn from content/datatype/collect/ instead of view/, so it renders as an input. See Forms in templates.

Related pages #

• Datatype view templates
• Nodes, objects and attributes
• Free documentation: this page is free to copy, translate and improve under the GNU FDL 1.3.