it-blog.club
Создаём возможность изменять участки статических страниц в битриксе

Создаём возможность изменять участки статических страниц в битриксе

Включаемые области Битрикс

Например у вас в шапке или подвале сайта имеется номер телефона, ну или какая либо ещё информация и сайте, и клиенту хотелось бы её редактировать не прибегая к программированию. Для этого мы можем воспользоваться особым методом для подключения отдельных файлов. Собственно в этих файлах и будет содержаться то, что выводится на сайте в том участке, где мы вызываем этот метод.

IncludeFile

Пример подключения файла:

 $APPLICATION->IncludeFile('/include/tel.php',array(),array('MODE'=>'html')); 

Вызываем данный метод, там, где у нас должен выводиться номер телефона. Далее, в публичном разделе мы должны перейти в режим редактирования сайта и навести курсор на место вывода телефона. У видите всплывашку, которая предложит вам отредактировать область как HTML. Самое главное, это создать наш файл tel.php по заданному пути.

Данный метод имеет несколько параметров.

Первый это путь до нашего файла. В напутствие сообщу, что подобные файлы лучше размещать в заблаговременно созданной директории include, и даже раскладывать по тематике. Например файла из каталога будут в /include/catalog/, а файлы контактов(адреса, эмейлы, телефоны) /include/contacts/. Не поверите как это облегчит вам жизнь в будущем.

Если ваш сайт имеет несколько шаблонов и подключаемые файлы могут расходиться, то такие файлы лучше располагать в include созданных в папках шаблонах. А общие подключаемые файлы, располагать в include созданной в корне проекта. В таком случаем вызов общего файла будет от корня '/include/file.php'. А тот файлы которые разные в каждом шаблоне вызывать через SITE_TEMPLATE_PATH.'/include/file.php'. Подобная структура поможет вам избежать множество проблем в будущем.

Второй - это массив передаваемых параметров в сам файл. В файле они будут находиться, как обычно, в $arParams

Файл где вызываем метод:

 $APPLICATION->IncludeFile('/include/tel.php',array('COLOR'=>'red'),array('MODE'=>'html')); 

Файл tel.php:

 var_dump($arParams); 

или


<div style="color: <?=$arParams['COLOR']?>;">Этот текст будет красный</div>

В итоге увидим следующее:

includeFile.png

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

Третий - это уже служебные настройки. Здесь я не могу сказать вам ничего другого, что уже имеется в официальной документации.

SHOW_BORDER - показывать ли рамку и иконки для редактирования, допустимы следующие значения:

  • true - показать рамку при нажатии на панели кнопки "Показать включаемые области" (значение по умолчанию)
  • false - не показывать рамки

NAME - текст всплывающей подсказки на иконке редактирования

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

BACK_URL - куда вернуться после редактирования (по умолчанию - текущая публичная страница)

WORKFLOW - участвует ли подключаемый файл в документооборте, возможны следующие значения:

  • true - ссылка ведущая на редактирование будет указывать на страницу модуля документооборота
  • false - ссылка ведущая на редактирование будет указывать на страницу модуля управления статикой (значение по умолчанию)

MODE - режим редактирования, допустимы следующие значения:

  • text - файл будет редактироваться как текст (ссылка на страницу редактирования файла в режиме текста)
  • html - файл будет редактироваться как HTML (ссылка на веб-редактор)(значение по умолчанию)
  • php - файл будет редактироваться как PHP (ссылка на страницу редактирования исходников файла)

TEMPLATE - если в параметре path указан абсолютный путь к несуществующему файлу, то здесь необходимо указать имя файла-шаблона для создания нового файла (по умолчанию - первый шаблон в порядке сортировки задаваемой в файле: /bitrix/templates/ID текущего шаблона сайта/page_templates/.content.php)

Как показывает практика, всеми этими параметрами вы будете пользоваться достаточно редко. Пожалуй единственная настройка которая должна находиться во всех подключаемых файлах, так это MODE, со значением html. Потому что это действительно удобно. И то, не стоит забывать, что он проставляется по умолчанию. Но как по мне, лучше прописать ещё раз, а то мало ли.


it-blog.club 1419
Автор: Ярослав Хмель


Если Вам понравилась статья, то можете поддержать блог переведя N сумму на кофе авторам или оплату хостинга!
В любом случае спасибо! А так же не забывайте про группу в ВК
ПОИСК ПО САЙТУ
Поддержать