Archive Month Links Tag¶

Introduction
Parameters
Variables
Variable Pairs

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

channel=¶

channel="news"

The name of the channel you want to limit the query to.

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 ¶

month
month_num
month_short
path
year
year_short

month ¶

{month}

Month, long format: September

month_num ¶

{month_num}

Month, numeric: 09

month_short ¶

{month_short}

Month, short format: Sep

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'}

year ¶

{year}

Year, long format: 2003

year_short ¶

{year_short}

Year, short format: 03

Variable Pairs ¶

year_heading¶

{year_heading}
    <p>{year}</p>
{/year_heading}

The year heading can be used to show information once for each year.

[ Permalink ] Posted by: Versa Studio on 28 September 2011 11:39pm
	If you’re using Multi-Site Manager (MSM) and want to refer to entries from a different site than the one your template belongs to, you’ll need to add the site parameter, i.e.,: `site="my_site_name"`
[ Permalink ] Posted by: tunnel7 on 18 May 2011 2:29pm
	Worth noting is that on the archive template page you can use the date_heading tag to display the archive month / year at the top of the page: `{exp:channel:entries channel="channelname"} {date_heading display="monthly"} <h1>Posts from {entry_date format="%F %Y"}</h1> {/date_heading} {/exp:channel:entries}` More details on the date_heading variable pair can be found in documentation here: http://expressionengine.com/user_guide/modules/channel/variable_pairs.html