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

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

  • bitrix
  • 10 263 прочитания

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

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

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

    * Карта на сайта

    * Управление на меню

          o Типове менюта

          o Построяване и показване на меню

          o Управление на меню

    * Навигационна нишка

          o Управление на позициите в навигационната нишка

          o Управление на показването на нишката

          o Управление на шаблона на навигационната нишка

Карта на сайта

 

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

Създаване на карта на сайта

За създаване на карта на сайта в «Bitrix Site Manager» се ползва компонента Карта на сайта (bitrix:main.map). Компонента е разположен в папка Съдържание > Карта на сайта панел Компоненти 2.0 на визуалния редактор. Картата се строи въз основа на менютата, използвани в системата. Типовете менюта се указват в настройките на главния модул, раздел Карта на сайта (Настройки > Настройки на продукта > Настройки на модули > Главен модул).

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

  • Създайте отделна страница и поставете на нея компонента Карта на сайта.
  • Настройте параметрите на компонента

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

Максимално ниво на вложеност – това е дълбочината на вложеност на разделите, до което трябва да се показва в менюто. Ако числото в това поле е над 4, то се препоръчва още веднъж да се преосмисли структурата на сайта.

Количество колонки – укажете в колко колонки да бъде построено изображението на картата на сайта. Това число много зависи от дизайна на сайта, използваното ниво на вложеност, структурата на сайта. Преноса на позициите на картата по колонки става на база позициите от менюто от първо ниво. Тоест, ако една от позициите в менюто има структура значително по-дълбока, от другите позиции, то при избор на дълбоко ниво на вложеност на картата на сайта вие можете да получите дълга колонка за тази позиция и къси колонки от другите позиции.

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

Забележка:

Ако в настройките на сайта (Настройки > Настройка на продукта > Сайтове > Списък на сайтове > _ име на сайта _) не съвсем вярно е посочена папката на сайта (например, няма затварящ слеш), то компонента няма да може да създаде карта на сайта.

 Управление на меню

 В този раздел се дават основните принципи и правила за създаване и управление на менюто на сайта, включително описание на файла данни и структурата на шаблона на менюто. Също така в раздела се описва възможността за използване на динамични менюта.

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

    * Типове менюта

    * Построяване и показване на меню

    * Управление на меню

Типове менюта

На сайта могат да бъдат представени няколко менюта от различни типове: горно, ляво, долно и т.н. В най-общия случай на сайта съществува едно "основно" меню, съответстващо на най-горното ниво на йерархия и показвано във всички раздели на сайта.

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

Също така в системата често се ползва "второстепенно" меню (или меню второ ниво), включващо линкове към подраздели и документи на текущия раздел.

Типовете използвани на сайта менюта се определят от административния раздел на страницата за настройки на модула Управление на структурата.

Например, нека в системата се ползват два типа менюта:

C25dv.44cf72d4a3634.menu_adm.png

  • ляво меню – тип "left";
  • горно (основно) меню – тип "top".

Типа меню, определен в настройките на модула Управление на структурата, ще бъде използван като префикс на файла с шаблона на менюто (например, top.menu_template.php), а също така за идентификация на файлове с позиции на менюто (например, .top.menu.php). Освен това, името на типа на менюто се използва за включване на менюто в шаблона на дизайна.

Забележка: Типовете меню могат да бъдат зададени отделно за всеки сайт.

UvJT3.44cf72d4a3a98.menu_site.png

Типове менюта. Демонстрационен клип. (Flash)Типове менюта. Демонстрационен клип. (Flash)

Типовете менюта се определят произволно (само символи на латиница). Но за опростяване на управлението на менюто се препоръчва да се дават на типовете меню значими имена. Например, top, left, bottom.

 

 Построяване и показване на меню

 

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

  • въвеждане на HTML елементи за построяване на меню;
  • създаване на шаблон за менюто (създаване на шаблон за компонента Меню);
  • включване на функции за показване на меню (извикване на компонента Меню) в общия шаблон на ("пролога" и "епилога");
  • запълване на менюто в съответствие със структурата на сайта.

Структура на менюто

Всяко меню на сайта се построява въз основа на две съставляващи:

  • масив от данни, определящ състава на менюто, дава имена и линкове за всички позиции на менюто. Управлението на масива данни става чрез административния интерфейс;
  • шаблон на външното представяне на менюто. Шаблона за менюто – е PHP код, определящ външния вид на менюто (шаблона на компонента Меню). Шаблона на менюто обработва масива от данни, и извежда в резултат HTML-код.

Масив от данни за менюто

Данните за всеки тип меню се съхраняват в отделен файл, чието име има следния формат: .<тип меню>.menu.php. Например, за съхраняване на данни за меню от типа left ще се ползва файл .left.menu.php, а за съхраняване на данни за меню от типа top - файл .top.menu.php.

Файловете за менюто се поставят в папките на тези раздели на сайта, където е нужно показването на съответните типове меню. Ако за даден раздел не е създаден съответния файл за меню, системата прави търсене на файла в каталога с по-горно ниво.

Например, тъй като основното меню (в демо-версията на продукта, това меню е от типа top) трябва да се показва във всички раздели, то файла с това меню се поставя само в корневия каталог на сайта:

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

Съответно менюто от второ ниво (в демо-версията на продукта, това е меню left) се показва отделно за всеки раздел на сайта. Затова в папката на всеки раздела се създава свой файл за дадения тип меню:

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

 

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

Системата «Bitrix Site Manager» позволява да се създават и менюта от динамичен тип. Т.е. масива от данни за такива менюта се генерира автоматично въз основа на някои данни, получавани с помощта на програмен код. Този код трябва да се съхрани в папката на съответния раздел на сайта във файл с име .<тип меню>.menu_ext.php.

Пример за такова меню може да служи лявото меню на раздела Каталог книги, представено в демо-версията на продукта. Тук първите две позиции от менюто Автори и Рецензии са създадени по обичайния начин, а останалите (Бизнес-литература, Детска литература и т.н.) се формират динамично.

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

В този случай в качеството на позиции на менюто се ползват названията на групи от каталога Книги, създадено въз основа на информационни блокове. Програмния код, на основата на който се генерира менюто се съхранява във файла .left.menu_ext.php в папка /e-store/books/.

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

Шаблон за външно представяне на меню

Отделяна на HTML елементи за построяване на меню

Създаването на шаблон за менюто започва с отделянето на необходимите HTML области в шаблона на сайта:

c3qAQ.44cf72d4a6e88.template.png

  • неизменна горна и долна част на шаблона;
  • повтарящи се елементи. Например, за хоризонтално меню – това са клетки от таблици, а за вертикалното – редове.

Създаване на шаблон за меню

Всички шаблони в менюто имат еднаква структура:

  • област на пролога на шаблона за меню;
  • област с описание на замяна за различни условия за обработка на шаблона;
  • област на тяло на шаблона за меню;
  • област на епилога на шаблона за меню.

Да разгледаме построяване на шаблон за меню чрез пример за Лявото меню, представено в демо-версията на продукта (шаблон .default на компонента Меню bitrix:menu):

<?if (!defined("B_PROLOG_INCLUDED") || B_PROLOG_INCLUDED!==true)die();?>
   <?if (!empty($arResult)):?>
     <ul class="left-menu">
      <?foreach($arResult as $arItem):?>
          <?if($arItem["SELECTED"]):?>
              <li><a href="<?=$arItem["LINK"]?>" class="selected">
<?=$arItem["TEXT"]?></a></li>
          <?else:?>
               <li><a href="<?=$arItem["LINK"]?>">
           <?=$arItem["TEXT"]?></a></li>
          <?endif?>
      <?endforeach?>
      </ul>
   <?endif?>

Повтарящата се част на менюто, отделена на предишната стъпка, се включва в тялото на шаблона на менюто.

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

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

t3dhv.44cf72d4a813b.examp.png

Всички шаблони за менюто се съхраняват в папката на компонента: /bitrix/components/bitrix/menu/templates/. 

Бърз достъп до редактиране на шаблона за всеки тип меню може да се направи в режим Разработка с помощта на позиция Редактирай шаблона на компонента меню на команди бутон за управление на компонента.

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

Организация на показване на менюто

Показването на менюто на страниците на сайта става с помощта на компонента jRCAr.menu_comp.png Меню (bitrix:menu). Например, извикването на горното меню на демо-сайта има следния вид:

<?$APPLICATION->IncludeComponent(
    "bitrix:menu",
    "horizontal_multilevel",
    Array(
         "ROOT_MENU_TYPE" => "top",
         "MAX_LEVEL" => "3",
         "CHILD_MENU_TYPE" => "left",
         "USE_EXT" => "Y"
     )
);?>

Този код се поставя в предвидената за показване на менюто област в шаблона на сайта.

Построяване на меню на сайта

Построяването на меню за показване става по следния начин:

  • в общия шаблон за показване се включва извикване на показване на менюто на екран;
  • при зареждане компонента проверява за наличие в текущия раздел на сайта за файл, съдържащ масив от значения за меню;
  • след това компонента извиква шаблона за построяване за дадения тип меню и зарежда HTML за менюто на екрана.

 Управление на меню

 

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

Създаване на меню

Можете да преминете към създаване на меню на раздела по следните начини:

  • от административния раздел с помощта на бутон Добави меню, разположен на контекстния панел на Менажера на файлове:

    3iUms.menu_add_adm.png

    Меню ще бъде създадено за раздела, чиято папка е отворена в дадения момент в Менажера на файлове.
  • от публичния раздел в режим Разработка с помощта на позиция Създай меню в текущия раздел меню на команди бутон управление на компонента.

    uitgV.menu_add_pub.png 
Забалежка: В резултат на тези операции се създава файл с данни за меню с име .<тип_ меню>.menu.php. Но в менажера на файловете името на файла данни автоматично се представя във вид на линк Меню от типа "<тип_меню>".

Редактиране на меню

Забележка: При редактиране на менюто се прави изменение на файла .<тип_ меню>.menu.php (например, .top.menu.php). Но работата с тези файлове става чрез специален интерфейс на системата. Това позволява да се изключи необходимостта от работа непосредствено с програмния код и дава възможност да се редактират позициите на менюто във визуален режим.

Може да се премине към редактиране на менюто чрез следните способи:

1. От административния раздел, отваряйки за редактиране файла на съответното меню в Менажера за файлове.

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

В системата са предвидени два режима за редактиране на меню (превключването между тях става с помощта на съответния бутон, разположен на контекстния панел на страницата за редактиране на менюто):

  • опростен режим на редактиране;

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

    Режима позволява да се определи типа на менюто и да се укаже название на позицията на менюто, линк за преход и значение на индекса за сортиране.
  • подробен режим за редактиране.

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

    В този режим за управление са достъпни следните данни:
    • тип на редактираното меню;
    • шаблон, въз основа на който ще бъде генерирано менюто (полето се използва в случай, че създаваното меню трябва да се генерира въз основа на шаблон, различен от използвания по подразбиране);
    • название на позицията на менюто;
    • линк за преход;
    • индекс за сортиране;
    • набор от допълнителни линкове, които съответстват на тази позиция на менюто. В даденото поле се въвежда набор от линкове към страници, при преход към които ще бъде отбелязван дадената позиция в менюто. Например, за да може при преглед на всяка страница от раздела Каталог книги да се отбелязва позиция в менюто Каталог книги, в даденото поле трябва да се въведе линк към папката, съдържаща всички страници на раздела (или да се изброят необходимите страници): /e-store/books/;
    • условия за показване. Например, позволява да се внесат ограничения за показване на дадена позиция от менюто за ползващи с определени права на достъп;
    • допълнителни параметри – набор от произволни параметри, които могат да бъдат обработени в шаблона за показване на менюто и представени по съответния начин. Например, ако позиция от менюто е заглавие на секция, това може да бъде указано в параметрите на позицията така: название на параметъра - SEPARATOR, значение - Y. При разработката на шаблона може да се проверява значението на този параметър и при показване да се отбелязва дадената позиция в менюто с разделител.

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

lkpGv.menu_edit_pub.png

Ще се отвори удобна форма за редактиране:

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

 Навигационна нишка

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

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

    * Управление на позициите в навигационната нишка

    * Управление на показването на нишката

    * Управление на шаблона на навигационната нишка

Управление на позициите в навигационната нишка

Навигационната нишка представлява последователен списък от линкове на раздели и страници на сайта и показва нивото на "гмуркане" на текущата страница в структурата на сайта. Значенията, поставяни в навигационната нишка, могат да бъдат зададени както за всеки раздел, така и за отделен документ.

Нишката за навигация помага на посетителя лесно да се ориентира на сайта: бързо да се върне на началната страница или да се качи на едно (или повече) нива нагоре, т.е. да премине от подраздела в раздела.

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

Управление чрез визуалния интерфейс на системата

По подразбиране в системата се ползва механизъм за управление на имената на позициите в навигационната нишка чрез свойствата на разделите. Названието на линка към раздел на сайта в навигационната нишка се определя с помощта на поле Заглавие във формата за настройки на свойствата на раздела.

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

  • от публичния раздел с помощта на позиция Свойства на раздела меню на командите бутон Измени:

    9T5rZ.edprop_menu.png

    В резултат на това ще се отвори форма за настройки на свойствата на текущия раздел:

    Натиснете върху  рисунката, за да я увеличите
  • от административния раздел с помощта на бутон 1tQpw.folder_prop.gif Свойства на папка, разположен на контекстния панел на Менажера за файлове. В резултат ще бъде отворена форма за настройка на свойствата на текущата папка.

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

За да измените названието на линка към раздела в нишката за навигация, трябва да се редактира Заглавието на папката. Названието на линка ще бъде изменено веднага след съхраняване на новите свойства на раздела.

0hceW.nav_chain1.png

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

Управление чрез кода на страницата

С помощта на php функция AddChainItem() в нишката за навигация могат да бъдат добавени допълнителни позиции. В качеството на значения на позиции в навигационната нишка могат да се ползват както статични, така и динамични величини:

<?
//---Първия параметър на функция AddChainItem() задава названието,

//---което ще бъде показано в навигационната нишка, втория параметър се задава

//---ссылка для перехода.

//---Значенията на параметрите могат да бъдат както статични, така и динамични.

//---в посочения пример названието на раздела е зададено със статична величина, а

//---линка се формира динамично. 

$APPLICATION->AddChainItem("Подробна информация за стоката", "catalog.php?BID=".$arIBlock["ID"]."&ID=".$arSection["ID"]);

//---В дадения по-долу пример и двете величини се формират динамично.

//---В качеството на названия се въвежда текущото значение на раздела на каталога.

$APPLICATION->AddChainItem($arSection["NAME"], "catalog.php?BID=".$arIBlock["ID"]."&ID=".$arSection["ID"]);

?>

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

<?$APPLICATION->AddChainItem($APPLICATION->GetTitle());?>

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

vZEKX.nav_chain2.png

Такива позиции се създават чрез добавяне шаблона за показване на навигационната нишка чрез следния код:

 if($arResult[$index]["LINK"] <> "")
  $strReturn .= '<li><a href="'.$arResult[$index]["LINK"].'" title="'.$title.'">'.$title.'</a></li>';
 else
  $strReturn .= '<li>'.$title.'</li>';

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

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

По аналогичен начин в навигационната нишка се добавят названия на форум и теми на форуми.

В този случай значението на позицията от навигационната нишка за тази страница се определят непосредствено в документа. За целта се ползва функция AddChainItem().

 

 Управление на показването на нишката

 

Показването на навигационната нишка става с помощта на специален код в шаблона на сайта:

<?
$APPLICATION->ShowNavChain();
?>

Функцията за извикване на навигационната нишка може да се ползва не само в шаблона на сайта, но и в кода на страници или отделни компоненти, представени на страница. Например, показването на навигационна нишка се ползва в компонента търсене:

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

Забележка: В демо-версията на продукта шаблона на нишката за навигация, използван в компонента за търсене, се съхранява в каталога на шаблона на компонента за търсене във файла chain_template.php.

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

  • На страницата за настройки на модула Управление на структурата се създава свойство за страници Не показвай навигационната нишка с код not_show_nav_chain. Това свойство е предварително включено в системата;

    OG1i0.props.png
  • ако навигационната нишка не трябва да се показва на определена страница или страница някакъв раздел, то за тази страница или раздел трябва да се включи значение на това свойство равно на Y.

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

    Освен това, значението на свойството Не показвай навигационната нишка може да бъде въвеждано непосредствено в кода на страницата с помощта на функция SetPageProperty():

    <?
    require($_SERVER["DOCUMENT_ROOT"]."/bitrix/header.php");
    $APPLICATION->SetPageProperty("description", "«1C-Битрикс: Управление на сайта» - система за разработка и управление на web-проекти");
    $APPLICATION->SetPageProperty("keywords", "Сайт, управление на сайта, система за управление");
    $APPLICATION->SetPageProperty("NOT_SHOW_NAV_CHAIN", "Y");
    $APPLICATION->SetTitle("Пробна версия на продукта «Bitrix Site Manager»");
    ?>

Подробна информация за управление на свойствата на страниците и разделите е дадена в раздел Свойства на страници и раздели.

 Управление на шаблона на навигационната нишка

 

В текущата версия на продукта нишката за навигация на сайта се включва в шаблона с помощта на компонента 2.0 NVZiP.breadcrumb.png Навигационна нишка (bitrix:breadcrumb). За този компонент може да бъде създадено произволно количество шаблони, т.е. външни видове. Всички те се съхраняват в папката на компонента /bitrix/components/bitrix/breadcrumb/templates/<название на шаблона>/. Всички създадени шаблони ще се показват в настройките на компонента. По този начин за всеки шаблон на сайта може да бъде включен свой шаблон за нишка за навигация. Структурата на шаблона за показване на навигационната нишка е аналогична на структурата на шаблона за показване на менюто.

Пример за шаблон на навигационна нишка:

<?
if(!defined("B_PROLOG_INCLUDED") || B_PROLOG_INCLUDED!==true)die();

if(empty($arResult))
 return "";

$strReturn = '<ul class="breadcrumb-navigation">';
for($index = 0, $itemSize = count($arResult); $index < $itemSize; $index++)
{
 if($index > 0)
  $strReturn .= '<li><span> > </span></li>';
$title = htmlspecialcharsex($arResult[$index]["TITLE"]);
 if($arResult[$index]["LINK"] <> "")
  $strReturn .= '<li><a href="'.$arResult[$index]["LINK"].'" title="'.$title.'">'.$title.'</a></li>';
 else
$strReturn .= '<li>'.$title.'</li>';
}
$strReturn .= '</ul>';
return $strReturn;
?>

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

gkk52.chain_comp.png

При включване на навигационната нишка с помощта на функция ShowNavChain() нейния шаблон може да бъде задаван допълнително за отделен раздел на сайта. За целта непосредствено във файла .section.php се определя променлива $sChainTemplate, където се задава пълния път към шаблона за показване на навигационната нишка. Например:

$sChainTemplate = "/bitrix/templates/demo/chain_template.php"

Шаблона за навигационната нишка може да бъде също така задаван и при извикване на функция ShowNavChain() като един от параметрите на функция.

$APPLICATION->ShowNavChain("/bitrix/templates/.default/chain_template_bottom.php")
Споделете: