Textpattern CMS is free, and so are you to help document it.

• Textpattern
• Plugins
• Themes
• Docs
• Forum
• Blog

Documentation

From Textpattern CMS User Documentation

<txp:newer>

The newer tag is both a single tag and a container tag. Should be used in a page after an article tag.

Textpattern will replace this tag with a link to the next list of articles in the sort order. The container tags wrap the text or tag assigned to the link. As a single tag it outputs the URL for the next list page.

An article list consists of the assigned number of articles set by the article tag. If there are no articles available having Newer status (articles ranked higher, or newer, in the present sort criteria than the present top of page article) <txp:newer> will not display unless the showalways attribute is set to 1. It is normally seen used in tandem with older.

Given a <txp:article limit="5" /> tag on the page in question, <txp:newer> will page up five articles at a time from the oldest post forward in time to the most recently posted article.

Attributes

Tag will accept the following attributes (case-sensitive):

escape="html"

Escape HTML entities such as <, > and &.

Values: html or unset.

Default: html

showalways="boolean"

Show wrapped value even when no newer page exists.

Values: 0 (no) or 1 (yes).

Default: 0

title="text"

HTML title attribute.

Default: unset.

Examples

Example 1: Container tag: link with text

<txp:newer>Newer</txp:newer>

Example 2: Single tag: link with image

<a href="<txp:newer />"><txp:image name="right-arrow.gif" /></a>

Example 3: Container tag: link with image

<txp:newer><txp:image name="right-arrow.gif" /></txp:newer>

The difference between examples 2 and 3 is that the tags in example 2 will display the image even if there are no newer articles, those used in example 3 won't.

Other tags used: image

Genealogy

Version 4.3.0

• title attribute reintroduced after being accidentally removed
• Added escape attribute