Adding multi-language support

From Joomla! Documentation

Quill icon.png
Content is Incomplete

This article or section is incomplete, which means it may be lacking information. You are welcome to assist in its completion by editing it as well. If this article or section has not been edited in several days, please consider helping complete the content.
This article was last edited by Wilsonge (talk| contribs) 11 years ago. (Purge)


The content management system Joomla! includes various language packs and translations for the user interface already. The combination of one specific language pack and the content in the same language allows you to build a website in any language you like.

If you build a website that should have more than one language you need some extensions for multi-lingual support. Those extensions will help you to maintain the translations as well as the organization of your content in the various languages. From the developer point of view it depends on the complexity of your application and the used extension by your users how you need to support multi-lingual sites.

Within this article we will give a brief introduction on the different topics and concepts. This article is for sure not complete and there are various ways out there in the internet how to realize this area. If you feel an important concept is missing please feel free to add it to this aritcle.

Multi-Lingual content in Joomla! 1.5[edit]

Joomla! 1.5 introduces the UTF-8 charset for all output, input and tables within the database. This allows you to use any language related character set for your content and also allows to have two languages stored in your database which have very different characters and scripts.

Simply speaking, this means you can store any language and any characters in your content with Joomla!. Now the issue comes with the word content. Joomla! is based on extensions which structure certain type of information. Core extensions are for example Articles, Contacts, Banners or Section and Category information. Using multi-lingual content there means you need to tell the system which language you wrote a certain text in. After you defined the original language of your content you need to translate it to those languages you want to include. In the end you might have some various structures of your site for different languages.

In general you can say the language adds a new dimension to your site which you need to manage. And of course there are some extensions for exactly this purpose.

Admin & User notes: Creating a multi-lingual website[edit]

If you try to create a new multi-lingual website the general process is not very different from a single language site. The new language dimension for your site adds some questions you need to answer in the beginning.

  1. Is the site structure of all languages the same or do I have different "views"?
  2. Do I need language related content such as different products in a shop?
  3. Are regions/countries related to languages or is the new language primarily a translation?
  4. Do I have different authors, publishers and so on for my various languages?
  5. Do I need a professional translation for my site or is an automated translation (e.g. by Google) acceptable?

If you answer those questions before going through the following steps you will find it quite easy to setup a multi-lingual site with Joomla!

Setting up Joomla! 1.5[edit]

To use Joomla! 1.5 with more than one language you do not need to do much. In addition to the standard installation you need to install all languages you like to use in your multi-lingual site with the Language Manager. You can add as many languages as you like and there are known installations with more than 20 languages used.

Creating your structure and content[edit]

From this point on you can basically start to create your structure and content. Most of the existing multi-lingual extensions do not require to be installed prior starting your site, which allows you to start with a single language site and extend it later to your needs. It is recommended to start with one language as your *original or default language*. The reason is not a technical one but an organizational. It is far simpler to setup a complete content and navigation structure for one language than starting with different languages at the same time. The language dimension adds also a new complexity to your structure and this is why the default language will help you a lot for the management later.

Using a multi-lingual extension[edit]

There are various extensions for multi-lingual websites available. The primary question is if you need a manually translated website or if automatic translation is an option for you. Mostly an automated translation does not 100% fit to what you want to say with your sentences. But if you just want to make sure your users can read your content it might be Ok.

Depending on the extension you use additional installation and configuration will be needed. Check out the related documentation and see if you can find a starting tutorial. Those are normally quite good for an initial start.

Developer notes: Multi-lingual support for extensions[edit]

For the developers integrating multi-lingual support for an extension is an additional task. In general there are some concepts to fulfill this tasks.

  • A generic approach which allows you to translate or manage all different multi-lingual content with one implementation
  • A version kind of approach, which is treating each language dependent content as a separate version
  • An individual approach for special logistics e.g. language dependent information to prices, dates or similar
  • and of course some more variations for individual needs

Generic approach for managing multi-lingual content[edit]

Language dependent versions of content[edit]

Individual handling of languages[edit]