Both CONJ and its companion (PowerPack) plugin are localized using the GNU framework, which is the most common way to translate WordPress core and almost any theme or plugin.

Files that enable the translation

  • .pot ― This file is a portable object template that contains all of the text to be translated.
  • .po ― The portable object file contains the original text and the translations.
  • .mo ― This is the machine object file. When your translation is complete, you will convert or export your .po file to this file type so that WordPress can use it.

.po and .mo translation files

WordPress uses .po and .mo files to manage translations. In fact, WordPress only needs .mo files to handle translations..po files are human-readable; Those files contains a list of strings ready to be translated or with a translation already included.‌

.mo files just compiled exports from the .po files and used by WordPress to get the conversion of each string to translate the theme. If you try to open a .mo file with a regular text editor, you will not understand anything of its content.

Loading translation files

Translations can be filed in the /languages/ directory. Both CONJ and PowerPack plugin will look in this directory for translations as a fallback. However, it is recommended that you use the global WordPress language directory and install your translations like so:

/wp-content/languages/themes/conj-it_IT.mo

Alternatively you can put translations in your child theme:

/wp-content/themes/conj-child-theme/languages/it_IT.mo

CONJ first looks in the WordPress Languages Directory, and then in the language directory of your child theme.

Custom translations need to be in the correct place, or they’ll be lost when updating CONJ core.

Translate or replace default text

In case you wish to translate or modify a few words of either CONJ or its companion (PowerPack) plugin without editing core catalog files, the following plugin might help:

  1. Log into your WordPress website and navigate to Plugins » Add New.
  2. Locate the search field in the top right corner of the page and type in Say What?.
  3. Click Install Now button.
  4. Then, click Activate button.
  5. At this point, the plugin will be up and running on your website!

When activated, the plugin will ask for:

  • Original string — text you are translating.
  • Text domain — conj or conj-powerpack.
  • Text you want to display.

Share your language files

In case you have already translated CONJ, a lot of users would be thrilled if you share your translation files with the community.

For translations, please start a new discussion under i18n forum here to share any of your translated files with us. We will include the translation files along with your name and credit to the next release, so other people who speak your language can use it.

Last updated: 3 months ago

We use cookies to personalize your experience. By continuing to visit this website you agree to our use of cookies ― Learn more

Accept