Install new Language - Site
other.screensPlease note that at the present time the Help icons in Joomla! direct both Language and Template Help Screens to this one page. There are separate Help Screens as follows:

Install new Template - [ Site ] and Install new Template - [ Administrator ]







menu=>Site=>Language Manager - New

User Level:

Super Administrator


Install a New Language


Language files help localize the appearance of a Joomla! web site by translating the default English_GB labels and core instructions to the specified language. A Language file typically contains HTML, PHP, and XML files

note icon NOTE: There is no way in a standard installation of Joomla! to change the language of the Back-end.

There are two ways to install a new Language in Joomla! Both methods are described here and both assume that the Language file to be installed, has already been downloaded and it is saved on a local hard drive.

To Upload a Language:

If the host web server has GZIP support enabled with PHP, it is possible to upload a zipped (.zip) package file that will be installed automatically.

To trace the file click on the Browse button. This will open the File Upload dialogue window. Navigate to the location of the desired Language file on the local hard drive. Select the Language file and click the Open button. The dialogue window will disappear and the path to, and name of, the Language file will appear in the File Upload field. Click the Upload and Install button to complete the transfer and installation of a copy of the Language file from the local computer to the joomla_root/languages/ directory tree.

note711_small NOTE: There is usually an upper limit to the size of files that can be uploaded within the web server itself. This limit is set in the PHP configuration file (php.ini) and may differ between web servers and web hosts. The limit cannot be altered from within Joomla!. Some hosting companies do not allow the limit to be altered at all!

To allow larger files to be uploaded it will probably be necessary to increase the upload_max_filesize and the post_max_size settings.

For very large files it may also be necessary to increase the max_execution_time and the memory_limit settings. Alternatively it may be necessary to use an external program to upload the files. If so follow the next set of instructions.

To Install From a Directory:

If the host web server does not have GZIP support enabled with PHP it will be necessary to transfer the Language file to the web server using FTP (File Transfer Protocol) or possibly a web host provided control panel, but these are varied and outside the scope of this Help Screen.

Unpack the compressed .zip file onto the local hard drive before uploading it via FTP. Ideally the file should be transferred to the joomla_root/administrator/components/com_installer/language/yourlanguagename directory of Joomla!.

Once the files are uploaded enter the exact location of this file (it must be the absolute location) in this example: joomla_root/administrator/components/com_installer/language/yourlanguagename then click the Install button. The new Language will be installed by Joomla! in the joomla_root/language/yourlanguagename directory of the web site.

The Success (or Failure Screen)

If all goes well a page will be displayed proclaiming Upload Language - Success. This confirms the name of the Language installed together with the Language authors description message.

If things did not go to plan the message Upload Language - Failed, followed usually by the reason for the failure. Make a note of the reason before clicking continue. Rectify the error, if possible, before trying again.

The newly installed Language will now be listed in the Language Manager and access to all the functions relating to the use of the new Language are found here.

Related Information:

Language Manager

Translations Work Group Forum

Joomla! Language Forum

Other Language specific forums are also available.

note icon NOTE: If you have any comments or suggestions regarding this Help screen then please post them in the Suggestions, Modifications, and Corrections forum in the User Documentation Work Group.

Thank you!


The User Documentation Team

Last Updated ( Monday, 09 April 2007 )