Contains multiple content.
Field | Type | Description |
object_type | string | "content" |
is_valid | true/false | true if this contains at least one entity |
prepended | list of content | content that will be listed at the beginning of the items list |
fetched | list of content | The primary list of content to be included in the items list |
appended | list of content | content that will be listed at the end of the items list |
appended_unique | list of content | content that will be listed at the end of the items list, excluding any content that are already included in either the prepended or fetched lists |
items | list of content | The full list of content in the proper order and uniqueness, including prepended, fetched, and appended content |
size | number | The total number of items in the list of items, including prepended, fetched, and appended content |
limit | number | The maximum number of content that could have been fetched dynamically from the database |
start | number | The 1-based index of the first entity that was (or would have been) dynamically fetched from the database |
page | number | The 1-based index of the first "page" of content that could have been fetched dynamically from the database - as determined by the start and limit properties |
total_count | number | The total number of content in the database that matched the provided filter parameters when fetching the list of fetched content |
total_pages | number | The total number of "pages" of results that matched the provided filter parameters when fetching the list of fetched content - as determined by the total_count and limit properties |
output | html | The default output that the content will produce when it is output directly to the template - using the "output_in_list" property of each entity in the items list |
Fetch a list of content.
{% content[var|set|assign] new_variable_nameSpecify a variable name in order to save the results to a variable. If not specified the results will be output to the template instead. The variable will be saved using the "var" behavior unless "set" or "assign" are specified.output_to_templateIf included, the results will be output directly to the template.=prepend:entity|content|guidPrepend the specified content before the fetched results. All prepended input will be returned in the same order that it is input.append:entity|content|guidAppend the specified content after the fetched results. All appended input will be returned in the same order that it is input.exclude:entity|content|guidPrevent the specified content from being included in the fetched results. Has no affect on prepended and appended contentexclude_prepended:trueSpecifically exclude all prepended content from the fetched results. If "unique:true" is specified this is the default behavior, although you may also specify "exclude_prepended:false" to allow any prepended items to be fetched along with other results anyway.exclude_appended:trueSpecifically exclude all appended content from the fetched results. This is false by default - even if "unique:true" is specified - so that results are returned in the proper order.unique:trueIf set to true, each of the resulting lists (prepended, fetched, appended, and items) will be unique, although there may be duplicates between the prepended, fetched, and appended lists. The "items" list will include objects in the order in which they appear - with prepended items first, then fetched items, then appended items.max_size:25If specified, then the "items" list will only include up to the specified number of content. The "limit" may be automatically lowered to only fetch the maximum number of content that will be included in "items" following prepended items. Note that this may also impact both the "page and "total_pages" values. In order to use pagination with a list loaded using "max_size" use "start" instead of "page" and "limit".filter:stringOnly return content that match the given string filterhas_url:booleanFilter results to only return content for which has_url exactly matches the specified value.global_type_id:stringFilter results to return content of that match the specified value.template:template|templates|guid|stringOnly return content with one of these templatesinclude_in_search:booleanFilter results to only return content for which include_in_search exactly matches the specified value.site_domain_guid:guidFilter results to only return content for which site_domain_guid exactly matches the specified value.ssl_mode:stringFilter results to only return content for which ssl_mode exactly matches the specified value.tag:tag|tags|guid|stringOnly return content with one of these tagsauthor:author|authors|guid|stringOnly return content with one of these authorsfolder:folder|folders|guid|stringOnly return content with one of these foldersdate_created_start:datetimeFilter results to return content for which date_created is greater than or equal to date_created_start.date_created_end:datetimeFilter results to return content for which date_created is less than or equal to date_created_end.start:1Set the 1-based index of the first entity to fetch.page:1Automatically calculate the first entity to fetch based on both of the "limit" and the 1-based "page" value. Ignored if "start" is set.limit:25Defines the maximum number of content to be fetched. If not included, this will default to 10. Note that if "max_size" is specified then "limit" may be automatically lowered even if specified.sort_by:"date_created"Specify which field to sort the fetched results by. Has no affect on prepended or appended content.
By default results will be sorted by relevance if there is a filter string and date_created (the date the item was first published) desc (newest first) if not.
Other Options include:
- Name
- Title
- URL
- BrowserTitle
- relevance (based on which field matches the given filter and where in the field the match is found. When sorting by relevance sort_direction is irrelevant)
- date_created (Equivalent to the date you first published this item. Unpublishing and republishing the item resets date_created to the current date)
- random (Using random sorting prevents fast caching of the page).
sort_direction:"desc"Specify whether the fetched results should be sorted in asc (ascending) or desc (descending) order.%}
If you do not include any filters or inputs other than prepended items, appended items, or max_size, then no additional items will be fetched. If you wish to fetch all items you must include at least one additional input (ie: "start:1")