diff --git "a/ru/03_\320\232\320\276\320\274\320\277\320\276\320\275\320\265\320\275\321\202\321\213/ContentBlocks/01_\320\237\321\200\320\270\320\274\320\265\321\200\321\213 \320\272\320\276\320\275\321\204\320\270\320\263\321\203\321\200\320\260\321\206\320\270\320\270.md" "b/ru/03_\320\232\320\276\320\274\320\277\320\276\320\275\320\265\320\275\321\202\321\213/PageBuilder/01_\320\237\321\200\320\270\320\274\320\265\321\200\321\213 \320\272\320\276\320\275\321\204\320\270\320\263\321\203\321\200\320\260\321\206\320\270\320\270.md" similarity index 100% rename from "ru/03_\320\232\320\276\320\274\320\277\320\276\320\275\320\265\320\275\321\202\321\213/ContentBlocks/01_\320\237\321\200\320\270\320\274\320\265\321\200\321\213 \320\272\320\276\320\275\321\204\320\270\320\263\321\203\321\200\320\260\321\206\320\270\320\270.md" rename to "ru/03_\320\232\320\276\320\274\320\277\320\276\320\275\320\265\320\275\321\202\321\213/PageBuilder/01_\320\237\321\200\320\270\320\274\320\265\321\200\321\213 \320\272\320\276\320\275\321\204\320\270\320\263\321\203\321\200\320\260\321\206\320\270\320\270.md" diff --git "a/ru/03_\320\232\320\276\320\274\320\277\320\276\320\275\320\265\320\275\321\202\321\213/ContentBlocks/index.md" "b/ru/03_\320\232\320\276\320\274\320\277\320\276\320\275\320\265\320\275\321\202\321\213/PageBuilder/index.md" similarity index 86% rename from "ru/03_\320\232\320\276\320\274\320\277\320\276\320\275\320\265\320\275\321\202\321\213/ContentBlocks/index.md" rename to "ru/03_\320\232\320\276\320\274\320\277\320\276\320\275\320\265\320\275\321\202\321\213/PageBuilder/index.md" index 7cbce23a..c3d5b8f8 100755 --- "a/ru/03_\320\232\320\276\320\274\320\277\320\276\320\275\320\265\320\275\321\202\321\213/ContentBlocks/index.md" +++ "b/ru/03_\320\232\320\276\320\274\320\277\320\276\320\275\320\265\320\275\321\202\321\213/PageBuilder/index.md" @@ -1,12 +1,13 @@ -Автор: mnoskov +Автор: mnoskov Плагин позволяет разработчику определить набор блоков с определенной разметкой и списком полей, чтобы контент-менеджер использовал те блоки, которые считает нужным, со своим наполнением. -Конфигурация для блоков берется из папки config. Для создания нового блока нужно создать в этой папке файл .php, который должен вернуть ассоциативный массив. Структура массива следующая: +Конфигурация для блоков берется из папки config. Для создания нового блока нужно создать в этой папке файл `.php`, который должен вернуть ассоциативный массив. Для создания контейнера нужно создать файл `.php`, имя которго будет начинаться с `container.`. Структура массива следующая: + +
КлючЗначение
titleНазвание блока, видимое менеджеру при заполнении
containerИмя контейнера (если несколько - то массив имен), в котором будет выводится блок.
fields @@ -22,6 +23,7 @@ Если этот параметр указан, то "hide_in_docs" не принимается во внимание. Если не указан ни один из параметров, ограничивающих доступ, блоки будут доступны во всех документах.
orderПорядок сортировки в секции добавления блока. Этот параметр НЕ влияет на сортировку самих блоков!
templates @@ -84,10 +86,10 @@ Также возможна подгрузка шаблона из файла, например: ```php -'owner' => '@FILE contentblocks/all_fields.tpl', +'owner' => '@FILE pagebuilder/all_fields.tpl', ``` -В этом примере файл шаблона будем загружен из `MODX_BASE_PATH . "assets/templates/contentblocks/all_fields.tpl"`. Вообще файл ищется в следующих директориях: +В этом примере файл шаблона будем загружен из `MODX_BASE_PATH . "assets/templates/pagebuilder/all_fields.tpl"`. Вообще файл ищется в следующих директориях: ``` assets/tvs/ @@ -115,7 +117,7 @@ assets/templates/ то вызов сниппета с параметром `&templates`, равным `anchors`, будет использовать для вывода шаблоны, которые определены в группе `anchors`: ``` -[[ContentBlocks? &templates=`anchors`]] +[[PageBuilder? &templates=`anchors`]] ``` ##Поля @@ -155,26 +157,28 @@ assets/templates/ ##Примеры конфигурации -Примеры конфигурации можно найти здесь. (Чтобы примеры блоков стали доступны для выбора, нужно переименовать файлы *.php.sample в *.php) +Примеры конфигурации можно найти здесь. (Чтобы примеры блоков стали доступны для выбора, нужно переименовать файлы *.php.sample в *.php) -##Сниппет ContentBlocks +##Сниппет PageBuilder -Для вывода заполненых блоков используется сниппет ContentBlocks с параметрами: +Для вывода заполненых блоков используется сниппет PageBuilder с параметрами: + +
Имя параметраЗначение по умолчаниюВозможные значения
docidТекущий документИдентификатор любого существующего документа, целое число
containerdefaultИмя контейнера
blocks*Список блоков через запятую, без пробелов. Берется имя файла конфигурации без расширения (Например, 'all_fields,groups'). Если указать '*', фильтрация по имени произведена не будет
wrapTpl[+wrap+]Имя чанка, содержащего шаблон-обертку для списка блоков выводимого контейнера
templatesИдентификатор группы шаблонов, которые будут использоваться для вывода. Должен быть определен в конфигурации каждого выводимого блока
offset0Число пропускаемых блоков с начала вывода
limit0Число блоков для вывода, либо 0 - для вывода всех
-##Плагин ContentBlocks +##Плагин PageBuilder Плагин отвечает за вывод формы редактирования блоков и имеет следующие параметры: - +
Имя параметраЗначение по умолчаниюВозможные значения
tabNameContent BlocksНазвание вкладки на странице редактирования ресурса, в которой будет выводиться форма
tabNamePage BuilderНазвание вкладки на странице редактирования ресурса, в которой будет выводиться форма
addTypedropdownВид секции для добавления новых блоков, может иметь значения "dropdown", "icons", "images". Для значения "icons" в конфигурации каждого блока должен быть определен ключ "icon", содержащий класс иконки. @@ -182,3 +186,4 @@ assets/templates/ Для значения "images" должен быть определен ключ "image", с адресом изображения (макс. 80х60)
placementtabРазмещение формы: tab - в отдельной вкладке, content - под содержимым ресурса
+