Плагин Menu

Плагин Menu

03.02.2021

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

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

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

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

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

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

В меню администратора выберите Навигация \ Варианты оформления меню. Здесь можно изменить уже имеющиеся оформления меню и создать новые.

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

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

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

HTML-код меню

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

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

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

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

В поле HTML-код до меню можно указать начало оформления, а в поле HTML-код после меню - конец оформления меню. Например, это могут быть теги ul или 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)
  • 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 раздела
  • brothers - "братья" - записи с тем же место в структуре, что и указанный в factor раздел
  • parents - "предок и его братья" - надраздел, указанного в factor раздела и указанного в level уровня, а также другие разделы с тем же местом в структуре
  • path - "путь" - список надразделов от верхнего уровня в структуре до указанного в factor раздела (полезно, например, для создания так называемых "хлебных крошек")
  • linked - "связи" - только те записи, с которыми связана указанная в factor запись
  • backlinks - "обратные связи" - только те записи, которые связаны с указанной в 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 Catalog):

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

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

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

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

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

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

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

  • select - в большинстве случаев должен быть равен children-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.
include

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

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

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

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

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

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

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

exclude

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

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

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

notzero

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

Например:

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

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

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)
  • 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_...

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

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

Пример временной метки текущего времени (05.03.2021 09:39:24): 1614926364

По умолчанию - 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 - сортировать на основе положения в базе данных в обратном порядке (рекомендуется для новостей, статей и т.п.)

Также доступна сортировка контента по полям с датой (доступна только при наличии в комплекте поставки 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.

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

 

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

 

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

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

Zion WebEngine 21.03.02
  • Доработан класс для работы с файлами и папками (спасибо Оптика От Склада):
    • Теперь инструмент Размеры файлов и папок не выдаёт ошибок при работе с любым, даже огромным, количеством файлов
  • Доработан класс для управления базой данных:
    • Расширен набор доступных функций

Zion WebEngine База данных/Таблицы данных Классы Файлы/Папки Что такое Классы?

Zion WebEngine 21.02.26
  • Доработан плагин универсального меню (спасибо Оптика От Склада):
    • Теперь при работе со списком товаров в заказе также доступно использование свойств не только товаров, но и заказа
  • Доработан класс для управления заказами:
    • Реализована возможность продублировать ранее оформленный заказ:
      • При этом в корзину добавляются только те товары, которые на данный момент не сняты с продажи

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

Zion WebEngine 21.02.18
  • Доработан плагин универсального меню (спасибо Оптика От Склада):
    • Улучшена фильтрация списков по тем или иным параметрам, в значениях которых встречается кириллица (русские буквы)

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

Zion WebEngine 21.02.16
  • Доработан класс для управления корзиной заказов (спасибо Moto-Retail18):
    • Теперь пре выборе того или иного способа доставки (не самовывоза) информация о ранее выбранной точке самовывоза будет "забыта" и, как следствие, не будет присутствовать в уведомлениях о заказах
  • Доработан класс для управления корзиной мусора (спасибо Оптика От Склада):
    • Переработано формирование и сохранение настроек по умолчанию без которых очистка могла производиться при каждом обращении к административному интерфейсу

Zion WebEngine Zion Catalog Что такое Административный интерфейс и Гостевой интерфейс? Административный интерфейс Классы Корзина для заказов Корзина для мусора Способы доставки/самовывоза Уведомления о заказах

Zion WebEngine 21.02.12
  • Доработаны классы для работы с местом в структуре и базой данных (спасибо Хронос Медиа):
    • Теперь при наличии в комплекте поставки Zion User Control можно разрешить (по умолчанию) или запретить массовое удаление записей для той или иной группы пользователей

Zion WebEngine База данных/Таблицы данных Доступ Групп пользователей Классы Место в структуре Элемент "Место в структуре"

Zion WebEngine 21.02.10
  • Устранены недочёты в комплекте поставки предыдущего обновления: (спасибо Moto-Retail18):
    • Могли появляться ошибки при открытии заказов в административном интерфейсе

Zion WebEngine Что такое Комплект поставки? Административный интерфейс Классы Корзина для заказов Обновления CMS

Zion WebEngine 21.02.09
  • Доработаны классы для управления базой данной и заказами, а также вспомогательный класс для управления вкладками, административные CSS-определения и административные JS-скрипты: (спасибо Moto-Retail18):
    • Теперь при распечатке заказов из интернет-магазина можно выбирать вкладки, информацию с которых нужно или не нужно распечатывать
  • Доработан класс для работы с файлами и папками:
    • В разделе Инструменты меню администратора снова стал доступен пункт Размеры файлов и папок:
      • С его помощью, можно уточнить, какие файлы занимают больше всего место на диске и оценить, например, не привысили ли Вы доступное место на хостинге

Zion WebEngine Zion Catalog Что такое Меню администратора? База данных/Таблицы данных Веб-сервер/Хостинг Вкладки Интернет-магазин Классы Корзина для заказов Меню администратора Файлы/Папки

Zion WebEngine 21.02.04
  • Доработан плагин универсального меню:
    • Параметр sort теперь может брать значения из COOKIE- и GET-параметров
    • Для параметра sort теперь доступен новый вариант fields - сортировка по указанному списку полей:
    • Для тех же целей созданы новые параметры:
      • sort-fields - указание на то, по каким полям необходимо сортировать список:
        • поля перечисляются через запятую - их порядок имеет значение
        • если по какому-то полю нужна сортировка в обратном порядке, то перед его именем нужно указать -. Например, не name, а -name
        • этот параметр также может брать значение из COOKIE- и GET-параметров
      • sort-numbers - указание на то, какие поля при сортировке нужно считать числами:
        • без использования этого параметра в некоторых случаях в результате сортировки вместо списка вида, 1, 2, 3, 10, 20, 100 может получиться список вида 1, 10, 100, 2, 20, 3
        • поля перечисляются через запятую - их порядок не имеет значения
  • Доработан класс для управления базой данной:
    • Функции ColumnsExistsList перед именами полей, наличие которых в таблице нужно проверить, теперь можно указывать знак -. Например, не name, а -name:
      • В этом случае, если name найдено, то будет возвращено name, а не -name
      • Кое-где это может быть полезно, например, для определения списка полей, по которым доступна сортировка (с символом - сортировка по данному полю будет в обратном, а не в обычном порядке)
  • Cоздан новый элемент Статистика, в котором отображаются данные о различных параметрах "популярности" той или иной контентной единицы (доступен при наличии в комплекте поставки Zion SEO Booster):
    • Количество просмотров данной страницы (доступно при наличии в комплекте поставки Zion PubHub):
      • Для сбора этих данных доработан главный файл гостевого интерфейса
    • Количество добавлений в корзину данного товара (доступно при наличии в комплекте поставки Zion Catalog):
      • Для сбора этих данных доработан класс для управления корзиной
    • Количество заказов данного товара (доступно при наличии в комплекте поставки Zion Catalog):
      • Для сбора этих данных доработан класс для управления заказами

Zion WebEngine Zion Catalog Zion SEO Booster POST/GET-данные База данных/Таблицы данных Гостевой интерфейс Интернет-магазин Классы Контент/Контентные единицы Корзина для заказов Куки Меню/Списки/Навигация Плагины Число Элементы Плагин Menu

Zion WebEngine 21.02.01
  • Доработаны классы для управления базой данной и заказами, а также административные CSS-определения: (спасибо Moto-Retail18):
    • Реализована возможность распечатки заказов из интернет-магазина:
      • При открытии того или иного заказа на панели инструментов появляется необходимая для распечатки кнопка

Zion WebEngine Zion Catalog Что такое Панель инструментов? База данных/Таблицы данных Интернет-магазин Классы Корзина для заказов Панель инструментов

Zion WebEngine 21.01.28
  • Доработан импорт данных из Excel/CSV:
    • Применён нативный "движок" для работы с форматом CSV вместо самописного
    • Для большего удобства изменён порядок параметров для настройки импорта
    • Реализована возможность указать префикс, который в случае необходимости будет удалён из адресов всех изображений
    • Ранее было доступно связывание всех записей (например, товаров) со всеми указанными записями (например, категориями). Теперь доступно связывание определённых товаров только с необходимыми категориями:
      • В этом случае категории создаются автоматически на основе данных из указанного в настройках столбца
      • Доступно связывание с несколькими категориями выбранного типа:
        • Важно, чтобы при этом для данного типа был выбран шаблон по умолчанию
      • Доступно автоматическое создание надкатегорий и подкатегорий
      • При этом в случае отметки галочки Удалить старые записи перед импортом будут удалены не только товары, но и категории
    • Помимо кодировки windows-1251 теперь доступно использование кодировки utf-8
    • Помимо точки с запятой теперь в качестве разделителя между ячейками доступно использование запятой
    • Если в некоторых столбцах импортируемых данных указаны не только значения, но и названия характеристик, то доступна опция для указания количества таких столбцов:
      • Затем можно указать, в каких столбцах хранятся названия, а в каких столбцах их значения:
        • То есть в одном столбце могут храниться данные о любом количестве характеристик
    • Теперь по завершение импорта, в том числе неудачного нет необходимости задавать параметры заново:
      • Также теперь нет необходимости заново загружать файл с импортируемыми данными, так как он не удаляется по завершении импорта

Zion WebEngine Zion Import CSV/Excel Изображение Импорт/Экспорт Категории Кодировки/Наборы символов Место в структуре Сайт-каталог Связи Типы Характеристики/Разновидности Шаблоны Что такое Тип контента?

Zion WebEngine 21.01.26
  • Доработана система мониторинга (спасибо VisualMathStart):
    • Значительно расширен список файлов для очистки после обновления CMS

Zion WebEngine Что такое система Мониторинга? Мониторинг Файлы/Папки

Zion WebEngine 21.01.25
  • Доработана интеграция с файл-менеджером KCfinder (спасибо Хронос Медиа):
    • Теперь в случае необходимости можно разрешить загрузку файлов через файл-менеджер в нестандартую папку:
      • В том числе теперь легко выделить для каждого авторизованного пользователя свою собственную папку без возможности доступа к папкам других пользователей

Zion WebEngine Доступы/Пользователи Файл-менеджер Файлы/Папки

Zion WebEngine 21.01.22
  • Доработан класс для работы с шаблонами:
    • Расширен набор доступных функций:
      • В том числе стало возможно определение ID элемента в формате класс_номер в указанном шаблоне по указанному имени:
        • Поиск ведётся только для обычных (не уникальных) элементов
        • Если элементов с таким названием в шаблоне несколько, вернётся ID первого найденного

Zion WebEngine Классы Шаблоны Элементы Что такое Элементы?

Zion WebEngine 21.01.21
  • Доработан элемент Связи (спасибо Хронос Медиа):
    • Расширен набор параметров для плагина, позволяющего редактировать связи между контентными единицами:
      • В том числе теперь при необходимости можно скрывать не нужные в том или ином случае кнопки напротив связываемых записей
  • Доработана интеграция с файл-менеджером KCfinder:
    • Устранены недочёты при разрешении или ограничение доступов для групп пользователей

Zion WebEngine Доступ Групп пользователей Контент/Контентные единицы Плагины Связи Файл-менеджер Элементы Что такое Плагины?

Zion WebEngine 21.01.14
  • Доработаны классы для работы с проектом, типами и шаблонами, а также элемент Связи (спасибо Хронос Медиа):
    • Упрощено редактирование некоторых доступов для групп пользователей

Zion WebEngine Доступ Групп пользователей Классы Связи Типы Шаблоны Элементы Что такое Тип контента?

Zion WebEngine 21.01.13
  • Доработаны классы для работы с корзиной и заказами (спасибо Group Experience):
    • Расширены возможности для работы с корзиной через AJAX
    • Расширены возможности по настройке формы заказа для услуг, оказываемых удалённо и не требующих доставки и/или самовывоза (например, онлайн-обучение):
      • В том числе стала доступна возможность скрыть в форме сразу все поля для указания адреса

Zion Catalog AJAX Классы Корзина для заказов Способы доставки/самовывоза Формы Что такое Классы?

Zion WebEngine 21.01.07
  • Учтены современные требования к favicon:
    • Доработан элемент HTML-код веб-страницы
    • Доработаны классы для управления проектом и шаблонами
    • Доработан монитор ядра
    • Доработан плагин Meta

Zion WebEngine Zion SEO Booster HTML-код веб-страницы SEO-параметры Классы Мониторинг Плагины Шаблоны Элементы

Zion WebEngine 21.01.04
  • Доработаны страницы ошибок (спасибо Феникс):
    • Устранены некоторые недочёты
  • Для совместимости с новыми стандартами CMS доработаны некоторые компоненты:
    • Элемент HTML-код веб-страницы
    • Классы для управления проектом, пользователями и шаблонами
    • Мониторы MySQLi и ядра
    • Обработчики обратной связи, обратного звонка
    • Настраиваемые модули для управления уведомлениями о заказах на системный email и для расчёта стоимости и срока доставки через СДЭК
    • Плагины Meta и SendMail

Zion WebEngine Zion Catalog Zion Mail Back Zion SEO Booster Zion xDelivery Zion Sender Email-рассылки Email-сообщения HTML-код веб-страницы SEO-параметры База данных/Таблицы данных Доступы/Пользователи Классы Мониторинг Настраиваемые модули Обработчики Обратная связь/Обратный звонок Плагины Способы доставки/самовывоза Страницы ошибок Уведомления о заказах Шаблоны Элементы

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