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

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
Наверх