IncludeTemplateLangFile

Описание и параметры

IncludeTemplateLangFile(
	string abs_path,
	string lang = false
);

Предназначена для подключения языковых файлов для скриптов лежащих в каталоге текущего шаблона сайта. Как правило используется в компонентах, либо в прологе и/или эпилоге сайта.

Алгоритм поиска языкового файла:

Сначала языковой файл будет искаться в каталоге

/bitrix/templates/ID текущего шаблона сайта/lang/ID языка/относительный путь к скрипту
Если файл не найден, он будет искаться в каталоге

/bitrix/templates/.default/lang/ID языка/относительный путь к скрипту
Затем если файл не найден, он будет искаться дистрибутиве модуля, т.е. в каталоге

/bitrix/modules/ID модуля/install/templates/lang/ID языка/относительный путь к скрипту

В общем случае, под "относительный путь к скрипту", понимается путь к файлу относительно каталога /bitrix/templates/ID текущего шаблона сайта/.

В частном случае, при подключении компонент, под "относительный путь к скрипту", понимается путь для подключения компонента передаваемый в функцию CMain::IncludeFile в качестве первого параметра.

В новом ядре D7 имеет аналог: Bitrix\Main\Localization\Loc::loadMessages.

Параметры функции

Параметр	Описание
abs_path	Абсолютный путь к файлу, для которого необходимо подключить языковые сообщения.
lang	Идентификатор языка. Необязательный параметр, по умолчанию равен "false" (текущий язык).

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

Примеры использования

<?
// Подключим языковой файл для текущего компонента
// Предполагаем, что языковой файл расположен стандартным образом
IncludeTemplateLangFile(__FILE__);
?>