Freeform Freeform for ExpressionEngine

Freeform_Next:Forms tag

The Freeform_Next:Forms template tag displays a list of available forms on your site.

Parameters

form

Specify the handle of the form you'd like to be displayed.

form_id

Specify the ID of the form you'd like to be displayed.

Variables

{form:name}

Outputs the name of the form.

{form:handle}

Outputs the handle of the form.

{form:id}

Outputs the unique ID of the form.

{form:description}

Outputs the description of the form.

{form:return_url}

Outputs the return URL of the form.

Conditionals

{if form:no_results}{/if}

Displays its contents when there are no results found for this template tag with the given set of parameters.

Examples

Basic List of Forms

The following is a simple example of how to display a list of available forms:

<ul>
{exp:freeform_next:forms}
	<li>
		<a href="{path='freeform/form/{form:handle}'}">{form:name}</a>
		<a href="{path='freeform/form/{form:handle}/submissions'}">
			({form:submission_count} submissions)
		</a>
	</li>
{if form:no_results}
	<li>
		There are currently no forms for this site.
	</li>
{/if}
{/exp:freeform_next:forms}
</ul>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

Basic Table of Forms

The following example is similar to the one in the demo templates. It shows a list of available forms and number of submissions, likely used as a way of administrating forms/submissions.

<table class="table">
	<thead>
		<tr>
			<th>#</th>
			<th>Form Name</th>
			<th>Description</th>
		{if logged_in_group_id == "1"}
			<th>Submissions</th>
		{/if}
		</tr>
	</thead>
	<tbody>
	{exp:freeform_next:forms}
		<tr>
			<td>{form:id}</td>
			<td>
				<a href="{path='freeform/form/{form:handle}'}">
					{form:name}
				</a>
			</td>
			<td>{form:description}</td>
		{if logged_in_group_id == "1"}
			<td>
				<a href="{path='freeform/form/{form:handle}/submissions'}">
					{form:submission_count} submissions
				</a>
			</td>
		{/if}
		</tr>
	{if form:no_results}
		<tr>
			<th colspan="{if logged_in_group_id=='1'}4{if:else}3{/if}">
				There are currently no forms for this site.
			</th>
		</tr>
	{/if}
	{/exp:freeform_next:forms}
	</tbody>
</table>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39