Custom templates

This addon provides a default template for all instances. You can provide additional template choices by adding a DJANGOCMS_VIDEO_TEMPLATES setting to your project’s settings file:

from django.utils.translation import gettext_lazy as _

DJANGOCMS_VIDEO_TEMPLATES = [
    ('feature', _('Featured Version')),
]

The first value, feature, is the template directory name; the second is the label shown in the plugin’s Template field.

Copy the files from this package’s djangocms_video/templates/djangocms_video/default/ directory into your own app, using this layout (your_app is an app in your project):

your_app/
    templates/
        djangocms_video/
            feature/
                video_player.html
                source.html
                track.html

Ensure your_app is in INSTALLED_APPS and APP_DIRS is True in your existing DjangoTemplates entry in TEMPLATES. If you configure template loaders explicitly instead, include django.template.loaders.app_directories.Loader.

Alternatively, put the same djangocms_video/feature/ directory under a project-level templates/ directory, alongside manage.py. Add that directory to DIRS in your existing DjangoTemplates entry in the project’s settings file, keeping any other directories already configured:

"DIRS": [BASE_DIR / "templates"],

This example assumes BASE_DIR is a pathlib.Path pointing to the directory containing manage.py. Keep the other template settings, including context processors. See Django’s template loading documentation for details.

Edit the copied files, then select Featured Version in the Video player plugin’s Template field. The player loads djangocms_video/feature/video_player.html; its Source and Track child plugins load source.html and track.html from the same directory. Copy all three files so that child plugins can render without a TemplateDoesNotExist error.

To customize the existing Default choice instead, use djangocms_video/default/ in your own templates directory; no DJANGOCMS_VIDEO_TEMPLATES setting is needed. When using app templates for this override, place your_app before djangocms_video in INSTALLED_APPS so Django finds your templates first.

Make changes in your own project or app. Editing the installed package’s files would lose your changes when the package is updated or reinstalled.

Video settings

MP4, WEBM and OGV files are allowed by default. We recommend adding all 3 source files for full browser compatibility. You can change the default setting by overriding:

DJANGOCMS_VIDEO_ALLOWED_EXTENSIONS = ['mp4', 'webm', 'ogv']

The plugin detects YouTube URLs using a regular expression and canonicalizes them to //www.youtube.com/embed/{} where the placeholder is replaced by the video id.

The canonical URL can be reconfigured with a configuration setting:

DJANGOCMS_VIDEO_YOUTUBE_EMBED_URL = '//www.youtube-nocookie.com/embed/{}'

HLS streams

To play an HTTP Live Streaming (HLS) stream, add an HLS Stream Source child to a Video player plugin and enter the HTTP or HTTPS URL of its .m3u8 playlist. Leave the player’s Embed link empty. The Show controls and Autoplay options are available in the player’s advanced settings; browsers may block autoplay.

Streams use the HTML <video> element with hls.js or the browser’s native HLS support. Ensure sekizai is in INSTALLED_APPS, sekizai.context_processors.sekizai is in the template context processors, and the page template loads sekizai_tags and includes {% render_block "js" %} after the content.

By default, hls.js is loaded from a CDN. To use a different URL or a locally hosted copy, override this setting:

DJANGOCMS_VIDEO_HLSJS_SOURCE = 'https://cdn.jsdelivr.net/npm/hls.js@1.5.17/dist/hls.min.js'