Skip to content

Редактируемая область для Битрикс

License

Notifications You must be signed in to change notification settings

nukinuki/include

Repository files navigation

Компонент для Битрикс "Редактируемая область"

demo

Любой сайт можно собрать на статических html файлах, вот только обслуживать его не удобно. Обычно сайт на Битрикс состоит из статических и динамических разделов. Динамические разделы как правило построены на инфоблоках, а статические — на простых php-файлах. Программист может облегчить контент-менеджеру работу со статическими страницами, если правильно настроит стили визуального редактора и сниппеты.

Но как редактировать сложную вёрстку?

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

Установка

С помощью Composer

composer require webprofy/include

Вручную

Клонируйте репозиторий в папку local/components/webprofy/include вашего проекта

Подключение

Компонент работает без шаблона. Единственный параметр FILE — путь до файла с включаемой областью от корня сайта.

<?$APPLICATION->IncludeComponent("webprofy:include", "", array('FILE'=>'/include/main_intro.php')); ?>

Как работает

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

Кроме стандартной панели Битрикс с настройками компонента вверху справа отображается кнопка "Редактировать", при нажатии на которую включается режим правки.

По-умолчанию вся область является редактируемой, но в таком режиме у контент-менеджера есть риск сломать вёрстку. Возможности редактирования можно ограничить с помощью специальной разметки.

Разметка файла

При указании аттрибута data-editable внутри нужного тега подключается редактор с ограниченными возможностями — только Bold, Italic и Ссылка. Перенос строки или вставка изображений недоступны.

При указании аттрибута data-editable у <img /> становится доступным замена этого изображения через Drag-n-drop.

При указании аттрибута data-rich в дополнении к аттрибуту data-editable для указанной области подключается полный редактор, т. е. с возможностью переноса строк, вставки заголовков и загрузки изображений.

Загрузка изображений

Все изображения загружаются в папку /upload/webprofy_include/

TODO

  • data-repeatable для копирования/удаления блоков вёрстки
  • Ресайз картинок после загрузки
  • Проблема с загрузкой больших изображений (не проходит POST-запрос)

medium-editor

В качестве встроенного редактора используется medium-editor.

Ссылка на проект: https://github.com/yabwe/medium-editor

About

Редактируемая область для Битрикс

Resources

License

Stars

Watchers

Forks

Packages

No packages published