Оглавление

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

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

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

Установка

Установка плагина очень простая. Клонируете плагин из репозитория командой 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.

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

Описание

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

Кнопка для вставки галереи ms2Gallery

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

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

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

ms2Gallery пример модального окна

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

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

ms2Gallery результат работы плагина

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

ms2Gallery вывод галереи