PHPackages                             heimrichhannot/contao-video-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Image &amp; Media](/categories/media)
4. /
5. heimrichhannot/contao-video-bundle

ActiveContao-bundle[Image &amp; Media](/categories/media)

heimrichhannot/contao-video-bundle
==================================

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

1.8.0(1y ago)23.5k↓34.6%2[3 issues](https://github.com/heimrichhannot/contao-video-bundle/issues)[4 PRs](https://github.com/heimrichhannot/contao-video-bundle/pulls)LGPL-3.0-or-laterPHPPHP ^7.4 || ^8.0

Since Mar 16Pushed 2mo ago7 watchersCompare

[ Source](https://github.com/heimrichhannot/contao-video-bundle)[ Packagist](https://packagist.org/packages/heimrichhannot/contao-video-bundle)[ RSS](/packages/heimrichhannot-contao-video-bundle/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (10)Dependencies (10)Versions (63)Used By (0)

Contao Video Bundle
===================

[](#contao-video-bundle)

[![](https://camo.githubusercontent.com/ac19503836a2ad377c9e62502c8c4875682c9245c552f1f5b6143399d3a82d74/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6865696d7269636868616e6e6f742f636f6e74616f2d766964656f2d62756e646c652e737667)](https://packagist.org/packages/heimrichhannot/contao-video-bundle)[![](https://camo.githubusercontent.com/fbe7b117dcb934453b8775e4af8b10c4a1d17e9f622ab0ead266a88b085f79e1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6865696d7269636868616e6e6f742f636f6e74616f2d766964656f2d62756e646c652e737667)](https://packagist.org/packages/heimrichhannot/contao-video-bundle)

This bundle brings enhanced video embedding support to contao with additional privacy options and is the successor of our [YouTube Bundle](https://github.com/heimrichhannot/contao-youtube-bundle).

Features
--------

[](#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](https://github.com/heimrichhannot/contao-encore-bundle) support
- [List Bundle](https://github.com/heimrichhannot/contao-list-bundle) and [Reader Bundle](https://github.com/heimrichhannot/contao-reader-bundle) support
- Privacy Center Bundle support

Usage
-----

[](#usage)

### Install

[](#install)

Install with contao manager or composer:

```
composer require heimrichhannot/contao-video-bundle

```

Update database afterwards.

### Setup

[](#setup)

1. Setup the [configuration](https://docs.contao.org/manual/de/system/einstellungen/#config-yml) to your likes (see [configuration reference](docs/configuration.md) 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

### Customize

[](#customize)

#### Add custom video link texts

[](#add-custom-video-link-texts)

Add your wanted translation as [symfony translation](https://symfony.com/doc/4.4/translation.html) withing `huh_video.fields.videoLinkText` key. Example:

```
# Projekt: app/Resources/translations/messages.en.yml
# Bundle: src/Resources/translations/messages.en.yml
huh_video:
  fields:
    videoLinkText:
      amazing: "Show this amazing video!"
```

#### Add custom media queries for file system videos

[](#add-custom-media-queries-for-file-system-videos)

The `name` is optional and is used for better explanation to the backend user

```
huh_video:
    media_queries:
        xxl:
            query: "(min-width: 1200px)"
            name: "Desktop"
```

**Note: Some browsers do not support media-queries on video element, even more it breaks autoplay. So just remove media-queries(it is not mandatory - just let the media-query field empty) from video source, if you want all browsers to autoplay on load.**

### Help

[](#help)

#### IE Support

[](#ie-support)

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

-
-

Documentation
-------------

[](#documentation)

[Developer documentation](docs/developers.md)

[Configuration reference](docs/configuration.md)

Acknowledgments
---------------

[](#acknowledgments)

The creation of this bundle and the vimeo integration was supported by [Liebchen+Liebchen GmbH](https://www.lplusl.de/).

###  Health Score

43

—

FairBetter than 90% of packages

Maintenance45

Moderate activity, may be stable

Popularity24

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity75

Established project with proven stability

 Bus Factor1

Top contributor holds 82.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~32 days

Recently: every ~133 days

Total

57

Last Release

481d ago

Major Versions

0.12.0 → 1.0.02022-05-17

PHP version history (3 changes)0.1.0PHP ^7.1

0.10.0PHP ^7.1|^8.0

1.1.0PHP ^7.4 || ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/28ad3224d8727b622ebd229840eea6b9dbcb83eb0bd609e6ce65b614830ff538?d=identicon)[digitales@heimrich-hannot.de](/maintainers/digitales@heimrich-hannot.de)

---

Top Contributors

[![koertho](https://avatars.githubusercontent.com/u/12064642?v=4)](https://github.com/koertho "koertho (64 commits)")[![vvohh](https://avatars.githubusercontent.com/u/75325799?v=4)](https://github.com/vvohh "vvohh (11 commits)")[![AlexejKossmann](https://avatars.githubusercontent.com/u/32612134?v=4)](https://github.com/AlexejKossmann "AlexejKossmann (2 commits)")[![zonky2](https://avatars.githubusercontent.com/u/1045318?v=4)](https://github.com/zonky2 "zonky2 (1 commits)")

---

Tags

contaovimeoyoutubevideoyoutubecontentcontaoresponsive

### Embed Badge

![Health badge](/badges/heimrichhannot-contao-video-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/heimrichhannot-contao-video-bundle/health.svg)](https://phpackages.com/packages/heimrichhannot-contao-video-bundle)
```

###  Alternatives

[api-platform/core

Build a fully-featured hypermedia or GraphQL API in minutes!

2.6k50.1M314](/packages/api-platform-core)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.4M196](/packages/sulu-sulu)[drupal/core-recommended

Locked core dependencies; require this project INSTEAD OF drupal/core.

6941.5M396](/packages/drupal-core-recommended)[api-platform/state

API Platform state interfaces

244.3M112](/packages/api-platform-state)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.5k5.8M712](/packages/sylius-sylius)[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k17.5M373](/packages/easycorp-easyadmin-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
