This document is for an older version of
Freeform
.
View latest version →
Freeform for ExpressionEngine 1.x Retired
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
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
2
3
4
5
6
7
8
9
10
11
12
13
14
15
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
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