В рамках этого урока мы создадим простой компонент-болванку. Он не будет содержать особой логики и даже не будет иметь особенного шаблона - его задача будет вызывать 2 других компонента и передавать в них определённые параметры. Мы реализуем 2-х колоночный список с возможностью выбора типа выводимых данных для каждой колонки: элементы и/или разделы инфоблока.
Каркас нового компонента 1С-Битрикс
Для начала создадим собственное пространство имён компонентов. Для этого в папке /bitrix/components/ создадим папку coffeediz (название папки и будет пространством имён).
Теперь в папке пространства имён компонентов /bitrix/components/coffeediz/ создадим папку с названием нашего нового компонента elements_and_categories.list.
В папке компонента /bitrix/components/coffeediz/elements_and_categories.list/ создаём файл .description.php следующего содержания:
<?
if (!defined("B_PROLOG_INCLUDED") || B_PROLOG_INCLUDED!==true) die();
$arComponentDescription = array(
"NAME" => GetMessage("ELEMENTS_AND_CATEGORIES_LIST"), //Название компонента
"DESCRIPTION" => GetMessage("ELEMENTS_AND_CATEGORIES_LIST_DESC"), //Описание
"ICON" => "/images/elements_and_categories_list.gif", //Иконка компонента для виз редактора
"SORT" => 70, //индекс сортировки, задающий положение компонента в конечной ветки дерева
"CACHE_PATH" => "Y",
"PATH" => array( //расположение в дереве компонентов визуального редактора
"ID" => "content", //Код ветки дерева "Контент"
"CHILD" => array(
"ID" => "news", //Код ветки дерева "Статьи и Новости" в ветке "Контент"
"NAME" => GetMessage("T_IBLOCK_DESC_NEWS"),
"SORT" => 10,
),
),
);
?>В папку /bitrix/components/coffeediz/elements_and_categories.list/images/ мы положим картинку, которую будем использовать в качестве иконки в виз редакторе (как можно видеть выше в .description.php можно вызвать файл с любым именем в качестве иконки) - elements_and_categories_list.gif.
Размер и вид иконки могут быть любыми, однако, мы рекомендуем придерживаться стилистики дефолтных иконок 1С-Битрикс.
Не забудем о необходимости создать языковые файлы (подключаются автоматически при размещении в папке компонента /lang/ИД_языка/ файлов с таким же названием как и те, где используются языковые фразы.
Для русского языка (/bitrix/components/coffeediz/elements_and_categories.list/lang/ru/.description.php):
<?
$MESS ['ELEMENTS_AND_CATEGORIES_LIST'] = "2-х колоночный список";
$MESS ['ELEMENTS_AND_CATEGORIES_LIST_DESC'] = "2-х колоночный список, выводящий в каждой колонке список элементов/разделов инфоблока на выбор";
$MESS ['T_IBLOCK_DESC_NEWS'] = "Статьи и новости";
?>Для английского языка (/bitrix/components/coffeediz/elements_and_categories.list/lang/en/.description.php):
<?
$MESS ['ELEMENTS_AND_CATEGORIES_LIST'] = "2 column list";
$MESS ['ELEMENTS_AND_CATEGORIES_LIST_DESC'] = "2 column list of elements/categories of Infoblock";
$MESS ['T_IBLOCK_DESC_NEWS'] = "News";
?>Поскольку файл component.php (файл с ЛОГИКОЙ) является обязательным согласно архитектуре 1С-Битрикс, то наш компонент не появится в визуальном редакторе до тех пор, пока мы его не создадим.
Однако поскольку наша задумка не предполагает никакой логики (мы просто передадим параметры нашего компонента в шаблон к вызываемым там компонентам), то мы оставим его ПУСТЫМ.Это может показаться странным (и кто-то из бывалых возможно нас осудит), но далее мы увидим, что это оправдано!
В результате увидим такую картинку в визуальном редакторе 1С-Битрикс:
Параметры нового компонента 1С-Битрикс
Создадим файл /bitrix/components/coffeediz/elements_and_categories.list/.parameters.php с параметрами компонента.
Поскольку у нас планируется работа с инфоблоками необходимо (сразу после проверки пролога) поставить проверку наличия в системе модуля инфоблоков:
if(!CModule::IncludeModule("iblock"))
return;Далее считаем в переменную данные о всех типах инфоблоков:
$arTypesEx = CIBlockParameters::GetIBlockTypes(Array("-"=>" "));Далее в отдельную переменную считаем данные об инфоблоках в системе.
Поскольку мы будем использовать архитектурное решение, аналогичное компонента bitrix:news.list, то тип инфоблока будет только справочным значением, которое будет использоваться для фильтрафии списка инфоблоков в целях упрощения работы администратора при изменении параметров компонента. Поэтому мы не просто считаем данные об инфоблоках и выберем ID, а скорректируем их в зависимости от выбранного в параметре "Тип инфоблока" значения:
$arIBlocks1col=Array();
$db_iblock = CIBlock::GetList(Array("SORT"=>"ASC"), Array("SITE_ID"=>$_REQUEST["site"], "TYPE" => ($arCurrentValues["1COLUMN_IBLOCK_TYPE"]!="-"?$arCurrentValues["1COLUMN_IBLOCK_TYPE"]:"")));
while($arRes = $db_iblock->Fetch())
$arIBlocks1col[$arRes["ID"]] = $arRes["NAME"];
Как видите в ряде переменных мы используем идентификатор 1 - он указывает на то, что мы выбираем ID инфоблока для 1й (левой колонки). Аналогичный код, но с 2 будет выбирать ID инфоблока для 2й колонки.
Теперь зададим сами параметры.
В отличие от шаблона компонента параметры самого компонента хранятся в виде массива в другой переменной - $arComponentParameters.
Во-первых, зададим 2 дополнительные группы параметров (мы будем хранить отдельно основные параметры и параметры, характерные для каждой из колонок для того, чтобы их удобнее было редактировать):
"GROUPS" => array(
"1COLUMN" => array(
"NAME" => GetMessage("1COLUMN_PARAMETERS")
),
"2COLUMN" => array(
"NAME" => GetMessage("2COLUMN_PARAMETERS")
),
),Во-вторых, зададим массив основных параметров, идентичным тем, что мы использовали в 10 уроке (Заголовок списка, текст перед списком и ссылка после списка) в массиве PARAMETERS:
"2_COL_TITLE" => Array(
"PARENT" => "BASE",
"NAME" => GetMessage("2_COL_TITLE"),
"TYPE" => "HTML",
"DEFAULT" => "Наши Возможности",
),
"2_COL_INTRO_TEXT" => Array(
"PARENT" => "BASE",
"NAME" => GetMessage("2_COL_INTRO_TEXT"),
"TYPE" => "HTML",
"DEFAULT" => "В данном двухколоночном списке представлены возможности данного шаблона, которые вы можете штатно использовать без дополнительных доработок.",
),
"2_COL_MORE_NAME" => Array(
"PARENT" => "BASE",
"NAME" => GetMessage("2_COL_MORE_NAME"),
"TYPE" => "HTML",
"DEFAULT" => "Ещё",
),
"2_COL_MORE_LINK" => Array(
"PARENT" => "BASE",
"NAME" => GetMessage("2_COL_MORE_LINK"),
"TYPE" => "HTML",
"DEFAULT" => "#",
),В-третьих (так же в массиве PARAMETERS) зададим выбор типа для колонки.
Мы предусмотрим для каждой из колонок 2 типа: элементы или разделы инфоблока.
Не забудем и о том, что после изменения значения каждого из этих свойств необходимо будет перезагрузить список параметров компонента (в зависимости от типа может меняться набор параметров для каждой конкретной колонки). За это отвечает параметр "REFRESH" => "Y".
Соответственно, реализацию мы сделаем через свойства типа "список" с 2 предопределёнными значениями, которые зададим в виде массива в свойстве VALUES:
"1COLUMN_TYPE" => array(
"PARENT" => "BASE",
"NAME" => GetMessage("1COLUMN_TYPE"),
"TYPE" => "LIST",
"VALUES" => array(
"COLUMN_TYPE_ELEMENT" => GetMessage("COLUMN_TYPE_ELEMENT"),
"COLUMN_TYPE_CATEGORY" => GetMessage("COLUMN_TYPE_CATEGORY")
),
"REFRESH" => "Y"
),
"2COLUMN_TYPE" => array(
"PARENT" => "BASE",
"NAME" => GetMessage("2COLUMN_TYPE"),
"TYPE" => "LIST",
"VALUES" => array(
"COLUMN_TYPE_ELEMENT" => GetMessage("COLUMN_TYPE_ELEMENT"),
"COLUMN_TYPE_CATEGORY" => GetMessage("COLUMN_TYPE_CATEGORY")
),
"REFRESH" => "Y"
),И, наконец, в-четвёртых, зададим параметры типа и ID инфоблока для каждой из колонок. Мы сделаем это сейчас в общем списке параметров потому, что вне зависимости от типа (элементы или разделы инфоблока) данных в колонке знать ID инфоблока нам необходимо.
Значения типа и ID инфоблоков из системы мы получили выше, так что код будет выглядеть даже проще, чем задание списка типов колонок:
"1COLUMN_IBLOCK_TYPE" => Array(
"PARENT" => "1COLUMN",
"NAME" => GetMessage("1COLUMN_IBLOCK_TYPE"),
"TYPE" => "LIST",
"VALUES" => $arTypesEx,
"DEFAULT" => "news",
"REFRESH" => "Y",
),
"1COLUMN_IBLOCK_ID" => Array(
"PARENT" => "1COLUMN",
"NAME" => GetMessage("1COLUMN_IBLOCK_ID"),
"TYPE" => "LIST",
"VALUES" => $arIBlocks1col,
"DEFAULT" => '={$_REQUEST["ID"]}',
"ADDITIONAL_VALUES" => "Y",
"REFRESH" => "Y",
),
"2COLUMN_IBLOCK_TYPE" => Array(
"PARENT" => "2COLUMN",
"NAME" => GetMessage("2COLUMN_IBLOCK_TYPE"),
"TYPE" => "LIST",
"VALUES" => $arTypesEx,
"DEFAULT" => "news",
"REFRESH" => "Y",
),
"2COLUMN_IBLOCK_ID" => Array(
"PARENT" => "2COLUMN",
"NAME" => GetMessage("2COLUMN_IBLOCK_ID"),
"TYPE" => "LIST",
"VALUES" => $arIBlocks2col,
"DEFAULT" => '={$_REQUEST["ID"]}',
"ADDITIONAL_VALUES" => "Y",
"REFRESH" => "Y",
),На этом мы пока закончим работу с массивом PARAMETERS (возможно мы вернёмся к нему, задав какие-то параметры далее, общие для компонента вне зависимости от типа выводимых данных, например тип и время кеширования).
Теперь зададим необходимые параметры для каждой из колонок.
Для этого нам необходимо понимать, что возможны 4 вариант вывода данных в нашем списке:
- 1-я колонка - элементы инфоблока, 2-я колонка - элементы инфоблока;
- 1-я колонка - элементы инфоблока, 2-я колонка - разделы инфоблока;
- 1-я колонка - разделы инфоблока, 2-я колонка - элементы инфоблока;
- 1-я колонка - разделы инфоблока, 2-я колонка - разделы инфоблока.
В зависимости от значения параметра с типом для каждой из колонок мы можем вывести одну из 2 групп параметров для данной колонки с помощью простого кода:
if ($arCurrentValues["1COLUMN_TYPE"] == "COLUMN_TYPE_ELEMENT")
{
}
else
{
}
if ($arCurrentValues["2COLUMN_TYPE"] == "COLUMN_TYPE_ELEMENT")
{
}
else
{
}
Компонент списка новостей поддерживает возможность указания количества выводимых элементов, поэтому в параметрах компонентов необходимо задать это значение. Воспользуемся для этого указанной выше логикой, позволяющей задать параметры при установке переключателя в положение тип колонки = элементы:
$arComponentParameters["PARAMETERS"]["1COLUMN_NEWS_COUNT"] = array(
"PARENT" => "1COLUMN",
"NAME" => GetMessage("1COLUMN_NEWS_COUNT"),
"TYPE" => "STRING",
"DEFAULT" => "5",
);Синим выделены параметры, относящие переменные к 1 колонке. Для второй колонки используем аналогичную конструкцию с 2.
Для компонента списка разделов инфоблока мы так же зададим 2 специфичных параметра: глубина вложенности разделов инфоблока и флаг вывода количества элементов в разделе.
$arComponentParameters["PARAMETERS"]["1COLUMN_COUNT_ELEMENTS"] = array(
"PARENT" => "1COLUMN",
"NAME" => GetMessage("1COLUMN_COUNT_ELEMENTS"),
"TYPE" => "CHECKBOX",
"DEFAULT" => 'Y',
);
$arComponentParameters["PARAMETERS"]["1COLUMN_TOP_DEPTH"] = array(
"PARENT" => "1COLUMN",
"NAME" => GetMessage("1COLUMN_TOP_DEPTH"),
"TYPE" => "STRING",
"DEFAULT" => '2',
);И вновь мы выделили цветом принадлежность к 1 (левой) колонке. Для правой колонки везде должно быть 2.
Мы специально не рассматриваем реализацию других параметров (их и так уже немало), чтобы не усложнять излишне урок!
Вы можете самостоятельно скопировать шаблон компонента в шаблон сайта и дополнить .parameters.php другими параметрами, которые умеют принимать компоненты списка разделов и списка новостей.
Результирующий вид /bitrix/components/coffeediz/elements_and_categories.list/.parameters.php:
<?
if (!defined("B_PROLOG_INCLUDED") || B_PROLOG_INCLUDED!==true) die();
if(!CModule::IncludeModule("iblock"))
return;
$arTypesEx = CIBlockParameters::GetIBlockTypes(Array("-"=>" "));
$arIBlocks1col=Array();
$db_iblock = CIBlock::GetList(Array("SORT"=>"ASC"), Array("SITE_ID"=>$_REQUEST["site"], "TYPE" => ($arCurrentValues["1COLUMN_IBLOCK_TYPE"]!="-"?$arCurrentValues["1COLUMN_IBLOCK_TYPE"]:"")));
while($arRes = $db_iblock->Fetch())
$arIBlocks1col[$arRes["ID"]] = $arRes["NAME"];
$arIBlocks2col=Array();
$db_iblock = CIBlock::GetList(Array("SORT"=>"ASC"), Array("SITE_ID"=>$_REQUEST["site"], "TYPE" => ($arCurrentValues["2COLUMN_IBLOCK_TYPE"]!="-"?$arCurrentValues["2COLUMN_IBLOCK_TYPE"]:"")));
while($arRes = $db_iblock->Fetch())
$arIBlocks2col[$arRes["ID"]] = $arRes["NAME"];
$arComponentParameters = array(
"GROUPS" => array(
"1COLUMN" => array(
"NAME" => GetMessage("1COLUMN_PARAMETERS")
),
"2COLUMN" => array(
"NAME" => GetMessage("2COLUMN_PARAMETERS")
),
),
"PARAMETERS" => array(
"2_COL_TITLE" => Array(
"PARENT" => "BASE",
"NAME" => GetMessage("2_COL_TITLE"),
"TYPE" => "HTML",
"DEFAULT" => "Наши Возможности",
),
"2_COL_INTRO_TEXT" => Array(
"PARENT" => "BASE",
"NAME" => GetMessage("2_COL_INTRO_TEXT"),
"TYPE" => "HTML",
"DEFAULT" => "В данном двухколоночном списке представлены возможности данного шаблона, которые вы можете штатно использовать без дополнительных доработок.",
),
"2_COL_MORE_NAME" => Array(
"PARENT" => "BASE",
"NAME" => GetMessage("2_COL_MORE_NAME"),
"TYPE" => "HTML",
"DEFAULT" => "Ещё",
),
"2_COL_MORE_LINK" => Array(
"PARENT" => "BASE",
"NAME" => GetMessage("2_COL_MORE_LINK"),
"TYPE" => "HTML",
"DEFAULT" => "#",
),
"1COLUMN_TYPE" => array(
"PARENT" => "BASE",
"NAME" => GetMessage("1COLUMN_TYPE"),
"TYPE" => "LIST",
"VALUES" => array(
"COLUMN_TYPE_ELEMENT" => GetMessage("COLUMN_TYPE_ELEMENT"),
"COLUMN_TYPE_CATEGORY" => GetMessage("COLUMN_TYPE_CATEGORY")
),
"REFRESH" => "Y"
),
"2COLUMN_TYPE" => array(
"PARENT" => "BASE",
"NAME" => GetMessage("2COLUMN_TYPE"),
"TYPE" => "LIST",
"VALUES" => array(
"COLUMN_TYPE_ELEMENT" => GetMessage("COLUMN_TYPE_ELEMENT"),
"COLUMN_TYPE_CATEGORY" => GetMessage("COLUMN_TYPE_CATEGORY")
),
"REFRESH" => "Y"
),
"CACHE_TIME" => Array("DEFAULT"=>36000000),
"CACHE_FILTER" => array(
"PARENT" => "CACHE_SETTINGS",
"NAME" => GetMessage("IBLOCK_CACHE_FILTER"),
"TYPE" => "CHECKBOX",
"DEFAULT" => "N",
),
"CACHE_GROUPS" => array(
"PARENT" => "CACHE_SETTINGS",
"NAME" => GetMessage("CP_BNL_CACHE_GROUPS"),
"TYPE" => "CHECKBOX",
"DEFAULT" => "Y",
),
"1COLUMN_IBLOCK_TYPE" => Array(
"PARENT" => "1COLUMN",
"NAME" => GetMessage("1COLUMN_IBLOCK_TYPE"),
"TYPE" => "LIST",
"VALUES" => $arTypesEx,
"DEFAULT" => "news",
"REFRESH" => "Y",
),
"1COLUMN_IBLOCK_ID" => Array(
"PARENT" => "1COLUMN",
"NAME" => GetMessage("1COLUMN_IBLOCK_ID"),
"TYPE" => "LIST",
"VALUES" => $arIBlocks1col,
"DEFAULT" => '={$_REQUEST["ID"]}',
"ADDITIONAL_VALUES" => "Y",
"REFRESH" => "Y",
),
"2COLUMN_IBLOCK_TYPE" => Array(
"PARENT" => "2COLUMN",
"NAME" => GetMessage("2COLUMN_IBLOCK_TYPE"),
"TYPE" => "LIST",
"VALUES" => $arTypesEx,
"DEFAULT" => "news",
"REFRESH" => "Y",
),
"2COLUMN_IBLOCK_ID" => Array(
"PARENT" => "2COLUMN",
"NAME" => GetMessage("2COLUMN_IBLOCK_ID"),
"TYPE" => "LIST",
"VALUES" => $arIBlocks2col,
"DEFAULT" => '={$_REQUEST["ID"]}',
"ADDITIONAL_VALUES" => "Y",
"REFRESH" => "Y",
),
)
);
if ($arCurrentValues["1COLUMN_TYPE"] == "COLUMN_TYPE_ELEMENT")
{
$arComponentParameters["PARAMETERS"]["1COLUMN_NEWS_COUNT"] = array(
"PARENT" => "1COLUMN",
"NAME" => GetMessage("1COLUMN_NEWS_COUNT"),
"TYPE" => "STRING",
"DEFAULT" => "5",
);
}
else
{
$arComponentParameters["PARAMETERS"]["1COLUMN_COUNT_ELEMENTS"] = array(
"PARENT" => "1COLUMN",
"NAME" => GetMessage("1COLUMN_COUNT_ELEMENTS"),
"TYPE" => "CHECKBOX",
"DEFAULT" => 'Y',
);
$arComponentParameters["PARAMETERS"]["1COLUMN_TOP_DEPTH"] = array(
"PARENT" => "1COLUMN",
"NAME" => GetMessage("1COLUMN_TOP_DEPTH"),
"TYPE" => "STRING",
"DEFAULT" => '2',
);
}
if ($arCurrentValues["2COLUMN_TYPE"] == "COLUMN_TYPE_ELEMENT")
{
$arComponentParameters["PARAMETERS"]["2COLUMN_NEWS_COUNT"] = array(
"PARENT" => "2COLUMN",
"NAME" => GetMessage("2COLUMN_NEWS_COUNT"),
"TYPE" => "STRING",
"DEFAULT" => "5",
);
}
else
{
$arComponentParameters["PARAMETERS"]["2COLUMN_COUNT_ELEMENTS"] = array(
"PARENT" => "2COLUMN",
"NAME" => GetMessage("2COLUMN_COUNT_ELEMENTS"),
"TYPE" => "CHECKBOX",
"DEFAULT" => 'Y',
);
$arComponentParameters["PARAMETERS"]["2COLUMN_TOP_DEPTH"] = array(
"PARENT" => "2COLUMN",
"NAME" => GetMessage("2COLUMN_TOP_DEPTH"),
"TYPE" => "STRING",
"DEFAULT" => '2',
);
}
?>Не забудем так же про языковые файлы:
- /bitrix/components/coffeediz/elements_and_categories.list/lang/ru/.parameters.php
- /bitrix/components/coffeediz/elements_and_categories.list/lang/en/.parameters.php
<?
$MESS ["2_COL_TITLE"] = "Заголовок блока";
$MESS ['2_COL_INTRO_TEXT'] = "Текстовый блок перед списком";
$MESS ['2_COL_MORE_LINK'] = "Ссылка под писком";
$MESS ['2_COL_MORE_NAME'] = "Текст ссылки под списком";
$MESS ['1COLUMN_PARAMETERS'] = "Параметры для 1-й (левой) колонки";
$MESS ['2COLUMN_PARAMETERS'] = "Параметры для 2-й (правой) колонки";
$MESS ['1COLUMN_TYPE'] = "Тип данных для 1й (левой) колонки";
$MESS ['2COLUMN_TYPE'] = "Тип данных для 2й (правой) колонки";
$MESS ['COLUMN_TYPE_ELEMENT'] = "Элементы инфоблока";
$MESS ['COLUMN_TYPE_CATEGORY'] = "Разделы инфоблока";
$MESS ['1COLUMN_IBLOCK_TYPE'] = "ТИП инфоблока для 1й колонки";
$MESS ['1COLUMN_IBLOCK_ID'] = "ID инфоблока для 1й колонки";
$MESS ['2COLUMN_IBLOCK_TYPE'] = "ТИП инфоблока для 2й колонки";
$MESS ['2COLUMN_IBLOCK_ID'] = "ID инфоблока для 2й колонки";
$MESS ['1COLUMN_NEWS_COUNT'] = "количество элементов инфоблока в 1й колонке";
$MESS ['2COLUMN_NEWS_COUNT'] = "количество элементов инфоблока во 2й колонке";
$MESS ['IBLOCK_CACHE_FILTER'] = "Кешировать при установленном фильтре";
$MESS ['CP_BNL_CACHE_GROUPS'] = "Учитывать права доступа";
$MESS ['1COLUMN_COUNT_ELEMENTS'] = "Показывать количество элементов в разделе";
$MESS ['1COLUMN_TOP_DEPTH'] = "Максимальная отображаемая глубина разделов";
$MESS ['2COLUMN_COUNT_ELEMENTS'] = "Показывать количество элементов в разделе";
$MESS ['2COLUMN_TOP_DEPTH'] = "Максимальная отображаемая глубина разделов";
?>
Component.php
В нашем компоненте не предполагается никакой логики кроме передачи параметров и вызова компонентов списка для каждой из колонок, поэтому в обязательно (с архитектурной точки зрения) component.php вы только передадим данные в шаблон (после обязательной проверки пролога):
<? if(!defined("B_PROLOG_INCLUDED") || B_PROLOG_INCLUDED!==true)die();
$this->IncludeComponentTemplate();
?>
Шаблон компонента
В шаблоне компонента для начала выведем параметры, задающие оформление списка (заголовок, описание перед списком и ссылку) с проверкой на их пустоту, аналогично тому, как мы это делали в уроке 10. В /bitrix/components/coffeediz/elements_and_categories.list/templates/.default/template.php:
<?if(!defined("B_PROLOG_INCLUDED") || B_PROLOG_INCLUDED!==true)die();?>
<?if (!empty($arParams["2_COL_TITLE"])):?><h4 class="indent-1"><?=$arParams['2_COL_TITLE']?>:</h4><?endif?>
<?if (!empty($arParams["2_COL_INTRO_TEXT"])):?><p class="lead"><?=$arParams['2_COL_INTRO_TEXT']?></p><?endif?>
<?if (!empty($arParams["2_COL_MORE_LINK"]) && !empty($arParams["2_COL_MORE_NAME"])):?><a href="<?=$arParams['2_COL_MORE_LINK']?>" class="link"><?=$arParams['2_COL_MORE_NAME']?></a><?endif?>Осуществим проверку на тип для каждой из колонки для вывода данных:
<?if ($arCurrentValues["1COLUMN_TYPE"] == "COLUMN_TYPE_ELEMENT"):?>
//1 - разделы
<?else:?>
//1 - элементы
<?endif?>
<?if ($arCurrentValues["2COLUMN_TYPE"] == "COLUMN_TYPE_ELEMENT"):?>
//2 - разделы
<?else:?>
//2 - элементы
<?endif?>Теперь для каждой из колонок (для соответствующего типа) вызовем компонент:
- bitrix:news.list - для элементов инфоблока
- bitrix:catalog.section.list - для разделов инфоблока
И создадим шаблоны 1 колоночного списка для каждого из них.
Формально нам следовало бы сделать комплексный компонент, а не отдельные шаблоны, поскольку так при использовании другого шаблона сайта (без копирования шаблонов компонентов) функционал перестанет работать. Но так мы потеряем возможность получать обновления штатных компонентов.
Можно было бы скопировать наши 1 колоночные шаблоны в компоненты системы (т.е. в ядро), однако это претит нашей идеологии.
Шаблон 1 колоночного списка элементов инфоблока (на основе компонента списка новостей 1С-Битрикс)
Создадим шаблон 1_column компонента bitrix:news.list в шаблоне сайта.
Сам шаблон будет практически идентичен тому, что мы создали в 10 уроке и будет содержать лишь 1 дополнительный параметр - флаг принадлежности к левой (1й) колонке:
<?if(!defined("B_PROLOG_INCLUDED") || B_PROLOG_INCLUDED!==true)die();
?>
<div class="span4<?if ($arParams["COL_TYPE_LEFT"] == Y):?> left-0<?endif?>">
<ul class="list"><?foreach($arResult["ITEMS"] as $arItem):?>
<?
$this->AddEditAction($arItem['ID'], $arItem['EDIT_LINK'], CIBlock::GetArrayByID($arItem["IBLOCK_ID"], "ELEMENT_EDIT"));
$this->AddDeleteAction($arItem['ID'], $arItem['DELETE_LINK'], CIBlock::GetArrayByID($arItem["IBLOCK_ID"], "ELEMENT_DELETE"), array("CONFIRM" => GetMessage('CT_BNL_ELEMENT_DELETE_CONFIRM')));
?>
<li id="<?=$this->GetEditAreaId($arItem['ID']);?>"><a href="<?echo $arItem["DETAIL_PAGE_URL"]?>"><?echo $arItem["NAME"]?></a></li>
<?endforeach;?></ul>
</div>
Теперь осталось поместить вызов этого шаблона в шаблоне компонента 2-х колоночного списка.
Мы оставим только необходимый минимум параметров компонента (и сразу поставим вызов ID инфоблока из параметров родительского компонента 2-х колоночного списка):
<?$APPLICATION->IncludeComponent("bitrix:news.list", "1_column", array(
"IBLOCK_ID" => $arParams["1COLUMN_IBLOCK_ID"],
"NEWS_COUNT" => $arParams["1COLUMN_NEWS_COUNT"],
"FILTER_NAME" => "\$arrFilter1",
"CACHE_TYPE" => $arParams["CACHE_TYPE"],
"CACHE_TYPE" => $arParams["CACHE_TIME"],
"CACHE_TYPE" => $arParams["CACHE_FILTER"],
"CACHE_TYPE" => $arParams["CACHE_GROUPS"],
"SET_TITLE" => "N",
"COL_TYPE_LEFT" => "Y",
),
false
);?>Как видите, мы задали переменную для фильтрации, таким образом при необходимости можно скопировать шаблон компонента 2-х колоночного списка в своё пространство имён и разместить перед компонентом каждой из колонок нужны фам фильтр! Мы не делаем этого потому, что различных комбинаций и типов фильтров может быть бесчисленное множество.
Синим выделены идентификаторы в переменных, относящихся к 1й (левой) колонке. Для правой они должны быть изменены на 2.
Зелёным выделена строка, устанавливающая параметр разметки, характерный для левой колонки. Для правой колонки этот параметр должен быть равен N.
Шаблон компонента списка разделов инфоблока
Аналогично списку новостей создадим шаблон 1_column компонента catalog.section.list в шаблоне сайта.
Несмотря на общее сходство с шаблоном 1 колоночного списка элементов (и с шаблоном 2-х колоночного списка разделов из урока 10) есть и важное отличие. Мы сохраним древовидную структуру шаблона .default!
Тогда шаблон будет выглядеть:
<?if(!defined("B_PROLOG_INCLUDED") || B_PROLOG_INCLUDED!==true)die();?>
<div class="span4<?if ($arParams["COL_TYPE_LEFT"] == Y):?> left-0<?endif?>">
<?
$TOP_DEPTH = $arResult["SECTION"]["DEPTH_LEVEL"];
$CURRENT_DEPTH = $TOP_DEPTH;
foreach($arResult["SECTIONS"] as $arSection)
{
$this->AddEditAction($arSection['ID'], $arSection['EDIT_LINK'], CIBlock::GetArrayByID($arSection["IBLOCK_ID"], "SECTION_EDIT"));
$this->AddDeleteAction($arSection['ID'], $arSection['DELETE_LINK'], CIBlock::GetArrayByID($arSection["IBLOCK_ID"], "SECTION_DELETE"), array("CONFIRM" => GetMessage('CT_BCSL_ELEMENT_DELETE_CONFIRM')));
if($CURRENT_DEPTH < $arSection["DEPTH_LEVEL"])
{
echo "\n",str_repeat("\t", $arSection["DEPTH_LEVEL"]-$TOP_DEPTH),'<ul class="list">';
}
elseif($CURRENT_DEPTH == $arSection["DEPTH_LEVEL"])
{
echo "</li>";
}
else
{
while($CURRENT_DEPTH > $arSection["DEPTH_LEVEL"])
{
echo "</li>";
echo "\n",str_repeat("\t", $CURRENT_DEPTH-$TOP_DEPTH),"</ul>","\n",str_repeat("\t", $CURRENT_DEPTH-$TOP_DEPTH-1);
$CURRENT_DEPTH--;
}
echo "\n",str_repeat("\t", $CURRENT_DEPTH-$TOP_DEPTH),"</li>";
}
echo "\n",str_repeat("\t", $arSection["DEPTH_LEVEL"]-$TOP_DEPTH);
?><li id="<?=$this->GetEditAreaId($arSection['ID']);?>"><a href="<?=$arSection["SECTION_PAGE_URL"]?>"><?=$arSection["NAME"]?><?if($arParams["COUNT_ELEMENTS"]):?> (<?=$arSection["ELEMENT_CNT"]?>)<?endif;?></a><?
$CURRENT_DEPTH = $arSection["DEPTH_LEVEL"];
}
while($CURRENT_DEPTH > $TOP_DEPTH)
{
echo "</li>";
echo "\n",str_repeat("\t", $CURRENT_DEPTH-$TOP_DEPTH),"</ul>","\n",str_repeat("\t", $CURRENT_DEPTH-$TOP_DEPTH-1);
$CURRENT_DEPTH--;
}
?>
</div>Не забудем про параметр COL_TYPE_LEFT, отвечающий за принадлежность колонки к типу "левая".
Осталось только вызвать компонент 1 колоночного списка разделов в шаблоне 2-х колоночного списка, передав в него параметры:
<?$APPLICATION->IncludeComponent("bitrix:catalog.section.list", "1_column", array(
"IBLOCK_ID" => $arParams["1COLUMN_IBLOCK_ID"],
"COUNT_ELEMENTS" => $arParams["1COLUMN_COUNT_ELEMENTS"],
"TOP_DEPTH" => $arParams["1COLUMN_TOP_DEPTH"],
"CACHE_TYPE" => $arParams["CACHE_TYPE"],
"CACHE_TYPE" => $arParams["CACHE_TIME"],
"CACHE_TYPE" => $arParams["CACHE_FILTER"],
"CACHE_TYPE" => $arParams["CACHE_GROUPS"],
"ADD_SECTIONS_CHAIN" => "N",
"COL_TYPE_LEFT" => "Y"
),
false
);?>Синим вновь выделены идентификаторы в переменных, относящихся к 1й (левой) колонке. Для правой они должны быть изменены на 2.
Зелёным выделена строка, устанавливающая параметр разметки, характерный для левой колонки. Для правой колонки этот параметр должен быть равен N.
Итоговый код шаблона:
<?if(!defined("B_PROLOG_INCLUDED") || B_PROLOG_INCLUDED!==true)die();?>
<?if (!empty($arParams["2_COL_TITLE"])):?><h4 class="indent-1"><?=$arParams['2_COL_TITLE']?>:</h4><?endif?>
<?if (!empty($arParams["2_COL_INTRO_TEXT"])):?><p class="lead"><?=$arParams['2_COL_INTRO_TEXT']?></p><?endif?>
<div class="lists">
<?if ($arParams["1COLUMN_TYPE"] == "COLUMN_TYPE_ELEMENT"):?>
<?$APPLICATION->IncludeComponent("bitrix:news.list", "1_column", array(
"IBLOCK_ID" => $arParams["1COLUMN_IBLOCK_ID"],
"NEWS_COUNT" => $arParams["1COLUMN_NEWS_COUNT"],
"FILTER_NAME" => "\$arrFilter1",
"CACHE_TYPE" => $arParams["CACHE_TYPE"],
"CACHE_TYPE" => $arParams["CACHE_TIME"],
"CACHE_TYPE" => $arParams["CACHE_FILTER"],
"CACHE_TYPE" => $arParams["CACHE_GROUPS"],
"SET_TITLE" => "N",
"COL_TYPE_LEFT" => "Y",
),
false
);?>
<?else:?>
<?$APPLICATION->IncludeComponent("bitrix:catalog.section.list", "1_column", array(
"IBLOCK_ID" => $arParams["1COLUMN_IBLOCK_ID"],
"COUNT_ELEMENTS" => $arParams["1COLUMN_COUNT_ELEMENTS"],
"TOP_DEPTH" => $arParams["1COLUMN_TOP_DEPTH"],
"CACHE_TYPE" => $arParams["CACHE_TYPE"],
"CACHE_TYPE" => $arParams["CACHE_TIME"],
"CACHE_TYPE" => $arParams["CACHE_FILTER"],
"CACHE_TYPE" => $arParams["CACHE_GROUPS"],
"ADD_SECTIONS_CHAIN" => "N",
"COL_TYPE_LEFT" => "Y"
),
false
);?>
<?endif?>
<?if ($arParams["2COLUMN_TYPE"] == "COLUMN_TYPE_ELEMENT"):?>
<?$APPLICATION->IncludeComponent("bitrix:news.list", "1_column", array(
"IBLOCK_ID" => $arParams["2COLUMN_IBLOCK_ID"],
"NEWS_COUNT" => $arParams["2COLUMN_NEWS_COUNT"],
"FILTER_NAME" => "\$arrFilter2",
"CACHE_TYPE" => $arParams["CACHE_TYPE"],
"CACHE_TYPE" => $arParams["CACHE_TIME"],
"CACHE_TYPE" => $arParams["CACHE_FILTER"],
"CACHE_TYPE" => $arParams["CACHE_GROUPS"],
"SET_TITLE" => "N",
"COL_TYPE_LEFT" => "N",
),
false
);?>
<?else:?>
<?$APPLICATION->IncludeComponent("bitrix:catalog.section.list", "1_column", array(
"IBLOCK_ID" => $arParams["2COLUMN_IBLOCK_ID"],
"COUNT_ELEMENTS" => $arParams["2COLUMN_COUNT_ELEMENTS"],
"TOP_DEPTH" => $arParams["2COLUMN_TOP_DEPTH"],
"CACHE_TYPE" => $arParams["CACHE_TYPE"],
"CACHE_TYPE" => $arParams["CACHE_TIME"],
"CACHE_TYPE" => $arParams["CACHE_FILTER"],
"CACHE_TYPE" => $arParams["CACHE_GROUPS"],
"ADD_SECTIONS_CHAIN" => "N",
"COL_TYPE_LEFT" => "N"
),
false
);?>
<?endif?>
</div>
<?if (!empty($arParams["2_COL_MORE_LINK"]) && !empty($arParams["2_COL_MORE_NAME"])):?><a href="<?=$arParams['2_COL_MORE_LINK']?>" class="link"><?=$arParams['2_COL_MORE_NAME']?></a><?endif?>
Заключение
В рамках этого урока мы разработали свой первый компонент. Он довольно прост и его задача - вызвать пару системных компонентов с нашими шаблонами, передав им набор параметров.
Так же в качестве бонуса мы разработали 2 простых шаблона компонентов.
В результате структура нашего компонента выглядеть следующим образом:
В публичной части это будет выглядеть следующим образом:
Результаты данного урока вы, как всегда, можете найти в нашем репозитории на GitHub.
