Table of Contents
Drupal technical requirements
The neural automatic translation to be used with Drupal will require to use the PHP script (can be downloaded below). To install the Linguise script, you’ll need the following requirements:
- Run PHP 7+
- Apache, LiteSpeed, NGINX, IIS server
- Activate the URL rewriting though the Drupal configuration
- Drupal 8+
1. Generate the API Key
After your connection to your Linguise dashboard, you’ll need to setup a new domain first and save its settings to get the API Key.
The API key is what is required to activate the translation on your Drupal website. Basically, the API key will check what language is activated on what domain and will allow the neural translation pages to be generated.
Copy the API Key and keep it in your clipboard.
Then by clicking on the tab “Script PHP” you’ll get the installation instructions we’ll follow here in details.
2. Upload and connect the Linguise translation script
The Linguise translation script needs to be uploaded on your server where Drupal is installed:
After the script is downloaded, unzip it and upload it to the root folder where the CMS is installed.
- Make sure it’s at the root level of your website (where your Drupal files are located)
- Make sure the folder keep its default name “linguise”
The Linguise API key will need to be copied in the Configuration.php file you’ve uploaded on your server, edit the file and copy your API Key between the simple quotes, replace the text REPLACE_BY_TOUR TOKEN.
3. Setup the Drupal URLs rewriting
By default, the URL rewriting is active in Drupal. On the top menu bar go to Configuration > Search and metadata if you want to make sure of it. Note that the multilingual URLs are also working if you’re using the Pathauto Drupal module.
The URL by language need to be configured in the .htaccess. Just copy this code after the code “RewriteEngine on” available in the default Drupal .htaccess.
RewriteEngine On RewriteRule ^(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-cn|zh-tw|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu|zz-zz)(?:$|/)(.*)$ linguise/linguise.php?linguise_language=$1&original_url=$2 [L,QSA]
Finally, your Drupal .htaccess should look something like this:
4. Activate the language switcher
4.1 Load the Linguise JS script
You can now load all your translated pages using the URL, for example: www.shop.com/fr/
The language switcher is the flag popup to select the language you want. To load it, you’ll need to copy the code given at the end of the website configuration to the head of your HTML page. The flag language switcher will then be loaded automatically.
It needs to be loaded in your page header. Drupal gives you the ability to do that through a module, for example the “Add to Head” module: https://www.drupal.org/project/add_to_head
Once installed, go to Configuration > Add to head > Add profile
Then add the script link
Finally, validate the script location
The language switcher will be displayed by default in a floating top right position on your website. You are welcome to customize it as you wish with CSS.
Activate the local cache system option
As an option, you can activate a local cache system that stores URLs and its related multilingual content to serve the pages faster. The local cache will save some data transfer between Linguise server and your website server. The cache is used only when a page has already been translated and has not been updated. The cache kept in priority will be the cache from the most viewed multilingual pages.
As an option, you can define the amount of cache stored in MB. In the following example the cache is activated and the amount of cache to keep is 500MB:
/** Basic configuration **/ public $cache_enabled = true; public $cache_max_size = 500; // In megabyte