Channel Entries Tag¶

author_id=¶

The author_id= parameter will limit the returned entries to the specified Member ID:

author_id="1"

Use the pipe delimiter to specify multiple Member IDs:

author_id="1|2|3"

Modify the parameter value using not to exclude Member IDs:

author_id="not 1|2|3"

Use the CURRENT_USER constant to limit entries to the currently logged-in user:

author_id="CURRENT_USER"

Use the NOT_CURRENT_USER constant to limit entries excluding the currently logged in user:

author_id="NOT_CURRENT_USER"

backspace=¶

The backspace= parameter will remove characters, including spaces and line breaks, from the last iteration of the tag pair:

backspace="7"

For example, if you use a <br /> element after each entry, Channel Entries will output this markup:

Entry 1<br />
Entry 2<br />
Entry 3<br />

However, you may not want the <br /> element after the last entry. Count the number of characters, including spaces and line breaks and use the result as the value for the parameter. The example <br /> element includes 6 characters and a line break, for a total of 7:

{exp:channel:entries backspace="7"}
        {title}<br />
{/exp:channel:entries}

Using backspace=, Channel Entries will output this markup:

Entry 1<br />
Entry 2<br />
Entry 3

cache=, refresh=¶

cache="yes" refresh="60"

This parameter enables tag caching. Refresh is the number of minutes between cache refreshes.

cat_limit=¶

cat_limit="30"

This parameter lets you set a different limit for the category display than the regular display. For example, let’s say you normally only want 10 entries on your main channel page, but you want 100 entries shown when viewing a specific category. For that, you could do this:

{exp:channel:entries limit="10" cat_limit="100"}

category=¶

category="2"

Categories are specified by ID number (the ID number of each category is displayed in the Control Panel). The reason we use the ID is because categories can be called anything (with spaces, quotes, etc.), and also renamed. It would be much more difficult to have to update the tag parameters every time you updated a category name. Further, you can have multiple categories with the same name either in different Category Groups or in different parts of the hierarchy within the same Category Group.

And as with some of the other parameters, you can stack categories to get entries with any of those categories

category="2|45|4|9"

Or use “not” to exclude categories

category="not 4|5|7"

And, you can use an inclusive stack to only get entries with all of the categories

category="3&7&8"

Or you can negate the inclusive stack and get entries that do not of all of those categories

category="not 3&5"

category_group=¶

category_group="2"

Category Groups are specified by ID number (the ID number of each category group is displayed in the Control Panel). The reason we use the ID is because category groups can be called anything (with spaces, quotes, etc.), and also renamed. It would be much more difficult to have to update the tag parameters every time you updated a category name.

And as with some of the other parameters, you can stack category groups

category_group="1|2|4"

Or use “not” to exclude categories

category_group="not 2"

channel=¶

channel="news"

From which channel to show the entries (will show all channels if no channel is specified). Additionally, you can use the pipe character to separate multiple channels:

channel="channel1|channel2|channel3"

Or you can add the word “not” (with a space after it) to exclude channels:

channel="not channel1|channel2|channel3"

You must specify this parameter if you use the category name in URL feature.

disable=¶

disable="categories"

The disable= parameter allows you to turn off aspects of the tag that you might not be using in order to improve performance. The channel tag is designed to fetch a lot of information by default: Categories, channel fields, member data, etc. Depending on how you use the tag, some of this data may not be needed. Through the use of the “disable” parameter you can turn off aspects of the tag in order to make it more lightweight.

The syntax for the disable parameter is this: disable="ITEM YOU WANT TO DISABLE". The following items can be turned off:

• categories
• category_fields
• custom_fields
• member_data
• pagination

You may specify multiple items to disable by separating them with the pipe character:

disable="categories|member_data"

The best approach is to examine the data you are showing in each instance of the tag. If there is a type of data you are not utilizing, turn it off.

For example, let’s say you are using an instance of your channel tag to show your 10 most recent entry titles:

{exp:channel:entries orderby="date" sort="desc" limit="10"}
        <a href="{title_permalink='channel/comments'}">{title}</a><br>
{/exp:channel:entries}

In this example you are only showing the title of your entries and nothing else; yet, the channel tag automatically fetches categories and other data. Using the disable= parameter you can turn off the unneeded features from being queried. In this case, you don’t need any of the features that can be disabled.

{exp:channel:entries orderby="date" sort="desc" limit="10" disable="categories|custom_fields|member_data|pagination"}
        <a href="{title_permalink='channel/comments'}">{title}</a><br>
{/exp:channel:entries}

display_by=¶

display_by="month"

There are three optional “display types” that let you limit the display of your entries. If you do not use these parameters the default grouping is by “number”.

These parameters interact with the “limit” parameter to tailor the number of entries per page. For example, if you want to show only the last month that contains entries you’ll do this:

display_by="month" limit="1"

At 12 AM on the first day of the month, based on your server time, the previous month will no longer be visible. If you want to show three months you’ll do this:

display_by="month" limit="3"

If you want to show only one day you’ll do this:

display_by="day" limit="1"

If you want to show 14 days you’ll do this:

display_by="day" limit="14"

These are all optional. If you do not use this parameter your entries will be limited by number. In other words:

limit="20"

Will show 20 entries.

display_by="week"

The display_by="week" parameter allows the displaying of entries by week. To simply show the last week that contains entries, you can use this:

display_by="week" limit="1"

The display_by="week" parameter can be used with other parameters like show_current_week=, start_day= and week_sort= to give more control over how the weeks are displayed and used with pagination.

For example, if you want to display the current week by default but also show entries in future weeks with pagination, you can use this:

display_by="week" limit="1" show_future_entries="yes" show_current_week="yes"

This parameter uses UTC/GMT time and is not localized to the server or logged in user.

dynamic=¶

dynamic="no"

The channel display engine sets some parameters dynamically, based on what is in the URL. There are times, however, where you do not want the parameters affected by what the URL contains. To override the dynamic nature of the channel tag, use dynamic="no".

This is often useful if you want to list entries in a “sidebar” on your site and have them always be the same ones regardless of which page on your site you visit (main page, archives, comments, etc.). By setting dynamic="no" you will ensure that the list is not affected by anything passed in the URL.

dynamic_parameters=¶

dynamic_parameters="orderby|limit|sort"

The Dynamic Parameters feature permits a {exp:channel:entries} tag’s parameters to be set “on the fly” using POST data submitted via a form. A practical use for this is to create some display options in a form on your page that your visitors can use to select their preferred page view.

Every Parameter available to the channel tag can be set dynamically.

dynamic_start=¶

dynamic_start="yes"

This parameter is only used in the tag when used in an RSS/Atom feed. It will not do anything in any other circumstance. The default value is “no”, so you must specify this parameter in order to take advantage of the feature.

When used in an RSS/Atom feed, this parameter allows ExpressionEngine to dynamically provide a starting date for the feed. This is used to allow EE to serve only new content when it is requested by the feed via a RFC3229-compliant request (RFC3229 info).

entry_id=¶

entry_id="147"

You can hard code the channel tag to show a specific channel entry. You may also specify multiple entries by separating them with the pipe character:

entry_id="13|42|147" Or use "not" to exclude entries::

entry_id="not 45|534|807"

entry_id_from=¶

entry_id_from="20"

This parameter is used together with entry_id_to= to designate a range of entries to display. This parameter indicates the beginning of the range. With the example above, the tag would begin displaying entries starting with entry ID 20.

entry_id_to=¶

entry_id_to="40"

This parameter is used together with entry_id_from= to designate a range of entries to display. This parameter indicates the end of the range. With the example above, the tag would stop displaying entries at entry ID 40.

fixed_order=¶

fixed_order="3|7|1"

You can hard code the channel entries tag to show entries in a specific order based on their entry ids. Entries will be displayed in the order specified in the pipe delimited list. In the example above, the three entries with id’s 3, 7, and 1 would be displayed in that order.

If you wish, you can also cause the entries to be displayed in the reverse of the order you specified. To do this, use the sort= param, setting it to ‘desc’:

fixed_order="3|7|1" sort="desc"

In the above example, three entries would be displayed, in the order: 1, 7, and then 3.

group_id=¶

group_id="4"

You can decide from which Member Groups (by specifying the group ID) you wish entries to be shown. If you choose “4”, then only entries created by members of the Member Group with the ID of 4 will be shown. You can choose multiple Member Groups using a pipe:

group_id="2|3|4"

Or exclude groups using “not”

group_id="not 2|3|4"

limit=¶

limit="12"

This parameter limits the number of entries on any given page. The limit will default to 100 entries if a value is not specified. If you are using pagination then this will determine the number of entries shown per page.

month_limit=¶

month_limit="30"

This parameter lets you set a different limit for the month display than the regular display. For example, let’s say you normally only want 10 entries on your main channel page, but you want 100 entries shown when viewing a specific month. For that, you could do this:

{exp:channel:entries limit="10" month_limit="100"}

offset=¶

offset="1"

This parameter offsets the display by X number of entries. For example, if you want to show all entries except the three latest ones, you would do this:

offset="3"

orderby=¶

orderby="date"

The orderby parameter sets the display order of the entries. Setting options for this parameter include:

• orderby="comment_total"
• orderby="date"
• orderby="edit_date"
• orderby="entry_id"
• orderby="expiration_date"
• orderby="most_recent_comment"
• orderby="random"
• orderby="screen_name"
• orderby="status"
• orderby="title"
• orderby="url_title"
• orderby="username"
• orderby="view_count_one"
• orderby="view_count_two"
• orderby="view_count_three"
• orderby="view_count_four"

In addition you can order by a channel field. Use the “short_name” of the field:

orderby="name_of_field"

Multiple Orders and Sorts

The orderby= and sort= parameters can accept multiple values using the pipe character. This allows you to have multiple levels of ordering and then specify the sort rules for those levels.

For example, if you wish to order by screen_name alphabetically and then have the most recent entries first, you would use the following parameters:

orderby="screen_name|date" sort="asc|desc"

Multiple Site Manager and orderby=

The orderby= parameter can accept a site short-name in the namespace.

orderby="default_site:body|second_site:summary"

When ordering by multiple fields from multiple Sites, remember that entries from another site will have no data for that field, and the entries will be ordered as such. This results in ordering entries by Site and then Field(s):

orderby="default_site:body|second_site:summary"

Will result in:

Default Site - Entry One - Albert
Default Site - Entry Two - Bobby
Second Site    - Entry One - Alligator
Second Site    - Entry Two - Buffalo

If you have multiple Sites where each site has a field with the same exact short name, then you can specify that short name (without the site specified) and ExpressionEngine will treat those two fields as the same value and be able to order them as if they were the same field:

orderby="body"

Default Site - Entry One - Albert
Second Site    - Entry One - Alligator
Default Site - Entry Two - Bobby
Second Site    - Entry Two - Buffalo

Thus, the output will then be ordered by the body, regardless of the originating site.

paginate=¶

paginate="top"

This parameter is for use with entry pagination and determines where the pagination code will appear for your channel entries:

1. top: The navigation text and links will appear above your list of entries.
2. bottom: The navigation text and links will appear below your list of entries.
3. both: The navigation text and links will appear both above and below your list of entries.

If no parameter is specified, the navigation block will default to the “bottom” behavior.

paginate_base=¶

paginate_base="site/index"

This tells ExpressionEngine to override the normal pagination link locations and point instead to the explicitly stated template group and template.

paginate_type=¶

paginate_type="field"

This tells ExpressionEngine to function in “pagination” mode for your channel entry fields so that you can automatically have an entry span multiple pages. See the Spanning a Channel Entry Across Multiple Pages page.

related_categories_mode=¶

related_categories_mode="no" related_categories_mode="yes"

When enabled, this parameter alters the behavior of the {exp:channel:entries} tag, causing it to ignore the entry ID or URL title found in the URL, and instead show a list of entries that are in the same category as the entry specified in the URL. This lets you create a list of entries that are “related” to the primary one specified by the URL.

The default limit when enabling related_categories_mode is 10 entries, and can be overridden with the addition of the limit= parameter.

When the related_categories_mode="" parameter is set to “yes”, there are two additional parameters available to the Channel Entries tag: custom_fields="yes" and member_data="yes", which will allow the displaying of field data and member data respectively. By default, those two parameters are both set to “no” to reduce load. Below is a simplified example with both optional parameters enabled:

{exp:channel:entries related_categories_mode="yes" custom_fields="yes" member_data="yes"}
        <h2>{title}</h2>
        {body}
        <div class="posted">Posted by {author} on {entry_date format='%m/%d'} at {entry_date format='%h:%i %A'}</div>
{/exp:channel:entries}

relaxed_categories=¶

relaxed_categories="yes"

This parameter allows you to use the category indicator in your URLs with an entries tag specifying multiple channels that do not share category groups.

require_entry=¶

require_entry="yes"

This parameter tells the channel tag that it should expect the URL to contain a valid entry ID or a valid URL title. If an ID is not found in the URL, the tag will not display any data. Normally, the channel tag will show something, even if the URL doesn’t point to a particular entry. For example, your main channel page will typically show several of your most recent entries. Whereas your “single entry” pages, like your comment page, will show a single entry based on information in the URL. However, if one of your single entry pages is requested, but it doesn’t contain a valid ID, this parameter will tell the tag that you do not wish the template to display anything.

search:field_name=¶

search:body="pickles"

The “search:” parameter allows you to constrain Channel Entries output based on content within your fields. You specify which field to search by using the field’s short name immediately after “search:”. You can search based on whether a field is an exact match to your provided term or whether or not a field simply contains your term.

search:body="=pickles|shoes"

search:body="=not pickles|shoes"

search:body="pickles|shoes"

search:body="not pickles|shoes"

search:body="pickles&&shoes"

search:body="not pickles&&shoes"

search:body="cat\W"

search:numeric_field="<20"

search:numeric_field=">20"

search:numeric_field="<=20"

search:numeric_field=">=20"

search:body="IS_EMPTY"

search:body="not IS_EMPTY"

search:body="=IS_EMPTY|sandwich"

search:body="IS_EMPTY|sandwich"

search:body="not IS_EMPTY|sandwich|salad"

{exp:channel:entries search:style="=ale" search:region="germany|belgium" search:rating="=3|4|5"}

show_current_week=¶

show_current_week="yes"

Requires use of the display_by= “week” parameter. When set to “yes”, it displays the current week by default (i.e. no pagination in the URL) and automatically adjusts the pagination links to indicate the correct page for that week.

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. Note that EE will still display past entries; this parameter simply instructs EE to also include entries from the future.

show_pages=¶

show_pages="only" show_pages="no"

Allows you to tell the Channel module whether to show those entries that have been used to create pages with the Pages module. You can also set it to “only” and only show those entries that have had Pages assigned to them. The default is “yes” and it will treat entries with assigned Pages no different from any other entries.

sort=¶

sort="asc" sort="desc"

The sort order can be ascending or descending. The order will default to “descending” if nothing is specified.

Multiple Orders and Sorts

Along with the orderby= parameter this parameter can accept multiple values using the pipe character so that you can have multiple levels of ordering and set the sort for those levels. For example, if you wish to order by screen_name alphabetically and then have the most recent entries first, you would use the following parameters:

orderby="screen_name|date" sort="asc|desc"

If no sort value or an incorrect value is specified for an order, then the default will be “descending”.

start_day=¶

start_day="Monday"

Requires use of the display_by= “week” parameter. Allows you to choose whether the week starts on Monday or Sunday. Sunday is the default.

start_on=¶

start_on="2004-06-05 20:00"

You can specify a particular date/time on which to start the entries. Only entries that are on or after this date will be included in the display. This parameter is often used together with the stop_before= parameter for limiting the entry display to a specific date range.

start_on="October 21st, 2015 4:30 PM"
start_on="today"
start_on="yesterday"
start_on="last Monday"
start_on="-2 months"

{exp:channel:entries channel="{my_weblog}" sort="desc" start_on="{current_time}" show_future_entries="yes"}

{exp:channel:entries channel="{my_weblog}" limit="5" sort="desc" start_on="-24 hours"}

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. If no status parameter is specified, only open status entries will be returned. You can choose multiple statuses using a pipe:

status="draft|reviewed|published|closed"

Or exclude statuses using “not”

status="not submitted|processing"

Note that closed status entries will not be included in the results when using “not” regardless of whether it is in the piped list.

stop_before=¶

stop_before="2004-06-12 20:00"

You can specify a particular date/time on which to end the entries. Only entries that are before this date will be included in the display (entries exactly on this date/time will not be included). This parameter is often used together with the start_on= parameter for limiting the entry display to a specific date range.

This parameter accepts the same date formats as the start_on= parameter.

sticky=¶

sticky="no"

By default, sticky topics always remain at the top of the page. You can manually turn off stickies by using the above parameter.

track_views=¶

ExpressionEngine lets you track how many times a channel entry has been “viewed” on a particular page. The view tracking counter will ONLY increment on pages that show a single entry using the {exp:channel:entries} tag, and only when the feature is enabled by using this parameter in the tag you want tracked. Up to four different instances of the view counter can be used (each in a different tag on a different page).

To enable the view counter you will use one of these four parameters in the tag located in the page you want tracked.

track_views="one" track_views="two" track_views="three" track_views="four"

Each of the above four parameters corresponds to these variables, which can be shown within any tag:

{view_count_one}{view_count_two}{view_count_three}{view_count_four}

uncategorized_entries=¶

uncategorized_entries="no"

By default, when specifying the category= parameter with ‘not ‘ at the beginning , ExpressionEngine will show all entries without those categories including any entries without categories assigned. If you would prefer that ExpressionEngine not show these uncategorized entries, then set this parameter to “no” and they will be ignored.

url_title=¶

url_title="my_wedding"

This parameter limits the query by an entry’s url_title. You can use the pipe character to query by multiple url_titles:

url_title="my_wedding|my_honeymoon|my_kids"

Or you can add “not” to exclude url_titles:

url_title="not my_in_laws"

username=¶

username="petunia"

This parameter limits the query by username. You can use the pipe character to query by multiple usernames:

username="tom|dick|harry"

Or you can add “not” to exclude usernames

username="not tom|dick|harry|fred"

You can also use the constant "CURRENT_USER" to show entries from only the currently logged in user.

username="CURRENT_USER"

This allow each logged-in user to get only their entries. Users who are not logged in won’t see anything. Alternatively, you can use the constant "NOT_CURRENT_USER" to show entries except from the currently logged in user.

username="NOT_CURRENT_USER"

week_sort=¶

week_sort="asc"

Requires the display_by= “week” parameter. Changes the sort order of the weeks so that you can either have the weeks displayed by most recent first or oldest first. Separate from the sort="" parameter, which will only affect the sorting of entries within the weeks, not the weeks themselves.

year=, month=, day=¶

year="2003"

month="12"

day="23"

You can limit queries by year, month, or day. For example, to show all of year 2002 you’ll use only:

year="2002"

To show only the month of December in 2003 you’ll do this

year="2003"

month="12"

absolute_count¶

{absolute_count}

The absolute “count” out of the current entries being displayed by the tag, including those entries on previous pages (if using pagination).

If five entries are being displayed per page, then for the fourth entry on the second page the {absolute_count} variable would have a value of “9”

BONUS: Since the Search module utilizes channel variables, {absolute_count} is also available to the Search Results tag.

absolute_results¶

{absolute_results}

This variable will always display the absolute total number of results that are returned by the tag, regardless of pagination.

aol_im¶

{aol_im}

The author’s AOL IM account name.

author¶

{author}

The author’s screen name, if it exists; otherwise, this variable will display the username.

author_id¶

{author_id}

The member ID of the author.

avatar_image_height¶

{avatar_image_height}

The height of the avatar image associated with the entry’s author. Typically used as such:

{if avatar}
        <img src="{avatar_url}" width="{avatar_image_width}" height="{avatar_image_height}" alt="{author}'s avatar">
{/if}

avatar_image_width¶

{avatar_image_width}

The width of the avatar image associated with the entry’s author. Typically used as such:

{if avatar}
        <img src="{avatar_url}" width="{avatar_image_width}" height="{avatar_image_height}" alt="{author}'s avatar">
{/if}

avatar_url¶

{avatar_url}

The URL to the avatar image associated with the entry’s author. Typically used as such:

{if avatar}
        <img src="{avatar_url}" width="{avatar_image_width}" height="{avatar_image_height}" alt="{author}'s avatar">
{/if}

bio¶

{bio}

The author’s bio as entered in their profile.

channel¶

{channel}

The name of the channel that the currently displayed entry is assigned to.

channel_id¶

{channel_id}

The ID number of the actual channel (not the entry.)

channel_short_name¶

{channel_short_name}

The short name of the channel of the currently displayed entry.

comment_auto_path¶

{comment_auto_path}

This variable is replaced by the URL set in the Comment Page URL preference under Admin ‣ Channel Management. No entry id, URL Title, or other information is included; this is the exact URL from the preference.

comment_entry_id_auto_path¶

{comment_entry_id_auto_path}

This variable is replaced by the URL set in the Comment Page URL preference under Admin ‣ Channel Management. The ID number of the entry will be automatically added. For example, this:

<a href="{comment_entry_id_auto_path}">my entry</a>

Would be rendered like this:

<a href="http://example.com/index.php/channel/comments/234">my entry</a>

comment_subscriber_total¶

{comment_subscriber_total}

Total number of subscribers to comments for a particular entry.

comment_total¶

{comment_total}

The total number of comments for a particular entry.

comment_url_title_auto_path¶

{comment_url_title_auto_path}

This variable is replaced by the URL set in the Comment Page URL preference under Admin ‣ Channel Management. The URL Title of the entry will be automatically added. For example, this:

<a href="{comment_url_title_auto_path}">my entry</a>

Would be rendered like this:

<a href="http://example.com/index.php/channel/comments/ice_cream/">my entry</a>

count¶

{count}

The “count” out of the current entries being displayed. If five entries are being displayed, then for the fourth entry the {count} variable would have a value of “4”.

cp_edit_entry_url¶

{if logged_in}
  <a href="{cp_edit_entry_url}">Edit Entry</a>
{/if}

The URL of the entry form in the control panel where this entry can be edited. It is recommended you wrap this variable in an {if logged_in} conditional to hide your control panel’s URL from regular site visitors. If you are running a membership based site, hide it behind an appropriate logged_in_group_id conditional. For example, to hide this link from everyone but Super Admins:

{if logged_in_group_id == 1}
  <a href="{cp_edit_entry_url}">Edit Entry</a>
{/if}

edit_date¶

{edit_date format="%Y %m %d"}

The date on which the entry was last edited. See Date Variable Formatting for more information.

email¶

{email}

The author’s raw email address.

entry_date¶

{entry_date format="%Y %m %d"}

The date the entry was submitted. See Date Variable Formatting for more information.

entry_id¶

{entry_id}

The ID number of the channel entry.

entry_id_path¶

{entry_id_path='channel/archives'}

The URL to the specified template. The ID number of the entry will be automatically added. For example, this:

<a href="{entry_id_path='channel/archives'}">my entry</a>

Would be rendered like this:

<a href="http://example.com/index.php/channel/archives/234/">my entry</a>

entry_site_id¶

{entry_site_id}

The Site ID of the channel entry.

expiration_date¶

{expiration_date format="%Y %m %d"}

The expiration date of the entry. See Date Variable Formatting for more information.

forum_topic_id¶

{forum_topic_id}

If you have the Discussion Forum Module installed and if you have associated a forum thread with a channel entry (via the “Forum” section of the Publish tab), this is the ID number of the forum thread. It will typically be used like so:

{if forum_topic}
        <a href="{path='forums/viewthread'}{forum_topic_id}">Discuss this in our forums</a>
{/if}

gmt_entry_date¶

{gmt_entry_date format="%Y %m %d"}

The date the entry was submitted in GMT. This variable is not localized for each user’s date settings. See Date Variable Formatting for more information.

gmt_edit_date¶

{gmt_edit_date format="%Y %m %d"}

The date on which the entry was last edited in GMT. This variable is not localized for each user’s date settings. See Date Variable Formatting for more information.

icq¶

{icq}

The author’s ICQ IM user identification number.

interests¶

{interests}

The author’s “interests” as entered in their profile.

ip_address¶

{ip_address}

The IP address of the author when they posted the entry.

location¶

{location}

The author’s location as entered in their profile.

member_search_path¶

{member_search_path='search/results'}

This variable is replaced by a URL that passes the author’s member name to your search results Template. In this way, you can display all entries made by the author. You should specify the Template_Group/Template that you use to display search results. For example:

<a href="{member_search_path='search/results'}">View entries by this member</a>

msn_im¶

{msn_im}

The author’s MSN IM account name.

occupation¶

{occupation}

The author’s occupation as entered in their profile.

page_uri¶

{page_uri}

If you have the Pages Module installed and if you have associated a static page with a channel entry (via the “Pages” section of the Publish tab), this is the page uri for the page. It will typically be used like so:

{if page_uri != ''} <a href="{page_uri}">View this page</a> {/if}

page_url¶

{page_url}

If you have the Pages Module installed and if you have associated a static page with a channel entry (via the “Pages” section of the Publish tab), this is the page url for the page (the site URL + the page URI). It will typically be used like so:

{if page_url != ''} <a href="{page_url}">View this page</a> {/if}

permalink¶

{permalink}

This variable defaults to site index with entry ID number:

http://example.com/index.php/235/

In addition, you can specify a template group/template and the entry ID will automatically be added:

{permalink="channel/archives"}

Will render as:

http://example.com/index.php/channel/archives/235/

photo_url¶

{photo_url}

This variable supplies the URL to the member photo (if you have that option enabled and the member has uploaded their photo). It is intended for use in an image tag.

photo_image_height¶

{photo_image_height}

This variable supplies the height of the member photo. It is intended for use in an image tag.

photo_image_width¶

{photo_image_width}

This variable supplies the width of the member photo. It is intended for use in an image tag.

profile_path¶

{profile_path='member'}

The URL to the author of the current entry. The ID number of the author will be automatically added. Used in a link:

<a href="{profile_path='member'}">{author}</a>

recent_comment_date¶

{recent_comment_date format="%Y %m %d"}

The date of the most recent comment associated with the entry. See Date Variable Formatting for more information.

relative_url¶

{relative_url}

The URL stored in your Channel URL setting under Channel Management, with the domain information removed. For example, if your setting is http://example.com/index.php/site/index/ the variable will output /index.php/site/index/. Typically only used in the Atom feed Template.

relative_date¶

{relative_date}

The amount of time that has passed between when the entry was submitted and the current time. The output is displayed in the format 1 day, 3 hours, 45 minutes. This variable is useful for displaying something such as “This entry was posted 1 day, 3 hours, 45 minutes ago.”

screen_name¶

{screen_name}

The author’s screen name, if it exists. This variable will not return anything if the author does not have a screen name defined.

signature¶

{signature}

The signature associated with the entry’s author. Typically used as such:

{if signature} <p>{signature}</p> {/if}

signature_image_height¶

{signature_image_height}

The height of the signature image associated with the entry’s author. Typically used as such:

{if signature_image}
        <img src="{signature_image_url}" width="{signature_image_width}" height="{signature_image_height}" alt="{author}'s signature">
{/if}

signature_image_url¶

{signature_image_url}

The URL to the signature image associated with the entry’s author. Typically used as such:

{if signature_image}
        <img src="{signature_image_url}" width="{signature_image_width}" height="{signature_image_height}" alt="{author}'s signature">
{/if}

signature_image_width¶

{signature_image_width}

The width of the signature image associated with the entry’s author. Typically used as such:

{if signature_image}
        <img src="{signature_image_url}" width="{signature_image_width}" height="{signature_image_height}" alt="{author}'s signature">
{/if}

status¶

{status}

The status of the entry (open, closed, etc.)

switch=¶

{switch='option_one|option_two|option_three'}

This variable permits you to rotate through any number of values as the entries are displayed. The first entry will use “option_one”, the second will use “option_two”, the third “option_three”, the fourth “option_one”, and so on.

The most straightforward use for this would be to alternate colors. It could be used like so:

{exp:channel:entries channel="yourchannel"}
        <div class="{switch='one|two'}">
                <h2>{title}</h2>
                {body}
        </div>
{/exp:channel:entries}

The entries would then alternate between <div class="one"> and <div class="two">.

Multiple instances of the {switch=} tag may be used and the system will intelligently keep track of each one.

title¶

{title}

The title of the entry

title_permalink¶

{title_permalink}

This variable uses the “url title” as the link. It defaults to the site index with the “url title”:

http://example.com/index.php/my_ugly_boyfriend/

In addition, you can specify a specific template group/template and the “url title” will automatically be added:

{title_permalink="channel/archives"}

Will render as:

http://example.com/index.php/channel/archives/my_ugly_boyfriend/

total_results¶

{total_results}

The total number of entries being displayed.

trimmed_url¶

{trimmed_url}

The domain name for your site, trimmed of any subdomains. For instance, example.com becomes example.com. Typically only used in the Atom feed Template.

url¶

{url}

The author’s raw URL, if it exists.

url_or_email¶

{url_or_email}

The author’s URL if it exists, otherwise the raw email address.

url_or_email_as_author¶

{url_or_email_as_author}

A hyperlink to the author’s URL if it exists, otherwise it will be an email link for the author’s email address. The text of the link will be the author’s screenname if it exists, otherwise it will be the username.

url_or_email_as_link¶

{url_or_email_as_link}

This is similar to the above variable. The difference is that the text for the link will be either the URL or the email address.

url_title¶

{url_title}

The human readable title used in the URL as a permalink.

url_title_path¶

{url_title_path='channel/archives'}

The URL to the specified template. The “url title” of the entry will be automatically added. For example, this:

<a href="{url_title_path='channel/archives'}">permalink</a>

Would be rendered like this:

<a href="http://example.com/index.php/channel/archives/ice_cream/">permalink</a>

username¶

{username}

The author’s username.

week_date¶

{week_date format="%Y %m %d"}

The date that the week of the currently displayed entry started on, most commonly used in “weekly” scenarios with the date_heading variable pair.

This variable is affected by the start_day= parameter. By default, the week date will fall on Sunday for the week of the entry. When start_day="Monday" is used, the week date will fall on Monday for the week of the entry. See Date Variable Formatting for more information.

yahoo_im¶

{yahoo_im}

The author’s Yahoo IM account name.

if allow_comments¶

{if allow_comments} content {/if}

This special conditional lets you conditionally display content if the current entry is set to allow comments. This conditional will return FALSE if commenting has expired.

{if allow_comments}
        ({comment_total}) <a href="{comment_path='channel/comments'}">Comments</a>
{/if}

Or you can display content if commenting is disabled:

{if allow_comments == FALSE} content {/if}

if avatar¶

{if avatar} content {/if}

This special conditional lets you conditionally display content if the current entry’s author has an avatar image specified.

{if avatar}
        <img src="{avatar_url}" width="{avatar_image_width}" height="{avatar_image_height}" alt="{author}'s avatar">
{/if}

if category_request¶

{if category_request} content {/if}

This special conditional lets you conditionally display content if the current tag is being displayed based on a category specified in the URL. For instance, if the URL being viewed were http://example.com/index.php/channel/archives/C13/ that could trigger this conditional.

if count¶

{if count > 5} content {/if}

This conditional allows you to test against which number entry is being displayed. You could use this to apply different styles to the first entry or have the last 5 entries out of 10 be formatted differently.

if forum_topic¶

{if forum_topic} content {/if}

You may use this conditional for displaying content when a forum topic has been associated with a channel entry. That option is only available if the Discussion Forum Module is installed. It will typically be used like so:

{if forum_topic}
        <a href="{path='forums/viewthread'}/{forum_topic_id}">Discuss this in our forums</a>
{/if}

if no_results¶

{if no_results} content {/if}

You may use this conditional for displaying a message in the case when no entries are returned. The contents inside of the conditional will be displayed in cases where there are no results returned for the tag.

{if no_results}  <p>There are no entries available.</p>  {/if}

Further, you may specify that another Template be shown in a case when there are no results. In order to do that, you must use the redirect= variable

{if no_results} {redirect="channel/noresult"} {/if}

Lastly, if you want to simply display your 404 page (with 404 headers) when no entries are returned, simply use “404” as the template name.

{if no_results} {redirect="404"} {/if}

if not_category_request¶

{if not_category_request} content {/if}

This special conditional lets you conditionally display content if the current tag is not being displayed based on a category specified in the URL. For instance, if the URL being viewed were http://example.com/index.php/channel/archives/C13/ that would not trigger this conditional.

if not_forum_topic¶

{if not_forum_topic} content {/if}

You may use this conditional for displaying content when no forum topic has been associated with a channel entry. That option is only available if the Discussion Forum Module is installed. It will typically be used like so:

{if not_forum_topic} There is no forum discussion available. {/if}

if photo¶

{if photo} content {/if}

This special conditional lets you conditionally display content if the current entry’s author has a photo image specified.

{if photo}
        <img src="{photo_url}" width="{photo_image_width}" height="{photo_image_height}" alt="{author}'s photo">
{/if}

if signature_image¶

{if signature_image} content {/if}

This special conditional lets you conditionally display content if the current entry’s author has a signature image specified.

{if signature_image}
        <img src="{signature_image_url}" width="{signature_image_width}" height="{signature_image_height}" alt="{author}'s signature">
{/if}

if sticky¶

{if sticky == 'y'} content {/if}

You may test whether an entry is set to be “sticky”. You may also test whether it is not “sticky”.

{if sticky == 'n'} content {/if}

date_footer¶

{date_footer display="daily"}  <p>That's all from today!</p>  {/date_footer}

The date footer can be used to show a footer at certain intervals. The interval can be set to show hourly, daily, weekly, monthly, or yearly. An optional “display” parameter can be used to set the display interval:

{date_footer display="daily"}

Choices for the “display” parameter are:

• {date_footer display="hourly"}
• {date_footer display="daily"}
• {date_footer display="weekly"}
• {date_footer display="monthly"}
• {date_footer display="yearly"}

If no parameter is specified it will default to “daily”.

date_heading¶

{date_heading}  <h1>{entry_date format="%Y %m %d"}</h1>  {/date_heading}

The date heading can be used to show a heading at certain intervals. The interval can be set to show hourly, daily, weekly, monthly, or yearly.

When using weekly intervals, the week_date variable would typically be used.

{date_heading display="weekly"}Week of {week_date format="%Y %m %d"}{/date_heading}

An optional “display” parameter can be used to set the display interval:

{date_heading display="daily"}

Choices for the “display” parameter are:

• {date_heading display="hourly"}
• {date_heading display="daily"}
• {date_heading display="weekly"}
• {date_heading display="monthly"}
• {date_heading display="yearly"}

If no parameter is specified it will default to “daily”.

categories¶

Categories are unique in that they are a “looping pair”. Since you can have multiple categories per entry, we need a mechanism to show as many categories as exist for each entry.

{categories}
        {category_image}
        <a href="{path='channel/index'}">{category_name}</a>
{/categories}

{categories backspace="5"}

Local News<br>
Health News<br>
Science News<br>

{categories backspace="5"}
        {category_name}<br>
{/categories}

Local News<br>
Health News<br>
Science News

{categories limit="1"}

{categories show="4|7"}

{categories show="not 3|6|8"}

{categories show_group="1|3"}

{categories show_group="not 2|4"}

{if active} This category is active {/if}

{category_description}

{category_group}

{category_id}

{parent_id}

{category_image}

{category_name}

{category_url_title}

{path='channel/index'}

{categories}  <a href="{path='SITE_INDEX'}">{category_name}</a>  {/categories}

{class} {extended_description} {category_name_fr} etc..