Weblog Entry Linking

The Next and Previous entry links allow you to automatically generate links to the next or previous entry. They are often used when displaying a single entry to provide navigation to other entries.

These tags work as tag pairs so that they will conditionally show the content between the pair if their is a next (or previous) entry.

{exp:weblog:next_entry}

<p>Next entry: <a href="{path="weblog/comments"}">{title}</a></p>

{/exp:weblog:next_entry}
{exp:weblog:prev_entry}

<p>Previous entry: <a href="{path="weblog/comments"}">{title}</a></p>

{/exp:weblog:prev_entry}

These tags must go on a page designed to show a single entry, such as a comments page.

Note: If you are viewing the most recent entry in your weblog, then the "next_entry" tag's contents will not be shown (since there is no "next entry"). Likewise, when you are viewing the oldest/first entry in the weblog the "previous_entry" content will not be shown.

The contents of these tags will only appear in a Template if you are viewing a "single-entry" type page (comments, permalink, etc.). The tag contents will not appear for viewers in other cases.

Parameters

status=

status="open"

The weblog status to which you would like to restrict display. You can choose multiple statuses using a pipe:

status="draft|reviewed|published"

Or exclude statuses using "not"

status="not submitted|processing|closed"

weblog=

weblog="news"

You can restrict the cycle to a specific weblog. You may also specify multiple weblogs by using the pipe character:

weblog="weblog1|weblog2|weblog3"

Or you can exclude weblogs by including the word "not" followed by a space:

weblog="not weblog4|weblog5"

Variables

path=

{path=template_group/template}

The path (template_group/template) where you want to show the entry. This is typically used within a standard HTML link tag:

<a href="{path=weblog/index}">{title}</a>

You can also use SITE_INDEX in your path to point to your main site index page. If you show your blog on your home page, using SITE_INDEX is preferable since it will make the URL cleaner.

<a href="{path=SITE_INDEX}">{title}</a>

title

{title}

This variable simply displays the title of the entry.