Translation

Оглавление

Управление мультиязычностью обеспечивается сущностью "Translation". Доступен функционал экспорта строк для переводов и их импортирования.

Страница импорта переводов (/admin/all/languages):

• Скачать строки для перевода - ссылка на экспорт переводов;
• Конечный язык - код языка, для которого выполняется импорт (ru, en и т.д.);
• Формат с оригинальными строками - строки в формате txt, каждое значение должно быть отделено двумя пустыми строками;
• Формат с переведенными строками - строки в формате txt, каждое значение должно быть отделено двумя пустыми строками.

Во время импорта переводов происходит разбиение файлов и создание массивов с исходными строками и их переведенными аналогами - поэтому важно, чтобы количество строк (объектов перевода) совпадало. Будет выполнен поиск уже существующих строк в базе данных - если найдено, выполняется обновление, иначе добавление.

Для экспорта строк доступны операции (/admin/all/languages/export и /admin/all/languages/export/hard):

• Экспорт - экспорт переводов (скачивание файлов);
• Генерация и экспорт - проход по содержимому и добавление строк в базу данных, после чего выполняется экспорт переводов (скачивание файлов).

Доступна ссылка удаления всех данных - /admin/all/languages/clear, что позволит удалить все строки и импортированные переводы.

На сайте может быть размещена языковая панель для переключения языков:

Достаточно добавить нужные языки и дописать к ссылке параметр вида ?l=*, где * - код языка (ru, en и т.д.). Кроме того, такой параметр может быть отправлен как методом GET, так и методом POST.

Стоит заметить, что переводы могут содержать код HTML и разрывы строк (не больше двух разрывов, иначе считается за следующий объект перевода):