CMS Bitrix Site Manager - интеграция (шаблон, структура, навигация) 8
- bitrix
- 9 024 прочитания
Урокът е от архива на сайта и е писан преди години. Някои бутони и менюта в програмите вече може да изглеждат различно.
В разделя се дава описание на основните принципи и способи за създаване, използване и настройки на визуалните компоненти.
Съдържание на главата:
* Използване на компоненти
* Включване на визуални компоненти
* Структура на компонентите
* Къстомизация на компоненти
* Пример на работа с компоненти (организация на показване на новини на сайта)
Използване на компоненти
Визуалните компоненти представляват логически завършен програмен код, изпълняващ операции с данни от отделни модули на системата. Практически всеки програмен код може да бъде представен във вид на компонент.
Започвайки от версия 6.0 на продукта, са достъпни компоненти от новата версия 2.0. Разликата между компонентите от версия 2.0 и първа версия е в това, че в тях са разделени логиката и представянето. Зад една логика може да бъде създадено няколко представяния, включително зависещи от шаблона на текущия сайт. Няма необходимост от промяна на логиката на компонента за да се промени вида на неговото показване. Затова управлението на външния вид на информацията, показвана от компонента е значително по-лесно. Компонентите от версия 2.0 се делят на два вида: прости и комплексни. Простите служат за създаване на някаква областа на една страница (списък новини, топ елементи от каталога, случайна фотография).
| |
Комплексните компоненти се използват за създаване на раздели на сайта (например, новинарски раздел, фото галерия, продуктов каталог, форум). Тяйното удобство се състой в създаването на една страница на физическо ниво и получаване на необходим набор от страници логически.
| |
За бързо поставяне на компонентите на страницата е разработен специален интерфейс на база визуалния HTML- редактор. При редактиране на страница може да се избере подходящ компонент от списъка и да пренесе в работната област на страницата.
Визуалните компоненти включват набор от параметри, определящи поведението на компонента. Основната особеност на компонентите е в това, че те позволяват да се управляват чрез тези параметри през визуалния интерфейс на продукта.
След поставяне на компонента на страницата неговите параметри могат да бъдат настроени с помощта на панела Свойства във визуалния редактор. Параметрите на компонентите са разделени по групи: шаблон на компонента (където се включва един от създадените шаблони за показване на компонента), основни параметри, източник на данни и т.н. Например, за компонента Каталог се задават основни параметри, шаблони за линкове, управление на режим AJAX, настройки за кеширане и т.н.
Отваря се форма от следния вид:
Някои компоненти могат да управляват отделни елементи на шаблона на сайта:
| |
- Ако на страницата са разположени няколко компонента, всеки от
които може да определя заглавието на страницата, то заглавието на
страницата ще бъде определено от последния компонент (с помощта на
функция
SetTitle()). - Ако на страницата са разположени няколко визуални компонента, добавящи свои бутони в административния панел (например, няколко компонента за информационни блокове), то за да се избегне претоварването на административния панел с бутони, в настройките на тези компоненти трябва да се изключи опция Добавяй в админ. панела бутон за този компонент.
При необходимост ползващия може бързо да премине към редактиране на PHP кода за извикване на компонента. За това е нужно да се превключи в режим редактиране на кода на страницата:
По аналогичен начин в работната област на страницата може да бъде добавен произволен PHP код, чиято модификация също става чрез диалог в долната част на екрана или в режим на редактиране на кода.
Възможността за използване на програмен код в работната област на страницата позволява да се включи практически всякакъв PHP код без нарушаване на визуалния режим на редактиране на съдържанието на страницата.
Включване на визуални компоненти
Компонентите от версия 2.0 се включват в кода на страницата с помощта на функция IncludeComponent(). В качеството на параметри на функцията се ползват:
- название на компонента във форма <пространство_имена>:<название_компонент>. При това названието на компонента се препоръчва да се строи йерархично, започвайки с общото понятие и завършвайки с конкретното назначение на компонента. Например, «catalog», «catalog.element», «catalog.section.list» и т.н.
- название на шаблона. Шаблона на компонента "по подразбиране" може да се задава празен ред, също така може явно да се определя
.default - масив от параметри за компонента
Array(...)
Пример на код за извикване на компонент Списък новини:
<?$APPLICATION->IncludeComponent(
"bitrix:news.list",
"",
Array(
"DISPLAY_DATE" => "Y",
"DISPLAY_NAME" => "Y",
"DISPLAY_PICTURE" => "N",
"DISPLAY_PREVIEW_TEXT" => "Y",
"IBLOCK_TYPE" => "news",
"IBLOCK_ID" => "33",
"NEWS_COUNT" => "3",
"SORT_BY1" => "ACTIVE_FROM",
"SORT_ORDER1" => "DESC",
"SORT_BY2" => "SORT",
"SORT_ORDER2" => "ASC",
"FILTER_NAME" => "",
"FIELD_CODE" => array(0=>"",1=>"",),
"PROPERTY_CODE" => array(0=>"",1=>"",),
"DETAIL_URL" => "/content/news/index.php?news=#ELEMENT_ID#",
"PREVIEW_TRUNCATE_LEN" => "0",
"ACTIVE_DATE_FORMAT" => "d.m.Y",
"DISPLAY_PANEL" => "N",
"SET_TITLE" => "N",
"INCLUDE_IBLOCK_INTO_CHAIN" => "Y",
"ADD_SECTIONS_CHAIN" => "Y",
"HIDE_LINK_WHEN_NO_DETAIL" => "N",
"PARENT_SECTION" => "",
"CACHE_TYPE" => "A",
"CACHE_TIME" => "3600",
"CACHE_FILTER" => "N",
"DISPLAY_TOP_PAGER" => "N",
"DISPLAY_BOTTOM_PAGER" => "N",
"PAGER_TITLE" => "Новости",
"PAGER_SHOW_ALWAYS" => "N",
"PAGER_TEMPLATE" => "",
"PAGER_DESC_NUMBERING" => "N",
"PAGER_DESC_NUMBERING_CACHE_TIME" => "36000"
)
);?>
Всички компоненти се намират в папка /bitrix/components/. Системните компоненти се намират в подпапка /bitrix/components/bitrix/. Съдържанието на тази папка се обновява от системата за обновяване и не может да се изменя от ползващите.
Потребителските компоненти могат да се намират във всякакви други подпапки на папка /bitrix/components/ или директно в папка /bitrix/components/.

Структура на компонентите
Папката на компонента може да съдържа следните подпапки и файлове:

- подпапка help, в която са разположени помощни файлове за компонента. Подпапка help може да отсъства.
- подпапка install, в която са разположени скриптове за инсталация и деинсталация на компонента. Тя може да отсъства.
- подпапка lang, в която са разположени файлове на езиковите съобщения (преводи) на компонента. Подпапка lang може да отсъства, ако в компонента няма зависещи от езика фрази.
- подпапка templates, в която са разположени шаблони за извикване (показване) на компонента. Подпапка templates може да отсъства, ако компонента няма шаблони за показване.
- файл component.php, който съдържа логиката (кода) на компонента. Този файл трябва винаги да присъства в папката на компонента.
- файл .description.php, който съдържа название, описание на компонента и неговото положение в дървото на логическото поставяне (за редактора). Този файл трябва винаги да присъства в папката на компонента.
- файл .parameters.php, който съдържа описание на входните параметри на компонента за редактора. Ако компонента има входни параметри, то този файл трябва да присъства в папката на компонента.
- всякакви други папки и файлове с ресурси, необходими на компонента, например, папка images.
Къстомизация на компоненти
Къстомизацията на визуални компоненти се състои в допълнителна настройка на външния вид (цвят, размер шрифт, форми на бутони и т.н.), а също и при необходимост в промяна на програмния код (логиката на работа) на компонентите (например, за промяна на способа на изкарване на списъка с елементи и т.н.).
За да къстомизирате компонент 2.0 за определен шаблон на сайта, трябва да копирате шаблона на компонента или в шаблона на сайта по подразбиране, или във всеки друг шаблон. Копирането на шаблона на компонента става със средствата на системата. В режим на разработка и настройка на сайта (вложка Разработка) чрез бутона Копирай шаблона на компонента става прехода към формата за копиране на шаблона на компонента.

След копирането на шаблона може да се премине към неговото редактиране за определените изисквания.
Ако е необходимо да се промени логиката на компонента, то компонента
трябва да напълно да се копира в ново пространство имена (подпапка на
папка /bitrix/components/), предварително създадено. След
тази операция компонента ще бъде показан в панела на визуалния редактор
редом със системния компонент. Ако трябва да се отдели отделна област в
панела на компоненти 2.0 за потребителски компоненти, то трябва да се
измени файла .description.php на компонента.
Пример на работа с компоненти (организация на показване на новини на сайта)
Създаването на страница за показване на новини започва със създаването на съответния информационен блок в административния интерфейс и попълване на елементи – новости.
При създаване на нов информационен блок трябва да укажете:
- път до страницата за показване на списъка с елементи на информационния блок (новини);
- път до страницата за показване на списъка с елементи на раздела на информационния блок (новини). Ако елементите на информационния блок (новини) са разпределени по групи, то тази страница ще бъде ползвана за показване на списък с новини от една група;
- път до страница да подробен преглед на елемента (новини).
За публикация на новинарския раздел ще ползваме комплексния компонент Новини (bitrix:news),
затова отделно създаване на страници със списък на всички новини, със
списък на новини от раздела, с подробно показване на новина не се
изисква.
След попълване на информационния блок Новини от фирмата със съдържание преминаваме към създаване на страница във визуалния редактор. За създаване на новинарски раздел пренасяме комплексния компонент на страницата:
По-нататък настройваме параметрите на компонента:
- Шаблона на компонента оставяме по подразбиране. Допълнителните
параметри позволяват лесно да се регулира пожеланията за визуализация:
нужна ли дата на елемента, изображение за анонса, текст на анонса:
- По-нататък определяме основните параметри на компонента:
- Също така настройките на компонента позволяват да се определят rss параметрите:
- Така също с помощта на параметрите на компонента може да се определят настройки за гласуване, настройки за показване на материали по темата, настройки за мнения и т.н.
След настройката на параметрите на компонента по нужния начин, съхраняваме страницата и преминаваме към преглед на новинарския раздел в публичната част.
Страница със списък новини:
Страница за подробен преглед:

















