modx CMS

Instructions

In order to install this snippet, just paste the contents of ChunkIf.txt into a new Snippet in the manager called 'ChunkIf'.

The long form of the snippet call looks like this:
[[ChunkIf? &tv=`tvname` &trueChunk=`chunkname` &falseChunk=`chunkname` &debug=`1|0`]]

The parameters to the snippet call work like this:

&tv
This is the name of the template variable you want to test. The value of this variable will be checked and if itís not empty or blank, &trueChunk will be output - otherwise &falseChunk will be.
&trueChunk
The name of the chunk whoís content you want output, in the event that your template variable (&tv) has a value.
&falseChunk
The name of the chunk whoís content you want output, if your template variable (&tv) is empty. If you omit this paramater, an empty string will be output if &tv is empty.
&debug
Set this to 1 to emit debugging comments into the HTML output; set it to 0 or leave it out to switch off.

There is a short version too:

[[ChunkIf? &tv=`tvname`]]

The shorthand form attempts to output the contents of a chunk with the same name as &tv, if &tv is set, or an empty string. If thereís no chunk with the same name, it also returns an empty string.

This shorthand version is very handy for switching chunks on and off using a single variable. As chunks can contain other chunks and snippet calls, you can use this to switch sidebars, footers and other complex bits of layout on and off on a per page basis, with a simple checkbox template variable.