Structure

The "Structure" section defines the site's data and the search parameters over it. It consists of the "Routes" tab and the "Object fields", "Search", "Filters", "Sort" and "Limits" settings. The structure settings are passed to the template during its render - changes in the structure do not require changes in the template

Pages

The "Routes" tab - the list of the site's pages on which the template is rendered. Each page has a path that can be set separately for each site language. Pages can be nested: the full path of a child page consists of the paths of its parent pages and its own segment. During the render, the path of the page the template is loaded from is matched against the full paths of the pages for the current language, if no match is found or the page is disabled - the template is not rendered

Page settings: "Route filters" - a list of object field options that are applied as the page's base filters: only the objects that contain each of the selected options (or one nested in it) are shown. Also, for each page a list is selected separately for each of the "Search", "Filters", "Sort" and "Limits" settings. By default the lists selected for the site in the "Search default", "Filters default", "Sorting default" and "Limits default" fields are used, the "None" value disables the corresponding setting

Object fields

The "Object fields" setting - the list of an object's fields. A field has a name, an identifier and a type. Field types: "String", "Textarea", "Number", "Date", "Image". Types with options: "Single selector" - one option from the list, "Multi selector" - several options from the list, "API selector" - several option keys without a list, the keys are not validated (edited in the cabinet and via the API). A value of the "String" type can hold up to 512 characters for each language, the "Textarea" type - up to 64000 characters for each language. System fields are present in every object: name, status, creation date, update date

Field parameters: "Required field" - the field's value is required to save the object. "Translatable field" (only for the "String" and "Textarea" types) - the field's value can be stored separately for each site language. "Field dependency" - the field is available only in the objects where the given option of another field is selected

Search box

The "Search" setting - lists of the fields the text search of the "Search" element runs over. A list item - an object field of the "String" or "Textarea" type, or the system name field. The search query is matched against all fields of the list. The "Typos" column of a list field: "Yes" - the search also finds the words of this field written with typos (a word from 4 letters - one typo, from 7 letters - two. The first letter must match), exact matches rank higher in relevance. It gives more extra matches and makes the query a bit slower. The list in use is defined by the "Search default" field or by the page setting

Filters

The "Filters" setting - lists of the filters shown by the "Filters" element. A list item - an object field and a filter type: for fields with options - "Checkboxes" or "Radio buttons", for fields of the "Number" type - "Numeric". A second click on the chosen option of a "Radio buttons" filter removes the choice. The order of the list items defines the order of the filters in the template. The filter of a field with the "Field dependency" parameter carries the "Filter unavailable" state until the filter of the other field has that option chosen (or one nested in it), and loses its value in that state. Until that choice is applied the filter carries the "Filter pending" state. A page that fixes the other field by its conditions or a token keeps such a filter only for the option it depends on, its parent or a nested one. When the other field is neither a filter of the page nor fixed by it, the filter is always shown

The list in use is defined by the "Filters default" field or by the page setting. Besides the created lists, the "Auto detected" value is available: every field with options becomes a filter (filter type "Checkboxes") as well as every field of the "Number" type (filter type "Numeric"), in the order of the fields

Sorting

The "Sort" setting - lists of the sorting options shown by the "Sorting" element. A list item: "Key" - the option's identifier, passed in the page URL and in API requests. "Label" - the option's label. "Object field" - a field of the "String", "Textarea", "Number", "Date" type or the system field of the name, creation date or update date. "Order" - "Descending" or "Ascending". The list in use is defined by the "Sorting default" field or by the page setting

Limits

The "Limits" setting - lists of the results-per-page options shown by the "Objects limit" element. A list item: "Key" - an integer from 1 to 100, the number of results. "Label" - the option's label. The first item of the list is applied by default. The list in use is defined by the "Limits default" field or by the page setting. With the "None" value there is no choice of how many, but the results are still split into pages of 100