Legacy Documentation
You are using the documentation for version 3.5.17. Go here for the latest version or check here for your available upgrades to 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/index.php/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.