Freeform 2.6 Entries

Parameters

A variety of parameters are used to control the behavior of the Freeform entries tag.

{exp:freeform:entries form_name="zeus" orderby="entry_date" sort="asc" limit="20"} content {/exp:freeform:entries}

In the above example, 20 postings from the form zeus will be displayed by entry date in ascending order.

dynamic =

dynamic = "no"

Freeform looks for an entry id in the URL in order to pull a specific Freeform entry. This default behavior can be disabled by providing 'no' as the value of the 'dynamic' parameter.

entry_id =

entry_id = "{entry_id}"

Freeform allows you to specify the entry id of a specific Freeform entry in order to show one entry per page. Not that if a Freeform entry id as found in the URL and the dynamic parameter is not set to 'no', Freeform will serve an entry matching the id present in the URL.

form_name=

form_name="my_form"

The 'form_name' parameter tells Freeform by which form name to pull entries.

limit=

limit="10"

The 'limit' parameter tells Freeform by how many entries to limit what is shown in your template.

orderby=

orderby="entry_date"

The 'orderby' parameter tells Freeform by which field to order your entries.

sort=

sort="asc"

The 'sort' parameter tells Freeform in which direction to sort your entries, asc or desc.

status=

status="open|closed"

The 'status' parameter tells Freeform by which status to pull entries. Separate multiple statuses with the pipe "|" character.

Variables

In addition to all of your custom Freeform fields, the following variables are available with the {exp:freeform:entries} tag.

attachment_count

{attachment_count}

The 'attachment_count' variable will be replaced by the number of attachments uploaded at the time of form submission.

author_id

{author_id}

The 'author_id' variable will be replaced by the member id of the form submitter if they were logged in when they submitted the form.

count

{ count}

The 'count' variable will be replaced by the current row number in the list of entries.

edit_date

{edit_date format="%M %d, %Y"}

The 'edit_date' variable will be replaced by the edit date of the Freeform entry. This variable should be formatted using standard EE date formatting. Note that there will only be an edit date if you have edited a given entry using the Freeform CP.

entry_date

{entry_date format="%M %d, %Y"}

The 'entry_date' variable will be replaced by the entry date of the Freeform entry. This variable should be formatted using standard EE date formatting.

form_name

{form_name}

The 'form_name' variable will be replaced by the form name used at the time of submission.

gmt_edit_date

{gmt_edit_date format="%M %d, %Y"}

The 'gmt_edit_date' variable will be replaced by the GMT version of the edit date of the Freeform entry. This variable should be formatted using standard EE date formatting. Note that there will only be an edit date if you have edited a given entry using the Freeform CP.

gmt_entry_date

{gmt_entry_date format="%M %d, %Y"}

The 'gmt_entry_date' variable will be replaced by the GMT version of the entry date of the Freeform entry. This variable should be formatted using standard EE date formatting.

group_id

{group_id}

The 'group_id' variable will be replaced by the member group id of the form submitter if they were logged in when they submitted the form.

ip_address

{ip_address}

The 'ip_address' variable will be replaced by the ip address of the form submitter.

reverse_count

{ reverse_count}

The 'reverse_count' variable allows you to show the entry count in reverse order as your list of entries is generated.

switch

{ switch="style_one|style_two"}

The 'switch' variable behaves in Freeform the same as it does in core EE functions. Use it to alternate the presentation of your entry rows.

total_entries

{total_entries}

The 'total_entries' variable will be replaced by the total number of entries that were found meeting your filtering criteria.

template

{template}

The 'template' variable will be replaced by the Freeform notification template used at the time of form submission. Note that Freeform does not keep track of which template was used to send a notification to the submitting user, if that option was used.

Variable Pairs

attachments

{attachments}{/attachments}

The 'attachments' variable pair allows you to establish the formatting and placement of the attachment variables for each Freeform entry.

Variables available within this variable pair are:

Conditionals

Freeform will evaluate conditionals on any of the variables listed above, including all of your custom Freeform fields. Use standard EE conditional formatting.