mirror of
https://github.com/TryGhost/Ghost.git
synced 2025-01-05 18:34:39 +03:00
a5c29dfc34
closes #6588, #7095 * `ImageObject` with image dimensions (#7152, #7151, #7153) - Returns meta data as promise - returns a new Promise from meta data - uses `Promise.props()` to resolve `getClient()` and `getMetaData()` - Adds 'image-size' util The util returns an object like this ``` { height: 50, url: 'http://myblog.com/images/cat.jpg', width: 50 }; ``` if the dimensions can be fetched and rejects with error, if not. In case we get a locally stored image or a not complete url (like `//www.gravatar.com/andsoon`), we add the protocol to the incomplete one and use `urlFor()` to get the absolute URL. If the request fails or `image-size` is not able to read the file, we reject with error. - adds 'image-size' module to dependencies - adds `getImageSizeFromUrl` function that returns image dimensions - In preparation of AMP support and to improve our schema.org JSON-LD and structured data, I made the following changes: - Changes the following properties to be `Objects`, which have a `url` property by default and a `dimensions` property, if `width` and `height` are available: - `metaData.coverImage` - `metaData.authorImage` - `metaData.blog.logo` - Checks cache by calling `getCachedImageSizeFromUrl`. If image dimensions were fetched already, returns them from cache instead of fetching them again. - If we have image dimensions on hand, the output in our JSON-LD changes from normal urls to be full `ImageObjects`. Applies to all images and logos. - Special case for `publisher.logo` as it has size restrictions: if the image doesn't fulfil the restrictions (<=600 width and <=60 height), we simply output the url instead, so like before. - Adds new property for schema.org JSON-LD: `mainEntityOfPage` as an Object. - Adds additional Open Graph data (if we have the image size): `og:image:width` and `og:image:height` - Adds/updates tests * AMP router and controller (#7171, #7157) Implements AMP in `/apps/`: - renders `amp.hbs` if route is `/:slug/amp/` - updates `setResponseContext` to set context to `['amp', 'post']` for a amp post and `['amp', 'page']` for a page, but will not render amp template for a page - updates `context_spec` - registers 'amp' as new internal app - adds the `amp.hbs` template to `core/server/apps/amp` which will be the default template for AMP posts. - adds `isAmpURL` to `post-lookup` * 🎨 Use `context` in meta as array (#7205) Instead of reading the first value of the context array, we're checking if it includes certain context values. This is a preparation change for AMP, where the context will be delivered as `['amp', 'post']`. * ✨ AMP helpers (#7174, #7216, #7215, #7223) - Adds AMP helpers `{{amp_content}}`, `{{amp_component}}` and `{{amp_ghost_head}}` to support AMP: - `{{amp_content}}`: - Adds `Amperize` as dependency - AMP app uses new helper `{{amp_content}}` to render AMP HTML - `Amperize` transforms regular HTML into AMP HTML - Adds test for `{{amp_content}}` helper - Adds 'Sanitize-HTML` as dependendy - After the HTML get 'amperized' we still might have some HTML tags, which are prohibited in AMP HTML, so we use `sanitize-html` to remove those. With every update, `Amperize` gets and it is able to transform more HTML tags, they valid AMP HTML tags (e. g. `video` and `amp-video`) and will therefore not be removed. - `{{amp_ghost_head}}`: - registers `{{amp_ghost_head}}` helper, but uses `{{ghost_head}}` code - uses `{{amp_ghost_head}}` in `amp.hbs` instead of `{{ghost_head}}` - `{{ghost_head}}`: - Render `amphtml` link in metadata for post, which links to the amp post (`getAmpUrl`) - Updates all test in metadata to support `amp` context - Changes context conditionals to work with full array instead of first array value - Adds conditionals, so no additional javascript gets rendered in `{{ghost_head}}` - Removes trailing `/amp/` in URLs, so only `amphtml` link on regular post renders it - Adds a conditional, so no code injection will be included, for an `amp` context. - `{{amp_components}}`: - AMP app uses new helper `{{amp_components}}` to render necessary script tags for AMP extended components as `amp-iframe`, `amp-anime` and `amp-form` - Adds test for `{{amp_components}}`
152 lines
5.2 KiB
JavaScript
152 lines
5.2 KiB
JavaScript
// # Ghost Head Helper
|
|
// Usage: `{{ghost_head}}`
|
|
//
|
|
// Outputs scripts and other assets at the top of a Ghost theme
|
|
//
|
|
// We use the name ghost_head to match the helper for consistency:
|
|
// jscs:disable requireCamelCaseOrUpperCaseIdentifiers
|
|
|
|
var getMetaData = require('../data/meta'),
|
|
hbs = require('express-hbs'),
|
|
escapeExpression = hbs.handlebars.Utils.escapeExpression,
|
|
SafeString = hbs.handlebars.SafeString,
|
|
_ = require('lodash'),
|
|
filters = require('../filters'),
|
|
assetHelper = require('./asset'),
|
|
config = require('../config'),
|
|
Promise = require('bluebird'),
|
|
labs = require('../utils/labs'),
|
|
api = require('../api');
|
|
|
|
function getClient() {
|
|
if (labs.isSet('publicAPI') === true) {
|
|
return api.clients.read({slug: 'ghost-frontend'}).then(function (client) {
|
|
client = client.clients[0];
|
|
if (client.status === 'enabled') {
|
|
return {
|
|
id: client.slug,
|
|
secret: client.secret
|
|
};
|
|
}
|
|
return {};
|
|
});
|
|
}
|
|
return Promise.resolve({});
|
|
}
|
|
|
|
function writeMetaTag(property, content, type) {
|
|
type = type || property.substring(0, 7) === 'twitter' ? 'name' : 'property';
|
|
return '<meta ' + type + '="' + property + '" content="' + content + '" />';
|
|
}
|
|
|
|
function finaliseStructuredData(metaData) {
|
|
var head = [];
|
|
_.each(metaData.structuredData, function (content, property) {
|
|
if (property === 'article:tag') {
|
|
_.each(metaData.keywords, function (keyword) {
|
|
if (keyword !== '') {
|
|
keyword = escapeExpression(keyword);
|
|
head.push(writeMetaTag(property,
|
|
escapeExpression(keyword)));
|
|
}
|
|
});
|
|
head.push('');
|
|
} else if (content !== null && content !== undefined) {
|
|
head.push(writeMetaTag(property,
|
|
escapeExpression(content)));
|
|
}
|
|
});
|
|
return head;
|
|
}
|
|
|
|
function getAjaxHelper(clientId, clientSecret) {
|
|
return '<script type="text/javascript" src="' +
|
|
assetHelper('shared/ghost-url.js', {hash: {minifyInProduction: true}}) + '"></script>\n' +
|
|
'<script type="text/javascript">\n' +
|
|
'ghost.init({\n' +
|
|
'\tclientId: "' + clientId + '",\n' +
|
|
'\tclientSecret: "' + clientSecret + '"\n' +
|
|
'});\n' +
|
|
'</script>';
|
|
}
|
|
|
|
function ghost_head(options) {
|
|
// if error page do nothing
|
|
if (this.statusCode >= 400) {
|
|
return;
|
|
}
|
|
|
|
var metaData,
|
|
client,
|
|
head = [],
|
|
context = this.context ? this.context : null,
|
|
useStructuredData = !config.isPrivacyDisabled('useStructuredData'),
|
|
safeVersion = this.safeVersion,
|
|
referrerPolicy = config.referrerPolicy ? config.referrerPolicy : 'no-referrer-when-downgrade',
|
|
fetch = {
|
|
metaData: getMetaData(this, options.data.root),
|
|
client: getClient()
|
|
};
|
|
|
|
return Promise.props(fetch).then(function (response) {
|
|
client = response.client;
|
|
metaData = response.metaData;
|
|
|
|
if (context) {
|
|
// head is our main array that holds our meta data
|
|
head.push('<link rel="canonical" href="' +
|
|
escapeExpression(metaData.canonicalUrl) + '" />');
|
|
head.push('<meta name="referrer" content="' + referrerPolicy + '" />');
|
|
|
|
if (_.includes(context, 'post') && !_.includes(context, 'amp')) {
|
|
head.push('<link rel="amphtml" href="' +
|
|
escapeExpression(metaData.ampUrl) + '" />');
|
|
}
|
|
|
|
if (metaData.previousUrl) {
|
|
head.push('<link rel="prev" href="' +
|
|
escapeExpression(metaData.previousUrl) + '" />');
|
|
}
|
|
|
|
if (metaData.nextUrl) {
|
|
head.push('<link rel="next" href="' +
|
|
escapeExpression(metaData.nextUrl) + '" />');
|
|
}
|
|
|
|
if (!_.includes(context, 'paged') && useStructuredData) {
|
|
head.push('');
|
|
head.push.apply(head, finaliseStructuredData(metaData));
|
|
head.push('');
|
|
|
|
if (metaData.schema) {
|
|
head.push('<script type="application/ld+json">\n' +
|
|
JSON.stringify(metaData.schema, null, ' ') +
|
|
'\n </script>\n');
|
|
}
|
|
}
|
|
|
|
if (client && client.id && client.secret && !_.includes(context, 'amp')) {
|
|
head.push(getAjaxHelper(client.id, client.secret));
|
|
}
|
|
}
|
|
|
|
head.push('<meta name="generator" content="Ghost ' +
|
|
escapeExpression(safeVersion) + '" />');
|
|
head.push('<link rel="alternate" type="application/rss+xml" title="' +
|
|
escapeExpression(metaData.blog.title) + '" href="' +
|
|
escapeExpression(metaData.rssUrl) + '" />');
|
|
|
|
return api.settings.read({key: 'ghost_head'});
|
|
}).then(function (response) {
|
|
// no code injection for amp context!!!
|
|
if (!_.includes(context, 'amp')) {
|
|
head.push(response.settings[0].value);
|
|
}
|
|
return filters.doFilter('ghost_head', head);
|
|
}).then(function (head) {
|
|
return new SafeString(head.join('\n ').trim());
|
|
});
|
|
}
|
|
|
|
module.exports = ghost_head;
|