Out of the box, CiviCRM comes ready for use in the United States, but localizations can be installed if you need to enter addresses outside the U.S. or use languages other than American English. Here’s how.
The following is an abridged version of the project’s localization installation instructions; refer to it for more information.
Before downloading, check the progress of the localization you are interested in. You might decide that a localization that’s only 5% translated isn’t worth fooling with, or you might decide to go with a less than ideal but more fully translated version. For example, as I write this I see the Puerto Rican Spanish localization is 8% complete vs. 80% for Castilian Spanish, so the latter would probably be a better choice even for users who would have preferred Puerto Rican Spanish were all things equal.
Download the localization package, labeled l10n, of your version of CiviCRM. It’s big, so if you will be installing to a remote server, consider using wget.
On a local server
Copy the localization (l10n) package to a temporary directory. Change the owner of the package to be the same user that you originally installed Joomla as. Become that user. On one local installation that was done thus:
$ cd /tmp/ $ cp ~/Downloads/civicrm-3.3.5-l10n.tar.gz . $ su # chown apache: civicrm-3.3.5-l10n.tar.gz # su apache
On any server
Unpack the package, for example:
$ tar -zxf civicrm-3.3.5-l10n.tar.gz
Notice that the new directory civicrm/ has been created, which contains the directories l10n (that’s “ell ten en”) and sql.
Inside l10n are directories, one for each available localization. The directory l10n and the subdirectories corresponding to the localizations you want are to be copied to the CiviCRM codebase root directory at JOOMLA_ROOT/administrator/components/com_civicrm/civicrm/. On one local installation I wanted Mexican Spanish (es_MX), so as user apache I did the following, still in Joomla’s temporary directory:
$ pwd /var/www/html/joomla1.5/tmp $ mkdir -p /var/www/html/joomla1.5/administrator/components/com_civicrm/civicrm/l10n/es_MX $ cp civicrm/l10n/es_MX/* /var/www/html/joomla1.5/administrator/components/com_civicrm/civicrm/l10n/es_MX/
Similarly, the sql directory contains two files for each available localization. Copy the localizations desired to CiviCRM’s sql directory. Again following my example of wanting Mexican Spanish:
$ pwd /var/www/html/joomla1.5/tmp $ cp civicrm/sql/civicrm_acl.es_MX.mysql /var/www/html/joomla1.5/administrator/components/com_civicrm/civicrm/sql/ $ cp civicrm/sql/civicrm_data.es_MX.mysql /var/www/html/joomla1.5/administrator/components/com_civicrm/civicrm/sql/
Login to CiviCRM (as a user with “administer CiviCRM permissions”). Go to Administer – Localization – Languages, Currency, Locations. Configure as desired.
When finished, delete the localization package and its unpacked files in the Joomla temporary directory.
TIPS AND TRICKS
Upon first use the information contained in the localization files are added to the database. So if after installing a localization you discover that it requires editing, then make your edits to the database, not to the files you installed.