README

[ ṯeufels ] Hauer-Heinrich - Video Extender Extended

Extend hauerheinrich/hh-video-extender EXT for Cookie Consent Tool Support for embedded youtube & vimeo content

This version supports TYPO3

Composer support

composer req teufels/hhvideoextender-extended

Requirements

hauerheinrich/hh-video-extender: ^0.3

How to use

Install with composer
select cookie-consent-tool to enable adapted handling of video extender in Site Management > Settings

Migration beewilly to teufels

replace beewilly/hive_ovr_hhvideoextender with teufels/hhvideoextender-extended

Migration to TYPO3 v14

hauerheinrich/hh-video-extender is no longer maintained for TYPO3 v14. The consent functionality is therefore implemented directly in the sitepackage (no separate extension package needed anymore).

1. Remove hauerheinrich/hh-video-extender + teufels/hhvideoextender-extended

composer remove hauerheinrich/hh-video-extender teufels/hhvideoextender-extended

2. Install traw/video-vtt

traw/video-vtt replaces the renderer functionality for YouTube, Vimeo and local videos (incl. subtitles/VTT, poster image, start-/end-time, controlsList etc.)

composer require traw/video-vtt

3. Add renderer overrides to the sitepackage

Copy the following classes from teufels/boilerplate-t3 (TYPO3 v14) into the sitepackage:

Classes/Resource/Rendering/YouTubeRenderer.php
- extends TRAW\VideoVtt\Resource\Rendering\YouTubeRenderer (priority 10)
- applies Cookiebot / Usercentrics attributes to the generated <iframe>
Classes/Resource/Rendering/VimeoRenderer.php
- extends TRAW\VideoVtt\Resource\Rendering\VimeoRenderer (priority 10)
- identical consent logic as YouTubeRenderer

$rendererRegistry->registerRendererClass(\Teufels\Sitepackage\Resource\Rendering\YouTubeRenderer::class);
$rendererRegistry->registerRendererClass(\Teufels\Sitepackage\Resource\Rendering\VimeoRenderer::class);

4. Add Fluid template override to the sitepackage

Copy from teufels/boilerplate-t3 (TYPO3 v14):

Resources/Private/Overrides/fluid-styled-content/Partials/Media/Type/Video.html
- overrides the core template (via partialRootPaths.999)
- renders data-type="external" and data-cookietool="..." on the <figure> tag
- renders <div class="cookieconsent-optout-marketing"> fallback block for Cookiebot

5. Make cookieTool setting available in lib.contentElement

Add to Configuration/TypoScript/Setup/ext.fluidstyledcontent.typoscript in the sitepackage so the setting is accessible in Fluid templates via {settings.sitepackage.cookieTool}:

lib.contentElement {
    settings {
        sitepackage {
            cookieTool = {$sitepackage.cookieTool}
        }
    }
}

Also define the empty default constant in Configuration/TypoScript/Constants/ext.teufels_sitepackage.typoscript:

sitepackage {
    cookieTool =
}

6. Configure Site Set settings

Add to Configuration/Sets/Sitepackage/settings.definitions.yaml in the sitepackage:

sitepackage.cookieTool:
  type: string
  default: ''
  enum:
    '': '(no consent tool)'
    cookiebot: 'Cookiebot'
    usercentrics: 'Usercentrics'

Select the desired consent tool in the TYPO3 backend under Site Management > Sites > [Site] > Sets > Sitepackage.

7. Add language keys to sitepackage locallang

Add to Resources/Private/Language/locallang.xlf and de.locallang.xlf:

video.cookiebot.please
video.cookiebot.accept
video.cookiebot.towatch

8. Behaviour after migration

Scenario	Result
`cookieTool = ''`	Videos are embedded directly
`cookieTool = cookiebot`	YouTube/Vimeo: `src` becomes `data-cookieblock-src`, `data-cookieconsent="marketing"` is set; fallback block visible until consent is given
`cookieTool = usercentrics`	YouTube/Vimeo: `src` becomes `uc-src`; UC renders its own overlay automatically
Local videos (mp4/webm)	Always embedded directly – no consent needed

Changelog

1.2.1

[DOCS] Added migration guide for TYPO3 v14 (replacement via traw/video-vtt + sitepackage integration)

1.2.0

[FEATURE] update dependency 'hauerheinrich/hh-video-extender' to ^0.4

1.1.1

[FEATURE] implement (Site) Sets configuration

1.1.0

[BREAKING] setting plugin.tx_hhvideoextender.settings.cookieTool has to moved from TypoScript/Setup to TypoScript/Constants
[CHANGE] add support for TYPO3 v13

1.0.0

[Initial] intial from hive_ovr_hhvideoextender

Conflict

usage of TypoScript default previewImage may not work

teufels / hhvideoextender-extended

Maintainers

Package info

Statistics

Security