- 4
-
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.12.29
- Доработан класс для миграции со старых версий CMS (спасибо С-Полимер):
- Устранены недочёты при конвертации редактируемых полей
- Реализована миграция шрифтов
Zion WebEngine Что такое CMS Zion WebEngine? Классы Миграция
Zion WebEngine 20.12.25
- Доработан элемент
Дата
:- Устранены некоторые недочёты, допущенные в предыдущем обновлении
- Доработан плагин универсального меню (спасибо Хронос Медиа):
- Добавлен новый вариант значения для параметра
include-sort
:- Со значением
sort
он позволяет все записи, добавленные через параметрinclude
, сортировать вместе со всеми другими записями в списке
- Со значением
- Добавлен новый вариант значения для параметра
Zion WebEngine Zion Pub Hub Дата/Время/TimeMashine Меню/Списки/Навигация Обновления CMS Плагины Элементы Плагин Menu
Zion WebEngine 20.12.24
- Доработан элемент
Дата
(спасибо Хронос Медиа):- Теперь обновление времени до текущего при сохранении стало опциональным:
- Если отметить соответсвующую галочку, то время не изменится
- Если галочку снять, то будет установлено текущее время (и указанная дата)
- Теперь обновление времени до текущего при сохранении стало опциональным:
- Доработан плагин
TimeMashine
:- Устранены некоторые недочёты, допущенные в предыдущем обновлении
- Доработан плагин универсального меню:
- Добавлен параметр
include-sort
:- Со значением по умолчанию
end
он добавляет все записи, перечисленные в параметреinclude
в конец списка (как и раньше) - Со значением
begin
он добавляет все записи, перечисленные в параметреinclude
в начало списка
- Со значением по умолчанию
- Добавлен параметр
Zion WebEngine Zion Pub Hub Дата/Время/TimeMashine Меню/Списки/Навигация Обновления CMS Плагины Элементы Плагин Menu
Zion WebEngine 20.12.23
- Доработан элемент
Дата
(спасибо Хронос Медиа):- Теперь под полем с датой доступна кнопка, при нажатии на которую устанавливается текущая дата:
- Её использование быстрее и удобнее, чем браузерный виджет с календарём
- Теперь под полем с датой доступна кнопка, при нажатии на которую устанавливается текущая дата:
- Создана система мониторинга для пакета Zion User Control (спасибо Новый стандарт):
- В том числе реализовано создание оформления по умолчанию для адресных уведомлений пользователям
Zion User Control Zion Pub Hub Веб-браузер Дата/Время/TimeMashine Доступы/Пользователи Мониторинг Уведомления Элементы Что такое Элементы?
Zion WebEngine 20.12.22
- Доработан плагин
TimeMashine
(спасибо Хронос Медиа):- Теперь с его помощью можно смещать заданную временную метку на любое количество годов, месяцев, дней, часов, минут, секунд:
- В том числе может быть полезно для отображение даты и времени в часовом поясе, отличающемся от часового пояса на веб-сервере
- В мастер вставки плагина
TimeMashine
также внесены изменения для отображения соответствующих подсказок по новым возможностям
- Теперь с его помощью можно смещать заданную временную метку на любое количество годов, месяцев, дней, часов, минут, секунд:
Zion WebEngine Веб-сервер/Хостинг Дата/Время/TimeMashine Плагины Помощники/Мастеры/Инструкции/Подсказки Что такое Плагины?
Zion WebEngine 20.12.14
- Доработан класс для управления контентом (спасибо Хронос Медиа):
- Доработано создание файла Sitemap.XML по умолчанию
Zion WebEngine SEO-параметры XML/RSS/1С/YML Классы Контент/Контентные единицы Как создать sitemap.xml?
Zion WebEngine 20.12.11
- Доработан класс для управления обменом сообщениями (спасибо Новый стандарт):
- Добавлены два новых плагина, упрощающие настройку списков чатов и сообщений:
chat_UsersButMe
- возвращает список ID всех участников указанного (или открытого сейчас) чата, кроме текущего пользователяchat_Name
- возвращает название указанного (или открытого сейчас) чата
- Добавлены два новых плагина, упрощающие настройку списков чатов и сообщений:
Zion Chat Доступы/Пользователи Классы Обмен сообщениями/Чат Плагины Что такое Плагины?
Zion WebEngine 20.12.10
- Доработаны класс для управления пользователями и элемент
Основной текст
(спасибо Новый стандарт):- Расширен список условий, доступных для использования в формах пользователей
- Дополнены соответствующие подсказки:
- Теперь они отображаются не под каждым полем для правки основного текста, а только под полем для правки основного текста формы пользователей
- Дополнены соответствующие подсказки:
- Расширен список условий, доступных для использования в формах пользователей
Zion WebEngine Доступы/Пользователи Классы Основной текст Помощники/Мастеры/Инструкции/Подсказки Условия Формы для пользователей Элементы Элемент "Основной текст"
Zion WebEngine 20.12.08
- Доработан класс для управления пользователями (спасибо Новый стандарт):
- Расширен список форм пользователя, в которых теперь можно использовать (и обрабатывать) данные о группе пользователя
Zion WebEngine Доступ Групп пользователей Доступы/Пользователи Классы Формы для пользователей
Zion WebEngine 20.12.06
- Доработан класс для управления пользователями (спасибо Новый стандарт):
- В форме пользователя для пополнения баланс теперь можно использовать (и обрабатывать) данные об имени пользователя и о его группе
Zion WebEngine Баланс пользователя/Абонентская плата Доступ Групп пользователей Доступы/Пользователи Классы Формы для пользователей
Zion WebEngine 20.11.27
- Доработан элемент
Число
(спасибо Феникс):- Создан новый плагин
number_IfNull
, которому можно передать параметрыvalue
(обязательно) иnullresult
(необязательно):- Если
value
- пустое/нулевое значение, то плагин вернёт то, что указано вnullresult
(по умолчанию -) - Это может быть полезно, например, для вывода списка характеристик, где нужно, например, прочерками пометить не указанные значения
- Если
- Создан новый плагин
Zion Catalog Классы Меню/Списки/Навигация Плагины Характеристики/Разновидности Элементы Что такое Плагины?
Zion WebEngine 20.11.25
- Доработан класс для управления email-сообщениями (спасибо Новый стандарт):
- Теперь в разделе
Опции \ Обратная связь
меню администратора можно увидеть не только количество неотправленных на данный момент сообщений, но и увидеть подробности о 10 сообщениях, отправка которых завершилась неудачей:- В том числе отображается информация об ошибке, что позволит оперативно её устранить
- Теперь при распределённой отправке в первую очередь отправляются более свежие сообщения, для которых пока не было сделано ни одной попытки:
- Это позволяет не задерживать "очередь" для безпроблемных сообщений из-за проблемных сообщений
- Теперь в разделе
Zion WebEngine Что такое Меню администратора? Email-сообщения Классы Меню администратора
Zion WebEngine 20.11.21
- Доработан класс для управления базой данных (спасибо Феникс):
- Устранены некоторые недочёты при правке небольших списков записей в административном интерфейсе
Zion WebEngine Что такое Административный интерфейс и Гостевой интерфейс? Административный интерфейс База данных/Таблицы данных Классы
Zion WebEngine 20.11.20
- Доработан класс для управления базой данных (спасибо Color House):
- Теперь при клонировании записей не копируются данные об ID товаров и категорий, необходимые для экспорта данных в формат YML для Яндекс.Маркет
Zion WebEngine XML/RSS/1С/YML База данных/Таблицы данных Импорт/Экспорт Категории Классы Сайт-каталог Что такое Классы?
Zion WebEngine 20.11.13
- Доработан класс для миграции со старых версий CMS (спасибо Богатый дом):
- Устранены недочёты при конвертации некоторых SEO-параметров
- Миграция теперь совместима с версией CMS 3.5
Zion WebEngine Zion WebEngine 3.5 Что такое CMS Zion WebEngine? SEO-параметры Классы Миграция
Zion WebEngine 20.11.12
- Доработаны классы для управлени контентом и шаблонами (спасибо Новый стандарт):
- Теперь при правке контента выпадающий список шаблонов сортируется более корректно (также, как в разделе
Справочники \ Шаблоны
)- Функция, отвечающая за вывод этого списка также может принимать необязательный параметр для реализации других вариантов сортировки
- Теперь при правке контента рядом с именами шаблонов и типов в соответствующих выпадающих списках отображаются их ID, что удобно при наличии записей с похожими или одинаковыми именами
- Теперь при правке контента выпадающий список шаблонов сортируется более корректно (также, как в разделе
Zion WebEngine Классы Контент/Контентные единицы Типы Шаблоны контента Что такое Шаблон контента?
Zion WebEngine 20.11.03
- Доработан класс для экспорта данных в формат YML для Яндекс.Маркет (спасибо Color House):
- Устранены недочёты при передаче в Яндекс.Маркет информации о подарках, которые могут быть получены при покупке того или иного товара
Zion Export XML/RSS/1С/YML Импорт/Экспорт Классы Сайт-каталог Что такое Классы?
Zion WebEngine 20.11.01
- Доработаны классы для экспорта данных в формат YML для Яндекс.Маркет и для управления базой данных (спасибо Color House):
- Теперь в Яндекс.Маркет можно отправлять информацию не только о товарах, но и о подарках, которые могут быть получены при покупке того или иного товара:
- В более новых версиях данная возможность будет расширена дополнительным функционалом
- Теперь в Яндекс.Маркет можно отправлять информацию не только о товарах, но и о подарках, которые могут быть получены при покупке того или иного товара:
Zion WebEngine Zion Export XML/RSS/1С/YML База данных/Таблицы данных Импорт/Экспорт Классы Обновления CMS Сайт-каталог
Zion WebEngine 20.10.31
- Доработан класс для экспорта данных в формат YML для Яндекс.Маркет (спасибо Color House):
- Завершена реализация отправки данных о товарах в Яндекс.Маркет
- Разработка завершена, но в ближайших обновлениях доработка продолжится:
- Данный функционал доступен только при наличии в комплекте поставки Zion Export
Zion Export Что такое Комплект поставки? XML/RSS/1С/YML Импорт/Экспорт Классы Обновления CMS Сайт-каталог
Zion WebEngine 20.10.30
- Доработаны классы для экспорта данных в формат YML для Яндекс.Маркет и для управления базой данных (спасибо Color House):
- Запрещено изменение некоторых полей в таблице данных контента для того, чтобы идентификаторы товаров и категорий всегда оставались одними и теми же для соблюдения требований Яндекс.Маркет
- Разработка пока не завершена
Zion WebEngine Zion Export XML/RSS/1С/YML База данных/Таблицы данных Импорт/Экспорт Категории Классы Контент/Контентные единицы Сайт-каталог Как редактировать Контент?
© 2005-2024 Все права защищены | Поддержку осуществляет веб-студия #webZion