Към съдържанието

CMS Bitrix Site Manager - интеграция (шаблон, структура, навигация) 8

  • bitrix
  • 9 024 прочитания

Урокът е от архива на сайта и е писан преди години. Някои бутони и менюта в програмите вече може да изглеждат различно.

Курса е предназначен за разработчици на уеб-сайтове въз основа на софтуерния продукт Bitrix Site Manager.  Визуални компоненти

 В разделя се дава описание на основните принципи и способи за създаване, използване и настройки на визуалните компоненти.

Съдържание на главата:

    * Използване на компоненти

    * Включване на визуални компоненти

    * Структура на компонентите

    * Къстомизация на компоненти

    * Пример на работа с компоненти (организация на показване на новини на сайта)

Използване на компоненти

 

Визуалните компоненти представляват логически завършен програмен код, изпълняващ операции с данни от отделни модули на системата. Практически всеки програмен код може да бъде представен във вид на компонент.

Започвайки от версия 6.0 на продукта, са достъпни компоненти от новата версия 2.0. Разликата между компонентите от версия 2.0 и първа версия е в това, че в тях са разделени логиката и представянето. Зад една логика може да бъде създадено няколко представяния, включително зависещи от шаблона на текущия сайт. Няма необходимост от промяна на логиката на компонента за да се промени вида на неговото показване. Затова управлението на външния вид на информацията, показвана от компонента е значително по-лесно. Компонентите от версия 2.0 се делят на два вида: прости и комплексни. Простите служат за създаване на някаква областа на една страница (списък новини, топ елементи от каталога, случайна фотография).

Натиснете върху рисунката, за да я увеличите  Натиснете върху рисунката, за да я увеличите

Комплексните компоненти се използват за създаване на раздели на сайта (например, новинарски раздел, фото галерия, продуктов каталог, форум). Тяйното удобство се състой в създаването на една страница на физическо ниво и получаване на необходим набор от страници логически. 

Натиснете върху рисунката, за да я увеличите  Натиснете върху рисунката, за да я увеличите

За бързо поставяне на компонентите на страницата е разработен специален интерфейс на база визуалния HTML- редактор. При редактиране на страница може да се избере подходящ компонент от списъка и да пренесе в работната област на страницата.

Натиснете върху рисунката, за да я увеличите

Визуалните компоненти включват набор от параметри, определящи поведението на компонента. Основната особеност на компонентите е в това, че те позволяват да се управляват чрез тези параметри през визуалния интерфейс на продукта.

След поставяне на компонента на страницата неговите параметри могат да бъдат настроени с помощта на панела Свойства във визуалния редактор. Параметрите на компонентите са разделени по групи: шаблон на компонента (където се включва един от създадените шаблони за показване на компонента), основни параметри, източник на данни и т.н. Например, за компонента Каталог се задават основни параметри, шаблони за линкове, управление на режим AJAX, настройки за кеширане и т.н.

Забележка: системата позволява да се управляват параметри на компонента от публичната част в режим разработка и настройка на сайта (вложка Разработка). Прехода към формата за редактиране на параметрите на компонента е възможен с помощта на позиция Редактирай параметрите на компонента меню на команди за компонента:

bVPv0.comp_params_menu.png

Отваря се форма от следния вид:

Натиснете върху рисунката, за да я увеличите

Някои компоненти могат да управляват отделни елементи на шаблона на сайта:

  • добавяне на бутон в административния панел (например, компоненти за информационни блокове);

Натиснете върху рисунката, за да я увеличите
Натиснете върху рисунката, за да я увеличите
  • добавяне на елементи в нишката за навигация (например, компоненти на информационни блокове, от интернет-магазина);
 Натиснете върху рисунката, за да я увеличите  Натиснете върху рисунката, за да я увеличите
  • включване на заглавие на документа (например, компоненти за информационни блокове, форум, блогове);
 Натиснете върху рисунката, за да я увеличите  Натиснете върху рисунката, за да я увеличите
  • задаване на значение на метаданни за страница: ключови думи и описание (например, компоненти за информационни блокове).
 Натиснете върху рисунката, за да я увеличите  
Забележка: В дадените примери за управлението на елементи на шаблона на сайта става с помощта на специални параметри на визуалните компоненти. Настройката на дадените параметри може да бъде направена при редактиране на страница в режим на визуален HTML-редактор или от публичната част във формата за редактиране на параметрите на компонента.
Полезна информация:
  • Ако на страницата са разположени няколко компонента, всеки от които може да определя заглавието на страницата, то заглавието на страницата ще бъде определено от последния компонент (с помощта на функция 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/.

sU4K6.user_comp.png

Забележка: подробно за поставяне и именуване на компонентите вижте в курса Компоненти 2.0.

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

 

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

jFwNj.comp_folder_structure.png

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

 Къстомизация на компоненти

 

Къстомизацията на визуални компоненти се състои в допълнителна настройка на външния вид (цвят, размер шрифт, форми на бутони и т.н.), а също и при необходимост в промяна на програмния код (логиката на работа) на компонентите (например, за промяна на способа на изкарване на списъка с елементи и т.н.).

За да къстомизирате компонент 2.0 за определен шаблон на сайта, трябва да копирате шаблона на компонента или в шаблона на сайта по подразбиране, или във всеки друг шаблон. Копирането на шаблона на компонента става със средствата на системата. В режим на разработка и настройка на сайта (вложка Разработка) чрез бутона Копирай шаблона на компонента става прехода към формата за копиране на шаблона на компонента.

593Vr.templ_copy_menu.png

След копирането на шаблона може да се премине към неговото редактиране за определените изисквания.

Ако е необходимо да се промени логиката на компонента, то компонента трябва да напълно да се копира в ново пространство имена (подпапка на папка /bitrix/components/), предварително създадено. След тази операция компонента ще бъде показан в панела на визуалния редактор редом със системния компонент. Ако трябва да се отдели отделна област в панела на компоненти 2.0 за потребителски компоненти, то трябва да се измени файла .description.php на компонента.

Забележка: подробно за къстомизацията на компоненти вижте в курса Компоненти 2.0 и в Ръководство по интеграция.

 Пример на работа с компоненти (организация на показване на новини на сайта)

 

Създаването на страница за показване на новини започва със създаването на съответния информационен блок в административния интерфейс и попълване на елементи – новости.

При създаване на нов информационен блок трябва да укажете:

Натиснете върху рисунката, за да я увеличите

  • път до страницата за показване на списъка с елементи на информационния блок (новини);
  • път до страницата за показване на списъка с елементи на раздела на информационния блок (новини). Ако елементите на информационния блок (новини) са разпределени по групи, то тази страница ще бъде ползвана за показване на списък с новини от една група;
  • път до страница да подробен преглед на елемента (новини).

За публикация на новинарския раздел ще ползваме комплексния компонент Новини (bitrix:news), затова отделно създаване на страници със списък на всички новини, със списък на новини от раздела, с подробно показване на новина не се изисква.

След попълване на информационния блок Новини от фирмата със съдържание преминаваме към създаване на страница във визуалния редактор. За създаване на новинарски раздел пренасяме комплексния компонент на страницата:

Натиснете върху рисунката, за да я увеличите

По-нататък настройваме параметрите на компонента:

  • Шаблона на компонента оставяме по подразбиране. Допълнителните параметри позволяват лесно да се регулира пожеланията за визуализация: нужна ли дата на елемента, изображение за анонса, текст на анонса:

    eWISs.params.png
  • По-нататък определяме основните параметри на компонента:

    RmDy7.params2.png
  • Също така настройките на компонента позволяват да се определят rss параметрите:

    Hhtbl.params3.png
  • Така също с помощта на параметрите на компонента може да се определят настройки за гласуване, настройки за показване на материали по темата, настройки за мнения и т.н. 

След настройката на параметрите на компонента по нужния начин, съхраняваме страницата и преминаваме към преглед на новинарския раздел в публичната част.

Страница със списък новини:

Натиснете върху рисунката, за да я увеличите

Страница за подробен преглед:

Натиснете върху рисунката, за да я увеличите


Споделете: