ghost/core/frontend/helpers/register.js

var hbs = require('../services/themes/engine'),
    Promise = require('bluebird'),
    config = require('../../server/config'),
    proxy = require('./proxy');

// Register an async handlebars helper for a given handlebars instance
function asyncHelperWrapper(hbs, name, fn) {
    hbs.registerAsyncHelper(name, function returnAsync(context, options, cb) {
        // Handle the case where we only get context and cb
        if (!cb) {
            cb = options;
            options = undefined;
        }

        // Wrap the function passed in with a when.resolve so it can return either a promise or a value
        Promise.resolve(fn.call(this, context, options)).then(function asyncHelperSuccess(result) {
            cb(result);
        }).catch(function asyncHelperError(err) {
            var wrappedErr = err instanceof proxy.errors.GhostError ? err : new proxy.errors.IncorrectUsageError({
                    err: err,
                    context: 'registerAsyncThemeHelper: ' + name,
                    errorDetails: {
                        originalError: err
                    }
                }),
                result = config.get('env') === 'development' ? wrappedErr : '';

            proxy.logging.error(wrappedErr);

            cb(new hbs.SafeString(result));
        });
    });
}

// Register a handlebars helper for themes
module.exports.registerThemeHelper = function registerThemeHelper(name, fn) {
    hbs.registerHelper(name, fn);
};

// Register an async handlebars helper for themes
module.exports.registerAsyncThemeHelper = function registerAsyncThemeHelper(name, fn) {
    asyncHelperWrapper(hbs, name, fn);
};