This document is for an older version of
Calendar
.
View latest version →
Calendar:Year_List template tag
The Calendar:Year_List loop outputs an archive list of years for the purpose of generating simple lists to link to Year calendars.
{exp:calendar:year_list} content {/exp:calendar:year_list}
Parameters
date_range_start=
date_range_start="2009-01-01"
Limits output to years on or after this date. Both standard and easy-to-use text date formatting apply to this parameter. Default value is year-01-01
.
date_range_end=
date_range_end="2012-12-last"
Limits output to years on or before this date. Both standard and easy-to-use text date formatting apply to this parameter.
limit=
limit="5"
This parameter allows you to limit the amount of year results to be displayed in the list. Default is 100
.
Variables
year
{year format="%Y"}
Displays the given year, formatted using EE-style format characters. If format=""
is not specified, it will parse as YYYY
(ex: 2009
).
Conditionals
is_current_year
{if is_current_year}Current Year{/if}
If the year in the list of results is the current year, this conditional will display its contents.
is_not_current_year
{if is_not_current_year}NOT Current Year{/if}
If the year in the list of results is NOT the current year, this conditional will display its contents.
Examples
The following code will display a list of years during the period of 2009 - 2012:
<ul>
{exp:calendar:year_list
date_range_start="2009-01-01"
date_range_end="2012-12-last"
limit="100"
}
<li>
<a href="{path='calendar/year'}/{year format="%Y"}/">
{year format="%Y"}
</a>
</li>
{/exp:calendar:year_list}
</ul>
2
3
4
5
6
7
8
9
10
11
12
13