Документация для разработчиков
Темная тема

IncludeTemplateLangFile

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

IncludeTemplateLangFile(
	string abs_path,
	string lang = false
);

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

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

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

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

  2. Если файл не найден, он будет искаться в каталоге

    /bitrix/templates/.default/lang/ID языка/относительный путь к скрипту

  3. Затем если файл не найден, он будет искаться дистрибутиве модуля, т.е. в каталоге

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

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

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

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

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

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

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

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


© «Битрикс», 2001-2024, «1С-Битрикс», 2024