WordPress Tutorials and Blog Posts

There are two types of files that deal with language. Site-wide labels and messages are handled in files with the extensions .mo and .po. These files are part of the WordPress core, or are added by plugins and themes to handle extra text. Many contributors have created files you can use for this, and there are language localization teams you can consult.

If you want to add a language other than English to your site, you can do one of three things:

1. Install a complete copy of WordPress written especially for your desired language.
2. Manually install language files on an English installation. You can download available translations from this page. To manually install a language file after you've downloaded it, place the language files in /wp-content/languages/.
3. Use a plugin.

We're going to use option #3. We're going to use these two plugins:

• WP Native Dashboard for translating your admin area.
• qTranslate for translating the content on the front of your site.

• Go to your dashboard.
• Go to Plugins then Add New.
• Search for WP Native Dashboard.
• Click Install after you find it.

This plugin enables the selection of your preferred language.

This plugin also includes a repository scan on demand (svn.automattic.com) for available language file downloads. You can download the required files into your installation and immediately use them on admin pages.

Access it by going to your Dashboard, then Settings, then Native Dashboard.

At the top of the settings page you can click the check boxes to enable the capabilities you want. In the Downloads pane, click check repository to find the language you want to install.

• Capabilities: choose one or a combination.
• Logon screen extension: the user can specify his/her preferred language during login.
• Dashboard quick switcher extension: the user can easily switch language on every admin page.
• WordPress admin bar switcher: the user can switch language via the admin bar.
• BuddyPress admin bar switcher: the user can switch language via the BuddyPress admin bar.
• User profile setting: the user can define their preferred language via their user profile.

The link to the downloads page should activate the progress bar, as shown in the picture above. When it is finished, you will have a list of language files to download. Be patient because this might take a while if you have a slow connection.

If clicking "check repository" doesn't initiate the svn search, you may not have a languages directory. Check your site's folders. There needs to be a writable languages directory located at /wp-content/languages/ otherwise the process fails. After creating the directory, make sure one of the Capabilities is checked and save the change. Then try the "check repository" link again.

Click the Download link to install the package.

An additional flag for each language will be added to the Installed Languages pane for each one you add.

Warning: Some languages provide a special xx_XX.php file disabling your login. Currently Russian (ru-RU) requires a small modification. The failure reason is the additional file needed for russian language named “ru_RU.php” in cooperation with your wp-config.php file. Change this line in your wp-config.php file to read:

$wp_default_secret_key = 'впишите сюда уникальную фразу';

On login, you will be presented with a language choice. Your members will be able to save the choice in their profile or login with their native language when they enter the site.

The main goal of this plugin is to control which languages can be used in the WordPress admin area. This addition of a language can only be managed by administrators. Other user can change the language they see, but not add a new language. The administrator defines what is allowed in the configuration by choosing one or a combination of the following settings:

• extend the WordPress login screen
• extend the backend header with quick switcher
• extend the user profile settings

This only changes the language of administration pages. We still need to deal with the front end language. It does not allow you to create posts or pages in multi-language versions. You will need another plugin for the front end view.

This plugin will add a language selector to your admin bar. You will be able switch the languages in the administration from a dropdown menu.

Go to your Dashboard, then Plugins, then Add new and search for qTranslate. Click Install Now.

qTranslate works best when installed on a site with no content. It will work fine if there is content, but there will be extra configuration steps involved. I suggest you install this on a test site first.

Go to Settings, then Languages to return to configure qTranslate.

• Choose the default language.
• Choose to Hide Untranslated Content or to show it. Read the instructional paragraph on the page for details on which is right for you.
• Click Advanced Settings (Show) to expand that pane and configure those options.
• Click qTranslate Services Settings (Show) to configure those options.
• Save any changes you make.

Note: qTranslate Services is a connection to a commercial translation service or an automated free service. Web Translations Services uses a network of freelance, in-country translators to return posts that sound natural to a native speaker of the language. There is also a free automated service, but it will only return a suggested translation that will not read naturally. You need an account with Web Translations Services for either the free or paid services.

On the settings page you can configure specific settings for each language. Different countries use different conventions for date format and other localization specifics.

For an idea of what you need to configure click "Edit" for one of the pre-installed languages on the language table to the right of the page. A picture of the language table is below.

Choose additional languages. Deutsch, English and Chinese come pre-installed and enabled. You can simply enable any language you see here, and you can edit the files.

In the picture, Deutsch (German) is enabled. Francais (French) is disabled and can be enabled by clicking on the word "Enable".

The above image shows a sample of the edits you can make on a language file.

Go to create or edit a Post.

You will be able to translate the post titles by typing the translations in the correct fields.

This is the easiest but also the most time consuming part of the process. Go to any post, page or category and you'll see editing windows for each language. Just write the translations in the appropriate fields. You have tabs for each version of the page.

Next to the Visual and HTML tabs you now have additional viewing tabs, one for each installed language. Choose the tab you want and write the article there in the chosen language.

Go to the Dashboard, then to Appearance, then Widgets and drag the qTranslate Language chooser onto a sidebar.

The image above shows the widget in the sidebar. I chose Chinese so you could easily see what would be translated by the uploaded language file. You can also see the parts that would need to be translated manually.

With these two plugins and the proper language file, you can present various languages on both the frontend and admin area of a WordPress site. Users can choose a language when they login so they can always be reading in their native tongue.