Tag 2.1 Entries

You can pass tags through the url or through the 'tag' parameter. This function will show entries that use the tags you provide. You can pass multiple tags by separating them with commas. If you like, you can show only entries that have all of the tags indicated by passing 'yes' to the 'inclusive' parameter.

Parameters
Variables
Variable Pairs
Conditionals
Examples

Parameters

A variety of parameters are used to control the behavior of the entries tag. This tag accepts most of the parameters used to control the weblog:entries tag in addition to a few more.

{exp:tag:entries weblog="some_weblog" inclusive="yes" orderby="entry_date" sort="asc" limit="20"} content {/exp:tag:entries}

category
inclusive
marker
paginate
tag
websafe_separator

category=

category="not 1|3"

You can filter tags in your Tag Entries by those that belong to entries of a specific category by supplying a category number. Seperate multiples with pipe character. You can also use 'not'.

inclusive =

inclusive ="yes"

You can pull entries by multiple tags when tags are separated by commas. If you set the 'inclusive' parameter to yes only entries that contain all of the tags will be shown. The default is to show entries that have any of the referenced tags.

marker=

marker="taggage"

The 'marker' parameter tells the Tag module what marker to look for in your url to determine for which tag to show entries. If you don't provide this parameter, the module will parse the url on the marker 'tag'. Like this: http://www.solspace.com/template_group/template/tag/chocolatey/

paginate=

paginate="bottom"

This parameter determines where the pagination code will appear for your Tag Related Entries. If no parameter is specified, the navigation block will default to the "bottom" behaviour. top: The navigation text and links will appear above your list of entries. bottom: The navigation text and links will appear below your list of entries. both: The navigation text and links will appear both above and below your list of entries.

tag=

tag="my tag"

The 'tag' parameter tells the Tag module by which tag to pull entries. Normally the tag will be supplied in the url of the page, but this parameter allows you to hard code it. You can call multiple tags by joining them with the pipe character. You can negate a list of tags by preceeding them with 'not' as in tag="not this_tag|or_this_one".

websafe_separator=

websafe_separator="+"

The 'websafe_separator' parameter allows you to control the websafe separator character for multi-word tags generated by the {websafe_tag}. Allowable characters are '+', '-', and '_'. The default is '+'. This is critical to match the websafe separator character being used in the URL. For example, if you're linking to your Tag:Entries page with '-' as your websafe separator, and your websafe separator parameter is '+', those entries will NOT show.

Variables

All of the variables available in the weblog:entries tag are available here.

Variable Pairs

All of the variable pairs available in the weblog:entries tag are available here.

Conditionals

All of the conditionals available in the weblog:entries tag are available here.

Examples

The below example will pull the Tag Name from the URL and “clean it up”, and will display the Title and Body of all weblog entries associated with the specified Tag. The websafe seperator is set to “_” which will detect Websafe Tags in the URL in that format (ex: “tag_name"). This example will also show 20 entries per page, and paginate the rest at the bottom.

<h1>{exp:tag:tag_name}</h1>


 


{exp:tag:entries inclusive="yes" orderby="entry_date" sort="asc" limit="20" paginate="bottom" websafe_separator="_"}


 


<p>{title}</p>


<p>{body}</p>


 


<br /><br />


 


{paginate}


<p>{pagination_links}</p>


{/paginate}


 


{/exp:tag:entries}