link to prev
From Textpattern CMS User Documentation
<txp:link_to_prev>
The link_to_prev tag can be used as a single tag or a container tag to return the permanent URL of the previous article by posting date.
If used as a container tag, the HTML required to output a hyperlink is returned; if used as a single tag, only the URL itself is returned.
Contents |
Attributes
Tag will accept the following attributes (case-sensitive):
- showalways="boolean"
- Show the wrapped value even when no previous article exists.
- Values:
0(no) or1(yes). - Default:
0
Examples
Example 1: Link to previous article using its title
<txp:link_to_prev><txp:prev_title /></txp:link_to_prev>
Other tags used: prev_title
Example 2: Link to previous article using static text
<txp:link_to_prev showalways="1">Previous</txp:link_to_prev>
Note: while
showalways will enable this tag to display what is wrapped inside it, prev_title returns nothing if there is no previous title, so nothing is displayed. Use text or the returned value that you need displayed.Example 3: Customizing links
The container tag returns only a very basic link, which doesn't allow for customizing the link title, or adding a CSS class, etc. Using the tag in its single tag capacity opens up a lot more possibilities.
For example, to give the link an HTML title attribute of the previous article's title, and also apply a class to it:
<a href="<txp:link_to_prev />" title="<txp:prev_title />" class="orange"><txp:prev_title /></a>
Other tags used: prev_title
