Меню KDT

Словарь фраз

Для добавления в шаблон многоязычных надписей или фраз, нужно использовать словарь фраз

Для того, чтобы шаблон сайта имел поддержку многоязычных надписей и фраз, в его корневой папке должен существовать один из вариантов файла словаря фраз (dictionary.xml, dictionary.json).

Управлять словарем фраз можно путем редактирования кода, нажав на кнопку "Редактировать код" в строке "Словарь фраз шаблона сайта" на странице шаблонов страниц в панели управления, либо альтернативным способом вручную.

Словарь фраз применяется к шаблону сайта сразу, как только будет создан файл, который за него отвечает.

Примеры содержимого файлов словаря фраз описаны ниже.

dictionary.xml
<?xml version="1.0" encoding="UTF-8"?>
<languages>
	<lang code="ru">
		<item key="cms.interview.head">Опрос</item>
		<item key="cms.interview.head2">Опрос2</item>
	</lang>
	<lang code="kz">
		<item key="cms.interview.head">Сауалнама</item>
		<item key="cms.interview.head2">Сауалнама2</item>
	</lang>
	<lang code="en">
		<item key="cms.interview.head">Poll</item>
		<item key="cms.interview.head2">Poll2</item>
	</lang>
</languages>
dictionary.json
{
	"ru": {
		"cms.interview.head": "Опрос",
		"cms.interview.head2": "Опрос2"
	},
	"kz": {
		"cms.interview.head": "Сауалнама",
		"cms.interview.head2": "Сауалнама2"
	},
	"en": {
		"cms.interview.head": "Poll",
		"cms.interview.head2": "Poll2"
	}
}
dictionary.php
В целях безопасности на данный момент запрещен для использования, и в случае попытки использования, не применится и ничего не даст.
<?php
	return [
		'ru' => [
			'cms.polls.head' => 'Опрос',
			'cms.polls.head2' => 'Опрос2',
		],
		'kz' => [
			'cms.polls.head' => 'Сауалнама',
			'cms.polls.head2' => 'Сауалнама2',
		],
		'en' => [
			'cms.polls.head' => 'Poll',
			'cms.polls.head2' => 'Poll2',
		],
	];
?>
Код обязательно должен обладать отступом (tabs).

При этом:

  • 'ru''kz''en' - коды языков
  • 'cms.polls.head''cms.polls.head2' - имена переменных, которые должны быть уникальными
  • 'Сауалнама''Опрос''Poll' - это надписи, которые меняются при смене языков

Для вывода фразы на странице, необходимо прописать в нужном участке кода следующее:

Виджет не найден
{{translate['cms.polls.head']}}
 В папке с шаблоном могут находиться и .xml файл и .json файл и .php файл. Сначала считывается .xml файл, затем .json, затем .php. Если файлов словарей фраз нет, в массив {{translate}} ничего не загружается. Если имеется несколько файлов словарей фраз, данные из файла .json заменятся данными из файла .php, а данные из файла .xml заменятся данными из файла .json (.xml < .json < .php).