How to link to previous/next entries in a section?

Question

What would be the equivalent in Craft of ExpressionEngine's Next/Previous entry linking? I was looking at getNext() and getPrev() (and their aliases next and prev) (via the EntryModel docs), but when I try the obvious:

<a href="{{ entry.prev.url }}">Previously: {{ entry.prev.title }}</a>

I just get the current entry's data.

What piece am I missing here?

Answer 1

You are probably not using this within a craft.entries loop. Position it inside a loop or set custom parameters for your prev and next elements:

{# Set parameters for prev/next elements list #}
{% set params = craft.entries.section('blog').order('title asc') %}

{# Get the prev/next elements #}
{% set prevEntry = entry.getPrev(params) %}
{% set nextEntry = entry.getNext(params) %}

{# And make sure to only output the links if the element exists #}
{% if prevEntry %}<a href="{{ prevEntry.url }}">Previous</a>{% endif %}
{% if nextEntry %}<a href="{{ nextEntry.url }}">Next</a>{% endif %}

Answer 2

You can set the prev.url at the top of the template, for example:

{% set criteria = {section: 'blog', order: 'postDate'} %}
{% set prev = entry.getPrev(criteria) %}

Add a link if prev is available:

{% if prev %}
   <a href="{{ prev.url }}">{{ prev.title }}</a>
{% endif %}

Answer 3

For navigating siblings in a structure there's a shortcut:

{% if entry.prevSibling %}<a href="{{ entry.prevSibling.url }}">Previous</a>{% endif %}
{% if entry.nextSibling %}<a href="{{ entry.nextSibling.url }}">Next</a>{% endif %}