Skip to content

Language Apps

Jump to bottom Edit New page
kisonik edited this page Jan 16, 2023 · 20 revisions

The purpose of the Language Apps is to translate all customizable interface text strings into a different language. Such text strings include buttons, menu items, alerts, forms, page block titles, email templates and so forth. Every installed language in UNA is under control of the Polyglot system app where you can add new language keys or edit the existing ones. By default, the English and Russian language apps are available in UNA.

Creating a copy of the English app

While you can use the Polyglot to make small edits, but when it comes to editing hundreds of language strings, working in the Polygot will become tedious and time consuming. So, in this case, creating a copy of an existing language app will be a more straightforward process. Let's create a copy of the English app as an example.

  1. Use your favorite FTP manager to navigate to the English app location, which is modules -> boonex -> english. Download the whole folder to your local computer. Alternatively, you can download the zipped version of the app from the UNA Market (if you know the exact app version), then unzip it.

  2. Edit the file install -> config.php. Here you will have to change some member values of the $aConfig array. All the suggested values here are optional. The goal here is to use something different and unique

    • 'vendor' -> change the value to your own name, for example 'John Doe'
    • 'name' -> change the value to 'johndoe_en'
    • 'title' -> change the value to 'English (Custom)'
    • 'help_url' -> change the value to your own URL, for example 'http://mysite.com'
    • 'home_dir' -> change the value to 'johndoe/english/'
    • 'home_uri' -> change the value to 'en1'
    • 'db_prefix' -> change the value to 'johndoe_eng_'
    • 'class_prefix' -> change the value to 'JohnDoeEng'
    • 'language_category' -> change the value to 'John Doe English'

    Save the file.

  3. Edit the file install -> langs -> en:

    • inside the resources tag change the following attribute value:
      • title -> change the value to John Doe English
    • "_bx_eng_wgt_cpt" -> change to "_johndoe_eng_wgt_cpt"
    • "_bx_eng_stg_cpt_type" -> change to "_johndoe_eng_stg_cpt_type"
    • "_bx_eng_stg_cpt_category_system" -> change to "_johndoe_eng_stg_cpt_category_system"

    In other words, you will need to replace the default db_prefix "bx_eng_" with your custom one "johndoe_eng_".

    You may also want to change the string values inside the ![CDATA[]] tags in this file but it is not necessary.

    Save the file.

  4. Now you need to edit the module's utility SQL files which will be used to install, uninstall, enable and disable your module in the Studio. Edit the following file and their contents:

    • install -> sql -> install.sql
      • search for bx_en and replace all the occurencies with johndoe_en
      • search for 'en' and replace all the occurencies with 'en1'
      • search for modules/boonex/english and replace all the occurencies with modules/johndoe/english
    • install -> sql -> uninstall.sql, install -> sql -> enable.sql, install -> sql -> disable.sql
      • search for bx_en and replace all the occurencies with johndoe_en
      • search for 'en' and replace all the occurencies with 'en1'

    Also change the module's installation file install -> installer.php

    • replace BxEngInstaller with JohnDoeEngInstaller

    Save the files.

  5. Now it's time to edit the language strings themselves. Rename the file data -> langs -> system -> en to en1 and edit it:

    • inside the resources tag change the following attribute values:

      • name -> change the value to en1
      • title -> change the value to John Doe English

    • change the values for the language strings you wish to edit. Change only the values of <![CDATA[]]> tags. For example:

      old string: <![CDATA[Message was successfully sent.]]>

      new string: <![CDATA[Hooray! Message was successfully sent.]]>

    Save the file.

  6. If you want to provide translations for modules other than system, create folders in the folder data -> langs with the names corresponding to the modules names, for example data -> langs -> bx_accounts. Copy the English language file for the module and put it inside the newly created folder with the new name en1. Module's language files are usually located in the folder install -> langs. Return to the step 5) to change the contents of the new file.

  7. Now you can upload the results on the server.

    • Create the folder johndoe inside the modules folder
    • Upload the whole english folder from your local computer to the johndoe folder on the server.

  8. Go to Studio -> Apps Market -> Downloaded and install your new language app from there.

Creating a new language app

When creating a new language app, you can slightly modify the steps used for the custom English language with some additions. I will provide all the steps again and take the French language file as an example.

  1. Use your favorite FTP manager to navigate to the English app location, which is modules -> boonex -> english. Download the whole folder to your local computer. Alternatively, you can download the zipped version of the app from the UNA Market (if you know the exact app version), then unzip it. Rename the folder english to french.

  2. Edit the file install -> config.php. Here you will have to change some member values of the $aConfig array. All the suggested values here are optional. The goal here is to use something different and unique

    • 'vendor' -> change the value to your own name, for example 'Jean Dubois'
    • 'name' -> change the value to 'jeandubois_fr'
    • 'title' -> change the value to 'French'
    • 'help_url' -> change the value to your own URL, for example 'http://mysite.com'
    • 'home_dir' -> change the value to 'jeandubois/french/'
    • 'home_uri' -> change the value to 'fr'
    • 'db_prefix' -> change the value to 'jeandubois_fr_'
    • 'class_prefix' -> change the value to 'JeanDuboisFr'
    • 'language_category' -> change the value to 'French'

    Save the file.

  3. Edit the file install -> langs -> en (use some editor which supports UTF-8 without BOM, such as Notepad++):

    • inside the resources tag change the following attribute value:
      • title -> change the value to French
    • "_bx_eng_wgt_cpt" -> change to "_jeandubois_fr_wgt_cpt"
    • "_bx_eng_stg_cpt_type" -> change to "_jeandubois_fr_stg_cpt_type"
    • "_bx_eng_stg_cpt_category_system" -> change to "_jeandubois_fr_stg_cpt_category_system"

    In other words, you will need to replace the default db_prefix "bx_eng_" with your custom one "jeandubois_fr_".

    Also change the string values inside the ![CDATA[]] tags in this file, for example:

    old string: <![CDATA[French]]>

    new string: <![CDATA[Français]]>

    Save the file.

  4. Now you need to edit the module's utility SQL files which will be used to install, uninstall, enable and disable your module in the Studio. Edit the following file and their contents:

    • install -> sql -> install.sql
      • search for bx_en and replace all the occurencies with jeandubois_fr
      • search for 'en' and replace all the occurencies with 'fr'
      • search for modules/boonex/english and replace all the occurencies with modules/jeandubois/french
    • install -> sql -> uninstall.sql, install -> sql -> enable.sql, install -> sql -> disable.sql
      • search for bx_en and replace all the occurencies with jeandubois_fr
      • search for 'en' and replace all the occurencies with 'fr'

    Also change the module's installation file install -> installer.php

    • replace BxEngInstaller with JeanDuboisFrInstaller

    Save the files.

  5. Now it's time to edit the language strings themselves. Rename the file data -> langs -> system -> en to fr and edit it (use some editor which supports UTF-8 without BOM, such as Notepad++):

    • inside the resources tag change the following attribute values:

      • name -> change the value to fr
      • title -> change the value to French
      • flag -> change the value to fr

    • change the values for the language strings you wish to edit. Change only the values of <![CDATA[]]> tags. For example:

      old string: <![CDATA[Message was successfully sent.]]>

      new string: <![CDATA[Le message a été envoyé avec succès.]]>

    Save the file.

  6. If you want to provide translations for modules other than system, create folders in the folder data -> langs with the names corresponding to the modules names, for example data -> langs -> bx_accounts. Copy the English language file for the module and put it inside the newly created folder with the new name fr. Module's language files are usually located in the folder install -> langs. Return to the step 5) to change the contents of the new file.

  7. As soon as the icon for the module you're creating will differ from the English one, you need to edit the SVG icon located here template -> images -> icons -> std-icon.svg.

  8. Now you can upload the results on the server.

    • Create the folder jeandubois inside the modules folder
    • Upload the whole french folder from your local computer to the jeandubois folder on the server.

  9. Go to Studio -> Apps Market -> Downloaded and install your new language app from there.

IMPORTANT NOTE: documentation was moved here - https://una.io/wiki/Introduction

Add a custom sidebar
Clone this wiki locally