Legacy Documentation
You are using the documentation for version 4.3.8. Go here for the latest version.
Archive Month Links Tag¶
Introduction¶
The Archive Month Links tag displays a list of links for any months that contain Channel Entries. The links will point to your monthly archive page.
{exp:channel:month_links channel="news" limit="50"}
{month}, {year}<br>
{/exp:channel:month_links}
The links created by the tag look like this:
- October, 2011
- September, 2011
- August, 2011
- July, 2011
- June, 2011
Parameters¶
sort=¶
sort="asc" ``sort="desc"``
The sort order can be ascending or descending. The order will default to “descending” if nothing is specified.
show_expired=¶
show_expired="yes"
You can determine whether you wish for entries that have “expired” to be included.
show_future_entries=¶
show_future_entries="yes"
You can determine whether you wish for entries dated in the “future” to be included. This option is useful when doing things like creating a list of events, some of which have not occurred yet.
status=¶
status="open"
You may restrict to entries with a particular status. The two statuses “open” and “closed” are default statuses that are always available, so you can always specify those if needed. You can choose multiple statuses using a pipe:
status="draft|reviewed|published"
Or exclude statuses using “not”
status="not submitted|processing|closed"
Variables¶
path¶
{path='channel/archives'}
The URL to the specified template. The month/year part of the link will be added automatically.
For example, this
<a href="{path='channel/archives'}">{month}, {year}</a>
Will be rendered like this
<a href="example.com/channel/archives/2003/12/">December, 2003</a>
Note
The path setting can optionally be enclosed in quotes
{path='template_group/template_name'}
Variable Pairs¶
year_heading¶
{year_heading}
<p>{year}</p>
{/year_heading}
The year heading can be used to show information once for each year.