Файл .section.php в 1С-Битрикс: описание и примеры использования

Файл .section.php может содержать PHP-код, который выполняется при загрузке соответствующего раздела, и позволяет динамически задавать настройки в зависимости от контекста.

Что такое .section.php?

В 1С-Битрикс .section.php – это специальный файл, который предназначен для хранения и изменения параметров конкретного раздела сайта. Он размещается непосредственно внутри папки, соответствующей нужному разделу, и позволяет задавать уникальные свойства для его страниц.

Благодаря .section.php можно задавать:

Заголовки страниц (title);
Meta-описания (description);
Ключевые слова (keywords);
Прочие пользовательские свойства, которые будут использоваться в шаблонах сайта или компонентах 1С-Битрикс.

Файл автоматически обрабатывается системой при переходе на любую страницу внутри соответствующего раздела. Если .section.php отсутствует, то 1С-Битрикс не применяет никаких дополнительных настроек к разделу.

Структура и пример кода

Основная часть настроек в .section.php хранится в виде массива $arDirProperties. Например:

<?
$sSectionName = "Наш новый раздел";
$arDirProperties = array(
   "title" => "Заголовок для раздела",
   "description" => "Краткое описание данного раздела",
   "keywords" => "битрикс, seo, пример",
   "ROBOTS" => "index, follow"
);
?>

Рассмотрим ключевые моменты:

$sSectionName
Хранит человекочитаемое название раздела, которое может выводиться в шаблонах или использоваться для навигации (breadcrumbs). Например, на странице может отображаться “Наш новый раздел” как заголовок или элемент цепочки навигации.
$arDirProperties
Ассоциативный массив, внутри которого можно задать любые свойства. Чаще всего используют:
- title: переопределяет заголовок (title) для страниц данного раздела (если не переопределено на конкретной странице).
- description: задаёт meta-описание (meta description) — важную часть SEO-оптимизации.
- keywords: ключевые слова (meta keywords), которые в современных поисковых системах уже не настолько актуальны, но иногда всё ещё используются.
- ROBOTS: директива для поисковых роботов (например, noindex, nofollow либо index, follow).
Кроме вышеперечисленных можно добавлять любые пользовательские поля:
```
<?
$arDirProperties = array(
   "UF_PRIORITY" => "high",
   "UF_COLOR" => "blue",
   "MY_CUSTOM_PROP" => "Любая произвольная информация"
);
?>
```
Затем эти поля можно использовать в различных шаблонах или компонентах, например, для отображения специального баннера на страницах конкретного раздела.

Где размещать .section.php?

Файл .section.php размещается в корне папки нужного раздела. Например, если у вас есть структура:

/catalog
    .section.php
    /electronics
        .section.php
        /smartphones
            .section.php
    /furniture
        .section.php

Файл в /catalog/.section.php будет влиять на все страницы раздела catalog. Файл в /catalog/electronics/.section.php – на все страницы внутри electronics. Аналогично с /catalog/electronics/smartphones/.section.php.

При этом, если в родительском разделе (например, electronics) заданы какие-то свойства, а в дочернем (smartphones) они не переопределены, то по умолчанию наследуются родительские настройки.

Как свойства из .section.php попадают в шаблон?

В типовых шаблонах 1С-Битрикс (например, в файле header.php) обычно есть следующие вызовы:

<?$APPLICATION->ShowTitle(false);?>
<?$APPLICATION->ShowProperty("title");?>
<?$APPLICATION->ShowProperty("keywords");?>
<?$APPLICATION->ShowProperty("description");?>

Благодаря этим методам свойства, которые мы задали в $arDirProperties, выводятся на страницу. Если для конкретной страницы задан заголовок или meta-описание вручную (через $APPLICATION->SetTitle или $APPLICATION->SetPageProperty), то они будут иметь приоритет над значениями из .section.php.

Практический пример использования

Допустим, вы хотите настроить SEO-данные для раздела “Каталог” с подразделами “Электроника” и “Смартфоны”:

Для раздела “Каталог” (/catalog/.section.php):

<?
$sSectionName = "Каталог";
$arDirProperties = array(
   "title" => "Каталог товаров",
   "description" => "Все товары нашего магазина с возможностью фильтрации и сортировки",
   "keywords" => "каталог, товары, купить"
);
?>

Для подраздела “Электроника” (/catalog/electronics/.section.php):

<?
$sSectionName = "Электроника";
$arDirProperties = array(
   "title" => "Техника и электроника",
   "description" => "Большой выбор бытовой техники и электроники",
   "keywords" => "электроника, телевизоры, смартфоны"
);
?>

Для подраздела “Смартфоны” (/catalog/electronics/smartphones/.section.php):

<?
$sSectionName = "Смартфоны";
$arDirProperties = array(
   "title" => "Смартфоны известных брендов",
   "description" => "Сравнение цен, скидки, характеристики смартфонов",
   "keywords" => "смартфоны, телефоны, бренды"
);
?>

Таким образом, если пользователь откроет раздел “Смартфоны”, то у него будут отображаться данные, указанные в файле .section.php для папки smartphones. Если в каком-то из подразделов .section.php отсутствует, система будет использовать настройки родительской папки.

Заключение

Файл .section.php – это важный инструмент для конфигурирования отдельных разделов в 1С-Битрикс. Благодаря нему можно тонко настраивать заголовки, meta-описания и любые другие свойства, которые понадобятся для шаблонов или модулей. Грамотное использование .section.php позволяет улучшить SEO-продвижение и повысить удобство работы с крупными разделами сайта, делая их более управляемыми и структурированными.

Теги: Битрикс, справочник