Install Linguise on Joomla

Table of Contents

Generate the API Key

After your connection to your Linguise dashboard you’ll need to setup a new domain first and save it’s settings to get the API Key.

The API key is what is required to activate the translation on your Joomla 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 or keep the browser tab open, so you can copy it later.

translation-API-key

Install the Joomla translation extension

Now you need to install the Joomla module and plugin (this is a single package) to activate the language switcher (flags with language switcher). You can download the latest version from here.

Once the Joomla extension is installed and activated you can access the component configuration by using the admin menu: Component > Linguise. 

From here, paste the API key you’ve generated from your Linguise dashboard and click apply.

Now the translation in all the languages selected is already activated on your Joomla website!

This action should synchronize all the language settings between Linguise and your website (original language and translated language list).

Make sure the URL rewriting is activated

In order to load your language on new URLs (like domain.com/es) the URL needs to be configured in Joomla general configuration, menu: System > Configuration > Site.

There are 2 options to activate, which are by the way the best one for SEO, they are:

  • Search Engine Friendly URLs
  • Use URL Rewriting (require editing a file to work properly)

URL rewriting and 404 errors: If these 2 settings are not activated you’ll have 404 errors on language pages. Plus, make sure there’s no other language tool that “locks” the multilingual URLs like the language filter plugin for the Joomla default multilingual system.

Add a Joomla language switcher

You have 3 methods to load the website language switcher (flags and language names) to your website on Joomla.

  • Use a Joomla menu (from the Joomla menu manager)
  • Use a Joomla module (from the Joomla module manager)
  • Use a PHP snippet

Add a Joomla menu

To add a Joomla menu to display the language switcher just use the Joomla menu manager Menu > Your menu > New

From the menu element setting, select Linguise and it’s done!

Your menu will be displayed according to the display settings you’ve setup in the component.

The alternate option will generate the alternate URL per language, so the search engine can crawl easily all the language version of the page. It’s recommended to let it activated.

An alternate example in the HTML code that will be crawled by search engines:

alternate-links

Load a Joomla module in content

The other option to include a language switcher is to use a pre-installed Joomla module and load it using the load module feature. The text to include in any text editor is: {loadmodule mod_linguise}

PHP code to include language switcher

This part is more for developers that want to include Linguise language switcher in, for example, a custom PHP template file that load a part of the website header. There’s a code you can use for that, just copy and paste it from the component.

				
					/**
* Get the linguise module
* If you want to use a completely different login module change the value of name in your layout override.
*/
$linguisemodule = LinguiseModelLinguise::getLinguiseModule('mod_linguise');
echo JModuleHelper::renderModule($linguisemodule, array('id' => 'section-box'));
				
			

Setup the language switcher type

There’s many design option that help the language switcher to be loaded anywhere on your website. For example, style won’t be the same on the white top bar and on a dark footer.

On the right side of the screen, you can use the preview to check the preview.

Language switcher flag and text design

There’s many design option that help the language switcher to be loaded anywhere on your website. For example, style won’t be the same on the white top bar and on a dark footer.

Main options are:

  • Flags shape and size
  • Language names text color
  • Shadow of elements on mouse hover
  • Mouse hover style

Language switcher setup in video

Language switcher advanced options

Finally, you can setup the advanced options such as cache setting, the amount of URL and translation to store locally to be served faster.

The browser language redirect is not recommended for various reasons detailed here. Basically, it redirects the user to one of the languages that is setup in his browser.

Still having trouble with your Linguise install? Don’t hesitate to reach us, we do offer custom free installation on your website!