DocPad: Query custom category objects (via template helper only)

README.md

DocPad: Query custom category objects (via template helper only)

See http://stackoverflow.com/a/14381327/130638 for explanation.

docpad.coffee

# Configure DocPad
docpadConfig =
	templateData:
		# Get a collection of documents with a particular category
		# Using QueryEngine's setFilter
		getDocumentsWithCategory: (desiredCategory) ->
			resultCollection = @getCollection('documents').createChildCollection()
				.setFilter 'category', (model) ->
					categories = model.get('categories')
					return false  unless Array.isArray(categories)
					for category in categories
						if desiredCategory in [category.id, category.slug]
							return true
					return false
				.query()
			return resultCollection

# Export
module.exports = docpadConfig

listing.html.eco

<%- @getDocumentsWithCategory('a').pluck('title') %>

post.html.md

title: 'Happy new year!'
layout: 'post'
categories: [
		id: 'a'
		description: 'a is the first letter of the alphabet'
	,
		id: 'b'
		description: 'b is the second letter of the alphabet'
]

Happy new year. Boom boom.