Параметры объекта JM

Все основные настройки модуля Джей-менеджер задаются параметрами самого объекта JM (id=7).

Параметр "настройки менеджера" представляет собой текстовое поле, каждая строка которого задает одну опцию и имеет следующий синтаксис:

ОПЦИЯ1=ЗНАЧЕНИЕ1
ОПЦИЯ2=ЗНАЧЕНИЕ2

Возможны следующие опции и их значения:

Опция

Умолчание

Описание

rootid=ЧИСЛО

Задает идентификатор начала ветви, которая будет видна в модуле JM. При попытке изменить или удалить объект, находящийся вне данной ветви, администратору будет выдано сообщение об отсутствии такого объекта. Если параметр не задан, то модуль JM отображает все дерево сайта.

rootid=SQL

нет

Задает SQL-выражение для указания нескольких корней дерева сайта. Альтернатива предыдущей опции.

filter=SQL

нет

Задает SQL-выражение для указания фильтра объектов, показываемых в дереве сайта. Т.е. все объекты которые может видеть администратор в дереве сайта должны удовлетворять заданному условию.

text=0/1

Устанавливает при старте текстовый режим работы модуля (по умолч. - графический). Опция контрольной панели - text.

simple=0/1

Устанавливает упрощенный режим работы JM. Аналог: nocontentext noparamsadd nouser nogroup norights nofilter noimport noadd noadmin.

width=ЧИСЛО

Задает ширину левой панели в процентах к общей ширине модуля JM. Можно изменить в правом поле на контрольной панели иодуля.

height=ЧИСЛО

500

Задает высоту окна JM в режиме работы с фиксированной высотой. Можно изменить в поле на контрольной панели иодуля.

height_start=0/1

Устанавливает режим работы с фиксированной высотой.

nohidden=0/1

Выключает при старте модуля опцию контрольной панели hidden.

nologin=0/1

Задает режим просмотра объекта по умолчанию с анонимными правами.

template=ШАБЛОН

main_content

Задает имя шаблона для просмотра объекта по умолчанию.

open=СПИСОК

1,100

Задает список раскрытых объектов в дереве сайта при старте модуля.

max_childs=ЧИСЛО

100

Задает максимальное число дочерних на одной странице при просмотре ветви.

flimit=ЧИСЛО

Задает лимит (максимальное число дочерних) в выборке ФИЛЬТРА по умолчанию.

icon_x=ЧИСЛО

100

Задает максимальную ширину при показе графических параметров в ФИЛЬТРЕ.

icon_y=ЧИСЛО

100

Задает максимальную высоту при показе графических параметров в ФИЛЬТРЕ и редактировании объекта.

textareas_h=ЧИСЛО

Задает высоту в пикселях текстового поля "аннотация" при редактировании объекта.

textareac_h=ЧИСЛО

100

Задает высоту в пикселях поля "текст" (контент) при редактировании объекта.

textareap_h=ЧИСЛО

Задает высоту в пикселях остальных текстовых полей при редактировании параметров объекта.

confirm=0/1

Задает режим подтверждения операции удаления параметров редактируемого объекта.

keyleft=info / view / edit / menu / none

info

Задает действие с объектом по левому щелчку мыши на папке или заголовке (свойства, просмотр, редактирование, контекстное меню или ничего).

afterapply=edit / info / view / none

edit

Задает действие с объектом после его ввода при нажатии клавиши "применить" (повторное редактирование, вывод свойств, просмотр объекта или ничего).

user_filter=SQL

нет

Задает фильтр для списка владельцев при редактировании объекта.

group_filter=SQL

нет

Задает фильтр для списка групп при редактировании объекта.

noimg=0/1

Выключает отображение графики при работе модуля.

nodate=0/1

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

noshort=0/1

Отключает возможность редактирования аннотации объекта.

nocontent=0/1

Отключает возможность редактирования контента (основного текста) объекта.

nocontentext=0/1

Отключает возможность расширенного редактирования контента (JEditor и т.п.).

nodoc=0/1

Отключает возможность загрузки документа (doc) в качестве контента.

nohtml=0/1

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

noparams=0/1

Отключает возможность редактирования параметров объекта.

noparamsadd=0/1

Отключает возможность добавления параметров при редактировании объекта.

nogroup=0/1

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

norights=0/1

Отключает возможность редактирования прав на объект.

nofilter=0/1

Отключает показ панели ФИЛЬТР при работе модуля.

noimport=0/1

Отключает показ панели ИМПОРТ при работе модуля.

nojparams=0/1

Отключает показ панели ПАРАМЕТРЫ при работе модуля.

noadd=0/1

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

noadddef=0/1

Отключает возможность добавления любых объектов.

noadmin=0/1

Отключает показ подменю "администратор".

ctrl_text=0/1

Задает текстовый или графический режим работы контрольной панели.

ctrl_lang=ru / en / de

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

piconsize=16/32

Задает размер пиктрограмм контрольной панели в пикселах.

iconsize=16/32

Задает размер пиктрограмм дерева в пикселах.

iconsown[16]=ЧИСЛО
iconsown[32]=ЧИСЛО

18
22

Задает идентификаторы объектов с собственными графическими ресурсами для соответствующего набора пиктрограмм.

fontsize=12/14

Задает размер системного шрифта в пикселах для работы модуля.

days_log=ЧИСЛО

365

Задает число дней для показа логов объекта.

days_stat=ЧИСЛО

Задает число дней для показа статистики объекта.

paramsedit=СПИСОК

нет

Задает список параметров (или групп параметров) допустимых для редактирования.

addfields[]=СТРОКА1
addfields[]=СТРОКА2

p_date,60,art_is=1
block_pos,80,block_is=1

Задает список дополнительных параметров для показа в дереве сайта. Форматы:
ПАРАМЕТР, ШИРИНА, ПРОВЕРКА УСЛОВИЕ ЧИСЛО
ПАРАМЕТР, ШИРИНА, КЛЮЧ
id, КЛАСС, ПРОВЕРКА УСЛОВИЕ ЧИСЛО
id, КЛАСС, КЛЮЧ

ПАРАМЕТР - имя параметра (атрибута) для показа в строке
ПРОВЕРКА - имя параметра (атрибута) для выполнения проверки
УСЛОВИЕ - один символ (= ! < >) - равно, не равно, меньше, больше
ЧИСЛО - число для выполнения проверки
КЛЮЧ - параметр для функции cond_check класса jmanager_local (sitemap_local)
КЛАСС - css-класс для выделения строки объекта в дереве
ШИРИНА - ширина поля для показа значения параметра в пикселах

Параметр будет показываться в строке объекта справа от заголовка (в поле заданной ширины), если для объекта выполняется заданное условие проверки. Если в качестве параметра указан id, то при выполнении условия вся строка будет выделена заданным css-классом

Примеры:

addfields[]=block_pos,80,block_is=1	В строке объекта с установленным параметром block_is (checkbox) будет отведено 80 пикселов для показа значения параметра block_pos.
addfields[]=p_date,60,art_type=140	В строке объекта с параметром art_type равным 140 будет отведено 60 пикселов для показа даты публикации объекта (дня).
addfields[]=prod_price,100,prod_price!''	В строках объектов с установленным и непустым параметром prod_price будет показываться значение этого параметра.
addfields[]=id,tuser1,group_id=4	Строки объектов, принадлежащих группе 4 будут выделены css-классом tuser1
addfields[]=id,tuser2,user_id>10	Строки объектов, принадлежащих пользователям с идентификаторами больше 10 будут выделены css-классом tuser2
addfields[]=p_date,60,check2	В строке объектов для которых выполняется условие с ключом check2 будет указано значение, возвращаемое функцией cond_check класса jmanager_local. Примечание. Требуется наличие данной функции и класса в главном модуле проекта index.phtml.

qsql[]=SQL1
qsql[]=SQL2

block_is

Задает список "любимых" sql-запросов для выборок в панели ФИЛЬТР. Данный список выдается при нажатии на клавишу "history" в панели ФИЛЬТР.

import_ctrls[]=СТРОКА1
import_ctrls[]=СТРОКА2

нет

Задает список "любимых" строк управления (шаблонов заголовка) для панели ИМПОРТ. Данный список выдается при нажатии на клавишу "history" в панели ИМПОРТ. Формат строк см. в "Описание полей импорта".

import_datas[]=СТРОКА1
import_datas[]=СТРОКА2

нет

Задает список "любимых" строк данных (шаблонов данных) для панели ИМПОРТ. Данный список выдается при нажатии на клавишу "history" в панели ИМПОРТ. Формат строк см. в "Описание полей импорта".

manager_example=SQL

нет

Задает SQL-выражение для задания списка "образцов дочерних" для отдельных администраторов. Задается только в параметре пользователя user_jmanager_conf

manager_example_def=ЧИСЛО

нет

Задает "образец по умолчанию" для отдельных администраторов. Задается только в параметре пользователя user_jmanager_conf

Для отдельных администраторов с ограниченными правами параметр "настройки менеджера" может быть переопределен с помощью аналогичного парамера из группы "ПОЛЬЗОВАТЕЛЬ СЛУЖЕБНЫЕ" (user_jmanager_conf). Задать значение этого параметра можно с помощью модуля "Пользователи" (users).

Возможные опции и их значения аналогичны перечисленным выше. Те опции, которые не указаны для конкретного администратора берутся из общих настроек модуля или устанавливаются по умолчанию (если они нигде на заданы).

К настройками JM можно отнести еще ряд параметров, влияющих на его интерфейс и функциональность. Среди них:

Параметр "образец дочерних" задает SQL-условие для формирования списка объектов, которые будут служить образцами (прототипами) для ввода всех новых объектов на сайте. По умолчанию SQL-условие имеет значение parent_id=95, т.е. образцами служат все объекты у которых идентификатор родителя равен 95 (ветвь спецрубрики/database/образцы). К списку, формируемым заданным условием, первым (верхним) пунктом всегда добавляется "пустой" образец, т.е. объект без каких-либо параметров.

Если заданное условие формирует список объектов из разных ветвей сайта, то контекстное меню для добавления объектов в JM автоматически становится двухуровневым (рис. 3).

Рис. 3. Двухуровневое контекстное меню для добавления дочерних объектов

Для отдельных администраторов с ограниченными правами параметр "образец дочерних" может быть переопределен с помощью параметра "настройки менеджера" из группы "ПОЛЬЗОВАТЕЛЬ СЛУЖЕБНЫЕ" (опция manager_example). Т.е. у каждого администратора может быть свой набор образцов для ввода.

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

АТРИБУТ=ТЕКСТ - сортировка по указанному атрибуту в порядке возрастания его значения.
АТРИБУТ desc=ТЕКСТ - сортировка по указанному атрибуту в порядке убывания его значения.
ПАРАМЕТР=ТЕКСТ - сортировка по указанному параметру в порядке возрастания его значения
ПАРАМЕТР desc=ТЕКСТ - сортировка по указанному параметру в порядке убывания его значения

Данный параметр, установленный в каком-либо объекте, задает режим "автосортировки", т.е. при вводе нового дочернего объекта вся ветвь будет пересортирована в соответствии со значением указанного параметра. Значения этого параметра используются также для формирования пунктов контекстного подменю "отсортировать" в модуле JM.

Параметр "ресурсы по умолчанию" задает список файлов с наборами пиктограмм, которые можно использовать в административных модулях TreeGraph и шаблонах (стилях) сайта:

treegraph_icons16.html=16x16
treegraph_icons32.html=32x32

В системе TreeGraph созданы несколько стандартных наборов пиктограмм различных размеров (рис. 4).

http://адрес_сайта/comm/images/treegraph_icons16.html (16х16)

http://адрес_сайта/comm/images/treegraph_icons32.html (32х32)

Рис. 4. Стандартные наборы пиктограмм для административных модулей и шаблонов сайта.

Рис. 5. Стандартный набор "смайликов" и пиктограмм BB-тегов для модуля Форум

Данный параметр устанавливается, как правило, в корневом объекте сайта (id=1).

Параметр "графические ресурсы" задает идентификатор (или список) объекта, с котором заданы дополнительные пиктограммы или другие графические изображения, использующиеся в административных модулях или шаблонах (стилях) сайта. Контент (основной текст) данного объекта аналогичен формату файлов treegraph_iconsXX.html и состоит из HTML-строк с описанием графических изображений (пиктограмм):

< img src="ИМЯ_ФАЙЛА1" lowsrc="ИМЯ_ФАЙЛА2" ПРИВЯЗКА="ЗНАЧЕНИЕ" alt="" width="ЧИСЛО" height=" ЧИСЛО" border="0">

ИМЯ_ФАЙЛА1 - Имя файла для основного изображения пиктограммы объекта.
ИМЯ_ФАЙЛА2 - Имя файла для изображения пиктограммы "текущего" объекта (можно не задавать).
ПРИВЯЗКА="ЗНАЧЕНИЕ" - Задает способ привязки пиктограммы к объектам дерева сайта.

Все пиктограммы "привязываются" к определенному параметру (свойству) объекта с помощью HTML-атрибута ПРИВЯЗКА="ЗНАЧЕНИЕ", который может иметь следующий формат:

Тип привязки	Описание
id="ЧИСЛО"	Данная пиктограмма будет отображаться в дереве сайта для объекта с указанным идентификатором.
parent_id="ЧИСЛО"	Данная пиктограмма будет отображаться для дочерних объектов указанного.
parents="СПИСОК"	Данная пиктограмма будет отображаться для всех объектов указанной ветви.
handler="СТРОКА"	Пиктограмма будет отображаться для объектов с установленным параметром "обработчик" и его значением, совпадающим с указанным.
param="ИМЯ" value="ЗНАЧЕНИЕ"	Данная пиктограмма будет отображаться для объектов с установленным указанным параметром и его значением, совпадающим с указанным в HTML-атрибуте value.
param="ИМЯ" value="*"	Данная пиктограмма будет отображаться для объектов с установленным указанным параметром и любым его значением (в том числе нулевых и пустых).
param="ИМЯ"	Данная пиктограмма будет отображаться для объектов с установленным указанным параметром и любым его значением (кроме нулевых и пустых).
parambg="ИМЯ" value="ЗНАЧЕНИЕ"	Дополнительная (фоновая) пиктограмма для объектов с установленным указанным параметром. Обработка значения value аналогична описанной выше.
file="РАСШИРЕНИЕ"	Данная пиктограмма будет отображаться для объектов с установленным параметром "внешний файл" и загруженным файлом с указанным расширением.
action="СТРОКА"	Задание вспомогательных пиктограмм для использования в различных шаблонах (стилях).
smile="ИМЯ" alt="КОД"	Пиктограмма для смайликов форума. ИМЯ – уникальное название смайлика (smile, wink, happy и др.), КОД - текст для вставки смайлика ( :) ;) и др.)

Если для объекта выполняется несколько условий привязки, то текущая пиктограмма выбирается в следующем порядке: id, handler, file, param, parambg, parent_id, parents.

Все стандартные и собственные пиктограммы попадают в XML-дерево сайта в секцию icon (подсекция соответствует типу привязки). Для вывода какой-либо пиктограммы в шаблоне можно использовать следующий XSL-тег:

В объекте с ресурсами можно переопределить любую стандартную пиктограмму, задав собственному графическому изображению соответствующую привязку. Если свойства какого-либо объекта удовлетворяют одновременно нескольким условиям привязки, то его пиктограмма будет отображаться исходя из следующего приоритета: id, handler, file, param, parent_id, parents. Секция icon кэшируется, поэтому после добавления или изменения собственных пиктограмм, необходимо сбросить кэш, командой экранного менеджера "clearcahe".

Параметр "графические ресурсы" устанавливается, как правило, в корневом объекте сайта (id=1).