Agenda Agenda Snippets AgendaLocations

This snippet displays a list of locations.


It uses the following snippet properties:

Property Description Default
ajax If enabled, the snippet output will be directly output as JSON result to the browser when the page is requested by Ajax (XMLHttpRequest). Available since Agenda 1.4.0. No
allowedRequestKeys Comma-separated list of request keys, that could be used to filter the displayed locations. Defaults to all allowed. Available since Agenda 1.1.0. -
emptyTpl Name of a chunk that contains the template for not found locations. tplAgendaLocationsEmpty
limit Limit the number of locations in the result. Use 0 for unlimited locations. 20
listId ID of a resource containing an AgendaList snippet call. System Setting agenda.list_id
locations Comma-separated list of aliases of locations to filter the displayed locations. -
offset An offset of locations returned by the criteria to skip. 0
outputSeparator An optional string to separate each tpl instance. -
selected Set the selected placeholder to selected="selected", when the value is equal to the location alias. -
toPlaceholder If set, the snippet result will be assigned to this placeholder instead of outputting it directly. -
totalVar The key of a placeholder that indicates the total number of locations returned by the criteria.
tpl Name of a chunk that contains the template for one location. tplAgendaLocation
wrapperTpl Name of a chunk that contains the wrapper template for all locations. tplAgendaLocationsWrapper


The following placeholders are available in the different (default) chunks. Each snippet property will be set as placeholder in each template chunk, i.e. a snippet call [[!AgendaDetail? &subtitle=`whatever`]] will fill the placeholder subtitle in each used chunk with the value whatever.

CAUTION: The default template chunks for both snippets are overwritten during each package update, so please rename the chunks before editing them.


Placeholder Description
address The address of the location.
alias The alias of the location.
center_lat The latitude of the center of a map of the location.
center_lng The longitude of the center of a map of the location.
description The description of the location.
lat The latitude of the location.
lng The longitude of the location.
name The name of the location.
resource_id The id of a linked resource of the location.
selected Contains selected="selected", when the location request value is equal to the alias of the location.
zoom The zoom level of a map of the location.


Only the current script properties are available as placeholders.


Placeholder Description
count Count of the locations filtered by the snippet properties (without limit/offset)
output All locations collected by the snippet separated by the string in the outputSeparator property