Плагины | ruCAD - интегрированная система на базе AutoCAD

Книга по MODx

Книга «Официальный сайт на базе MODx - как это делается»

Наши заметки о MODx

В этом разделе мы будем собирать небольшую копилку секретов по работе с системой управления контентом сайта (CMS) MODx. Эти заметки ни в коем случае не претендуют на лавры документации. На нашем сайте тема MODx вообще занимает небольшой уголок, и эти материалы мы размещаем только потому, что по роду основной работы нам приходится оказывать техническую поддержку нескольким десяткам организаций, использующих наши прототипы сайтов. В то же время кое-что может пригодиться и другим людям.

Мы не претендуем на изложение "истины в последней инстанции". Наверняка в этих заметках гуру MODx найдут неточности и ошибки. Мы будем очень благодарны, если на это нам укажут в комментариях.

В заметках мы стараемся не просто сразу приводить готовое правильное решение, но и показываем, как мы набивали шишки в процессе поиска.

Основные ресурсы по MODx

Англоязычный портал MODx

Русскоязычный форум по MODx

Русская Wikipedia - MODx

Дополнительные ресурсы по MODx

Редактор TinyMCE

AjaxFileManager

AjaxSearch

PieX - MODx Wiki. Здесь есть самая свежая версия.

Какие плагины мы применяем

Плагины относятся к важнейшим ресурсам MODx. Плагин - это подпрограмма на языке php, выполняющаяся при различных событиях системы MODx. Например, плагин может выполняться при выводе html-кода в браузер.

На нашем сайте используется не очень-то много плагинов. Основные плагины входят в сборку MODx.

Плагины MODx

Плагин	Описание	Пояснения
TinyMCE	Текстовый редактор, используемый для редактирования контента страниц сайта	Подробно описан в специальных заметках
QuickEdit	Плагин, позволяющий редактора сайта редактировать свойства и текст страницы, не разыскивая её в админке, а прямо при просмотре.	Описан в этой заметке. Заменен на Quim
Search Highlighting	Осуществляет подсветку найденных слов после выполнения поиска по сайту с использованием сниппета AjaxSearch	Безусловно необходим. См. примечание.
Inherit Parent Template	Устанавливает для новых документов такой же шаблон, как у родительского документа.	Очень удобно
Bottom Button Bar	Добавляет дополнительный ряд кнопок Сохранить, Удалить и Отмена в нижнюю часть фрейма Создать/Редактировать документ админки	Удобно - позволяет избегать многократных прокруток фрейма
Forgot Manager Login	Сброс забытого пароля менеджера	Возможно что удобно для растяп. Мы пароли не забываем, проверить не пришлось
Image TV Preview	Показывает миниатюры предварительного просмотра картинок, загружаемых в качестве параметров TV (Template Variable)	Пока не оценили, таких параметров не использовали. При случае напишем специальную заметку.

Некоторые плагины установлены нами дополнительно.

Дополнительные плагины

Плагин	Описание	Пояснения
GeSHi Syntax Highlighter	Автоматическая подсветка синтаксиса исходников, публикуемых на сайте	Идея привлекательная, для каких-то сайтов полезная. У нас - масса проблем, описанных в этой заметке. Плагин оставлен на всякий случай.
FileDownloadPlugin	Обеспечивает загрузку файлов с сайта	Очень нужный, но имеется масса проблем. Когда добьемся их устранения, напишем специальную заметку по укрощению.
ru_AutoAliasRus2Lat	Автоматически преобразует заголовок страницы в псевдоним. Для русского языка выполняется транслитерация. Если псевдоним задан вручную, то он не изменяется	Значительно упрощает работу. Пример может увидеть в адресной строке браузера. Пришлось подключить из-за того, что штатная настройка MODx Автоматически генерировать псевдонимы не работает для русских заголовков страниц.
HyperStabilo	Также подсвечивает результаты поиска.	См. комментарий ниже
EditArea	Выполняет подсветку синтаксиса, поиск и замену при редактировании исходных текстов сниппетов и плагинов.	Польза будет при микроскопической правке или при просмотре. Подсветка выполняется коряво, для серьезной работы не годится - лучше забрать текст в Notepad++
DirecrResize	Масштабирование одиночных картинок, вставленных в текст. Если в свойствах картинки задать уменьшенный размер, а мы это как раз часто делаем, чтобы большой скриншот не вылезал за пределы колонки, то этот плагин автоматически создает миниатюру, ссылку на картинку заменяет на миниатюру заданного размера (эта миниатюра может быть и не такой уж миниатюрной). При щелчке по картинки открывается полное изображение с различными эффектами - как в MaxiGallery.	Плагин очень полезен, но нуждается в тщательной настройке, а возможно и в обработке напильником - естьнеприятные побочные эффекты. Заслуживает написания подробной заметки.

При ревизии плагинов на нашем сайте выяснилось, что есть два плагина, предназначенных для подсветки результатов поиска - Search Highlighting и HyperStabilo. Search Highlighting входит в "родную" сборку MODx, а зачем мы второй поставили - уже забылось. При пробах оказалось, что на нашем сайте подсветку результатов выполняет именно HyperStabilo, а "штатный" Search Highlighting - не подсвечивает результаты.

В результате следствия установлено, что Search Highlighting всё-таки делает подсветку, но её не видно, так как в наших таблицах стилей не было требуемых классов (AS_ajax_highlight1 ... AS_ajax_highlight6 и ajaxSearch_highlight1 ... ajaxSearch_highlight6), а в HyperStabilo цвета зашиты в код плагина. Скорее всего этот плагин мы поставили, когда использовали HyperFlexSearch. Теперь нет никаких причин для его сохранения. Удаляем смело.