Jump to main content Jump to doc navigation

The snippet pdoNeighbors displays the previous and the next resources.

It can display several neighbors at once, check their status (unpublished, published), and allows you to specify sorting.

You can display the previous / next resources based on «menuindex», publication date or other resource field.


Accepts all options of pdoTools (except chunks templates) and some of its own:

Parameter Default Description
&id The current document The resource ID, of which are displayed the neighbors.
&tplPrev see below Chunk reference to the previous document.
&tplUp see below Chunk reference to the parent document.
&tplNext see below Chunk reference to the following document.
&tplWrapper see below Chunk-wrapper for wrapping results. Uses placeholders: [[+left]], [[+top]], [[+right]] and [[+log]]. It does not work in conjunction with &toSeparatePlaceholders.
&toPlaceholder If not empty, the snippet will save all data to the placeholder specified, instead of displaying the output with the snippet call.
&showLog 0 Display log information of the snippet. Only authorized in the context «mgr».
&loop 1 0/1: Hide/show neighbours first/last entry if at the end of list

Template Chunks

Template Default
&tplPrev @INLINE <span class="link-prev"><a href="/[[+uri]]">&larr; [[+menutitle]]</a></span>
&tplUp @INLINE <span class="link-up">&uarr; <a href="/[[+uri]]">[[+menutitle]]</a></span>
&tplNext @INLINE <span class="link-next"><a href="/[[+uri]]">[[+menutitle]] &rarr;</a></span>
&tplWrapper @INLINE <div class="neighbors">[[+prev]][[+up]][[+next]]</div>


Default snippet displays the neighbors as they are in the resource tree, that is, based on «menuindex»:


By default, the neighbors are selected from the current document, but you can specify a different id:


The snippet is perfect for displaying links to adjacent news items (it is best to sort by date of publication):


Support the team building MODX with a monthly donation.

The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.



$0 per month—let's make that $500!

Learn more