import * as express from 'express'
-import * as Bluebird from 'bluebird'
-import { buildFileLocale, getDefaultLocale, is18nLocale, POSSIBLE_LOCALES } from '../../shared/models/i18n/i18n'
-import { CONFIG, CUSTOM_HTML_TAG_COMMENTS, EMBED_SIZE, STATIC_PATHS } from '../initializers'
+import { buildFileLocale, getDefaultLocale, is18nLocale, POSSIBLE_LOCALES } from '../../shared/core-utils/i18n/i18n'
+import {
+ AVATARS_SIZE,
+ CUSTOM_HTML_TAG_COMMENTS,
+ EMBED_SIZE,
+ PLUGIN_GLOBAL_CSS_PATH,
+ WEBSERVER,
+ FILES_CONTENT_HASH
+} from '../initializers/constants'
import { join } from 'path'
-import { escapeHTML } from '../helpers/core-utils'
+import { escapeHTML, sha256 } from '../helpers/core-utils'
import { VideoModel } from '../models/video/video'
-import * as validator from 'validator'
-import { VideoPrivacy } from '../../shared/models/videos'
+import { VideoPlaylistModel } from '../models/video/video-playlist'
+import validator from 'validator'
+import { VideoPrivacy, VideoPlaylistPrivacy } from '../../shared/models/videos'
import { readFile } from 'fs-extra'
import { getActivityStreamDuration } from '../models/video/video-format-utils'
+import { AccountModel } from '../models/account/account'
+import { VideoChannelModel } from '../models/video/video-channel'
+import * as Bluebird from 'bluebird'
+import { CONFIG } from '../initializers/config'
+import { logger } from '../helpers/logger'
+import { MAccountActor, MChannelActor } from '../types/models'
+
+type Tags = {
+ ogType: string
+ twitterCard: 'player' | 'summary' | 'summary_large_image'
+ schemaType: string
+
+ list?: {
+ numberOfItems: number
+ }
+
+ title: string
+ url: string
+ description: string
+
+ embed?: {
+ url: string
+ createdAt: string
+ duration?: string
+ views?: number
+ }
+
+ image: {
+ url: string
+ width?: number
+ height?: number
+ }
+}
export class ClientHtml {
private static htmlCache: { [path: string]: string } = {}
static invalidCache () {
+ logger.info('Cleaning HTML cache.')
+
ClientHtml.htmlCache = {}
}
- static async getIndexHTML (req: express.Request, res: express.Response, paramLang?: string) {
- const path = ClientHtml.getIndexPath(req, res, paramLang)
+ static async getDefaultHTMLPage (req: express.Request, res: express.Response, paramLang?: string) {
+ const html = paramLang
+ ? await ClientHtml.getIndexHTML(req, res, paramLang)
+ : await ClientHtml.getIndexHTML(req, res)
+
+ let customHtml = ClientHtml.addTitleTag(html)
+ customHtml = ClientHtml.addDescriptionTag(customHtml)
+
+ return customHtml
+ }
+
+ static async getWatchHTMLPage (videoId: string, req: express.Request, res: express.Response) {
+ // Let Angular application handle errors
+ if (!validator.isInt(videoId) && !validator.isUUID(videoId, 4)) {
+ res.status(404)
+ return ClientHtml.getIndexHTML(req, res)
+ }
+
+ const [ html, video ] = await Promise.all([
+ ClientHtml.getIndexHTML(req, res),
+ VideoModel.loadWithBlacklist(videoId)
+ ])
+
+ // Let Angular application handle errors
+ if (!video || video.privacy === VideoPrivacy.PRIVATE || video.privacy === VideoPrivacy.INTERNAL || video.VideoBlacklist) {
+ res.status(404)
+ return html
+ }
+
+ let customHtml = ClientHtml.addTitleTag(html, escapeHTML(video.name))
+ customHtml = ClientHtml.addDescriptionTag(customHtml, escapeHTML(video.description))
+
+ const url = WEBSERVER.URL + video.getWatchStaticPath()
+ const title = escapeHTML(video.name)
+ const description = escapeHTML(video.description)
+
+ const image = {
+ url: WEBSERVER.URL + video.getPreviewStaticPath()
+ }
+
+ const embed = {
+ url: WEBSERVER.URL + video.getEmbedStaticPath(),
+ createdAt: video.createdAt.toISOString(),
+ duration: getActivityStreamDuration(video.duration),
+ views: video.views
+ }
+
+ const ogType = 'video'
+ const twitterCard = CONFIG.SERVICES.TWITTER.WHITELISTED ? 'player' : 'summary_large_image'
+ const schemaType = 'VideoObject'
+
+ customHtml = ClientHtml.addTags(customHtml, { url, title, description, image, embed, ogType, twitterCard, schemaType })
+
+ return customHtml
+ }
+
+ static async getWatchPlaylistHTMLPage (videoPlaylistId: string, req: express.Request, res: express.Response) {
+ // Let Angular application handle errors
+ if (!validator.isInt(videoPlaylistId) && !validator.isUUID(videoPlaylistId, 4)) {
+ res.status(404)
+ return ClientHtml.getIndexHTML(req, res)
+ }
+
+ const [ html, videoPlaylist ] = await Promise.all([
+ ClientHtml.getIndexHTML(req, res),
+ VideoPlaylistModel.loadWithAccountAndChannel(videoPlaylistId, null)
+ ])
+
+ // Let Angular application handle errors
+ if (!videoPlaylist || videoPlaylist.privacy === VideoPlaylistPrivacy.PRIVATE) {
+ res.status(404)
+ return html
+ }
+
+ let customHtml = ClientHtml.addTitleTag(html, escapeHTML(videoPlaylist.name))
+ customHtml = ClientHtml.addDescriptionTag(customHtml, escapeHTML(videoPlaylist.description))
+
+ const url = videoPlaylist.getWatchUrl()
+ const title = escapeHTML(videoPlaylist.name)
+ const description = escapeHTML(videoPlaylist.description)
+
+ const image = {
+ url: videoPlaylist.getThumbnailUrl()
+ }
+
+ const embed = {
+ url: WEBSERVER.URL + videoPlaylist.getEmbedStaticPath(),
+ createdAt: videoPlaylist.createdAt.toISOString()
+ }
+
+ const list = {
+ numberOfItems: videoPlaylist.get('videosLength') as number
+ }
+
+ const ogType = 'video'
+ const twitterCard = CONFIG.SERVICES.TWITTER.WHITELISTED ? 'player' : 'summary'
+ const schemaType = 'ItemList'
+
+ customHtml = ClientHtml.addTags(customHtml, { url, embed, title, description, image, list, ogType, twitterCard, schemaType })
+
+ return customHtml
+ }
+
+ static async getAccountHTMLPage (nameWithHost: string, req: express.Request, res: express.Response) {
+ return this.getAccountOrChannelHTMLPage(() => AccountModel.loadByNameWithHost(nameWithHost), req, res)
+ }
+
+ static async getVideoChannelHTMLPage (nameWithHost: string, req: express.Request, res: express.Response) {
+ return this.getAccountOrChannelHTMLPage(() => VideoChannelModel.loadByNameWithHostAndPopulateAccount(nameWithHost), req, res)
+ }
+
+ static async getEmbedHTML () {
+ const path = ClientHtml.getEmbedPath()
+
if (ClientHtml.htmlCache[path]) return ClientHtml.htmlCache[path]
const buffer = await readFile(path)
let html = buffer.toString()
-
- html = ClientHtml.addTitleTag(html)
- html = ClientHtml.addDescriptionTag(html)
- html = ClientHtml.addCustomCSS(html)
+ html = await ClientHtml.addAsyncPluginCSS(html)
ClientHtml.htmlCache[path] = html
return html
}
- static async getWatchHTMLPage (videoId: string, req: express.Request, res: express.Response) {
- let videoPromise: Bluebird<VideoModel>
+ private static async getAccountOrChannelHTMLPage (
+ loader: () => Bluebird<MAccountActor | MChannelActor>,
+ req: express.Request,
+ res: express.Response
+ ) {
+ const [ html, entity ] = await Promise.all([
+ ClientHtml.getIndexHTML(req, res),
+ loader()
+ ])
// Let Angular application handle errors
- if (validator.isInt(videoId) || validator.isUUID(videoId, 4)) {
- videoPromise = VideoModel.loadAndPopulateAccountAndServerAndTags(videoId)
- } else {
+ if (!entity) {
+ res.status(404)
return ClientHtml.getIndexHTML(req, res)
}
- const [ html, video ] = await Promise.all([
- ClientHtml.getIndexHTML(req, res),
- videoPromise
- ])
+ let customHtml = ClientHtml.addTitleTag(html, escapeHTML(entity.getDisplayName()))
+ customHtml = ClientHtml.addDescriptionTag(customHtml, escapeHTML(entity.description))
- // Let Angular application handle errors
- if (!video || video.privacy === VideoPrivacy.PRIVATE) {
- return ClientHtml.getIndexHTML(req, res)
+ const url = entity.Actor.url
+ const title = escapeHTML(entity.getDisplayName())
+ const description = escapeHTML(entity.description)
+
+ const image = {
+ url: entity.Actor.getAvatarUrl(),
+ width: AVATARS_SIZE.width,
+ height: AVATARS_SIZE.height
}
- return ClientHtml.addOpenGraphAndOEmbedTags(html, video)
+ const ogType = 'website'
+ const twitterCard = 'summary'
+ const schemaType = 'ProfilePage'
+
+ customHtml = ClientHtml.addTags(customHtml, { url, title, description, image, ogType, twitterCard, schemaType })
+
+ return customHtml
}
- private static getIndexPath (req: express.Request, res: express.Response, paramLang?: string) {
+ private static async getIndexHTML (req: express.Request, res: express.Response, paramLang?: string) {
+ const path = ClientHtml.getIndexPath(req, res, paramLang)
+ if (ClientHtml.htmlCache[path]) return ClientHtml.htmlCache[path]
+
+ const buffer = await readFile(path)
+
+ let html = buffer.toString()
+
+ if (paramLang) html = ClientHtml.addHtmlLang(html, paramLang)
+ html = ClientHtml.addManifestContentHash(html)
+ html = ClientHtml.addFaviconContentHash(html)
+ html = ClientHtml.addLogoContentHash(html)
+ html = ClientHtml.addCustomCSS(html)
+ html = await ClientHtml.addAsyncPluginCSS(html)
+
+ ClientHtml.htmlCache[path] = html
+
+ return html
+ }
+
+ private static getIndexPath (req: express.Request, res: express.Response, paramLang: string) {
let lang: string
// Check param lang validity
// Save locale in cookies
res.cookie('clientLanguage', lang, {
- secure: CONFIG.WEBSERVER.SCHEME === 'https',
- sameSite: true,
+ secure: WEBSERVER.SCHEME === 'https',
+ sameSite: 'none',
maxAge: 1000 * 3600 * 24 * 90 // 3 months
})
return join(__dirname, '../../../client/dist/' + buildFileLocale(lang) + '/index.html')
}
- private static addTitleTag (htmlStringPage: string) {
- const titleTag = '<title>' + CONFIG.INSTANCE.NAME + '</title>'
+ private static getEmbedPath () {
+ return join(__dirname, '../../../client/dist/standalone/videos/embed.html')
+ }
+
+ private static addHtmlLang (htmlStringPage: string, paramLang: string) {
+ return htmlStringPage.replace('<html>', `<html lang="${paramLang}">`)
+ }
+
+ private static addManifestContentHash (htmlStringPage: string) {
+ return htmlStringPage.replace('[manifestContentHash]', FILES_CONTENT_HASH.MANIFEST)
+ }
+
+ private static addFaviconContentHash (htmlStringPage: string) {
+ return htmlStringPage.replace('[faviconContentHash]', FILES_CONTENT_HASH.FAVICON)
+ }
+
+ private static addLogoContentHash (htmlStringPage: string) {
+ return htmlStringPage.replace('[logoContentHash]', FILES_CONTENT_HASH.LOGO)
+ }
+
+ private static addTitleTag (htmlStringPage: string, title?: string) {
+ let text = title || CONFIG.INSTANCE.NAME
+ if (title) text += ` - ${CONFIG.INSTANCE.NAME}`
+
+ const titleTag = `<title>${text}</title>`
return htmlStringPage.replace(CUSTOM_HTML_TAG_COMMENTS.TITLE, titleTag)
}
- private static addDescriptionTag (htmlStringPage: string) {
- const descriptionTag = `<meta name="description" content="${CONFIG.INSTANCE.SHORT_DESCRIPTION}" />`
+ private static addDescriptionTag (htmlStringPage: string, description?: string) {
+ const content = description || CONFIG.INSTANCE.SHORT_DESCRIPTION
+ const descriptionTag = `<meta name="description" content="${content}" />`
return htmlStringPage.replace(CUSTOM_HTML_TAG_COMMENTS.DESCRIPTION, descriptionTag)
}
private static addCustomCSS (htmlStringPage: string) {
- const styleTag = '<style class="custom-css-style">' + CONFIG.INSTANCE.CUSTOMIZATIONS.CSS + '</style>'
+ const styleTag = `<style class="custom-css-style">${CONFIG.INSTANCE.CUSTOMIZATIONS.CSS}</style>`
return htmlStringPage.replace(CUSTOM_HTML_TAG_COMMENTS.CUSTOM_CSS, styleTag)
}
- private static addOpenGraphAndOEmbedTags (htmlStringPage: string, video: VideoModel) {
- const previewUrl = CONFIG.WEBSERVER.URL + STATIC_PATHS.PREVIEWS + video.getPreviewName()
- const videoUrl = CONFIG.WEBSERVER.URL + '/videos/watch/' + video.uuid
+ private static async addAsyncPluginCSS (htmlStringPage: string) {
+ const globalCSSContent = await readFile(PLUGIN_GLOBAL_CSS_PATH)
+ if (globalCSSContent.byteLength === 0) return htmlStringPage
+
+ const fileHash = sha256(globalCSSContent)
+ const linkTag = `<link rel="stylesheet" href="/plugins/global.css?hash=${fileHash}" />`
+
+ return htmlStringPage.replace('</head>', linkTag + '</head>')
+ }
+
+ private static generateOpenGraphMetaTags (tags: Tags) {
+ const metaTags = {
+ 'og:type': tags.ogType,
+ 'og:title': tags.title,
+ 'og:image': tags.image.url
+ }
+
+ if (tags.image.width && tags.image.height) {
+ metaTags['og:image:width'] = tags.image.width
+ metaTags['og:image:height'] = tags.image.height
+ }
- const videoNameEscaped = escapeHTML(video.name)
- const videoDescriptionEscaped = escapeHTML(video.description)
- const embedUrl = CONFIG.WEBSERVER.URL + video.getEmbedStaticPath()
+ metaTags['og:url'] = tags.url
+ metaTags['og:description'] = tags.description
- const openGraphMetaTags = {
- 'og:type': 'video',
- 'og:title': videoNameEscaped,
- 'og:image': previewUrl,
- 'og:url': videoUrl,
- 'og:description': videoDescriptionEscaped,
+ if (tags.embed) {
+ metaTags['og:video:url'] = tags.embed.url
+ metaTags['og:video:secure_url'] = tags.embed.url
+ metaTags['og:video:type'] = 'text/html'
+ metaTags['og:video:width'] = EMBED_SIZE.width
+ metaTags['og:video:height'] = EMBED_SIZE.height
+ }
- 'og:video:url': embedUrl,
- 'og:video:secure_url': embedUrl,
- 'og:video:type': 'video/mp4',
- 'og:video:width': EMBED_SIZE.width,
- 'og:video:height': EMBED_SIZE.height,
+ return metaTags
+ }
- 'name': videoNameEscaped,
- 'description': videoDescriptionEscaped,
- 'image': previewUrl,
+ private static generateStandardMetaTags (tags: Tags) {
+ return {
+ name: tags.title,
+ description: tags.description,
+ image: tags.image.url
+ }
+ }
- 'twitter:card': CONFIG.SERVICES.TWITTER.WHITELISTED ? 'player' : 'summary_large_image',
+ private static generateTwitterCardMetaTags (tags: Tags) {
+ const metaTags = {
+ 'twitter:card': tags.twitterCard,
'twitter:site': CONFIG.SERVICES.TWITTER.USERNAME,
- 'twitter:title': videoNameEscaped,
- 'twitter:description': videoDescriptionEscaped,
- 'twitter:image': previewUrl,
- 'twitter:player': embedUrl,
- 'twitter:player:width': EMBED_SIZE.width,
- 'twitter:player:height': EMBED_SIZE.height
+ 'twitter:title': tags.title,
+ 'twitter:description': tags.description,
+ 'twitter:image': tags.image.url
}
- const oembedLinkTags = [
- {
- type: 'application/json+oembed',
- href: CONFIG.WEBSERVER.URL + '/services/oembed?url=' + encodeURIComponent(videoUrl),
- title: videoNameEscaped
- }
- ]
+ if (tags.image.width && tags.image.height) {
+ metaTags['twitter:image:width'] = tags.image.width
+ metaTags['twitter:image:height'] = tags.image.height
+ }
+
+ if (tags.twitterCard === 'player') {
+ metaTags['twitter:player'] = tags.embed.url
+ metaTags['twitter:player:width'] = EMBED_SIZE.width
+ metaTags['twitter:player:height'] = EMBED_SIZE.height
+ }
- const schemaTags = {
+ return metaTags
+ }
+
+ private static generateSchemaTags (tags: Tags) {
+ const schema = {
'@context': 'http://schema.org',
- '@type': 'VideoObject',
- name: videoNameEscaped,
- description: videoDescriptionEscaped,
- thumbnailUrl: previewUrl,
- uploadDate: video.createdAt.toISOString(),
- duration: getActivityStreamDuration(video.duration),
- contentUrl: videoUrl,
- embedUrl: embedUrl,
- interactionCount: video.views
+ '@type': tags.schemaType,
+ 'name': tags.title,
+ 'description': tags.description,
+ 'image': tags.image.url,
+ 'url': tags.url
+ }
+
+ if (tags.list) {
+ schema['numberOfItems'] = tags.list.numberOfItems
+ schema['thumbnailUrl'] = tags.image.url
+ }
+
+ if (tags.embed) {
+ schema['embedUrl'] = tags.embed.url
+ schema['uploadDate'] = tags.embed.createdAt
+
+ if (tags.embed.duration) schema['duration'] = tags.embed.duration
+ if (tags.embed.views) schema['iterationCount'] = tags.embed.views
+
+ schema['thumbnailUrl'] = tags.image.url
+ schema['contentUrl'] = tags.url
+ }
+
+ return schema
+ }
+
+ private static addTags (htmlStringPage: string, tagsValues: Tags) {
+ const openGraphMetaTags = this.generateOpenGraphMetaTags(tagsValues)
+ const standardMetaTags = this.generateStandardMetaTags(tagsValues)
+ const twitterCardMetaTags = this.generateTwitterCardMetaTags(tagsValues)
+ const schemaTags = this.generateSchemaTags(tagsValues)
+
+ const { url, title, embed } = tagsValues
+
+ const oembedLinkTags: { type: string, href: string, title: string }[] = []
+
+ if (embed) {
+ oembedLinkTags.push({
+ type: 'application/json+oembed',
+ href: WEBSERVER.URL + '/services/oembed?url=' + encodeURIComponent(url),
+ title
+ })
}
let tagsString = ''
tagsString += `<meta property="${tagName}" content="${tagValue}" />`
})
+ // Standard
+ Object.keys(standardMetaTags).forEach(tagName => {
+ const tagValue = standardMetaTags[tagName]
+
+ tagsString += `<meta property="${tagName}" content="${tagValue}" />`
+ })
+
+ // Twitter card
+ Object.keys(twitterCardMetaTags).forEach(tagName => {
+ const tagValue = twitterCardMetaTags[tagName]
+
+ tagsString += `<meta property="${tagName}" content="${tagValue}" />`
+ })
+
// OEmbed
for (const oembedLinkTag of oembedLinkTags) {
tagsString += `<link rel="alternate" type="${oembedLinkTag.type}" href="${oembedLinkTag.href}" title="${oembedLinkTag.title}" />`
}
// Schema.org
- tagsString += `<script type="application/ld+json">${JSON.stringify(schemaTags)}</script>`
+ if (schemaTags) {
+ tagsString += `<script type="application/ld+json">${JSON.stringify(schemaTags)}</script>`
+ }
- // SEO
- tagsString += `<link rel="canonical" href="${videoUrl}" />`
+ // SEO, use origin URL
+ tagsString += `<link rel="canonical" href="${url}" />`
- return htmlStringPage.replace(CUSTOM_HTML_TAG_COMMENTS.OPENGRAPH_AND_OEMBED, tagsString)
+ return htmlStringPage.replace(CUSTOM_HTML_TAG_COMMENTS.META_TAGS, tagsString)
}
}