CycleResources

By: Murray Wood Published on: 18/07/2016

An Extra for MODX that allows link creation to the next or previous resource.

An Extra for MODX that allows link creation to the next or previous resource.

If you get a chance, take a peek at an Extra I packaged for MODX called cycleResources. It can be downloaded from http://modx.com/extras/package/cycleresources or directly from the package manager within MODX. It generates a link to the next or previous published resource in the same container and will loop through if the end is reached. It is perfect in a portfolio site or anything you need to dynamically link to the next/previous in a series.

It consists of a few snippets and a default template. You can currently choose either a next or a previous link and you can also choose to use your own chunk for custom formatting/styling.

USAGE

The newest and easiest way is to simply call [[nextResource]] for the next resource and [[prevResource]] for the previous resource.

Use [[nextResource? &tpl=`myCustomTplChunk`]] to specify your own chunk for formatting.

----------------------------------------------
For backwards compatibility, the [[cycleResources]] snippet is also included. To use the default template, and provide the "next" resource simply copy and paste: [[cycleResources]]

To use your own chunk for the template: [[cycleResources? &tpl=`myCustomTplChunk`]]

If you want the generated link to be for the "previous" resource instead of the next: [[cycleResources? &reverse=`1`]]

KNOWN ISSUES

On duplicating a resource, at the time of writing by default MODX core does not assign a new menuindex to the new resource, so it's quite likely you'll end up with two resources that have the same menu index. This can cause cycleResources to skip the original resource and only display the new resource. To avoid this, change the MODX system setting "preserve_menuindex" to false.

Post Details

Category MODX Extra Development
Date 18/07/2016
Author Murray Wood
About The CycleResources Extra can be downloaded from the package manager inside MODX.

Latest Posts

LocationResources
Date 20/01/2017

CycleResources
Date 18/07/2016

MODExt Tutorial Series - Part 2
Date 02/07/2015

MODExt Tutorial Series - Part 1
Date 26/06/2015

Comments