cf-signpost

URL routing for sections and articles

Installation

npm install --save cf-signpost

Usage

``js
var signpost = require('cf-signpost')(sectionService, articleService)
`

Signpost takes a sectionService and an articleService and returns 2 functions: findSection and findArticle.

$3

When given a URL, finds all sections that match the query and calls the callback with the first one (if there is a section) or false.

If the url contains a valid previewId query string parameter, then a search is performed on the sections regardless of their visibility.

$3

When given a URL, finds all public articles that match the query and calls the callback with the first one or false.

If the url contains a valid previewId query string parameter, then a search is performed on the articles regardless of their visibility.

$3

This can be used in a site as follows:

`js
// Render the page
var signpost = require('cf-signpost')(sectionService, articleService)

// Catch all requests and route them through to the section finder
serviceLocator.router.get('*', function (req, res, next) {

signpost.findSection(req.url, function (err, section) {
if (err) return next(err)
// If a section was found, delegate to the section renderer to render it
if (section) return sectionRenderer(section)(req, res, next)
// No section was found, call the next route handle
next()
})

})

// Catch all requests and route them through to the article finder
serviceLocator.router.get('*', function (req, res, next) {

signpost.findArticle(req.url, function (err, data) {
if (err) return next(err)
// If an article was found, delegate to the article renderer to render it
if (data) return articleRenderer(data.section, data.article)(req, res, next)
// No section was found, call the next route handle
next()
})

})
``

Credits

Built by developers at Clock.

Licence

Licensed under the New BSD License