From 2bd24850df06198eb38a92a7748a98bc3c18097f Mon Sep 17 00:00:00 2001
From: reganlawton <reganlawton92@gmail.com>
Date: Mon, 12 Aug 2024 17:22:33 +1000
Subject: [PATCH 1/4] chore: Registing plugin to test CDN build process

---
 src/Oembed.php | 30 +++++++++++++++++-------------
 1 file changed, 17 insertions(+), 13 deletions(-)

diff --git a/src/Oembed.php b/src/Oembed.php
index 3ce3a83..b6beec8 100644
--- a/src/Oembed.php
+++ b/src/Oembed.php
@@ -10,25 +10,26 @@
 
 namespace wrav\oembed;
 
-use wrav\oembed\events\BrokenUrlEvent;
-use wrav\oembed\fields\OembedField;
-use wrav\oembed\jobs\BrokenUrlNotify;
-use wrav\oembed\services\OembedService;
-use wrav\oembed\variables\OembedVariable;
-use wrav\oembed\models\Settings;
-
 use Craft;
+use craft\web\View;
+use yii\base\Event;
 use craft\base\Plugin;
+use craft\web\UrlManager;
+use craft\services\Fields;
+
 use craft\services\Plugins;
 use craft\events\PluginEvent;
-use craft\services\Fields;
-use craft\web\twig\variables\CraftVariable;
-use craft\events\RegisterComponentTypesEvent;
-use craft\web\View;
+use wrav\oembed\models\Settings;
+use wrav\oembed\fields\OembedField;
+use wrav\oembed\jobs\BrokenUrlNotify;
+use wrav\oembed\events\BrokenUrlEvent;
 use craft\events\RegisterUrlRulesEvent;
-use craft\web\UrlManager;
+use wrav\oembed\services\OembedService;
+use wrav\oembed\variables\OembedVariable;
+use craft\web\twig\variables\CraftVariable;
 
-use yii\base\Event;
+use craft\events\RegisterComponentTypesEvent;
+use wrav\oembed\assetbundles\oembed\OembedAsset;
 
 /**
  * @author    reganlawton
@@ -117,6 +118,9 @@ function (PluginEvent $event) {
             }
         );
 
+        // Register Assets
+        Craft::$app->getView()->registerAssetBundle(OembedAsset::class);
+
         Event::on(
             View::class,
             View::EVENT_END_PAGE,

From fb9c2faba90b722a8730441275e3f929602df044 Mon Sep 17 00:00:00 2001
From: reganlawton <reganlawton92@gmail.com>
Date: Mon, 12 Aug 2024 17:50:13 +1000
Subject: [PATCH 2/4] chore: Register the OembedAsset for all but Site requests

---
 src/Oembed.php | 19 +++----------------
 1 file changed, 3 insertions(+), 16 deletions(-)

diff --git a/src/Oembed.php b/src/Oembed.php
index b6beec8..52a62de 100644
--- a/src/Oembed.php
+++ b/src/Oembed.php
@@ -119,22 +119,9 @@ function (PluginEvent $event) {
         );
 
         // Register Assets
-        Craft::$app->getView()->registerAssetBundle(OembedAsset::class);
-
-        Event::on(
-            View::class,
-            View::EVENT_END_PAGE,
-            function(Event $event) {
-                if (Craft::$app->getRequest()->getIsCpRequest() && preg_match('/^\/.+\/entries\//', Craft::$app->getRequest()->getUrl())) {
-                    $url = Craft::$app->assetManager->getPublishedUrl('@wrav/oembed/assetbundles/oembed/dist/js/oembed.js', true);
-
-                    echo "<script src='$url'></script>";
-
-                    $url = Craft::$app->assetManager->getPublishedUrl('@wrav/oembed/assetbundles/oembed/dist/css/oembed.css', true);
-                    echo "<link rel='stylesheet' href='$url'>";
-                }
-            }
-        );
+        if (!Craft::$app->getRequest()->getIsSiteRequest()) {
+            Craft::$app->getView()->registerAssetBundle(OembedAsset::class);
+        }
 
         Event::on(
             UrlManager::class,

From 35913d04dae97d9bbd1fb803f47ddeec151dca54 Mon Sep 17 00:00:00 2001
From: reganlawton <reganlawton92@gmail.com>
Date: Mon, 9 Sep 2024 18:21:13 +1000
Subject: [PATCH 3/4] feat: Added additional fallback logic and added custom
 extractor support

---
 CHANGELOG.md                   | 70 ++++++++++++++++++++++++++++++++
 README.md                      | 11 ++++-
 composer.json                  |  2 +-
 src/adapters/EmbedAdapter.php  | 74 +++++++++++++++++++++++++++++++++-
 src/services/OembedService.php | 16 ++++++--
 5 files changed, 164 insertions(+), 9 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 65239c7..cdb0ea8 100755
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,23 +1,37 @@
 # oEmbed Changelog
 
+## 3.1.0 - 2024-07-09
+
+### Added
+
+- Added support for adapter extractor support to allow custom site handling
+
+### Update
+
+- Refactor EmbedAdapter to handle extractor object to support better fallback for some websites
+
 ## 3.0.9 - 2024-07-26
 
 ### Update
+
 - Resolves error when querying an entry with a empty oEmbed URL. Thanks to @jaapfaes for PR #157
 
 ## 3.0.8 - 2024-02-26
 
 ### Update
+
 - Resolved GraphQL issues. Special thanks to @davidwebca 
 
 ## 3.0.7 - 2023-12-15
 
 ### Update
+
 - Resolve YT loop issues. Reported by @holiday-jan in issue #146. Thanks @holiday-jan
 
 ## 3.0.6 - 2023-12-15
 
 ### Update
+
 - Fixed issue with src attribute not being set on iframe. Reported by @holiday-jan in issue #146. Thanks @holiday-jan
 - Rework preview handling
 - Updated README docs
@@ -26,101 +40,121 @@
 ## 3.0.5 - 2023-12-08
 
 ### Update
+
 - Modified handling of empty embedded media codes
 
 ## 3.0.4 - 2023-12-07
 
 ### Update
+
 - Adds version to cache key to prevent cache key collisions.
 
 ## 3.0.3 - 2023-12-04
 
 ### Update
+
 - Add GDPR compliance with CookieBot settings and functionality. Reported by @joepagan in issue #131. Thanks @joepagan and @iparr for discussion and logging.
 
 ## 3.0.2 - 2023-12-01
 
 ### Update
+
 - Add data mapping and fallback for image properties. Reported by @maxfenton in issue #143 and @helleholmsen in issue #145. Thanks @maxfenton and @helleholmsen
 
 ## 3.0.1 - 2023-11-17
 
 ### Update
+
 - Handle all exceptions in OembedService to prevent edge case errors. Reported by @holiday-jan in issue #141. Thanks @holiday-jan
 
 ## 3.0.0 - 2023-11-04
 
 ### Update
+
 - Update embed/embed to v4 to allow for support with newer plugins.
 
 ## 2.3.1 - 2023-10-11
 
 ### Update
+
 - Added fix for issue #138, caused by static return type on the JobInterface. Thanks @laurabennett
 - Added @sgtpenguin 's PR to avoid GraphQL bug by defaulting the height and width to NULL for the fallback adapter. Thanks @sgtpenguin
 
 ## 2.3.0 - 2023-02-02
 
 ### Update
+
 - Added default caching keys to resolve missing field data while cached
 
 ## 2.2.2 - 2022-08-26
 
 ### Update
+
 - Fix Craft 4 type compatibility. THANKS @raymondelooff
 
 ## 2.2.1 - 2022-06-30
 
 ### Update
+
 - Fix a side effect of #101 fix where the preview and embed will fallback to the default Craft site if no or invalid URL is provided (@juban)
 
 ## 2.2.0 - 2022-06-30
 
 ### Update
+
 - Converting DOMDocument to JSON and back to StdClass due to error "Serialization of 'DOMDocument' is not allowed" with caching in PHP 8.
 - Fixed `required` option not applying
 
 ## 2.1.0 - 2022-06-29
 
 ### Added
+
 - Added `ext-dom` requirement
 
 ### Updated
+
 - Fix for issue #101 for the v2 version track for Craft v4. Thanks again @juban
 
 ## 2.0.0 - 2022-06-18
 
 ### Updated
+
 - Updated plugin to support Craft v4
 - Removed requirement for Craft v3 and requiremnt is now PHP to >=8.0.2
 
 ## 1.3.15 - 2022-03-09
 
 ### Updated
+
 - Fix for issue #101, where the plugin is unable to set a webpage as a valid source URL. Thanks @juban
 
 ## 1.3.13 - 2021-10-21
 
 ### Added
+
 - Add referrer to Embed for videos with privacy restrictions.
 
 ### Updated
+
 - Changes to the handle of FallbackAdapter with no URL.
 - Preview changes
 
 ## 1.3.12 - 2021-08-05
 
 ### Added
+
 - Fix issue with blank URLs where fallback adapter sets URL to '/'. This also fixes #88 issue.
 
 ## 1.3.11 - 2021-07-21
 
 ### Added
+
 - Added fallback adapter for invalid URLs and PHP 8 issues, thanks [@gglnx](https://github.com/gglnx). This also fixes #81, #76 issues.
 
 ## 1.3.10 - 2021-07-20
 
 ### Updated
+
 - Fixes issue with caching key, thanks [@mijewe](https://github.com/mijewe).
 - Fixes to 'class@anonymous' handling, this should help resolve issues [#81](https://github.com/wrav/oembed/issues/81), [#50](https://github.com/wrav/oembed/issues/50), [#10](https://github.com/wrav/oembed/issues/10).
 - Updated CHANGELOG dates.
@@ -128,179 +162,215 @@
 ## 1.3.9 - 2021-06-16
 
 ### Updated
+
 - Fixes issue with `params` option not applying if query / GET params not yet set, this resolves issues [#53](https://github.com/wrav/oembed/issues/53).
 
 ## 1.3.8 - 2021-06-15
 
 ### Updated
+
 - Fixes issue with code changes due to PHP namespacing.
 - Updates to caching key to support embed options, this resolves issues [#73](https://github.com/wrav/oembed/issues/73). 
 
 ## 1.3.7 - 2021-06-15
 
 ### Updated
+
 - Updates to OembedModel / GraphQL bugfixes, this resolves issues [#74](https://github.com/wrav/oembed/issues/74) and PR [#75](https://github.com/wrav/oembed/issues/75). Thank you to @joshuabaker, @denisyilmaz and anyone else I missed. 
 - Clean up bugfixes changes
 
 ## 1.3.6 - 2020-10-28
 
 ### Added
+
 - Added new render option called `attributes` to allow custom attributes to bet added to iframe element, this resolves issue ([#51](https://github.com/wrav/oembed/issues/51)).
 
 ## 1.3.5 - 2020-10-28
 
 ### Updated
+
 - Add settings-input for Facebook/Instagram access token. Thanks Floris aka @FlorisDerks
 
 ## 1.3.4 - 2020-06-29
 
 ### Updated
+
 - Fix to normalizeValue function on GraphQL field's `__get()` magic method. Thanks @joshuabaker
 
 ## 1.3.3 - 2020-06-29
 
 ### Updated
+
 - Fix to GraphQL bug caused by PHP NULL coalescing operator from issue ([#46](https://github.com/wrav/oembed/issues/46)).
 
 ## 1.3.2 - 2020-06-05
 
 ### Updated
+
 - Fixed GraphQL bug `Internal Server Error: GraphQL fails to get oembed fields` ([#46](https://github.com/wrav/oembed/issues/46)).
 
 ## 1.3.1 - 2020-05-08
 
 ### Added
+
 - *(NEW FEATURE)* Added GDPR setting to transform URL's for Youtube and Vimeo to their GDPR versions. This happen's without needing to change existing URL's.
 
 ## 1.3.0 - 2020-03-05
 
 ### Added
+
 - *(NEW FEATURE)* Added setting to hide preview iframe in the new a collapsable UI component.
 - *(NEW FEATURE)* Added notification by email for broken URLs which can be set up in plugin settings. This feature is still under development and new feature's like Slack, Microsoft Team notification channels will be added including support to update the notify message copy.
 
 ### Updated
+
 - Preview iframe is now rendered into a collapsable component to save space.
 - Add `overflow:hidden` to iframe to prevent overflow ([#37](https://github.com/wrav/oembed/issues/37)).
 
 ## 1.2.5 - 2020-02-10
 
 ### Updated
+
 - Allow users to set width and height on the iframe ([#35](https://github.com/wrav/oembed/issues/35)).
 
 ## 1.2.4 - 2020-02-05
 
 ### Updated
+
 - Removed package dependacy to get PHP 7.0-compatible ([#33](https://github.com/wrav/oembed/issues/33))
 
 ## 1.2.3 - 2020-02-05
 
 ### Fixed
+
 - Fixed "Upgrading to 1.2.0+ disables admin UI ([#32](https://github.com/wrav/oembed/issues/32))" bug caused by LibXML rendering self closing `iframe`.
 
 ## 1.2.2 - 2020-01-30
 
 ### Updated
+
 - Updated README with usage of new feature.
 
 ### Added
+
 - *(NEW FEATURE)* Add new `params` option to allow you to set missing URL query params that are supported by the providers oembed protocol. ([#24](https://github.com/wrav/oembed/issues/24) & [#30](https://github.com/wrav/oembed/issues/30))
 
 ## 1.2.1 - 2020-01-19
 
 ### Updated
+
 - Re-add `rel` feature missing due to merge conflict. ([#24](https://github.com/wrav/oembed/issues/24))
 
 ## 1.2.0 - 2020-01-19
 
 ### Updated
+
 - Support `rel` URL propety via DOM manipulation. ([#24](https://github.com/wrav/oembed/issues/24))
 - Added GraphQL support. ([#25](https://github.com/wrav/oembed/issues/25))
 - Updated docs
 
 ### Fixed
+
 - Fixed "Undefined index: autoplay" warnings. ([#26](https://github.com/wrav/oembed/issues/26))
 
 ## 1.1.8 - 2019-09-16
 
 ### Updated
+
 - Support Youtube and Vimeo `autoplay`, `loop` and `autopause` embed feature via DOM manipulation. ([#14](https://github.com/wrav/oembed/issues/14))
 
 ### Fixed
+
 - Array to string conversion bug due to lack of a recursive function. ([#17](https://github.com/wrav/oembed/issues/17))
 
 ## 1.1.7 - 2019-09-16
 
 ### Updated
+
 - Support custom control panel (`cpTrigger`) configurations.
 
 ## 1.1.6 - 2019-04-22
 
 ### Updated
+
 - Caching is now a field you enable in new settings area.
 
 ## 1.1.5 - 2019-04-15
 
 ### Updated
+
 - Updated to prevent <script/> rendering outsite `/admin/entries`, with support if `admin` isn't the CP URL trigger.
 
 ## 1.1.4 - 2019-04-04
 
 ### Updated
+
 - Updated to allow better support for sites which don't quite meet the oEmbed format requirements. 
 
 ## 1.1.3 - 2019-03-29
 
 ### Added
+
 - Added `valid` method to handle errors gracefully (Thanks @iparr). 
 - Added data caching for parsed URLs to help increase page response time. 
 
 ### Updated
+
 - Updated docs. 
 
 ## 1.1.2 - 2019-02-18
 
 ### Updated
+
 - Version bump.
 
 ## 1.1.1 - 2019-02-18
 
 ### Updated
+
 - Fix bug in field type rendering.
 
 ## 1.1.0 - 2019-03-13
 > {note} The plugin’s dependence has changed from `essence/essence` to `embed/embed`. After updating to oEmbed 1.1.0 or later, make sure you reference to the README and test your site for possible missing/ renamed twig object keys.
 
 ### Updated
+
 - Updated composer package `essence/essence` to `embed/embed` to handle more edge case URLs.
 
 ## 1.0.5 - 2019-02-08
 
 ### Updated
+
 - Fix bug where field is in Matrix field and the AJAX event action isn't bound / fired until after entry initial saved
 
 ## 1.0.4 - 2019-01-17
 
 ### Updated
+
 - Allowing support for CraftCMS v3.1
 
 ## 1.0.3 - 2018-12-07
 
 ### Updated
+
 - Prevent JS asset rendering on frontend
 - Revert javascript to use jQuery
 
 ## 1.0.2 - 2018-12-06
 
 ### Updated
+
 - Refactored javascript to use native JS over jQuery
 
 ## 1.0.1 - 2018-11-26
 
 ### Updated
+
 - Changed preview controller action access to prevent anonymous access
 - Refactored the preview action to use a template with wrapper to allow for future styling and updates
 
 ## 1.0.0 - 2018-11-18
 
 ### Added
+
 - Initial release and migration from previous project
diff --git a/README.md b/README.md
index f3367a7..bb7d290 100755
--- a/README.md
+++ b/README.md
@@ -28,8 +28,15 @@ A simple plugin to extract media information from websites, like youtube videos,
 
 This plugin requires Craft CMS 3.0.0-beta.23 or later.
 
-If use are looking for CraftCMS 2.5 support use previous project [version 1.0.4](https://github.com/hut6/oembed/tree/1.0.4) 
-which is the latest release for CraftCMS 2.5.
+If use are looking for CraftCMS 2.5 support use previous project [version 1.0.4](https://github.com/hut6/oembed/tree/1.0.4), which is the latest release for CraftCMS 2.5.
+
+## Quick FYI on URL issues
+
+Many websites, such as Vimeo, are restricting access to standard URLs (e.g. www.vimeo.com) and sometimes require using the embed URL (e.g., player.vimeo.com) to retrieve oEmbed data.
+
+You can typically find the embed URL through the "share" options on video and oEmbed-supported sites. While the plugin provides general rich content as a fallback, its true potential comes from utilizing the oEmbed protocol and the associated metadata from the content provider.
+
+If you're experiencing issues, check whether the provider or page offers an embed version, and use that URL to ensure you're accessing the most accurate data.
 
 ## Installing
 
diff --git a/composer.json b/composer.json
index ffb7134..ccc4cfd 100755
--- a/composer.json
+++ b/composer.json
@@ -2,7 +2,7 @@
     "name": "wrav/oembed",
     "description": "A simple plugin to extract media information from websites, like youtube videos, twitter statuses or blog articles.",
     "type": "craft-plugin",
-    "version": "3.0.9",
+    "version": "3.1.0",
     "keywords": [
         "craft",
         "cms",
diff --git a/src/adapters/EmbedAdapter.php b/src/adapters/EmbedAdapter.php
index 9a6c3f6..840885d 100755
--- a/src/adapters/EmbedAdapter.php
+++ b/src/adapters/EmbedAdapter.php
@@ -13,10 +13,42 @@
 class EmbedAdapter
 {
     public $data = [];
-
-    public function __construct($data)
+    private $extractorData;
+
+    /**
+     * @param mixed $data The data to be mapped to the EmbedAdapter object
+     * @param \Embed\Extractor $extractorData The extractor data to be used as a fallback
+     * 
+     * @var string $title The title of the media
+     * @var string $description The description of the media
+     * @var string $url The url of the media
+     * @var string $type The type of the media
+     * @var array $tags The tags of the media
+     * @var string $images The images of the media
+     * @var string $image The image of the media
+     * @var int $imageWidth The width of the image
+     * @var int $imageHeight The height of the image
+     * @var string $code The code of the media
+     * @var int $width The width of the media
+     * @var int $height The height of the media
+     * @var float $aspectRatio The aspect ratio of the media
+     * @var string $authorName The author name of the media
+     * @var string $authorUrl The author url of the media
+     * @var string $providerName The provider name of the media
+     * @var string $providerUrl The provider url of the media
+     * @var array $providerIcons The provider icons of the media
+     * @var string $providerIcon The provider icon of the media
+     * @var string $publishedDate The published date of the media
+     * @var string $license The license of the media
+     * @var array $linkedData The linked data of the media
+     * @var array $feeds The feeds of the media
+     * 
+     * @return void
+     */
+    public function __construct($data, \Embed\Extractor $extractorData = null)
     {
         $this->data = $data;
+        $this->extractorData = $extractorData;
 
         // Map the data to the EmbedAdapter object properties for easy access
         $defaultKeys = [
@@ -50,6 +82,25 @@ public function __construct($data)
             $keyName = strtolower(preg_replace('/(?<!^)[A-Z]/', '_$0', $key));
 
             $this->$key = $this->data[$keyName] ?? null;
+
+            // Try to get the value from the extractorData first and fallback to the oembed data array
+            if($this->$key === null && $this->extractorData) {
+                try {
+                    $this->$key = $this->extractorData->$key;
+
+                    // If the value is an stringable object, convert it to a string
+                    if($this->$key !== null && is_object($this->$key) && method_exists($this->$key, '__toString')) {
+                        $this->$key = (string) $this->$key;
+                    }
+                } catch (\Exception $e) {
+                    // Do nothing if the property doesn't exist
+                }
+            }
+        }
+
+        // Get linkedData from the extractorData if it's not set
+        if($key === 'linkedData' && $this->extractorData && $this->linkedData === null) {
+            $this->linkedData = $this->extractorData->getLinkedData()->all();
         }
 
         // Fallback for .code incase it's empty
@@ -91,6 +142,25 @@ public function __construct($data)
                 $this->imageHeight = $this->data['thumbnail_height'] ?? null;
             }
         }
+
+        // Set width, height and aspect ratio from the extractorData code object, if they are not set
+        try {
+            $codeObject = $this->extractorData->code;
+
+            if($codeObject && $this->width === null) {
+                $this->width = $codeObject->width;
+            }
+
+            if($codeObject && $this->height === null) {
+                $this->height = $codeObject->height;
+            }
+
+            if($codeObject && $this->ratio === null) {
+                $this->aspectRatio = $codeObject->ratio;
+            }
+        } catch (\Exception $e) {
+            // Do nothing if the property doesn't exist
+        }
     }
 
     public function __call(string $name, array $arguments)
diff --git a/src/services/OembedService.php b/src/services/OembedService.php
index fb99d3b..98ab204 100755
--- a/src/services/OembedService.php
+++ b/src/services/OembedService.php
@@ -13,10 +13,8 @@
 use craft;
 use craft\base\Component;
 use craft\helpers\Template;
-use craft\helpers\UrlHelper;
 use DOMDocument;
 use Embed\Embed;
-use Embed\Http\CurlDispatcher;
 use Exception;
 use wrav\oembed\adapters\EmbedAdapter;
 use wrav\oembed\adapters\FallbackAdapter;
@@ -61,7 +59,7 @@ public function render($url, array $options = [], array $cacheProps = [])
      * @param array $options
      * @return Media|string
      */
-    public function embed($url, array $options = [], array $cacheProps = [])
+    public function embed($url, array $options = [], array $cacheProps = [], $factories = [])
     {
         $plugin = Craft::$app->plugins->getPlugin('oembed');
 
@@ -85,13 +83,23 @@ public function embed($url, array $options = [], array $cacheProps = [])
             array_multisort($options);
 
             $embed = new Embed();
+        
+            // Add custom factories
+            if (count($factories) > 0) {
+                foreach ($factories as $factory) {
+                    $embed->getExtractorFactory()->addAdapter($factory['domain'], $factory['extractor']::class);
+                }
+            }
+
             $infos = $embed
                 ->get($url ?: "")
             ;
+
             $infos->setSettings($options);
+            
             $data = $infos->getOEmbed()->all();
 
-            $media = new EmbedAdapter($data);
+            $media = new EmbedAdapter($data, $infos);
         } catch (Exception $e) {
             Craft::info($e->getMessage(), 'oembed');
 

From 5aee9e7b8ae72ca803bfac4b48735dfad6dabd0a Mon Sep 17 00:00:00 2001
From: reganlawton <reganlawton92@gmail.com>
Date: Mon, 9 Sep 2024 19:16:24 +1000
Subject: [PATCH 4/4] feat: Add version information to README.md

---
 README.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/README.md b/README.md
index bb7d290..128b538 100755
--- a/README.md
+++ b/README.md
@@ -30,6 +30,16 @@ This plugin requires Craft CMS 3.0.0-beta.23 or later.
 
 If use are looking for CraftCMS 2.5 support use previous project [version 1.0.4](https://github.com/hut6/oembed/tree/1.0.4), which is the latest release for CraftCMS 2.5.
 
+## Versions
+
+| Version | CraftCMS Version       | Embed Version | PHP Version   | Branch                          | Status        |
+|---------|------------------------|---------------|---------------|---------------------------------|---------------|
+| v1      | ^3.0.0-beta.23          | ^3.3          | >=7.2.5       | [v1](https://github.com/wrav/oembed/tree/v1) | Discontinued  |
+| v2      | ^4.0                    | ^3.3          | ^8.0.2        | [v2](https://github.com/wrav/oembed/tree/v2) | Discontinued  |
+| v3      | ^3.0 \| ^4.0 \| ^5.0    | ^v4.4         | ^8.2          | [v3](https://github.com/wrav/oembed/tree/v3) | Active        |
+| dev-v3-php74-support | ^3.0 \| ^4.0 \| ^5.0 | ^v4.4         | ^7.4          | [dev-v3-php74-support](https://github.com/wrav/oembed/tree/dev-v3-php74-support) | Active (PHP 7.4 Support) |
+◊
+
 ## Quick FYI on URL issues
 
 Many websites, such as Vimeo, are restricting access to standard URLs (e.g. www.vimeo.com) and sometimes require using the embed URL (e.g., player.vimeo.com) to retrieve oEmbed data.