integration guide

1С-Битрикс Управление сайтом 6x Руководство по интеграции

2

copy laquo1C-Битриксraquo 2007

Введение Данное руководство предназначено для разработчиков веб-сайтов на основе программного продукта laquo1C-Битрикс Управление сайтом 6xraquo В документе подробно рассматривается процедура интеграции продукта в новый или уже существующий сайт

В данном документе подразумевается что разработчик владеет базовыми технологиями для разработки веб-сайта такими как HTML CSS PHP

3


Новая технология интеграции Версия 6x продукта laquo1C-Битрикс Управление сайтомraquo включает в себя целый ряд новшеств направленных на ускорение процесса разработки сайтов

Сохраняя традиционную гибкость системы шаблоны дизайна позволяют в течение нескольких часов провести интеграцию дизайна с программным продуктом laquo1C-Битрикс Управление сайтомraquo и приступить к построению структуры проекта и размещению программных компонентов В текущей версии продукта доступно редактирование шаблона дизайна в визуальном режиме Кроме того многие элементы шаблона дизайна такие как переключатель сайтов вставка включаемые области навигационная цепочка меню и др вынесены в компоненты и поэтому подключать их в шаблоне дизайна стало проще

Шаблон сайта может быть загружен в систему одним файлом с использованием встроенного веб-интерфейса продукта и применен к одному или нескольким сайтам Используемые в системе шаблоны могут быть выгружены (экспортированы) в виде комплекта файлов и использованы в других проектах

Шаблоны и сайты Продукт laquo1C-Битрикс Управление сайтомraquo поддерживает многосайтовость что позволяет создать несколько сайтов на одной копии продукта Каждый сайт может характеризоваться собственным доменным именем внешним видом языком интерфейса и информационным наполнением

Внешний вид сайта определяется шаблоном дизайна Для каждого сайта может быть назначено неограниченное количество шаблонов Использование шаблонов открывает широкие возможности для настройки внешнего вида сайта и изменения его дизайна в зависимости от различных условий

Продукт позволяет гибко настроить дизайн для различных сайтов разделов сайта использовать специальный праздничный дизайн в течение определенного времени задать отдельные шаблоны дизайна для различных групп посетителей сайта в зависимости от определенного параметра в адресе и тп (рис 11)

Рис11 Шаблоны и сайты

Выбор и назначение шаблонов для каждого сайта выполняется в административном разделе Настройки ndash Настройки продукта ndash Сайты ndash Список сайтов

4


Для каждого шаблона дизайна может быть задано условие при котором данный шаблон будет применен к страницам сайта (рис 12) Если условие не задано то шаблон применяется по умолчанию как основной Рассмотрим условия применения того или иного шаблона в настройках Демо-сайта

Рис 12 Настройка шаблонов сайта

В соответствии с условиями представленными на рисунке 12 шаблоны дизайна будут применяться к страницам сайта следующим образом

Корпоративный сайт (на главную страницу выведен каталог книг) будет использоваться в качестве основного шаблона сайта так как для него не задано условие показа Шаблон Прохождение курса обучения будет использован для страниц раздела communicationlearningcourse на сайте Шаблон Версия для печати будет использован если URL адрес страницы содержит параметр print=Y Например ссылка на странице сайта httpwwwsite2comprint=Y позволит посетителю получить версию документа для печати

На заметку условие может содержать любой программный код на языке PHP в том числе вызовы API-функций продукта Для получения дополнительной информации смотрите документацию к продукту

Вы можете убедиться что шаблон настроен правильно нажав на иконку рядом с выпадающим списком шаблонов Вы увидите сайт с выбранным шаблоном в режиме предварительного просмотра еще до применения изменений

При создании шаблона сайта возможно использование различных программных условий влияющих на отображение тех или иных элементов шаблона для различных разделов сайта Для этого для раздела сайта нужно определить некоторое свойство значение которого будет проверяться в шаблоне сайта

lt if ($APPLICATION-gtGetProperty(SECT_PROP ) == ldquoYrdquo)gt

Подобные условия можно вводить для любых элементов шаблона Например можно отключать показ включаемых областей или управлять показом навигационной цепочки и тп

К одному сайту может быть применено неограниченное число шаблонов Один и тот же шаблон может быть использован многократно для любых сайтов при различных условиях

5


Управление шаблонами Структура шаблона Дизайн сайта обычно состоит из трех основных частей (рис 21)

sect Верхняя часть дизайна (header) sect Рабочая область страницы в которой размещаются информационные материалы сайта компоненты или любой другой программный код

sect Нижняя часть дизайна (footer)

Рис 13 Основные части дизайна

Рассмотрим как в шаблоне настраиваются части дизайна на примере шаблона Корпоративный сайт который включен в поставку продукта

Управление шаблонами дизайна осуществляется в административном разделе Настройки ndash Настройки продукта ndash Сайты ndash Шаблоны сайтов В указанном разделе можно просмотреть существующие шаблоны модифицировать их или же добавить свои собственные шаблоны сайта Например зайдем в режим редактирования шаблона Корпоративный сайт выбрав действие Изменить

На закладке Шаблон представлен внешний вид шаблона дизайна сайта Начиная с версии 60 стало возможным создание шаблона дизайна сайта в визуальном режиме с использованием программных компонентов

6


Рис 14 Редактирование шаблона в визуальном режиме

Обратите внимание Редактирование шаблона дизайна сайта в визуальном режиме будет происходить корректно если в атрибутах HTML тегов не содержится php-код а также если например строки и ячейки таблицы не прерываются php-кодом при формировании таблицы Если в коде шаблона дизайна сайта есть такие особенности то редактировать его следует только в режиме кода Разрешить визуальное редактирование шаблона можно в настройках Главного модуля

Рис 15 Настройки главного модуля

Шаблоны демонстрационной версии специально адаптированы для работы в данном режиме Не рекомендуется включение данного режима на других шаблона если вы не уверены что он отвечает заданным требованиям ndash шаблон может быть утерян при сохранении

Шаблон в этом поле представляет собой объединенные верхнюю и нижнюю часть дизайна сайта В HTML код вставляются компоненты и функции на языке программирования PHP

7


которые обеспечивают показ различного рода информации метаданных заголовка страницы таблицы каскадных стилей административной панели и последующее управление этой информацией с использованием визуальных инструментов

Обратите внимание на наличие в шаблоне разделителя WORK_AREA который используется для указания границы между верхней и нижней частью дизайна Именно в этом месте выполняется подключение рабочей области страницы Такой разделитель можно вставить непосредственно в коде шаблона а можно воспользоваться кнопкой расположенной в панели инструментов визуального редактора По нажатии на нее в

рабочую область вставится разделитель

Каждая часть шаблона храниться в отдельном файле sect верхняя часть шаблона дизайна храниться хранится в файле hellipltидентификатор шаблонаgtheaderphp

sect нижняя часть шаблона дизайна храниться в файле hellipltидентификатор шаблонаgtfooterphp

Внимание Система не устанавливает никаких ограничений в шаблонах и внешнем виде сайта

Использование шаблона с программным кодом обеспечивает необходимую гибкость при реализации интернет-проекта позволяет реализовать как простые шаблоны так и шаблоны с произвольной программной логикой и индивидуальным внешним видом При создании шаблона можно воспользоваться программными компонентами для шаблона включенными в поставку продукта меню навигационная цепочка переключатель сайтов форма поиска и др

Каскадные стили используемые в шаблоне рекомендуется разделять на две таблицы стилей хранящиеся в двух разных файлах Оба файла находятся в директории hellipltидентификатор шаблонаgt Один из файлов носит название stylescss и содержит стили для представления внутреннего содержания страниц на сайте Содержимое этого файла отображается при редактировании шаблона на закладке laquoСтили сайтаraquo Во втором файле ndash с именем template_stylescss - описаны стили для представления шаблона дизайна Содержимое этого файла отображается при редактировании шаблона на закладке laquoСтили шаблонаraquo

Все шаблоны хранятся в директории bitrixtemplates Набор файлов каждого шаблона находится в поддиректории название которой соответствует идентификатору шаблона В рассматриваемом нами примере шаблон размещается в каталоге

bitrixtemplatesthree_columns

Примечание При создании нового шаблона через интерфейс задается его идентификатор название описание для показа в списке код шаблона внешнего вида сайта таблицы стилей и набор используемых включаемых компонентов и картинок При сохранении шаблона автоматически создается поддиректория bitrixtemplatesltидентификатор шаблонаgt

Каждый шаблон имеет схожую структуру файлов и поддиректорий Простейший шаблон может состоять всего из нескольких основных файлов headerphp footerphp stylescss template_stylescss а также нескольких файлов для шаблонов меню

Все графические элементы используемые в шаблоне размещаются в директории bitrixtemplatesltидентификатор шаблонаgtimages В каталоге шаблона могут быть также размещены другие файлы и компоненты Посмотреть состав шаблона в Менеджере файлов можно перейдя по ссылке показанной рядом с идентификатором шаблона

В виде отдельных файлов могут быть представлены любые области дизайна которые предполагается использовать в шаблоне сайта и к редактированию которых необходимо

8


иметь быстрый доступ Примерами таких областей могут служить область с указанием авторских прав (copyright) область с контактной информацией и тп

Включаемые области и компоненты Для динамического управления современным сайтом с использованием визуальных инструментов некоторые элементы дизайна в шаблоне представлены в виде программных компонентов Вернемся к шаблону Корпоративный сайт и познакомимся с основными программными компонентами и включаемыми областями На рисунке 14 выделены компоненты и включаемые области в данном шаблоне

Рис 16 Включаемые области в шаблоне

В HTML-коде прототипа проводятся замены выделенных областей на включения соответствующих компонентов

В код вставляются функции которые обеспечивают показ различного рода информации метаданных заголовка страницы подключение таблицы каскадных стилей вывод административной панели

Отдельно создаются шаблоны элементов навигации навигационная цепочка меню сайта

После создания HTML-прототипа и проведения требуемых подстановок функций и вызовов для программных компонентов в вашем распоряжении будет PHP-шаблон дизайна сайта

Все размещенные в шаблоне сайта области и компоненты доступны для быстрого редактирования из публичного раздела при работе в режиме показа включаемых областей (закладка на административной панели)

9


Рис 17 Режим показа включаемых областей и компонентов

Включаемые компоненты могут иметь различные элементы управления представленные различными иконками

Так например с помощью элементов управления рекламного баннера можно перейти к редактированию текущего баннера или же перейти к списку баннеров в административной части отфильтрованному по выбранному типу баннера Также для всех компонентов отображается иконка которая служит для редактирования параметров компонентов из публичной части

На сайте могут быть использованы различные включаемые HTML-области Включаемые области оформляются отдельными файлами и могут быть показаны например только для текущего раздела либо только для текущей страницы и тп Элемент управления каждой включаемой области позволяет перейти непосредственно к ее редактированию

10


Интеграция в деталях

Структура файлов Программный продукт laquo1С-Битрикс Управление сайтомraquo разработан таким образом что внешнее представление (или публичная часть) отделено от программного ядра Основная программная часть инсталлированного продукта размещается в папке bitrix в корневом каталоге сайта

Подкаталоги этой папки содержат следующие файлы

sect bitrixtemplates sect шаблоны внешнего вида (дизайна сайта) и пользовательские шаблоны компонентов Основная работа по интеграции существующего дизайна и продукта производится с файлами находящимися в этой директории

sect bitrixcomponents sect системные компоненты (в пространстве имен bitrix) и пользовательские компоненты Системные компоненты обновляются системой обновлений Их изменение не желательно

sect bitrixadmin sect интерфейс административной части Вызов различных форм управления и редактирования для всех основных модулей системы

sect bitrixcache bitrixmanaged_cache bitrixstack_cache

sect кэш-файлы созданные в процессе кэширования динамической информации прав доступа курсов валют и тд

sect bitrixphp_interface sect дополнительные системные файлы (информация для подключения к базе данных некоторые другие файлы)

sect bitrixmodules sect библиотеки классов и функций для основных модулей системы

sect bitriximages sect картинки для модулей установленных в системе

sect bitrixtools sect служебные файлы

sect bitrixupdates sect используется для загрузки обновлений

sect bitrixwizards sect системные (в пространстве имен bitrix) и пользовательские мастера Системные мастера обновляются системой обновлений и не могут изменяться пользователем

sect bitrix sect дополнительные служебные файлы

Типовая страница Сборка типовых страниц производится подключением пролога и эпилога для каждой страницы сайта В общем случае структура документов которые размещаются на сайте выглядит так lt require($_SERVER[DOCUMENT_ROOT]bitrixheaderphp) $APPLICATION-gtSetTitle(1С-Битрикс Управление сайтом 60) gt Тело документа Содержательная часть lt require($_SERVER[DOCUMENT_ROOT]bitrixfooterphp) gt

11


Свойства страниц и папок Предлагаемая в продукте возможность задавать свойства страниц и разделов позволяет организовать гибкое управление показом информации на сайте Задавая определенные свойства на страницах сайта можно устанавливать значения метаданных для различных страниц организовать смену графических элементов дизайна в зависимости от раздела сайта или отдельной страницы и тд

Значения свойств страниц и разделов могут быть заданы через соответствующий административный интерфейс либо непосредственно из программного скрипта

В продукте зарезервировано несколько названий свойств значения которых проверяются и используются некоторыми функциями

Примеры зарезервированных свойств

sect title свойство используется для установки дополнительного заголовка страницы (см Установка заголовка документа)

sect adv_desired_target_keywords свойство используется для установки желательных (desired) ключевых слов для показа рекламы на странице (см Размещение рекламных областей)

sect not_show_nav_chain свойство используется для выключения показа навигационной цепочки на странице или в разделе сайта (см Настройка цепочки навигации)

Создание шаблона сайта В процессе перевода шаблона от HTML-варианта к полноценному PHP-шаблону производится замена HTML-кода на вызов соответствующих PHP-функций методов и программных компонентов

Обратите внимание разработчик может использовать набор функций которые позволяют управлять вставкой в шаблон метаданных заголовка страницы навигационной цепочки включаемых областей и тп Использование функций ShowMeta() ShowTitle() ShowCSS() и тд позволяет производить инициализацию отдельных элементов непосредственно из скрипта на странице или из компонента Например заголовок страницы может быть добавлен уже после вывода результатов работы скрипта Таким образом если ранее требовалось производить инициализацию заголовка страницы до подключения основного дизайна то теперь появилась возможность производить установку заголовка страницы непосредственно из кода в рабочей области страницы Ниже приводится детальное описание используемых в типовом шаблоне функций и программных компонентов

Управление метаданными

Как это выглядит Примером управления метаданными в продукте может служить механизм задания ключевых слов и описаний для страниц и разделов сайта По умолчанию в поставляемой версии продукта настроено управление именно этими двумя типами метаданных но по аналогичной схеме список возможных вариантов может быть дополнен и другими

Как это работает Работа с метаданными осуществляется через управление свойствами страниц и разделов сайта Изменение свойств страницы может быть выполнено при редактировании текущего документа встроенным визуальным HTML-редактором в режиме Редактировать как HTML

(кнопка верхней панели инструментов) В режиме визуального редактирования перейти на закладку laquoСвойстваraquo и ввести значения соответствующих свойств страницы

12


Также свойства страницы могут быть заданы в режиме редактирования страницы как laquoТекстraquo Значения свойств для всех страниц раздела сайта задаются в отдельном диалоге доступном

по кнопке административной панели

Как это реализуется

Для вывода соответствующих метаданных в коде страницы необходимо воспользоваться следующей функцией ltheadgt hellip lt$APPLICATION-gtShowMeta(keywords)gt lt$APPLICATION-gtShowMeta(description)gt hellip ltheadgt

В результате работы функции в код страницы будет подставлен следующий HTML-код (пример) ltmeta name=keywords content=1с-битрикс CMS PHP bitrix система управления контентом gt ltmeta name=description content=1С-Битрикс Управление сайтом gt

Свойства страницы могут быть установлены динамически из скрипта Например для страниц показа информации каталога или новостей (информационных блоков) свойства страницы могут быть установлены в соответствии с определенными свойствами элементов информационных блоков

Таким образом можно создавать свойства keywords и description для элементов каталога и динамически подставлять их в код страницы

Установка кодировки страницы

Как это выглядит Некоторые языки не могут быть представлены одновременно в одной кодировке например русский и немецкий языки Поэтому если в системе используется подобное сочетание языков для каждого языка нужно определить кодовую таблицу с использованием которой будут отображаться текстовые сообщения

Как это работает Управление языками публичной части системы осуществляется из административного раздела отдельно для каждого сайта Настройки ndash Настройки продукта ndash Сайты ndash Список сайтов Для каждого сайта может быть указана индивидуальная кодировка формат вывода даты и времени

Настройка формата показа даты и времени позволяет правильно отображать данные при показе в публичном разделе сайта

Рис 21 Установка параметров языка для публичного раздела сайта

13



Кодировка страниц определяется с помощью константы PHP которая получает значение из настроек языка текущего сайта ltheadgt hellip ltmeta http-equiv=Content-Type content=texthtml charset=ltecho LANG_CHARSETgtgt hellip ltheadgt

Включение таблиц стилей

Как это выглядит Для форматирования различных элементов на сайте используются несколько таблиц стилей В отдельный файл stylescss вынесены стили используемые в рабочей области на сайте при создании содержимого страниц В отдельном файле template_stylescss содержатся стили применяемые в шаблоне дизайна сайта

Важным элементом при формировании таблицы стилей является создание названий стилей Названия следует создавать для тех стилей из файла stylescss которые планируется использовать при редактировании страниц в режиме HTML-редактора Задавать названия стилей можно в визуальном режиме при редактировании шаблона на закладке Стили сайта

Рис 22 Создание описаний стилей в настройках шаблона сайта

Стили будут доступны в редакторе из выпадающего списка под именами определенными в данной форме Заданные здесь названия будут храниться в файле ltидентификатор шаблонаgtstylesphp (файл с именами стилей)

Как это работает Для настройки таблиц стилей служат закладки laquoСтили сайтаraquo и laquoСтили шаблонаraquo на странице редактирования шаблона дизайна

14


Рис 23 Управление таблицей стилей в настройках шаблона сайта

Как это реализуется Подключение таблиц стилей производится в области ltheadgt пролога Весь необходимый HTML код подставляется функцией

lt$APPLICATION-gtShowCSS()gt

Указанная функция выполняет подключение файлов стилей stylescss template_stylescss текущего шаблона всех дополнительных стилей определенных для данной страницы функцией SetAdditionalCSS() стилей компонентов используемых на странице

Использование функции ShowCSS() без параметров произведет подключение стилей в следующем виде

ltLINK href=bitrixtemplatesthree_columnsstylescss type=textcss rel=STYLESHEET gt

ltLINK href=bitrixtemplatesthree_columnstemplate_stylescss type=textcss rel=STYLESHEET gt

При этом стили которые подключаются с использованием SetAdditionalCSS() будут включены в код страницы с использованием require() Визуальный редактор страниц подключает stylescss для использования

Визуальный редактор шаблона подключает template_stylescss и stylescss для использования

Отдельные компоненты версии 20 могут иметь свои таблицы стилей которые подключаются автоматически

15


Настройка цепочки навигации

Как это выглядит Навигационная цепочка позволяет визуально представить глубину вложенности пунктов меню начиная с главной страницы и до текущего документа Значения которые подставляются в навигационную цепочку могут быть заданы как для каждого раздела так и для каждого документа

Начиная с версии 60 навигационная цепочка подключается в шаблоне отдельным компонентом Навигационная цепочка (bitrixbreadcrumb) Как и для всех компонентов версии 20 для данного компонента можно создавать неограниченного число шаблонов внешнего вида

Рис 24 Цепочка навигации

В случае необходимости значение пункта навигационной цепочки для данной страницы определяется непосредственно в документе Для этого используется функция AddChainItem() Обратите внимание что некоторые скрипты и компоненты поставляемые в составе дистрибутива продукта добавляют определенные элементы в навигационную цепочку Так например компонент каталога последовательно добавляет в навигационную цепочку названия каталогов и групп товаров по мере погружения вглубь по уровням каталога Аналогичным образом в навигационную цепочку добавляются названия форумов и тем форумов

Как это работает По умолчанию в качестве ссылки на раздел в цепочке навигации используется заголовок раздела Значение заголовка сохраняется в файле sectionphp соответствующего раздела

Изменение заголовка раздела может быть выполнено в форме настройки свойств папки

соответствующего раздела (кнопка на административной панели) либо непосредственным редактированием файла sectionphp

Пример файла sectionphp lt $sSectionName = Главная страница gt


Шаблон показа навигационной цепочки определяется шаблоном компонента Навигационная цепочка (bitrixbreadcrumb) Этот шаблон рекомендуется копировать в нужный шаблон сайта средствами системы (используя кнопку панели компонента в режиме редактирования сайта) и затем редактировать его под конкретные требования

Обратите внимание Не рекомендуется производить редактирование системных компонентов и их шаблонов расположенных в папке bitrixcomponentsbitrix Эта папка обновляется системой обновлений поэтому ее изменения произведенные пользователем будут перетерты Шаблон навигационной цепочки в Демо-сайте состоит из таблицы стилей и самого шаблона Файл templatephp lt if(defined(B_PROLOG_INCLUDED) || B_PROLOG_INCLUDED==true)die() delayed function must return a string if(empty($arResult))

16


return $strReturn = ltul class=breadcrumb-navigationgt for($index = 0 $itemSize = count($arResult) $index lt $itemSize $index++) if($index gt 0) $strReturn = ltligtltspangtampnbspampgtampnbspltspangtltligt $strReturn = ltligtlta href=$arResult[$index][LINK] title=$arResult[$index][TITLE]gt$arResult[$index][TITLE]ltagtltligt $strReturn = ltulgt return $strReturn gt

Компонент навигационной цепочки подключается в виде кода следующим образом ltdiv id=navigationgtlt$APPLICATION-gtIncludeComponent( bitrixbreadcrumb Array( START_FROM =gt 0 PATH =gt SITE_ID =gt ) )gt ltdivgt

Ниже приведен пример добавления элементов в навигационную цепочку с использованием функции AddChainItem() lt ---Первым параметром функции AddChainItem() задается название ---которое будет показано в навигационной цепочке вторым параметром задается ---ссылка для перехода ---Значения параметров могут быть как статическими так и динамическими ---в приведенном примере название раздела задано статической величиной а ---ссылка формируется динамически $APPLICATION-gtAddChainItem(Детальная информация о товаре catalogphpBID=$arIBlock[ID]ampID=$arSection[ID]) ---В приведенном ниже примере обе величины формируются динамически ---В качестве названия подставляется текущее значение раздела каталога $APPLICATION-gtAddChainItem($arSection[NAME] catalogphpBID=$arIBlock[ID]ampID=$arSection[ID]) gt

Для того чтобы выводить в навигационную цепочку название текущей страницы необходимо вставить вызов функции AddChainItem() в файле footerphp те после вывода содержимого рабочей области lt$APPLICATION-gtAddChainItem($APPLICATION-gtGetTitle())gt

17


В шаблоне показа навигационной цепочки можно настроить показ элементов для которых не задана ссылка в виде обычного текста (например выводить название текущей страницы без ссылки) if (strlen($LINK)gt0) $sChainBody = lta href=$LINK class=$strclassgt$TITLEltagt else $sChainBody = ltfont class=$strclassgt$TITLEltfontgt

Показ навигационной цепочки может быть отключен на определенных станицах или в определенном разделе сайта Для этого для страницы или папки необходимо задать свойство с кодом not_show_nav_chain

На выбранных страницах или в заданных разделах сайта следует установить значение данного свойства равным Y

Установка заголовка документа

Как это выглядит Заголовок документа выводится в верхней части браузера и в центральной части страницы документа

Рис 25 Вывод заголовка документа в верхней части браузера

Рис 26 Вывод заголовка в содержательной части документа

Как это работает Изменение заголовка документа может быть выполнено при редактировании документа

встроенным визуальным HTML-редактором в режиме Редактировать как HTML (кнопка административной панели) Заголовок документа задается в поле laquoЗаголовок страницыraquo

Заголовок страницы также может быть изменен в режиме редактирования документа как laquoТекстraquo или при непосредственном редактировании HTML-кода документа

Заголовок выводимый в верхней части окна браузера может отличаться от основного заголовка страницы По умолчанию для его задания на странице определено свойство title

Как это реализуется Задание заголовка может выполняться в любом месте страницы Стандартно заголовок страницы вставляется до вызова основного пролога документа следующим образом lt ---Установка статического заголовка $APPLICATION-gt SetTitle(О компании) ---Установка динамического заголовка В качестве заголовка страницы ---используется имя информационного блока для заданного

18


$ID $arIBlock = GetIBlock($ID news) $APPLICATION-gtSetTitle($arIBlock[NAME]) hellip gt

Заголовок выводимый в верхней строке браузера может быть установлен с использованием различных механизмов По умолчанию заголовок устанавливается в отдельно заведенном свойстве страницы title Если указанное свойство не заполнено то заголовок окна браузера будет установлен равным текущему заголовку страницы

Вывод заголовка производится заданием следующего кода в шаблоне дизайна

lt$APPLICATION-gtShowTitle()gt

Приведенный код размещается в области ltheadgt основного пролога ltheadgtlttitlegtlt$APPLICATION-gtShowTitle()gtlttitlegtltheadgt и в области ltbodygt на месте вывода заголовка документа lt$APPLICATION-gtShowTitle(false)gt Параметр false в последнем случае указывает что для установки заголовка не нужно проверять значение свойства title те используется стандартный заголовок установленный с использованием функции SetTitle()

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

Как это выглядит После авторизации на сайте для администратора становится доступна панель инструментов в верхней части страницы С ее помощью можно управлять параметрами текущего раздела перейти к редактированию текущей страницы и дополнительных редактируемых областей добавить и изменить меню текущего раздела а также быстро перейти в административный раздел сайта или завершить сеанс работы с сайтом

Рис 27 Административная панель

Как это работает Панель инструментов разделена на три закладки

Публичный раздел Просмотр публичного раздела сайта

Редактировать сайт С помощью этой закладки возможен переход к режиму отображения компонентов включаемых областей С помощью иконок расположенных в верхнем левом углу включаемой области можно перейти к управлению выбранным элементом непосредственно из публичного раздела

Панель управления С помощью этой закладки осуществляется переход в административный раздел

С каждой кнопкой панели инструментов связан определенный раздел административной части системы

19


Вот неполный перечень функций доступных из административной панели (дополнительно доступны кнопки для перехода к редактированию документов через модуль laquoДокументооборотаraquo и для управления содержимым информационных блоков)

Создание новой папки Открывает диалог для создания новой директории в структуре сайта Задается как имя папки так и название раздела которое будет использоваться при построении навигационной цепочки Предлагает возможность автоматически создать индексную страницу раздела по заданному шаблону и сразу же перейти к ее редактированию

Свойства текущей папки Переводит в диалог для управления свойствами папки текущего раздела сайта Можно задатьизменить заголовок раздела используемый для построения навигационной цепочки

Создание нового документа Переводит в режим создания нового документа (страницы сайта) в текущем разделе сайта

Редактирование текущей страницы Позволяет модифицировать текущую страницу сайта с помощью визуального HTML редактора

Завершение сеанса

Как это реализуется Код для включения административной панели в верхней части сайта задается сразу после тега ltbodygt перед началом первой таблицы lt $APPLICATION-gtShowPanel() gt Отдельные модули могут добавлять в панель свои кнопки (например модуль laquoДокументооборотаraquo и модуль laquoИнформационных блоковraquo)

Также пользователь может самостоятельно добавить кнопки в панель

Добавление может быть выполнено несколькими способами

sect изменением файла bitrixphp_interfaceincludeadd_top_panelphp Функция $APPLICATION-gtShowPanel() производит проверку наличия указанного файла и выводит в панель описанные в нем кнопки

sect использованием в скрипте показа функции CIblockShowPanel() в случае вывода дополнительных кнопок для модуля laquoИнформационных блоковraquo Количество кнопок может варьироваться например в зависимости от того выполняется ли вывод списка элементов информационного блока или детальный показ информации по одному элементу Компоненты информационных блоков имеют специальную опцию определяющую добавлять или нет кнопки в административную панель

Размещение рекламных областей

Как это выглядит На сайте может быть представлено несколько различных типов рекламы и выделено несколько рекламных областей Это может быть как стандартная баннерная реклама так и текстовые рекламные области Реклама может быть постоянной или показываться с определенной вероятностью задаваемой администратором Показ рекламы может быть регламентирован по определенным разделам сайта и тд Более подробная информация о рекламе представлена в соответствующем разделе laquoПомощиraquo по продукту

20


Рис 28 Пример рекламной области

Как это работает Заведение типов рекламы и добавление конкретных рекламных элементов производится через административный интерфейс в разделе Сервисы ndash Реклама Название типа рекламного блока задается администратором произвольно и будет использоваться для выбора конкретной рекламы Например для верхней рекламы может быть установлен тип TOP TOP1 и тп

Рис 29 Управление типами рекламы на сайте

Быстрый доступ к управлению соответствующим рекламным баннером (или списком баннеров

выбранной рекламной области) можно выполнить по нажатию на иконку laquoРедактировать

данный баннерraquo (или laquoОтфильтрованный список баннеровraquo) отображаемую непосредственно рядом с баннером в режиме показа редактируемых областей

21


Рис210 Форма добавления рекламы определенного типа

Как это реализуется Размещение рекламных областей осуществляется двумя способами

С помощью компонента Баннер (bitrixadvertisingbanner) В его настройках определяется тип баннера

Обратите внимание Данный компонент не учитывает таргетинг по ключевым словам Если необходимо то используйте функцию $APPLICATION-gtShowBanner() lt ---Пример размещения рекламной области с использованием функции $APPLICATION-gtShowBanner() ---Производится выбор любого типа ---TOP BOTTOM COUNTERhellip (первый параметр функции) ---Могут быть использованы как предустановленные так и задаваемые пользователем типы ---В качестве двух дополнительных параметров может указываться HTML-код обрамляющий рекламную область сверху и снизу $APPLICATION-gtShowBanner(LEFT ltdiv align=centergt ltbrgtltdivgtltbrgt) gt

Показ рекламы на странице осуществляется в зависимости от набора ключевых слов баннера и страницы сайта если вывод рекламы осуществлен с помощью функции $APPLICATION-gtShowBanner()

Ключевые слова баннера могут быть заданы как для отдельного баннера так и для рекламного контракта в целом

Ключевые слова страницы сайта разделяются на обязательные (required) и желательные (desired) Более подробная информация представлена в руководстве laquoУправление рекламой с помощью ключевых словraquo и документации продукта

Обратите внимание что по умолчанию если в коде страницы не установлено каких-либо ключевых слов для рекламы считается что функция CAdvBannerSetDesiredKeywords использует в качестве параметра значение свойства страницы adv_desired_target_keywords Если значение данного свойства не задано то в качестве параметра функции используется значение свойства keywords

Функция CAdvBannerSetDesiredKeywords вызывается автоматически в момент сборки страницы с указанными выше параметрами ее не нужно дополнительно вызывать в файле headerphp если нет необходимости переопределить ключевые слова для показа рекламы

22


Настройка меню

Как это выглядит Любое меню на сайте строится на основе двух составляющих

sect массива данных редактируемых в административном разделе (в поставку входят демонстрационные меню)

sect шаблона внешнего представления меню

Массив данных определяет состав меню задает названия и ссылки для всех пунктов меню Массив данных меню храниться в файле ltтип менюgtmenuphp в папке соответствующего раздела сайта При отображении в Менеджере файлов данному файлу автоматически присваивается имя Меню типа laquoltтип_менюgtraquo

При использовании компонентов 20 - шаблон меню ndash это шаблон компонента меню определяющий внешний вид меню

Для настройки шаблона в HTML-коде необходимо выделить повторяющиеся части меню (рис 211) Например для горизонтального меню ndash это ячейки таблицы а для вертикального ndash строки

Рис 211 Выделение меню

Задача формирования меню включает

sect выделение HTML элементов для построения меню

sect создание шаблонов меню

sect включение (вызов) функции показа меню в общем шаблоне (прологе и эпилоге)

sect заполнение меню в соответствии со структурой сайта

При выделении области верхнего меню нужно обратить внимание на повторяющиеся элементы пункты меню и разделители В примере приведенном на рисунке 211 повторяющимися элементами являются ячейки таблицы (2) При выделении области левого меню повторяющимися элементами будут строки таблицы

При создании шаблона меню потребуется также создать дополнительные стили в таблице стилей Например для текстового меню цвет пункта меню и цвет текущего (активного) пункта меню Отдельного представления в шаблоне могут потребовать заголовки разделов Например возможно использование графических и текстовых обозначений того что данный пункт связан не с конечным документом а ведет в новый раздел (директорию) и тп

23


Рис212 Элементы меню

Как это работает Управление меню каждого раздела производится через административный интерфейс Для редактирования меню раздела можно найти соответствующий файл в Менеджере файлов либо использовать кнопку Редактировать пункты меню ( ) расположенную рядом с соответствующим меню в режиме показа включаемых областей

Одному разделу сайта могут соответствовать несколько меню различных типов верхнее левое нижнее и тп В самом общем случае на сайте существует одно верхнее меню которое соответствует самому верхнему уровню и подключается во всех разделах Также в системе обычно используется ndash левое (или правое) меню второго уровня которое определяет пункты для документов и подразделов данного раздела (директории)

Типы меню задаются из административного раздела в секции Настройки ndash Настройки модулей ndash Управление структурой Для каждого сайта в системе может быть задан свой набор типов меню Например в поставке продукта для обоих сайтов в системе заданы два типа меню

sect Левое меню ndash тип left

sect Верхнее меню ndash тип top

Рис 213 Задание типов меню

Тип заданный в настройках будет использован как префикс файла шаблона меню Указанный префикс используется также для идентификации файлов с пунктами меню для конкретного раздела

Для хранения данных для каждого типа меню создается отдельный файл Например для хранения данных левого меню текущего раздела - leftmenuphp а topmenuphp для верхнего меню

Существует два режима редактирования меню упрощенный и расширенный В упрощенном режиме задаются только название пункта меню ссылка для перехода и значение сортировки

24


Рис 214 Упрощенный режим редактирования меню

В расширенном режиме для управления доступны следующие данные

sect название пункта меню sect ссылка для перехода sect набор дополнительных ссылок которые соответствуют этому же пункту меню В данном поле задается набор ссылок на страницы при переходе на которые будет также подсвечиваться данный пункт меню Например для того чтобы при просмотре любой страницы раздела laquoНовости компанииraquo подсвечивался пункт меню Новости компании в данном поле нужно указать ссылку на папку содержащую все страницы раздела (или перечислить необходимые страницы) aboutnews

sect сортировка - определяет положение пункта меню в общем списке чем меньше значение тем выше будет показан элемент

sect условия показа Например позволяет внести ограничения на показ данного пункта меню пользователям с определенными правами доступа

sect дополнительные параметры ndash набор произвольных параметров которые могут быть обработаны в шаблоне показа меню и представлены соответствующим образом Например если пункт меню является заголовком секции это может быть указано в параметрах пункта так название параметра - SEPARATOR значение - ldquoYrdquo При разработке шаблона можно проверять значение этого параметра и при показе выделять данный пункт меню разделителем

Рис 215 Расширенный режим редактирования меню

Все данные которые заносятся через административный интерфейс будут сохранены в папке соответствующего раздела сайта в файле leftmenuphp для левого меню и topmenuphp для верхнего меню соответственно Файл содержит массив значений для всех элементов меню

25


Файлы размещаются в тех разделах (директориях) где требуется их показ Если для данного раздела не задан соответствующий файл меню система производит поиск файла на уровень выше

Построение меню для показа происходит следующим образом В общем шаблоне показа меню содержится вызов функции вывода меню на экран При загрузке страницы данная функция проверяет наличие в текущем разделе файла содержащего массив значений для меню вызывает шаблон построения для данного типа меню и выводит HTML меню на экран

Есть возможность выводить в меню различные разделы не физического а логического уровня Например в поставку продукта включен системный компонент выводящий разделы инфоблоков в левое меню (Пункты меню bitrixmenusections) и приведен пример реализации на сайте


Для размещения меню на сайте используется компонент Меню (bitrixmenu) В его настройках указывается шаблон тип меню уровень вложенности и тд

Как и для любого компонента версии 20 для меню можно создать неограниченное количество шаблонов Создание шаблонов меню начинается с выделения соответствующих HTML областей в шаблоне сайта После этого выделяются неизменные верхняя и нижняя часть шаблона а также повторяющиеся элементы

Все системные шаблоны меню хранятся в папке

bitrixcomponentsbitrixmenutemplates Для того чтобы приступить к редактированию шаблона меню необходимо его скопировать в определенный шаблон сайта средствами системы (используя кнопку панели компонента в режиме редактирования сайта) После копирования шаблона появятся следующие кнопки

- для быстрого перехода к редактированию шаблона компонента

- для перехода к редактированию css-файла компонента

Начиная с версии 60 продукта шаблон меню представляет собой цикл строящий последовательно пункты меню учитывая параметры компонента

Вызов меню из основного шаблона производится размещением компонента Меню (menu) который подключается в виде кода следующим образом Подключение верхнего многоуровневого меню lt$APPLICATION-gtIncludeComponent( bitrixmenu horizontal_multilevel Array( ROOT_MENU_TYPE =gt top MAX_LEVEL =gt 3 CHILD_MENU_TYPE =gt left USE_EXT =gt Y ) )gt

26


Добавление разделов инфоблоков в меню

Как это выглядит В продукте есть возможность строить меню на основе логических разделов например разделов инфоблоков В поставке продукта приведен пример объединения в левом меню пунктов ссылающихся на разделы сайта на физическом уровне и на разделы инфоблока

Рис 216 Левое меню

Как это работает При переходе к редактированию данного меню средствами системы можно изменить только первые два пункта (Авторы и Рецензии) созданные обычным способом Пункты разделов инфоблока будут меняться автоматически при изменении структуры инфоблока


Для реализации упомянутого механизма необходимо в настройках компонента меню Меню (bitrixmenu) проверить наличие установленной опции Подключать файлы с именами вида тип_менюmenu_extphp (USE_EXT) Если данная опции отмечена то при каждом построении меню система проверяет наличие файла тип_менюmenu_extphp в текущей директории Если такой файл найден то он будет выполнен и построение меню совершится с его участием Рассмотрим реализацию описанного механизма на примере Пункты меню Авторы и Рецензии создадим обычным способом через режим редактирования сайта Далее используем компонент Пункты меню (bitrixmenusections) в файле leftmenu_extphp lt if(defined(B_PROLOG_INCLUDED) || B_PROLOG_INCLUDED==true)die() global $APPLICATION $aMenuLinksExt = $APPLICATION-gtIncludeComponent( bitrixmenusections Array( ID =gt $_REQUEST[ELEMENT_ID] IBLOCK_TYPE =gt books IBLOCK_ID =gt 30 SECTION_URL =gt e-storebooksindexphpSECTION_ID=ID CACHE_TIME =gt 3600 ) ) $aMenuLinks = array_merge($aMenuLinks $aMenuLinksExt) gt

27


В данном примере строится массив разделов инфоблоков $aMenuLinksExt с помощью компонента Пункты меню Далее происходит объединение двух массивов $aMenuLinks (массив возвращающий пункты стандартного левого меню) и $aMenuLinksExt в один И потом при построении меню с помощью компонента Меню (bitrixmenu) строится левое меню с использованием файла leftmenu_extphp

Настройка дополнительных редактируемых областей

Как это выглядит Шаблоны документов и шаблоны включаемых областей являются обыкновенными HTML-документами которые содержат предопределенные элементы форматирования таблицы картинки стили и тп Созданные шаблоны копируются в папки page_templates либо для всех шаблонов (bitrixtemplatesdefaultpage_templates) либо для каждого шаблона в отдельности (bitrixtemplatesltидентификатор шаблонаgtpage_templates)

В системе существует возможность создания различных типов включаемых областей например

sect включаемая область для конкретного файла ndash будет выводиться только при просмотре текущего документа

sect включаемая область для конкретной секции ndash будет выводиться для всех документов в данном разделе (секции)

sect другие типы включаемых областей

Рис 217 Пример включаемой области

Как это работает Включаемые области сохраняются в отдельных файлах с некоторым суффиксом например _inc Для конкретного файла этот суффикс добавляется к имени файла В поставляемом дистрибутиве продукта включаемый файл для раздела (секции) сайта сохраняется с именем sect_incphp Количество редактируемых областей для каждого файла или раздела может быть расширено При этом потребуется некоторая модификация шаблона

Создание и редактирование включаемых областей для текущего документа может быть выполнено непосредственно из публичного раздела сайта в режиме показа включаемых областей В тех местах где предполагается вывод дополнительных редактируемых областей будут показаны иконки для быстрого перехода к созданию или редактированию этих областей

При создании включаемых областей можно использовать настроенные шаблоны показа для этих областей Список шаблонов заполняется в файле contentphp

28


Перечисленные в файле шаблоны будут доступны при создании новой страницы в виде выпадающего списка

Следует обратить внимание что имя шаблона может быть передано параметром при подключении редактируемой области в шаблоне сайта (см выделение синим цветом в примере ниже)

Как это реализуется Для выделения места в шаблоне дизайна сайта для включаемой области можно использовать специальный компонент Вставка включаемой области (bitrixmaininclude) Компонент имеет следующие особенности

sect Если в настройках компонента выбрано выводить включ область laquoдля страницыraquo то созданная в дальнейшем файл для включаемой области будет показан только на текущей странице Если laquoдля разделаraquo то файл будет показан для всего раздела Формат имени файла включаемой области также определяется настройками данного компонента

sect В поле laquoсуффикс имени файла включаемой области (по умолчанию inc)raquo указывается суффикс который будет добавляться ко всем создаваемым в дальнейшем включаемым областям и страницы с таким суффиксом будут восприниматься как включаемые области

sect В поле laquoРежим редактирования по умолчаниюraquo выбирается один из трех стандартных режимов редактирования (HTML PHP как текст) Режим редактирования выбранный в данном поле будет использоваться при переходе к редактированию включаемой области страницыраздела из публичной части

sect Если установлен вариант показывать включаемую область для раздела то доступна опция laquoРекурсивное подключение включаемых областейraquo При установленной опции включаемые области разделов будут подключаться рекурсивно те если в папке более низкого уровня есть своя включаемая область то она будет показана Если же текущий раздел не имеет своей включаемой области то рекурсивно до корня сайта будут проверяться все разделы до самого верхнего и будет выведена первая встретившаяся включаемая область

sect Также в настройках компонента устанавливается шаблон страницы по умолчанию

Для подключения произвольных файлов в шаблоне дизайна сайта с последующей возможностью их редактировать средствами системы используется функция IncludeFile() Например код подключения файла с авторскими правами имеет следующий вид ltdiv id=footergtlt$APPLICATION-gtIncludeFile( $APPLICATION-gtGetTemplatePath(include_areascopyrightphp) Array() Array(MODE=gthtml) )gt ltdivgt

29


Работа с компонентами Часто используемые области на сайте могут быть оформлены как программные компоненты Практически любой программный скрипт может быть представлен компонентом

Начиная с версии 60 продукта выпускаются компоненты новой версии Отличие компонентов версии 20 от первой версии состоит в том что в них разделены логика и представление Для одной логики может быть создано несколько представлений в том числе зависящих от шаблона текущего сайта Представление (шаблон вывода) может быть написано на любом шаблонном языке который можно подключить из PHP Например шаблоны могут быть на PHP Smarty XSLT и тд Нет необходимости изменять логику компонента для изменения особенностей его показа Поэтому управлять внешним видом информации выводимой компонентом стало значительно проще тк для этого разбираться в логике компонента совсем не обязательно

Компоненты централизованно хранятся в одной папке (bitrixcomponents) Это обеспечивает большую целостность и понятность структуры сайта Папка доступна для обращений а значит компонент и его шаблоны могут легко подключать свои дополнительные ресурсы Компоненты определяются пространством имен Так системные компоненты поставляемые с продуктом и обновляемые системой обновлений относятся к пространству имен bitrix и располагаются в каталоге bitrixcomponentsbitrix

Обратите внимание Изменять содержимое папки bitrixcomponentsbitrix не рекомендуется

Пользовательские компоненты рекомендуется размещать в своей папке например bitrixcomponentsmy_folder либо в разделе bitrixcomponents

Компоненты версии 20 делятся на простые (одностраничные) и комплексные (многостраничные) Простые компоненты создают какую-либо область на одной странице (например лента новостей фотография детально таблица курсов валют и тд) Комплексные компоненты создают разделы сайта Например компонент каталога создает на сайте весь раздел каталога и список каталогов и список групп и страницы товаров То есть комплексный компонент состоит из набора страниц при визуальном просмотре сайта но из одной страницы на физическом уровне

Имена компонентов имеют вид laquoидентификатор1идентификатор2raquo Например laquocatalograquo laquocatalogelementraquo laquocatalogsectionlistraquo и тп Рекомендуется строить имена иерархически начиная с общего понятия и заканчивая конкретным назначением компонента Например компонент показывающий список товаров данной группы может называться laquocatalogsectionraquo

Структура компонентов версии 20 значительно отличается от предыдущей версии Папка компонента содержит следующие подпапки и файлы

sect подпапку templates в которой расположены шаблоны вывода (отображения) компонента Подпапка templates может отсутствовать если у компонента нет шаблонов вывода

sect файл componentphp который содержит логику (код) компонента Этот файл должен всегда присутствовать в папке компонента

sect файл parametersphp который содержит описание входных параметров компонента для редактора Если у компонента есть входные параметры то этот файл должен присутствовать в папке компонента

sect другие подпапки и файлы

o help с файлами помощи по компоненту

o lang с языковыми файлами

sect папку images

sect файл descriptionphp с названием описанием компонента и его положением в дереве компонентов в редакторе и тд

30


Для размещения компонентов на странице разработан специальный интерфейс на базе визуального редактора При редактировании страницы можно выбрать компонент из списка и переместить его в рабочую область страницы Для этого достаточно просто перетащить на страницу иконку компонента

После помещения на страницу компонента его параметры могут быть настроены в панели Свойства При установке курсора на значок компонента в рабочей области в нижней части экрана будет выведен список параметров доступных для данного компонента

Рис 218 Визуальный редактор

Настройки визуального редактора доступные по кнопке позволяют выбрать версию компонентов для работы Компоненты версии 10 также могут использоваться

Система позволяет управлять параметрами компонента из публичной части в режиме редактирования сайта Для компонентов отображаются панели с различным набором кнопок Например компонент Список новостей (bitrixnewslist) в режиме редактирования сайта может иметь такую панель

Рис 219 Кнопки управления параметрами компонента

- редактирование параметров данного компонента Кнопка отображается всегда для любого компонента за исключением подкомпонентов в составе комплексного По нажатии отображается форма настройки параметров где можно изменить настройки компонента без перехода к режиму редактирования страницы

31


Рис 220 Форма редактирования параметров компонента

- копирование шаблона компонента Кнопка отображается всегда По нажатии появляется диалоговое окно где указывается имя шаблона компонента и в какой шаблон сайта осуществить копирование

Рис 221 Форма копирования шаблона компонента

Шаблон компонента скопированный в один из шаблонов сайта называется пользовательским Его можно изменять под конкретные требования

- редактирование текущей страницы шаблона Кнопка отображается если применен пользовательский шаблон По нажатии происходит переход к редактированию страницы шаблона

ndash редактирование CSS-файла шаблона Кнопка отображается если применен пользовательский шаблон

ndash очистка кеша компонента

Непосредственно в коде страницы подключение компонентов производится с использованием функции IncludeComponent() В качестве параметров функции указываются название компонента название шаблона а также параметры компонента заданные при его добавлении на страницу

32


Например вызов компонента Список новостей (bitrixnewslist) в виде кода имеет следующий вид sect lt$APPLICATION-gtIncludeComponent( sect bitrixnewslist sect template_my sect Array( sect DISPLAY_DATE =gt Y sect DISPLAY_NAME =gt Y sect DISPLAY_PICTURE =gt Y sect DISPLAY_PREVIEW_TEXT =gt Y sect IBLOCK_TYPE =gt news sect IBLOCK_ID =gt 33 sect NEWS_COUNT =gt 4 sect SORT_BY1 =gt ACTIVE_FROM sect SORT_ORDER1 =gt DESC sect SORT_BY2 =gt SORT sect SORT_ORDER2 =gt ASC sect FILTER_NAME =gt sect FIELD_CODE =gt array(0=gt1=gt) sect PROPERTY_CODE =gt array(0=gt1=gt) sect DETAIL_URL =gt

contentnewsindexphpnews=ELEMENT_ID sect PREVIEW_TRUNCATE_LEN =gt 0 sect ACTIVE_DATE_FORMAT =gt dmY sect DISPLAY_PANEL =gt N sect SET_TITLE =gt N sect INCLUDE_IBLOCK_INTO_CHAIN =gt Y sect ADD_SECTIONS_CHAIN =gt Y sect HIDE_LINK_WHEN_NO_DETAIL =gt N sect PARENT_SECTION =gt sect CACHE_TYPE =gt A sect CACHE_TIME =gt 3600 sect CACHE_FILTER =gt N sect DISPLAY_TOP_PAGER =gt N sect DISPLAY_BOTTOM_PAGER =gt N sect PAGER_TITLE =gt Новости sect PAGER_SHOW_ALWAYS =gt N sect PAGER_TEMPLATE =gt sect PAGER_DESC_NUMBERING =gt N sect PAGER_DESC_NUMBERING_CACHE_TIME =gt 36000 sect ) sect )gt Ниже описаны некоторые особенности работы с основными компонентами поставляемыми в составе дистрибутивного комплекта

Модуль подписки

Компонент laquoФорма подпискиraquo

Как это выглядит Стандартная форма подписки включает динамически формируемый список рубрик подписки поле для ввода электронного адреса подписчика кнопку для подтверждения действия и ссылку для перехода на страницу управления подпиской После заполнения формы посетитель сайта будет переведен на форму упрощенной регистрации и затем будет добавлен в список подписчиков Впоследствии он сможет изменить параметры подписки или отказаться от рассылки сайта Страница упрощенной регистрации будет доступна в том случае если в настройках главного модуля установлен флаг Позволять ли пользователям регистрироваться самостоятельно

33


Рис222 Форма подписки

Как это работает Управление рубриками подписки списком подписчиков и рассылкой сообщений осуществляется из административного раздела Сервисы ndash Рассылки

Администратор сайта заводит различные рубрики подписки Посетители сайта подписываются на них Затем администратор сайта создает рассылки которые отправляются по списку подписчиков


Форма подписки реализуется компонентом Форма подписки (bitrixnewslist) расположенным в разделе Сервисы ndash Рассылки в дереве компонентов в редакторе

Системный шаблон этого компонента находится в файле

bitrixcomponentsbitrixsubscribeformtemplatesdefaulttemplatephp

По умолчанию компонентом используется системный шаблон default

Включение формы подписки выполняется следующим образом lt$APPLICATION-gtIncludeComponent( bitrixsubscribeform Array( USE_PERSONALIZATION =gt Y PAGE =gt SITE_DIRpersonalsubscribesubscr_editphp SHOW_HIDDEN =gt N CACHE_TYPE =gt A CACHE_TIME =gt 3600 ) )gt

Компонент laquoСтраница рассылокraquo Компонент позволяет создать стандартную страницу со списком рассылок и формами управления подпиской

В параметрах можно задать путь к странице редактирования подписки указать нужно ли выводить количество подписчиков для рубрик подписки и другие параметры

Компонент laquoСтраница редактирования подпискиraquo Компонент позволяет создать страницу управления параметрами подписки (добавление редактирование адреса подписки) В параметрах компонента можно указать разрешать ли анонимную подписку показывать ли ссылку на авторизацию при анонимной подписке и другие параметры

34


Модуль поиска

Компонент laquoФорма поискаraquo

Как это выглядит Посетителям сайта доступна стандартная форма поиска

Рис 223 Стандартная форма поиска

После выполнения запроса на поиск посетитель сайта будет перенаправлен на страницу с результатами поиска

Как это работает Поиск производится по статическим материалам информационным блокам (новостям каталогу вакансиям и тп) форуму и блогам


Включение формы в основной шаблон показа выполняется включением компонента Форма поиска (bitrixsearchform) В виде кода подключение этого компонента имеет вид lt$APPLICATION-gtIncludeComponent( bitrixsearchform Array( PAGE =gt SITE_DIRsearchindexphp ) )gt

В параметрах компонента можно указать путь к странице результатов поиска и установить пользовательский шаблон если он создан

Компонент laquoСтраница поискаraquo В параметрах компонента можно определить искать ли только в активных по дате документах указать значения для выпадающего списка laquoГде искатьraquo ограничить область поиска определить количество результатов на странице указать тип и время кеширования

Компонент laquoОблако теговraquo С помощью данного компонента осуществляется вывод ключевых слов (облака тегов)

Компонент laquoФорма ввода теговraquo Данный компонент служит для создания формы ввода тегов

35


Главный модуль

Компонент laquoФорма авторизацииraquo

Как это выглядит Стандартная форма авторизации позволяет посетителям сайта быстро ввести свои параметры входа и перейти в закрытые разделы при наличии соответствующих прав

Как это работает Форма авторизации позволяет проверить права пользователя для доступа к определенным разделам и страницам сайта Права доступа могут быть заданы для страниц сайта разделов сайта и информационных блоков


Включение формы в основной шаблон показа производится с помощью компонента Форма авторизации (bitrixsystemauthform) В параметрах компонента определяется путь к странице регистрации путь к странице профиля пользователя и шаблон компонента Подключение данного компонента в виде кода имеет вид lt$APPLICATION-gtIncludeComponent( bitrixsystemauthform default Array( REGISTER_URL =gt auth PROFILE_URL =gt personalprofile ) )gt

Компонент laquoПанель переключения сайтовraquo Выводится панель переключения сайтов Включение панели в основной шаблон выполняется с помощью компонента Выбор сайта (bitrixmainsiteselector) в настройках которого определяется шаблон компонента список сайтов тип и время кеширования Подключение данного компонента в виде кода имеет вид lt$APPLICATION-gtIncludeComponent( bitrixmainsiteselector default Array( SITE_LIST =gt array(0=gtall) CACHE_TYPE =gt A CACHE_TIME =gt 3600 ) )gt

Компонент laquoКарта сайтаraquo

Компонент Карта сайта (bitrixmainmap) предназначен для вывода карты сайта в публичной части Настройки данного компонента позволяют установить шаблон компонента тип и время кеширования определить настройки внешнего вида карты сайта ограничить уровень вложенности указать количество колонок при выводе карты сайта

Компонент laquoПараметры пользователяraquo

Компонент Параметры пользователя (bitrixmainprofile) предназначен для показа и редактирования информации профайла текущего пользователя

36


Модуль статистики

Компонент laquoТаблица статистикиraquo

Как это выглядит Посетителям сайта может быть показана таблица со статистическими данными по посещаемости сайта В таблице представлена статистика по общему количеству посетителей сайта и по количеству посетителей за текущую дату Для администратора сайта подписи представлены ссылками по которым он может перейти из данной таблицы непосредственно в раздел просмотра детализированной статистики

Как это работает Система сбора статистики позволяет собрать и обработать данные по посетителям сайта рекламным кампаниям хитам поисковиков ссылающимся сайтам сессиям и тп


Включение таблицы статистики в основной шаблон показа выполняется следующим образом lt$APPLICATION-gtIncludeComponent( bitrixstatistictable Array( CACHE_TYPE =gt A CACHE_TIME =gt 20 CACHE_FOR_ADMIN =gt N ) )gt

Модуль информационных блоков

Как это выглядит Система 1С-Битрикс Управление сайтом позволяет управлять как статической так и динамической информацией К динамической информации на сайте могут быть отнесены регулярно обновляющиеся материалы новости пресс-релизы фотогалерея вакансии каталог товаров

Управление динамической информацией в системе осуществляется на базе так называемых информационных блоков или информационных разделов которые состоят из определенного количества элементов Например раздел новостей Новости компании является информационным блоком а каждая новость является элементом информационного блока

Как это работает Управление информационными блоками осуществляется из административного раздела в секции Контент ndash Информационные блоки

В системе могут быть представлены различные типы информационных блоков новости фотогалерея вакансии каталог Для каждого информационного блока могут быть заданы свойства которые затем будут унаследованы всеми элементами внутри данного информационного блока Так например могут быть заданы специфичные свойства товаров в каталоге масса габариты цвет и тп

Свойства могут иметь предустановленное значение для всех элементов внутри информационного блока Важными настройками для информационных блоков являются настройки пути к странице со списком элементов данного информационного блока пути к

37


странице со списком элементов раздела информационного блока и пути к странице детального просмотра элементов блока

При выборке элементов блока важным параметром является не только ID блока но также и мнемоническое имя блока задаваемое символами латинского алфавита

Для различных типов информационных блоков уровень вложенности элементов может определяться двумя уровнями информационный блок ndash группы ndash элементы

Как это реализуется В новой версии продукта информация из информационных блоков может быть выведена с помощью простых или комплексных компонентов Комплексные компоненты целесообразно использовать если требуется создать полный раздел на сайте (например полный каталог новостной раздел раздел фотогалереи и тд)

Все компоненты работающие с модулем информационных блоков выведены в разделе Контент дерева компонентов в редакторе Далее в подразделах сгруппированы компоненты по своей функциональной направленности Новости Фотогалерея Каталог RSS Валюты и тд

Пример организации показа новостей на сайте с помощью одностраничных компонентов Создание страниц для показа новостей начинается с заведения соответствующего информационного блока в административном интерфейсе и заполнения его элементов ndash новостей

При создании нового информационного блока необходимо указать путь к странице показа списка элементов информационного блока (новостей) путь к странице со списком элементов раздела (если информационный блок содержит разделы) и путь к странице детального просмотра элемента (новости)

Указанные выше страницы должны быть созданы в структуре сайта Например для показа списка новостей aboutnewsindexphp а для детального показа новости aboutnewsdetailphp

Далее на вновь созданной странице следует разместить соответствующие компоненты Для страницы показа списка новостей в визуальном редакторе нужно перетащить на страницу иконку компонента laquoСписок новостей (bitrixnewslist)raquo из раздела Контент - Новости а для страниц детального просмотра новости ndash иконку компонента laquoНовость детально (bitrixnewsdetail)raquo

Для того чтобы организовать экспорт новостей с этой страницы в RSS в данном случае нужно вставить на страницу картинку RSS 20 и поставить на ней ссылку на некоторую страницу например aboutnewsrssphp Указанную страницу следует также создать средствами продукта в визуальном редакторе разместить на ней компонент экспорта в RSS формате RSS новости (экспорт)

Предварительно нужно убедиться что в настройках соответствующего информационного блока разрешен экспорт данных в формате RSS

38


Рис 224 Показ новостей со ссылкой на страницу экспорта новостей в формате RSS

Пример организации показа новостей на сайте с помощью комплексных компонентов Для организации новостного раздела с помощью комплексных компонентов требуется создать только одну страницу и разместить на ней компонент Новости (bitrixnews) После настройки его параметров и сохранении страницы новостной раздел в публичном разделе будет создан

Модуль веб-форм Показ веб-формы в публичной части сайта осуществляется следующим образом

sect создается веб-форма в административном разделе сайта Сервисы - Веб-формы - Настройка форм

sect в публичной части сайта на некоторой странице в визуальном редакторе добавляется компонент laquoЗаполнение веб-формы (bitrixformresultnew)raquo

sect в настройках компонента выбираются название формы а также названия страниц для показа списка результатов и редактирования результата веб-формы

sect последовательно средствами продукта добавляются указанные страницы и на них помещаются соответствующие компоненты и для всех компонентов выполняются соответствующие настройки

Также можно воспользоваться одним комплексным компонентом Веб-форма (bitrixform) для создания страниц заполнения формы страницы со списком результатов и страницы редактирования результатов

Модуль опросов Размещение опросов производится аналогичным образом В настройках компонентов дополнительно указываются названия страниц с отображением результатов опросов

В системе представлен компонент для вывода опросов например на главную страницу сайта с последующим отображением результатов Для не голосовавших посетителей ndash показываются опросы сразу после голосования ndash показываются результаты опросов для уже проголосовавших ранее посетителей ndash показываются результаты опросов

В настоящий момент компоненты разработаны для всех основных модулей системы и список их будет пополняться как со стороны нашей компании так и со стороны партнеров компании laquo1С-Битриксraquo

39


Использование файлов языковых сообщений При выделении общего шаблона для нескольких языков следует обратить внимание на текстовые элементы дизайна заголовки альт-текст к рисункам подписи на кнопках и тп

Шаблон показа настраивается таким образом что HTML-код является общим для всех языков а все текстовые элементы в нем заменены на текстовые сообщения Языковые сообщения хранятся отдельно в папке bitrixtemplatesltидентификатор_шаблонаgtlangru для русского языка и соответственно в папке helliplangen для английского языка (хранение языковых сообщений для других языков выполняется аналогично)

Например языковые сообщения для редактируемой области с копирайтами (файл bitrixtemplatesltидентификатор шаблонаgtinclude_areascopyrightphp) могут храниться соответственно в файлах

bitrixtemplatesltидентификатор_шаблонаgtlangrucopyrightphp

для русского интерфейса и в файле

bitrixtemplatesltидентификатор_шаблонаgtlangencopyrightphp

для английского интерфейса

Файл с языковыми сообщениями для русского языка выглядит следующим образом lt $MESS [SEARCH_TITLE] = Поиск gt

В файле


языковые сообщения подключаются в самом начале lt IncludeTemplateLangFile(__FILE__) gt В самом документе языковое сообщение вызывается следующим кодом (например для кнопки laquoКопироватьraquo) ltfont class=copygtltecho GetMessage(COPY)gtltfontgt

40


Настройка продукта на техподдержку со стороны партнеров Партнеры компании laquo1С-Битриксraquo могут произвести некоторые изменения в административной части продукта

Для того чтобы настроить сайт на техподдержку со стороны партнеров следует произвести следующие действия

Изменение адреса сайта и ссылки на техподдержку в правом нижнем углу экрана административной части

Создать файл bitrixphp_interfacethis_site_supportphp который будет содержать необходимый текст Тогда будет подключаться именно он а не стандартный текст

Пример файла bitrixphp_interfacethis_site_supportphp sect lta href=httpwwwflowerswebinfo sect class=pagebottomtextgtwwwflowerswebinfoltagtampnbspampnbsp sect |ampnbspampnbsplta sect class=pagebottomtext sect href=httpwwwflowerswebinfosupportgtТехподдержкаltagt Встраивание логотипа или текста в левый нижний угол экрана (под меню) административной части

Создать файл bitrixphp_interfacethis_site_logophp который будет содержать необходимый текст

Если этот файл существует то именно его содержимое будет показано

Содержимое файла произвольно

Изменение почтового адреса на который направляются письма в техподдержку со страницы Проверка сайта (bitrixadminsite_checkerphp)

Необходимо определить константы

define(THIS_SITE_SUPPORT_EMAIL E-Mail системы техподдержки)

define(THIS_SITE_SUPPORT_CHARSET Кодировка)

Определять кодировку не обязательно в этом случае она будет устанавливаться автоматически в windows-1251 для русского языка и в iso-8859-1 для остальных

Определить константы можно в файлах

bitrixphp_interfacedbconnphp (подключается в самом начале)

или bitrixphp_interfaceafter_connectphp (подключается после соединения с базой)

или bitrixphp_interfaceltкод_сайтаgtinitphp (подключается после определения сайта для определенного сайта)

41


Приложение 1 Рекомендации по подготовке HTML шаблона Подготовка базового графического дизайна сайта должна проводиться с учетом дополнительных требований которые накладываются использованием продукта 1С-Битрикс Управление сайтом

При подготовке графического дизайна следует заранее разметить линию раздела дизайна на пролог (headerphp) и эпилог (footerphp)

Следует выделить основные элементы дизайна для последующей модификации таблицы стилей шрифты цвета заливки и тп

Разрабатывая дизайн меню различных уровней желательно выделять повторяющиеся элементы - для упрощения создания шаблона меню и дальнейшего управления этими меню

Для облегчения сопровождения различных языковых версий сайта по возможности следует использовать вместо графических элементов текстовые

При нарезке графического дизайна и подготовке HTML шаблона необходимо заранее предусмотреть место расположения основных компонентов системы управления сайтом Выделить области меню рекламные области области размещения дополнительных форм

Рекомендуется производить подготовку шаблона с учетом последующей табличной сборки Одновременно допускается использование слоев

При нарезке графического дизайна выделяются однотонные области При сборке шаблона эти области могут быть представлены ячейками таблиц со сплошной заливкой цвета

42


Приложение 2 Настройка внешнего вида дополнительных элементов Настройка сообщений об ошибках Часто возникает необходимость выполнить настройку сообщений об ошибках чтобы сообщение об ошибке было аккуратно показано в дизайне сайта

Для того чтобы произвести настройку внешнего вида сообщения об ошибке соединения с базой данных следует отредактировать файл

bitrixphp_interfacedbconn_errorphp

Для того чтобы произвести настройку внешнего вида сообщения об ошибке в запросе к базе данных следует отредактировать файл

bitrixphp_interfacedbquery_errorphp

Настройка файла подключаемого при закрытии сайта Для того чтобы произвести настройку внешнего вида файла подключаемого при закрытии публичной части сайта следует скопировать файл

bitrixmodulesmainincludesite_closedphp

и поместите его в bitrixphp_interfaceltязыкgt

или в bitrixphp_interfaceinclude

Настройка внешнего вида навигации постраничного просмотра Постраничный показ информации организуется с использованием PHP функции NavPrint() ndash функции вывода ссылок для постраничной навигации Для управления внешним видом постраничной навигации могут быть использованы следующие параметры

NavPrint($title $show_allways=false $StyleText=text $template_path)

где

$title ndash название выводимых элементов

$show_allways ndash если значение параметра false то функция не будет выводить навигационные ссылки если все записи умещаются на одну страницу Если true то ссылки для постраничной навигации будут выводиться всегда

$StyleText ndash CSS класс шрифта для вывода навигационных ссылок

$template_path ndash путь к шаблону показа навигационных ссылок

Введение

Новая технология интеграции

Шаблоны и сайты

Управление шаблонами Структура шаблона

Включаемые области и компоненты


Структура файлов

Типовая страница

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

Создание шаблона сайта











Работа с компонентами






Модуль веб-форм

Модуль опросов

Использование файлов языковых сообщений

Настройка продукта на техподдержку со стороны партнеров

Приложение 1 Рекомендации по подготовке HTML шаблона

Приложение 2 Настройка внешнего вида дополнительных элементов

2


Введение Данное руководство предназначено для разработчиков веб-сайтов на основе программного продукта laquo1C-Битрикс Управление сайтом 6xraquo В документе подробно рассматривается процедура интеграции продукта в новый или уже существующий сайт

В данном документе подразумевается что разработчик владеет базовыми технологиями для разработки веб-сайта такими как HTML CSS PHP

3










4












5









6







7
















8










9






10


















11















12














13










14












15














16






17














18















19















20








21











22

















23












24










25














26








27













28











29


















30









31










32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































3










4












5









6







7
















8










9






10


















11















12














13










14












15














16






17














18















19















20








21











22

















23












24










25














26








27













28











29


















30









31










32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































4












5









6







7
















8










9






10


















11















12














13










14












15














16






17














18















19















20








21











22

















23












24










25














26








27













28











29


















30









31










32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































5









6







7
















8










9






10


















11















12














13










14












15














16






17














18















19















20








21











22

















23












24










25














26








27













28











29


















30









31










32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































6







7
















8










9






10


















11















12














13










14












15














16






17














18















19















20








21











22

















23












24










25














26








27













28











29


















30









31










32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































7
















8










9






10


















11















12














13










14












15














16






17














18















19















20








21











22

















23












24










25














26








27













28











29


















30









31










32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































8










9






10


















11















12














13










14












15














16






17














18















19















20








21











22

















23












24










25














26








27













28











29


















30









31










32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































9






10


















11















12














13










14












15














16






17














18















19















20








21











22

















23












24










25














26








27













28











29


















30









31










32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































10


















11















12














13










14












15














16






17














18















19















20








21











22

















23












24










25














26








27













28











29


















30









31










32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































11















12














13










14












15














16






17














18















19















20








21











22

















23












24










25














26








27













28











29


















30









31










32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































12














13










14












15














16






17














18















19















20








21











22

















23












24










25














26








27













28











29


















30









31










32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































13










14












15














16






17














18















19















20








21











22

















23












24










25














26








27













28











29


















30









31










32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































14












15














16






17














18















19















20








21











22

















23












24










25














26








27













28











29


















30









31










32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































15














16






17














18















19















20








21











22

















23












24










25














26








27













28











29


















30









31










32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































16






17














18















19















20








21











22

















23












24










25














26








27













28











29


















30









31










32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































17














18















19















20








21











22

















23












24










25














26








27













28











29


















30









31










32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































18















19















20








21











22

















23












24










25














26








27













28











29


















30









31










32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































19















20








21











22

















23












24










25














26








27













28











29


















30









31










32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































20








21











22

















23












24










25














26








27













28











29


















30









31










32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































21











22

















23












24










25














26








27













28











29


















30









31










32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































22

















23












24










25














26








27













28











29


















30









31










32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































23












24










25














26








27













28











29


















30









31










32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































24










25














26








27













28











29


















30









31










32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































25














26








27













28











29


















30









31










32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































26








27













28











29


















30









31










32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































27













28











29


















30









31










32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































28











29


















30









31










32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































29


















30









31










32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































30









31










32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































31










32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































32







33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































33














34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































34














35













36














37













38













39










В файле



40



















41










42













где





Введение
































35













36














37













38













39










В файле



40



















41










42













где





Введение
































36














37













38













39










В файле



40



















41










42













где





Введение
































37













38













39










В файле



40



















41










42













где





Введение
































38













39










В файле



40



















41










42













где





Введение
































39










В файле



40



















41










42













где





Введение
































40



















41










42













где





Введение
































41










42













где





Введение
































42













где





Введение
































integration guide

Documents