{{ form }}

form Properties

FieldTypeDescription
object_typestring"form"
is_validTrue|FalseTrue if this references a form or false if the form is null
guidguidThe unique identifier for this form
redirect_urlurl_field
template_override_guidtext_field
nametext_fieldThe entity name. This field is primarily intended for internal use by website administrators to identify objects.
titletext_field
linked_titlehtmlA link to the form if it has a URL, or the escaped title if not.
folder_guidtext_field
folderfolder
has_urltrue|false
site_domain_guidtext_field
ssl_modetext_field
include_in_searchtrue|false
urltext_field
template_guidtext_field
templatetemplate
canonical_urlurl_field
browser_titletext_field
meta_descriptiontextarea_field
meta_robotstextarea_field
keywordstextarea_field
full_urlstringThe full URL of the page - including the scheme ("http://", "https://" or just "//"), the domain name, and the path.
visitedtrue/falseWhether or not the user has visited the form before in their current session. Note that this will always be false if the user has not allowed session permission (see the Permissions and Personalization documentation).
customvariesEach form includes all of the custom properties defined by the template.
form_unique_identifierstringA helper property containing a unique ID for this instance of this form. Every time this form is output - either from this instance or from multiple instances - it should have a different ID. Specifically, every time the FormEnd property is accessed the unique ID will be reset to a new value (thereby preventing conflicting javascript code and element identifiers).
form_starthtmlA helper property to assist in creating the form markup. This property includes the form tag with the form_unique_identifier.
form_endhtmlA helper property to assist in creating the form markup. This property includes the end form tag as well as some javascript that will be used to assist in processing conditional fields, form validation, and form submissions.
javascriptstringA helper property to assist in creating the form markup. This property includes all of the javascript that will be output from the form_end property. USE WITH CAUTION.
javascript_field_configstringA helper property to assist in creating the form markup. This property includes the field configurations for the javascript that will be output from the javascript property. USE WITH CAUTION.
javascript_form_configstringA helper property to assist in creating the form markup. This property includes the form configuration for the javascript that will be output from the javascript property. USE WITH CAUTION.
form_submit_targetstringA helper property in case you decide to build and submit the form without using the form_start and form-end properties. This property contains the URL that the form must be submitted to in order to be recorded by Marketpath CMS as a form submission.
fieldslistA list containing all of the form fields that are direct children of the current form.
Note that any fields (or groups) that are part of a parent group will NOT be included in this list - they will be included as children of their parent group.
valuestringSynonymn for guid
outputhtmlThe default output that the form produces when output directly to the template.
output_in_listhtmlThe default output that the form produces when output directly to the template as part of a list.

forms Summary

Contains multiple forms.

forms Properties

FieldTypeDescription
object_typestring"forms"
is_validtrue/falsetrue if this contains at least one form
prependedlist of formsforms that will be listed at the beginning of the items list
fetchedlist of formsThe primary list of forms to be included in the items list
appendedlist of formsforms that will be listed at the end of the items list
appended_uniquelist of formsforms that will be listed at the end of the items list, excluding any forms that are already included in either the prepended or fetched lists
itemslist of formsThe full list of forms in the proper order and uniqueness, including prepended, fetched, and appended forms
sizenumberThe total number of items in the list of items, including prepended, fetched, and appended forms
limitnumberThe maximum number of forms that could have been fetched dynamically from the database
startnumberThe 1-based index of the first form that was (or would have been) dynamically fetched from the database
pagenumberThe 1-based index of the first "page" of forms that could have been fetched dynamically from the database - as determined by the start and limit properties
total_countnumberThe total number of forms in the database that matched the provided filter parameters when fetching the list of fetched forms
total_pagesnumberThe total number of "pages" of results that matched the provided filter parameters when fetching the list of fetched forms - as determined by the total_count and limit properties
outputhtmlThe default output that the forms will produce when it is output directly to the template - using the "output_in_list" property of each form in the items list

Methods

{% form %}

Fetch a single form.

{% form
[var|set|assign] new_variable_name
Specify a variable name in order to save the form to a variable. If not specified the form will be output to the template instead. The variable will be saved using the "var" behavior unless "set" or "assign" are specified.
output_to_template
If included, the form will be output directly to the template.
=
form|guid|string
%}

{% forms %}

Fetch a list of forms.

{% forms
[var|set|assign] new_variable_name
Specify 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_template
If included, the results will be output directly to the template.
=
prepend:form|forms|guid|string
Prepend the specified forms before the fetched results. All prepended input will be returned in the same order that it is input.
append:form|forms|guid|string
Append the specified forms after the fetched results. All appended input will be returned in the same order that it is input.
exclude:form|forms|guid|string
Prevent the specified forms from being included in the fetched results. Has no affect on prepended and appended forms
exclude_prepended:true
Specifically exclude all prepended forms 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:true
Specifically exclude all appended forms 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:true
If 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:25
If specified, then the "items" list will only include up to the specified number of forms. The "limit" may be automatically lowered to only fetch the maximum number of forms 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:string
Only return forms that match the given string filter
has_url:boolean
Filter results to only return forms for which has_url exactly matches the specified value.
template:template|templates|guid|string
Only return forms with one of these templates
include_in_search:boolean
Filter results to only return forms for which include_in_search exactly matches the specified value.
site_domain_guid:guid
Filter results to only return forms for which site_domain_guid exactly matches the specified value.
ssl_mode:string
Filter results to only return forms for which ssl_mode exactly matches the specified value.
folder:folder|folders|guid|string
Only return forms with one of these folders
date_created_start:datetime
Filter results to return forms for which date_created is greater than or equal to date_created_start.
date_created_end:datetime
Filter results to return forms for which date_created is less than or equal to date_created_end.
start:1
Set the 1-based index of the first form to fetch.
page:1
Automatically calculate the first form to fetch based on both of the "limit" and the 1-based "page" value. Ignored if "start" is set.
limit:25
Defines the maximum number of forms 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 forms.
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")