Joomla! 1.5 Top Extensions Cookbook

Over 80 great recipes for taking control of Joomla! Extensions

• Set up and use the best extensions available for Joomla!
• Covers extensions for just about every use of Joomla!
• Packed with recipes to help you get the most of the Joomla! extensions
• Part of Packt’s Cookbook series: Each recipe is a carefully organized sequence of instructions to complete the task as efficiently as possible       

Introduction

One of the greatest features of Joomla! is that you can build a multilingual website. The Joomla! interface can be displayed in many languages. You can simply download the translation pack for the required language and install that to Joomla!. If you don’t have a translation pack for your desired language, you can translate it by editing language files directly or by using the translation manager component. The translation manager component allows you to visually translate your site’s interface into any language, right from the Joomla! administration area. After completing the translation, you can pack the translation and share it with others, so that they can install the translation in other Joomla! sites.

Besides translating the Joomla! interface, you can translate a site’s contents into your desired language. The GTranslate component allows you to translate your site’s content into 55 languages using Google’s translation service.

Adding a language to your site

Joomla! can build a multilingual site. A site interface can be in multiple languages, using different locales. In this recipe, you will learn how to add an additional language to a Joomla! site.

Getting ready…

Joomla! translations are available in major languages. First, decide which language you want to add to your site. For example, we want to add French to a Joomla! website. A French translation for Joomla! 1.5 is available to download at the Joomla! Extensions Directory, http://extensions.joomla.org/extensions/languages/translations-for-joomla. Download this extension from http://joomlacode.org/gf/project/french/frs/, and install it from the Extensions | Install/Uninstall screen.

How to do it…

After installation, follow the steps as shown:

1. From the Joomla! administration panel, click on Extensions | Language Manager. This will show the Language Manager screen, listing the installed languages for the site:

   

2. Note that the default language for the site is marked with a yellow star in the Default column. To make the newly-installed language, French (Fr), the default language for your site, select the language and click on the Default button in the toolbar.
3. Preview the site’s frontend and you will find the site’s interface (not content) in French. For example, the Login Form module will look like the following screenshot:

   

4. For changing the language of the administration panel, in the Language Manager screen click on Administrator, select a language from the list, and set that as the default language for the administrator backend.

See also…

Adding a translation will only show the Joomla! interfaces in that language. The content of the site is not translated or displayed in the selected language. Also note that we still don’t have a mechanism to select our desired language. All of these things can be done using the Joom!Fish extension, which is discussed in the recipe Manually Translating Your Joomla! Site’s Content into Your Desired Language.

Translating language files for your site

Joomla!’s translations are available in most major languages. However, you may like to change the translations and have your own translation in your desired language. In that case, Joomla! provides a mechanism to translate the Joomla! interface language. In this recipe, you will learn how to translate language files for your site from the administration backend.

Getting ready…

Translation Manager is a popular extension that can help you translate the site’s language files right from the administration backend, without opening a text editor. Download this extension from http://joomlacode.org/gf/project/joomla_1_5_tr1/frs/ and install it from the Extensions | Install/Uninstall screen.

How to do it…

After installation, follow the steps as shown:

1. 1. From the Joomla! administration panel, click on Components | Translation Manager. This will show the Translation Manager screen, listing all of the installed languages for the site and the administration backend.

      

<

1. For changing any language translation, select that language, for example Site [en-GB] English(United Kingdom), and click on the View Files button. This will show the language files for that language.

   

2. Now select a file, such as, com_banners, and click on the Edit button. This shows the string editing screen for the com_banners.ini file.

   

3. Change the strings accordingly, and click on the Save button in the toolbar.
4. For adding a new language, click on New in the Translation Manager screen. This will show the Create New Language screen:

   

5. In the Language Details section, configure the following:
   • Client: Select who will be the client for this translation—Administrator, Installation, or Site. If you want to translate for the administrator interface, select Administrator. We want to translate the site’s frontend, therefore we select Site.
   • Language ISO tag: Type the ISO tag for the language. For example, if we want to translate it into Bengali, type ISO code bn-BD.
   • Name: Type language name, that is Bangla.
   • Description: Type a short description for the translation.
   • Legacy Name: Type the traditional name of the language, for example, bn for bn-BD.
   • Language Locales: Type the locale code for the language.
   • Windows Code page: Specify the code page for the language. The default is iso-8859-1. For the Bangla language it will be utf-8.
   • PDF Font: Specify the font family to be used for displaying the PDF in that language.
   • Right-to-Left: Specify Yes if the language is to be read from right to left (for example, Arabic).
6. In the Author Details section, provide the translator’s name (probably your name), e-mail address, website URL, version number for the translation, creation date, the copyright holder’s name, and URL to the license document. When done, click on the Save button in the toolbar. This saves the language definition and you will see the language name on the Translation Manager screen: