CMS-сообщения

CMS-сообщения - это особого вида строки. Обычно они содержат в себе строки, которые будут показаны пользователю после рендеринга html-документа.

CMS-сообщение - это строка, которая должна быть переведена на другой язык. На место CMS-сообщения в html-документ будет вставлен перевод этого сообщения на язык, в котором пользователь просматривает этот документ.

Команды вставки CMS-сообщений:

[{текст сообщения}]

Вставить перевод на текущий язык сообщения 'текст сообщения'.

Если внутри сообщения находится последовательность [var], то эта последовательность заменяется на значение соответствующей переменной.

<cms [quote=“char-list”] [vars=“var-list”]>текст сообщения</cms>

Вставить перевод на текущий язык сообщения 'текст сообщения'.

Если указано значение необязательного атрибута quote, то в переводе перед всеми символами, перечисленными в char-list будет добавлен обратный слеш (\).

Если указано значение необязательного атрибута vars, то внутри этого сообщения могут появиться переменные. В списке var-list имена переменных перечисляются через запятую. Внутри переводимого сообщения имя переменной берется в квадратные скобки ([]).

Замечание: Поскольку пользователям исходные CMS сообщения обычно не показываются, то в CMS-сообщения можно (и нужно) добавлять комментарии, которые помогут переводчику перевести это сообщение на другой язык. В качестве комментария можно, например, написать, в каком месте или в каком контексте используется это сообщение. Комментарий отделяют от сообщения вертикальной чертой ('|').

Замечание: Если перевода этого сообщение на текущий язык нет, то будет показан перевод этого сообщения на наиболее похожий язык. Если перевода этого сообщения нет ни на один язык, то будет показано исходное сообщение, в таком виде, как оно записано в шаблоне, но без комментария.

Замечание: Максимальная длина CMS-сообщения вместе с комментарием составляет 255 символов.

Предупреждение: При добавлении в шаблон новых CMS-сообщений, они автоматически записываются в базу данных. После удаления этого сообщения из шаблона они из базы данных не удаляются, поскольку невозможно определить, какие из сообщений были удалены. Постоянное изменение CMS-сообщений приведет к захламлению базы данных переводов ненужными сообщениями и повлечет за собой повышенный расход труда переводчиков. Старайтесь использовать всегда одни и те же CMS-сообщения. CMS-сообщения считаются разными, даже если они отличаются одним-единственным символом в комментарии. Не набирайте CMS-сообщения вручную, используйте буфер обмена для копирования. Будьте аккуратны при работе с CMS-сообщениями!

Пример шаблона с использованием CMS-сообщений:

[{Пароль|вставляется перед полем для ввода пароля}]: <input type=password name=pwd>

Если пользователь просматривает строку в английском языке и переводом этого CMS-сообщения является строка 'Password', то результатом интерпретации такого шаблона будет строка:

Password: <input type=password name=pwd>

CMS-сообщения можно использовать внутри значений атрибутов:

<input type=“submit” value=«[{Вход в систему|passport.login.submit}]» />

Пример шаблона с использованием CMS-сообщений, содержащих команды вставки значений переменных:

[{Введите число от [min] до [max]|приглашение}]: <input type=text name=num>

Эквивалент с использованием xml-синтаксиса:

<cms vars=“min,max”>Введите число от [min] до [max]|приглашение</cms>: <input type=text name=num>

Если пользователь просматривает строку в русском языке, переводом этого CMS-сообщения является строка 'Введите число от [min] до [max]', в шаблон переданы переменные min=10 и max=20. то результатом интерпретации такого шаблона будет строка:

Введите число от 10 до 20: <input type=text name=num>

Сотрите так же

	Статьи
	Программирование   Модули   cms   cms.template   Синтаксис шаблонов <template> Комментарии в шаблонах Пробелы и концы строк Квадратные скобки Переменные CMS-сообщения <if> FAQ

Последняя модификация: 14.08.05 22:02

Не проходите мимо! Оставьте Ваш комментарий в форуме! >>>