- 6
-
1
-
Ответов на вопросы за месяц: 1
-
Плагин Menu
03.05.2024
-
Что такое Плагины?
Если инструкция не соответствует тому, что Вы видите, Ваша версия CMS устарела. Обратитесь к создателю сайта за обновлением...
Все плагины в CMS Zion WebEngine служат для выполнения каких-либо целей. Это может быть вывод какого-то текста, корректировка базы данных, изменение глобальных переменных и т.д.
Где хранятся плагины
Плагины могут быть самостоятельными программными модулями или могут быть частью классов
- Каждый самостоятельный плагин хранится в одном из файлов в папке
plugins
, либоplugins/custom.
Если Вы хотите изменить один из таких плагинов или создать новый, то сохраняйте его в папкеplugins/custom
- так он не будет заменён стандартным плагинов в случае обновления CMS. При совпадении имён вplugins
и вplugins/custom
наибольший приоритет имеют плагины из папкиplugins/custom
. - Если плагин является частью класса, то найти его можно в файле соответствующего класса. Это будет отдельный метод, имя которого всегда начинается с
Plugin
и в качестве параметров к которому должен передаваться массивparams
Набор доступных плагинов зависит от комплекта поставки
Имена плагинов
- Если плагин хранится в отдельном файле с имением
мойплагин.php
то имя плагина будетмойплагин
(.php
обязательно должно присутствовать в имени файла) - Если плагин является частью класса, например,
мойкласс
, и хранится в методеPluginМойПлагин
, то имя плагина будетмойкласс_МойПлагин
К плагинам можно обращаться через команду вызова, через URL-адрес или через AJAX
- В самом простом случае команда вызова плагина выглядит так:
{plugin:мойплагин}
или{plugin:мойкласс_МойПлагин}
- При обращении через URL-адрес всё аналогично:
/?plugin=мойплагин
или/?plugin=мойкласс_МойПлагин
(в URL также могут быть указаны другие GET-параматры, как слева, так и справа от того, что указано в примере) - При обращении через AJAX нужно соблюсти следующие условия:
- В HTML-коде веб-страницы должна присутствовать команда вызова специального плагина AJAX -
{plugin:ajax}
(если указать её несколько раз, дублирование вызова нужных модулей не произойдёт) - Вызов плагина через AJAX должен происходить через вызов ассинхронной JS-функции
sendRequest(URL,objectID,getRequest,oldHTML,okProc)
, гдеURL
- URL-адрес плагина (пример смотрите выше)objectID
- ID HTML-тега, в который будет возвращён результат выполнения плагинаgetRequest
- оставляйте этот параметр без измененийoldHTML
- этот параметр не обязательный - можно оставить его пустым, но если заполнить его текстом или HTML-кодом, то он будет отображаться в результирующем тегеobjectID
до того, как плагин вернёт результатokProc
- этот параметр не обязательный - можно оставить его пустым, но если указать в нём какую-либо JS-функцию, то она будет выполнена после того, как плагин вернёт результат (эта функция не должна принимать параметры)
- В HTML-коде веб-страницы должна присутствовать команда вызова специального плагина AJAX -
Результаты выполнения плагинов
Плагины могут возвращать результирующий текст или HTML-код.
- В самостоятельных плагинах результат присваивается PHP-переменной
$echo
- В плагинах из классов результат возвращается через оператор
return(...);
От способа вызова плагина зависит то, где и как будет выводиться его результат:
- Если используется команда вызова плагина, то результат отобразится именно там, где была команда (результат заменит собой команду)
- Если используется обращение по URL-адресу, то результат выведется в браузере (при этом на веб-странице не будет ничего кроме результата выполнения плагина)
- Если используется вызов через AJAX, то результат будет выведен в тег, свойство
id
которого совпадает с тем, что указано вobjectID
Параметры плагинов
Плагинам можно передавать параметры. В результате многие плагины могут выполняться в сотнях и в тысячах различных режимов
- Если используется команда вызова плагина, то она может выглядеть, например, так:
{plugin:имя_плагина;color:red;type:apple;action:kick}
, при этом- после имени плагина должна быть точка с запятой
;
- пары имя-значение (имя и значение параметра) отделяются друг от друга точкой с запятой
;
- имя параметра от значения того же параметра отделяется двоеточием
:
- в именах и в значениях параметров не допускается использовать двоеточия
:
и точки с запятой;
- после имени плагина должна быть точка с запятой
- Если используется обращение по URL-адресу, то для того же плагина с теми же параметрами URL будет такой:
/?plugin=имя_плагина¶ms=color:red;type:apple;action:kick}
, при этом- после имени плагина нужно написать
¶ms=
- пары имя-значение (имя и значение параметра) также отделяются друг от друга точкой с запятой
;
- имя параметра от значения того же параметра также отделяется двоеточием
:
- в именах и в значениях параметров не допускается использовать двоеточия
:
и точки с запятой;
, а также амперсанд&
и равно=
- после имени плагина нужно написать
- Если используется вызов через AJAX, то к URL применяются те же требования, что и в предыдущем примере
В плагине эти параметры можно использовать, как элементы ассоциативного массива $params
. Например, параметры из примеров выше будут доступны, как переменные $params['color']
, $params['type']
и $params['action']
.
Плагины могут воспринимать только те параметры, которые в них запрограммированы. Список доступных параметров смотрите в документации к каждому конкретном плагину
Что такое Комплект поставки? AJAX POST/GET-данные Адрес (URL)/ЧПУ/Переадресация Классы Обновления CMS Плагины Элемент "HTML-код веб-страницы" Элемент "Адрес" Элемент "Место в структуре"
Если инструкция не соответствует тому, что Вы видите, Ваша версия CMS устарела. Обратитесь к создателю сайта за обновлением...
CMS Zion WebEngine является бесплатной системой. Развивается за счёт рекламы, помощи веб-студии #webZion и других спонсоров.
Будем рады, если Вы поддержите нас любой суммой, а также поделитесь идеями на счёт каких-либо улучшений и доработок для CMS...
Заранее, большое, спасибо
|
Блог обновлений
Zion WebEngine X9.10.07
- Доработан класс, облегчающий миграцию со старых версий CMS на новые (спасибо Федерация Киокусинкай Пермского края):
- Реализована конвертация условий (в очень старых версиях их формат отличался от используемого сейчас)
Zion WebEngine X9.10.02
- Доработан класс, облегчающий миграцию со старых версий CMS на новые (спасибо Федерация Киокусинкай Пермского края):
- Доработана миграция страниц ошибок
- Оптимизирована конвертация новостей, товаров их категорий и всего, что с ними связано
- Реализована конвертация контактов для обратной связи
- Доработана конвертация команды вызова плагина новостей в команду вызова плагина универсального меню
- Доработана конвертация некоторых свойств новостей, эскизов и изображений
Zion WebEngine Что такое CMS Zion WebEngine? Изображение Категории Классы Контент/Контентные единицы Меню/Списки/Навигация Миграция Обратная связь/Обратный звонок Плагины Сайт-каталог Страницы ошибок Эскизы
Zion WebEngine X9.10.01
- Доработан класс, облегчающий миграцию со старых версий CMS на новые (спасибо Федерация Киокусинкай Пермского края):
- Реализована конвертация команд вызова устаревшего плагина кэширования в команды для вызова современных аналогов
- Эскизы теперь не копируются из старой версии в новую, так как в новой версии эскизы создаются автоматически
- На время миграции теперь автоматически отключается поддержка SSL/HTTPS
- Доработана миграция онлайн-консультанта
- Расширен набор опций для миграции:
- Например, при можно отключить копирование файлов из папки upload и её подпапок для ускорения процесса при повторной миграции - когда содержимое этой папки уже скопировано
Zion WebEngine HTTP/HTTPS/SSL-сертификаты Классы Кэш/Кеш Миграция Онлайн-консультант Плагины Файлы/Папки Эскизы
Zion WebEngine X9.09.22
- Доработаны класс для работы с контентом и плагин универсального меню (спасибо iRobot Пермь):
- Устранены недочёты при сравнении (например, товаров)
Zion WebEngine Классы Контент/Контентные единицы Меню/Списки/Навигация Плагины Сайт-каталог Сравнение
Zion WebEngine X9.09.21
- Доработан класс для работы с текущими данными (спасибо iRobot Пермь):
- Расширен функционал для определения и использования ID текущей страницы
Zion WebEngine X9.09.20
- Доработаны класс для работы с навигацией (спасибо iRobot Пермь):
- Дополнены некоторые подсказки
- Доработаны класс и плагин для работы с галереей:
- Теперь, если индикаторы нужно формировать с помощью HTML-кода, нет необходимости создавать две галереи и вызывать одну из другой:
- В редакторе галерее добавлены поля (по аналогии с подстраницами в редакторе меню/списков, но со своими отличиями):
HTML-код до списка индикаторов
HTML-код после списка индикаторов
HTML-код обычного элемента списка индикаторов
- Реализована обработка новых свойств:
{gallery_indicator}
- порядковый номер индикатора, начиная с1
{gallery_indicator0}
- порядковый номер индикатора, начиная с0
{gallery_indicators}
- именно вместо этого свойства будет вставлен весь HTML-код индикаторов:- Доступна многократная вставка индикаторов в одной галерее
- Доступны условия для тонкой настройки каждого индикатора:
IS_HAS_NUMBER_номер??истина::ложь
- если у данного индикатора соответствующий порядковый номер, начиная с1
IS_HAS_NUMBER0_номер??истина::ложь
- если у данного индикатора соответствующий порядковый номер, начиная с0
- В редакторе галерее добавлены поля (по аналогии с подстраницами в редакторе меню/списков, но со своими отличиями):
- Теперь, если индикаторы нужно формировать с помощью HTML-кода, нет необходимости создавать две галереи и вызывать одну из другой:
Zion WebEngine Zion Gallery Галереи/Слайды Классы Меню/Списки/Навигация Пагинация/Подстраницы Плагины Помощники/Мастеры/Инструкции/Подсказки Свойства Условия
Zion WebEngine X9.09.19
- Доработаны класс и плагин для работы с навигацией (спасибо iRobot Пермь):
- Помимо свойства
menu_item_number
, подставляющего порядковый номер пункта списка/меню, начиная с1
, теперь можно использовать свойствоmenu_item_number0
для подстановки порядкового номера пункта, начиная с0
- Также добавлены соответствующие условия и подсказки для них:
- Аналогичные доработки для условий реализованы в классе и плагине для работы с галереями
- Помимо свойства
Zion WebEngine Zion Gallery Галереи/Слайды Классы Меню/Списки/Навигация Плагины Помощники/Мастеры/Инструкции/Подсказки Свойства Условия
Zion WebEngine X9.09.18
- Доработаны класс и плагин для работы с галереями (спасибо iRobot Пермь):
- Помимо свойства
{gallery_item_number}
, подставляющего порядковый номер слайда, начиная с1
, теперь можно использовать свойство{gallery_item_number0}
для подстановки порядкового номера слайда, начиная с0
:- Это может быть полезно при работе с некоторыми слайдерами
- Устранены некоторые недочёты и повышена производительность
- Помимо свойства
Zion WebEngine X9.09.17
- Доработан класс для управления корзиной заказов (спасибо Moto-Retail18):
- Реализованы инструменты для исключения вероятности двойного клика по кнопке оформления заказа (в результате могло поступить 2 одинаковых заказа)
- Доработан класс для управления навигацией:
- Доработаны записи по умолчанию
Zion WebEngine Zion Catalog Классы Корзина для заказов Меню/Списки/Навигация
Zion WebEngine X9.09.12
- Доработан настраиваемый модуль для управления уведомлениями о заказах на системный e-mail (спасибо Moto-Retail18):
- Устранены недочёты в тексте сообщения и в служебных заголовках
Zion Catalog Email-сообщения Настраиваемые модули Реакции на заказ
Zion WebEngine X9.09.11
- Доработан настраиваемый модуль для управления уведомлениями о заказах в административный интерфейс (спасибо Moto-Retail18):
- Изменена формулировка некоторых подсказок
Zion Catalog Административный интерфейс Настраиваемые модули Помощники/Мастеры/Инструкции/Подсказки Реакции на заказ
Zion WebEngine X9.09.10
- Доработан настраиваемый модуль для управления уведомлениями о заказах в XML/1C (спасибо Белый и Пушистый):
- Учтены особенности разных версий (и настроек) 1С относительно длины идентификаторов товаров в заказах:
- Этот параметр теперь можно настраивать в административном интерфейсе
- Устранены недочёты с некорректными идентификаторами товаров в XML-файлах с информацией о заказах:
- При создании заказов проблем не было. Проблемы при смене статуса заказа устранены
- Учтены особенности разных версий (и настроек) 1С относительно длины идентификаторов товаров в заказах:
- Доработан класс для управления навигацией (спасибо Savory):
- Доработаны записи по умолчанию
- Продолжена переделка принципа действия форм обратной связи и заказа обратного звонка:
- Доработан вспомогательный класс для управления вкладками
- Доработан класс для управления формами обратной связи:
- Начата работа по управлению полями, которые можно будет использовать в формах
- Добавлено несколько подробных подсказок по использованию нового функционала
- Разработка ещё не завершена
Zion WebEngine Zion Mail Back Zion Export XML/RSS/1С/YML Административный интерфейс Вкладки Импорт/Экспорт Классы Меню/Списки/Навигация Настраиваемые модули Обратная связь/Обратный звонок Помощники/Мастеры/Инструкции/Подсказки Реакции на заказ Формы
Zion WebEngine X9.09.02
- Доработаны классы для управления корзиной и заказами, а также для управления уведомлениями о заказах на системный e-mail и через экспорт в XML/1C (спасибо Белый и Пушистый):
- Добавлена опциональная возможность указывать ИНН в форме заказа в интернет-магазине
Zion Catalog Zion Export Email-сообщения XML/RSS/1С/YML Импорт/Экспорт Интернет-магазин Классы Корзина для заказов Настраиваемые модули Реакции на заказ Формы
Zion WebEngine X9.08.26
- Доработан класс для управления онлайн-консультантом:
- Устранены некоторые недочёты при сохранении параметров
- Доработаны класс и система мониторинг для reCAPTCHA:
- Оптимизирована работа с защитой от спама
- Реализована возможность отображать любое количество reCAPTCHA на одной странице
- Доработано отключение защиты от XSS (спасибо Федерация Киокусинкай Пермского края):
- Теперь оно происходит только, если достоверно известно, что в административный интерфейс вошёл тот, у кого к нему должен быть доступ
- Доработаны некоторые классы и плагины:
- Повышена производительность при выполнении команд вызова плагинов
- Повышена производительность при обработке условий
- Доработан драйвер оболочки:
- Изменён подход к выполнению команд вызова плагинов:
- Применена более производительная альтернатива
- Доступны положительные побочные эффекты, которые будут применены в ближайших обновлениях
- Изменён подход к выполнению команд вызова плагинов:
- Доработаны формы и обработчики обратной связи и заказа звонка:
- Google reCAPTCHA теперь защищает от спама и в случае заказа обратного звонка
- Доработана адаптивность форм
- Учтены недочёты при отображении элементов, необходимых для соблюдения ФЗ-152
Zion WebEngine Zion Mail Back Zion Gallery Zion JivoSite Zion Bulletins Board XSS Административный интерфейс Доступ Групп пользователей Драйверы Классы Мониторинг Обновления CMS Обработчики Обратная связь/Обратный звонок Онлайн-консультант Плагины Спам Условия ФЗ-152 Формы
Zion WebEngine X9.08.23
- Доработан класс для экспорта данных о заказах в FrontPad: (спасибо Якудза)
- Реализована возможность отображать информацию для отладки связи с FrontPad при просмотре заказа в административном интерфейсе
- Для этих же целей доработаны классы для управления заказами и вкладками:
- Различные классы теперь также могут добавлять дополнительные вкладки при просмотре заказов
Zion WebEngine Zion Catalog Zion Export Что такое Административный интерфейс и Гостевой интерфейс? Вкладки Импорт/Экспорт Классы Корзина для заказов Настраиваемые модули Реакции на заказ
Zion WebEngine X9.08.22
- Доработан класс для экспорта данных о заказах в FrontPad: (спасибо Якудза)
- Расширен набор возможностей по настройке модуля
- В том числе реализована возможность выбирать способы оплаты, при которых данные о заказе нужно отправлять только после получения оплаты
- Проведены "боевые" испытания
- Разработка завершена, но развитие продолжится в новых версиях
- Расширен набор возможностей по настройке модуля
Zion Export Импорт/Экспорт Классы Настраиваемые модули Реакции на заказ Способы оплаты
Zion WebEngine X9.08.21
- Доработан класс для управления языками (спасибо Анвизор):
- Улучшена SEO-оптимизация для многоязычных сайтов
- Доработаны классы для управления корзиной и заказами (спасибо Якудза):
- Устранена уязвимость, при которой покупатель в интернет-магазине мог оформить заказ и перейти к онлайн-оплате, но при этом по какой-то причине возвращался на сайт (по своей воле). После этого он мог сменить способ оплаты, способ доставки, товары в заказе и контактные данные. Не все данные при этом обновлялись там, где это было необходимо:
- В связи с этим также были доработаны настраиваемые модули уведомления о заказах на системный email и по SMS
- Устранена уязвимость, при которой покупатель в интернет-магазине мог оформить заказ и перейти к онлайн-оплате, но при этом по какой-то причине возвращался на сайт (по своей воле). После этого он мог сменить способ оплаты, способ доставки, товары в заказе и контактные данные. Не все данные при этом обновлялись там, где это было необходимо:
- Создан класс для экспорта данных о заказах в FrontPad (CRM-система, оптимизированная для доставки пищи):
- Разработка пока не завершена
Zion WebEngine Zion Catalog Zion Export Zion Multi-Lang Email-сообщения SEO-параметры SMS Импорт/Экспорт Интернет-магазин Классы Корзина для заказов Многоязычность/Языки Настраиваемые модули Реакции на заказ Способы доставки/самовывоза Способы оплаты
Zion WebEngine X9.08.20
- Доработан плагин формы обратной связи (спасибо Анвизор):
- Устранены некоторые недочёты при работе со списком контактов
Zion WebEngine X9.08.19
- Доработан класс для управления корзиной заказов (спасибо Белый и Пушистый):
- Расширены возможности кастомизации формы заказа
- Доработаны настраиваемые модули для управления уведомлениями о заказах (в CMS, в XML/1C, на системный email):
- Теперь скрываются или переименовываются некоторые поля в соответствии с заданными настройками
- При экспорте данных в XML/1C теперь отправляется цена товаров с учётом всех скидок
- Доработаны JS-скрипты для административного интерфейса (спасибо Якудза):
- Смена места в структуре стала более быстрой и удобной
- Доработан класс для управления местом в структуре:
- Устранены некоторые недочёты
Zion WebEngine Zion Catalog Zion Export Что такое CMS Zion WebEngine? Email-сообщения XML/RSS/1С/YML Административный интерфейс Импорт/Экспорт Классы Корзина для заказов Место в структуре Настраиваемые модули Реакции на заказ Скидки/Наценки Формы
Zion WebEngine X9.08.16
- Доработаны классы для управления корзиной и заказами (спасибо Якудза):
- Расширен набор полей в форме заказа в интернет-магазине:
- Добавлены подъезд и этаж, а также количество персон:
- Новые поля будут полезны, например, доставщикам пищи:
- Количество персон в форме заказа можно скрыть
- Новые поля будут полезны, например, доставщикам пищи:
- Добавлены подъезд и этаж, а также количество персон:
- Реализована возможность скрывать в форме заказа в интернет-магазине поля для указания индекса и региона:
- Это может быть полезно в тех случаях, когда Ваша доставка работает только на один город:
- Для этих же целей и для совместимости с некоторыми модулями доступно указание индекса, региона и города по умолчанию
- Это может быть полезно в тех случаях, когда Ваша доставка работает только на один город:
- Реализована возможность переименовывать поле "Ф.И.О." в форме заказа в интернет-магазине:
- Например, можно назвать это поле "Ваше имя", "Контактное лицо" или использовать любое другое обращение к клиенту
- Управление галочкой "Перезвонить" теперь работает не через указание параметра при вызове плагина
basket_Order
, а при настройке способа уведомления о заказах с модулемВ CMS
:- Остальными выше перечисленными опциями можно управлять там же
- Здесь же добавлены подсказки о том, на что влияет та или иная опция
- Расширен набор полей в форме заказа в интернет-магазине:
- Доработаны модули уведомлениями о заказах через системный email и через экспорт в 1C/XML:
- Расширен набор поддерживаемых полей в информации о заказах
- Доработан класс для управлениям пользователями:
- Расширен набор полей в контактной информации о пользователе
- Доработано CSS-оформление для формы заказа в интернет-магазине по умолчанию:
- Реализована поддержка новых полей
Zion WebEngine Zion Catalog Zion Export Email-сообщения XML/RSS/1С/YML Доступы/Пользователи Импорт/Экспорт Интернет-магазин Классы Корзина для заказов Настраиваемые модули Плагины Помощники/Мастеры/Инструкции/Подсказки Реакции на заказ Способы доставки/самовывоза Формы
© 2005-2024 Все права защищены | Поддержку осуществляет веб-студия #webZion