DSGVO-konforme YouTube Videos

New Features:

• Now available as Code Snippet, Include, and Plugin with automatic update check.
  For snippet or include, checks for updates every 12 hrs (same frequency used by WP for plugin updates),
  and shows update notice in admin area, dismissible for 12 hrs. Can also be checked manually on the Settings page.
  For plugin, WordPress standard update mechanism is used.
• Settings > MA GDPR Youtube
  • Manage the video cache (thumbnails and meta data retrieved from YouTube):
    Cache can be deleted or refreshed from YouTube.
  • Configure presets values for shortcode parameters

Changes:

• Predefined GDPR texts for different languages
  Now handle the privacy policy term in curly brackets instead of %s placeholder plus
  separate term. This simplifies editing the texts on the settings page.
  Caution! Old syntax (%s placeholder plus separate term) is not supported anymore.
  If you used the $GLOBALS method to define GDPR texts, this must be adapted to the new format.
• Languages:
  Use locale (e.g. de-DE) instead of slug (e.g. de) for YouTube requests to retrieve
  translated titles more reliably. Use dash instead of underscore for locale.
  Use site language as fallback if current language not available (e.g. when saving
  Gutenberg content)
• Error handling and logging:
  • Added more specific error messages for different failure points (e.g. thumbnail
    retrieval, video info retrieval, parsing errors)
  • Logging request URL and video ID for failed YouTube requests to identify
    problematic videos.
  • If basic video data (title, author, thumbnail, duration) is empty after retrieval
    from YouTube, the video is considered as unavailable, and an error message is shown.
  • Handling non-existing manual thumbnails:
    If a manual thumbnail is specified but not found, fall back to YouTube thumbnails
• Added proper html and attribute escaping, and using kses for attributes that allow HTML (title, gdpr-text)
• Changed shortcode parameter 'priority' (boolean) to 'thumbnail-loading' (lazy or eager with fetchfiority=high).
• Storage of YouTube HTML response must now manually be activated via $yt_store_response
• Requests to YouTube now send Client Hints (Sec-CH-UA...) to improve bypassing YouTube restrictions.

Fixes:

• Added width/height attributes to SVG symbol definition, to avoid a gap at the page end in Bricks Builder.
  That gap was caused by a Bricks CSS rule to set a min-width/height for <svg> without width/height attributes.
  (Thanks to Stephen Vaughan for reporting!)

Changes:

• get_current_language() can now return slug (de) and locale (de-DE) language codes.
  Locale is used for YouTube requests to retrieve translated titles more reliably.
• Stored HTML response from YouTube now also contains request and response headers
  as comments.

Fixes:

• Corrected thumbnailUrl parse pattern

Changes:

• HTML Response from YouTube is now always stored to allow analysis.
  Therefore, cache folder is created directly after retrieval of response, also if an error occurred during parsing.
• Description and keywords from meta itemprop, fallback meta name, to prioritize video info over page info.
  For keywords read from itemprop, adding spaces after commas.

New Features:

• More details retrieved from YouTube: Canonical video URL, Thumbnail URL, Author details (name, profile URL), Duration (in seconds and h:m:s format)
• New related tags for title, alt, title-text attributes: @author_name@, @author_url@, @duration_hms@
• Microdata (<meta itemprop...>) added to video wrapper div for better SEO.
  (Thanks to Hubertus Pohlmann for the suggestion)
  Please note that the original props from YouTube are used, not the custom ones, like customized title.

Changes:

• Skipping retrieval of video details if the video ID is shorter than 11 characters to avoid creating invalid video folders and JSON files.
  This is especially important for Bricks Builder, which executes shortcodes while still typing in the editor.
• When downloading details from YouTube, the snippet version is stored in the JSON file.
  This allows to check if the JSON (and thus video details) are retrieved and parsed with an older version of the snippet, and should be retrieved again to assure all details are available.
• Thumbnails are now retrieved using cURL instead of file_get_contents to avoid the requirement for allow_url_fopen.
  (Thanks to Roland Laich for the suggestion)
• Replaced error suppression (@ operator) with try-catch

New features:

• New shortcode parameter "priority" (0/1) to control the loading behavior of the video thumbnail, e.g. if video is placed above the fold.
  priority=0: loading="lazy" (default)
  priority=1: loading="eager" fetchpriority="high"
  (Thanks to Tobias Haas for the feature request)

(This version hasn't been published officially)

Fixes:

• Replace "u0026" with "&amp;" in YouTube video title.
  (Thanks to Tobias Haas for reporting)
  >> Video folder in /wp-content/uploads/ma-gdpr-youtube/ must be deleted manually to re-trigger video metadata retrieval and storage.

Changes:

• Retrieval of video details now uses cURL for better handling of YouTube responses.
  (Thanks to Oscar Obianenue for reporting and supporting analysis and tests)

Fixes:

• Fixed missing styling of video preview (play button, GDPR text) in Bricks builder.

Changes:

• Added width and height attributes for thumbnail images
• Player observer now handles fullscreen correctly
  (Thanks to Michael Herceg for reporting)

Reorganization of code base.

New Features:

• For better accessibility, the Enter key can now be used to start and stop videos.
  (Thanks to Stephan Koenigk for his feature request and pre-release tests)
• alt, title and title-text now support placeholders @title@ and @description@, language specific, if available. The use of @ is deprecated.

Changes:

• For invalid IDs, don't create directory, store json, attempt to retrieve thumbnails
• In Builders Bricks and Oxygen, click handler is deactivated to allow selecting element
• Preparation for Bricks Element. Coming soon.

New Features:

• Complete rebuild of JS
• Video player management via players registry and observer
  • Pause current video if another one is started
  • Pause video if modal/popup closed (evaluated by visibility of parent DOM element)
• Support for dynamically embedded videos using AJAX calls:
  • Removed init prevention for AJAX calls
  • Added PHP method MA_GDPR_YouTube::enable_footercode() to trigger output of footer code (styles, scripts, svg) for video embeds dynamically loaded by AJAX calls
  • Play click handler is now assigned as onclick event instead of collecting all videos after page load. This eliminates the need for an extra click handler initialization for players dynamically loaded after page load.
• Optimizations for accessibility

Fixes

• Prefixed wrapper/player IDs with snippet slug to prevent IDs starting with number
• Fallback for aspect ratio via padding-top (CSS variable, @supports rule) for older browsers not supporting aspect-ratio like Safari < V15

Changes:

• Changed debug URL switch from "debug" to "ma-gdpr-youtube-debug" to avoid conflicts
• Changed cache folder name from ma-gdpr-youtube-thumbnails to ma-gdpr-youtube incl. renaming

New Features:

• Title of the video is now automatically retrieved from YouTube and stored locally.
  Request to YouTube is made using the current language to retrieve translated title if available. Titles are stored per language. So only one request per video and language.
  Title from YouTube can be displayed using parameter title-text="@".
  Title from YouTube can also be used as alt="@" and title="@" for the thumbnail.
• Shortcode attributes title-text, gdpr-text now allow HTML (e.g. for bold, links, ...)

Fixes:

• If video is played in a modal (Oxygen, Bricks), don't restart video after closing modal.
  Implemented via visibility check in onReady event.
  (Requested by Manuel Mochkal)

Changes:

• Added compatibility check for allow_url_fopen. Must be On for the snippet to work.
• Thumbnail size is now based on width and aspect-ratio instead of calculated height.
• Changed JS function variable from ytVidPlay to ma_gdpr_youtube_ytVidPlay

New Features:

• Added parameter "video" with parsing of YouTube URL variants
• Added global configuration via $GLOBALS['ma_gdpr_youtube']
• Added Finnish translations for GDPR text
  (Thanks to Thao Le)

New Features:

• Added Japanese translations for GDPR text
  (Thanks to Viorel-Cosmin Miron)
• Added support for WPML
  (Thanks to Viorel-Cosmin Miron)
  Please note there's a WPML bug preventing the creation a policy link with correct language.
  (https://wpml.org/forums/topic/get_the_privacy_policy_link-should-be-translated/#post-8153387)

Changes:

• Migrated JavaScript from jQuery to vanilla JS (ES6) to eliminate jQuery dependency.

Fixes:

• Changed init skip for JSON calls (introduced in 1.1.0) to allow rendering in Oxygen Builder

New Features:

• Added new shortcode parameters title-text, title-class, title-style for title overlay
• Added new shortcode parameters notice-class, notice-style for GDPR text banner
• Added new shortcode parameters play-button, play-button-color, play-button-style for button variations

Fixes:

• Added original image size to source set for custom thumbnail by ID
• Removed double '.' for German GDPR text.
  (Thanks to Tobias Maximilian Hietsch for reporting)
• Removed excess trailing comma at sprintf arguments
  (Thanks to Nils Bäßler for reporting)

New Features:

• Support for webp thumbnail image format
  (Requested by Artur Gilbert, Yan Kiara)
• Added lazy loading for thumbnail images
  (Requested by Yan Kiara)
• Support for additional YouTube player parameters (e.g. modestbranding=1)
  (Requested by Lau Fa)
• Added Dansk translations for GDPR text
  (Thanks to Theis L. Soelberg)
• Added shortcode parameters alt and title for thumbnail image
  (Thanks to Theis L. Soelberg)
• Added shortcode parameters thumbnail (URL or media ID)
  (Requested by Viorel-Cosmin Miron)
• Added width/height attributes for thumbnail images
  (Requested by Viorel-Cosmin Miron)
• Added JS console debugging by URL parameter "debug"

Fixes:

• Optimization of SVG symbol minimizing

New Features:

• Using scheme-less URL to avoid issues with wrong WordPress URL configuration
• Added parameter new-window to play video in a new window
• Added "_" to valid character check on video id
• Hide GDPR notice block if text is empty
• Load and cache YouTube thumbnails only on very first appearance of a new video ID to improve performance, if specific YouTube thumbnail sizes are not available

Fixes:

• Check for availability of specific thumbnail sizes (might not be available from YouTube)

Fix: Correction in Hungarian translation

Features:

• Added "-" to valid character check on video id (thanks to Zoltán Kőrösi)
• Added Hungarian GDPR text (thanks to Zoltán Kőrösi)

Fix: Check GET parameter "ct_builder" before accessing it

Feature: Add link to privacy policy to default gdpr text if configured in WordPress

Fix: Allow same video embedded multiple times

Initial Release