express-pagelet

1. Configure the middleware for express:

app.use(require('express-pagelet').createMiddleware({
pageletDirectory: path.join(__dirname, 'pagelets')
}));

2. Define a pagelet, e.g. in pagelets/foo.js:

var FooPagelet = module.exports = function() {};

FooPagelet.prototype.load = function(opts, ready) {

this.page = opts.page || 1;
// load from db etc.
ready();
};

FooPagelet.prototype.render = function(req, res, done) {
return res.render('pagelet/foo.jade', { heading: 'Foo pagelet', content: 'Some more content...', page: this.page }, done);
};

3. Example view-file in views/pagelet/foo.jade:

h2= heading
p= content
p
strong= page

4. In your route-handler add pagelets, either lazy loading (async: true) or rendering as part of the request:

exports.index = function(req, res) {
res.addPagelet('foo', { async: true }); // type defaults to the name of pagelet
res.addPagelet('bar', { type: 'foo' });

res.renderWithPagelets('index', { title: 'Express' });
};

5. The pagelets are available in your views as locals:

!{pagelet_foo}
!{pagelet_bar}