Support

Akeeba Ticket System

#38290 How-To Translate

Posted in ‘Akeeba Ticket System for Joomla! 4 & 5’
This is a public ticket

Everybody will be able to see its contents. Do not include usernames, passwords or any other sensitive information.

Environment Information

Joomla! version
4.2.6
PHP version
8.0.26
Akeeba Ticket System version
5.2.2

Latest post by nicholas on Wednesday, 11 January 2023 06:33 CST

matrox90

Hi,

i tried to check inside documentation but i cannot find anything that could help me. I need to translate Akeeba Ticket System at 100% in italian. I can do it by myself but i cannot understand how to do it. I copied com_ats.ini in en-GB folder inside an it-IT folder in the same language path, edited com_ats.ini in all of it parts but i cannot find how to apply this labels in frontend. Could you help me please?

Regards

 

Marco Gardin

nicholas
Akeeba Staff
Manager

ATS, like all of our Joomla extensions, uses the standard Joomla language management. The process to translate it is the same as any other extension.

For the component, you just need to copy language/en-GB/com_ats.ini to language/it-IT/com_ats.ini and translate it. You need to install Joomla's language pack for Italian (it-IT) and set your site's default frontend language to Italian.

Please note that if your translated file has invalid INI syntax (e.g. it's missing an opening and/or closing double quote) Joomla will silently fail to load it without giving you any indication that this happened. In this case it will fall back to the default language (English - United Kingdom, the one shipped with ATS itself). Unfortunately there is no good way to troubleshoot it that I know of :(

Nicholas K. Dionysopoulos

Lead Developer and Director

🇬🇷Greek: native 🇬🇧English: excellent 🇫🇷French: basic • 🕐 My time zone is Europe / Athens
Please keep in mind my timezone and cultural differences when reading my replies. Thank you!

matrox90

Thanks so much. Unfortunatly I've understood that translation files have to be even in component folder, even in administrator language component folder and respective joomla language folders. I've made a hard link from master file component folder in joomla language folder and start working correctly.

nicholas
Akeeba Staff
Manager

Let me try to explain in layman's terms how Joomla's \Joomla\CMS\Language\Language::load() and its use from Joomla's works.

Let's say that you want to load the Italian (it-IT) language strings for com_ats (Akeeba Ticket System), for the JPATH_BASE (the frontend of the site).

Joomla will first always load the en-GB files, then the it-IT files. This is deliberate: it gives a human-readable fallback in case you have not yet translated something in Italian e.g. if we added a new language string in the meantime.

Joomla looks for the following files, in this order:

  • language/it-IT/com_ats.ini
  • language/it-IT/it-IT.com_ats.ini
  • components/com_ats/it-IT/com_ats.ini
  • components/com_ats/it-IT/it-IT.com_ats.ini

The first one found makes the language loading process stop immediately. The other files won't be loaded.

This means that you need a total of three files for the Italian translation of ATS:

  • language/it-IT/com_ats.ini (copied from language/en-GB/com_ats.ini). This is the frontend language file.
  • administrator/language/it-IT/com_ats.ini (copied from administrator/language/en-GB/com_ats.ini). This is the backend language file.
  • administrator/language/it-IT/com_ats.sys.ini (copied from administrator/language/en-GB/com_ats.sys.ini). This is the system language file, used to display some administrator menu items, the name of the component in the Extensions, Manage page, and some component Options.

I hope this helps!

Nicholas K. Dionysopoulos

Lead Developer and Director

🇬🇷Greek: native 🇬🇧English: excellent 🇫🇷French: basic • 🕐 My time zone is Europe / Athens
Please keep in mind my timezone and cultural differences when reading my replies. Thank you!

Support Information

Working hours: We are open Monday to Friday, 9am to 7pm Cyprus timezone (EET / EEST). Support is provided by the same developers writing the software, all of which live in Europe. You can still file tickets outside of our working hours, but we cannot respond to them until we're back at the office.

Support policy: We would like to kindly inform you that when using our support you have already agreed to the Support Policy which is part of our Terms of Service. Thank you for your understanding and for helping us help you!