Translating WP Job Manager

WP Job Manager (and all official add-ons) are fully internationalized, which allows you to translate individual strings or use your own language. WP Job Manager comes with several user-contributed language files, but if yours is missing you can translate it yourself.

↑ Back to Top Existing Translations of WPJM

All translations or translation work is performed wholly by volunteers. You can see existing publicly available translations of WPJM here:

https://translate.wordpress.org/projects/wp-plugins/wp-job-manager/

Any translation which is not 90% or greater will not be automatically installed with WPJM. You can still download it by clicking on the language name, scrolling to the bottom of the language page, and exporting the existing strings.

Note: a ‘string’ is any character or series of characters (ie, words) which can be translated.

↑ Back to Top When You Only Want to Change One Word to Another

If you want to do something like change every instance of ‘Job’ to say, ‘Vacancy’, try the Say What plugin. This simple plugin lets you translate any string via the WordPress admin dashboard. Your ‘translation’ can even be English->English!

You’ll need to provide the text domain of the plugin. You can find this in the root file of WPJM (or our other paid addons).

For WPJM, this information is:

* Text Domain: wp-job-manager
* Domain Path: /languages/

Say What has more instructions here.

Translating WPJM

WP Job Manager includes a language file (.pot file) which contains all of the English text which can be translated via plugin. You can find this language file inside the plugin folder in wp-job-manager/languages/.

You can take a look at it here.

The same plugin-name/languages directory is used for all paid add-ons as well.

↑ Back to Top Setting up WordPress in Your Language

WordPress needs to be told which language it should run under.

Change the language in the admin settings screen. This can be done via Settings → General → Site Language. This setting will impact the following areas of your site:

This will not translate any existing post and page content – it will just translate the default text strings from your theme/plugins.

Examples of Using Translation Plugins/Software with WPJM

Please note that we cannot provide support for creating translations or for using the following plugins/software. Please contact the plugin developer for help with their plugin or software.

Translation Using Poedit

Poedit is an application you can use on your computer to translate a POT file into your language.

  1. Download and install Poedit
  2. Find the POT file in wp-job-manager/languages/wp-job-manager.pot
  3. Open the POT file in Poedit.
  4. Translate the strings into your language.
  5. Go to File → Save as… to save your translations in a PO file.
  6. When you are finished translating, go to File → Save as… again to generate the MO file.
  7. Or you can set your Poedit to always compile a MO file when saving changes by clicking File → Preferences and on the Editor tab check the Automatically compile .mo file on save box.
  8. Upload your PO and MO file to wp-content/languages/wp-job-manager/

Updating your translation

After updates, you can update your po file by opening it and then going to Catalog > Update from POT file. Choose the file and it will be updated accordingly.

Translation Using Loco Translate

Loco Translate is a WordPress plugin that provides in-browser editing of PO files used for localizing WordPress plugins and themes.

You can then follow the instructions that take you through making a translation.

They have a helpful beginner’s guide to the plugin as well.

Keeping Translation Files Upgrade Safe

When WordPress does an automatic update to a plugin, any custom translation files inside the plugin directory will be lost, so please backup your po and mo files. With that in mind, you may want to use one of the following alternative methods of keeping translations upgrade safe.

↑ Back to Top Put Translations Inside the WP_LANG Directory

You can put your .po and .mo files in the WP_LANG directory which will keep them safe from updates. This is usually the wp-content/languages/ directory.

So for example, if you were translating the Resume Manager add-on, you would put your mo file in wp-content/languages/plugins/wp-job-manager-resumes-LOCALE.mo, replacing LOCALE with your language code.

Naming of your MO files must be in the format:

TEXTDOMAIN-LOCALE.mo

e.g. wp-job-manager-de_DE.mo

There is a list of WordPress locales here; search for your language to see the associated language/locale code.

↑ Back to Top Multilingual Job Sites with WP Job Manager and WPML

If you want to create a job board site with listings in multiple languages, we recommend using WPML.

You can find documentation for setting up your multilingual job board site here:

Using WP Job Manager with WPML

Note: If you encounter any issues setting up your multilingual site, please open a support ticket with WPML here. They will investigate the issue and then get in touch with our developers if any updates are necessary.

Optional: Contribute Your Translation to Core

All translations are performed by volunteers, not the WPJM development team. The core WPJM translations are hosted on WordPress.org:

https://translate.wordpress.org/projects/wp-plugins/wp-job-manager

Anyone can signup and start translating here and any updates will be included in WP Job Manager updates. Contributing to these translations benefits all users since they will be pulled into the plugins when downloaded.

Translations for our paid addons is performed by individual site owners and are not publicly available.