Skip to content

Latest commit

 

History

History
54 lines (41 loc) · 1.73 KB

VideoEmbedPrivacy.md

File metadata and controls

54 lines (41 loc) · 1.73 KB
Raw

<- back

Improved privacy for embedded videos

Before videos from the platforms YouTube and Vimeo are actually loaded, the user is asked for consent. This improves the privacy and as an additional benefit also the loading time.

Configuration

The template used to show the overlay can be configured with an additional setting of the ViewHelper <f:media />.

Since the versions 8.7.14 and 7.6.28 the ViewHelper call in fluid_styled_content looks like this:

<f:media class="video-embed-item" file="{file}" `
    width="{dimensions.width}" height="{dimensions.height}" 
    alt="{file.alternative}" title="{file.title}" 
    additionalConfig="{settings.media.additionalConfig}" />

This allows to override the template with the following TypoScript:

lib.contentElement {
    settings {
        media {
            additionalConfig {
                gdpr-vimeo-template = EXT:sitepackage/Resources/Private/Templates/Gdpr/Vimeo.html
                gdpr-youtube-template = EXT:sitepackage/Resources/Private/Templates/Gdpr/Youtube.html
            }
        }
    }
}

Usage in custom extensions

If the <f:media /> is used in custom extensions, use a configuration like additionalConfig="{settings.mediaConfiguration}" and a TS like

plugin.tx_yourExt {
    settings {
        mediaConfiguration {
            gdpr-vimeo-template = EXT:sitepackage/Resources/Private/Templates/Gdpr/Vimeo.html
            gdpr-youtube-template = EXT:sitepackage/Resources/Private/Templates/Gdpr/Youtube.html
        }
    }
}

Templates

The templates (default can be found at EXT:gdpr/Resources/Private/Templates/Rendering/ contain the styling and vanilla JS for exchanging the overlay with the actual video iframe.