How to translate Visitor Maps for WordPress

Posted by on Jan 22, 2011 in Visitor Maps

How to translate Visitor Maps for WordPress:

This article explains how to make a new language translation file when a translation in your language does not exist. See also: How to update a translation of Visitor Maps for WordPress

WordPress uses gettext files for language translation localization. There are three types of files used in the gettext translation framework. These files are used and/or generated by translation tools during the translation process, as follows:

POT (Portable Object Template) files
The first step in the localization process is that a program is used to search through the WordPress source code and pick out every message passed into a __() or _e() function. This list of English-language messages is put into a specially-formatted template file (POT file) that forms the basis of all translations. Generally, you can download a POT file for WordPress, so you shouldn’t have to generate your own. Separate POT files can also be made for themes and plugins, if the theme/plugin developer has enclosed all text in __() or _e() functions.

PO (Portable Object) files
The second step in the localization process is that the translator translates all the messages from the POT file into the target language, and saves both English and translated messages in a PO file.

MO (Machine Object) files
The final step in the localization process is that the PO file is run through a program that turns it into an optimized machine-readable binary file (MO file). Compiling the translations to machine code makes the localized program much faster in retrieving the translations while it is running.

How to switch the language for Visitor Maps in WordPress:
Set WPLANG inside of wp-config.php to your chosen language. For example, if you wanted to use Italian:

define ('WPLANG', 'it_IT');

Note: there must be a corresponding language files in the plugin folder: /wp-content/plugins/visitor-maps/languages/
For example, if you wanted to use Italian:

Getting started making a new translation:
There may already be translation in your language, check before you start! Look in the plugin languages folder.
The country code is part of the file name. Example for Italian: it_IT. The Italian files of this WordPress plugin are named like this:

Translating With Poedit:
If there is not already a translation in your language, you may continue.
You should download the free Poedit to translate, because it makes it easier to translate.

Download the plugin POT file, look for the link below or find it in the plugin languages folder. Getting the latest one online is recommended. Download the language .pot file for Visitor Maps

Open the pot file in Poedit. Click FIle – New Catalog from POT file


Entries are arranged in a list, so that you can easily navigate large catalogs and immediately get an idea about how big part of the catalog is already translated, what needs translating and which parts are only translated in a “fuzzy” way. Fuzzy and untranslated records are highlighted and displayed at the top of the list. Start at the top of the list and translate each line. When done translating click Save.

Poedit will automatically save the .mo and .po files needed by this plugin. Be sure to name them like this:
Example for Italian: it_IT.

Copy the language files into the plugin folder:

When you have completed a new translation, please make a support ticket and request to submit your language files to be included in the plugin download. Be sure to include your name and your web site URL for the credits.

More info:
See also: How to update a translation of Visitor Maps for WordPress

Do you need more help?

Send us a Donation:

Donate to Mike Challis