Elegant solutions, lasting results

Recommendations

Calendar

Create full-featured calendars, including advanced recurrence and exception rules for events. Import & export events with ICS.


More Info Add to Cart


.

Tag

Tag your content with keywords and intuitively display relationships between entries.


More Info Add to Cart


.

My Cart

Documentation

Calendar: Month List

The Calendar:Month_List loop outputs an archive list of months for the purpose of generating simple lists to link to Month calendars.

{exp:calendar:month_list} content {/exp:calendar:month_list} 

Parameters

The following parameters are available for use:

date_range_start=

date_range_start="2009-06-01" 

Limits output to months 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="2010-06-last" 

Limits output to months on or before this date. Both standard and easy-to-use text date formatting apply to this parameter.

limit=

limit="18" 

This parameter allows you to limit the amount of month results to be displayed in the list. Default is 12.

Variables

The following variables are available for use:

month

{month format="%F, %Y"} 

Displays the given month, formatted using EE-style format characters. If format="" is not specified, it will parse as MM (ex: 03).

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

The following conditionals are available for use:

if is_current_month

{if is_current_month}Current Month{/if} 

If the month in the list of results is the current month, this conditional will display it's contents.

if is_not_current_month

{if is_not_current_month}NOT Current Month{/if} 

If the month in the list of results is NOT the current month, this conditional will display it's contents.

if is_current_year

{if is_current_year}Current Year{/if} 

If the month in the list of results is the current year, this conditional will display it's contents.

if is_not_current_year

{if is_not_current_year}NOT Current Year{/if} 

If the month in the list of results is NOT the current year, this conditional will display it's contents.

Examples

The following code will display a list of months during the period of January, 2009 - December, 2012:

<ul>
    {exp:calendar:month_list
        date_range_start="2009-01-01"
        date_range_end="2012-12-last"
        limit="100"
    }
        <li>
            <a href="{path='calendar/month'}/{month format="%Y/%m"}/">
                {month format="%F, %Y"}
            </a>
        </li>
    {/exp:calendar:month_list}
</ul>