ms2Gallery

Оглавление

• Демонстрация работы
• Установка
  • Настройка для TinyMCE Rich Text Editor
• Описание

Плагин для TinyMCE 4 версии — ms2Gallery, служит для удобной вставки галерей платного компонента MODx ms2Gallery. Можно использовать как с родным полем MODx — content, так и с любым другим дополнительным полем (TV или MIGX), чей тип будет richtext (для подключения текстового редактора).

Демонстрация работы

Установка

Установка плагина очень простая. Клонируете плагин из репозитория командой git clone https://github.com/iWatchYouFromAfar/TinyMCE4-ms2Gallery или просто скачиваете.

Настройка для TinyMCE Rich Text Editor:

Установка для компонента MODx TinyMCE Rich Text Editor.

1. Копируете плагин в папку /assets/components/tinymcerte/js/vendor/tinymce/plugins/.
2. В системных настройках TinyMCE RTE находите настройку tinymcerte.plugins, добавляете туда название плагина: ms2Gallery.
3. Там же, находите три настройки tinymcerte.toolbar1, tinymcerte.toolbar2, tinymcerte.toolbar3. Выбираете на какой тулбар вставить кнопку, и указываете название плагина: ms2Gallery.

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

Описание

После установки плагина, в меню редактора будет новая кнопка:

При нажатии на неё, появится модальное окно, куда нужно будет ввести значения для четырех параметров:

• parents — Список категорий, через запятую, для поиска результатов.
• resources — Список ресурсов, через запятую, для вывода в результатах.
• limit — Лимит выборки результатов.
• tags — Список тегов, разделённых запятыми, для вывода изображений.

Это пожалуй единственные знания, которые необходимы менеджеру при работе с ms2Gallery, знать индентификаторы ресурсов, выставлять лимит и уметь набирать русские буковки для вывода изображений по тегам. Более подробно про эти (и другие) параметры читайте в официальной документации ms2Gallery.

Пример заполненного модального окна:

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

[[!ms2Gallery? &tags=`Озеро,Горы`]]

На фронте, в поле content, должна появится галеря с опциями, которые указаны в вызове: