Citadela Translations & Multilingual website with Citadela

How to use Citadela in your language

You can choose your language during WordPress installation or switch the WordPress language in Settings – General – Site Language:

Languages included in Citadela theme, Pro and Listing plugins

Citadela theme and plugins include auto translations for several most used languages. The quality of the auto translations is good. Using the Loco Translate plugin, you can use these translations as a base for your translations.

82 language translations are included in the Citadela package:

  • Afrikaans
  • Albanian
  • Amharic
  • Arabic
  • Arabic (Egypt)
  • Arabic (Morocco)
  • Armenian
  • Assamese
  • Azerbaijani
  • Belarusian
  • Bengali (Bangladesh)
  • Bosnian
  • Bulgarian
  • Catalan
  • Chinese (China)
  • Chinese (Hong Kong)
  • Chinese (Singapore)
  • Chinese (Taiwan)
  • Croatian
  • Czech
  • Danish
  • Dutch
  • Dutch (Belgium)
  • English (US)
  • Esperanto
  • Estonian
  • Finnish
  • French (Canada)
  • French (France)
  • Galician
  • German
  • Greek (Greece)
  • Hebrew
  • Hebrew (Israel)
  • Hindi
  • Hungarian
  • Icelandic
  • Indonesian
  • Italian
  • Japanese
  • Korean
  • Latvian
  • Lithuanian
  • Macedonian
  • Malay
  • Mongolian
  • Moroccan Arabic
  • Norwegian (Bokmål)
  • Persian
  • Polish
  • Portuguese (Angola)
  • Portuguese (Brazil)
  • Portuguese (Portugal)
  • Romanian
  • Russian
  • Saraiki
  • Serbian
  • Sindhi
  • Slovak
  • Slovenian
  • South Azerbaijani
  • Spanish (Argentina)
  • Spanish (Colombia)
  • Spanish (Costa Rica)
  • Spanish (Dominican Republic)
  • Spanish (Ecuador)
  • Spanish (Guatemala)
  • Spanish (Chile)
  • Spanish (Mexico)
  • Spanish (Peru)
  • Spanish (Puerto Rico)
  • Spanish (Spain)
  • Spanish (Uruguay)
  • Spanish (Venezuela)
  • Swedish
  • Thai (Thailand)
  • Turkish
  • Ukrainian
  • Vietnamese

If you would like us to include a specific language, please let us know. We will release an update with the new translation files.

Community translation of Citadela theme

Citadela theme can be translated directly on WP.org by you. Join the community of translators and help us with Citadela Theme translations. It is already translated into 6 languages. These translations will be available to everybody if you switch the language of your WordPress installation. Several other languages are auto translated and are bundled in the theme package. You can use these automatic translations as a base for your own translation.

How to create multilingual website with Citadela

You can use the WPML or TranslatePress plugin to translate the Citadela website into multiple languages and run a multilingual website. Both WPML and TranslatePress allow you to translate website content and also the theme’s strings.

TranslatePress compatibility with Citadela

Citadela is fully compatible with TranslatePress plugin. Our www.ait-themes.club website is running TranslatePress plugin to manage translations.

WPML compatibility with Citadela

Citadela WordPress theme and plugins should be also compatible with the latest version of WPML plugin. It allows you to translate all conted and create multilingual website in multiple languages simultaneously.

You have to adapt some settings in WPML (for example, for the items), ex., for the coordinates, website etc., which need to be set to ‘Copy, don’t translate’. And change the configuration for the text (and subtitles) to ’translate’. You must change settings in several places, but nothing tricky.

It is also important to check the following: WPML -> Languages -> Language switcher options -> Preserve URL arguments

Please note that we are not WPML experts, we cannot help you with all the detailed WPML plugin configuration.

How to translate Citadela plugins using Loco Translate

All Citadela plugins include the translation .pot file in the ./languages subfolder. Using the .pot file you can translate words from plugin files to your language.

The easiest way to translate the plugin to your language is to use the Loco Translate plugin. You do not need to use Poedit, you do not need to generate .json files. The plugin will do all the work for you.

We recommend storing translated .po and .mo files outside of the plugin folder in the default WordPress ./languages folder. That way you will not lose any translations during plugin updates.

The translation is easy and very straightforward. Loco Translate plugin makes all the hard work of generating files for you. Simply click save and all translations are ready to use in seconds.

How to translate Citadela Listing

We recommend storing translated .po and .mo files outside of the plugin folder in the default WordPress ./languages folder. That way you will not lose any translations during plugin updates.

Loco Translate plugin can be also used to translate Citadela Listing plugin including Subscription functionality:

WordPress is also planning native support for creating and managing multilingual websites. You can read more about their plans in the official WordPress roadmap.

Citadela Subscriptions is based on WooCommerce subscriptions. In order to translate strings from this bundled code, you need to add it to Loco translate. The easiest way is to use the following configuration XML code.

Please navigate to Loco Translate > Plugins > Citadela Listing. You should see the following screen:

Click on Setup.

Click on Import config from XML and copy & past the following XML code into XML setup text area.

<?xml version="1.0" encoding="utf-8"?>
<bundle name="Citadela Listing">
  <domain name="citadela-directory">
    <project name="Citadela Listing" slug="citadela-directory">
      <source>
        <directory>.</directory>
      </source>
      <target>
        <directory>languages</directory>
      </target>
      <template>
        <file>languages/citadela-directory.pot</file>
      </template>
    </project>
  </domain>
  <domain name="woocommerce-subscriptions">
    <project name="Citadela Subscription" slug="woocommerce-subscriptions">
      <source>
        <directory>.</directory>
      </source>
      <target>
        <directory>plugin/libs/wc-subscriptions/languages</directory>
      </target>
      <template>
        <file>plugin/libs/wc-subscriptions/languages/woocommerce-subscriptions.pot</file>
      </template>
    </project>
  </domain>
</bundle>

If you have done everything correctly, you should see the following screen in Overview:

Now you can click New language to start translating Citadela Subscriptions.

How to translate Citadela Pro plugin

We recommend storing translated .po and .mo files outside of the plugin folder in the default WordPress ./languages folder. That way you will not lose any translations during plugin updates.

The following XML file can be used to automatically configured Citadela Pro plugin:

<?xml version="1.0" encoding="utf-8"?>
<bundle name="Citadela Pro">
  <domain name="citadela-pro">
    <project name="Citadela Pro" slug="citadela-pro">
      <source>
        <directory>.</directory>
      </source>
      <target>
        <directory>assets/languages</directory>
      </target>
      <template>
        <file>languages/citadela-pro.pot</file>
      </template>
    </project>
    <project name="Citadela Pro" slug="citadela-pro">
      <source>
        <directory>.</directory>
      </source>
      <target>
        <directory>languages</directory>
      </target>
      <template>
        <file>assets/languages/citadela-pro.pot</file>
      </template>
    </project>
  </domain>
</bundle>

Manual WordPress theme translation using PoEdit

Please use this translation method ONLY if you’re professional developer and you know what you are doing.

All Citadela products include the translation .pot file in the ./languages subfolder. Using the .pot file you can translate words from theme or plugin files to your language.

We recommend using Poedit translation editor to translate words from files. The editor allows you to translate words from theme or plugin .php files. After installation, go to preferences of Poedit via menu File > Preferences, and in the Editor tab of options select “Automatically compile .mo file on save” to automatically create a .mo file during saving .po file.

Once your translation is done, Poedit save your translation files with extensions .po and .mo. From the existing .pot file you will create .po and .mo file types:

  • .po file type created from .pot file and you will use this file for all further changes in translation
  • .mo file is created automatically during saving .po file, .mo file is the file which WordPress require to load translation

Names of files are very important to allow WordPress to load your translation.

  • Theme translation files would have format theme-name-{locale_CODE}.po
    – example of file name for German translation of Citadela Theme: citadela-de_DE.po
  • Plugin translation files would have format plugin-name-{locale_CODE}.po
    – example of file name for German translation of Citadela Listing plugin: citadela-directory-de_DE.po

If you are going to edit the .po file and change translations over FTP, download the .po file to your computer and edit the file locally because generated mo file is not uploaded to your server automatically with the saved .po file.

We highly recommend storing your own translation files in the Child Theme to prevent loss of your translation files with the next Theme or Plugin update. If you store translation files outside the theme or plugin folders, you will not lose translation with the next theme or plugin update.

Correct language locale codes can be found on official WordPress pages: https://make.wordpress.org/polyglots/handbook/translating/requesting-a-new-locale/#find-your-language-code

Note please that translation of words from Gutenberg editor (blocks and settings in the editor) require additional action to generate .json translation files from your translated .po files. Blocks and editor settings are based on the javascript, thus make a working translation of these words you need to follow advanced WordPress documentation: https://developer.wordpress.org/block-editor/developers/internationalization/#create-translation-file

For now, WordPress does not offer a user-friendly way to generate .json translation files for words in Javascript files. Creation of these files can be done only using WordPress Command Line Interface (WP CLI).