Add tag_handling optional param

Author: floranpagliai

src/DeepL.php

@@ -34,6 +34,11 @@ class DeepL
      */
     const API_URL_DESTINATION_LANG = 'target_lang=%s';
 
+    /**
+     * API v1 URL: Parameter tag_handling
+     */
+    const API_URL_TAG_HANDLING = 'tag_handling=%s';
+
     /**
      * DeepL HTTP error codes
      *
@@ -120,18 +125,19 @@ public function __destruct()
      * @param $text                string|string[]
      * @param $sourceLanguage      string
      * @param $destinationLanguage string
+     * @param $tagHandling         array
      *
      * @return string|string[]
      *
      * @throws DeepLException
      */
-    public function translate($text, $sourceLanguage = 'de', $destinationLanguage = 'en')
+    public function translate($text, $sourceLanguage = 'de', $destinationLanguage = 'en', array $tagHandling = [])
     {
         // make sure we only accept supported languages
         $this->checkLanguages($sourceLanguage, $destinationLanguage);
 
         // build the DeepL API request url
-        $url  = $this->buildUrl($sourceLanguage, $destinationLanguage);
+        $url  = $this->buildUrl($sourceLanguage, $destinationLanguage, $tagHandling);
         $body = $this->buildBody($text);
 
         // request the DeepL API
@@ -185,12 +191,15 @@ protected function checkLanguages($sourceLanguage, $destinationLanguage)
      *
      * @return string
      */
-    protected function buildUrl($sourceLanguage, $destinationLanguage)
+    protected function buildUrl($sourceLanguage, $destinationLanguage, $tagHandling)
     {
         $url = DeepL::API_URL . '?' . sprintf(DeepL::API_URL_AUTH_KEY, $this->authKey);
 
         $url .= '&' . sprintf(DeepL::API_URL_SOURCE_LANG, strtolower($sourceLanguage));
         $url .= '&' . sprintf(DeepL::API_URL_DESTINATION_LANG, strtolower($destinationLanguage));
+        if (!empty($tagHandling)) {
+            $url .= '&' . sprintf(DeepL::API_URL_TAG_HANDLING, implode(',', $tagHandling));
+        }
 
         return $url;
     }