CMS Bitrix Site Manager - интеграция (шаблон, структура, навигация) 4
- bitrix
- 15 256 прочитания
Урокът е от архива на сайта и е писан преди години. Някои бутони и менюта в програмите вече може да изглеждат различно.
Съдържание на главата:
* Редактиране на служебни области
* Управление на стиловете
o Използване на каскадни стилове
o Работа със стилове във визуалния HTML-редактор
o Пример на таблица стилове за шаблона на сайта
o Механизъм на реализация
* Включване на административния панел
o Включване на административния панел
o Добавяне на бутони в административния панел
* Управление на кодировката на страниците
o Използване на кодировки
o Определяне на текуща кодировка
* Управление на метаданните
o Управление на значения на метаданни чрез визуалния интерфейс
o Управление на метаданни в кода
* Управление на заглавието на документа
o Използване на заглавието
o Управление на заглавието чрез визуалния интерфейс
o Управление на заглавието в кода
Редактиране на служебни области
Ако за създаване (редактиране) на шаблона използвате визуалния редактор, то управлението на служебните области може да се прави в специална форма. Прехода към тази форма става с помощта на бутона Редактирай служебните области на шаблона, разположен в панела на редактора.

Формата за редактиране на областите се състои от две вложки: Горна част и Долна част.
На първата вложка се прави редактиране на горната част на шаблона до
тага <body>. Вие можете да въвеждате
съдържание на областта със значения по подразбиране. За целта натиснете
бутон
и във формата ще бъде вмъкнат набор от
стандартни функции, като включване на кодировката на страниците,
показване на заглавие и метаданни на страницата, включени файлове на
стилове и др. Аналогично, на вложка Долна част се извършва
редактиране на долната част на шаблона, чието съдържание също може да
бъде със значения по подразбиране.
ShowMeta(),
ShowTitle(), ShowCSS() и т.н. позволява да се
прави инициализация на отделни елементи непосредствено от скрипта на
страницата или от компонента. Например, заглавието на страницата може да
бъде добавено след показване на резултата от работата на скрипта. По
този начин, ако преди е било нужно да се прави инициализация на
заглавието на страницата преди включването на основния дизайна, то сега
може да се прави въвеждане на заглавие на страница непосредствено от
кода в работната област на страницата.
Управление на кодировката на страниците
Този раздел съдържа информация за използването на кодировки за коректно показване на информацията на страниците на сайта. След изучаване на раздела вие ще получите представа за основните принципи на ползване, а също така начините за настройка и включване на различни кодировки.
Съдържание на главата:
* Използване на кодировки
* Определяне на текуща кодировка
Използване на кодировки
Една от важните характеристики на продукта «Bitrix Site Manager» е поддръжката на произволен брой езици. Системата позволява да се:
- използва многоезичен интерфейс в административния раздел;
- създават произволно количество сайтове* на различни езици в
рамките на една система;


* - количеството сайтове е ограничено от вашия лиценз.
За коректно показване на националните символи се използват съответните кодировки. При показване на страницата браузера разпознава използваната кодировка и на нейна основа изпълнява показването на символите.
По-долу се дава списък с таблици кодове, използвани за показване на символи на руски, английски и немски езици:
|
Пълен списък на кодировките, използвани за различни езици се дава в документацията на продукта.
Ако дадена кодировка не се ползва, но в системата е необходимо съчетаване на различни езици, то за всеки език трябва да се определи кодова таблица, с използването на която ще се показват текстовите съобщения.
Настройката на кодировката се прави отделно за административния и публичния раздел:
- Настройка на кодировката, ползвана в публичния раздел, се прави за
всеки сайт:
Настройки > Настройка на продукта > Сайтове > Список на сайтове.
Кодировката се определя, като се изхожда от езика, използван на сайта. Също така при настройка на параметрите на езика може да се задава формат на време и дата, което позволява правилно да се показват тези данни в публичния раздел (например, при показване на новини, стоки в каталога и т.н.).
- Настройка на кодировката за административния раздел на сайта се
прави чрез формата за управление на параметрите на езиците, използвани в
системата:
Настройки > Настройки на продукта > Езици на интерфейса.
Също така при настройка на параметрите на езика може да се определи формат на време и дата. Указания формат ще се ползва при показване на дата и време в административния раздел на сайта.

Определяне на текуща кодировка
Текущата кодировка, използвана в публичния раздел на сайта се
определя с помощта на php-константа LANG_CHARSET, поставена
в областта на заглавието на шаблона на сайта.
При прилагане на шаблона към сайта се запитва значението на
параметъра кодировка, определен в настройките на сайта. На константата LANG_CHARSET
се дава значение, равно на значението на параметъра кодировка.
Пример на код, с помощта на който се изпълнява включването на кодировка на страницата е даден по-долу:
< head >
…
< meta http-equiv="Content-Type" content="text/html; charset=< ?echo LANG_CHARSET? >" >
…
< head >
Управление на метаданните
В този раздел се описват основните инструменти и способи за управление на метаданни на страници и раздели, представени в продукта «Bitrix Site Manager».
Съдържание на главата:
* Управление на значения на метаданни чрез визуалния интерфейс
* Управление на метаданни в кода
Управление на значения на метаданни чрез визуалния интерфейс
Обичайно, основната цел на използването на метаданни е оптимизация на сайта за търсещи системи. Търсачките използват метаданни за индексация на документите на сайта.
За пример на управление на метаданни в продукта може служи механизма на въвеждане на ключови думи и описания за страници и раздели на сайта. По подразбиране в дистрибутива на продукта е настроено управление именно на тези два типа метаданни (по аналогична схема списъка с възможни варианти може да бъде допълнен).
За да имате възможност да управлявате значенията на метаданните, предварително е необходимо да се създадат съответните свойства в настройките на модула "Управление на структурата":
Настройки > Настройки на продукта > Настройки на модулите >Управление на структурата.
keywords
и description.Забележка: Набора от свойства може да бъде въвеждан отделно за всеки сайт, работещ под управлението на системата.

Подробна информация по настройка на свойствата на страници и раздели, а също така по управление на значенията на метаданните вие можете да получите в раздел Свойства на страници и раздели на сайта.
Управление на метаданни в кода
За извеждане на значенията на метаданните в кода на страницата трябва
да използвате функция ShowMeta(), поставена в пролога на
шаблона за дизайна на сайта:
< head >
…
< ?$APPLICATION->ShowMeta("keywords")?>
< ?$APPLICATION->ShowMeta("description")?>
…
</head>
Да предположим, че за страницата са определени следните значения на свойства ключови думи и описание:
C помощта на функция SetPageProperty() значението на
тези свойства ще бъдат приложени към страницата:
< ?
$APPLICATION->SetPageProperty("keywords", "уеб, разработка, програмиране");
$APPLICATION->SetPageProperty("description", "Система за управление на сайта");
?>
Тогава в резултат на работата на функция ShowMeta() в
кода на страницата ще бъде въведен следния HTML-код:
<meta name="keywords" content=" уеб, разработка, програмиране ">
<meta name="description" content=" Система за управление на сайта ">
Ако за самата страница значение на свойството не е въведено, то ще бъде взето значение на свойството на вишестоящия раздел (рекурсивно до корена на сайта). Ако значение на свойството не е определено, то значението на съответния мета-тага ще остане незададено. Свойствата на страницата могат да бъдат включвани динамично от кода на компонентите, разположени на страницата. Например, за страница за показване на информация от каталога или новините свойствата на страницата могат да бъдат въвеждани в съответствие с определени свойства на елементите от инфоблока:
$APPLICATION->SetPageProperty("description",$arIBlockElement["PROPERTIES"][$META_DESCRIPTION]["VALUE"]);
В този случай в качеството на значение на свойството на страницата description
ще бъде използвано значение на свойство на елемента от информационния
блок с код meta_description. По този начин, може да се
създават свойства keywords и description за
елементи на каталога и динамично да се въвеждат в кода на страницата.
Управление на заглавието на документа
Този раздел съдържа подробна информация за настройка и управление на заглавието на документите и прозорците на уеб-браузера с използване на средствата на системата.
Съдържание на главата:
* Използване на заглавието
* Управление на заглавието чрез визуалния интерфейс
* Управление на заглавието в кода
Използване на заглавието
Използването на заглавието помага да се привлече вниманието на посетителите към страницата на сайта, а също и да се създаде обща представа за нейното съдържание и роля. Освен това, за да може посетителя безпогрешно да определи, в кой прозорец е отворена интересуващата го страница, се препоръчва да се въвеждат допълнителни заглавия на страниците за показване, като заглавие на самия прозорец на браузера:
- показване на заглавие на документа в горната част на браузера:
- показване на заглавие на документа в съдържателната част на
документа:
Заглавията на страниците се използват и при индексацията на сайтовете от търсачките и се показват във вид на линкове към съответните ресурси на сайта.
Системата «Bitrix Site Manager» позволява да се извършват следните операции със заглавието на страницата:
- определяне на еднакво заглавие за страниците на сайта и на
прозореца на уеб-браузера;
- въвеждане на различни заглавия за страницата на сайта и прозореца
на уеб-браузера;
- въвеждане на заглавия на страница и прозореца на уеб-браузера динамично, например, с използване на:
Управление на заглавието чрез визуалния интерфейс
Създаването и промяната на заглавие на страница, а също и в прозореца на уеб-браузера може да бъде направено както с помощта на средствата в административния, так и в публичния раздел.
За удобно използване на свойството трябва да се въведе негово име (например, Допълнително заглавие (заглавие за прозореца на уеб-браузера)) в настройките на модула Управление на структурата.
Управление чрез административния раздел
Ако се намирате в административния раздел, то начина да въведете заглавие на страница се определя от избора на режима за редактиране на самата страница:
- при използване на текстовия редактор заглавието на съдържателната
част на страницата се въвежда в полето Заглавие на страница,
заглавието за прозореца на браузера е в свойството Допълнително
заглавие (въвежда се в случай, че трябва да се отличава от основното
заглавие на страницата);
- при редактиране на текущия документа в режим на визуален HTML-редактор:
- заглавието може да се въвежда непосредствено в кода на страницата
при редактиране в режим Редактирай като PHP:

Управление чрез публичния раздел
В публичния раздел на сайта въвеждането на основно и допълнително заглавие за създаваната страница става в процеса на работа на Помощника за създаване на страница:
| |
За редактиране на заглавието на съществуваща страница трябва да използвате Свойства на страница в менюто на командите бутон Измени, разположен на административния панел:

Управление на заглавието в кода
Въвеждане и показване на заглавие на страница
Заглавието на страницата може да бъде въведено по следните способи.
- При редактиране на документа с помощта на вградения редактор (в
режим «Текст», «PHP» или «HTML»). В този случай заглавието на страницата
се въвежда чрез включване в кода на документа на следната функция:
<?
$APPLICATION-> SetTitle("За фирмата");
?> - Заглавието на документа може да се въвежда динамично чрез един от
компонентите, разположени на страницата. В показания по-долу пример в
качеството на заглавие на страницата се използва името на текущия
информационен блок:
<?
$arIBlock = GetIBlock($ID, "news")
$APPLICATION->SetTitle($arIBlock["NAME"]);
…
?>
Показването на заглавието на документа става с помощта на поставянето
на функция ShowTitle() в местото за показване на
заглавието на страницата:
<H1><?$APPLICATION->ShowTitle()?></H1>
Ако при показване на заглавието на страницата функция ShowTitle()
използва параметъра false, это означава, че за включване
на заглавие на страницата не е нужно да се проверява значението на
свойство title.
<H1><?$APPLICATION->ShowTitle(false)?></H1>
Т.е. в качеството на заглавие на страница ще се използва заглавието,
определено от функция SetTitle().
Въвеждане и показване на заглавие за прозореца на уеб-браузера
Показването на заглавие за прозореца на уеб-браузера се изпълнява с
помощта на кода ShowTitle(), поставен в областта <head>
в шаблона за дизайна на сайта:
<head><title><?$APPLICATION->ShowTitle()?></title></head>
Заглавието за прозореца на уеб-браузера може да бъде въведено с
използване на различни механизми. По подразбиране заглавието се въвежда в
свойство на страницата title. Ако значението на това
свойство не е указано, то заглавието за прозореца на браузера ще бъде
еднакво с текущото заглавие на страницата.
Управление на стиловете
Информацията в този раздел дава представа за основните цели и способи на ползване на таблици каскадни стилове (CSS) на сайта.
Съдържание на главата:
* Използване на каскадни стилове
* Работа със стилове във визуалния HTML-редактор
* Пример на таблица стилове за шаблона на сайта
* Механизъм на реализация
Използване на каскадни стилове
Каскадните стилове представляват съвкупност от правила, прилагани за оформяне на определени елементи на страниците на сайта. Технологията на каскадните стилове (CSS) позволява съхраняване на цялата информация за разпределението на страницата, използваните на нея шрифтове, цветове, стилове за оформяне на меню и т.н. в определено място (един или няколко файла).
Използването на CSS опростява задачата по оформянето на страницата на сайта. Освен това, при промяна на дизайна на сайта или негови отделни елементи няма необходимост от редактиране на всяка страница: достатъчно е просто да се измени съответната таблица стилове.
Така, например, може да се измени оформянето на форума (шрифт, цвят на елементите и др.) В дадения пример стиловете за форума се задават отделно от стиловете на общия шаблон на сайта.
![]() |
.forumborder {background-color:#CACBBD;}
|
![]() |
.forumborder {background-color:#96C0FA;}
|
Каскадните стилове се настройват отделно за всеки шаблон на сайта,
използван в системата, и се поставят в папки съответстващи на шаблоните
на сайта. Каскадните стилове за представяне на вътрешното съдържание на
страниците на сайта се съхраняват във файлове от вида styles.css
в папката на съответния шаблон. Допълнителните таблици стилове,
например, стиловете за форума, могат да имат имена от вида: forum.css.
- стиловете, използвани в шаблона за дизайна, се съхраняват
отделно във файл
template_styles.css. - стиловете, използвани при оформяне на съдържанието на
страниците (стилове на сайта), се съхраняват във файл
styles.css. Стиловете от този файл се показват в падащия списък със стилове при редактиране на страници във визуалния редактор.
Формирането на таблици стилове за сайта (файл styles.css)
става на страницата за редактиране на шаблона за дизайна на вложка Стилове
за сайта. Важен елемент при създаване на таблиците стилове за
страници е създаването на имена на стиловете. Имена трябва да се
създават само за тези стилове, които се планира да се ползват при
редактиране на страници в режим на визуален HTML-редактор (секция Описание
на стилове).
Стиловете ще са достъпни във визуалния редактор от падащия списък под
имената, определени в дадената форма. Зададените тук имена ще се
съхранят във файла <идентификатор_на_шаблона>/.styles.php
(файл с имена на стилове).
Създаването на таблици стилове за шаблона на дизайна (файл template_styles.css)
става на вложка Стилове на шаблона форма за редактиране на
шаблона на сайта
Работа със стилове във визуалния HTML-редактор
Важен елемент при формиране на каскадните стилове е добавяне на
названията на стиловете. Имената на стиловете могат да бъдат добавени
непосредствено във файл .styles.php. Този файл се намира в
папката на шаблона на сайта и има следния формат.
<?
$arStyles = Array(
"information-block-head" => "Заглавие на инфоблока",
"content-block-head" => "Заглавие с отстъп",
"information-block-body" => "Текст на елементите от инфоблока",
"tablehead" => "Таблица - шапка",
"tablebody" => "Таблица - тяло",
);
return $arStyles;
?>
Също така названия на стилове могат да се добавят във формата за
редактиране на шаблона на вложко Стилове на сайта. В
този случай файла .styles.php се създава автоматично.
Названията на стиловете ще се показват във визуалния редактор в падащия списък.
Ако във формата за настройки на модул Управление на структурата на вложка Визуален редактор се избере опция Разреши във визуалния HTML редактор да се показват стилове без имена,
то в списъка ще бъдат показани всички достъпни за страницата стилове, включително тези, за които не са давани имена:
За обозначаване на стила с неустановено название ще бъде ползвано
име, зададено при създаване на стила: information-block, content-block
и т.н.
Също така в таблицата стилове ще могат да бъдат създадени стилове, прилагани към определени html-елементи в страницата (например, граници на таблици, клетки, рисунки и др.). При отбелязване на тези елементи в списъка ще бъдат показвани достъпните за тях стилове.
Пример на таблица стилове за шаблона на сайта
Стилове за ляво меню:
.leftmenu, .leftmenuact {font-family: Arial, Helvetica, sans-serif;
font-size:12px; font-weight: bold; text-decoration: none;}
.leftmenu {color: #3F3F3F;}
.leftmenuact {color:#FF5235;}
Стилове за горно меню:
.topmenu {font-family: Arial, Helvetica, sans-serif; font-size:12px;
font-weight: bold; color: #FFFFFF; text-decoration: none;}
.topmenuact {font-family: Arial, Helvetica, sans-serif; font-size:12px;
font-weight: bold; color: #FAC535; text-decoration: none;}
Стилове за таблици:
.tableborder {background-color:#9C9A9C;}
.tablehead {background-color:#D8D9DA;}
.tablebody {background-color:#F8F8F8;}
.tablebodytext, .tableheadtext {font-family: Arial, Helvetica, sans-serif;
font-size:12px;}
.tablebodytext {color:#000000;}
.tableheadtext {color:#000066;}
Механизъм на реализация
Каскадните стилове се включват към шаблона на сайта в областта на
пролога с помощта на функция ShowCSS().
<?
$APPLICATION->ShowCSS();
?>
Функцията ShowCSS() изпълнява включване на файла със
стиловете от текущия шаблон на сайта, а също така на всички допълнителни
стилове определени за дадената страница с функция SetAdditionalCSS().
<?
$APPLICATION->SetAdditionalCSS("/bitrix/templates/demo/additional.css");
?>
Допълнителните стилове могат да се ползват, например, за оформяне на форума, уеб-форми, таблици, някои типове менюта и т.н.
Обърнете внимание! При използване на функция ShowCSS()
без параметри за включване на стилове ще бъде изпълнено във вид на линк
към CSS файла:
<LINK href="/bitrix/templates/demo/styles.css" type="text/css" rel="STYLESHEET">
При това стиловете, включени с използване на SetAdditionalCSS(),
ще бъдат включени в кода на страницата с използване на PHP функция require()
(т.е. ще бъдат напълно включени в окончателния код на страницата).
В случай на използване на функция ShowCSS() с параметър false
файла със стиловете за текущия дизайн ще бъде включен също в кода на
страницата с използване на require():
<?
$APPLICATION->ShowCSS(false);
?>
Включване на административния панел
Съдържание на главата:
* Включване на административния панел
* Добавяне на бутони в административния панел
Включване на административния панел
След авторизиране на сайта за ползващия със съответни права става достъпен панел Административен панел в горната част на страницата. С негова помощ може да се:
- управляват параметри на текущия раздел;
- премине към редактиране на текущата страница и включените области;
- добави и промени меню на текущия раздел;
- настроят параметри на компоненти;
- бързо да се премине в административния раздел на сайта;
- и много друго.
Кода за включване на административния панел де въвежда в служебната
област на шаблона за дизайна на сайта веднага след тага <body>
преди началото на първата таблица.
<?
$APPLICATION->ShowPanel();
?>
Добавяне на бутони в административния панел
Ползващия може самостоятелно да добавя бутони в административния панел. Например, да добавим в панела бутон Редактирай урок, който ще се показва при преглед на учебния курс. За целта направете следното:
- Създайте файл
/bitrix/php_interface/include/add_top_panel.php; - Добавете следния код и съхранете файла:
<?
if (($APPLICATION->GetCurPage() == "/communication/learning/course/index.php") &&
$USER->IsAdmin()) //проверка на адреса на страницата и
//принадлежност на ползващия към групата на администраторите
{
$main_sort = 100; //сортиране за групата на бутоните
$alt = "Редактирай урок"; //текста на изскачащото подсказване
$link = "Y"; //е линк
$href="/bitrix/admin/learn_lesson_edit.php?lang=".LANGUAGE_ID."&ID=".
$_GET["LESSON_ID"]."&COURSE_ID=".$_GET["COURSE_ID"]."&CHAPTER_ID=".$_GET["CHAPTER_ID"]; //линк към нужната страница
$src="/bitrix/images/fileman/panel/edit_lesson.gif"; //иконка на бутона
$APPLICATION->AddPanelButton(array("LINK"=>$link, "HREF"=>$href, "SRC"=>$src, "ALT"=>$alt, "MAIN_SORT"=>$main_sort, "SORT"=>200));
//добавяне на бутона в панела
}
?> - Извикваната в пролога на страницата функция
$APPLICATION->ShowPanel()прави проверка за наличие на указания файла и изкарва в панела описаните в него бутони.
С помощта на дадения код в административния панел ще бъде добавен бутон, който ще бъде показван само на администраторите и само на страницата за преглед на курса.
При натискане на бутона ще бъде извършван преход към административния раздел за редактиране на преглеждания урок.
Освен това, за модула Информационни блокове бутони в панела се
добавят с помощта на функция CIblock::ShowPanel().
Количеството бутони може да варира, например, в зависимост от това
извършва ли се показване на списъка с елементи на информационния блок
или подробно показване на информация за един елемент. Компонентите на
информационните блокове имат специална опция, определяща, да се добавят
или не бутони в административния панел.
















