В Joomla! 2.5 мовні файли використовуються в чотирьох різних ситуаціях:
- відображення компонента в публічній частині сайту
- управління компонентом в інтерфейсі адміністратора
- управління пунктами меню в інтерфейсі адміністратора
- установка компонента
Joomla! 2.5 використовує два різних шляхи розміщення мовних файлів:
- один в administrator / language або language
- другий в папці розширення. Якщо це компонент, то шлях буде таким: administrator / components / * component * / language або components / * component * / language
Все залежить від того, як встановлюється розширення.
Додаємо переклад для публічної частини сайту
Створіть файл site / language / en-GB / en-GB.com_helloworld.ini:
COM_HELLOWORLD_DEFAULT_PAGE_TITLE = "Hello World! Component"
COM_HELLOWORLD_ERROR_OCCURRED = "An error has occurred"
і файл site / language / ru-RU / ru-RU.com_helloworld.ini:
COM_HELLOWORLD_DEFAULT_PAGE_TITLE = "Компонент Hello World!"
COM_HELLOWORLD_ERROR_OCCURRED = "Сталася помилка"
Додаємо переклад для інтерфейсу адміністратора
Створіть файл admin / language / en-GB / en-GB.com_helloworld.ini:
COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_DESC = "This message will be displayed"
COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_LABEL = "Message"
COM_HELLOWORLD_HELLOWORLD_HEADING_GREETING = "Greeting"
COM_HELLOWORLD_HELLOWORLD_HEADING_ID = "Id"
і файл admin / language / ru-RU / ru-RU.com_helloworld.ini:
COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_DESC = "Повідомлення для відображення"
COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_LABEL = "Повідомлення"
COM_HELLOWORLD_HELLOWORLD_HEADING_GREETING = "Привітання"
COM_HELLOWORLD_HELLOWORLD_HEADING_ID = "Id"
Додаємо переклад для управління пунктами меню в інтерфейсі адміністратора
Створіть файл admin / language / en-GB / en-GB.com_helloworld.sys.ini:
COM_HELLOWORLD = "Hello World!"
COM_HELLOWORLD_DESCRIPTION = "This is the Hello World! Description"
COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_TITLE = "Message"
COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_DESC = "This view displays a selected message"
COM_HELLOWORLD_MENU = "Hello World!"
і файл admin / language / ru-RU / ru-RU.com_helloworld.sys.ini:
COM_HELLOWORLD = "Hello World!"
COM_HELLOWORLD_DESCRIPTION = "Це опис нашого компонента Hello World!"
COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_TITLE = "Повідомлення"
COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_DESC = "Цю виставу відобразить вибране повідомлення"
COM_HELLOWORLD_MENU = "Hello World!"
Варіанти розміщення мовних файлів
Починаючи з версії 1.6, існує два варіанти установки мовних файлів для розширення. Ви можете використовувати їх в різній комбінації. У версії 1.5 файли встановлювалися в основну папку мов (ROOT / administrator / language / і ROOT / language /). Новий варіант включає файли в папку "language", яка розташована в корені розширення. Таким чином, розширення може включати в себе папку мов з файлом .sys.ini. який відрізняється від того, який встановлений в основну папку мов Joomla.
sys.ini також використовується для перекладу імені розширення в деяких місцях адмінки і для перекладу меню компонента.
Таким чином xml-файл може включати:
і / або варіант версії 1.5:
або просто в корінь
Під час установки / оновлення розширення саме файл .sys.ini з папки, яка розташована в корені розширення, буде відображати результат установки з опису. Після цього (якщо є) .sys.ini і .ini. встановлені в основну папку мов, будуть мати пріоритет над файлами, які знаходяться в папці, яка розташована в корені розширення.
Одним з переваг установки файлів в папку language. яка розташована в корені розширення, є те, що ці файли не будуть зачіпатися при оновленні мовних пакетів. Іншою перевагою можна вважати те, що ця папка може містити в собі кілька мов (завжди en-GB, ru-RU, fr-FR і т.д.) і при цьому користувач не зобов'язаний встановлювати відповідний мовний пакет.
Додаємо переклад для процесу установки компонента
Створіть файл language / en-GB / en-GB.com_helloworld.sys.ini:
COM_HELLOWORLD = "Hello World!"
COM_HELLOWORLD_DESCRIPTION = "This is the Hello World description"
і файл language / ru-RU / ru-RU.com_helloworld.sys.ini
COM_HELLOWORLD = "Hello World!"
COM_HELLOWORLD_DESCRIPTION = "Це опис компонета Hello World!"
Збираємо пакет установки компонента
Не забудьте поміняти номер версії в файлі helloworld.xml:
Також ми можемо використовувати для перекладу назва компонента, опис компонента і пункт меню:
В розділ
А в розділ
У цьому helloworld.xml файлі мови встановлюються в:
Вміст директорії з кодом:
Запакуйте директорію в архівний файл (zip, tar, tar.gz, bz2) або скачайте його безпосередньо c GitHub. Далі встановіть його, використовуючи менеджер розширень Joomla. Тепер можете переконатися в тому, що переклад працює:
У наступній частині ми додамо панель управління компонентом в адмінці.