Custom Page Templates

fixes #1969

- creates new ./server/helpers/tempalte.js method
 which returns the correct view to use when rendering

- updates fronted controller to check if a custom page template
 exists and if so then uses that to render the static page

- adds additional class name to body_class helper when
 a custom page template is being rendered

- adds tests to address all new features

Author: hswolff

core/server/controllers/frontend.js

@@ -15,6 +15,7 @@ var moment      = require('moment'),
     config      = require('../config'),
     errors      = require('../errorHandling'),
     filters     = require('../../server/filters'),
+    template    = require('../helpers/template'),
 
     frontendControllers,
     // Cache static post permalink regex
@@ -186,7 +187,8 @@ frontendControllers = {
                 filters.doFilter('prePostsRender', post).then(function (post) {
                     api.settings.read('activeTheme').then(function (activeTheme) {
                         var paths = config().paths.availableThemes[activeTheme.value],
-                            view = post.page && paths.hasOwnProperty('page.hbs') ? 'page' : 'post';
+                            view = template.getThemeViewForPost(paths, post);
+
                         res.render(view, {post: post});
                     });
                 });

core/server/helpers/index.js

@@ -347,6 +347,7 @@ coreHelpers.ghost_script_tags = function () {
 coreHelpers.body_class = function (options) {
     /*jslint unparam:true*/
     var classes = [],
+        post = this.post,
         tags = this.post && this.post.tags ? this.post.tags : this.tags || [],
         page = this.post && this.post.page ? this.post.page : this.page || false;
 
@@ -366,9 +367,26 @@ coreHelpers.body_class = function (options) {
         classes.push('page');
     }
 
-    return filters.doFilter('body_class', classes).then(function (classes) {
-        var classString = _.reduce(classes, function (memo, item) { return memo + ' ' + item; }, '');
-        return new hbs.handlebars.SafeString(classString.trim());
+    return api.settings.read('activeTheme').then(function (activeTheme) {
+        var paths = config().paths.availableThemes[activeTheme.value],
+            view;
+
+        if (post) {
+            view = template.getThemeViewForPost(paths, post).split('-');
+
+            // If this is a page and we have a custom page template
+            // then we need to modify the class name we inject
+            // e.g. 'page-contact' is outputted as 'page-template-contact'
+            if (view[0] === 'page' && view.length > 1) {
+                view.splice(1, 0, 'template');
+                classes.push(view.join('-'));
+            }
+        }
+
+        return filters.doFilter('body_class', classes).then(function (classes) {
+            var classString = _.reduce(classes, function (memo, item) { return memo + ' ' + item; }, '');
+            return new hbs.handlebars.SafeString(classString.trim());
+        });
     });
 };
 

core/server/helpers/template.js

@@ -23,4 +23,26 @@ templates.execute = function (name, context) {
     return new hbs.handlebars.SafeString(partial(context));
 };
 
+// Given a theme object and a post object this will return
+// which theme template page should be used.
+// If given a post object that is a regular post
+// it will return 'post'.
+// If given a static post object it will return 'page'.
+// If given a static post object and a custom page template
+// exits it will return that page.
+templates.getThemeViewForPost = function (themePaths, post) {
+    var customPageView = 'page-' + post.slug,
+        view = 'post';
+
+    if (post.page) {
+        if (themePaths.hasOwnProperty(customPageView + '.hbs')) {
+            view = customPageView;
+        } else if (themePaths.hasOwnProperty('page.hbs')) {
+            view = 'page';
+        }
+    }
+
+    return view;
+};
+
 module.exports = templates;