make oembed configurable for additional oembed parameters

Author: reflexxion

CHANGELOG.md

@@ -10,6 +10,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 - Ability to send settings to `CurlClient`. Added the `cookies_path` setting to customize the file used for cookies. #345
 - `Document::selectCss()` function to select elements using css selectors instead xpath (it requires symfony/css-selector)
 - `Document::removeCss()` function to remove elements using css selectors instead xpath (it requires symfony/css-selector)
+- Ability to configure OEmbed parameters from the outside
 
 ## 4.0.0 - 2020-03-13
 Full library refactoring.

src/OEmbed.php

@@ -13,6 +13,8 @@ class OEmbed
 
     private static $providers;
 
+    private array $queryParameters;
+
     private static function getProviders(): array
     {
         if (!is_array(self::$providers)) {
@@ -22,6 +24,23 @@ private static function getProviders(): array
         return self::$providers;
     }
 
+    public function addQueryParameters(array $queryParameters): self
+    {
+        return $this->setQueryParameters(array_merge($this->getQueryParameters(), $queryParameters));
+    }
+
+    public function setQueryParameters(array $queryParameters): self
+    {
+        $this->queryParameters = $queryParameters;
+
+        return $this;
+    }
+
+    public function getQueryParameters(): array
+    {
+        return $this->queryParameters ?? [];
+    }
+
     protected function fetchData(): array
     {
         $this->endpoint = $this->detectEndpoint();
@@ -63,7 +82,7 @@ private function detectEndpointFromProviders(): ?UriInterface
 
         return $this->extractor->getCrawler()
             ->createUri($endpoint)
-            ->withQuery(http_build_query(['url' => $url, 'format' => 'json']));
+            ->withQuery(http_build_query(array_merge(['url' => $url, 'format' => 'json'], $this->getQueryParameters())));
     }
 
     private static function searchEndpoint(array $providers, string $url): ?string