The Advanced Tab

You can use the fields on this tab to control advanced features. You do not need to make any changes to the fields on this tab in most cases. None of the fields are required, and the widget will always work without you making any settings here.

The Advanced tab contains the following fields:

Widget wrapper settings

This group contains the following fields:

Wrapper (pick value from list, default=No wrapper)

Select the name of the HTML element you want to be used to enclose the entire widget. If you do not want the widget to be wrapped in this way, select No wrapper.

You can select one of the following values:

No wrapper, article, section, div, span, p, pre, h1, h2, h3, h4, h5, h6

Style Id (plain text)

Sets the id attribute of the Wrapper element. If you do not enter a value then the wrapper element has no id attribute.

Style Class (plain text)

Sets the class attribute of the Wrapper element. You can enter several class names in this field. If you do not enter a value then the wrapper element has no class attribute.

Field wrapper settings

This group contains the following fields:

Wrapper type (pick value from list, default=Default)

Select Custom if you want to be able to choose the HTML element and attributes used to display the selected item of information. If you choose Default, then a p element is used, with a class attribute set to the name of the information item displayed.

You can select one of the following values:

Default, Custom

Custom field wrapper (pick value from list, default=No wrapper)

Select the name of the HTML element you want to be used to display the selected field. If you do not want the field wrapped in an element, select No wrapper.

This option is only used if Field wrapper is set to Custom.

You can select one of the following values:

No wrapper, article, section, div, span, p, pre, h1, h2, h3, h4, h5, h6

Style Id (plain text)

Sets the id attribute of the Field wrapper element. If you do not enter a value then the wrapper element has no id attribute.

This option is only used if Field wrapper is set to Custom.

Style class (plain text)

Sets the class attribute of the Field wrapper element. If you do not enter a value then the wrapper element has no class attribute.

This option is only used if Field wrapper is set to Custom.

Caching settings

This group contains the following fields:

Edge Side Includes (ESI) (boolean, default=false)

Check this option to enable ESI includes for this widget. You can only use this option if your installation includes a web cache (such as Varnish) that both supports ESI includes and has been configured to process them.

Note also that whether or not ESI is actually used when enabled depends upon the sections in which the widget appears. ESI must be enabled for a publication or sections of a publication by setting the section parameter template.enableESI to true. If the section in which a widget appears (or one of its parent sections) does not have this parameter set, then ESI will not be used even if you have enabled it here.

Maximum age (in seconds) (number, default=60)

Determines how long the caching server may cache this widget. It does so by setting the HTTP header Cache-Control: max-age=NNN.

Set cache control directive (pick value from list, default=Private)

Sets the cache-control header.

You can select one of the following values:

Public, Private, No cache

Widget properties

This group contains the following fields:

Widget properties (plain text)

Sets the properties of this widget.