j1-template 2021.2.0 → 2021.2.4

data/assets/themes/j1/modules/carousel/css/theme/uno.css

@@ -51,7 +51,7 @@ padding-left: 1px;
 }
 
 .slider-title {
-  color: #212121;
+  /* color: #424242; */
   line-height: 1.25rem;
   font-size: 1.125rem;
   font-weight: 500;

data/assets/themes/j1/modules/carousel/css/theme/uno.min.css

@@ -12,4 +12,4 @@
  # See: https://github.com/jekyll-one-org/J1 Template/blob/master/LICENSE
  # -----------------------------------------------------------------------------
 */
-.j1-owl-gutter.row{margin-right:0;margin-left:0}.j1-owl-gutter>[class^="col-"],.j1-owl-gutter>[class^=" col-"]{padding-right:0;padding-left:0}.j1-owl-gutter-2.row{margin-right:-1px;margin-left:-1px}.j1-owl-gutter-2>[class^="col-"],.j1-owl-gutter-2>[class^=" col-"]{padding-right:1px;padding-left:1px}.owl-carousel .item p{margin:3px}.owl-carousel .item img{opacity:1;width:100%;height:auto}.slider-title{color:#212121;line-height:1.25rem;font-size:1.125rem;font-weight:500;margin-bottom:.5rem}.owl-item .carousel-caption{opacity:0;position:absolute;bottom:3px;left:3px;right:3px;color:white;font-size:1rem;font-weight:300;font-family:sans-serif;z-index:10;padding-top:20px;padding-bottom:20px;color:#fff;text-align:center}.owl-item .carousel-caption:hover{opacity:1;-webkit-transition:opacity 500ms;-moz-transition:opacity 500ms;-o-transition:opacity 500ms;transition:opacity 500ms;background:rgba(0,0,0,0.5)}span.carousel-caption a{color:#fff;text-decoration:none}.owl-btn{color:#777;cursor:pointer;font-size:18px;padding:2px 9px;text-align:center;background:#f5f5f5}.owl-btn:hover{color:#fff;background:#72c02c}.owl-theme .owl-controls{margin-top:10px;text-align:center}.owl-theme .owl-controls .owl-buttons div{color:#212121;display:inline-block;zoom:1;margin:5px;padding:3px 10px;font-size:12px;font-weight:500;-webkit-border-radius:30px;-moz-border-radius:30px;background:#2196f3}.owl-theme .owl-controls.clickable .owl-buttons div:hover{opacity:1;text-decoration:none}.owl-theme .owl-controls .owl-page{display:inline-block;zoom:1}.owl-theme .owl-controls .owl-page span{display:block;width:1.25rem;height:1.25rem;margin:5px 7px;filter:Alpha(Opacity=50);opacity:.5;-webkit-border-radius:20px;-moz-border-radius:20px;border-radius:20px;background:#2196f3}.owl-theme .owl-controls .owl-page.active span,.owl-theme .owl-controls.clickable .owl-page:hover span{opacity:1}.owl-theme .owl-controls .owl-page span.owl-numbers{height:auto;width:auto;color:#FFF;padding:2px 10px;font-size:12px;-webkit-border-radius:30px;-moz-border-radius:30px;border-radius:30px}.owl-item.loading{min-height:150px;background:url(../../images/ajax-loader.gif) no-repeat center center}.owl-carousel .item{height:44vh;background-color:#fff;background-position:center 55%;-webkit-background-size:cover;-moz-background-size:cover;-o-background-size:cover;background-size:cover}.owl-carousel .container{display:table;height:inherit}.owl-carousel .caption{display:table-cell}.owl-carousel .caption h1,.owl-carousel .caption p,.owl-carousel .caption div{position:relative}.owl-carousel .caption h1 span{padding:.25em 0;line-height:180%}
+.j1-owl-gutter.row{margin-right:0;margin-left:0}.j1-owl-gutter>[class^="col-"],.j1-owl-gutter>[class^=" col-"]{padding-right:0;padding-left:0}.j1-owl-gutter-2.row{margin-right:-1px;margin-left:-1px}.j1-owl-gutter-2>[class^="col-"],.j1-owl-gutter-2>[class^=" col-"]{padding-right:1px;padding-left:1px}.owl-carousel .item p{margin:3px}.owl-carousel .item img{opacity:1;width:100%;height:auto}.slider-title{line-height:1.25rem;font-size:1.125rem;font-weight:500;margin-bottom:.5rem}.owl-btn{color:#777;cursor:pointer;font-size:18px;padding:2px 9px;text-align:center;background:#f5f5f5}.owl-btn:hover{color:#fff;background:#72c02c}.owl-theme .owl-controls{margin-top:10px;text-align:center}.owl-theme .owl-controls .owl-buttons div{color:#212121;display:inline-block;zoom:1;margin:5px;padding:3px 10px;font-size:12px;font-weight:500;-webkit-border-radius:30px;-moz-border-radius:30px;background:#2196f3}.owl-theme .owl-controls.clickable .owl-buttons div:hover{opacity:1;text-decoration:none}.owl-theme .owl-controls .owl-page{display:inline-block;zoom:1}.owl-theme .owl-controls .owl-page span{display:block;width:1.25rem;height:1.25rem;margin:5px 7px;filter:Alpha(Opacity=50);opacity:.5;-webkit-border-radius:20px;-moz-border-radius:20px;border-radius:20px;background:#2196f3}.owl-theme .owl-controls .owl-page.active span,.owl-theme .owl-controls.clickable .owl-page:hover span{opacity:1}.owl-theme .owl-controls .owl-page span.owl-numbers{height:auto;width:auto;color:#FFF;padding:2px 10px;font-size:12px;-webkit-border-radius:30px;-moz-border-radius:30px;border-radius:30px}.owl-item.loading{min-height:150px;background:url(../../images/ajax-loader.gif) no-repeat center center}.owl-carousel .container{display:table;height:inherit}.owl-carousel .caption{display:table-cell}.owl-carousel .caption h1,.owl-carousel .caption p,.owl-carousel .caption div{position:relative;margin-top:2rem;margin-right:2rem;margin-left:2rem}.owl-carousel .caption h1 span{padding:.25em 0;line-height:180%}.owl-item .carousel-caption{opacity:0;position:absolute;bottom:3px;left:3px;right:3px;color:white;font-size:1rem;font-weight:300;font-family:sans-serif;z-index:10;padding-top:20px;padding-bottom:20px;color:#fff;text-align:center}.owl-item .carousel-caption:hover{opacity:1;-webkit-transition:opacity 500ms;-moz-transition:opacity 500ms;-o-transition:opacity 500ms;transition:opacity 500ms;background:rgba(0,0,0,0.5)}span.carousel-caption a{color:#fff;text-decoration:none}

data/assets/themes/j1/modules/cookieConsent/js/cookieConsent.js

@@ -24,7 +24,7 @@
  #  outside of J1 Template!
  # -----------------------------------------------------------------------------
 */
-'use strict';
+//'use strict';
 
 // -----------------------------------------------------------------------------
 // ESLint shimming
@@ -39,11 +39,10 @@
 
 function BootstrapCookieConsent(props) {
   var logger                = log4javascript.getLogger('j1.core.bsCookieConsent');
-  var modalId               = 'bccs-modal';
   var self                  = this;
   var detailedSettingsShown = false;
   var url                   = new liteURL(window.location.href);
-  var secure                = (url.protocol.includes('https')) ? true : false;
+  var cookieSecure          = (url.protocol.includes('https')) ? true : false;
   var logText;
   var current_page;
   var whitelisted;
@@ -51,35 +50,43 @@ function BootstrapCookieConsent(props) {
   logger.info('\n' + 'initializing core module: started');
   logger.info('\n' + 'state: started');
 
+  // default settings
   this.props = {
-    autoShowDialog:         true,                                               // disable autoShowModal on the privacy policy and legal notice pages, to make these pages readable
-    language:               navigator.language,                                 // the language, in which the modal is shown
-    languages:              ["en", "de"],                                       // supported languages (in ./content/), defaults to first in array
-    contentURL:             "./content",                                        // this URL must contain the dialogs content in the needed languages
-    cookieName:             "cookie-consent-settings",                          // the name of the cookie in which the configuration is stored as JSON
-    cookieStorageDays:      365,                                                // the duration the cookie configuration is stored on the client
+    autoShowDialog:         true,                                               // show dialog if NO consent cookie found
+    dialogLanguage:         'content',                                          // language used for the consent dialog (modal)
+    dialogLanguages:        ['en','de'],                                        // supported languages for the consent dialog (modal), defaults to first in array
+    contentURL:             '/assets/data/cookieconsent',                       // URL contain the consent dialogs (modals) for ALL supported languages
+    cookieName:             'j1.user.translate',                                // name of the cookie, in which the configuration is stored
+    cookieStorageDays:      365,                                                // duration the configuration cookie is stored on the client
     postSelectionCallback:  undefined,                                          // callback function, called after the user has made his selection
-    whitelisted:            [],                                                 // pages NO consent modal page is issued
-    xhr_data_element:       "",                                                 // container for the language-specific consent modal taken from /assets/data/cookieconsent.html
-    sameSite:               "Strict",                                           // restrict consent cookie to first-party, do NOT send cookie to other domains
-    secure:                 false                                               //
-  }
+    whitelisted:            [],                                                 // pages NO consent modal dialog is issued
+    xhrDataElement:         'consent-data',                                     // src container for all language-specific consent dialogs (taken from contentURL)
+    dialogContainerID:      'consent-modal',                                    // dest container, the dialog modal is loaded (dynamically)
+    cookieSameSite:         'Strict',                                           // restrict the consent cookie to first-party (do NOT send cookie to other domains)
+  };
 
+  // merge property settings
   for (var property in props) {
     this.props[property] = props[property];
   }
 
-  this.language = this.props.language
-  if (this.language.indexOf("-") !== -1) {
-    this.language = this.language.split("-")[0];
+  if (this.props.dialogLanguage.indexOf("-") !== -1) {
+    this.props.dialogLanguage = this.props.dialogLanguage.split("-")[0];
   }
 
-  if (!this.props.languages.includes(this.language)) {
-    this.language = this.props.languages[0];                                    // fallback on default language
+  // fallback on default language (modal) if dialogLanguage not suppported
+  if (!this.props.dialogLanguages.includes(this.props.dialogLanguage)) {
+    this.props.dialogLanguage = this.props.dialogLanguages[0];
   }
 
+  // set modal by dialogLanguage that is loadad
+  this.props.xhrDataElement = this.props.xhrDataElement + '-' + this.props.dialogLanguage;
+
+  // set modal by dialogLanguage that is loadad
+  this.props.cookieSecure = cookieSecure;
+
   var Cookie = {
-    set: function (name, value, days, samesite, secure) {
+    set: function (name, value, days, cookieSameSite, cookieSecure) {
       var value_encoded = window.btoa(value);
       var expires = "";
       if (days) {
@@ -87,10 +94,10 @@ function BootstrapCookieConsent(props) {
         date.setTime(date.getTime() + (days * 24 * 60 * 60 * 1000));
         expires = "; expires=" + date.toUTCString();
       }
-      if (secure) {
-        document.cookie = name + "=" + (value_encoded || '') + expires + '; Path=/; SameSite=' + samesite + '; ' + 'secure=' + secure + ';';
+      if (cookieSecure) {
+        document.cookie = name + "=" + (value_encoded || '') + expires + '; Path=/; cookieSameSite=' + cookieSameSite + '; ' + 'cookieSecure=' + cookieSecure + ';';
       } else {
-        document.cookie = name + "=" + (value_encoded || '') + expires + '; Path=/; SameSite=' + samesite + ';';
+        document.cookie = name + "=" + (value_encoded || '') + expires + '; Path=/; cookieSameSite=' + cookieSameSite + ';';
       }
     },
     get: function (name) {
@@ -107,9 +114,9 @@ function BootstrapCookieConsent(props) {
         return value;
       }
     }
-    return undefined
+    return undefined;
     }
-  }
+  };
 
   var Events = {
     documentReady: function (onDocumentReady) {
@@ -119,20 +126,20 @@ function BootstrapCookieConsent(props) {
         document.addEventListener('DOMContentLoaded', onDocumentReady);
       }
     }
-  }
+  };
 
   function showDialog(options) {
     Events.documentReady(function () {
 
-      self.modal = document.getElementById(modalId);
+      self.modal = document.getElementById(self.props.dialogContainerID);
       if (!self.modal) {
         logger.info('\n' +  'load consent modal');
         self.modal = document.createElement("div");
-        self.modal.id = modalId;
+        self.modal.id = self.props.dialogContainerID;
         self.modal.setAttribute("class", "modal fade");
         self.modal.setAttribute("tabindex", "-1");
         self.modal.setAttribute("role", "dialog");
-        self.modal.setAttribute("aria-labelledby", modalId);
+        self.modal.setAttribute("aria-labelledby", self.props.dialogContainerID);
         document.body.append(self.modal);
         self.$modal = $(self.modal);
 
@@ -149,7 +156,7 @@ function BootstrapCookieConsent(props) {
         .done(function (data) {
           logger.info('\n' + 'loading consent modal: successfully');
           self.modal.innerHTML = data;
-          self.modal.innerHTML = $('#' + self.props.xhr_data_element).eq(0).html();
+          self.modal.innerHTML = $('#' + self.props.xhrDataElement).eq(0).html();
 
           $(self.modal).modal({
             backdrop: "static",
@@ -196,11 +203,11 @@ function BootstrapCookieConsent(props) {
         .fail(function () {
           logger.error('\n' + 'loading consent modal: failed');
           logger.warn('\n' + 'probably no `contentURL` set');
-        })
+        });
       } else {
-        self.$modal.modal("show")
+        self.$modal.modal('show');
       }
-    }.bind(this))
+    }.bind(this));
   }
 
   function updateOptionsFromCookie() {
@@ -242,16 +249,16 @@ function BootstrapCookieConsent(props) {
         options[name] = !!setAllExceptNecessary;
       }
     }
-    return options
+    return options;
   }
 
   function agreeAll() {
-    Cookie.set(self.props.cookieName, JSON.stringify(gatherOptions(true)), self.props.cookieStorageDays, self.props.sameSite, self.props.secure);
-    self.$modal.modal("hide");
+    Cookie.set(self.props.cookieName, JSON.stringify(gatherOptions(true)), self.props.cookieStorageDays, self.props.cookieSameSite, self.props.cookieSecure);
+    self.$modal.modal('hide');
   }
 
   function doNotAgree() {
-    Cookie.set(self.props.cookieName, JSON.stringify(gatherOptions(false)), self.props.cookieStorageDays, self.props.sameSite, self.props.secure);
+    Cookie.set(self.props.cookieName, JSON.stringify(gatherOptions(false)), self.props.cookieStorageDays, self.props.cookieSameSite, self.props.cookieSecure);
 
     // jadams, 2021-07-15: all cookies NOT longer supported by j1.expireCookie
     // TODO: Create loop over all cookies found in page
@@ -259,13 +266,13 @@ function BootstrapCookieConsent(props) {
     // logger.warn('expire all cookies');
     // j1.expireCookie('all');
 
-    self.$modal.modal('hide')
+    self.$modal.modal('hide');
     j1.goHome();
   }
 
   function saveSettings() {
-    Cookie.set(self.props.cookieName, JSON.stringify(gatherOptions()), self.props.cookieStorageDays, self.props.sameSite, self.props.secure);
-    self.$modal.modal("hide");
+    Cookie.set(self.props.cookieName, JSON.stringify(gatherOptions()), self.props.cookieStorageDays, self.props.cookieSameSite, self.props.cookieSecure);
+    self.$modal.modal('hide');
   }
 
   // call consent dialog if no cookie found (except pages whitelisted)
@@ -288,7 +295,7 @@ function BootstrapCookieConsent(props) {
     if (!whitelisted) {
       showDialog();
     }
-  }
+  };
 
   // collect settings from consent cookie
   // ---------------------------------------------------------------------------
@@ -308,6 +315,6 @@ function BootstrapCookieConsent(props) {
     } else {
       return undefined;
     }
-  } // END getSettings
+  }; // END getSettings
 
 } // END BootstrapCookieConsent

data/assets/themes/j1/modules/j1Deepl/js/j1deepl.js

@@ -0,0 +1,388 @@
+/*
+ # -----------------------------------------------------------------------------
+ # ~/assets/themes/j1/modules/j1Deepl/js/j1deepl.js
+ # J1 core module for j1Deepl
+ #
+ # Product/Info:
+ # https://jekyll.one
+ #
+ # Copyright (C) 2021 Juergen Adams
+ #
+ # J1 Template is licensed under the MIT License.
+ # For details, see https://jekyll.one
+ # -----------------------------------------------------------------------------
+ # NOTE: Based on https://github.com/jquery-boilerplate/jquery-boilerplate
+ # See:  https://www.dotnetcurry.com/jquery/1069/authoring-jquery-plugins
+ # -----------------------------------------------------------------------------
+*/
+
+// the semi-colon before function invocation is a SAFETY method against
+// concatenated scripts and/or other plugins which may NOT be closed
+// properly.
+//
+;(function($, window, document, undefined) {
+
+    'use strict';
+
+    // Create the defaults
+    var pluginName = 'j1deepl',
+    defaults = {
+      api:                  'free',                                             // free (default) | pro
+      auth_key:             false,                                              // API authorization key.
+      source_lang:          'auto',                                             // autodetection (default: auto)|supported language. Specifies the language for the input text.
+      target_lang:          'DE',                                               // language to be tranlasted in.
+      max_chars:            false,                                              // false (unlimited) or number. Number of chars from the source text passed for translation.
+      split_sentences:      '1',                                                // enabled (1, default)|disabled (0)|nonewlines. Sets the translation engine to first split the input text into sentences.
+      preserve_formatting:  '0',                                                // disabled (0, default)|enabled (1). Sets the translation engine to respect the original formatting.
+      formality:            'default',                                          // default|more|less. Sets the translated text should lean towards formal or informal language.
+      tag_handling:         false,                                              // false (value=0)|xml. Sets which kind of tags should be handled. If set, API is able to process structured XML content.
+      outline_detection:    true,                                               // false (value=0) or true (NO value passed). Controls the automatic mechanism on XML tags for splitting. If disabled, all splitting_tags are to be specified.
+      non_splitting_tags:   false,                                              // false or comma-separated list of XML tags. Disable automated splitting on the tags specified.
+      splitting_tags:       false,                                              // false or comma-separated list of XML tags which always cause splitting.
+      ignore_tags:          false,                                              // false or comma-separated list of XML tags that indicate text NOT to be translated.
+      onInit:               function (){},                                      // callback after plugin has initialized.
+      onBeforeTranslation:  function (){},                                      // callback before translation started.
+      onAfterTranslation:   function (){}                                       // callback after translation finished.
+    };
+
+    // -------------------------------------------------------------------------
+    // plugin constructor
+    // create the jquery plugin
+    // -------------------------------------------------------------------------
+    function Plugin (element, options) {
+      this.element            = element;
+      this.settings           = $.extend( {}, defaults, options);
+      this.settings.elementID = '#' + this.element.id;
+      this.xhr                = new XMLHttpRequest();
+
+      // call the plugin initializer
+      this.init(this.settings);
+    }
+
+    // Avoid plugin prototype conflicts
+    $.extend(Plugin.prototype, {
+      // -----------------------------------------------------------------------
+      // init
+      // initialize the plugin
+      // -----------------------------------------------------------------------
+      init: function(options) {
+        var logger = log4javascript.getLogger('j1deepl.init');
+
+        logger.info('\n' + 'initializing plugin: started');
+        this.translate(options);
+        logger.info('\n' + 'initializing plugin: finished');
+      },
+
+      // -----------------------------------------------------------------------
+      // prepareXHR
+      // Prepare a XHR request according to DeepL API specification
+      // for the required HTTP header settings
+      // See: https://www.deepl.com/de/docs-api/simulator/
+      // -----------------------------------------------------------------------
+      // NOTE: "User-Agent" NOT used as the use is qualified UNSECURE
+      // -----------------------------------------------------------------------
+      prepareXHR: function (settings) {
+        if (settings.api === 'free') {
+          this.xhr.open("POST", "https://api-free.deepl.com/v2/translate", true);
+        } else if (settings.api === 'pro') {
+          this.xhr.open("POST", "https://api.deepl.com/v2/translate", true);
+        } else {
+          this.xhr.open("POST", "https://api-free.deepl.com/v2/translate", true);
+        }
+        // Set required header parameters
+        this.xhr.setRequestHeader("Accept", "*/*");
+        this.xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");
+      },
+
+      // -----------------------------------------------------------------------
+      // prepareText
+      // Prepare text function used to parse, or arrange text, designed as
+      // a module. Currently it splits all text whenever a newline ("\n")
+      // is met, so that it preserves the original layout of the text, which
+      // would have otherwise been lost because of the way DeepL accepts
+      // multiple sentences.
+      // -----------------------------------------------------------------------
+      prepareText: function (source_text) {
+        return source_text.split("\n");
+      },
+
+      // -----------------------------------------------------------------------
+      // translate
+      // Translate text function which uses all the other modules, in order to
+      // create a request, which is sent to the DeepL API to translate, and
+      // then display the result, designed as a module.
+      // -----------------------------------------------------------------------
+      translate: function (settings) {
+        const logger                  = log4javascript.getLogger('j1deepl.translate');
+        const READYSTATE_DONE         = 4;
+        const STATUS_OK               = 200;
+        const SUPPORTED_LANG          = ['BG', 'CS', 'DA', 'DE', 'EL', 'EN-GB', 'EN-US', 'EN', 'ES', 'ET', 'FI', 'FR', 'HU', 'IT', 'JA', 'LT', 'LV', 'NL', 'PL', 'PT-PT', 'PT-BR', 'PT', 'RO', 'RU', 'SK', 'SL', 'SV', 'ZH'];
+        const ALLOWED_FORMALITY_LANG  = ['DE', 'FR', 'IT', 'ES', 'NL', 'PL', 'PT', 'PT-BR', 'RU'];
+        const ALLOWED_TAG_HANDLING    = ['xml'];
+        const TARGET_ELEMENT          = settings.targetElement;
+        const TARGET_ELEMENT_EXISTS   = $(TARGET_ELEMENT).length;
+        const ERROR_TEXT              = 'Translation failed.' + '\n' + 'Reason: ';
+        const WARNING_TEXT            = 'Translation skipped.' + '\n' + 'Reason: ';
+
+        var BASE_TARGET_ELEMENT;
+        var ELEMENT_TYPE;
+        var SOURCE_TEXT_FOUND;
+
+        var API_RESPONSE              = {};
+        API_RESPONSE['400']           = 'Bad request. Please check error message and your parameters.';
+        API_RESPONSE['401']           = 'Authorization failed. Please supply a valid DeepL-Auth-Key.';
+        API_RESPONSE['403']           = 'Forbidden. The access to the requested resource is denied, because of insufficient access rights.';
+        API_RESPONSE['404']           = 'The requested resource could not be found.';
+        API_RESPONSE['413']           = 'The request size exceeds the limit.';
+        API_RESPONSE['415']           = 'The requested entries format specified in the Accept header is not supported.';
+        API_RESPONSE['429']           = 'Too many requests. Please wait and resend your request.';
+        API_RESPONSE['456']           = 'Quota exceeded. The maximum amount of glossaries has been reached.';
+        API_RESPONSE['500']           = 'Internal server error';
+        API_RESPONSE['503']           = 'Resource currently unavailable. Try again later.';
+        API_RESPONSE['529']           = 'Too many requests. Please wait and resend your request.';
+
+        var reason_text;
+        var request                   = '';
+        var element                   = '';
+        var source_text               = '';
+        var source_text_lines         = '';
+        var source_lang;
+        var target_lang;
+
+        // check if passed HTML element or ID exists
+        if (TARGET_ELEMENT_EXISTS) {
+          BASE_TARGET_ELEMENT = (TARGET_ELEMENT.includes('.')||TARGET_ELEMENT.includes('#')) ? TARGET_ELEMENT.substring(1) : TARGET_ELEMENT;
+          ELEMENT_TYPE        = $(TARGET_ELEMENT).get(0).nodeName;
+
+          // Read the text to be translated from the given HTML element
+          if (ELEMENT_TYPE === 'TEXTAREA') {
+              source_text  = this.element.value;
+          } else if (ELEMENT_TYPE === 'P') {
+              element      = this.element;
+              source_text  = $(TARGET_ELEMENT).text();
+          }
+          SOURCE_TEXT_FOUND = source_text.length;
+        } else {
+          logger.error('\n' + 'target element does not exists: ' + TARGET_ELEMENT);
+          return false;
+        }
+
+        // limit the source text if required
+        if (settings.max_char && source_text.length > settings.max_char ) {
+          var source_text_limited = source_text.substring(0, settings.max_char -3);
+          source_text = source_text_limited + ' ...';
+          logger.info('\n' + 'limit for source text ' + '(max: ' + settings.max_char + ')' + ' reached: ' + source_text.length);
+        }
+        source_text_lines = this.prepareText(source_text);
+
+        // prepare the XHR request for the API (free/pro) requested
+        this.prepareXHR(settings);
+
+        // Makes a request with every line, as a new text to translate
+        var source_text_request = "";
+        for(var i = 0; i < source_text_lines.length; i++) {
+          source_text_request += "&text=" + source_text_lines[i];
+        }
+
+        this.xhr.onload = function () {
+          if (this.readyState === READYSTATE_DONE) {
+            if (this.status === STATUS_OK) {
+              // JSON parse the response
+              var result = JSON.parse(this.responseText);
+
+              // recreate the response as one text to keep its original layout
+              var translated_text = "";
+              for(var i = 0; i < result.translations.length; i++) {
+                translated_text += result.translations[i].text;
+                translated_text += "\n";
+              }
+
+              // update the HTM element (content) by the tranlation
+              if (ELEMENT_TYPE === 'TEXTAREA') {
+                $(TARGET_ELEMENT).val(translated_text);
+              } else if (ELEMENT_TYPE === 'P') {
+                $(TARGET_ELEMENT).text(translated_text);
+              }
+            } else {
+              logger.error('\n' + 'API returned ' + this.status + ': ' + API_RESPONSE[this.status]);
+            }
+          }
+        };
+
+        // ---------------------------------------------------------------------
+        // preflight (validity check) on given parameters
+        // ---------------------------------------------------------------------
+
+        // Check for SUPPORTED language by option source_lang|target_lang
+        source_lang = this.settings.source_lang;
+        target_lang = this.settings.target_lang;
+
+        if (this.settings.source_lang !== 'auto') {
+          this.settings.source_lang = (SUPPORTED_LANG.indexOf(this.settings.source_lang) > -1) ? this.settings.source_lang : false;
+        }
+        this.settings.target_lang = (SUPPORTED_LANG.indexOf(this.settings.target_lang) > -1) ? this.settings.target_lang : false;
+
+        // stop processing if invalid language or NO AUTH key passed
+        if (!this.settings.auth_key || !this.settings.source_lang || !this.settings.target_lang) {
+          if (!this.settings.auth_key) {
+            reason_text = 'NO AUTH key passed.';
+            logger.error('\n' + 'invalid option found. ' + reason_text);
+          }
+          if (!this.settings.source_lang) {
+            reason_text = 'WRONG source language passed: ' + source_lang;
+            logger.error('\n' + 'invalid option found. ' + reason_text);
+          }
+          if (!this.settings.target_lang) {
+            reason_text = 'WRONG target language passed: ' + target_lang;
+            logger.error('\n' + 'invalid option found. ' + reason_text);
+          }
+
+          // update the HTML element (content) by an error text
+          if (ELEMENT_TYPE === 'TEXTAREA') {
+            $(TARGET_ELEMENT).val(ERROR_TEXT + reason_text);
+          } else if (ELEMENT_TYPE === 'P') {
+            $(TARGET_ELEMENT).text(ERROR_TEXT + reason_text);
+          }
+          return false;
+        }
+
+        if(!SOURCE_TEXT_FOUND) {
+          reason_text = 'NO text found for translation';
+          // update the HTML element (content) by an error text
+          if (ELEMENT_TYPE === 'TEXTAREA') {
+            $(TARGET_ELEMENT).val(WARNING_TEXT + reason_text);
+          } else if (ELEMENT_TYPE === 'P') {
+            $(TARGET_ELEMENT).text(WARNING_TEXT + reason_text);
+          }
+          logger.warn('\n' + 'no text found for translation');
+          return false;
+        }
+
+        // Check for VALID language supported by option 'formality'
+        if (this.settings.formality !== 'default' ) {
+          if (!(ALLOWED_FORMALITY_LANG.indexOf(this.settings.target_lang) > -1)) {
+            logger.warn('\n' + 'wrong language found for formality setting: ' + this.settings.target_lang);
+          }
+          this.settings.formality = (ALLOWED_FORMALITY_LANG.indexOf(this.settings.target_lang) > -1) ? this.settings.formality : 'default';
+        }
+
+        // Check for VALID tag handling and options
+        if (this.settings.tag_handling) {
+          var tag_handling = this.settings.tag_handling;
+          // check for VALID method
+          this.settings.tag_handling = (ALLOWED_TAG_HANDLING.indexOf(this.settings.tag_handling) > -1) ? this.settings.tag_handling : false;
+          if (this.settings.tag_handling) {
+            this.settings.non_splitting_tags = this.settings.non_splitting_tags ? encodeURIComponent(this.settings.non_splitting_tags) : false;
+            this.settings.splitting_tags = this.settings.splitting_tags ? encodeURIComponent(this.settings.splitting_tags) : false;
+            this.settings.ignore_tags = this.settings.ignore_tags ? encodeURIComponent(this.settings.ignore_tags) : false;
+          } else {
+            logger.error('\n' + 'invalid option found for tag handling : ' + tag_handling);
+            logger.warn('\n' + 'disable option: ' + 'tag_handling');
+            // reset to defaults if WRONG method detected
+            if (this.settings.non_splitting_tags) {
+              logger.warn('\n' + 'disable option: ' + this.settings.non_splitting_tags);
+              this.settings.non_splitting_tags = false;
+            }
+            if (this.settings.splitting_tags) {
+              logger.warn('\n' + 'disable option : ' + this.settings.splitting_tags);
+              this.settings.splitting_tags = false;
+            }
+            if (this.settings.ignore_tags) {
+              logger.warn('\n' + 'disable option: ' + this.settings.ignore_tags);
+              this.settings.ignore_tags = false;
+            }
+          }
+        } else {
+          // reset tags to their defaults if NO tag_handling is enabled but settings passed
+          if (this.settings.non_splitting_tags) {
+            logger.warn('\n' + 'invalid option found: ' + this.settings.non_splitting_tags);
+            this.settings.non_splitting_tags = false;
+          }
+          if (this.settings.splitting_tags) {
+            logger.warn('\n' + 'invalid option found: ' + this.settings.splitting_tags);
+            this.settings.splitting_tags = false;
+          }
+          if (this.settings.ignore_tags) {
+            logger.warn('\n' + 'invalid option found: ' + this.settings.ignore_tags);
+            this.settings.ignore_tags = false;
+          }
+        }
+
+        // ---------------------------------------------------------------------
+        // construct the API request body
+        // ---------------------------------------------------------------------
+        request =  "auth_key=" + this.settings.auth_key;
+        request += (this.settings.source_lang !== 'auto' ) ? "&source_lang=" + this.settings.source_lang : '';
+        request += "&target_lang=" + this.settings.target_lang;
+        request += (this.settings.formality !== 'default' ) ? "&formality=" + this.settings.formality : '';
+        request += (this.settings.split_sentences) ? "&split_sentences=" + this.settings.formality : '';
+        request += (this.settings.tag_handling) ? "&tag_handling=" + this.settings.tag_handling : "&tag_handling=0";
+        request += (this.settings.tag_handling && this.settings.non_splitting_tags) ? "&non_splitting_tags=" + this.settings.non_splitting_tags : '';
+        request += (this.settings.tag_handling && this.settings.splitting_tags) ? "&splitting_tags=" + this.settings.splitting_tags : '';
+        request += (this.settings.tag_handling && this.settings.ignore_tags) ? "&ignore_tags=" + this.settings.ignore_tags : '';
+        request += source_text_request;
+
+        // Send the constructed request to the API for translation
+        this.xhr.send(request);
+      } // END translate
+
+    }); // END prototype
+
+    // ---------------------------------------------------------------------------
+    // plugin wrapper
+    // A really lightweight plugin wrapper around the constructor,
+    // wrapper around the constructor to prevent multiple instantiations
+    // preventing against multiple instantiations and allowing any
+    // public function (ie. a function whose name doesn't start
+    // with an underscore) to be called via the jQuery plugin,
+    // e.g. $(element).defaultPluginName('functionName', arg1, arg2)
+    // ---------------------------------------------------------------------------
+    $.fn[pluginName] = function ( options ) {
+      var args = arguments;
+
+      // Is the first parameter an object (options), or was omitted,
+      // instantiate a new instance of the plugin.
+      //
+      if (options === undefined || typeof options === 'object') {
+        return this.each(function () {
+        // Only allow the plugin to be instantiated once,
+        // so we check that the element has no plugin instantiation yet
+        if (!$.data(this, 'plugin_' + pluginName)) {
+          // if it has no instance, create a new one, pass options to the
+          // plugin constructor, and store the plugin instance in the
+          // elements jQuery data object.
+          $.data(this, 'plugin_' + pluginName, new Plugin( this, options ));
+        }
+        });
+      } else if (typeof options === 'string' && options[0] !== '_' && options !== 'init') {
+        // If the first parameter is a string and it doesn't start
+        // with an underscore or "contains" the `init`-function,
+        // treat this as a call to a public method.
+
+        // Cache the method call to make it possible to return a value
+        var returns;
+
+        this.each(function () {
+          var instance = $.data(this, 'plugin_' + pluginName);
+
+          // Tests that there's already a plugin-instance
+          // and checks that the requested public method exists
+          if (instance instanceof Plugin && typeof instance[options] === 'function') {
+              // Call the method of our plugin instance,
+              // and pass it the supplied arguments.
+              returns = instance[options].apply( instance, Array.prototype.slice.call( args, 1 ) );
+          }
+
+          // Allow instances to be destroyed via the 'destroy' method
+          if (options === 'destroy') {
+              $.data(this, 'plugin_' + pluginName, null);
+          }
+        });
+
+        // If the earlier cached method gives a value back return the value,
+        // otherwise return "this" to preserve chainability.
+        return returns !== undefined ? returns : this;
+      }
+    }; // END plugin wrapper
+
+})(jQuery, window, document);