Localizing Participants Database

The Participants Database plugin is set up for internationalization. There are several languages available, although currently many of these translations are incomplete. Which language is used is based on the WordPress language setting or, if a multilingual plugin is used, the setting determined by that plugin.

Multilingual or Localized?

There is a big difference between running a WordPress site in a non-English language and running WordPress as a multilingual application.

If you just need the application run in your own language, it is fairly easy to set up: just select that language in the WordPress general settings and the plugin will follow, using the translation files provided with the plugin.

If the translation for for your language is missing or incomplete, you can complete the translation or create a new one using a translation tool such as Poedit. The details on how to get that done are discussed in several places:

If you are completing or correcting a translation or creating a new translation, and would like to see it added to the plugin for others to use, please contact me…or just send the files to support@xnau.com. I’ll give you a credit in the plugin readme.

Multilingual Sites

Setting up a multilingual site (that is, a site that can be read in more than one language) is more complex, and usually involves the use of a multilingual plugin. In this case, the plugin must be set up for all the languages you want to support. This usually means using a special format for plugin settings that are printable strings: things such as feedback messages, emails, field titles, etc. The specially-formatted strings are then filtered according to the current language so that only the translation for that language is shown.

Participants Database accommodates this by filtering all it’s settings strings, titles, etc. through a “gettext” statement where the multilingual plugin can filter it. However, since this can slow the plugin down, the strings are not normally passed through this extra function. It is necessary to tell the plugin that you need to translate the strings by setting a constant. You can do that easily in your theme functions.php file with a line like this:

define( 'PDB_MULTILINGUAL', true );

That should allow the multilingual plugin to translate all the plugin’s settings strings.