Плагин Menu

19.01.2024

Для чего нужен плагин Menu

С его помощью можно формировать автоматические меню и списки. Это может быть и меню для навигации по сайту, и список новостей, список сообщений в чате, список товаров в заказе. Что угодно.

Где хранится плагин Menu

В папке plugins, в файле menu.php.

Если хотите внести какие-либо изменения в код этого плагина, то перенесите его в папку plugins/custom - так он не будет заменён стандартным плагином в случае обновления CMS.

Как создать и оформить меню или список

В меню администратора выберите Навигация \ Варианты оформления меню.

При правке меню увидите несколько полей, их названия, подсказки по использованию доступных свойств и условий.

Доступные поля:

  • ID - идентификатор меню. Нечто уникальное. Его можно указать при создании меню. В дальнейшем его не изменить.
  • Название - ни на что не влияет. Но лучше создавайте такие названия, которые будут понятны Вам. Может существовать несколько меню с одинаковыми названиями, но лучше так не делать. Название можно изменить в дальнейшем.
  • Несколько полей для указания HTML-кода различных частей меню. От этих полей зависит, как будет выглядеть меню.

HTML-код меню

Если Вы не разбираетесь в HTML, то лучше самостоятельно не вносите здесь изменения.

Поля для HTML-кода можно разбить на 3 вида:

  • Основное оформление
  • Альтернативное оформление
  • Оформление пагинации

Основное оформление

В поле HTML-код до меню можно указать начало оформления, а в поле HTML-код после меню - конец оформления меню. Например, это теги ul, navdiv или table.

Список или меню может состоять из одного или нескольких блоков. Если Вы разделение на блоки не планируете, то предполагается, что блок будет один. Если используете табличную вёрстку, то, в полях HTML-код до блока и HTML-код после блока могут быть указаны, например, теги tr.

Можно также заполнить поле HTML-код между блоками. Если блок будет всего один, то то, что здесь указано, выведено не будет, что следует из названия поля...

Остались поля для записей (элементов списка или меню):

  • HTML-код обычной записи - здесь могут быть указаны, например, теги li или td, а также свойства записей, например {content_name}. Это поле одинаково доступно для всех типов меню и списков.
  • HTML-код активной записи - аналогичное по смыслу поле, но оформление из него используется вместо оформления из предыдущего поля только для активной записи (а также для надразделов активной записи). Если речь идёт о меню страниц, то здесь Вы можете указать, как должна выглядеть в меню открытая в данный момент страница (или надраздел открытой в данный момент страницы). Для некоторых типов меню это поле недоступно (так как не все типы можно открыть), а для некоторых типов меняется смысл данного поля. Например, если мы отображаем список пользователей, то здесь можно задать оформление текущего пользователя. Если речь идёт о списке чатов, то здесь можно задать оформление чатов с непрочитанными сообщениями. А если речь идёт о списке сообщений в чате, то здесь можно задать оформление непрочитанных сообщений.
  • HTML-код между записями - если в меню будет всего одна запись, то то, что здесь указано, выведено не будет, что следует из названия поля...

Альтернативное оформление

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

Оформление пагинации

Список может быть разделён на подстраницы (например, 100 товаров, могут быть разбиты на 5 страниц по 20 товаров). Для оформления отображения списка из номеров подстраниц (это часто называется "пагинацией") также есть несколько полей. Они аналогичны тем, что используются для основного оформления, но без разделения на блоки:

  • HTML-код до списка подстраниц и HTML-код после списка подстраниц - например, теги p
  • HTML-код обычного элемента списка подстраниц и HTML-код активного элемента списка подстраниц - например, теги a и свойства подстраниц, вроде {menu_subpage} (номер подстраницы) и {menu_subpage_url} (URL подстраницы)
  • HTML-код между элементами списка подстраниц - будет использоваться только, если подстраниц более, чем одна.

Как отобразить меню или список с нужными параметрами

Для того, чтобы вставить меню в HTML-код веб-страницы или в любое другое место, нужно сформировать команду для вызова плагина.

По умолчанию команда вызова такая: {plugin:menu}

Но такая команда результата не даст, так как не заданы (в том числе обязательные) параметры.

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

Одна пара имя:значение от другого аналогичной пары отделяется точкой с запятой ;

От имени плагина параметры также отделяются точкой с запятой

Пример:

У нас есть два параметра. У первого название par1, а значение test. У второго название param2, а значение yahoo

Команда вызова плагина при этом будет такая {plugin:menu;par1:test;param2:yahoo}.

Некоторые параметры могут быть обязательными. Некоторые параметры могут быть (не)доступны или изменены при определённых значениях других параметров.

Для некоторых параметров доступны значения по умолчанию. Параметры со значениями по умолчанию можно не указывать.

Параметры плагина Menu

В старых версиях CMS набор доступных параметров и доступных значений может отличаться. Если Ваша CMS устарела, то рекомендуется обновить её до самой свежей версии.

Также на набор параметров и значений может влиять комплект поставки.

Имя параметра Значение параметра и комментарии
id

ID одного из вариантов оформления меню, которые можно найти в разделе меню администратора Навигация \ Варианты оформления меню.

Это обязательный параметр. Без него плагин вернёт пустой результат.

blocks

Количество блоков, на которые нужно разбить меню.

По умолчанию: 1.

Допускаются целые положительные числа.

inblock

Количество элементов в блоке.

Допускаются целые положительные числа.

Доступен, если не задан blocks.

fixblocks

Фиксировать ли блоки.

Доступны только следующие варианты:

  • on - фиксировать (по умолчанию)
  • off - не фиксировать

Влияет на выравнивание коротких меню: например, если в списке всего 4 записи и inblock:3, то при fixblocks:off в обоих блоках будет по 2 записи, а при fixblocks:on в первом блоке будет 3 записи, а во втором 1.

types

Список типов записей, которые нужно отобразить.

По умолчанию - все типы контента.

Если нужно отобразить записи только некоторых типов, то ID типов нужно указать через запятую. Список доступных типов можно найти в разделе меню администратора Справочники \ Типы. Этот раздел доступен только при наличии в комплекте поставке Zion Pub Hub или Zion Catalog.

Также доступны следующие варианты, которые нельзя перечислять через запятую (только один из вариантов, несочетающийся ни с одним другим вариантом):

  • tabs - Вкладки (доступен при наличии в комплекте поставки ZIon Catalog)
  • elements - Элементы (доступен при наличии в комплекте поставки ZIon Catalog)
  • langs - Языки (доступен только наличии в комплекте поставки ZIon Multi-Lang)
  • delivery - Способы доставки (доступен при наличии в комплекте поставки ZIon Catalog)
  • transcomp - Транспортные компании (доступен при наличии в комплекте поставки ZIon xDelivery)
  • payment - Способы оплаты (доступен при наличии в комплекте поставки ZIon Catalog)
  • orders - Заказы активного пользователя (доступен при наличии в комплекте поставки ZIon Catalog)
  • inorders - Товары в заказе активного пользователя (доступен при наличии в комплекте поставки ZIon Catalog)
  • users - Зарегистрированные пользователи (доступен при наличии в комплекте поставки ZIon User Control)
  • balans - История баланса активного пользователя (доступен при наличии в комплекте поставки ZIon Catalog и Zion User Control)
  • chats - Чаты активного пользователя (доступен при наличии в комплекте поставки ZIon Chat)
  • inchats - Сообщения в чате активного пользователя (доступен при наличии в комплекте поставки ZIon Chat)

Несочетающиеся значения не доступны при select:last.

select

Указание на то, по какому принципу нужно выбирать записи, которые будут отображаться в меню.

Может быть заполнено значением из переменной GET[select]. При этом обязательно должна присутствовать переменная GET[menu], равная значению параметра id.

Для отображения контентных единиц доступны варианты:

  • children - "потомки" - непосредственные подразделы, указанного в factor раздела (по умолчанию)
  • children-all - "все потомки" - все подразделы, указанного в factor раздела (если все подразделы имеют один и тот же тип, то для крупных сайтов рекомендуется использовать не children-all, а all с указанием нужных типов в types - это сильно снизит нагрузку на БД)
  • all - все записи с учётом других параметров фильтрации (это рекомендуемая замена для варианта children-all, который может сильно снижать производительность на крупных сайтах)
  • brothers - "братья" - записи с тем же место в структуре, что и указанный в factor раздел
  • parents - "предок и его братья" - надраздел, указанного в factor раздела и указанного в level уровня, а также другие разделы с тем же местом в структуре
  • path - "путь" - список надразделов от верхнего уровня в структуре до указанного в factor раздела (полезно, например, для создания так называемых "хлебных крошек")
  • linked - "связи" - только те записи, с которыми связана указанная в factor запись
  • backlinks - "обратные связи" - только те записи, которые связаны с указанной в factor записью
  • link4user - "свяанные с пользователем" - только те записи, с которыми связан указанный в factor пользователь
  • list - "список" - только те записи, ID которых перечислены через запятую в include
  • last - "последние" - последние записи, просмотренные данным посетителем сайта (в этом режиме сортировка всегда ведётся от последней просмотренной записи к первой)
  • basket - "корзина" - только те записи, которые помещены в корзину для заказов (доступен только при наличии в комплекте поставки ZIon Catalog)

Для отображения вкладок доступны варианты (при наличии в комплекте поставки ZIon Catalog):

  • all - все вкладки
  • linked - "связи" - только те вкладки, на которых есть элементы указанной в factor контентной единицы (по умолчанию)
  • list - "список" - только те вкладки, ID которых перечислены через запятую в include

Для отображения элементов контента доступны варианты (при наличии в комплекте поставки ZIon Catalog):

  • all - все элементы контента, в том числе и недоступные для указанной в factor контентной единицы (рекомендуется для организации сравнения)
  • linked - "связи" - все элементы контента, доступные для указанной в factor контентной единицы (по умолчанию)
  • ontabs - "на вкладках" - только те элементы контента, которые расположены на указанных в tabs вкладках указанной в factor контентной единицы
  • list - "список" - только те элементы контента, ID которых перечислены через запятую в include

Из списка элементов автоматически исключается  htmlsource (HTML-код веб-страницы). Чтобы исключить зацикливание, следует в include указывать те элементы, из которых может производится вызов плагинов, например, maintext (Основной текст).

Для отображения языков доступен вариант (при наличии в комплекте поставки ZIon Multi-Lang):

  • all - все доступные языки (по умолчанию)

Для отображения пользователей доступны варианты (при наличии в комплекте поставки ZIon User Control):

  • all - все пользователи (по умолчанию)
  • list - "список" - только те пользователи, ID которых перечислены через запятую в include

Для отображения истории баланса доступен вариант (при наличии в комплекте поставки ZIon Catalog и Zion User Control):

  • all - все изменения

Для отображения способов доставки доступен вариант (при наличии в комплекте поставки ZIon Catalog):

  • all - все доступные способы доставки

Для отображения транспортных компаний доступен вариант (при наличии в комплекте поставки ZIon xDelivery):

  • all - все доступные траспортные компании

Для отображения способов оплаты доступен вариант (при наличии в комплекте поставки ZIon Catalog):

  • all - все доступные способы оплаты

Для отображения списка чатов доступны варианты (при наличии в комплекте поставки ZIon Chat):

  • all - все чаты активного пользователя (по умолчанию)
  • new - только чаты активного пользователя, в которых есть непрочитанные сообщения

Для отображения сообщений в чате доступны варианты (при наличии в комплекте поставки ZIon Chat):

  • all - все сообщения из указанного в factor чата (по умолчанию)
  • new - только непрочитанные сообщения из указанного в factor чата
search

Если этот параметр задан, то производится поиск указанного в данном параметре текста

Рекомендации:

  • select - в большинстве случаев должен быть равен all, но доступны и другие варианты
  • factor - желательно явно указать
  • чтобы автоматически подставить в search или в любое другое место искомый текст, используйте команду {plugin:current_SearchText}

Не доступен при несочетающихся вариантах types.

Не доступен при select:path и при select:list.

search-cols

Указание на то, в каких столбцах производить поиск.

Поля отделяются друг от друга запятыми, (без пробелов и других символов)

Если в подсказке к полю указано {content_name}, то здесь укажите name и т.п.

Список полей проверяется. Некорректные исключаются. Если после проверки не останется ни одного корректного поля, то будет подставлено значение по умолчанию:
id,name,seo_title,seo_description,seo_keywords,maintext_value = ID, название, основные SEO-параметры, основной текст

Доступно при непустом search.

bigdata

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

  • Для небольших списков лучше не использовать, так как эффект от оптимизации может быть обратным

Доступны только следующие варианты:

  • on - оптимизировать
  • off - НЕ оптимизировать (по умолчанию)

При types:elements всегда равно on

Не доступен при types:tabs и при types:users

level

Уровень, разделы которого нужно вывести.

Доступен при select:parents.

По умолчанию - 0 - непосредственный надраздел и его "братья"

Допускаются целые числа

Если level больше уровня раздела, указанного в factor, то select:parents меняется на select:children, а factor становится равным ID "предка" уровня (level-1)

factor

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

Доступны следующие варианты:

  • ID любого раздела, например factor:contacts (при select:children отобразит подразделы такого раздела)
  • . (например, factor:.)
    • "верхний уровень" - при select:children отобразит все разделы, для которых место в структуре равно (верхний уровень)
  • Пустое значение (например, factor:)
    • "вне структуры" - при select:children отобразит все разделы, для которых место в структуре равно (вне структуры)
  • По умолчанию - ID открытого в данный момент раздела
  • При types:inorders - ID заказа (может принимать значения из GET[order]). Данный заказ должен быть доступен для текущего пользователя (и для администраторов). Возможно при наличии в комплекте поставки ZIon Catalog.
  • При types:inchats - ID чата (может принимать значения из GET[chat]). Данный чат должен быть доступен для текущего пользователя (иначе будет произведена переадресация на список чатов). Возможно при наличии в комплекте поставки ZIon Chat.

Также доступен вариант {content_id} - автоматически подставляемое ID раздела.

Если вызов плагина Menu производится из HTML-кода веб-страницы или из любого другого элемента данной контентной единицы, то вместо {content_id} будет подставлено ID данной контентной единицы.

Если вызов плагина Menu вызывается также из плагина Menu (например, если в надменю нужно вызвать подменю, то для вызова подменю указывайте factor:{content_id}). В этом случае соответствующее ID контентной единицы будет подставлено для каждого пункта надменю.

Доступно использование любых других свойств (не только контента)

fellLinks

При любом непустом значении будет выделять, как активные, те записи, которые связаны с открытой записью.

Внимание! Так как активными (а также следующими после активных и предыдущими для активных) в этом случае могут считаться сразу несколько записей, порядок которых заранее неизвестен, использование данного параметра может привести к одновременному и многократному срабатыванию условий IS_NEXT??истина::ложь и IS_PREV??истина::ложь, что невозможно во всех других случаях. Используйте данный параметр с данными условиями на свой страх и риск!
tabs

ID вкладок, перечисленные через запятую, для указанной в factor контентной единицы, для которой нужно отобразить список элементов контента.

Это обязательный параметр при types:elements;select:ontabs

Доступен при types:elements и select:ontabs.

hidden

Указание на то, стоит ли отображать скрытые записи.

  • Скрытыми контентными единицами считаются записи без адреса.
  • Скрытыми элементами контента считаются записи с пустым, нулевым или незаполненным значением.

Доступны следующие варианты:

  • show - показывать
  • hide - скрывать (по умолчанию)
При types:elements доступен, если select:ontabs или select:list. При select:list, если например в include указаны stringfield_5,number_3, то на заполненность будут проверяться поля stringfield_5_value и number_3_value - то есть поля, имена которых заканчиваются на _value.
include

Список ID записей, которые нужно добавить в меню.

При указании этого параметра в меню будут включены дополнительные пункты (если они существуют).

При отсутствии значения оно может быть заполнено значением из переменной GET[include]. При этом обязательно должна присутствовать переменная GET[menu], равная значению параметра id.

Если эти пункты уже есть в меню, дублирование не произойдёт.

Недоступен при types:orderstypes:inorderstypes:balans, types:chats и types:inchats.

Это обязательный параметр при select:list.

По умолчанию записи, добавленные через include, добавляются в конец списка. Чтобы это изменить, используйте параметр include-sort со значением, отличающимся от значения по умолчанию.

exclude

Список ID записей, которые нужно исключить из меню.

На этот параметр влияют ограничения прав доступа: в него добавляется список всего, к чему нет доступа у текущего пользователя или его группы.

Этот параметр имеет больший приоритет по сравнению с include.

notzero

Отображать только записи с ненулевыми значениями в указанном поле

Например:

  • notzero:stringfield_15_value - будут показаны только записи, у которых в поле stringfield_15_value не равно 0

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

positive

Отображать только записи с положительными значениями в указанном поле

Например:

  • positive:number_10_value - будут показаны только записи, у которых в поле number_10_value больше 0

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

checked

Отображать только записи, у которых отмечена соответсвущая галочка

Например:

  • checked:checkbox_23_value - будут показаны только записи, у которых в поле checkbox_23_value равно on (отмечено)

Можно использовать не только для галочек, но и для любых полей, где может быть значение on.

cookie

Имя массива куков

Список элементов из этого массива будет добавлен к include.

Доступен при select:list.

hidecopies

Имя массива куков, в котором должны храниться имена контентных единиц, для которых нужно скрывать те элементы, значения которых не отличаются от значений тех же элементов у других контентных единиц в том же массиве (полезно для реализации, например, сравнения товаров)

Игнорируется, если в этом массиве есть только один элемент

Доступен при types:elements.

inlist

Максимальное количество записей, которые нужно вывести в списке.

По умолчанию - 0 - все найденные записи

Допускаются целые неотрицательные числа

listing

Указание на то, стоит ли отображать список подстраниц

Доступны следующие варианты:

  • show - всегда показывать
  • hide - всегда скрывать
  • auto - скрывать, если нет необходимости отображать (по умолчанию)

В режиме auto будет отображаться только, если подстраниц больше, чем одна. Иначе будет скрываться.

subpage

Номер активной подстраницы

При отсутствии значения оно может быть заполнено значением из переменной GET[subpage]. При этом обязательно должна присутствовать переменная GET[menu], равная значению параметра id.

По умолчанию - 1 - первая подстраница

Допускаются целые положительные числа

maxsubpages

Максимально допустимое количество подстраниц в пагинации

При отсутствии или при некорректном значении отображаются все подстраницы.

Допускаются целые положительные числа

random

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

По умолчанию - 0 - не использовать случайную выборку, а отобразить все элементы в обычном порядке.

Допускаются целые неотрицательный числа

userbrowser

Веб-браузер посетителя, под который должна быть сделана оптимизация.

Если не указан (по умолчанию), то браузер определяется автоматически.

Доступны только следующие варианты:

  • Opera - классический Opera
  • Chrome - Google Chrome или другой браузер на движке Chromium (в т.ч. Яндекс.Браузер и новые Opera и Edge)
  • Internet Explorer - Microsoft Internet Explorer или другой браузер на движке Trident
  • Firefox - Mozilla Firefox или другой браузер на движке Gecko
  • Safari - Apple Safati или другой браузер на движке WebKit
  • Other - другой браузер
content-type

Позволяет изменить тип контента в заголовках, передаваемых веб-сервером.

По умолчанию передаётся тип контента text/html

Внимание: при указании альтернативного типа контента, дробную черту / нужно менять на дефис -

Например:

  • application-xml - если нужен тип контента application/xml
charset

Позволяет изменить набор (кодировку) символов в заголовках, передаваемых веб-сервером.

По умолчанию передаётся кодировка windows-1251

Внимание: кодировка применяется ко всему выводимому контенту! Помимо указания заголовка производится конвертация из кодировки windows-1251 в кодировку, указанную в данном параметре!

При content-type:application-xml рекомендуется использовать кодировку utf-8

filter

Использовать ли фильтр.

Доступны следующие варианты:

  • on - использовать
  • off - не использовать (по умолчанию)

При on можно использовать массив переменных GET[filter]. Например, если в адресной строке указано...?filter[name]=Тест&filter[type]=pages..., то из найденных с помощью других параметров записей в списке будут отображены только записи, у которых поле name равно значению Тест, а поле type равно значению pages.

Если нужна проверка не на равенство, а на соответствие другим условиям, то дополнительно нужно использовать массив переменных GET[filterFunc], В котором имена переменных должны быть такими же, как в GET[filter], а значения должны соответствовать одной из функций сравнения. Например, если в адресной строке указано...?filter[price]=100&filterFunc[price]=more..., то из найденных с помощью других параметров записей в списке будут отображены только записи, у которых поле price больше значения 100.

Доступны следующие функции:

  • equal - равно (по умолчанию)
  • !equal - неравно - больше или меньше
  • more - больше
  • less - меньше
  • !more - не больше - меньше или равно
  • !less - не меньше - больше или равно
  • between - между - больше, чем одно значение, и меньше, чем другое значение. При этом в GET[filter] должны быть указаны два значения, через ;. Например, ...?filter[price]=100;500&filterFunc[price]=between...
  • range - диапазон - равно или больше, чем одно значение, и равно или меньше, чем другое значение. При этом в GET[filter] должны быть указаны два значения, через ;. Например, ...?filter[price]=100;500&filterFunc[price]=range...
  • substring - подстрока (например, в строке розовый слон будет найдена подстрака слон или подстрока роз и т.п.)

Не доступен при types:tabs и types:elements.

Не доступен при select:list, select:all, select:new и select:path.

Количество элементов в массиве GET[filter] не ограничено, но многие веб-серверы и веб-браузеры не (корректно) выполняют очень длинные GET-запросы.

datefrom_...

Показывать только записи с датой равной или более поздней, чем указанная временная метка.

У одной контентной единицы может быть несколько полей с датой. У каждого такого поля есть свой номер. Возможна фильтрация по любому из них - достаточно просто указать его номер вместо ...

Пример временной метки текущего времени (29.03.2024 02:38:23): 1711669103

По умолчанию - 0 - отображать все записи.

Не доступен при select:path и select:list.

Не доступен при несочетающихся вариантах types.

dateto_...

Аналогично datefrom_... - показывать только записи с датой равной или более ранней, чем указанная временная метка.

По умолчанию - 0 - отображать все записи.

Не доступен при select:path и select:list.

Не доступен при несочетающихся вариантах types.

year_...

Показывать только записи с датой в указанном году.

У одной контентной единицы может быть несколько полей с датами. У каждого такого поля есть свой номер. Возможна сортировка по любому полю с датой - достаточно просто указать его номер вместо ...

По умолчанию - 0 - отображать все записи.

year_... имеет больший приоритет, чем datefrom_... и dateto_... - по сути переопределяет оба эти параметра.

Не доступен при select:path и select:list.

Не доступен при несочетающихся вариантах types.

month_...

Показывать только записи с датой в указанном месяце.

По умолчанию - 0 - отображать все записи.

Если при наличии этого параметра параметр year_... пуст, то ему будет присвоен текущий год.

Не доступен при select:path и select:list.

Не доступен при несочетающихся вариантах types.

day_...

Показывать только записи с датой в указанном дне месяца.

По умолчанию - 0 - отображать все записи.

Если при наличии этого параметра параметр month_... пуст, то ему будет присвоен текущий месяц.

Не доступен при select:path и select:list.

Не доступен при несочетающихся вариантах types.

sort

Указание на то, как следует сортировать найденные записи.

Доступны следующие варианты:

  • id - сортировать по ID (недоступно при types:inchats)
  • -id - сортировать по ID в обратном порядке (недоступно при types:inchats)
  • name - сортировать по названию (недоступно при types:balans, types:orders, types:chats и types:inchats)
  • -name - сортировать по названию в обратном порядке (недоступно при types:balans, types:orders, types:chats и types:inchats)
  • date - сортировать по дате (доступно при types:balans, types:chats или types:inchats)
  • -date - сортировать по дате в обратном порядке (доступно при types:balans, types:chats или types:inchats)
  • fields - сортировка по указанному в sort-fields списку полей
  • none - сортировать на основе положения в базе данных (по умолчанию)
  • -none - сортировать на основе положения в базе данных в обратном порядке (рекомендуется для новостей, статей и т.п.)

При select:linked и select:backlinks доступны варианты сортировки по возрастанию по следующим столбцам из таблицы связей:

  • id - ID связи
  • fromid - ID связывающейся записи
  • toid - ID связываемой записи
  • reason - причина связи
  • info - информация о связи
  • price - цена связи
  • description - описание связи

Также доступна сортировка контента по полям с датой (при наличии в комплекте поставки ZIon Pub Hub):

У одной контентной единицы может быть несколько полей с датой. У каждого такого поля есть свой номер. Возможна сортировка по любому из них - достаточно просто указать его номер в команде sort:date_... или sort:-date_... (в обратном порядке).

Если сортировка по дате недоступна, то sort:date_... будет изменено на sort:none, а sort:-date_... будет изменено на sort:-none, где ... - любой доступный номер поля с датой.

Аналогично выше описанной сортировке по датам возможна сортировка по датам, как ежегодных событий (при наличии в комплекте поставки ZIon Pub Hub):

Полезно, например, для отображения дней рождения или других праздников

В этом случае в место sort:date_... нужно написать sort:yearly_..., где ... - любой доступный номер поля с датой. Такая сортировка в обратном порядке не предусмотрена.

Значение данного параметра может быть изменено на значение из COOKIE[sort][ID меню], где ID меню равно значению параметра id.

В свою очередь в COOKIE[sort][ID меню] значение может быть записано, если одновременно в GET[sort] указано какое-либо корректное значение, а в GET[menu] указано значение параметра id.

Значение в COOKIE[sort][ID меню] будет сброшено, если одновременно в GET[sort] указано пустое значение, а в GET[menu] указано значение параметра id. При этом параметр sort будет изменён на значение по умолчанию.

Любая сортировка не доступна при select:path, select:list, select:last и types:elements.

По умолчанию записи, добавленные через include, добавляются в конец списка. Чтобы это изменить, используйте параметр include-sort со значением, отличающимся от значения по умолчанию.

include-sort

Сортировать или нет записи, добавленные через include

Доступны только следующие варианты:

  • begin - записи будут добавлены в начало списка в том порядке, в котором они указаны в include
  • end - записи будут добавлены в конец списка в том порядке, в котором они указаны в include (по умолчанию)
  • sort - записи, указанные в include, будут отсортированы также, как все остальные записи в списке

Любая сортировка не доступна при select:path, select:list, select:last и types:elements.

sort-fields

Указание на то, по каким полям необходимо сортировать список.

Доступно указание нескольких полей через запятую, например, name,stringfield_2_value,nubmer_5_value. Порядок полей имеет значение.

Если в подсказке к полю указано {content_name}, то здесь укажите name и т.п.

Поля, которых в таблице данных нет, будут исключены из данного списка. Если список полей для сортировки после проверки окажется пустым, то параметр sort будет изменён на значение по умолчанию.

Если нужна сортировка в обратном порядке по тому или иному полю, то перед его названием нужно указать символ -. Например, -nubmer_5_value.

Значение данного параметра может быть изменено на значение из COOKIE[sort-fields][ID меню], где ID меню равно значению параметра id.

В свою очередь в COOKIE[sort-fields][ID меню] значение может быть записано, если одновременно в GET[sort-fields] указано какое-либо корректное значение, а в GET[menu] указано значение параметра id.

Значение в COOKIE[sort-fields][ID меню] будет сброшено, если одновременно в GET[sort-fields] указано пустое значение, а в GET[menu] указано значение параметра id. При этом параметр sort будет изменён на значение по умолчанию.

sort-numbers

 

Указание на то, какие поля при сортировке нужно считать числами.

Без использования этого параметра в некоторых случаях в результате сортировки вместо списка вида, 1, 2, 3, 10, 20, 100 может получиться список вида 1, 10, 100, 2, 20, 3.

Доступно указание нескольких полей через запятую, например, name,

stringfield_2_value,nubmer_5_value. Порядок полей имеет значение.

Если в подсказке к полю указано {content_name}, то здесь укажите name и т.п.

Учитывается при использовании sort-fields.

reason

При установлении связи между контентными единицами можно указать (выбрать из списка или добавить) причину связи.

Использование этого параметра позволяет отобразить связанные записи только с указанной причиной связи.

Помимо указания одной из причин также доступны следующие варианты:

  • !exists - будут отображены только те связи, для которых указана любая (не "пустая") причина
  • !notexists - будут отображены только те связи, для которых причина не указана (указана "пустая" причина)
  • Пустое или не указанное значение (по умолчанию) - будут отображены все связи с учётом других параметров фильтрации.

Доступен при select:linked и select:backlinks и только для списков контента


CMS Zion WebEngine является бесплатной системой. Развивается за счёт рекламы, помощи ООО "Зион" и других спонсоров.

 

Будем рады, если Вы поддержите нас любой суммой, а также поделитесь идеями на счёт каких-либо улучшений и доработок для CMS...

 

Заранее, большое, спасибо

 

Блог обновлений

Zion WebEngine X8.05.21
  • Доработан класс для управления связями между записями:
    • Повышена совместимость с PHP 7.2.1

Zion WebEngine PHP Классы Связи

Zion WebEngine X8.05.19
  • Доработан класс для управления куки-массивами:
    • Повышена совместимость с PHP 7.2.1

Zion WebEngine PHP Вкладки Куки

Zion WebEngine X8.05.18
  • Улучшена совместимость с PHP 7.2.1:
    • Доработан плагин галереи (спасибо Polarus)
    • Доработан плагин универсального меню (спасибо Единый Центр Недвижимости)
    • Доработан класс для управления категориями

Zion WebEngine Zion Gallery PHP Галереи/Слайды Категории Классы Меню/Списки/Навигация Плагины

Zion WebEngine X8.05.17
  • Доработан класс для управления email-сообщениями:
    • Переработан алгоритм вывода уведомлений об ошибках
  • Доработан класс для управления навигацией:
    • Переработаны многие меню/списки по умолчанию, связанные с заказами в интернет-магазине
  • Завершено тестирование использования различных способов доставки и оплаты:
    • Доработаны классы для управления корзиной и для управления способами доставки

Zion WebEngine Zion Catalog Zion Mail Back Email-сообщения Интернет-магазин Классы Корзина для заказов Меню/Списки/Навигация Способы доставки/самовывоза Способы оплаты Уведомления

Zion WebEngine X8.05.16
  • Доработан класс для управления email-сообщениями (спасибо Moto-Retail18):
    • В случае, если по какой-либо причине сообщение через SMTP не удалось отправить с первой попытки, попытка повторяется:
      • Пауза перед каждой следующей попыткой увеличивается (полезно для проблем, которые устраняются автоматически, но не моментально)
      • После десятой неудачной попытки SMTP-отправки выводится уведомление с предложением связаться другим способом (полезно, для проблем, которые не устраняются автоматически):
        • В зависимости от того, есть ли в комплекте поставки онлайн-консультант, и включен ли он, могут выводиться разные предложения (например, написать в чат)
        • Также дополнительно производится попытка оправить сообщение через php-функцию mail
  • Доработан класс для управления корзиной заказов:
    • Улучшена форма заказа
    • Подсчёт стоимости заказа лучше учитывает стоимость доставки
  • Доработан класс для управления способами доставки:
    • Доработано несколько имеющихся и создано несколько новых функций
  • Доработан класс для управления модулем расчёта стоимости и срока доставки через СДЭК:
    • Устранены некоторые недочёты
    • Испытания и разработка продолжаются
  • Доработан класс для управления навигацией:
    • Внесены коррективы в некоторые меню по умолчанию, связанные с оформлением заказа в интернет-магазин

Zion WebEngine Zion Catalog Zion Mail Back Zion xDelivery Email-сообщения PHP SMTP/PHP-mail Интернет-магазин Классы Корзина для заказов Меню/Списки/Навигация Настраиваемые модули Онлайн-консультант СДЭК Способы доставки/самовывоза Уведомления Формы

Zion WebEngine X8.05.15
  • Доработан класс для управления способами оплаты:
    • Устранена вероятность раскрытия конфиденциальных данных при неумелом формировании списка способов оплаты
    • Реализована возможность отключения временно ненужных способов оплаты (вместо их удаления)
  • Доработан класс для управления модулем оплаты через Robokassa:
    • Устранены опечатки в инструкции
  • Доработан класс для управления базой данных:
    • Устранена вероятность несохранения некоторых типов данных
  • Доработан плагин универсального меню:
    • Реализована возможность отображать список только доступных способов доставки и отплаты (отключенные выводиться не будут)
    • Реализован новый функционал в списке способов доставки по умолчанию
  • Создан новый пакет Zion ExpressDelivery:
    • Начата разработка набора компонентов для расчёта стоимости и сроков, а также оформления доставки из интернет-магазина в режиме on-line
    • В комплект поставки включён нативный класс для расчёта стоимости и сроков доставки от СДЭК
    • Создан класс для управления доставкой через СДЭК
      • Реализована возможность автоматически корректировать структуру базы данных при необходимости
      • Реализованы правка и сохранение параметров:
        • Тариф и режим доставки
        • Отсрочка в днях
        • Индекс отправителя
        • Вес и габариты товаров по умолчанию
        • Данные авторизации
      • Создана краткая инструкция
      • Ведутся испытания в боевом режиме
  • Доработан класс для управления способами доставки:
    • Устранена вероятность раскрытия конфиденциальных данных при неумелом формировании списка способов доставки
    • Дополнен список способов доставки по умолчанию
    • Реализована возможность подключать и настраивать модули различных систем доставки
    • Реализована возможность отключения временно ненужных способов доставки (вместо их удаления)
  • Доработан класс для управления вкладками:
    • Добавлены некоторые особые возможности для управления модулями систем доставки
  • Доработан драйвер для управления классами:
    • Теперь при отсутствии запрашиваемого класса работа системы не останавливается.
    • Уведомление по-прежнему выводится, но в другом формате
  • Доработан класс для управления куки-массивами:
    • Расширен функционал
  • Доработан класс для управления корзиной заказов:
    • Форма заказа теперь динамически реагирует на данные покупателя и показывает данные о стоимости и сроке доставки

Zion WebEngine Zion Catalog Zion xDelivery Zion Robokassa Robokassa База данных/Таблицы данных Вес и габариты Вкладки Драйверы Интернет-магазин Классы Корзина для заказов Куки Меню/Списки/Навигация Настраиваемые модули Плагины Помощники/Мастеры/Инструкции/Подсказки СДЭК Способы доставки/самовывоза Способы оплаты Уведомления Формы

Zion WebEngine X8.05.14
  • Завершён перевод пакета Zion Robokassa на новую платформу:
    • Доработана графическая составляющая пакета
    • Улучшен редактор параметров
    • Создана инструкция по заданию параметров
    • Реализованы новые плагины и обработчики
    • Устранены все архаизмы от старой платформы
  • Доработан класс для управления навигацией:
    • Устранены недочёты в меню товаров в заказе по умолчанию
  • Доработан класс для управления способами доставки:
    • Расширен функционал
  • Доработан класс для управления корзиной заказов:
    • Реализована подключение модулей оплату тогда, когда это необходимо
  • Доработан класс для управления способами оплаты:
    • Скорректирован список записей, доступных по умолчанию

Zion WebEngine Zion Catalog Zion Robokassa Robokassa Классы Корзина для заказов Меню/Списки/Навигация Настраиваемые модули Обработчики Плагины Платформа Помощники/Мастеры/Инструкции/Подсказки Способы доставки/самовывоза Способы оплаты

Zion WebEngine X8.05.13
  • Доработан класс для управления контентом:
    • Внедрены некоторые удобства при правке контента
  • Доработано меню администратора для сайта-каталога и интернет-магазина:
    • Способы доставки и оплаты по умолчанию теперь создаются до входа в соответствующие разделы
  • Доработано управление способами оплаты:
    • Реализована возможность подключать и настраивать модули различных платёжных систем
  • Доработан класс для управления вкладками:
    • Добавлены некоторые особые возможности для управления модулями платёжных систем
  • Начат перевод пакета Zion Robokassa на новую платформу:
    • Создан модуль для платёжной системы Robokassa
      • Реализовано задание параметров
      • Реализована инструкция по настройке
      • Реализована автоматическая корректировка структуры базы данных
      • Разработка ещё не завершена

Zion WebEngine Zion Catalog Zion Robokassa Robokassa База данных/Таблицы данных Вкладки Интернет-магазин Классы Контент/Контентные единицы Меню администратора Настраиваемые модули Платформа Помощники/Мастеры/Инструкции/Подсказки Сайт-каталог Способы доставки/самовывоза Способы оплаты

Zion WebEngine X8.05.11
  • Создан класс для управления способами оплаты
  • Доработаны классы для управления контентом и навигацией, а также плагин универсального меню и драйвер оболочки:
    • Устранены недочёты в списке способов доставки
    • Реализована возможность отображать меню способов оплаты
  • Доработан класс для управления куки-массивами:
    • Расширен функционал
  • Доработаны меню администратора и графическая составляющая для сайта-каталога и интернет-магазина
  • Доработан класс для управления корзиной

Zion WebEngine Zion Catalog Драйверы Интернет-магазин Классы Контент/Контентные единицы Корзина для заказов Куки Меню/Списки/Навигация Меню администратора Плагины Сайт-каталог Способы доставки/самовывоза Способы оплаты

Zion WebEngine X8.05.10
  • Доработаны плагин универсального меню и класс для управления навигацией (спасибо Moto-Retail18):
    • Реализована возможность выводить пагинацию (список подстраниц) не только после меню/списка (по умолчанию), но и в любом другом месте в меню/списке
    • Доступен множественный вывод пагинации, например, до списка товаров и после него же

Zion WebEngine Классы Меню/Списки/Навигация Пагинация/Подстраницы Плагины

Zion WebEngine X8.05.06
  • Доработан класс для управления куки-массивами:
    • Улучшена совместимость с различными кодировками
  • Доработан класс для управления корзиной:
    • Доработано оформление формы оформления заказа
    • Реализовано сохранение в куках данных клиента, указанных при оформлении заказа
      • Подстановка данных при следующем заказе производится автоматически
    • Реализовано управление способами доставки
  • Доработано меню администратора
  • Доработаны плагин универсльного меню и класс для управления навигацией:
    • Добавлены новые условия для более тонкой настройки элементов списков
    • Реализована возможность отображать список способов доставки
  • В комплект поставки включёны настройки для способов доставки по умолчанию
  • Доработан драйвер оболочки

Zion WebEngine Zion Catalog Драйверы Классы Кодировки/Наборы символов Корзина для заказов Куки Меню/Списки/Навигация Меню администратора Плагины Способы доставки/самовывоза Формы

Zion WebEngine X8.05.05
  • Доработаны классы для управления контентом и навигацией:
    • В комплект поставки включены заготовки для реализации сравнения в двух режимах:
      • Отображение всех характеристик и отображение только отличающихся характеристик
    • В комплект поставки включены заготовки для email-сообщений о заказах в интернет-магазине:
      • На e-mail в том числе будет приходить:
        • Список заказанных товаров с ценами, количеством и итоговой суммой
        • Выбранные способы доставки и оплаты
        • Контактные данные клиента
        • Комментарий к заказу
  • Доработан плагин универсального меню:
    • Устранены некоторые недочёты при замене параметров, которые не были чётко заданы при вызове меню
  • Доработан класс для управления корзиной:
    • Доработана форма оформления заказа
  • Доработан класс для управления куки-массивами:
    • Реализовано сохранение всех POST-данных в куки

Zion WebEngine Zion Catalog Email-сообщения POST/GET-данные Интернет-магазин Классы Контент/Контентные единицы Корзина для заказов Куки Меню/Списки/Навигация Плагины Способы доставки/самовывоза Способы оплаты Сравнение Формы

Zion WebEngine X8.05.04
  • Доработан класс для управления контентом:
    • Реализована возможность при сравнении отображать только те характеристики, значения которых отличаются у товаров, участвующих в сравнении:
      • Характеристики с одинаковыми значениями скрываются:
        • Опционально

Zion WebEngine Классы Контент/Контентные единицы Сравнение

Zion WebEngine X8.05.03
  • Доработан плагин универсального меню:
    • Устранены некоторые недочёты при замене параметров, которые не были чётко заданы при вызове меню
  • Доработаны классы для управления навигацией и контентом:
    • Расширен функционал для реализации сравнения товаров

Zion WebEngine Классы Контент/Контентные единицы Меню/Списки/Навигация Плагины Сравнение

Zion WebEngine X8.04.28
  • Доработан обработчик заказа обратного звонка (спасибо Теплодом):
    • Учтена некорректная обработка некоторых служебных заголовков в Microsoft Office Outlook:
      • Email-сообщения могли помечаться как "нежелательная почта":
        • Пометить письмо как "не спам" было невозможно, так как данный почтовый клиент не распознаёт некоторые стандартные служебные заголовки

Zion Mail Back Email-сообщения Корзина для заказов Обработчики

Zion WebEngine X8.04.27

Zion WebEngine Zion Gallery PHP Галереи/Слайды Классы Контент/Контентные единицы Плагины Связи

Zion WebEngine X8.04.26
  • Доработан главный файл административного интерфейса:
    • Реализовано принудительное отключении XSS-защиты из-за ложных срабатываний в браузерах на движке Chromium
  • Доработана система мониторинга:
    • Расширен список доступных версий PHP:
      • Рекомендуется версия 7.2 и выше
      • Поддержка версии ниже, чем 5.4 не гарантируется
      • Версии ниже, чем 5.5 больше не поддерживаются разработчиками PHP и могут иметь уязвимости. Используйте их на свой страх и риск и только если у вас есть код, который не работает с более новыми версиями
  • Повышена совместимость с PHP 7.2.1
    • Доработан драйвер базы данных для старой платформы (спасибо Бургес)
    • Доработан класс для управления древовидными структурами (спасибо ЦентрСпецЗапчасть и ДиагностикаПромСервис)
    • Выпущено специальное обновление для пакета KCAPTCHA
      • Данный пакет далее развиваться не будет. Обновление выпущено для старых сайтов, которые переходят на новую версию PHP

Zion WebEngine KCAPTCHA Zion Edition Chromium PHP XSS Административный интерфейс База данных/Таблицы данных Веб-браузер Драйверы Классы Мониторинг Обновления CMS Платформа

Zion WebEngine X8.04.25
  • Доработана графическая составляющая Zion Catalog
  • Доработан плагин универсального меню:
    • Теперь прямо в оформлении меню можно использовать значения любых параметров, которые были переданы в плагин:
      • Также доступно использование своих "пользовательских" параметров - тех, которые отсутствуют в спецификации
    • Новый функционал позволяет отображать записи из указанных куки-массивов:
      • Может быть полезно, например, для организации сравнения товаров, для отобраежения "избранного", "закладок", списка "пожеланий" и т.п.
    • В комплект поставки добавлено несколько меню с рабочим примером реализации сравнения товаров:
  • Доработан класс для управления куки-массивами:
    • Реализовано получение списка всех имён в указанном куки-массиве:
      • Может быть полезно, например, для использования в параметре include плагина универсального меню
    • Реализовано получение имени первого элемента указанного куки-массива:
      • Может быть полезно, например, для использования в параметре factor плагина универсального меню при сравнении товаров
  • Доработан класс для управления контентом:
    • В комплекте поставки теперь есть страница с рабочим примером реализации сравнения товаров:

Zion WebEngine Zion Catalog Контент/Контентные единицы Куки Меню/Списки/Навигация Плагины Сравнение

Zion WebEngine X8.04.24
  • Доработаны классы для управления навигацией, HTML-кодом веб-страниц и куки-массивами, а также плагин универсального меню:
    • Расширен и доработан функционал для использования куки-массивов:
      • Доработано добавление/удаление записей в куки-массивы
      • Реализована возможность отображения количества записей в указанном куки-массиве
      • Реализована проверка на наличие указанной записи в указанном куки-массиве
      • Реализована проверка на существование указанного куки-массива
      • Расширен список связанных с куки-массивами условий, в зависимости от выполнения или невыполнения которых, можно делать особое оформление пунктов меню или HTML-кода веб-страниц
    • Данный функционал можно использовать для организации сравнения товаров, создания списков избранного, закладок, пожеланий и многого другого

Zion WebEngine HTML-код веб-страницы Классы Куки Меню/Списки/Навигация Плагины Сравнение Условия

Zion WebEngine X8.04.22
  • Доработан класс для управления элементом контента Число:
    • Устранена вероятность того, что данный элемент мог быть не сохранён в качестве цены
  • В комплект поставки включены некоторые заготовки для более быстрого развёртывания интернет-магазина:
    • Доработаны классы для управления шаблонами, контентом, HTML-кодом веб-страниц
      • Внедрена реализация последних нововведений
    • Доработан класс для управления навигацией:
      • Устранена вероятность несовместимости некоторых компонентов навигации между друг другом
    • Доработан плагин универсального меню:
      • Расширен список условий для более тонкой настройки пунктов меню и элементов контента

Zion WebEngine Zion Catalog HTML-код веб-страницы Интернет-магазин Классы Контент/Контентные единицы Меню/Списки/Навигация Плагины Условия Число Шаблоны контента Элементы