heimrichhannot/contao-video-bundle

This bundle brings enhanced video embedding support to contao with additional privacy options.

1.7.1 2024-02-27 09:19 UTC

Requires

• php: ^7.4 || ^8.0
• contao/core-bundle: ^4.9
• heimrichhannot/contao-config-element-type-bundle: ^0.2
• heimrichhannot/contao-encore-contracts: ^1.0
• heimrichhannot/contao-multi-column-editor-bundle: ^2.13
• heimrichhannot/contao-twig-support-bundle: ^1.5
• heimrichhannot/contao-utils-bundle: ^2.224
• symfony/deprecation-contracts: ^2.0 || ^3.0
• symfony/http-kernel: ^4.4 || ^5.4
• symfony/service-contracts: ^1.0 || ^2.0 || ^3.0
• symfony/translation-contracts: ^1.0 || ^2.0 || ^3.0

Suggests

• heimrichhannot/contao-encore-bundle: Manage dependencies with Symfony Webpack Encore.

Conflicts

• heimrichhannot/contao-privacy-center-bundle: <2.8

LGPL-3.0-or-later

• youtube
• video
• responsive
• content
• contao

README

This bundle brings enhanced video embedding support to contao with additional privacy options and is the successor of our YouTube Bundle.

Features

• Support for YouTube and Vimeo as video providers
• Support for Videos from Contao File System
  • integration of multiple sources for one video
  • integration for subtitles
  • integration for madia-queries on video tag
• Out-of-the-box-usage:
  • Content Element
  • News
• enhance your users privacy with preview images, privacy notice before playing and no cookie urls
• responsive Videos
• expandable architecture
• Encore Bundle support
• List Bundle and Reader Bundle support
• Privacy Center Bundle support

Usage

Install

Install with contao manager or composer:

composer require heimrichhannot/contao-video-bundle

Update database afterwards.

Setup

1. Setup the configuration to your likes (see configuration reference for all options):

   huh_video:
       # Enable support for news entity.
       enable_news_support:    false
       # Enable if by default no cookie embed urls should be used, if supported by the video provider. This can be overwritten on root pages.
       default_use_no_cookie_video_url: false
       # Enable if by default a privacy message should be displayed before playing the video. This can be overwritten on root pages.
       default_display_privacy_notice: false

2. Clear cache and check for database updates after update your config

3. Adjust template settings on root page if needed. You can also overwrite the default configuration there.

   • If privacy center bundle installed, configure the integration there.

4. Start adding videos as content element or to your news.

   • Content Element: Select "Video" content element
   • News:
     • Check "Add video" in your news item
     • output "videoplayer" variable in your news template

Help

IE Support

To make video bundle work in IE, you have to add polyfills:

• https://developer.mozilla.org/en-US/docs/Web/API/NodeList/forEach
• https://developer.mozilla.org/en-US/docs/Web/API/Element/matches

Documentation

Developer documentation

Configuration reference

Acknowledgments

The creation of this bundle and the vimeo integration was supported by Liebchen+Liebchen GmbH.