Go to main content

Older

Contents

Syntax

<txp:older />

The older tag is both a single tag and a container tag. Textpattern will replace this tag with a link to the previous list of articles in the sort order. As a single tag it outputs the URL for the previous list page. If used as a container, it will wrap the text or tag assigned to the link

An article list consists of the assigned number of articles set by the article tag. If there are no articles available having ‘Older’ status (articles ranked lower, or earlier, in the present sort criteria than the article shown at the bottom of the present list) <txp:older /> will not display unless the showalways attribute is set. It is normally used in tandem with newer or pages.

Given a <txp:article limit="5" /> tag on the page in question, <txp:older /> will page down five articles at a time from the most recent post back in time to the oldest.

Note: This tag is context-sensitive, meaning it will only fetch content from the section or category being viewed.

Attributes

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

rel="text" v4.7.0+
HTML rel attribute to be applied to link.
Default: unset.
showalways="boolean"
Show wrapped value even when no older page exists.
Values: 0 (no) or 1 (yes).
Default: 0.
title="text"
HTML title attribute to be applied to link.
Default: unset.

Examples

<txp:older rel="next">Older</txp:older>

or, to render the text in the current site language:

<txp:older rel="next"><txp:text item="older" /></txp:older>
<a href="<txp:older />">
    <txp:image name="left-arrow.gif" />
</a>

Other tags used: image.

<txp:older>
    <txp:image name="left-arrow.gif" />
</txp:older>

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

Other tags used: image.

Genealogy

Version 4.7.0

rel attribute added.

Version 4.3.0

escape attribute added.

If you notice any kind of problem with this page’s construction or content (outdated information, typos, broken links, or whatever), open an issue to have it sorted. Or have a go at it yourself. :)