Update missing or incorrectly translated terms in local translation

In case you need to update the existing local translation of the plugin, please follow these steps:

  1. Download Necessary Tools: Before starting the translation of the WordPress plugin, ensure you have the Poedit application. You can download it for free from here. Additionally, download the original translation files from here. Extract the contents of the archive to access the PO and MO translation files. The PO file contains the source translation files, while the MO file contains the compiled translation files. Edit the specific PO file corresponding to your website's locale. For example, the German translation file may be named as booking-de_DE.po, and the Spanish translation file may be named as booking-es_ES.po. Find the full list of locales in WordPress on this page.
  2. Placeholder Variables: Be attentive to placeholders for variables such as %s, %d, %f, etc. Ensure that you maintain the placeholders in the same position as in the original translation line. The number of placeholders must be consistent with the original translations. For more detailed information about placeholders for variables in translations, check here.
  3. Using Poedit:
    • Start the Poedit program.
    • Click on "Browse Files" or select File > Open from the menu, or press Ctrl + O.
    • Find the specific PO file of Booking Calendar, such as booking-nl_NL.po.
    • Locate untranslated or incorrectly translated terms and update the translations.
    • Ensure that you do not set specific translation lines as "Need to work" or "Fuzzy." You can check this under the "Edit" menu > "Translation need to work" (Ctrl + U).
    • Save the file after translation.
  4. Send Updated Translation: Send your updated translation file (*.po) to info@wpbookingcalendar.com. We will update the translation on the server. Once updated, you can update this translation in the WP Booking Calendar > Settings General page in the "Translation" section, as described in this FAQ guide.

Refreshing Local Translations in the Booking Calendar Plugin

How to  update Local trnasaltions in Booking Calendar plugin

To update the local translation files in the Booking Calendar plugin, follow these steps:

  1. Navigate to WP Booking Calendar > Settings General page in the "Translation" section.
  2. For the option "Firstly load translation," select the "Local" value.
  3. Click on the "Save Changes" button.

After saving the changes, click on the "Update Translations" button. Wait for the system to download and update the translation files. Once the update is complete, test the new translation to ensure it is working correctly.

To select a specific language in WordPress admin panel:

- Open the WordPress > Settings > General page.
- In the "Site Language" option, select your preferred language.

OR

- If you use a translation plugin, select the specific language from the menu of your translation plugin.

How to get active locale (language) of the page, from where visitor submit booking?

On the Booking Listing page exist ability to change language (locale) of emails, that will send to visitor during approving or declining of the booking. But how to detect language/locale of webpage, from where visitor submit the booking.
Here is instruction how to do this.
Please open the Booking > Settings > Fields page and add to the booking form this shortcode and JavaScript code:

<div style="display:none;"> Active Language: [text active_language class:wpbc_lang_field]</div>
<script type="text/javascript">
 jQuery(document).ready(function(){
    jQuery('.wpbc_lang_field').val( wpbc_active_locale );
 });
</script>

Its will add to your booking form new field [active_language] and JavaScript for auto-inserting active locale into this field. Please note, this field is not visible for visitors, because of this CSS: style="display:none;"

Also you will be need to add to the "Content of booking fields data" form (its at the bottom of Booking > Settings > Fields page) this shortcode:

<strong>Active Language</strong>:<span class="fieldvalue">[active_language]</span>

For showing this field at the Booking Listing page.

Available translations for paid versions and progress of translation

There are 2 types of Booking Calendar translations.

1) One list of translations located at WordPress repository. Please note, these translations at your website should be located at: "../wp-content/languages/plugins/" folder.

2) Another list of translations located at the Booking Calendar website. You can download the original PO translations files from here. Please note, these translations at your website should be located at: "../wp-content/plugins/{Booking Calendar Folder}/languages/" folder.

By default Booking Calendar plugin try to use translations from "../wp-content/languages/plugins/",
if failed (not exist), then try to use translations from "../wp-content/plugins/{Booking Calendar Folder}/languages/" folder.
This behavior is possible to change at the Booking > Settings General page in the Translation section.

You can check instruction how to make or update local plugin translation files at this page.

Translations available in paid versions of Booking Calendar:

English - 100%
German 99.55% [ 2198 / 2208 ], fuzzy 8, not translated 2
Dutch 99.23% [ 2202 / 2219 ], fuzzy 16, not translated 1
Hungarian 95.91% [ 2108 / 2198 ], fuzzy 63, not translated 27
French (France) 95.8% [ 2101 / 2193 ], fuzzy 89, not translated 3
Spanish (Spain) 88.77% [ 1944 / 2190 ], fuzzy 82, not translated 164
Greek 84.38% [ 1847 / 2189 ], fuzzy 221, not translated 121
Turkish 83.28% [ 1823 / 2189 ], fuzzy 239, not translated 127
Portuguese (Brazil) 82.12% [ 1805 / 2198 ], fuzzy 255, not translated 138
Italian 80.95% [ 1772 / 2189 ], fuzzy 128, not translated 289
Romanian 75.15% [ 1645 / 2189 ], fuzzy 349, not translated 195
Arabic 74.83% [ 1638 / 2189 ], fuzzy 355, not translated 196
Spanish (Mexico) 74.6% [ 1633 / 2189 ], fuzzy 365, not translated 191
Finnish 74.4% [ 1636 / 2199 ], fuzzy 369, not translated 194
Swedish 74.1% [ 1622 / 2189 ], fuzzy 365, not translated 202
Norwegian (Bokmål) 73.69% [ 1613 / 2189 ], fuzzy 376, not translated 200
Polish 73.46% [ 1611 / 2193 ], fuzzy 375, not translated 207
Slovenian 72.68% [ 1591 / 2189 ], fuzzy 386, not translated 212
Danish 69.07% [ 1512 / 2189 ], fuzzy 437, not translated 240
Bulgarian 69.03% [ 1511 / 2189 ], fuzzy 432, not translated 246
Chinese (Taiwan) 67.43% [ 1476 / 2189 ], fuzzy 483, not translated 230
Russian 65.92% [ 1449 / 2198 ], fuzzy 482, not translated 267
Portuguese (Portugal) 65.56% [ 1435 / 2189 ], fuzzy 485, not translated 269
Galician 65.46% [ 1433 / 2189 ], fuzzy 492, not translated 264
Thai 65.37% [ 1431 / 2189 ], fuzzy 483, not translated 275
Hebrew 63.32% [ 1386 / 2189 ], fuzzy 489, not translated 314
Chinese (China) 62.72% [ 1373 / 2189 ], fuzzy 494, not translated 322
Ukrainian 62.51% [ 1374 / 2198 ], fuzzy 506, not translated 318
Croatian 53.86% [ 1179 / 2189 ], fuzzy 481, not translated 529
Slovak 53.81% [ 1178 / 2189 ], fuzzy 484, not translated 527
Czech 53.77% [ 1177 / 2189 ], fuzzy 481, not translated 531
Catalan 53.63% [ 1174 / 2189 ], fuzzy 485, not translated 530

Different Languages on the same website

Paid versions of Booking Calendar support configuration in different languages of the booking form, email templates and some other text options in the settings . The active language of the booking form depends on the active locale of the site.

Booking Calendar supports WPML and Polylang plugins for dynamic changing of website locale (language).

General Usage:
[lang=LOCALE] - start a new translation section in a specific language, where LOCALE - locale of the translation.

Example of English and French translation of "Thank you" message:

Thank you for your booking.[lang=fr_FR]Je vous remercie de votre réservation.
-

Important!
Please note, English language is the default language in the Booking Calendar plugin. You need to start with English section (without [lang=...] shortcode at the top of form), and then continue with all other language sections divided by shortcode [lang=LOCALE],  where LOCALE its locale of specific language,  like de_DE,  or es_ES,  etc...

Of course you can have more than 2 language sections.

Example of configuration booking form in English and French languages at the Booking > Settings > Fields page:

[calendar]
First Name (required): [text* name]
Last Name (required): [text* secondname]
Email (required): [email* email]
Visitors: [select visitors "1" "2" "3" "4"]
Details: [textarea details]
[submit "Send"]
[lang=fr_FR]
[calendar]
Prénom (obligatoire): [text* name]
Deuxième prénom (requis) [text* secondname]
Email (obligatoire) [email* email]
Visiteurs : [select visitors "1" "2" "3" "4"]
Détails : [textarea details]
[submit "Envoyer"]

In the same way, you can configure the email templates on the Booking > Settings > Emails page and search form on the Booking > Settings > Search page, etc..

How to Make a New Translation of the Plugin

Follow these steps to create a new translation of the WordPress plugin:

  1. Download Necessary Tools: Before starting the translation of the WordPress plugin, ensure you have the Poedit application. You can download it for free from here. Additionally, download the original translation files from here.
  2. Using Poedit:

    • Start the Poedit program.
    • Select File -> New catalog from POT file from the menu and choose the POT file for translation, usually located inside the languages folder, which you downloaded at previous point.
    • Type a description for your translation.
    • Enter the name of the PO file. The name consists of two parts:
      • The filename of the plugin (in this case, "booking").
      • The Locale (for example, for Spanish translation: "es_ES"). So, the name would be "booking-es_ES.po". Find the full list of locales in WordPress on this page.
    • Save the file to the "languages" folder of the plugin.
  3. Translation Process:

    • Begin the translation.
    • Placeholder Variables: Be attentive to placeholders for variables such as %s, %d, %f, etc. Ensure that you maintain the placeholders in the same position as in the original translation line. The number of placeholders must be consistent with the original translations. For more detailed information about placeholders for variables in translations, check here.
    • Ensure that you do not set specific translation lines as "Need to work" or "Fuzzy." You can check this under the "Edit" menu > "Translation need to work" (Ctrl + U).
    • Save the file after translation.
  4. Submit Your Translation:

    • Send your updated translation file (*.po) to info@wpbookingcalendar.com. We will update the translation on the server. Once updated, you can update this translation in the WP Booking Calendar > Settings General page in the "Translation" section, as described in this FAQ guide.