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.

README.md

@@ -167,6 +167,16 @@ $oembed->int('width'); //Return the value as integer
 $oembed->url('url'); //Return the value as full url (converts relative urls to absolutes)
 ```
 
+Additional oEmbed parameters (like instagrams `hidecaption`) can also be provided:
+```php
+$embed = new Embed();
+$info = $embed->get('https://www.instagram.com/p/B_C0wheCa4V/');
+$oembed = $info->getOEmbed();
+$oembed->setQueryParameters(['hidecaption' => true]);
+
+$oembed->all();
+```
+
 ## LinkedData
 
 Another API available by default, used to extract info using the [JsonLD](https://www.w3.org/TR/json-ld/) schema.
@@ -247,7 +257,7 @@ The `Extractor` class has many `Detectors`. Each detector is responsible to dete
 
 So, an adapter is basically an extractor created specifically for a site. It can contains also custom detectors or apis. If you see the `src/Adapters` folder you can see all adapters.
 
-If you create an adapter, you need also register to Embed, so it knows in which website needs to use. To do that, there's the `ExtractorFactory` object, that is responsible for instantiate the right extractor for each site. 
+If you create an adapter, you need also register to Embed, so it knows in which website needs to use. To do that, there's the `ExtractorFactory` object, that is responsible for instantiate the right extractor for each site.
 
 ```php
 use Embed\Embed;

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