- 7
-
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 20.01.27
- Доработан класс для управления базой данных:
- Устранены недочёты при отображении кнопок для очистки кэша веб-страниц (спасибо ГлассПром-Урал)
- В списке пользователей теперь отобажаются их логины (спасибо Федерация Киокусинкай Пермского края):
- Доступно при наличии в комплекте постави Zion User Control
- Доработаны классы для управлениями типами контента и местом в структуре:
- Стала доступна возможность скрывать при выборе места в структуре записи любых типов:
- Для каждого типа это настраивается отдельно в разделе
Справочники \ Типы
:- Доступно при наличии в комплекте постави Zion Pub Hub или Zion Catalog
- Может быть полезно, если у Вас очень много новостей, статей или товаров, у которых не может быть подразделов, но которые при этом отображаются в дереве подразделов, что сильно затрудняет поиск нужного надраздела
- Для каждого типа это настраивается отдельно в разделе
- Стала доступна возможность скрывать при выборе места в структуре записи любых типов:
- Доработан класс для управления элементом контента
Дата
:- Учтены особенности браузера
Apple Safari
, который обрабатывает даты не по общепринятым стандартам в отличии от других браузеров:- Данный браузер НЕ РЕКОМЕНДУЕТСЯ для пользователей Windows, так как для этой платформы его разработка завершена и последние версии давно устарели
- Учтены особенности браузера
- Компоненты, необходимые для работы с reCAPTCHA перенесены из ядра в пакет Zion Mail Back
Zion WebEngine Zion User Control Zion Catalog Zion Mail Back Zion Pub Hub Что такое Комплект поставки? База данных/Таблицы данных Веб-браузер Дата/Время/TimeMashine Доступы/Пользователи Классы Контент/Контентные единицы Кэш/Кеш Место в структуре Сайт-каталог Спам Типы Элементы
Zion WebEngine 20.01.23
- Доработан класс для интеграции с Gifts.Ru (спасибо ZS-Moskva):
- При импорте изображений учтена вероятность использования недопустимых символов в именах файлов
Zion Import Изображение Импорт/Экспорт Классы Кодировки/Наборы символов Файлы/Папки
Zion WebEngine 20.01.22
- Доработан класс для интеграции с Gifts.Ru (спасибо ZS-Moskva):
- Переработан алгоритм скрытия категорий, в которых нет ни одного товара
Zion WebEngine 20.01.21
- Доработан класс для интеграции с Gifts.Ru (спасибо ZS-Moskva):
- Оптимизирован и упрощён алгоритм автоматической докачки файлов изображений для товаров с сайта gifts.ru на Ваш сайт
- Налажено более грамотное форматирование цен
- Приняты меры для скрытия категорий, в которых нет ни одного товара:
- Работы в этом направлении ещё ведутся
Zion Import Изображение Импорт/Экспорт Категории Классы Сайт-каталог Файлы/Папки
Zion WebEngine 20.01.20
- Доработан класс для интеграции с Gifts.Ru (спасибо ZS-Moskva):
- Реализован импорт данных о товарах
- Также реализована автоматическая загрузка изображений для товаров с сайта gifts.ru на Ваш сайт:
- В связи с некоторыми ограничеиями на количество обращений доступна автоматическая докачка файлов
Zion Import Изображение Импорт/Экспорт Классы Сайт-каталог Файлы/Папки
Zion WebEngine 20.01.18
- Доработан класс для интеграции с Gifts.Ru (спасибо ZS-Moskva):
- Реализован импорт данных о структуре каталога (о категориях товаров и о товарах в этих категориях с учётом подкатегорий)
Zion WebEngine 20.01.17
- Доработан класс для работы с XML-данными (спасибо ZS-Moskva):
- Упразднены некоторые архаизмы
- Доработано меню администратора для пакета Zion Import:
- Начата работа по внедрению интеграции с веб-сервисом Gifts.Ru
Zion Import XML/RSS/1С/YML Импорт/Экспорт Классы Меню администратора
Zion WebEngine 20.01.14
- Оптимизирован класс для работы с файлами и папками (спасибо Moto-Retail18):
- Реализована возможность отключения обязательной сортировки по имени при построении дерева каталогов
- Реализовано кэширование при построении дерева каталогов
- Доработан класс для работы с XML-данными:
- Ускорена загрузка списков файлов и папок при настройке импорта из XML/1С
- Эскиз по умолчанию перенесён из пакета Zion Pub Hub в Zion WebEngine, так как он может быть необходим для других пакетов
- Доработана система мониторинга для Ядра (спасибо Федерация Киокусинкай Пермского края):
- Приняты меры для того, чтобы стандартный эскиз по умолчанию не заменял собой его пользовательский аналог при обновлениях до более новых версий CMS
- Доработан класс для управления типами:
- Улучшен алгоритм автоматического создания недостающих столбцов в таблицах данных:
- Повышена совместимость со старыми версиями CMS при их обновлении до более свежих версий
- Устранены некоторые недочёты, связанные с выбором для типа шаблона по умолчанию:
- В некоторых случаях могли появляться вкладки, которых в редакторе типов быть не должно
- Улучшен алгоритм автоматического создания недостающих столбцов в таблицах данных:
- Доработан класс для управления базой данных:
- Реализованы некоторые решения, которые станут доступны в более новых версиях CMS
Zion WebEngine Zion Import Zion Pub Hub Что такое Комплект поставки? XML/RSS/1С/YML База данных/Таблицы данных Импорт/Экспорт Классы Кэш/Кеш Мониторинг Обновления CMS Типы Файлы/Папки Шаблоны контента Эскизы
Zion WebEngine 20.01.09
- Доработаны класс для работы с навигацией и плагин универсального меню (спасибо Якудза):
- Добавлено новое условие
IS_HOUR<значение??истина::ложь
, с помощью которого можно применять к меню разное оформление в зависимости от того, наступил ли указанный в значении час:- Может быть полезно, например, в тех случаях, если Вы принимаете заказы не круглосуточно
- Добавлено новое условие
Zion WebEngine Классы Корзина для заказов Меню/Списки/Навигация Плагины Условия
Zion WebEngine 20.01.07
- Доработан класс конвертации кириллических доменов (спасибо Балкон-Мастер):
- Устранена несовместимость с PHP 7.4
Zion WebEngine 20.01.04
- Для совместимости с новыми стандартами CMS доработаны некоторые компоненты:
- Инструкция по использованию CKeditor
- Элемент "HTML-код веб-страницы"
- Классы для управления проектом, пользователями и шаблонами
- Мониторы MySQLi и объявлений
- Обработчики обратной связи, обратного звонка и добавления объявления
- Настраиваемые модули для управления уведомлениями о заказах на системный email и для расчёта стоимости и срока доставки через СДЭК
- Плагины Meta и SendMail
Zion WebEngine Zion Catalog Zion Mail Back Zion SEO Booster Zion xDelivery Zion Sender Zion Bulletins Board Email-сообщения HTML-код веб-страницы SEO-параметры База данных/Таблицы данных Доступы/Пользователи Классы Мониторинг Настраиваемые модули Объявления Обработчики Обратная связь/Обратный звонок Плагины Помощники/Мастеры/Инструкции/Подсказки Рассылки Реакции на заказ Редактор контента/WYSIWYG-редактор СДЭК Способы доставки/самовывоза Шаблоны контента Элементы
Zion WebEngine 20.01.03
- Доработан класс для управления связями:
- Устраненены некоторые недочёты в совместимости с PHP 7.4
- Доработан монитор функциональности PHP:
- Реализована полная совместимости с PHP 7.4
Zion WebEngine X9.12.19
- Доработан класс для управления базой данных (спасибо Федерация Киокусинкай Пермского края):
- Некторые кнопки в списке записей (и при правке записи) в интерфейсе администратора теперь стали более компактными, что позволяет видеть больше записей на одном экране
- Доработан класс для управления типами контента:
- Стало доступно указание шаблона по умолчанию для каждого типа:
- При создании новой записи теперь по умолчанию подставляется выбранный для соответствующего типа шаблон:
- Его можно оставить или заменить на другой (как перед созданием, так и после)
- При создании новой записи теперь по умолчанию подставляется выбранный для соответствующего типа шаблон:
- Стало доступно указание шаблона по умолчанию для каждого типа:
- Доработано CSS-оформление для интерфейса администратора:
- Устранены некоторые недочёты
Zion WebEngine Административный интерфейс База данных/Таблицы данных Классы Контент/Контентные единицы Типы Шаблоны контента
Zion WebEngine X9.12.12
- Доработаны классы для управления корзиной и заказами (спасибо Moto-Retail18):
- При настройке способов уведомления о заказах стала доступна возможность отключать для телефона покупателя строгий формат
79XXXXXXXXX
- Такой формт нужен только при использовании онлайн-оплаты через Qiwi Кассу. В остальных случаях он создаёт неудобства для покупателей
- При настройке способов уведомления о заказах стала доступна возможность отключать для телефона покупателя строгий формат
Zion Catalog Zion Qiwi Qiwi Касса Классы Корзина для заказов Настраиваемые модули Реакции на заказ Способы оплаты
Zion WebEngine X9.12.05
- Доработан настраиваемый модуль для онлайн-оплаты через Робокассу (спасибо Чистая Магия):
- Учтено, что в тестовый сервер Робокассы возвращает не все отпавляемые ему дополнительные параметры
Zion Robokassa Robokassa Настраиваемые модули Способы оплаты
Zion WebEngine X9.12.03
- Доработан настраиваемый модуль для расчёта стоимости и срока доставки через СДЭК (спасибо Чистая Магия):
- Стало доступно указание выходных дней недели:
- Если Ваша доставка не работает, например, в субботу и/или воскресенье, то с новым параметром можно автоматически увеличить отсрочку доставки
- При отображении результата рассчёта срока и стоимости доставки вместо срока в днях от-до отображается крайняя дата доставки:
- Это связано с тем, что параметры отсрочки и выходных дней доставки никак не влияют на сам срок доставки в днях
- Стало доступно указание выходных дней недели:
Zion xDelivery Настраиваемые модули СДЭК Способы доставки/самовывоза
Zion WebEngine X9.11.25
- Доработан вспомогательный класс для работы с элементами контента (спасибо Федерация Киокусинкай Пермского края):
- Реализована возможность в качестве элементов вставлять в шаблоны не только стандартные, но и пользовательские классы:
- Пользовательские классы располагаются в отдельной папке, которая ранее игнорировалась при поиске доступных элементов
- Пользовательские классы (теперь в том числе и элементы), как и раньше имеют больший приоритет, чем стандартные
- Реализована возможность в качестве элементов вставлять в шаблоны не только стандартные, но и пользовательские классы:
- Класс, облегчающий миграцию со старых версий CMS на новые теперь совместим с версиями Zion WebEngine 3.4.2 и 3.5.1
Zion WebEngine Zion WebEngine 3.4.2 Zion WebEngine 3.5.1 Что такое CMS Zion WebEngine? Контент/Контентные единицы Миграция Шаблоны контента Элементы
Zion WebEngine X9.11.22
- Доработан плагин универсального меню (спасибо Гид по Тоскане):
- Устранены некоторые недочёты при обработке параметров:
- Например, теперь текущая страница подставляется в параметр
factor
только, если параметр не был указан при обращении к плагину:- Иначе могли отображаться не те записи, которые нужны, если указанная в
factor
запись не существует (например, была удалена)
- Иначе могли отображаться не те записи, которые нужны, если указанная в
- Например, теперь текущая страница подставляется в параметр
- Устранены некоторые недочёты при обработке параметров:
© 2005-2024 Все права защищены | Поддержку осуществляет веб-студия #webZion