1. Общая информация
TreeGraph представляет собой универсальную систему для
создания, управления и развития любых интернет-проектов, от небольших
интернет-представительств компаний до торговых площадок и корпоративных
порталов.
Более чем 8-летний опыт
развития системы TreeGraph и
реализованные за это время проекты позволили нам накопить огромный практический
опыт, который сегодня мы можем предложить нашим клиентам.
TreeGraph - непрерывно развивающаяся система. В своих
разработках мы учитываем постоянно растущие потребности и запросы наших
клиентов, осваиваем новые технологии, совершенствуем и развиваем применяемые
методы. Первая коммерческая версия системы была разработана в апреле 2000 года.
В настоящее время более 150 наших проектов используют TreeGraph различных версий. Полный список работ, созданных с помощью системы TreeGraph можно увидеть в разделе Портфолио
нашего сайта.
| 1.1. Функциональные возможности
Основные
функциональные возможности, которые предоставляются наших клиентам на сайтах,
созданных с помощью системы TreeGraph:
Полный контроль и управление сайтом с помощью
интернет-броузера без дополнительного клиентского программного обеспечения.
Веб-публикации -
интерактивное создание и управление структурой сайта, публикация и
редактирование текстовых и графических материалов администраторами с любого
компьютера, подключенного к сети интернет.
Импорт файлов -
встроенный конвертор дает возможность публиковать материалы непосредственно в
форматах MS Word, MS Excel, RTF, HTML и TXT, сохраняя
при этом оформление документа.
WYSIWYG-редактор -
встроенный визуальный редактор позволяет создавать и изменять любые страницы
сайта. Интерфейс редактора прост и максимально приближен к MS Word.
Графический редактор -
встроенный модуль для редактирования (масштабирования, обрезки, поворота) любых
загруженных графических файлов, позволяет добавлять рамки, водяные знаки или
тексты к изображению.
Экспорт страниц - встроенный
документ-генератор позволяет создавать документы в формате MS Word из любой страницы сайта, полностью сохраняя при
этом оформление и стили сайта.
Регистрация и авторизация посетителей на сайте,
поддержка групп пользователей, различных по назначению и привилегиям.
Управление правами доступа. Возможно
разграничение прав посетителей (или групп) как на изменение, так и на просмотр
информации на уровне подразделов, страниц и даже отдельных блоков на страницах
сайта.
Управление настройками и внешним видом сайта, включая
создание отдельных страниц и подсайтов со своим дизайном и системой навигации,
с учетом прав доступа.
Применение системы XML/XSL-шаблонов. На сайте
возможно как использование стандартной библиотеки шаблонов и стилей, так и
создание своих собственных стилей для страниц и подразделов сайта или отдельных
блоков.
Организация и управление подпиской на
новости и любые другие страницы сайта в различных форматах.
Создание и ведение своих
собственных баз данных, каталогов, прайс-листов, классификаторов и различных
параметров, управляющих формированием динамических блоков на страницах сайта.
Экспорт-импорт - полностью
симметричный алгоритм позволяет организовать вывод любой информации с сайта в
различных форматах (MS Excel, XML, HTML и др.) и потоковую загрузку
данных на сайт. С помощью этого модуля легко организуется синхронизация внешних
баз данных (например, 1С) и информации на сайте.
Поддержка интерактивных форм -
создание анкет, опросов, заказов, гостевых книг и любых произвольных
интерактивных форм с полями различных типов. Интеграция форм с электронной
почтой и обратная связь с менеджерами сайта.
Сбор и анализ статистики посещений
всех страниц сайта за любой временной интервал, отслеживание поведения
посетителя на сайте, генерация графиков и csv-таблиц со
статистической информацией для дальнейшей обработки.
Дополнительные функциональные модули -
настраиваемый полнотекстовый поиск по разделам сайта или объектам определенного
типа, динамические карты сайта, версия сайта для печати, системы голосования,
форумы и др.
| 1.2. Особенности и отличия
Встроенный конвертор файлов
Вы можете подготавливать информацию для загрузки на сайт в любом
из следующих форматов: обычный текст с упрощенной системой тегов, HTML, RTF,
Microsoft Word, Microsoft Excel. Документы могут содержать любые элементы
оформления текста и абзацев, включать в себя сложные таблицы, иллюстрации,
графики и т.п. Встроенный конвертор автоматически распознает тип документа,
обеспечит сохранение оформления страницы, преобразует встроенные объекты в
графические файлы (GIF и JPG) и загрузит все файлы на сервер (рис. 1). Возможна
индивидуальная настройка конвертора для проекта. Файл, загруженный на сервер,
сохраняется в архиве и у администратора всегда имеется возможность скачать его,
отредактировать и загрузить обратно.

Рис. 1. Результат работы конвертора
файлов
|
Встроенный визуальный редактор
Кроме конвертора файлов, система TreeGraph имеет и встроенный
визуальный редактор, который позволяет вводить и редактировать любые страницы
сайта в режиме WYSIWYG (принцип - "что вы видите, то и получаете"). С
помощью него можно легко публиковать и изменять сложные документы с
разнообразным оформлением текста, с иллюстрациями, диаграммами, таблицами и
т.п. (рис. 2). Интерфейс редактора максимально приближен к возможностям
программы MS Word. Редактор позволяет также корректировать текст в исходных
HTML-кодах.

|
Рис. 2. Окно визуального редактора
JEditor.
|
Встроенный графический редактор
С помощью встроенного графического редактора Вы можете
модифицировать любые загруженные графические изображения: изменять масштаб,
обрезать по заданной области, поворачивать на любой угол, добавлять рамки,
"водяные знаки" или произвольный текст. Редактор работает в двух
режимах: редактирование текущего изображения и создание иконки. При сохранении
результатов редактирования, предыдущий файл архивируется и имеется возможность
его восстановить.

|
Рис. 3. Работа графического
редактора в режиме создания иконки.
|
Независимость контента и программ от дизайна
Все информационное наполнение сайта (контент) и динамическая
информация, генерируемая функциональными модулями, полностью отделены от
оформления страниц сайта. Все модули "занимаются" только подготовкой
данных отдельных блоков, а преобразование их в HTML-код осуществляется по
правилам, установленным в шаблонах и стилях сайта. Это позволяет быстро и легко
изменить оформление как отдельных блоков, так и всего сайта целиком.
Конструирование страниц, шаблоны и стили
В системе TreeGraph используется шаблонно-блочный метод
организации страниц. Любая страница сайта формируется по заданному шаблону,
состоящему из элементов оформления и набора позиций для вывода блоков данных
(рис. 4). Сайт может иметь неограниченное количество шаблонов. Компоновка
страницы заключается в создании блоков (специальных служебных объектов в дереве
сайта), в которых администратор задает условия выборки данных, указывает
определенный стиль и позицию блока в шаблоне.

|
Рис. 4. Схема формирования страниц
с помощью шаблонов и стилей
|
Сформированные с помощью стиля, коды отдельных блоков образуют
готовую HTML-страницу в соответствии с установленным текущим шаблоном.
Некоторые блоки могут использоваться на всех страницах сайта (например, общая
шапка, главное меню), другие - на отдельных страницах или подразделах. На блоки
распространяется вся система прав доступа, т.е. одна и та же страница может
"выглядеть" по-разному для посетителей с различными правами. В
распоряжении администратора имеется обширная общая библиотека шаблонов и
стилей. Кроме этого, можно создавать свои собственные стили для отдельных блоков
и шаблоны для страниц или подразделов сайта. Для разработки шаблонов
используется язык XML/XSL (The Extensible Stylesheet Language) и его
спецификации XSLT (XSL Transformations) и XPath (XML Path Language).
Развитая система прав доступа
В системе TreeGraph реализовано взаимодействие с
посетителями, аналогичное ОС Unix. Любой посетитель сайта может быть анонимным
или зарегистрированным пользователем, входящим в одну или несколько групп.
Права пользователя на определенные действия (просмотр объектов, редактирование
и др.) определяются его принадлежностью к группам и атрибутами объекта. Такая
система позволяет организовать многопользовательское управление сайтом и
создание отдельных страниц или подразделов, доступных на просмотр посетителям
только определенных групп (внутрикорпоративные страницы, разделы для дилеров и
т.п.).
Расширяемая база данных объектов
В системе TreeGraph используется оригинальный подход к
хранению объектов в базе данных. Любое объект в базе, кроме фиксированных полей
(атрибутов), может содержать произвольное количество дополнительных полей
различного типа (параметров). Эти поля могут использоваться для управления
логикой формирования блоков, создания различных каталогов, произвольных
интерактивных форм и т.п. Значения атрибутов и параметров объектов можно
использовать при разработке шаблонов и стилей сайта. Администратор имеет
возможность самостоятельно создавать новые параметры любого типа, в том числе и
так называемые "классификаторы", т.е. параметры, значения
которых формируются из заголовков и идентификаторов других объектов.
Импорт и экспорт базы данных
В системе TreeGraph создан полностью симметричный алгоритм
экспорта-импорта данных. Он дает возможность организовать вывод всей базы
данных или указанных объектов (новостей, каталога товаров и др.) в различных
форматах (MS Excel, XML, HTML и др., в том числе данные в архивах ZIP/RAR) или
осуществить потоковую загрузку данных на сайт. Это позволяет значительно
облегчить и ускорить ввод или редактирование большого количества объектов (фотогалерей,
товаров), а также настроить синхронизацию с внешними БД.
С помощью импорта-экспорта легко осуществить интеграцию
(синхронизацию) сайта с любыми внешними базами данных (например, 1С) и другими
интернет-проектами. Администратор сайта может создать любое количество
различных RSS-каналов для экспорта новостей, сообщений в форумах и т.п. для
подключения сайта к Яндекс.Новости или программам чтения RSS-каналов. Возможно
также чтение внешних RSS-каналов и отображение их на сайте различными стилями.
Экспорт в формате YML позволяет легко подключить каталог товаров сайта к
системе Яндекс.Марке
| 2. Техническая информация
Информация в данном
разделе предназначена, в первую очередь, для администраторов сайтов и служб
технической поддержки.
С технологической
точки зрения, система TreeGraph представляет собой набор функций и
программ, написанных на языке PHP. TreeGraph работает на любых Unix- и Windows-платформах под управлением веб-сервера Apache и использует базу данных mySQL.
| 2.1. Архитектура TreeGraph
Система TreeGraph имеет модульную структуру и
состоит из ядра и набора функциональных модулей, выполняющих различные задачи
(рис. 1). Такая структура позволяет каждому проекту использовать все
функциональные возможности системы, а также создавать собственные модули,
удовлетворяющие потребностям клиента.
Общая схема работы системы
TreeGraph
- Получение
и обработка запроса от клиента (URL)
- Определение
и проверка прав клиента на данный запрос
- Получение
запрашиваемой и связанной информации из базы данных и кэш-файлов
- Структурирование
всех полученных данных в виде XML-дерева страницы
- Формирование
HTML-страницы из XML-дерева по заданным XSLT-шаблонам и стилям
- Передача
сформированной HTML-страницы
клиенту

Рис. 1. Структура системы управления сайтом TreeGraph
В ядре TreeGraph объединены функции, которые реализуют базовые возможности системы:
- функции общего назначения
- административные функции
- функции работы с базой данных
- функции управления доступом и правами
- многоуровневая система кэширования
- система обработки статистических данных
- поддерка многоязычного интерфейса
- конвертор файлов различных форматов
- полнофункциональный визуальный редактор
- система трассировки и отладки
- система мониторинга проектов
- система XML представления данных
- XSL-парсер шаблонов
Общие модули TreeGraph реализуют определенные задачи проектов. К
ним относятся:
- организация и обработка произвольных
интерактивных форм
- модуль голосования
- линейный и структурированный форумы
- настраиваемый полнотекстовый поиск по
сайту
- генераторы карт сайта
- калькулятор (конфигуратор)
- каталог товаров и интегрированная
корзина заказов
- регистрация пользователей на сайте
- организация подписки на различные
новости сайта
Административные модули
TreeGraph предназначены для
контроля, управления и развития сайта. К ним относятся:
- менеджеры (управление структурой и
содержимым сайта, правами доступа, навигацией)
- параметры (управление типами данных,
масштабирование базы данных)
- пользователи (управление группами и зарегистрированными
пользователями сайта)
- статистика (просмотр и анализ
статистической информации о посетителях сайта)
- рассылка (управление автоматической
рассылкой новостей сайта)
- стили (контроль и загрузка библиотеки XSL шаблонов и стилей)
- экспорт (выгрузка базы данных и файлов
проекта в различные форматы)
- импорт (потоковый ввод страниц сайта в
базу данных)
Крон-система автоматически выполняет следующие функции:
- организация рассылки новостей проектов
- создание архивных копий баз данных и
файлов проектов
- обработка статистической информации
проектов
Библиотека TreeGraph включает в себя общие файлы, используемые
всеми проектами:
- базовые XSL шаблоны
- набор общих CSS-стилей
- набор общих JavaScript функций
- базовый набор графических изображений
(иконок)
Каждый проект состоит
из главного модуля, собственной базы данных, структурированных каталогов с
внешними объектами и кэш-файлами, библиотеки шаблонов. Главный модуль получает
запрос от клиента и передает управление ядру TreeGraph, которое, при необходимости, поключает различные модули
системы (или проекта) и возвращает клиенту готовую сформированную HTML-страницу. Для любого
проекта могут быть разработаны и установлены дополнительные программные модули,
решающие его специфические задачи.
TreeGraph может обеспечивать функционирование сразу
нескольких проектов, использующих одно ядро, общие модули и шаблоны
(рис. 2). При этом, каждый сайт будет иметь свою собственную базу данных,
внешние файлы, дополнительные модули и библиотеки шаблонов.

Рис. 2. Схема взаимодействия ядра TreeGraph и различных проектов
По желанию клиентов, различные проекты могут взаимодействовать
между собой, используя информацию не только из своей базы данных, но и из баз
других проектов. Возможно также совместное использование библиотек XSL стилей и других ресурсов
проектов..
| 2.2. Схема работы
Общая схема работы системы TreeGraph выглядит следующим образом:
1. Получение запроса клиента (посетителя) на просмотр страницы сайта (URL)
главным модулем сайта.
2. Подключение ядра TreeGraph и начальная установка всех параметров
сайта.
3. Подключение к базе данных сайта.
4. Определение статуса посетителя на данном сайте (по сессиям, COOKIE и
др.).
5. Определение идентификатора запрашиваемой страницы в базе данных.
6. Запись в базу данных статистической информации о посетителе.
7. Получение запрашиваемой страницы из базы данных.
8. Определение прав посетителя на запрашиваемую страницу.
9. Определение параметров (характеристик) запрашиваемой страницы.
10. Проверка на допустимость доменного имени в запросе.
11. Получение из базы данных или кэш-файлов дополнительной информации
(описания параметров, типов данных и др.).
12. При отсутствии у посетителя прав на просмотр данной страницы (или
другое действие), формирование блока с запросом на авторизацию (ввод логина и
пароля).
13. Проверка на разрешение или запрет просмотра данной страницы (или другое
действие) для определенных IP-адресов.
14. Получение из базы данных связанных страниц сайта (дочерних,
родительских и др.).
15. Определение типа запрашиваемой страницы, подключение и запуск, при
необходимости, дополнительного модуля (обработчика).
16. Получение из базы дополнительных данных (блоков), которые должны
показываться на запрашиваемой странице. При необходимости, информация для
блоков может быть запрошена из других баз данных, с учетом прав данного
посетителя.
17. Построение XML-дерева страницы из всех полученных данных.
18. Формирование HTML-кода для отдельных блоков из XML-дерева по заданным
XSLT-шаблонам (стилям).
19. Формирование HTML-кода всей страницы из HTML-кодов отдельных блоков по
заданному XSLT-шаблону.
20. Кэширование, при необходимости, HTML-кодов блоков и всей страницы.
21. Передача сформированной HTML-страницы клиенту.

|
Рис. 1. Схема формирования страницы в системе TreeGraph.
|
| 2.3. Системные требованияТребования к аппаратному обеспечению зависят от количества посетителей сайта и объема информации.
Программное обеспечение
|
Версия
|
Операционная система
|
FreeBSD или Linux (Debian, SuSe, RedHat, Gentoo и пр.)
|
Web сервер
|
Apache Web Server или nginx
|
Язык программирования
|
PHP >=5.3 (dom, xsl, xml, session, gd, iconv, eaccelerator или xcache)
|
СУБД
|
MySQL >=5.1
|
Почтовый сервер
|
Sendmail или другой MTA для поддержки рассылки (postfix, exim)
|
Дополнительное ПО
|
cron - для запуска рассылок и обработки статистики;
wget, zip, unzip, unrar - для импорта и экспорта;
whois, host - детализация статистики;
rm, cp, du, mv, grep, chmod - файловые операции
желателен локальный кэширующий dns сервер
|
При выборе конфигурации сервера для установки системы TreeGraph мы рекомендуем уделить внимание всем комплектующим. Более быстрый процессор сокращает время генерации HTML страницы из объектов XML/XSL - это наиболее ресурсоемкий процесс. Несколько процессоров обеспечат работу сайта при большом наплыве посетителей. Большой объем оперативной памяти позволит запоминать результаты частых запросов к базе данных. Скоростной SCSI или SAS винчестер уменьшит задержки по всем операциям.
На что обратить внимание при установке.
- Рекомендуется RAID уровня 1, 5, 10.
- Рекомендуется отдельный диск для резервных копий.
- VLM не используем. Дробим разделы, чтобы сделать отдельными /var/log /tmp /www /mysql. Последние в отношении размеров 50 на 50. Это соотношение действует для большинства проектов. Основной принцип в разметке - в случае краха иметь возможность вытащить данные.
- FTP и Apache должны уметь создавать файлы, общие для редактирования. Для ProFTPd и Apache это возможно.
- Меры защиты типа jail, chroot и т.д. теоретически возможны, но могут потребовать дополнительной совместной работы в плане доступа к необходимым библиотекам php.
- Возможна замена Apache на другой веб сервер.
- Реомендован кэширующий DNS.
- При настройке фаервола следует учесть, что сайт может обращаться к другим серверам, зачитывая xml или rss. А так же использует сервер конвертера форматов от разработчика.
| 3. Административные модули
Административные
модули TreeGraph предназначены для контроля, управления и
развития сайта. К ним относятся:
| 3.1. Джей-менеджер
Джей-менеджер (далее JM) – основной инструмент администратора
сайта, созданного по технологии TreeGraph. Модуль JM обладает дружественным интерфейсом и не
требует специальных знаний от администраторов, кроме обычных навыков работы с
интернет-броузером.
Этот инструмент
позволяет администратору добавлять, удалять, редактировать, копировать или
перемещать в другой раздел любую страницу или целую ветвь сайта. Возможно
изменение и добавление как текстовой, так и графической информации. Встроенный
конвертор позволяет публиковать как простые тексты, так и документы в форматах HTML, RTF, Microsoft Word, Microsoft Excel. Модуль JM также имеет визуальный редактор с
интерфейсом, приближенным к программе Microsoft Word, который позволяет редактировать страницы
со сложным оформлением в режиме WYSIWYG (принцип - "что вы видите, то и
получаете"). При таком подходе пользователи могут легко публиковать
сложные документы с графикой, диаграммами, таблицами, не нарушая общего
оформления сайта.
Войти в модуль JM можно по адресу http://адрес_сайта/7 или через меню администратора по ссылке jmanager (после авторизации на сайте).
Внешний вид JM представлен на рис. 1. В верхней части
окна расположена контрольная панель
управления и настроек. Остальная часть окна разбита на несколько управляющих и
информационных панелей. Каждая
панель имеет свой заголовок и для наглядности обведена рамкой. Все панели можно
закрывать или открывать щелчком мыши на заголовке панели (или значке +/- перед
заголовком).

|
Рис. 1. Внешний вид модуля JM
|
В левой части окна
расположена основная панель ДЕРЕВО САЙТА с объектами (страницами и разделами
сайта), под ним - панель ФИЛЬТР (для групповых операций над объектами) и панель
ИМПОРТ (для потокового ввода информации). Справа выводятся различные панели с
формами для редактирования, информацией, диагностикой действий администратора и
другие.
JM может работать в
следующих режимах: основном, упрощенном
и текстовом. Упрощенный режим предназначен для администраторов с
ограниченными правами. В этом случае отдельные панели и некоторые функции JM становятся недоступными. Текстовый режим
отключает графические изображения пиктограмм в дереве сайта для ускорения
работы JM при низкоскоростном
соединении. Текущий режим работы JM задается параметрами самого объекта JM, параметрами администратора (пользователя сайта)
и опциями контрольной панели. Подробнее о режимах см. Настройки JM. Язык интерфейса JM задается параметром "язык сайта или
подраздела". По умолчанию он совпадает с языком, заданным для всего сайта.
Контрольная панель JM (рис. 2) состоит из пяти основных частей:
-
Информация о статусе JM
-
Поле
для индикации и ввода идентификатора корня дерева (или ветви), отображаемой на
панели.
-
Поле
для индикации и ввода идентификатора текущего объекта в дереве.
-
Меню управления текущего объекта.
-
Настройки
интерфейса и режимов работы JM (отсутствуют в упрощенном режиме).

|
Рис. 2. Контрольная панель JM для текущего объекта (текстовый режим
панели)
|

|
Рис. 3. Контрольная панель JM для текущего объекта (графический режим
панели)
|
Модуль JM во время работы может находится в одном
из трех состояний: …, ready (готов) , busy... (запрос…) .
Статус "…" появляется
только при старте JM. В этот
момент производится начальная загрузка всех требуемых данных и настроек модуля.
После загрузки всех данных JM переходит в состояние ready. После любой команды
администратора на несколько мгновений появляется статус busy… В этом состоянии JM обрабатывает текущую команду – передает, получает
и отображает различную информацию с сервера. Начинать работу с JM или давать новую команду нужно только
после появления статуса ready. Внимание!.
Обработка некоторых команд (особенно групповых в фильтре, импорте и др.) может
занимать от нескольких секунд до нескольких минут. Если в результате какого-либо
сбоя или ошибки статус JM в
течении длительного времени остается в состоянии busy…, то необходимо перезагрузить всю страницу с модулем (клавиша F5 в IE).
Справа от статуса
расположены два поля с идентификаторами корня дерева и текущего объекта.
Стартовое значение корня дерева, как правило равно 1, т.е. на панели
отображаются все ветви сайта. Для администраторов с ограниченными правами
стартовое значение корня дерева может быть изменено с помощью настроек модуля JM и параметров пользователя (см. Настройки JM).
В этом случае в поле указывается слово root (корень).
Для ускорения работы
модуля или уменьшения размеров панели администратор может задать в качестве
корня дерева идентификатор любого объекта, который находится в пределах разрешенного
ему дерева. В этом случае, на панели ДЕРЕВО САЙТА будет отображаться только
указанный объект и его ветвь, если она имеется. Для оперативной установки
текущего корня дерева, можно можно нажать правую клавишу на пиктограмме или слева от заголовка объекта. Идентификатор
данного объекта будет установлен в качестве временного корня дерева. Для
возвращения к исходному состоянию панели, необходимо ввести в поле стартовое
значение корня и нажать клавишу Enter или нажать правую клавишу мыши в данном поле. Если объект с введенным
идентификатором отсутствует в разрешенных пределах, то также устанавливается
стартовое значение корня. Для смены текущего корня на один уровень выше можно
нажать пункт ^ ( ) контрольной панели или нажать правую
клавишу мыши для установки стартового значения корня.
Внимание! Если в модуле установлено какое-либо значение
корня дерева, то ВСЕ действия JM, включая выборки в ФИЛЬТРЕ, будут производиться только над объектами,
которые находятся в ветви данного корня.
Если в дереве сайта есть
текущий (выделенный) объект, то его идентификатор отображается во втором поле
контрольной панели. Для оперативного нахождения объекта в дереве сайта, можно
ввести его идентификатор в данное поле и нажать клавишу Enter. При этом раскрываются все ветви сайта от
корня до данного объекта, он становится текущим и модуль JM входит в режим редактирования. Если
объект с указанным идентификатором существует, но отсутствует в отображаемом
дереве сайта, то на информационной панели выдается диагностика "нет прав на
редактирование". В данном поле также можно ввести несколько первых
символов заголовка требуемого объекта и нажать Enter. Модуль JM найдет первое совпадение, начиная от текущего объекта вниз по дереву (или
от корня), установит найденный объект текущим и войдет в режим его
редактирования.
Меню управления
появляется на контрольной панели, если в дереве сайта есть текущий объект.
Состав пунктов меню зависит от типа объекта, его расположения в дереве и прав
администратора на определенные действия над объектом. Отдельные пункты меню
имеют различные действия при нажатии левой или правой клавиши мыши. Назначения
пунктов отображаются во всплывающих подсказках .
Слева указывается действие по нажатию левой клавиши мыши, справа от символа
слеш (/) - по нажатию правой клавиши. Все пункты меню контрольной панели
дублируются в контекстном меню объекта, которое можно вывести на экран нажатием
правой клавиши мыши на папке или заголовке объекта.
В правой части
контрольной панели расположены настройки интерфейса модуля JM и переключатели режимов работы. Подробнее
они описаны в главе Настройки Джей-менеджера.
Внешний вид панели
ДЕРЕВО САЙТА (рис. 1) очень похож на интерфейс Проводника системы Windows (Windows Explorer). В левой части
расположены папки (пиктограммы) и заголовки объектов (страниц и подразделов)
сайта. Правее заголовка могут быть указаны список страниц многостраничной
ветви, некоторые параметры объекта, количество дочерних объектов (в квадратных
скобках) и идентификатор объекта (рис. 4).

|
Рис. 4. Строки объектов в дереве сайта
|
Раскрытие и закрытие
ветвей дерева сайта производится с помощью пиктограмм  (плюс, минус), расположенных слева от папки
объекта. Знак "+" ( )
на контрольной панели раскрывает всю текущую ветвь, включая все ее подразделы. Знак
"-" ( )
на контрольной панели закрывает все подразделы текущей ветви. Во время работы JM "запоминает" состояние дерева и
настройки на время сессии броузера, т.е. при повторных обращениях к модулю
администратор увидит дерево сайта в том же самом состоянии.
Для всех
административных модулей в системе TreeGraph созданы несколько стандартных наборов
управляющих и информационных пиктограмм различных размеров. Администратор сайта
может выбирать любой из этих наборов и создавать свои дополнительные
пиктограммы для отображения в дереве объектов определенного типа или же для
использования в качестве графических элементов оформления в различных шаблонах
(стилях). Набор пиктограмм задается параметром "ресурсы по
умолчанию", установленным, как правило, в корне сайта (объект с
идентификатором 1). Для задания собственных пиктограмм создается специальный
объект на сайте и в корне сайта устанавливается параметр "графические
ресурсы", в котором указывается идентификатор этого объекта. Подробнее см.
главу Настройки JM.
Папки всех объектов в
дереве сайта показываются в соответствии с установленными графическими ресурсами
и типом объекта, т.е. набором и значением его параметров.

|
Рис. 5. Пример стандартного набора пиктограмм (размер
16х16 пикселей).
|
Если у администратора нет прав на изменение и
удаление какого-либо объекта, то папка этого объекта в строке дерева будет
показана полупрозрачной. Если нет прав на просмотр, то данной ветви просто не
будет в дереве сайта.
Обычно заголовки
объектов в дереве сайта выводятся черным
цветом. Заголовки объектов, закрытых от просмотра обычными посетителями сайта
показаны светло-серым, удаленных объектов - светло-коричневым. Перед заголовком удаленного объекта в квадратных
скобках указывается идентификатор ветви, из которой он был удален. Заголовки
объектов, не опубликованных на сайте, выделяются курсивом. См. Приложение
Атрибуты объектов. Если у объекта пустой заголовок, то в дереве сайта
справа от папки показывается строка "заголовок
отсутствует!".
Для отображения ветвей
с большим количеством дочерних объектов в JM предусмотрен механизм многостраничности (рис. 6).
Максимальное количество объектов на странице задается настройками JM. Подробнее см. главу Настройки
JM.
Список страниц ветви
(со ссылками на них) указывается в строке объекта после заголовка, текущая
страница выделяется жирным шрифтом.
В самой ветви на первой и последней строке указываются символы -+-, которые
служат ссылками на предыдущую и следующую страницы.

|
Рис. 6. Многостраничная ветвь в JM
|
В дереве сайта
расположены не только информационные разделы, но и другие объекты сайта. К ним
относятся: сервисные модули (поиск,
карта, регистрация, подписка), интерактивные
модули (форумы, анкеты, отзывы, голосования), административные модули (сам Джей-менеджер, статистика, параметры,
пользователи и др.). Кроме этого, существуют различные объекты (разделы)
специального назначения (корзина, классификаторы, образцы, блоки и др.).
Все административные
действия в JM производятся
над текущим (выделенным) объектом. Левый щелчок мыши на папке (пиктограмме) или
заголовке объекта в дереве сайта делает данный объект текущим. В этот момент на
контрольной панели (во втором поле) появляется идентификатор объекта и меню
управления, сама строка выделяется светло-серым фоном.
Для оперативного
нахождения объекта в дереве сайта, можно ввести его идентификатор или начало
зоголовка во втором поле контрольной панели и нажать Enter. При этом дерево сайта раскрывается для показа
данного объекта и модуль JM
входит в режим редактирования этого объекта.
Правый щелчок мыши на
объекте в дереве сайта делает его текущим и одновременно выдает выпадающее
контекстное меню данного объекта (рис. 7).

|
Рис. 7. Контекстное меню и подменю JM
|
Контекстное меню для
текущего объекта можно также вывести на экран левым щелчком мыши на пункте menu ( ) контрольной панели или "горячей
клавишей" Esc.
Положение меню будет определяться текущим положением курсора мыши на экране.
В контекстном меню,
как и на контрольной панели, указаны все допустимые действия администратора над
текущим объектом (просмотр, изменение, добавление, удаление, копирование и
др.). Набор этих действий зависит от свойств объекта и прав администратора на
данный объект.
Большинство операций
над текущим объектом доступны с помощью так называемых "горячих
клавиш". Их комбинации указаны на панели контекстного меню. Все
"горячие клавиши" действуют только в том случае, если в дереве сайта
есть текущий объект и в правой части окна JM нет панелей с формами, т.е. "горячие
клавиши" отключаются в момент добавления или редактирования объекта.
Отдельные пункты меню имеют выпадающие подменю для выбора типа
операции. Некоторые операции выводят дополнительные окна для подтверждения
действия администратора или ввода уточняющих значений.
| 3.1.1. Операции редактирования
| 3.1.1.1. Добавление нового объекта
Для добавления нового
объекта в дереве сайта нужно сделать правый щелчок мыши на родительском
объекте. В полученном контекстном меню выбрать пункт добавить и в подменю - тип добавляемого объекта. (рис. 1). Список
типов объектов соответствует значению параметра сайта "образец
дочерних". Образцы представляют собой объекты с определенным набором
параметров, расположенные в специальной ветви дерева сайта спецрубрики / database / образцы.
Администратор может создавать свои типы объектов и соответствующие им образцы.
Если в родительском
объекте задан параметр "образец дочерних", то его значение называется
дочерним по умолчанию для данного родителя. Соответствующая строка в
контекстном меню выделяется жирным шрифтом
и для операции добавления объекта этого типа назначается "горячая
клавиша" Insert. Если
данный параметр не задан, то при добавлении создается "пустой"
объект, т.е. в нем отсутствуют какие-либо параметры.

|
Рис. 1. Контекстное меню для добавления нового
объекта (основной режим работы JM).
|
При выборе пункта
контекстного подменю другое…
администратору выдается окно для задания идентификатора объекта, которое будет
служить образцом нового объекта (рис. 2).

|
Рис. 2. Окно ввода идентификатора образца для
нового объекта.
|
В упрощенном режиме
работы JM администратор может
добавить только объект, заданный параметром "образец дочерних" или
"пустой" объект, если данный параметр не задан в родительском. Эта
операция выполняется с помощью пункта контекстного меню "Добавить"
или add ( ) контрольной
панели.
После выбора типа
добавляемого объекта соответствующий образец копируется к указанному родителю
вместе со всеми его параметрами. Новому объекту сразу же присваивается
уникальный идентификатор и он становится текущим в дереве. Вместо пустого
заголовка в строке дерева показывается текст "заголовок
отсутствует!" (рис. 3).
Если в начале заголовка образца указан ключевой тег < FULL> , то образец копируется полностью,
вместе с заголовком, аннотацией и контентом. Если образец имеет дочерние
объекты, то вновь создаваемый объект будет иметь аналогичную ветвь с дочерними.
Положение объекта в
текущей ветви будет соответствовать значению параметра "сортировка
дочерних", установленному в родительском объекте. Если данный параметр не
установлен, то новый объект будет самым первым (верхним) в текущей родительской
ветви.

|
Рис. 3. Добавление нового объекта (основной
режим работы JM)
|
Справа от дерева сайта
будут выведены панели с формами для ввода атрибутов и параметров нового объекта
(рис. 3). Дата публикации объекта заполняется текущей серверной датой и
временем. Владельцем объекта по умолчанию устанавливается администратор,
производящий данную операцию ввода. Группа и права на объект по умолчанию
устанавливается в соответствии с группой и правами родительского объекта. Если
в родительском объекте заданы параметры "владелец объекта
(сообщения)", "группа пользователей" или "права объектов
(сообщений)", то владелец, группа или права нового объекта будут
установлены в соответствии со значениями данных параметров. Права на чтение
объекта сбрасываются в 0, если в настройках JM установлена опция hidden.
Ввод атрибутов и
параметров, добавление и удаление установленных параметров производятся
аналогично операции изменения (редактирования) объекта. Для
завершения ввода нового объекта, после заполнения необходимых полей нужно
нажать клавишу ввести на панели УПРАВЛЕНИЕ
или под формой для ввода текста. Клавиша сбросить
восстанавливает значения всех полей в соответствии с образцом добавляемого
объекта. Клавиша удалить выполняет
операцию удаления данного объекта.
| 3.1.1.2. Изменение (редактирование) объекта
Вход в режим
редактирования объекта осуществляется через контекстное меню (пункт изменить) или пункт edit ( ) контрольной
панели. "Горячая клавиша" для изменения текущего объекта - Enter или двойной щелчок левой клавиши на папке
(заголовке) объекта. Для оперативного нахождения объекта в дереве сайта и входа
в режим редактирования, можно ввести его идентификатор (или первые буквы
заголовка) в втором поле контрольной панели и нажать Enter.
Справа от дерева будут
выведены несколько панелей с формами для редактирования. Поля элементов форм
будут заполнены установленными значениями атрибутов и параметров данного
объекта (рис. 1).

|
Рис. 1. Редактирование объекта (основной режим
работы JM)
|
В основном режиме
работы JM все формы для
редактирования разделены на пять панелей:
- АТРИБУТЫ – поля
для ввода основных атрибутов объекта (даты публикации, заголовка,
аннотации и текста).
- УСТАНОВЛЕННЫЕ ПАРАМЕТРЫ – поля для ввода значений установленных параметров объекта.
- НЕУСТАНОВЛЕННЫЕ ПАРАМЕТРЫ – список всех параметров сайта, разделенных на группы.
- ВЛАДЕЛЕЦ, ПРАВА
– поля для задания прав доступа к данному объекту.
- УПРАВЛЕНИЕ –
управляющая панель с кнопками для завершения операции или сброса ошибочно
введенных значений.
В упрощенном режиме
работы JM панели
НЕУСТАНОВЛЕННЫЕ ПАРАМЕТРЫ и ВЛАДЕЛЕЦ, ПРАВА отсутствуют (рис. 2). Т.е.
администратор в этом режиме может только изменять те параметры, которые были
установлены в редактируемом объекте и не может их удалять, а также изменять
права доступа объекта (владельца, группу, права).

|
Рис. 2. Редактирование объекта (упрощенный режим
работы JM)
|
Панель АТРИБУТЫ
Данная панель
предназначена для ввода и изменения основных атрибутов объекта. В заголовке
панели указывается идентификатор текущего объекта. На самой панели отображаются
поля форм для редактирования (рис. 3).

|
Рис. 3. Панель
АТРИБУТЫ.
|
Дата публикации - день и время публикации объекта на сайте в
формате ДД.ММ.ГГГГ ЧЧ:ММ. Это поле задает дату, когда объект станет доступным
для просмотра посетителями сайта. Объекты можно вводить "впрок", т.е.
с более поздней датой, чем текущая. Такие объекты будут видны в модуле JM, но станут доступны посетителям сайта
начиная с указанной даты и времени. Заголовки таких объектов в JM показываются курсивом.
Заголовок - заголовок объекта (строка до 254 символов). Эта
строка используется в качестве заголовка страницы данного объекта, а также для
формирования списков объектов различными стилями (блоков). Как правило,
заголовок объекта также используется для формирования служебного тега < title > (окна броузера на странице
этого объекта). Обязательное поле!
Аннотация - краткое описание объекта (текст до 64К). Как
правило, используется вместе с заголовком при формировании различных списков
(блоков).
Текст - основной текст объекта (контент). Текст может быть обычным или в
стандарте HTML. В обычном
тексте абзацы разделяются пустыми строками. Если в тексте встречаются символы
< или >, то текст интерпретируется по стандарту HTML. В этом случае текст может содержать любые
элементы оформления, ссылки (локальные и внешние) на иллюстрации (gif, jpeg) или другие файлы (архивы zip, документы excel, word, acrobat и др.). Двойной
щелчок мыши в любой месте данного поля увеличивает или уменьшает в два раза
высоту зоны редактирования. Это правило распространяется на редактирование всех
атрибутов и параметров объекта типа textarea.
Файл (doc, rtf, txt, html) - поле, альтернативное предыдущему. Администратор
может загрузить с локального компьютера файл с текстом данного объекта. В этом
случае весь контент заменяется на содержимое загружаемого файла или результат
работы встроенного конвертора.
В качестве контента
объекта можно загружать файлы следующих форматов:
- Текстовые файлы (*.txt) - загружаются "как есть",
т.е без преобразования в HTML (кроме пустых строк и ссылок).
- HTML-файлы (*.html, *.htm) - оптимизируются и требуют
дополнительной подзагрузки связанных файлов.
- Документы в формате RTF (*.rtf) - конвертируются в HTML, встроенные файлы загружаются
автоматически.
- Документы Microsoft Word (*.doc) -
конвертируются в HTML,
встроенные файлы загружаются автоматически.
- Таблицы Microsoft Excel (*.xls) -
конвертируются в HTML.
Слева от поля
"текст" выводятся несколько ссылок для работы с буфером MS Windows, содержимым данного поля и загруженным файлом (рис. 3):
- cut - вырезает содержимое поля "текст" в буфер MS Windows
- copy - копирует содержимое поля "текст"
в буфер MS Windows
- clear - очищает содержимое поля "текст"
- paste - вставляет содержимое буфера MS Windows в поле "текст"
- exch - заменяет содержимое поля "текст"
на содержимое буфера MS Windows (т.е. clear + paste)
- edit - запускает встроенный редактор JEditor для изменения поля
"текст". Описание см. в разделе Редактор JEditor.
Пиктограмма дает ссылку на просмотр контента
редактируемого объекта в отдельном окне. Рядом с ссылкой указывается дата
последней модификации (изменения) объекта и размер контента в килобайтах (без
графики и других внешних файлов). Если контент у редактируемого объекта пустой,
то данная ссылка отсутствует.
Если в предыдущие
сеансы редактирования (или ввода) данного объекта в качестве контента были
загружены файлы в формате DOC, RTF или XLS, то в следующей строке указывается ссылка
в виде пиктограммы на последний загруженный файл. Рядом
указывается дата последней загрузки и размер файла в килобайтах.
Последней строкой
указывается ссылка в виде пиктограммы на создание (генерацию) файла в формате MS Word из текущего контента (содержимого поля "текст").
Панель УСТАНОВЛЕННЫЕ ПАРАМЕТРЫ
Панель предназначена
для редактирования и удаления установленных параметров объекта. На ней
отображаются поля для ввода только тех параметров, которые присутствуют в
данном объекте или добавлены администратором из панели НЕУСТАНОВЛЕННЫЕ
ПАРАМЕТРЫ (см. описание панели ниже). Все поля параметров сгруппированы в отдельные
подпанели в соответствии с их группами. В заголовке каждой подпанели
указывается название группы параметров. Для удобства редактирования подпанели
можно открывать и закрывать также, как и панели JM, левым щелчком мыши на заголовке. Слева
указываются названия параметров и некоторая дополнительная информация, справа -
поля форм для редактирования. Элементы форм показываются в соответствии с типом
параметров (переключатели, текстовые поля, радио-кнопки и др.) (рис. 4).
Для графических
параметров рядом с формой указывается тип файла (gif, jpg, png), и его размер в
пикселях и байтах. Если изображение имеет больший размер, чем задано
настройками JM, то оно
показывается не масштабируемым, а обрезанным по ширине и/или высоте. Само
изображение служит ссылкой для просмотра всего файла в отдельном окне. Слева от
графики указываются ссылки для работы с изображением с помощью встроенного
графического редактора (изменить, иконка, восстановить, bak). Описание см. в разделе Встроенный
графический редактор.
Вместе с изображением
предлагается ввести дополнительное поле "alt" для альтернативного текста. Если при вводе
параметра данное поле оставить пустым, то оно заполняется текстом заголовка
объекта.

|
Рис. 4. Панель
УСТАНОВЛЕННЫЕ ПАРАМЕТРЫ.
|
Рядом с файловыми
параметрами указывается имя файла, ссылка на сам файл и его размер в байтах.
Для параметров
типа textarea действует
следующее правило: двойной щелчок мыши в любой месте текстового поля
увеличивает или уменьшает в два раза высоту зоны редактирования. Правый щелчок
мыши на списке для параметра типа select делает данный список многострочным, т.е. показывает все возможные значения
параметра.
Для удаления параметра
из объекта необходимо сделать левый щелчок на имени параметра. При этом строка
параметра исчезнет из текущей панели и появится в панели НЕУСТАНОВЛЕННЫЕ
ПАРАМЕТРЫ (данная панель может быть закрыта). Внимание! Фактическое изменение или удаление параметров произойдет
только после окончания процесса редактирования, т.е после нажатия кнопки ввести на панели УПРАВЛЕНИЕ. Если
администратор ошибочно удалил какие-либо параметры, он может восстановить их
значения, нажав кнопку сбросить на
панели УПРАВЛЕНИЕ.
Панель НЕУСТАНОВЛЕННЫЕ ПАРАМЕТРЫ
Данная панель
предназначена для добавления новых параметров к объекту, т.е. тех, которые не
были установлены в нем. При входе в режим редактирования это панель закрыта (в
упрощенном режиме работы JM
она отсутствует). На панели отображаются имена и названия переменных всех
параметров сайта, кроме тех, которые уже установлены в редактируемом объекте
(рис. 5).

|
Рис. 5. Панель
НЕУСТАНОВЛЕННЫЕ ПАРАМЕТРЫ.
|
Все параметры
сгруппированы в отдельные подпанели в соответствии с их группами. В заголовке
каждой подпанели указывается название группы параметров. Для удобства редактирования
подпанели можно открывать и закрывать также, как и панели JM, левым щелчком мыши на заголовке. Для
добавления параметра к объекту необходимо сделать левый щелчок на имени
параметра или соответствующей переменной. Под списком параметров каждой группы
указывается ссылка **ИМЯ_ГРУППЫ, при нажатии на которую к объекту добавляются
все параметры данной группы.
При добавлении
параметров соответствующие строки исчезают из данной панели и перемещаются в
вышестоящую панель УСТАНОВЛЕННЫЕ ПАРАМЕТРЫ. После выполнения этой операции
необходимо ввести нужные значения добавляемых параметров в соответствующих
полях формы (рис. 6).

|
Рис. 6. Пример добавления неустановленного
параметра.
|
Внимание! Фактическое добавление параметров и установка их
значений произойдет только после окончания процесса редактирования, т.е после
нажатия кнопки ввести на панели
УПРАВЛЕНИЕ.
Панель ВЛАДЕЛЕЦ, ПРАВА
Данная панель
предназначена для установки атрибутов объекта, управляющих правами доступа к
нему (в упрощенном режиме работы JM эта панель отсутствует, кроме того, наличие этой панели управляется
локальными настройками каждого конкретного администратора). На панели
отображаются поля "владелец", "группа", "права" и
показывается IP-адрес/ хост,
с которого был введен данный объект (рис. 7). В списке владельцев указываются
все пользователи сайта, кроме "подписчиков". В списке групп - все
группы сайта. В поле "права" отображаются шесть переключателей (rg, wg, xg; ro, wo, xo), задающих права
доступа для группы и остальных посетителей сайта. Назначение переключателей
(слева - направо):
1. (rg) – право на чтение (просмотр) объекта для
выбранной группы пользователей;
2. (wg) – право на запись, т.е. редактирование и
удаление объекта для выбранной группы пользователей;
3. (xg) – право на добавление дочерних к данному
объекту для выбранной группы пользователей;
4. (ro) – право на чтение (просмотр) объекта для
всех посетителей, данный переключатель устанавливается у всех открытых для
общего пользования объектов, объекты, у которых данный переключатель отключен
отображаются в дереве сайта серым цветом (объекты с ограниченным доступом);
5. (wo) – право на запись для всех посетителей
(для того, чтобы иметь возможность редактировать что-либо, кроме наличия
данного права, пользователю нужно еще, как минимум, иметь права на доступ к
соответствующему административному модулю);
6. (xo) – право на добавление дочерних к данному
объекту для всех посетителей, данный переключатель должен быть установлен у
общедоступных форм и форумов, где запись сообщений разрешена неавторизованным
посетителям.
Подробнее см. описание
модуля Пользователи и Приложение Атрибуты.

|
Рис. 7. Панель
ВЛАДЕЛЕЦ, ПРАВА.
|
Справа от каждого поля
имеется переключатель ветвь. Если
при редактировании объекта он включается, то значение соответствующего атрибута
(владелец, группа или права) будет установлен для всех объектов данной ветви
(если у администратора есть права на их редактирование).
Внимание! Фактическая установка прав доступа произойдет только
после окончания процесса редактирования, т.е. после нажатия кнопки ввести на панели УПРАВЛЕНИЕ.
Панель УПРАВЛЕНИЕ
На данной панели
расположены три управляющие клавиши и ссылка log на модуль watch для просмотра всех административных действий над
текущим объектом (рис. 8).

|
Рис. 8. Панель
УПРАВЛЕНИЕ.
|
Кнопка ввести завершает процесс редактирования
объекта и загружает все графические и файловые параметры на сервер.
Кнопка сбросить восстанавливает значения всех
атрибутов и параметров объекта на те, которые были в момент входа в режим
редактирования. Кнопка удалить
выдает окно подтверждения удаления и перемещает объект в специальный раздел
дерева сайта Trash. (См.
операцию Удаление и восстановление объекта).
Завершение ввода, загрузка и удаление файлов
Если в качестве
контента объекта был загружен файл формате DOC, XLS или RTF, то модуль JM осуществляет конвертирование документа в
стандарт HTML и автоматически
загружает на сервер все встроенные иллюстрации, диаграммы и т.п. Результат операции
ввода объекта и работы конвертора будет отображен на панели ИНФОРМАЦИЯ (рис.
9). Если в директории данного объекта есть "потерянные" файлы, т.е.
те на которые в тексте отсутствуют локальные ссылки (без http://), то на панели выводится список этих
файлов с переключателями для их удаления.

|
Рис. 9. Панель с информацией о результате
редактирования и работы конвертора.
|
Если в контент был
загружен HTML-файл с
локальными ссылками (без http://) или в тексте контента есть ссылки на различные файлы (иллюстрации,
архивы и т.п.), то после нажатия кнопки ввести
в правой части окна JM будет
выведена панель ФАЙЛЫ (рис. 10). На этой панели перечисляются все имена файлов,
на которые есть ссылки, их статус (наличие или отсутствие в директории объекта на
сервере) и кнопки Обзор… (Browse...) для загрузки файлов с локального
компьютера. Кроме этого, также выводится список "потерянных" файлов с
переключателями для их удаления.

|
Рис. 10. Панель ФАЙЛЫ.
|
Те файлы, которые
будут введены администратором кнопками Обзор...
(Browse...), загружаются на
сервер под соответствующими именами и результат загрузки отображается на панели
ИНФОРМАЦИЯ (рис. 11).

|
Рис. 11. Панель с информацией о результате
загрузки и удалении файлов.
|
При различных сбоях
работы конвертора или ошибках чтения/записи файлов на панели ИНФОРМАЦИЯ будет
выведена соответствующая диагностика.
| 3.1.1.3. Редактирование графики
Если объект содержит
какие-либо графические параметры (графика, иконка и др.), то Вы можете
воспользоваться встроенным графическим редактором для модификации этих
изображений (изменения размеров, обрезки, применения различных эффектов и др.).
Подробно этот модуль описан в разделе Графический редактор.
Для редактирования основной графики объекта (параметр "графика")
можно воспользоваться пунктом графика
контекстного меню или пунктом img ( ) контрольной панели. Для модификации других
графических параметров необходимо войти в режим редактирования или просмотра
свойств объекта и нажать на ссылку изменить
слева от соответствующего изображения нужного параметра (рис. 1).

|
Рис. 1. Вызов встроенного редактора для
изменения различных графических параметров.
|
Ссылка восстановить заменяет текущий параметр
на предыдущую сохраненную копию изображения. Ссылка bak дает возможность
просмотра сохраненной копии в отдельном окне. После завершения работы
графического редактора предыдущая копия будет заменена текущим изображением, а
текущее заменится на вновь созданный файл. Т.е. сохраняется только одна
(последняя) копия изображения.
Для выполнения
групповой операции изменения графических параметров объектов в ФИЛЬТРЕ
необходимо сформировать выборку и сделать текущей строку все выбранные. Затем нажать пункт img ( ) контрольной панели или пункт графика контекстного меню. В правой
части экрана будет выведена панель ГРАФИКА со списком выбранных объектов для
задания размеров, формата и других характеристик выходных файлов (рис. 2).

|
Рис. 2. Изменение параметра "графика" для выборки объектов.
|
В панели ПАРАМЕТРЫ
необходимо выбрать графический параметр (или несколько), над которым будет
производится данная операция.
Если необходимо
выполнить масштабирование графики и нескольких последовательных эффектов, то
размеры выходных файлов и применяемые эффекты необходимо задавать в в текстовом
поле "эффект" в формате, аналогичном значению параметра "эффекты
графики". Если достаточно только одного эффекта, то его можно задать в
соответствующих полях формы.
| 3.1.1.4. Создание иконки
Если объект содержит
основное графическое изображение, заданное параметром "графика" (icon), то для него можно создать иконку -
уменьшенную копию, требуемого размера. Для автоматической генерации иконки
нужно нажать правую клавишу мыши на пункте icon ( )
контрольной панели. Размер и формат иконки в этом случае будет определяться
текущими значениями параметра "эффекты иконки" (view_make_icon_e). Он может быть задан
в любом родительском объекте.
Значение данного
параметра указываются в виде отдельных строк в формате:
ключ1=значение1
ключ2=значение2
Ключи
масштабирования и автоиконок:
i=ИМЯ_ПАРАМЕТРА
|
задает имя графического
параметра, который будет служить автоиконкой для
данного. Умолчанием для параметра "графика" (icon) служит параметр "иконка" (view_icon_photo). Тип и размер автоиконки задается в
аналогичной параметре "эффекты иконки".
|
|
|
t=ЧИСЛО
|
задает тип (формат) выходного
файла
|
t=0
|
не применять масштабирование
или автоматическое создание иконки
|
t=1 или t=gif
|
выходной формат - GIF
|
t=2 или t=jpg
|
выходной формат - JPG
|
t=3 или t=png
|
выходной формат - PNG
|
t=4 или t=orig
|
выходной формат совпадает с
форматом оригинала
|
|
|
x=ЧИСЛО
|
максимальная или точная ширина
выходного файла
|
y=ЧИСЛО
|
максимальная или точная высота
выходного файла
|
|
|
z=ЧИСЛО
|
совмещение изображений
выходного файла и оригинала (по умолч. - p)
|
z=0 или z=с
|
совпадают центры изображений
|
z=1 или z=lt или z=tl
|
совпадают левые верхние углы
|
z=2 или z=rt или z=tr
|
совпадают правые верхние углы
|
z=3 или z=rb или z=br
|
совпадают правые нижние углы
|
z=4 или z=lb или z=bl
|
совпадают левые нижние углы
|
z=5 или z=p
|
совпадают все углы, т.е. в
выходном файле сохраняются пропорции оригинала
|
z=6 или z=tc или z=ct
|
«портретный» режим: если высота
оригинального изображения больше ширины – совпадают оба верхних угла, в
противном случае совмещаются центры
|
Примечания.
1. Если один из ключей
x или y не задан, то выходной файл всегда сохраняет
пропорции оригинала, независимо от значения ключа z.
2. Если значение ключа
z задано от 0 до 4 и указаны
оба ключа x и y, то они будут задавать не максимальный, а
точный размер выходного файла.
Ключи дополнительных
эффектов:
ключи
|
умолчание
|
описание
|
e=СИМВОЛ
|
|
задает тип эффекта
|
e_XXX=СТРОКа
|
|
дополнительные параметры эффекта
|
|
|
|
e=c
|
|
обрезка изображения (canvas)
|
e_x=ЧИСЛО
|
ширина оригинала
|
ширина выходного файла
|
e_y=ЧИСЛО
|
высота оригинала
|
высота выходного файла
|
e_color=XXXXXX
|
FFFFFF
|
цвет свободного фона
|
|
|
|
e=b
|
|
рамка, бордюр (border)
|
e_color=XXXXXX
|
333333
|
цвет бордюра
|
e_x=ЧИСЛО
|
1
|
толщина бордюра
|
|
|
|
e=r
|
|
поворот (rotate)
|
e_x=ЧИСЛО
|
90
|
угол поворота в градусах
|
e_color=XXXXXX
|
FFFFFF
|
цвет свободного фона
|
|
|
|
e=t
|
|
добавление текста (text)
|
e_color=XXXXXX
|
FFFFFF
|
цвет текста
|
e_trans=ЧИСЛО
|
50
|
прозрачность текста от 0 до 100
|
e_x=ЧИСЛО
|
(ширина оригинала) - (ширина
текста)
|
позиция левого края текста от
левого края оригинала в пикселах
|
e_y=ЧИСЛО
|
(высота оригинала) - (высота текста)
|
позиция верхнего края текста от
верхнего края оригинала в пикселах
|
e_text=ТЕКСТ
|
копирайт сайта
|
сам текст
|
e_font=ЧИСЛО
|
6
|
номер системного шрифта от 1 до
7
|
|
|
|
e=w
|
|
водяной знак (watermark) использует параметр "водяной
знак"
|
e_trans=ЧИСЛО
|
30
|
прозрачность знака от 0 до 100
|
e_x=ЧИСЛО
|
(ширина оригинала) - (ширина знака)
|
позиция левого края знака от
левого края оригинала в пикселах
|
e_y=ЧИСЛО
|
(высота оригинала) - (высота знака)
|
позиция верхнего края знака от
верхнего края оригинала в пикселах
|
|
|
|
Для задания нескольких
последовательных эффектов к ключам добавляется порядковый индекс с номером
эффекта. Пример:
t=gif
x=72
y=72
z=p
e[0]=c
e_x[0]=88
e_y[0]=88
e_color[1]=FFFFFF
e[1]=b
e_x[1]=4
e_color[1]=FF3300
e[2]=w
|
В данном случае
последовательность обработки загруженного оригинала следующая:
1. Из оригинала создается уменьшенная копия в формате GIF размером не более 72 пикселов по ширине и высоте при сохранении пропорций
оригинала
2. Полученное ихображение дополняется по ширине и
высоте белым фоном до размера 88х88 пикселов.
3. По краям изображения строится красная рамка (бордюр) толщиной 4 пиксела
4. В правом нижнем углу (по умолчанию) добавляется водяной знак (текущее
значение параметра watermark)
|
Созданный графический
файл сохраняется в параметре "иконка для фото" (или в параметре,
указанном ключом i=) и служит для отображения объекта различными
стилями в списках.

|
Рис. 1. Результат выполнения генерации иконки на панели ИНФОРМАЦИЯ.
|
Для
"ручного" создания иконки нужно нажать левую клавишу мыши на пункте icon ( )
контрольной панели или воспользоваться пунктом иконка контекстного меню.
При этом запускается встроенный графический редактор, который позволяет создать иконку произвольных
размеров с применением различных эффектов. Если в объекте уже присутствовала
иконка, то после завершения работы редактора текущее изображение заменится на
вновь созданный файл.
Для выполнения
групповой операции создания иконки в ФИЛЬТРЕ необходимо сформировать выборку и сделать текущей строку все
выбранные. Затем нажать пункт icon ( )
контрольной панели или пункт иконка контекстного меню. В правой части
экрана будет выведена панель ИКОНКА со списком выбранных объектов для задания
размеров, формата и других характеристик выходных файлов (рис. 2).

|
Рис. 2. Создание иконок для выборки объектов.
|
Если необходимо
создать иконку и применить нескольких последовательных эффектов, то размеры
иконки и применяемые эффекты необходимо задавать в в
текстовом поле "эффект" в формате, описанном выше. Если достаточно
только одного эффекта, то его можно задать в соответствующих полях формы.
| 3.1.1.5. Удаление и восстановление объекта
Для удаления текущего
объекта нужно выбрать пункт удалить
в контекстном меню, пункт del ( ) контрольной панели или нажать клавишу Delete. Данная операция будет произведена только
после подтверждения действия в отдельном окне (рис. 1).

|
Рис. 1. Окно подтверждения удаления объекта.
|
Если операция
подтверждена, то данный объект перемещается в специальный раздел дерева сайта Trash (корзина, аналог Recycle Bin Microsoft Windows), и права на его чтение устанавливаются равными 0, т.е. страница данного
объекта становится закрытой от просмотра обычными посетителями сайта.
Внимание! Необходимо отметить, что если удаляемый объект
имеет дочерние, то данная операция удалит всю
ветвь, т.е. сам объект и все его потомки будут перемещены в
"корзину". При этом структура ветви сохранится, а права на чтение
будут установлены в 0 для всех объектов удаленной ветви. Если операция удаления
производится над объектом, уже находящимся в "корзине", то текущий
объект и все его дочерние будут полностью удалены из базы данных вместе с внешними
файлами. Внимание! Данная операция
необратима.
Для восстановления
ошибочно удаленного объекта, необходимо раскрыть ветвь спецрубрики / Trash, найти объект (или ввести его
идентификатор во втором поле контрольной панели), нажать правую клавишу мыши и
выбрать пункт меню восстановить
(рис. 2).

|
Рис. 2. Восстановление удаленного объекта.
|
В строке заголовков
объектов, находящихся в "корзине", указывается идентификатор
родителя, из ветви которого был удален данный объект. При восстановлении объект
перемещается в "свою" ветвь и администратору выдается запрос на
восстановление прав на чтение для объекта (рис. 3).

|
Рис. 3. Окно запроса на восстановление прав на чтение объекта.
|
Внимание!. В "корзине" запоминается только
идентификатор родителя объекта, но не положение его в ветви. Поэтому, после
восстановления, данный объект окажется первым (верхним) в своей ветви (или в
соответствии с заданной сортировкой). Для задания требуемого положения объекта
необходимо воспользоваться операциями передвижение или сортировка.
| 3.1.1.6. Очистка ветви
Операция очистка ветви
удаляет все дочерние объекты текущего объекта. Для выполнения данной операции
нужно выбрать пункт очистить в
контекстном меню или правую клавишу на пункте del ( ) контрольной панели и подтвердить выполнение
в отдельном окне.

|
Рис. 1. Окно подтверждения очистки ветви.
|
Все удаляемые
объекты будут перемещены в специальный раздел дерева сайта Trash ("корзина") и права на чтение
для них будут установлены в 0.
Внимание! Необходимо отметить, что если удаляемые объекты
имеет дочерние, то они тоже будут удалены. При этом структура каждой ветви
сохранится, а права на чтение будут установлены в 0 для всех объектов удаляемых
ветвей.
Если данная операция
производится над объектом Trash ("корзина", id=99), то все объекты "корзины" будут удалены из базы данных
сайта. Внимание! Данная операция
необратима.
Результат выполнения
операции очистки ветви будет выведен на панели ИНФОРМАЦИЯ.
| 3.1.1.7. Изменение прав доступа
Изменение прав доступа
к текущему объекту или его ветви производится в режиме редактирования. Вход в этот режим осуществляется через
контекстное меню (пункт изменить) или пункт edit ( )
контрольной панели. "Горячая клавиша" для текущего объекта - Enter или двойной щелчок левой клавиши на папке
(заголовке) объекта.
Права доступа текущего
объекта определяются установленными значениями его атрибутов
"владелец", "группа пользователей" и "права".
Поля для задания этих значений располагаются в панели ВЛАДЕЛЕЦ, ПРАВА (в нижней
части формы для редактирования). В упрощенном режиме работы JM эта панель отсутствует, кроме того,
наличие этой панели управляется локальными настройками каждого конкретного
администратора.
На панели отображаются
текущие значения указанных атрибутов и показывается IP-адрес/ хост, с которого был введен данный объект
(рис. 1).
В списке владельцев указываются все пользователи
сайта, кроме тех, которые входят только в группу "по умолчанию"
("подписчики")[1]. Указанный в данном поле
пользователь будет обладать полными правами на данный объект[2]. Пользователь с именем
"root" всегда
обладает полными правами для любых объектов.
В списке групп - все группы пользователей,
существующие на сайте[3]. У всех пользователей,
входящих в группу "root"
всегда есть полные права на любые объекты.
В поле "права"
отображаются шесть переключателей (rg, wg, xg; ro, wo, xo), задающих права доступа для группы и
остальных посетителей сайта. Назначение переключателей (слева - направо):
1. (rg) – право на чтение (просмотр) объекта для
пользователей, входящих в выбранную группу (указанную в поле
"группа");
2. (wg) – право на запись, т.е. редактирование и
удаление объекта для пользователей, входящих в выбранную группу;
3. (xg) – право на добавление дочерних к данному
объекту для пользователей, входящих в выбранную группу;
4. (ro) – право на чтение (просмотр) объекта для
всех посетителей; данный переключатель устанавливается у всех открытых для
общего пользования объектов, объекты, у которых данный переключатель отключен
отображаются в дереве сайта серым цветом (объекты с ограниченным доступом);
5. (wo) – право на запись для всех посетителей
(для того, чтобы иметь возможность редактировать что-либо, кроме наличия
данного права, пользователю нужно еще, как минимум, иметь права на доступ к
соответствующему административному модулю);
6. (xo) – право на добавление дочерних к данному
объекту для всех посетителей, данный переключатель должен быть установлен у
общедоступных форм и форумов, где запись сообщений разрешена неавторизованным
посетителям.
Подробнее см. описание
модуля Пользователи и Приложение Атрибуты.

|
Рис. 1. Панель ВЛАДЕЛЕЦ, ПРАВА.
|
Справа от каждого поля
имеется переключатель ветвь. Если при редактировании объекта он
включается, то значение соответствующего атрибута (владелец, группа или права)
будет установлен для всех объектов данной ветви (если у администратора есть
права на их редактирование).
Внимание! Фактическая установка прав доступа
произойдет только после окончания процесса редактирования, т.е. после нажатия
кнопки ввести на панели УПРАВЛЕНИЕ.
Для выполнения
групповой операции по изменению прав доступа для произвольного набора объектов
необходимо сформировать
выборку требуемых
объектов в ФИЛЬТРЕ и сделать текущей строку все выбранные. Затем нажать
пункт rwx ( )
контрольной панели или пункт права контекстного меню. В правой части
экрана будет выведена панель ВЛАДЕЛЕЦ, ПРАВА для задания требуемых значений
(рис. 2).

|
Рис. 2. Установка владельца, группы и прав для выборки объектов.
|
Для тех атрибутов,
которые вы собираетесь установить в выбранных объектах, необходимо задать требуемое значение (из списка или
переключателями) и установить переключатель в колонке "изменить"
напротив атрибута. После нажатия кнопки ввести, у всех выбранных
объектов будут установлены заданные атрибуты. Те атрибуты, которые не были
отмечены в колонке "изменить" останутся в объектах без изменения.
В примере на рис. 2
для трех объектов, выбранных в ФИЛЬТР будут произведены следующие изменения:
1. Будет установлен владелец
"root" (т.е.
никакой конкретный владелец, фактически, не задан).
2. Право на
"чтение для группы" будет установлено в 1 (разрешено).
3. Право на
"чтение для всех" будет установлено в 0 (запрещено).
4. Группа
пользователей и остальные права останутся без изменений.
[1] Список пользователей в данном поле
может быть задан специальным образом с помощью модификатора «user_filter»,
применимого к конкретному профилю пользователя или к модулю JManager.
[2] Просмотр, изменение, удаление,
добавление дочерних. Для выполнения любых действий связанных с модификацией или
добавлением информации, кроме прав на объект, пользователю также потребуются
права на доступ к инструментам, позволяющим производить модификацию или
добавление информации (например, право на доступ к странице с работающим JManager-ом, интерактивной формой, форумом и
т.д.).
[3] В списке групп могут быть
отображены только требуемые группы, это настраивается модификатором «group_filter»
для конкретного пользователя или JManager-а, по аналогии с «user_filter».
| 3.1.1.8. Выборочное изменение параметров
Операции по выборочному
добавлению, замене и удалению параметров для текущего объекта по своей сути не
отличаются от обычного редактирования объекта.
Самостоятельное значение данные операции имеют при модернизации параметров для
группы объектов, находящихся в выборке фильтра.
Вызов данных операций
осуществляется через контекстное меню - пункты параметры / добавить выборочно, параметры / добавить (зменить) выборочно и параметры / удалить выборочно или пункт par ( ) контрольной панели (рис. 1).

|
Рис. 1. Контекстное меню для выборочного добавления, замены и удаления
параметров.
|
После выбора операции в
правой части JM выводится
панель ДОБАВЛЯЕМЫЕ ПАРАМЕТРЫ (или другая, соответствующая операции). В панели
перечисляются все параметры сайта, разбитые на группы (рис. 2). Раскрывая
панели групп, нужно выбрать те параметры, которые необходимо добавить к
объекту, установить их значения (в верхней части панели) и нажать клавишу ввести. Если выбрана операция удаление параметров, то вводить значения
не обязательно.

|
Рис. 2. Панель для выбора и задания значений добавляемых параметров.
|
Операция добавить выборочно работает следующим
образом:
1. Если выбранный параметр
установлен в объекте, то он остается без изменений.
2. Если выбранного параметра
нет в объекте, то он добавляется к него с заданным администратором значением.
Операция добавить (заменить) выборочно работает
следующим образом:
1. Если выбранный параметр
установлен в объекте, то он заменяется на значение, заданное администратором.
2. Если выбранного параметра
нет в объекте, то он добавляется к объекту с заданным значением.
Операция удалить выборочно удаляет все выбранные
администратором параметры из объекта.
Внимание! Операции
замены и удаления необратимы, т.е. восстановить ранее установленные параметры и
их значения можно будет только вручную.
Для выполнения групповых
операций по работе с параметрами необходимо сформировать выборку
требуемых объектов в ФИЛЬТРЕ и сделать текущей строку все выбранные. Затем выбрать пункт параметры контекстного меню и требуемый подпункт (добавить, заменить или удалить). Через меню контрольной панели
доступны операции по добавлению параметров - левая клавиша мыши на пункте par ( ) и замене параметров - правая клавиша мыши
на пункте par ( ). В правой части экрана будет выведена
соответствующая панель (ДОБАВЛЯЕМЫЕ, ЗАМЕНЯЕМЫЕ или УДАЛЯЕМЫЕ ПАРАМЕТРЫ).

|
Рис. 3. Изменение параметров для выборки объектов.
|
Все групповые
операции по изменению параметров для выборки аналогичны соответствующим
операциям для текущего объекта, описанным выше.
| 3.1.1.9. Изменение параметров по образцу
Операции по добавлению
(замене) параметров позволяют установить параметры текущего объекта в
соответствии с указанным образцом. Вызов данных операций осуществляется через
контекстное меню - пункты параметры /
добавить (заменить) по образцу и параметры
/ установить по образцу.

|
Рис. 1. Контекстное меню для добавления, замены и удаления параметров по
образцу.
|
После выбора операции
выдается окно запроса образца (рис. 2), в котором необходимо указать
идентификатор объекта, чьи параметры будут скопированы в текущий объект.

|
Рис. 2. Окно запроса образца на дабавление или замену параметров объекта.
|
Операция добавить (заменить) по образцу работает
следующим образом:
1. Если параметр
установлен и в объекте и в образце, то он заменяется на значение из образца.
2. Если параметр
установлен в объекте и его нет в образце, то он остается без изменений.
3. Если параметр есть
в образце и его нет в объекте, то он добавляется к объекту из образца.
Операция установить по образцу удаляет ВСЕ
установленные параметры в объекте и добавляет к нему ВСЕ параметры из образца.
Операция удалить ВСЕ параметры выдает окно (рис.
3) и после подтверждения удаляет ВСЕ параметры из текущего объекта.

|
Рис. 3. Окно подтверждения удаления параметров объекта.
|
Внимание! Операции
замены и удаления необратимы, т.е. восстановить ранее установленные параметры и
их значения можно будет только вручную.
| 3.1.2. Операции перемещения
| 3.1.2.1. Передвижение объекта по дереву
Для передвижения
текущего объекта внутри ветви нужно выбрать пункт передвинуть в контекстном меню и требуемый пункт в подменю (рис.
1).

|
Рис. 1 .Контекстное меню операции передвижения объекта.
|
Команда наверх делает текущий объект первым
(верхним) в его ветви. "Горячая клавиша" Alt-PageUp или левое нажатие на пункте | ( ) контрольной панели.
Команда вниз делает текущий объект последним
(нижним) в его ветви. "Горячая клавиша" - Alt-PageDown или правое нажатие на пункте | ( ) контрольной панели.
Команда выше передвигает объект в ветви на одну
строку вверх. "Горячая клавиша" - Alt-Стрелка вверх или левое нажатие на пункте | ( ) контрольной панели.
Команда ниже передвигает объект в ветви на одну
строку вниз. "Горячая клавиша" Alt-Стрелка вниз или правое нажатие на пункте | ( ) контрольной панели.
При выборе пунктов
контекстного подменю передвинуть над
и передвинуть под администратору
выдается окно для ввода идентификатора объекта, над (или под) которым надо поставить
текущий (рис. 2). "Горячие клавиши" для этих команд- Alt-Home и Alt-End или левое и правое
нажатие на пункте -- ( ) контрольной панели.

|
Рис. 2. Окно для ввода идентификатора объекта.
|
В этом окне можно
указать идентификатор не только объекта данной ветви, но и любого другого, т.е.
объект может быть перенесен в другую ветвь и установлен над (под) указанным
объектом. Если у текущего объекта есть дочерние, то они будут перенесены вместе
с ним, т.е. структура ветви полностью сохранится. Нельзя перенести объект в
ветвь, которая находится среди потомков текущего объекта.
Для выполнения данной
операции у администратора должны быть права не только на изменение текущего
объекта, но и на добавление к родительскому для указанного.
Результат выполнения
операции будет отображен на панели ИНФОРМАЦИЯ.
| 3.1.2.2. Сортировка дочерних объектов
Если у текущего
объекта в дереве сайта есть дочерние, то их можно отсортировать по значению
какого-либо атрибута или параметра.
Для выполнения данной
операции нужно выбрать пункт отсортировать
в контекстном меню и пункт в подменю, соответствующий нужному критерию
сортировки (рис. 1). Для пересортировки дочерних объектов в обратном порядке
можно выбрать пункт sort ( ) контрольной панели.

|
Рис. 1. Контекстное меню для сортировки объектов.
|
Основные критерии
сортировки перечислены в подменю:
- по алфавиту (по заголовку объекта)
- по
дате публикации
- по
дате модификации
- по
дате ввода
- по
идентификатору
При выборе последнего подпункта
отсортировать… администратору
выдается окно для ввода параметра (атрибута) сортировки (рис. 2).

|
Рис. 2. Окно для ввода параметра сортировки.
|
В нем можно указать
переменную, соответствующую любому атрибуту объекта или спецпараметру. См.
Приложения Атрибуты и Параметры. Если
указано только имя, то сортировка производится в порядке увеличения значения
параметра. Для сортировки в обратном порядке после имени параметра надо
добавить пробел и ключевое слово desc.
Результат выполнения
операции будет отображен на панели ИНФОРМАЦИЯ.
Внимание! Данная операция одноразовая, т.е. она не
устанавливает новый тип сортировки, а действует только на уже введенные
объекты. Для того, чтобы все новые объекты в ветви сортировались автоматически,
необходимо к родительскому объекту добавить параметр "сортировка
дочерних" и установить ему требуемое значение.
| 3.1.2.3. Перенос объекта или ветви
Для переноса текущего
объекта или ветви в другое место дерева сайта нужно выбрать пункт перенести в контекстном меню или пункт move ( ) контрольной панели ("горячая клавиша"
- Ctrl-M). Администратору будет выдано окно для ввода
идентификатора родительского объекта, в ветвь которого надо перенести текущий
(рис. 1).

|
Рис. 1. Окно для ввода идентификатора родительского объекта.
|
Для выполнения данной
операции у администратора должны быть права не только на изменение текущего
объекта, но и на добавление к указанному родительскому объекту.
Если у текущего
объекта есть дочерние, то они будут перенесены вместе с ним, т.е. структура
ветви полностью сохранится.
Перенос объекта в
ветвь с идентификатором 99 (Trash) равносилен его удалению.
Перенесенный объект
будет располагаться в новой ветви сайта точно также, как и при вводе нового
объекта. Если у родителя не установлен параметр "сортировка
дочерних", то перенесенный объект будет самым верхним в ветви. Если данный
параметр установлен, то после операции перенесения будет выполнена операция
сортировки ветви, соответствующая значению параметра "сортировка
дочерних" в родительском объекте.
Результат выполнения
операции будет отображен на панели ИНФОРМАЦИЯ.
| 3.1.2.4. Дублирование объекта
Операция дублирования
создает полную копию объекта (вместе со всеми его файлами) в этой же ветви
сайта. Для выполнения данной операции нужно выбрать пункт дублировать в контекстном меню или пункт dubl ( ) контрольной панелт ("горячая
клавиша" - Ctrl-U).
Дублирование
выполняется только для текущего объекта, т.е. не затрагивает дочерние объекты.
Если необходимо продублировать целую ветвь, то надо воспользоваться операциями копировать - вставить ветвь.
Права на чтение для
нового объекта будут установлены равными 0, если в настройках JM включена опция hidden. Если данная опция отключена, то права нового объекта будут полностью
совпадать с правами оригинала.
При левом нажатии на
пункт dubl ( ) копия будет располагаться в текущей ветви
сайта точно также, как и при вводе нового объекта. Если у родителя не
установлен параметр "сортировка дочерних", то новый объект будет
самым верхним в ветви. Если данный параметр установлен, то после операции
дублирования будет выполнена операция сортировки ветви, соответствующая
значению параметра "сортировка дочерних" в родительском объекте.
При правом нажатии на пункт
dubl ( ) копия будет располагаться в ветви сайта
точно под текущим объектом.
После дублирования JM автоматически входит в режим
редактирования вновь созданного объекта.
| 3.1.2.5. Копирование и вставка объекта
Для выполнения данной
операции нужно выбрать пункт копировать
в контекстном меню или copy ( ) контрольной
панели ("горячая клавиша" Ctrl-C). Текущий объект (и
ветвь) в дереве сайта выделяется серой пунктирной линией, в меню управления
контрольной панели появляются пункты paste ( ) и clear ( ), а в контекстной меню – пункты вставить и вставить ветвь (рис. 1).

|
Рис. 1. Копирование объекта
(ветви).
|
Данная операция не
выполняет непосредственного копирования объекта, а только запоминает его
идентификатор в буфере. Для выполнения самой операции нужно сделать правый
щелчок мыши на папке объекта в ветвь которого надо скопировать текущий и
выбрать в контекстном меню пункт вставить
/ вставить ветвь или левое / правое
нажатие на пункте paste ( ) контрольной панели. "Горячие
клавиши" для данных операций - Ctrl-V и Ctrl-T соответственно. Копирование будет произведено после подтверждения действия
в отдельном окне (рис. 2).

|
Рис. 2. Окна подтверждения операций копирования-вставки объекта и ветви.
|
Операция вставить (Ctrl-V) делает полную копию объекта (без дочерних) и добавляет ее в ветвь
текущего объекта. Права на чтение для копии будут установлены равными 0, если в
настройках JM включена опция hidden. Если данная опция отключена, то права копии будут полностью совпадать с
правами оригинала. К заголовку нового объекта добавляется строка (copy of XXX), где XXX - идентификатор копируемого объекта.
Операция вставить ветвь (Ctrl-T) делает полную копию всей ветви объекта. Права на чтение и заголовки новых
объектов будут полностью совпадать с оригинальными, независимо от настроек JM.
Нельзя скопировать
ветвь к объекту, который является одним из потомков копируемой ветви. Для
выполнения операции у администратора должны быть права на добавление к текущему
объекту (родительскому для копии).
Левое нажатие на
пункте clear ( ) контрольной панели очищает буфер и убирает
выделение объектов в дереве сайта.
| 3.1.2.6. Вырезание и вставка объекта
Операции вырезания и
вставки объекта аналогичны операциям копирования и вставки, но при этом не
создаются копии, а выполняется перемещение объекта или ветви в другую ветвь
дерева сайта.
Для выполнения данной
операции нужно выбрать пункт вырезать
в контекстном меню или пункт cut ( ) контрольной панели ("горячая клавиша"
Ctrl-X). Текущая ветвь в дереве сайта выделяется красной
пунктирной линией, в меню управления контрольной панели появляются пункты paste ( ) и clear ( ), а в контекстной меню – пункты вставить и вставить ветвь (рис. 1).

|
Рис. 1. Вырезание объекта (ветви).
|
Данная операция только
запоминает идентификатор объекта в буфере. Для выполнения вставки нужно сделать
правый щелчок мыши на папке объекта в ветвь которого надо переместить текущий и
выбрать в контекстном меню пункт вставить
/ вставить ветвь или левое/правое
нажатие на пункте paste ( ) контрольной панели. "Горячие
клавиши" для данных операций - Ctrl-V и Ctrl-T соответственно. Перемещение будет произведено после подтверждения действия
в отдельном окне (рис. 2).

|
Рис. 2. Окна подтверждения операций вырезания-вставки объекта и ветви.
|
Операции вставка и вставка ветви в данном случае абсолютно идентичны, т.е. вырезанный
объект всегда перемещается вместе со своими дочерними. Вставленный объект
(ветвь) будет располагаться в текущей
ветви сайта точно также, как и при вводе нового объекта (верхним или в
соответствии со значением родительского параметра "сортировка
дочерних").
Нельзя переместить
ветвь к объекту, который является одним из потомков этой же ветви. Для
выполнения операции у администратора должны быть права на добавление к текущему
объекту (новому родительскому для перемещаемой ветви).
| 3.1.3. Операции информационные
| 3.1.3.1. Переход на страницу объекта
Переход из модуля JM на страницу какого-либо объекта на сайте
может быть выполнен тремя различными способами:
1. Левый щелчок мыши
на идентификаторе объекта в строке дерева сайта.
2. Через контекстное меню:
- правый щелчок мыши на папке или
заголовке объекта
- пункт
меню - перейти
3. Клавиши Ctrl-G, если объект выделен в дереве сайта.
| 3.1.3.2. Просмотр объекта или страницы
Не выходя из модуля JM, администратор может просмотреть, как
будет выглядеть любой объект на странице сайта. Просмотр может осуществляться с
любым шаблоном, доступным на данном сайте. Один из шаблонов назначается
шаблоном "по умолчанию" (это задается в настройках JM).
Для просмотра объекта
(заголовка, контента и его дочерних) нужно выбрать пункт просмотр в контекстном меню и подпункт объект или сделать правый щелчок мыши на идентификаторе объекта в
строке дерева. "Горячие клавиши" для просмотра объекта с шаблоном по
умолчанию - Ctrl-Q.
Внешний вид объекта
или страницы будет представлен на панели ИНФОРМАЦИЯ в правой части окна JM (рис. 1).

|
Рис. 1. Просмотр в шаблоне объекта.
|
Для просмотра объекта
с другими шаблонами нужно выбрать соответствующий подпункт в контекстном меню просмотр (рис. 1).
Шаблоны объект (анонимно) и страница (анонимно) показывают объект с
правами на просмотр обычного (анонимного) посетителя сайта, т.е. если данный
объект закрыт от просмотра, то будет отображен блок для авторизации посетителя.
Если просматриваемый объект еще не опубликован на сайте или имеет параметр
"перенаправить", то на панели ИНФОРМАЦИЯ будет выведена диагностика
"невозможно отобразить страницу". Остальные шаблоны показывают
объекты с правами, соответствующими данному администратору сайта.
Шаблон печать показывает всю страницу данного
объекта в режиме сайта "Версия для печати", т.е с отключенной
оформительской графикой и блоками. Шаблоны текст
и графика отображают только одно
поле объекта - контент или параметр "графика" соответственно.
Если просматриваемый
объект имеет параметр "блок", то на панели ИНФОРМАЦИЯ будет
отображена текущая выборка данного блока, сформированная в соответствии его
параметрами и стилями (рис. 2).

|
Рис. 2. Просмотр
блока.
|
При выборе пункта
подменю шаблон, стиль, список...
администратору будет предложено ввести имена (переменные) требуемого шаблона,
стиля и списка (через запятую) для просмотра объекта. Список всех допустимых шаблонов,
стилей и списков можно увидеть в модуле Стили или модуле Джей-параметры
(значение параметров "шаблон ветви", "стиль ветви",
"список ветви").
| 3.1.3.3. Экспорт объектов
Данная операция
позволяет создать экспортный файл для текущего объекта или выборки объектов в
ФИЛЬТРЕ в различных форматах. Для экспорта группы объектов в ФИЛЬТРЕ необходимо
сформировать выборку и сделать текущей строку все выбранные. Затем нажать пункт exp ( ) контрольной панели или пункт экспорт контекстного меню. В правой
части экрана будет выведена панель ЭКСПОРТ для задания формата и других
характеристик экспортного файла (рис. 1).

|
Рис. 1. Экспорт заданных атрибутов и параметров выбранных объектов.
|
Поле
"разделитель" задает вид разделителя полей в строке экспортного файла
для текстового формата (символ ";" или табуляция). Поле "mselect" задает способ экспорта параметров
типа "mselect",
"mradio",
"mchecks" и
"mselects".
Если переключатель установлен в положении "id", то в экспортный файл попадут числовые
значения параметров указанных типов, если в положении "header" - то заголовки объектов,
соответствующих установленным значениям данных параметров.
Атрибуты и параметры
объектов, необходимые для экспортного файла выбираются в панели ПАРАМЕТРЫ или
устанавливаются переключатели "ВСЕ атирибуты" и "ВСЕ
параметры" для экспорта всех атрибутов (параметров) объектов.
После задания формата
и выбора экспортируемых атрибутов и параметров необходимо нажать клавишу ввести. После обработки данных на
панели ИНФОРМАЦИЯ будет выведена диагоностика экспорта: количество объектов,
разделитель, формат и число экспортируемых полей (атрибутов и параметров) в
каждом объекте (рис. 2). Если не было задано ни одного поля, то будет выдано
сообщение об ошибке. При нажатии на кнопку открыть
вы получите экспортный файл заданного формата в новом окне броузера.

|
Рис. 2. Подготовка экспортного файла.
|

|
Рис. 3. Пример экспортного файла в формате TXT
|

|
Рис. 4. Пример экспортного файла в формате HTML
|

|
Рис. 5. Пример экспортного файла в формате XML
|

|
Рис. 6. Пример экспортного файла в формате Excel
|

|
Рис. 7. Пример экспортного файла в формате ZIP
|

|
Рис. 8. Пример файла list.txt при экспорте в
формате ZIP
|
| 3.1.3.4. Вывод свойств объекта
Для получения
информации об объекте нужно сделать его текущим в дереве сайта левым щелчком
мыши. Справа от дерева, на панели ИНФОРМАЦИЯ, будут выведены значения всех
атрибутов и установленных параметров данного объекта, включая графические
изображения (рис. 1). В текстовом режиме JM для вывода информации о текущем объекте надо
нажать на пункт info ( ) контрольной панели. Для вывода информации
об объекте через контекстное меню, нужно выбрать пункт дополнительные->свойства.

|
Рис. 1. Вывод информации об объекте
|
В заголовке панели
указывается идентификатор объекта. Сама панель состоит из четырх секций
(АТРИБУТЫ, ПАРАМЕТРЫ, ВЛАДЕЛЕЦ-ПРАВА и ФАЙЛЫ). Информация в каждой секции
выводится в четыре колонки: название атрибута
или параметра, соответствующая переменная, тип и значение.
Для контента
(основного содержимого объекта) на панели ИНФОРМАЦИЯ выводятся четыре строки:
- текст (mess_content) - ссылка на просмотр HTML-кода, введенного администратором или
сформированного конвертором (указывается размер кода в Кб)
- файл (mess_content_file) - ссылка на последний загруженный через конвертор файл (указывается
размер файла в Кб)
- дата загрузки (file_modify_date) - дата загрузки последнего файла в конвертор
- создать doc-документ (createdoc) - ссылка на генерацию (создание) документа
в формате MS Word из текущего контента
В секции ПАРАМЕТРЫ
указываются установленные параметры объекта. Для параметров некоторых типов
указываются числовые (списковые) и текстовые значения. Для графических и
файловых параметров указывается тип файла, его размер и ссылка на сам файл.
Если изображение имеет больший размер, чем задано настройками JM, то оно показывается не масштабируемым, а
обрезанным по ширине и/или высоте. Само изображение служит ссылкой для
просмотра всего файла в отдельном окне. Рядом с изображением выводится ссылка
"изменить" для вызова встроенного графического редактора. Для
параметра "графика" указывается еще и дополнительная ссылка
"иконка" для вызова редактора в режиме создания иконки.
Примечание. В данном
режиме показываются только СОБСТВЕННЫЕ параметры объекта, т.е. те, которые
установлены в нем. Для вывода ПОЛНОЙ информации об объекте, включая наследуемые
параметры (установленные в родительских объектах), необходимо нажать правую клавишу
на пункте info ( ) контрольной панели или выбрать пункт
контекстного меню дополнительные->свойства
(родители). В этом режиме в секции собственные параметры объекта будут
отображены на белом фоне, а наследуемые - на сером. В колонке
"установлен" будет указан идентификатор ближайшего родителя, где
задан данный параметр (рис. 2).

|
Рис. 2. Вывод собственных и наследуемых
параметров объекта
|
В секции ВЛАДЕЛЕЦ,
ПРАВА указываются:
-
идентификатор
и имя владельца объекта
-
идентификатор
и название группы, которой принадлежит объект
-
права
на объект для группы и остальных пользователей
-
ip-адрес
и хост, с которого был введен данный объект
Если в директории
данного объекта есть какие-либо файлы, то на панели выводится дополнительная
секция ФАЙЛЫ. В ней перечисляются все файлы данного объекта с указанием
статуса, типа и размера. Возможные статусы файлов:
-
image - файл установленного параметра типа image
-
file - файл установленного параметра типа file
-
LINK - ссылка на файл параметра "внешний
файл"
-
BAK - архивная копия параметра типа image
-
DOC - последний загруженный через конвертор
файл
-
MANUAL - файл, загруженный конвертором или
администратором "вручную" и на который есть ссылка в HTML-коде объекта (href, src и др.)
-
LOST - загруженный файл, на который нет ссылок в HTML-коде объекта
Для всех файлов, кроме
image и file в первой колонке указывается ссылка
на удаление данного файла. В последней строке секции указывается общий размер
файлов текущего объекта в байтах и ссылка на удаление всех файлов типа LOST.
| 3.1.3.5. Вывод логов объекта
В системе TreeGraph ведется полный учет логов (действий администраторов) над
каждым объектом. Для вывода логов текущего объекта через контекстное меню,
нужно выбрать пункт дополнительные->логи.
На правой панели JM будет выведена таблица с логами данного объекта (рис. 1).

|
Рис. 1. Вывод логов объекта (действий
администратора)
|
В заголовке панели
указывается идентификатор объекта и временной интервал (число дней), за который
выводятся логи. Интервал задается настройкой модуля JM days_log и по умолчанию
равен 365 дней. Информация в панели выводится в несколько колонок:
логи - уникальный номер записи лога (одного действия администратора) дата модификации - день и время,
когда произошла данная операция (серверное) пользователи - идентификатор и логин
пользователя, выполнившего данную операцию (для анонимных и неавторизованных
пользователей не заполняется) ip-адрес - IP адрес, с которого была произведена данная операция действие - краткое обозначение
операции стр - идентификатор страницы
(объекта), на которой находился пользователь, при выполнении данной операции
(как правило, идентификатор модуля JM) информация - комментарии к операции:
список редактируемых (удаляемых) параметров, имена загружаемых (удаляемых)
файлов и пр.
Необходимо отметить,
что некоторые действия администратора приводят к записи нескольких подряд
идущих логов. Например добавление нового объекта создает следующие логи: clone, sort, update, update params.
Для просмотра логов
проекта (т.е. всех объектов, в том числе и удаленных) в системе TreeGraph имеется специальный модуль Наблюдатель (Watch).
| 3.1.3.6. Вывод статистики объекта (ветви)
В системе TreeGraph ведется полный учет статистических данных о посетителях всех
страниц сайта. Ежедневно собранная за прошедшие сутки информация обрабатывается
и сохраняется в базе данных проекта. Полная (необработанная) статистика
хранится еще примерно 7 дней. Большинство статотчетов доступны только для
обработанных данных, т.е. только после окончания текущих суток. Некоторые виды
отчетов (например, путь по сайту) возможно получить только из полных
(необработанных) данных. Для просмотра всех видов статистических отчетов в
системе TreeGraph имеется специальный модуль Статистика (Stats).
Получение некоторых
отчетов для объектов или ветвей возможно непосредственно в модуле JM. Для вывода статистики текущего объекта
через контекстное меню, нужно выбрать пункт дополнительные->статистика или пункт stat ( ) контрольной панели. На правой панели JM будет выведена таблица со статистикой
по дням для данного объекта (рис. 1).

|
Рис. 1. Вывод статистики объектов и ветвей
|
В заголовке панели
указывается идентификатор объекта и временной интервал (число дней), за который
выводится статистика. Интервал задается настройкой модуля JM days_stat и по
умолчанию равен 30 дней. Информация в панели выводится в несколько колонок:
дни - день, за
который отображается статистика хиты - количество хитов (просмотров)
данной страницы за указанный день хосты - количество хостов
(уникальных IP-адресов) при
просмотре данной страницы за указанный день хиты (в) - количество хитов
(просмотров) всех объектов в данной ветви за указанный день (подсчитывается
только для некоторых разделов сайта) хосты (в) - количество хостов при
просмотре всех объектов в данной ветви за указанный день (подсчитывается только
для некоторых разделов сайта)
У тех дней, для которых сохранена
полная (необработанная) статистика дата служит ссылкой для просмотра списка
хитов за этот день (рис. 2)

|
Рис. 2. Вывод списка хитов для объекта
|
В заголовке панели
указывается идентификатор объекта и день, за который показывается статистика. В
колонках таблицы выводится время каждого хита (захода на данныю страницу), IP-адрес посетителя, идентификатор
пользователя (для авторизованных посетителей) и внешняя ссылка на данную
страницу (если был заход с другого сайта).
Для просмотра других
статистических отчетов (по странам, городам, поисковикам и др.) или вывода
статистики за другие интервалы в системе TreeGraph имеется
специальный модуль Статистика
(Stats).
| 3.1.3.7. Вывод суммарной статистики ветви
Для вывода суммарной
статистики ветви текущего объекта надо нажать правую клавишу на пункте stat ( ) контрольной панели или в контекстном меню
выбрать пункт дополнительные->статистика
суммарная. На правой панели JM будет выведена ветвь текущего объекта с суммарными статистическими
данными (рис. 1).

|
Рис. 1. Вывод суммарной статистики ветви
|
В заголовке панели
указывается временной интервал (число дней), за который выводится статистика.
Интервал задается настройкой модуля JM days_stat и по умолчанию равен 30 дней.
Информация в панели выводится в несколько колонок:
объект - заголовок
объекта хиты - суммарное количество хитов
(просмотров) данной страницы за весь указанный интервал времени хосты - суммарное количество хостов
(уникальных IP-адресов) при
просмотре данной страницы за весь указанный интервал времени дни - число дней в которые были
заходы на данную страницу в указанном интервале времени хиты (в) - суммарное количество
хитов (просмотров) всех объектов в данной ветви за весь указанный интервал
времени (подсчитывается только для некоторых разделов сайта) хосты (в) - суммарное количество
хостов для всех объектов в данной ветви за весь указанный интервал времени (подсчитывается
только для некоторых разделов сайта) дни (в) - число дней в которые были
заходы на любую страницу в ветви объекта в указанном интервале времени
Для просмотра других
статистических отчетов (по странам, городам, поисковикам и др.) или вывода
статистики за другие интервалы в системе TreeGraph имеется
специальный модуль Статистика
(Stats).
| 3.1.3.8. Вывод количества файлов ветви
Для получения сводной
информации о количестве и размерах файлов для ветви текущего объекта нужно
выбрать пункт дополнительные->файлы.
На правой панели JM будет
выведена ветвь текущего объекта с указанием количества и суммарного размера (в
байтах) внешних файлов каждого объекта (рис. 1).

|
Рис. 1. Вывод количества и размеров внешних
файлов для ветви текущего объекта.
|
В колонке файлы указывается общее число файлов
каждого объекта всех типов. В колонках LOST и BAK указывается число файлов соответствующего типа. Файлы BAK - это архивные копии параметров
типа image. Файлы LOST - это загруженные
администратором файлы, на которые нет
ссылок в HTML-коде объекта. Число является ссылкой для операции удаления
файлов объекта соответствующего типа. Перед удалением администратору выдается
окно для подтверждение операции (рис. 2).

|
Рис. 2. Подтверждение операции удаления всех LOST файлов объекта 1105.
|
В колонке размер указывается общей размер всех файлов
объекта в байтах. В последней строке ветви отображается суммарное количество
файлов файлов и их размер для всей ветви.
Если данная операция
применяется для объектов, выбранных в фильтр, то в последней строке ветви число
файлов типа LOST и ВАК служат ссылкой для операции удаления файлов соответствующего
типа для ВСЕХ объектов выборки (рис. 3).

|
Рис. 3. Вывод количества и размеров внешних
файлов для выборки фильтра.
|
Для просмотра более
подробной информации о файлах каждого объекта можно нажать на ссылку с его идентификатором.
При этом данный объект становится текущим, а в правой панели будет выведена
таблица с информацией об объекте и полным списком его файлов. См. Вывод
свойств объекта.
| 3.1.3.9. Вывод сессии администратора
Вся информация,
которая выводится администратору на правую панель модуля JM (редактирование, удаление, загрузка
файлов, работа с фильтром и др.) запоминается на время сессии броузера. Для повторного
вывода этой информации нужно выбрать пункт контекстного меню дополнительные->сессия. На правой
панели JM будет
выведен список всех действий администратора в текущей сессии броузера с
указанием времени и идентификаторов объектов (рис. 1).

|
Рис. 1. Вывод информации в текущей сессии
администратора.
|
Большая часть действий
администратора записывается в дополнительную базу данных в виде логов проекта.
Для просмотра логов текущего объекта можно выбрать пункт дополнительные->логи или воспользоваться
модулем Наблюдатель.
| 3.1.3.10. Трассировка страницы объекта
Для получения трассировки
страницы текущего объекта нужно выбрать пункт дополнительные->timepoint. На правой панели JM будет выведена страница объекта с
соответствующим шаблоном и под ней - таблица с трассировкой (рис. 1).

|
Рис. 1. Страница текущего объекта с трассировкой.
|
В таблице указываются
номера строк и названия функций ядра системы, а также время выполнения каждой
функции в секундах и процентах от общего времени формирования страницы.
Отдельно перечисляются все формируемые блоки с указанием условия выбора,
условия показа и количества выбранных объектов. В последней строке выдается
общее время формирования страницы. Временные интервалы иллюстрируются
диаграммой.
В основном, данная
информация предназначена разработчикам системы для контроля и оптимизации
работы TreeGraph. Однако и
администратор сайта может изменять время формирования страницы, отключая
отдельные блоки или изменяя их параметры (условие выбора, количество и др.).
| 3.1.4. Фильтр (групповое редактирование)
Панель ФИЛЬТР модуля JM предназначена для поиска и выборки
объектов из дерева сайта, удовлетворяющих заданным условиям, а также для
выполнения групповых операций над ними. Панель расположена под основной панелью
ДЕРЕВО САЙТА и по умолчанию свернута. В упрощенном режиме работы панель ФИЛЬТР
отсутствует. Панель состоит из трех подпанелей: ФИЛЬТР (основная),
ДОПОЛНИТЕЛЬНЫЕ (для задания дополнительных условий выбора и показа) и ВЫБРАНО
(со списком и деревом выбранных объектов) (рис. 1).

|
Рис. 1. Внешний вид панели ФИЛЬТР модуля JM.
|
| 3.1.4.1. Формирование выборки объектов
Формирование выборки
объектов осуществляется заданием значений полей в ФИЛЬТРЕ или
"ручным" способом с помощью управляющих клавиш в строках объектов. В
дереве сайта в строке каждого объекта имеется значок +, при нажатии на который
данный объект добавляется в выборку фильтра (рис. 2).

|
Рис. 2. "Ручной" способ формирования выборки объектов.
|
Если объект имеет
дочерние, то в строке дерева указывается их количество в квадратных скобках.
При нажатии левой клавиши мыши на это число все дочерние объекты добавляются к
выборке. Если нажать правую клавишу, то в выборку попадет вся ветвь данного
объекта. При "ручном" способе задания выборки значение поля sql-запрос формируется автоматически.
Подпанели формирования
условия выборки (основная и дополнительная) позволяют задать или
откорректировать условия для выборки определенных объектов сайта. После ввода
условий необходимо задать требуемое ограничение на количество результатов и
нажать кнопку ввести.
sql-запрос
|
Является основным (хотя и не
обязательным) полем, позволяющим задать произвольное условие выборки наиболее
гибким образом, используя синтаксис MySQL.. Синтаксис SQL-выражений, которые можно использовать в данном
поле описан в Приложении Синтаксис SQL-выражений. Если в
данном поле указаны только числа через запятую, то это условие трактуется как
список идентификаторов объектов. Это является аналогом SQL-запроса id in (число1, число2, число3). В выборку попадут объекты,
идентификаторы которых присутствуют в списке.
|
текст
|
Позволяет производить выборку
по произвольному тексту. В выборку попадут объекты, в заголовке, аннотации
или тексте которых присутствует указанный текст. Текст также может
присутствовать и в значениям текстовых параметров объектов.
|
количество
|
Позволяет задать ограничение на
количество выбираемых объектов. В этом поле обязательно должно быть указано
число, иначе выборка не будет сформирована. Правый клик мышью по этому полю
добавляет к значению 10. Допускается использование одного из двух допустимых
синтаксисов для данного поля:
1. Указывается одно простое
число: N. В этом случае
после получения из базы данных всех объектов, соответствующих условию
выборки, и выполнения сортировки этих объектов по заданному правилу в выборку
фильтра попадут N первых из
всех объектов, удовлетворяющих заданному условию.
2. Указываются два простых
числа через запятую: M,N. При этом логика работы фильтра
остается такой же, как и в первом случае, с той лишь разницей, что из общей
выборки будут отобраны не первые N объектов, а N
объектов, начиная с позиции M. Необходимо иметь в виду, что первый объект в списке является по счету
нулевым, т.е. если необходимо выбрать в фильтр 10 объектов, начиная со 2-го,
необходимо указать в поле количество: 1,10.
|
владелец
|
Позволяет выбирать объекты,
владельцем которых является конкретный пользователь. В списке присутствуют
все пользователи зарегистрированные на сайте, кроме тех, что входят только в
одну группу "по умолчанию".
|
группа
|
Позволяет выбирать объекты,
принадлежащие определенной группе пользователей. Добавить группу и включить в
нее определенных пользователей можно в модуле Пользователи.
|
сортировка
|
Позволяет управлять порядком
следования объектов в выборке. В настоящий момент доступны следующие варианты
сортировки:
Натуральная – Порядок объектов
в выборке соответствует их расположению в дереве сайта (атрибут tree_order).
По алфавиту – Объекты следуют в алфавитном порядке (атрибут mess_header).
По дате публикации – Объекты сортируются по убыванию даты публикации,
введенной администратором (атрибут publish_date).
По дате ввода – Объекты сортируются по
убыванию даты ввода (атрибут enter_date).
По дате модификации – Объекты сортируются по убыванию даты последней
модификации (атрибуту modify_date).
По идентификатору – Объекты сортируются по возрастанию их идентификатора
(атрибут id).
Случайно – Объекты располагаются в случайном порядке.
По владельцу – Объекты сгруппированы по их владельцу (атрибут user_id).
По размеру контента – Объекты располагаются в порядке уменьшения размеров
контента (атрибут mess_content).
Также для каждого варианта
сортировки предусмотрено инверсное правило, т.е. "по возрастанию",
или "в обратном порядке".
|
показать
|
Позволяет ввести имя параметра
или список параметров через запятую, значения которых администратор желает
видеть у выбранных объектов при работе с фильтром.
|
не брать
из Trash
|
При установке данного флага в
выборку не будут включаться удаленные объекты, т.е. находящиеся в ветви Trash (id=99).
|
только
количество
|
При установке данного флага
будет выведено только количество объектов сайта, соответствующих условию
выборки без их отображения в линейном дереве ФИЛЬТРА.
|
При нажатии на кнопку ввести производится выборка объектов из
базы данных с заданными условиями и ограничениями. На панели ИНФОРМАЦИЯ
выводится полностью сформированный SQL-запрос и указывается число выбранных объектов и общее количество,
удовлетворяющих заданному условию. Кнопка сбросить
очищает выборку объектов и сбрасывает все условия на панели ФИЛЬТРА. Кнопка закрыть скрывает панель фильтра, не
сбрасывая выборку и заданные условия.
После формирования
выборки на подпанели ВЫБРАНО выдается текстовое поле, содержащее идентификаторы
всех выбранных объектов через запятую. Также указывается число выбранных
объектов и (в скобках) общее количество объектов сайта, удовлетворяющих условию
выборки. Под данным полем выдается линейное дерево выбранных объектов с корнем все выбранные, если не был установлен
флаг только количество.
В этом дереве можно
работать как с отдельными объектами, так и со всей выборкой. Порядок работы над
отдельными объектами выборки не отличается от обычной работы с объектами в
дереве сайта модуля JM, с той
лишь разницей, что вместо символа + в строке заголовка каждого объекта
расположен символ –. Этот элемент позволяет вручную исключить объект из
выборки. Контекстное меню каждого объекта дополняется еще одним пунктом – в дереве, который позволяет найти
данный объект в дереве сайта.

|
Рис. 1. Контекстное меню и контрольная панель для групповых операций в
панели ФИЛЬТР.
|
Для совершения
операций сразу над всеми объектами выборки необходимо сделать текущей строку
дерева все выбранные (рис. 1).
Список доступных операций для выборки незначительно отличается от набора
операций над отдельным объектом. Любая групповая операция в ФИЛЬТРЕ выполняется
над всеми объектами, попавшими в выборку, если это возможно (есть права на
совершение операции, операция не противоречива и т.д.).
Возможные групповые
операции в ФИЛЬТРЕ:
- просмотр всех объектов (страниц) с
заданным шаблоном, стилем и списком
- удаление
всех объектов
- изменение графических параметров для
всех объектов
- создание иконок по заданным
параметрам и автоматическая генерация иконок для всех объектов
- добавление, замена и удаление
заданных параметров для всех объектов
- установка прав, владельца и группы
для всех объектов
- экспорт заданных атрибутов и
параметров всех объектов в требуемом формате
- перенос всех объектов в указанную
ветвь
- копирование
и вставка всех объектов
- вырезание
и вставка всех объектов
- вывод свойств (информации) всех
объектов
| 3.1.4.2. Групповое редактирование объектов
Групповые действия над объектами возможны только после выбора их в фильтр.
После того как объекты выбраны на панели редактирования необходимо нажать кнопку «Изменить» (рис.1)

|
Рис.1
|
Доступные операции редактирования выбранных объектов ( Рис.2 ):
- обновить все атрибуты
- применить типограф в выбранных параметрах
- поиск и замена текста в выбранных параметрах
- добавить (заменить) выбранные параметры
- удалить выбранные параметры

|
Рис.2
|
Обновить все атрибуты

|
Рис.3
|
Этот режим не изменяет параметров кроме «даты модификации» (Рис.4 пункт 2), обновление выделенных объектов равносильно нажатию кнопки «Применить» (Рис.4 пункт 1) для каждого объекта в отдельности.

|
Рис.4
|
Применить типограф в выбранных параметрах

|
Рис.5
|
Типограф – это удобное средство онлайн подготовки русского текста к веб-изданию. Он помогает избежать монотонной корректировки, расстановки кавычек, неразрывных пробелов, специальных символов, исправляет некоторые ошибки ввода (опечатки), проверяет орфографию и так далее.
Список параметров доступных для выбора (Рис.5) включает в себя все параметры, которые есть в выбранных объектах. Чтобы выбрать параметр или атрибут для обработки его содержимого типографом необходимо кликнуть по названию параметра (Рис. 6).
Внимание! В поля выбранных параметров ничего вводить не нужно!

|
Рис.6
|
Удалить выбранные параметры

|
Рис.7
|
Выбранный параметр (чтобы выбрать параметр или атрибут для обработки его содержимого типографом необходимо кликнуть по названию параметра) будет удален из всех выбранных объектов, после нажатия кнопки «Ввести».
Поиск и замена текста в выбранных параметрах

|
Рис.8
|
Алгоритм работы с режимом «Поиск и замена текста в выбранных параметрах» (Рис.9):
- выберите параметр(ы), где нужно произвести поиск и замену текста
- заполните поля «найти» и «заменить»
- ввести изменения

|
Рис.9
|
Поиск и замена текста в выбранных параметрах допускает использования дополнительных настроек (можно выбирать сразу несколько):
- учитывать регистр (по умолчанию регистр не учитывается)
- регулярные выражения
- обрабатывать в полях «найти» и «заменить на»
- тестовый режим
Учитывать регистр (по умолчанию регистр не учитывается)
Если нужно учитывать регистр при поиске фразы, то выберите эту настройку и выполните замену.
Регулярные выражения
Выбор этой настройки позволит вводить в поле «найти» регулярные выражения, для более сложного поиска в строке, подробнее о регулярных выражениях по ссылке http://php.net/manual/ru/reference.pcre.pattern.syntax.php
Обрабатывать $PARAMS в полях «найти» и «заменить на»
Выбор этой настройки позволит вводить в поля «найти» и «заменить на» выражения типа $PARAMS[] подробнее по ссылке http://graphit.ru/?id=2514 .
Тестовый режим
Выбор этой настройки позволит сымитировать замену не внося изменения в сами объекты. Результат имитации доступен в текстовом отчете в модуле «Информации» (он появится после нажатия кнопки «Ввести»)

|
Рис.10
|
Добавить (заменить) выбранные параметры

|
Рис.11
|
Алгоритм работы с режимом «Добавить (заменить) выбранные параметры» по умолчанию добавляет и заменяет (удаляя старое значение) (Рис.11):
- выберите параметр(ы) которые нужно добавить (заменить)
- укажите значение параметров
- введите изменения
Для данного режима предусмотрены дополнительные настройки:
- сохранять установленные параметры
- удалять невыбранные параметры
- обрабатывать в значениях параметров
Сохранять установленные параметры
Эта настройка позволит сохранить старое значение параметра, если оно уже есть в объекте.
Удалять невыбранные параметры
Применение этой настройки удалит ВСЕ старые параметры и добавит ТОЛЬКО новые.
Обрабатывать $PARAMS в значениях параметров
Позволяет добавлять в поля атрибутов и параметров выражения типа $PARAMS.
Тестовый режим
Выбор этой настройки позволит сымитировать добавление (замену) параметров не внося изменения в сами объекты. Результат имитации доступен в текстовом отчете в модуле «Информации» (он появится после нажатия кнопки «Ввести»)
| 3.1.5. Импорт
Панель ИМПОРТ модуля JM предназначена для потокового ввода и
редактирования информации на сайте.
Интерфейсная панель
ИМПОРТ расположена под основной панелью ФИЛЬТР и по умолчанию свернута. В
упрощенном режиме работы JM панель ИМПОРТ отсутствует.

|
Рис. 1. Внешний вид панели ИМПОРТ модуля JM.
|
| 3.1.5.1. Описание полей формы импорта и режимов работы
Чтобы выполнить нужную
пакетную операцию с использованием данного модуля необходимо заполнить форму на
панели ИМПОРТ. Обязательным является только поле файл или список,
значения остальных полей не обязательны.
Значения полей
выделенных [квадратными скобками] могут содержаться в операционном
файле и отличаться для разных строк файла.
[Куда загружать] - id объекта, дочерними которого становятся
загружаемые объекты (если в загружаемом операционном файле есть столбец parent_id и в строках данных указаны соответствующие значения, то данное поле
игнорируется).
Файл - операционный файл для ввода или
редактирования информации (текстовый файл или архив RAR/ZIP, содержащий операционный файл с именем list.txt).
[Владелец сообщений]
(user_id) – id пользователя: кто будет владельцем загружаемых объектов. Если параметр не
установлен, то владельцем будет тот, кто загружает.
[Группа
пользователей] (group_id) - группа для загружаемых объектов (id группы пользователей). Если параметр не установлен, группа будет такая же,
как у родительских объектов.
[Права сообщений] (rg,wg,xg,ro,wo,xo) - задает права загружаемых объектов.
Параметры для
заголовка - список
параметров, из которых будет создаваться заголовок, если отсутствует столбец mess_header. Если данное поле не заполнено и отсутствует mess_header, то заголовок формируется из номера строки
операционного файла.
Образец дочерних - загружаемые объекты формируются из
этого объекта, с приоритетным добавлением параметров и атрибутов из
загружаемого файла. Например, если загрузчику установить образец дочерних
"блок" и произвести импорт, то у созданных сообщений будут
установлены параметры сообщения-образца "блок" вне зависимости от
того, будут ли указаны такие параметры в операционном файле (если будут, то их
значения для вводимых объектов будут такие, какие указаны в операционном
файле).
Управление - шаблон заголовка при загрузке архива RAR/ZIP с отсутствующим файлом list.txt (перечень полей в
автогенерируемом list.txt).
Данные - шаблон строки данных при загрузке
архива RAR/ZIP с отсутствующим файлом list.txt (шаблон для автогенерации list.txt).
Список - альтернатива операционного файла,
первая строка - описание структуры загружаемых данных, следующие строки -
данные.
Импорт (объект | параметры ) - режим работы импорта - загрузка объектов или параметров и их групп.
Тест - данный модуль запускается в режиме
тестирования, т.е. анализируются загружаемые данные, выводится вся
диагностическая информация, но не производятся операции добавления и
редактирования объектов.
Будьте внимательны
при использовании данного модуля! Результаты операции пакетного редактирования
не обратимы.
Допустимы следующие способы импорта объектов:
- Используется поле "Файл": загружается
текстовый операционный файл (list.txt)
В поле файл
загружен текстовый файл (и любым
именем и расширением), содержащий данные в формате CSV согласно формату
операционного файла. В этом случае вся информация о вводимых объектах,
включая их контент и значения иных параметров должна содержаться в самом
текстовом файле. При таком варианте невозможно ввести параметры с картинками
или параметры, текст которых должен быть получен из doc или иных дополнительных файлов.
- Используется поле "Список"
В поле список
вводится текст, согласно все тому же формату операционного
файла. Этот способ полностью аналогичен первому варианту, за исключением
того, что никаких файлов создавать не нужно.
Пример.
Задача: создать пять
новых разделов внутри каталога с id 12345.
Вместо того, чтобы
создавать объекты руками – используем импорт. В поле "список"
достаточно вставить один столбец с заголовками, если нужны другие параметры (с
общими для всех новых объектов значениями) выбираем при импорте нужный образец
или устанавливаем образец для раздела в которой производится импорт (с помощью
параметра "образец дочерних" из группы "МЕНЕДЖЕР").
Куда загружать: 12345
Список: mess_header
Первый раздел
Второй раздел
Третий раздел
Четвертый раздел
Последний раздел
- Используется поле "Файл": ZIP/RAR c list.txt внутри
В поле файл загружен
архив ZIP/RAR. В этом случае загружаемый архив
обязательно должен содержать операционный файл, названный list.txt. Формат list.txt аналогичен варианту (А): но при этом
можно также работать и со значениями параметров типа file и image. В качестве значения такого параметра в list.txt необходимо просто указать имя загружаемого файла с расширением.
Например:
mess_header;
|
icon;
|
mess_content_file;
|
mess_content_doc
|
Заголовок 1;
|
foto1.jpg;
|
1.html;
|
|
Заголовок 2;
|
foto2.gif;
|
;
|
1.doc
|
Из файлов, указанных в столбце mess_content_file будет извлечено содержимое без каких-либо изменений - только для текстовых
и html файлов; файлы,
указанные в mess_content_doc - будут пропущены через конвертор (допустимые форматы файлоы: doc, rtf, xls) перед вставкой текста на сайт.
И сам файл list.txt, и все упомянутые в нем файлы, должны находиться в загружаемом архиве. В
именах файлов, находящихся в архиве, русские буквы следует использовать с
особой осторожностью: обязательно сначала нужно произвести импорт в режиме "Тест"
и убедиться что русские имена корректно отображаются, а ошибки при импорте
отсутствуют. Возможность, либо невозможность использования русских букв в
именах файлах целиком зависит от настроек сервера. Если имеются проблемы, и при
тестировании вы видите русские буквы в неправильной кодировке, попробуйте
другой формат архива, например RAR вместо ZIP и наоборот.
- Используется поле "Файл": ZIP/RAR без list.txt (фотогалереи)
Существует упрощенный
режим импорта объектов, предназначенный для наиболее распространенной операции
– загрузки фотографий на сайт. Данный режим "включается" в случае,
если в загруженном архиве нет операционного файла, а поля "список", "управление"
и "данные" (см. ниже) пустые.
Все что нужно сделать
чтобы загрузить на сайт фотографии (или иную графику) – запаковать в zip или rar архив графические файлы (gif / jpg / png), затем отправить такой архив в модуль импорта.
В этом случае:
-
обязательно
нужно заполнить поле "куда загружать" (указать id галереи);
-
создастся
столько объектов, сколько графических файлов будет в архиве;
-
картинки
будут загружены в параметр "графика", если нужно загружать их в
другой параметр – используйте автогенерацию операционного файла (см. ниже);
-
если
в самой галерее нет параметра "образец дочерних", а в каждой
фотографии требуются какие-то специальные параметры – нужно выбрать образец с
этими специальными параметрами в поле формы импорта "образец
дочерних";
-
если
нужно автоматически создавать иконки для фотографий – можно это сделать
"по требованию" после импорта используя фильтр или же заранее (до
импорта) настроить параметр "эффекты
иконки".
- Используются поля "Управление"
/ "Данные", "Файл": ZIP/RAR без list.txt (автогенерация операционного файла)
В данном режиме (когда
заполнены поля "Управление" и "Данные") операционный файл
создается "на лету" при переборе файлов, содержащихся в архиве. Если
в архиве содержится также list.txt, то в качестве
операционного файла будет использован он.
Данный режим позволяет
быстро решать самые разнообразные типовые задачи. Он аналогичен предыдущему,
однако позволяет задать собственную логику обработки файлов в архиве, например,
объединять по 2 графических файла в один объект, загружать файлы в произвольный
параметр, обрабатывать текстовые (txt, doc, xsl) файлы и т.д.
Особенно удобно
пользоваться этим режимом при настройке модуля импорта в отдельно стоящем
объекте. В этом случае можно ввести настройки "данные"/"управление"
для конкретной задачи в параметр объекта "настройки менеджера", а ряд
данных, используемых в операционном файле, запрашивать через интерактивную
форму.
В поле
"Управление" нужно указать первую строку операционного файла (см. формат операционного файла)
В поле
"Данные" нужно записать специально составленный шаблон для конкретной
операции.
Операционный файл будет составлен в процессе перебора файлов внутри полученного
архива.
В шаблоне допустимо
использовать следующие обозначения:
$PARAMS [file] – полное имя текущего файла обработанное (в формате файловой
системы – кириллица предобазована в трнаслит, нет заглавных букв)
$PARAMS [filename] – имя текущего файла без расширения, обработанное
$PARAMS [fileext] – расширение текущего файла
$PARAMS [fileorig] – оригинальное имя файла текущего без расширения
(предусмотрена поддержка кириллицы, заглавных и сточный букв, пробелов) NB: после $PARAMS, перед квадратными скобками (здесь и далее по
тексту) нет пробела.
Если используется
вариант отдельно стоящего импорта (не интегрированного в JM) c интерактивной формой, то можно использовать конструкции вида
$_REQUEST[p__имя_параметра].
Пример 1:
Управление:
mess_header;icon;view_icon_photo;mess_content Данные: $PARAMS [fileorig];$PARAMS [file];$PARAMS [filename]_ico.$PARAMS
[fileext];< p >Текст под фото.< br >
© 2008 Имя автора< /p
>
В данном случае, в
загружаемом архиве должны быть фотографии и вручную изготовленные иконки к ним.
Если фотографий называются "abc.jpg", "zxc.gif", то иконки к ним должны называться "abc_ico.jpg", "zxc_ico.gif". Это
определено строкой $PARAMS [filename]_ico.$PARAMS [fileext] (имя иконки такое же как у оригинального файла – $PARAMS [filename]) с окончанием "_ico" и расширение такое же как у
оригинального файла).
Заголовком объекта
стане оригинальное имя файла.
Стоит заметить, что
дополнительные файлы, вовлеченные шаблоном исключаются из общего перебора, в
противном случае, в вышеуказанном примере объектов было бы в два раза больше
чем нужно – по количеству файлов в архиве.
Пример 2:
Тоже, что и в
примере 1, однако с получением данных через интерактивную форму (для отдельно стоящего
импорта):
import_ctrl=mess_header;icon;view_icon_photo;art_author;art_keywords;mess_content import_data=$PARAMS [fileorig] -
$_REQUEST[p__uni_topic_ic];$PARAMS [file];$PARAMS [filename]_ico.$PARAMS [fileext];$_REQUEST[p__art_author];$_REQUEST[p__art_keywords];
© 2008 "$_REQUEST[p__site_copyright]".
Значения параметров uni_topic_ic (тема фотогалереи), art_keywords (ключевые
слова), art_author (автор) и site_copyright (авторские права) одинаковы для всех загружаемых в данный момент объектов
и передаются вместе с архивом через интерактивную форму.
Пример 3:
Управление: id;icon; Данные: $PARAMS [filename]; $PARAMS [file]
Загрузка графики
происходит в уже существующий объект, id которого строго совпадает с именем файла без расширения, при
условии существования такого объекта.
В остальном, данный способ
импорта работает аналогично предыдущим.
| 3.1.5.2. Формат операционного файла
Первая строка операционного
файла представляет собой описание структуры загружаемых данных, все последующие
строки - сами данные для загрузки (одна строка - один объект):
ИМЯ_ПОЛЯ_1 РАЗДЕЛИТЕЛЬ ИМЯ_ПОЛЯ_2
РАЗДЕЛИТЕЛЬ ... ИМЯ_ПОЛЯ_N
ПОЛЕ_1 РАЗДЕЛИТЕЛЬ ПОЛЕ_2 РАЗДЕЛИТЕЛЬ ... ПОЛЕ_N
...
ПОЛЕ_1 РАЗДЕЛИТЕЛЬ ПОЛЕ_2 РАЗДЕЛИТЕЛЬ ... ПОЛЕ_N
Разделителем может
являться символ табуляции или символ ";" (точка с запятой). Используемый в файле
символ - разделитель полей при загрузке определяется автоматически.
При составлении
операционного файла необходимо помнить, что символ-разделитель не должен
встречаться нигде в значениях параметров, иначе значение такого поля должно быть заключено в двойные кавычки ("). Например, если в аннотации одного из
вводимых объектов используется символ ";", то либо нужно использовать в качестве разделителя полей
символ табуляции, либо нужно заключить аннотацию в двойные кавычки:
значение предыдущего поля;"аннотация; аннотация";значение следующего поля В противном случае, такая строка обработана не будет.
Разделитель полей
должен быть одним и тем же во всем операционном файле.
ВАЖНО: каждый объект внутри файла должен занимать строго одну строку. Символы переноса строки недопустимы! Если необходимо ввести данные, содержащие симполы переноса строк, необходимо использовать последоватьельность "\n" (без кавычек) для обозначения новой строки. Пример
значение предыдущего поля;"аннотация\nаннотация";значение следующего поля
Пример операционного файла:
mess_header;mess_short;art_is
новость 1;это аннотация первой новости;1
новость 2;аннотация второй новости здесь;1
статья;;0
Пример операционного
файла для варианта (Б):
mess_header;mess_short;mess_content_file;icon;need_comments
привет 1;аннотация 1;test.doc;01.gif;1
привет 2;аннотация 2;info.html;02.gif;0
привет 3;аннотация 3;info.html;pic.jpg;NaN
Замечания: если у
текстового параметра не должно быть значения, следует пропустить этот столбец,
оставив два разделителя полей подряд, если какой-либо параметр не должен
добавляться к объекту, то в данной столбце соответствующей строки необходимо
ввести ключевое слово NaN.
Именами полей могут
быть имена параметров любого типа, а также атрибуты (mess_header, mess_short, p_date, p_time...). Именем поля также может
являться вспомогательный виртуальный параметр virt_id – поле текстового типа с произвольной нумерацией. Значения virt_id обрабатываются только в процессе загрузки
операционного файла и используются для создания с помощью импорта нелинейных
структур объектов в дереве сайте.
Чтобы посмотреть
полный список атрибутов кликните один раз по имени любого объекта в JM (если JM работает в текстовом режиме - выберите пункт свойства из контекстного меню объекта).
Если в операционном
файле присутствует столбец с именем поля id и в
соответствующем поле какой-либо строки указано число, то данные в этой строке
будут использованы не для создания нового объекта, а для правки существующего - того, id которого указан.
Если для конкретной
строки указан атрибут parent_id, или иные атрибуты, которые можно указать в форме загрузчика, то при
выполнении модулем заданных операций для этой строки будут использованы те значения, которые указаны в операционном
файле, а не те, которые указаны в форме.
Если в одной и той же
строке операционного файла указаны одновременно поля id и parent_id, приоритетным
является поле id, т.е. в этом случае значение parent_id будет проигнорировано, и будет осуществлена
правка указанного в id объекта, вне зависимости от того,
совпадает его parent_id с указанным или
нет.
По умолчанию все
вводимые с помощью загрузчика объекты являются дочерними к уже существующим
(находятся в одном разделе, если родительское задается в форме JM, либо находятся в разных, если в
операционном файле используется столбец parent_id). Однако возникают ситуации, когда вводимые загрузчиком объекты должны
являться дочерними к другим загружаемым тем же операционным файлом и еще не
созданным объектам. Такая ситуация может возникнуть, например, при импорте
целой ветви сайта в один этап.
В этом случае для
операционного файла предусмотрено вспомогательное поле virt_id. В этом поле вводятся произвольные числовые
значения, которые будут являться вспомогательными идентификаторами строк.
Значения, указанные в поле (столбце) virt_id можно использовать в поле parent_id для других строк
того же операционного файла.
При необходимости
выполнения операции импорта ветви с сохранением иерархических связей
рекомендуем обратиться к службе технической поддержки для дополнительного
контроля корректности операционного файла перед выполнением его импорта.
Порядок столбцов в
операционном файле значения не имеет.
Финальный набор
параметров во вводимых заново объектах будет определяться перечнем параметров,
указанных в операционном файле, а также установленным в форме при загрузке образцом дочерних. У введенного объекта
будут установлены все параметры, перечисленные в операционном файле, а также
параметры, существующие у выбранного образца. Приоритетными будут являться
значения параметров из операционного файла, т.е. если параметр присутствовал в
выбранном образце, но не был упомянут в загружаемом файле, то этот параметр
будет установлен со значением как в образце.
Финальный набор
параметров в редактируемых объектах будет определяться перечнем параметров,
указанных в операционном файле, а также параметрами, установленными в
редактируемом объекте. Приоритетными также будут являться значения параметров
из операционного файла.
| 3.1.6. Текстовый редактор JEditor
Визуальный HTML-редактор JEditor (далее редактор) предназначен для оформления
основного текста объекта (контента) в режиме WYSIWYG (принцип - "что вы видите, то и
получаете"). С помощью него можно легко публиковать и изменять сложные
документы с разнообразным оформлением текста, с иллюстрациями, диаграммами,
таблицами и т.п. Интерфейс редактора максимально приближен к возможностям
программы MS Word. Редактор позволяет также корректировать
контент в исходных HTML-кодах
(рис. 9).
Запуск редактора
происходит по ссылке edit, расположенной слева от основного окна
ввода текста в режиме редактирования объекта. Внешний вид редактора
представлен на рис. 1.

|
Рис. 1. Внешний вид редактора JEditor
|
| 3.1.6.1. Основные возможности редактора
Редактор JEditor предоставляет следующие основные
возможности:
- Разнообразное шрифтовое оформление
текста (применение стилей, шрифтов, размеров, различных выделений).
- Работа с цветом текста и фона.
- Оформление абзацев текста (применение
стилей, выравнивание, различные списки, отступы).
- Установка и редактирование ссылок и
якорей, в том числе и графических.
- Загрузка на сервер и вставка в
документ графических элементов.
- Вставка и редактирование таблиц, в
том числе и вложенных.
- Вставка различных спецсимволов и
отбивок.
- Работа с буфером MS Windows (копирование, вставка текста, вставка с
полным или оптимизированным оформлением).
- Поиск и замена текста по всему
контенту.
- Предварительный просмотр страницы на
экране броузера.
- Работа с шаблонами (для создания
новых документов).
- Редактирование текста в исходных HTML-кодах.
| 3.1.6.2. Элементы панели управления
На панели управления
расположены пиктограммы основных операций и выпадающие меню для оформления
текста определенным стилем, форматом, шрифтом и размером (рис. 2). Список
стилей и их оформление соответствует CSS-классам данного сайта, заданным в файловом параметре "CSS-стиль" в корне сайта.

|
Рис. 2. Меню для оформления текста стилями и различными шрифтами.
|
Правый щелчок мыши в
любом месте поля редактора вызывает появление соответствующего контекстного
меню (рис. 3). Список пунктов меню зависит от положения курсора в тексте.

|
Рис. 3. Контекстное меню редактора.
|
Пиктограммы панели
управления в режиме WYSIWYG:

|
Переключение
режимов работы Источник-WYSIWYG
|

|
Вырезание
выделенного текста в буфер MS Windows
|

|
Сохранение
текста и возврат в Джей-менеджер
|

|
Копирование
выделенного текста в буфер MS Windows
|

|
Очистка всего
текста и создание новой страницы
|

|
Вставка текста
из буфера MS Windows
|

|
Очистка всего
текста и создание страницы по шаблону
|

|
Вставка текста
из буфера без оформления
|

|
Предварительный
просмотр текста в отдельном окне
|

|
Вставка текста
с оптимизированным оформлением
|

|
Печать текста на принтере
|

|
Отмена последней операции
|
|
|

|
Восстановление последней отмененной операции
|

|
Поиск текста в
окне редактора (рис. 4)
|

|
Выделение всего текста
|

|
Поиск и замена
текста в окне редактора (рис. 4)
|

|
Очистка форматирования выделенного текста
|

|
Оформление текста жирным
|

|
Оформление нумерованного списка
|

|
Оформление текста курсивом
|

|
Оформление ненумерованного списка
|

|
Оформление подчеркнутого текста
|

|
Уменьшение
отступа и вложенные списки
|

|
Оформление перечеркнутого текста
|

|
Увеличение
отступа и вложенные списки
|

|
Оформление нижнего индекса
|

|
Оформление выравнивания влево
|

|
Оформление верхнего индекса
|

|
Оформление выравнивания по центру
|

|
Вставка и
редактирование ссылки (рис. 5)
|

|
Оформление выравнивания вправо
|

|
Удаление ссылки
|

|
Оформление выравнивания по ширине
|

|
Вставка и
редактирование якоря (рис. 5)
|
|
|

|
Вставка и
редактирование изображения (рис. 6)
|
|
|

|
Вставка и
редактирование таблицы (рис. 7)
|
|
|

|
Вставка горизонтальной линии
|

|
Задание цвета текста (рис. 8)
|

|
Вставка специального символа (рис. 8)
|

|
Задание цвета фона (рис. 8)
|
При выполнении
различных операций редактор выдает диалоговые окна для ввода значений и
параметров редактируемого текста. Некоторые окна имеют несколько закладок для
ввода расширенных (дополнительных) значений параметров. Ниже приведены примеры
диалоговых окон.
| 3.1.6.3. Поиск и замена текста
Диалоговые окна
редактора для поиска и замены текста в окне:

|
Рис. 4. Поиск и замена текста в окне редактора.
|
| 3.1.6.4. Редактирование ссылок и якорей
Ссылкой может служить
любой выделенный текст или изображение, загруженное на сервер (см. ниже).
|
Рис. 5. Диалоговое окно для вставки и редактирования ссылки
|
Для ссылки можно
задать ее тип (URL, якорь,
почта) и протокол (http://, ftp://, news:// и др.). В закладке Цель и Расширенный можно
указать тип окна и фрейма, а также CSS-классы и стили ссылки.

|
Рис. 6. Диалоговое окно для вставки и редактирования якоря
|
| 3.1.6.5. Работа с изображениями и файлами
Диалоговое окно для
вставки изображения и редактирования его свойств:
|
Рис. 7. Диалоговое окно для редактирования свойств изображения.
|
При нажатии на кнопку Просмотреть на сервере в диалоговых
окнах Ссылка и Свойства изображения запускается окно для просмотра ресурсов
(файлов) редактируемого объекта (рис. 8).

|
Рис. 8. Диалоговое окно для загрузки файлов на сервер.
|
В окне отображается
список всех файлов данного объекта с указанием их имен и размеров. Для
графических изображений показываются уменьшенные копии со ссылкой на просмотр
полного изображения и размер в пикселях. Ссылка del позволяет удалить
лишние файлы с сервера. Поле Обзор… (Browse…) дает возможность загрузить требуемые файлы на
сервер с локального компьютера. Для вставки файла (т.е. соответствующего HTML-кода) в текст, необходимо нажать на
ссылку с именем нужного файла.
| 3.1.6.6. Работа с таблицами
Редактор позволяет
вставлять в текст сложные таблицы (в том числе и вложенные) и редактировать их
свойства. Для таблиц допустимы следующие операции: вставка и удаление строки,
вставка и удаление колонки, вставка и удаление ячейки, соединение и разбиение
ячеек.
Для редактирования
свойств таблицы и ее ячеек необходимо использовать контекстное меню (рис.
3).

|
Рис. 9. Диалоговое окно для вставки и редактирования таблицы.
|
| 3.1.6.7. Дополнительные возможности

|
Рис. 10. Диалоговое окно для вставки в текст специальных символов.
|

|
Рис. 11. Диалоговое окна для выбора цвета текста/ фона.
|
| 3.1.6.8. Работа в режиме Источник
При переключении в
режим Источник редактор позволяет изменять текст непосредственно в HTML-кодах.

|
Рис. 12. Внешний вид редактора в режиме работы Источник.
|
После переключения
режимов редактор проверяет корректность HTML-кода и исправляет его при необходимости.
Внимание! Для записи введенного текста, после нажатия
пиктограммы и возврата в JM, необходимо нажать кнопку ввести на панели УПРАВЛЕНИЕ JM.
| 3.1.7. Графический редактор Resizer
С помощью встроенного
графического редактора Вы можете модифицировать любые графические параметры
объектов: изменять их масштаб, обрезать по заданной области, поворачивать на
любой угол, добавлять рамки, "водяные знаки" или произвольный текст.
Редактор работает в
двух режимах: изменения (редактирования) текущего изображения (параметра) и
создание иконки (view_icon_photo) для параметра "графика" (icon). Запуск редактора производится с
контрольной панели JM или из
режимов редактирования и просмотра свойств объекта (ссылки изменить и иконка слева
от соответствующего изображения).
Редактор запускается в
отдельном окне броузера. В верхней части окна редактора находится управляющая
панель с полями форм. В первой строке указываются размеры и масштаб исходного и
результирующего изображения, во второй строке задаются формат выходного файла,
различные эффекты и их параметры.
Под управляющей
панелью показывается оригинальное изображение в заданном масштабе и
полупрозрачная зона обрезки. Вы можете задать масштаб результирующего файла и
обрезку, изменяя размеры зоны мышью за правый нижний угол и перемещая зону по
изображению. Можно также задать габариты выходного файла в полях выходной размер.
Поле оригинал задает масштаб просмотра
редактируемого изображения. Справа от него показывается ширина и высота
оригинального изображения в пикселях.
В полях обрезка отображаются размеры выделенной
зоны обрезки в пикселях и масштаб зоны по отношению к результирующему файлу.
Если числа в данных полях отображаются красным цветом, то это означает, что
результирующее изображение больше оригинала, т.е. это приведет к ухудшению
качества изображения. Максимальное качество изображения будет достигнуто, если
масштаб обрезки равен 100%. Поля начало показывают
координаты левого верхнего угла зоны обрезки относительно оригинала.
В полях выходной размер задаются и отображаются
ширина и высота результирующего файла в пикселях.
Возможные выходные
форматы изображения: формат оригинала, GIF, JPG, PNG
Возможные эффекты:
Водяной знак. Добавляет поверх изображения значение текущего
параметра "водяной знак" (view_watermark). В поле прозрачность можно указать процент
прозрачности знака (по умолчанию - 30%). В полях x и y можно задать координаты левого верхнего угла знака (по умолчанию знак
располагается в правом нижнем углу изображения).
Бордюр. Добавляет рамку вокруг изображения. В поле цвет можно задать цвет рамки в шестнадцатеричном формате от 000000
до FFFFFF (по умолчанию -
серая рамка 333333). В поле x задается толщина рамки в пикселях (по
умолчанию - 1 пиксель).
Текст. Добавляет произвольный текст поверх изображения. В поле цвет задается цвет текста в
шестнадцатеричном формате от 000000 до FFFFFF (по умолчанию - белый FFFFFF). В поле прозрачность
можно указать процент прозрачности текста (по умолчанию - 50%). В полях x и y можно задать координаты левого верхнего угла
текста (по умолчанию текст располагается в правом нижнем углу изображения). В
поле текст вводится требуемый текст
(по умолчанию - текущее значение параметра "копирайт" site_copyright). В следующем поле указывается число от 1 до 7,
задающее шрифт для текста. Шрифты с 1 по 5 содержат только латинские буквы.
Шрифт 6 (fixedsys) и 7 (courier) имеют полный набор знаков (по умолчанию - шрифт
6 fixedsys).
Поворот. Осуществляет поворот изображения на заданный угол. В поле x задается величина поворота в градусах против часовой стрелки (по умолчанию
- 90 градусов). В поле цвет можно
задать цвет свободного фона изображения в шестнадцатеричном формате от 000000
до FFFFFF (по умолчанию -
белый FFFFFF).
При нажатии на кнопку ввести редактор создает выходное
изображение в соответствии с заданными размерами, форматом и эффектом, делает
архивную копию предыдущего файла, заменяет редактируемый графический параметр
на полученное изображение и завершает процесс редактирования.
Действия при нажатии
на кнопку применить аналогичны
предыдущим, но при этом процесс редактирования не завершается. Это дает
возможность за один сеанс редактирования применить несколько эффектов.
Кнопка восстановить заменяет редактируемый
файл на предыдущую сохраненную архивную копию. Внимание! Сохраняется только
одна (последняя) копия изображения. Все более ранние файлы удаляются!
Кнопка сбросить восстанавливает начальные
значения в полях форм на контрольной панели и размер области обрезки.
| 3.1.7.1. Режим редактирования изображения
Если текущий объект
содержит какие-либо графические параметры (графика, иконка и др.), то Вы можете
воспользоваться встроенным графическим редактором для модификации этих
изображений Для редактирования основной графики объекта (параметр "графика")
можно воспользоваться пунктом "графика" контекстного меню или пунктом
img контрольной панели. Для модификации других
графических параметров необходимо войти в режим редактирования или просмотра
свойств объекта и нажать на ссылку изменить
слева от соответствующего изображения нужного параметра.

|
Рис. 1. Работа в режиме изменения (редактирования) текущего изображения.
|
При запуске редактора
в данном режиме стартовые значения выходных размеров и зоны обрезки совпадают с
размерами оригинального редактируемого файла. Если Вы не задаете выходные
размеры "вручную" в полях ввода на панели, а только изменяете зону
обрезки или устанавливаете эффекты, то в этом случае результирующий файл будет
сохранен в масштабе оригинала, т.е. с максимальным качеством. Если при задании
каких-либо выходных размеров или зоны обрезки масштаб обрезки на панели
начинает отображаться красным цветом, то это означает, что результирующее
изображение будет больше оригинала, т.е. это приведет к ухудшению качества
изображения. В этом случает необходимо увеличить выходные размеры или величину
зоны обрезки или восстановить начальные значения, нажав кнопку сбросить.

|
Рис. 2. Применение одновременно нескольких эффектов при редактировании.
|
Для завершения работы
редактора с сохранением полученного изображения, нужно нажать кнопку ввести. Если Вы хотите задать несколько
эффектов одновременно, например добавить рамку и водяной знак, то после задания
каждого эффекта необходимо нажимать кнопку применить,
а затем закрыть окно редактора (рис. 2).
| 3.1.7.2. Режим создания иконки
Если текущий объект
содержит основное графическое изображение, заданное параметром
"графика" (icon),
то для него можно создать иконку - уменьшенную копию, требуемого размера. Для
этого нужно нажать левую клавишу мыши на пункте icon контрольной панели
или воспользоваться пунктом иконка
контекстного меню. Если Вы находитесь в режиме редактирования или просмотра
свойств объекта, то можно нажать на ссылку иконка
слева от изображения параметра "графика".
При запуске редактора
в данном режиме справа от оригинала будет отображаться результирующий файл
(иконка) в реальном масштабе. Под ней показывается предыдущая архивная копия,
если она была создана. Стартовые значения выходных размеров и зоны обрезки в
этом режиме соответствуют текущим значениям параметров "max ширина автоиконки" (view_make_icon_x) и "max высота автоиконки". Начальное
расположение зоны обрезки - в левом верхнем углу оригинала.

|
Рис. 1. Работа графического редактора в режиме создания иконки.
|
В полях контрольной
панели Вы можете задать требуемые размеры иконки и перемещать зону обрезки по
исходному изображению. Изменяя размеры зоны мышью, Вы тем самым задаете масштаб
результирующего файла по отношению к оригиналу. Если при задании каких-либо
выходных размеров иконки или зоны обрезки масштаб обрезки на панели начинает
отображаться красным цветом, то это означает, что результирующее изображение
будет больше оригинала, т.е. это приведет к ухудшению качества изображения. В
этом случает необходимо увеличить зону обрезки или восстановить ее начальные
значения, нажав кнопку сбросить.
Для завершения работы
редактора с сохранением полученной иконки, нужно нажать кнопку ввести. Редактор делает архивную копию
предыдущего файла иконки и заменяет графический параметр "иконка"
текущего объекта на полученное изображение.
Перед сохранением
иконки Вы можете задать формат выходного файла и какой-либо эффект (только
один). Если Вы хотите скорректировать полученную иконку или применить
дополнительные эффекты, то необходимо повторно запустить графический редактор,
но уже в режиме изменения параметра,
нажав на ссылку изменить слева от
полученного изображения (рис. 2).

|
Рис. 2. Запуск редактора из режима просмотра свойств объекта.
|
В режиме создания
иконки параметр "графика", из которого создается иконка остается
каких-либо без изменений. Т.е. Вы можете повторно запустить редактор в этом режиме и создать новую иконку с
другими размерами или эффектами.
| 3.1.8. Настройки
Внешний вид
модуля JM и режимы его работы
задаются тремя типами настроек:
| 3.1.8.1. Опции контрольной панели
Опции контрольной
панели (в правой части рис. 1 и 2) управляют некоторыми текущими настройками
интерфейса модуля JM.

|
Рис. 1. Контрольная панель JM для текущего объекта (текстовый режим
панели)
|

|
Рис. 2. Контрольная панель JM для текущего объекта (графический режим
панели)
|
Опция hidden (скрытно) ( ) задает значение атрибута "права на
чтение для остальных" при вводе нового объекта и копировании. Если данная
опция включена, то новые объекты будут добавляться в дереве сайта
"скрытно", т.е с отключенным правом на чтение. Стартовое значение
данной опции задается настройкой JM nohidden=.
Опция text (текст) ( ) переключает текстовый и основной режимы
работы модуля JM. В текстовом
режиме отключены графические изображения пиктограмм в дереве сайта для
ускорения работы JM при
низкоскоростном соединении. Стартовое значение данной опции задается настройкой
JM text=.
Поле ввода высота (левое) устанавливает или
отменяет режим работы модуля JM с фиксированной высотой. Число, введенное в данном поле задает высоту
панелей JM в пикселях (рис.
2). При этом, для каждой панели JM отображаются независимые полосы прокрутки. Введенное значение 0 отменяет
данный режим работы и отключает полосы прокрутки. Нажатие правой клавиши в
данном поле производит переключение между двумя режимами работы. Стартовое
значение данной опции задается настройками JM height_start= и height=.
Поле ввода ширина (правое) задает ширину левой
панели в процентах к общей ширине модуля JM (рис. 2). Нажатие правой клавиши в данном поле
восстанавливает начальное значение. Стартовое значение данной опции задается
настройкой JM width=.

|
Рис. 3. Внешний вид модуля JM с фиксированной высотой.
|
Все стартовые значения
опций контрольной панели можно задать в конфигурации JM параметром "настройки менеджера" (См.
ниже).
| 3.1.8.2. Параметры объекта JM
Все основные настройки модуля Джей-менеджер задаются параметрами самого
объекта JM (id=7).
Параметр "настройки менеджера" представляет собой
текстовое поле, каждая строка которого задает одну опцию и имеет следующий
синтаксис:
ОПЦИЯ1=ЗНАЧЕНИЕ1 ОПЦИЯ2=ЗНАЧЕНИЕ2
Возможны следующие опции и их значения:
Опция
|
Умолчание
|
Описание
|
rootid=ЧИСЛО
|
1
|
Задает
идентификатор начала ветви, которая будет видна в модуле JM. При попытке изменить или удалить объект,
находящийся вне данной ветви, администратору будет выдано сообщение об
отсутствии такого объекта. Если параметр не задан, то модуль JM отображает все дерево сайта.
|
rootid=SQL
|
нет
|
Задает SQL-выражение для указания нескольких корней дерева
сайта. Альтернатива предыдущей опции.
|
filter=SQL
|
нет
|
Задает SQL-выражение для указания фильтра объектов,
показываемых в дереве сайта. Т.е. все объекты которые может видеть
администратор в дереве сайта должны удовлетворять заданному условию.
|
text=0/1
|
0
|
Устанавливает при старте текстовый
режим работы модуля (по умолч. - графический). Опция контрольной панели -
text.
|
simple=0/1
|
0
|
Устанавливает упрощенный режим работы
JM. Аналог: nocontentext
noparamsadd nouser nogroup norights nofilter noimport noadd noadmin.
|
width=ЧИСЛО
|
50
|
Задает ширину левой панели в
процентах к общей ширине модуля JM. Можно изменить в правом поле на контрольной панели иодуля.
|
height=ЧИСЛО
|
500
|
Задает высоту окна JM в режиме работы с фиксированной
высотой. Можно изменить в поле на контрольной панели иодуля.
|
height_start=0/1
|
0
|
Устанавливает режим работы с
фиксированной высотой.
|
nohidden=0/1
|
0
|
Выключает при старте модуля
опцию контрольной панели hidden.
|
nologin=0/1
|
0
|
Задает режим просмотра объекта
по умолчанию с анонимными правами.
|
template=ШАБЛОН
|
main_content
|
Задает имя шаблона для
просмотра объекта по умолчанию.
|
open=СПИСОК
|
1,100
|
Задает список раскрытых
объектов в дереве сайта при старте модуля.
|
max_childs=ЧИСЛО
|
100
|
Задает максимальное число
дочерних на одной странице при просмотре ветви.
|
flimit=ЧИСЛО
|
99
|
Задает лимит (максимальное
число дочерних) в выборке ФИЛЬТРА по умолчанию.
|
icon_x=ЧИСЛО
|
100
|
Задает максимальную ширину при
показе графических параметров в ФИЛЬТРЕ.
|
icon_y=ЧИСЛО
|
100
|
Задает максимальную высоту при
показе графических параметров в ФИЛЬТРЕ и редактировании объекта.
|
textareas_h=ЧИСЛО
|
50
|
Задает высоту в пикселях
текстового поля "аннотация" при редактировании объекта.
|
textareac_h=ЧИСЛО
|
100
|
Задает высоту в пикселях поля
"текст" (контент) при редактировании объекта.
|
textareap_h=ЧИСЛО
|
50
|
Задает высоту в пикселях
остальных текстовых полей при редактировании параметров объекта.
|
confirm=0/1
|
0
|
Задает режим подтверждения
операции удаления параметров редактируемого объекта.
|
keyleft=info / view / edit / menu / none
|
info
|
Задает действие с объектом по
левому щелчку мыши на папке или заголовке (свойства, просмотр,
редактирование, контекстное меню или ничего).
|
afterapply=edit / info / view / none
|
edit
|
Задает действие с объектом после
его ввода при нажатии клавиши "применить" (повторное редактирование,
вывод свойств, просмотр объекта или ничего).
|
user_filter=SQL
|
нет
|
Задает фильтр для списка
владельцев при редактировании объекта.
|
group_filter=SQL
|
нет
|
Задает фильтр для списка групп
при редактировании объекта.
|
noimg=0/1
|
0
|
Выключает отображение графики
при работе модуля.
|
nodate=0/1
|
0
|
Отключает возможность редактирования
даты и времени публикации объекта.
|
noshort=0/1
|
0
|
Отключает возможность
редактирования аннотации объекта.
|
nocontent=0/1
|
0
|
Отключает
возможность редактирования контента (основного текста) объекта.
|
nocontentext=0/1
|
0
|
Отключает
возможность расширенного редактирования контента (JEditor и т.п.).
|
nodoc=0/1
|
0
|
Отключает
возможность загрузки документа (doc) в качестве контента.
|
nohtml=0/1
|
0
|
Отключает
возможность ввода HTML-тегов
в заголовке, аннотации, тексте и любых параметрах.
|
noparams=0/1
|
0
|
Отключает
возможность редактирования параметров объекта.
|
noparamsadd=0/1
|
0
|
Отключает
возможность добавления параметров при редактировании объекта.
|
nogroup=0/1
|
0
|
Отключает
возможность редактирования группы объекта.
|
norights=0/1
|
0
|
Отключает
возможность редактирования прав на объект.
|
nofilter=0/1
|
0
|
Отключает показ
панели ФИЛЬТР при работе модуля.
|
noimport=0/1
|
0
|
Отключает показ
панели ИМПОРТ при работе модуля.
|
nojparams=0/1
|
0
|
Отключает показ
панели ПАРАМЕТРЫ при работе модуля.
|
noadd=0/1
|
0
|
Отключает
возможность добавления произвольных объектов (разрешено только по заданному
образцу).
|
noadddef=0/1
|
0
|
Отключает
возможность добавления любых объектов.
|
noadmin=0/1
|
0
|
Отключает показ
подменю "администратор".
|
ctrl_text=0/1
|
1
|
Задает
текстовый или графический режим работы контрольной панели.
|
ctrl_lang=ru / en / de
|
en
|
Задает язык
пунктов меню контрольной панели в текстовом режиме.
|
piconsize=16/32
|
16
|
Задает размер пиктрограмм
контрольной панели в пикселах.
|
iconsize=16/32
|
16
|
Задает размер пиктрограмм
дерева в пикселах.
|
iconsown[16]=ЧИСЛО
iconsown[32]=ЧИСЛО
|
18
22
|
Задает
идентификаторы объектов с собственными графическими ресурсами для
соответствующего набора пиктрограмм.
|
fontsize=12/14
|
12
|
Задает размер системного
шрифта в пикселах для работы модуля.
|
days_log=ЧИСЛО
|
365
|
Задает число
дней для показа логов объекта.
|
days_stat=ЧИСЛО
|
30
|
Задает число
дней для показа статистики объекта.
|
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).
| 3.1.8.3. Пользовательские настройки JM
В группе
"ПОЛЬЗОВАТЕЛЬ СЛУЖЕБНЫЕ" есть параметр "настройки
менеджера" (user_jmanager_conf), значения
которого влияют на режим работы администраторов в модуле JM. Этот параметр устанавливается с помощью
модуля Пользователи главным администратором сайта в профиле остальных
администраторов с ограниченными правами. Сами администраторы изменить значения
параметров из этой группы не могут.
Параметр "настройки менеджера" представляет собой
текстовое поле, каждая строка которого задает одну опцию и имеет следующий синтаксис:
ОПЦИЯ1=ЗНАЧЕНИЕ1 ОПЦИЯ2=ЗНАЧЕНИЕ2
Возможные опции и их значения аналогичны тем, которые описаны в Параметрах объекта JM.
Опции manager_example и manager_example_def можно задавать
только в параметре пользователя user_jmanager_conf.
Те опции, которые не указаны для конкретного администратора берутся из
общих настроек модуля JM (jmanager_conf) или
устанавливаются по умолчанию (если они не заданы ни в одном из параметров).
| 3.2. Джей-параметры
Административный
модуль Джей-параметры (далее JP) предназначен для управления параметрами объектов (дополнительными
полями), которые могут использоваться для создания новых типов данных,
интерактивных форм, различных настроек сайта и др.
С помощью модуля можно
создавать различные формы гостевых книг, опросов, анкет, заводить свои
классификаторы, различные типы объектов, разрабатывать пользовательские базы
данных. Модуль JP позволяет
создавать новые группы и параметры, изменять существующие, переносить параметры
из одной группы в другую, выбирать объекты с установленными параметрами,
удалять параметры и группы.
Войти в модуль JP можно по адресу http://адрес_сайта/4 или через меню
администратора по ссылке jparams (после авторизации на сайте).
Внешний вид и интерфейс
модуля JP аналогичен модулю
Джей-менеждер (рис. 1). В верхней части окна расположена контрольная панель управления и настроек. Остальная часть окна
разбита на несколько управляющих и информационных панелей. Каждая панель имеет свой заголовок и для наглядности
обведена рамкой. Все панели можно закрывать или открывать щелчком мыши на
заголовке панели (или значке +/- перед заголовком).

|
Рис. 1. Внешний вид модуля JP
|
В левой части окна
расположена основная панель ПАРАМЕТРЫ с группами и параметрами сайта. Справа
выводятся различные панели с формами для редактирования, информацией,
диагностикой действий администратора.
JP может работать в
двух режимах: основном и текстовом. Текстовый
режим отключает графические изображения пиктограмм в дереве для ускорения
работы JP при низкоскоростном
соединении. Текущий режим работы JP задается параметрами самого объекта JP, параметрами администратора (пользователя сайта)
и опциями контрольной панели.
Язык интерфейса JP задается параметром "язык сайта или
подраздела". По умолчанию он совпадает с языком, заданным для всего сайта.
В левой части
контрольной панели всегда выводится статус (состояние) JP (…, ready или busy…) и меню управления
текущего (выделенного) параметра (группы) в дереве (рис. 2). В правой части –
настройки JP (в упрощенном
режиме они отключены). Статус …
появляется только при старте JP. В этот момент производится начальная загрузка всех требуемых данных и
настроек модуля. В состоянии busy… JP обрабатывает очередную команду администратора – передает, получает и
отображает различную информацию с сервера. Начинать работу с JP или давать новую команду нужно только
после появления статуса ready.

|
Рис. 2. Контрольная панель JP для текущего параметра (группы)
|
В левой части панели
ПАРАМЕТРЫ расположены папки (пиктограммы) и названия параметров и групп. Правее
указываются переменная, тип параметра и количество объектов, в которых
установлен данный параметр (рис. 3).

|
Рис. 3. Строка группы и параметров в дереве
|
Раскрытие и закрытие
ветвей групп параметров производится с помощью пиктограмм  (плюс, минус), расположенных слева от папки
группы. Пиктограмма на контрольной панели раскрывает все группы
параметров. Пиктограмма на контрольной панели закрывает все группы. Во
время работы JP "запоминает"
состояние дерева и настройки на время сессии броузера, т.е. при повторных
обращениях к модулю администратор увидит дерево параметров в том же самом
состоянии.
Все административные
действия в JP производятся
над текущим (выделенным) параметром или группой. Левый щелчок мыши на папке
(пиктограмме) или заголовке параметра (группы) в дереве делает его текущим. В
этот момент на контрольной панели появляется идентификатор (переменная)
параметра и меню управления, сама строка выделяется светло-серым фоном. Правый
щелчок мыши на параметре (группе) делает его текущим и одновременно выдает
выпадающее контекстное меню (рис. 4).

|
Рис. 4. Контекстное меню и подменю JP
|
В контекстном меню
указаны все допустимые действия администратора над текущим параметром (просмотр,
изменение, удаление и др.). Большинство операций над текущим объектом доступны
с помощью так называемых "горячих клавиш". Их комбинации указаны на
панели контекстного меню. Все "горячие клавиши" действуют только в
том случае, если в дереве есть текущий параметр и в правой части окна JP нет панелей с формами, т.е. "горячие
клавиши" отключаются в момент добавления или редактирования параметра
(группы). Отдельные пункты меню имеют выпадающие подменю для выбора типа
операции. Некоторые операции выводят дополнительные окна для подтверждения
действия администратора или ввода уточняющих значений.
| 3.2.1. Назначение параметров
Все параметры сайта
разбиты на группы по назначению и в модуле Параметры показываются в виде дерева
(рис. 1). Любой параметр сайта имеет следующие характеристики:
Характеристика
|
|
Описание
|
description
|
название
|
Текст с
названием параметра, который используется в модуле JM при добавлении параметра к объекту и
редактировании его значений. Этот же текст используется при создании ФОРМ с
данным параметром, если не заданы дополнительные его характеристики description и description_ЯЗЫК (см. ниже)
|
name
|
переменная
|
Уникальный
текстовый идентификатор параметра. При создании нового параметра он
генерируется автоматически из имени (переменной) группы, в которой он
создается и числа.
|
type
|
Тип
|
Тип параметра -
его основная характеристика (см. ниже)
|
longdescription
|
модификаторы
|
Текстовое поле
для задания модификаторов (дополнительных характеристик) параметра. Каждая
строка поля задает один модификатор и имеет следующий синтаксис
МОДИФИКАТОР=ЗНАЧЕНИЕ (см. ниже)
|
value
|
значение
|
Текстовое поле
для задания возможных значений параметров некоторых типов (select, radio, mselect и др.)
|
required
|
проверять при вводе
|
Устанавливает
обязательность ввода данного параметра в поле интерактивной формы (для типов text, textarea, number).
|
storage
|
отдельное поле
|
Задает способ
хранения данного параметра в базе данных.
|
priority
|
приоритет
|
Число, задающее
положение параметра внутри группы. Любой новый параметр создается с высшим
приоритетом, т.е. располагается верхним (первым) в группе. Изменить приоритет
параметра можно с помощью пункта контекстного меню передвинуть или соответствующими "горячими клавишами".
|
| 3.2.2. Типы параметров
Тип параметра - это
основная характеристика, определяющая вид поля для ввода (редактирования)
параметра в форме и способ его хранения в базе данных.
Характеристика
|
Внешний вид в формах и JM
|
Описание
|
text
|

|
Поле для ввода произвольной строки текста (до 256
символов)
|
textarea
|

|
Поле для ввода больших объемов текста (до 64К)
|
number
|

|
Поле для ввода чисел (до 256 символов)
|
password
|

|
Поле для ввода паролей (до 256 символов)
|
checkbox
|

|
Переключатель
да/нет (1/0)
|
image
|

|
Поле для загрузки графического файла (GIF, JPG, PNG)
|
file
|

|
Поле для загрузки файла произвольного типа
|
date
|



|
Поля для ввода текста в формате даты. Внешний вид,
количество и тип отдельных полей задаются дополнительными характеристиками
параметра fedateformat и fedatecal (см. ниже).
|
select
|

|
Выбор одной альтернативы в виде выпадающего меню.
Варианты для выбора задаются в характеристике value в виде списка
не менее чем из двух строк: значение 1=вариант 1
значение 2=вариант 2
значение 3=вариант 3
|
mselect
|

|
Выбор одной альтернативы в виде выпадающего меню.
Варианты для выбора задаются в характеристике value в виде строки SQL-запроса. Данный запрос должен вернуть не менее
одного объекта из базы данных.
|
radio
|

|
Выбор одной альтернативы в виде радио-кнопки. Варианты
для выбора задаются в характеристике value в виде списка
не менее чем из двух строк значение 1=вариант 1
значение 2=вариант 2
значение 3=вариант 3
|
mradio
|

|
Выбор одной альтернативы в виде радио-кнопки. Варианты
для выбора задаются в характеристике value в виде строки SQL-запроса. Данный запрос должен вернуть не менее
одного объекта из базы данных. В
качестве альтернатив указываются заголовки объектов, удовлетворяющих
заданному условию.
|
checks
|

|
Выбор нескольких значений из заданных альтернатив.
Варианты для выбора задаются в характеристике value в виде списка: значение 1=вариант 1
значение 2=вариант 2
значение 3=вариант 3
|
mchecks
|

|
Выбор нескольких значений из заданных альтернатив.
Варианты для выбора задаются в характеристике value в виде строки SQL-запроса. Данный запрос должен вернуть не менее
одного объекта из базы данных. В
качестве альтернатив указываются заголовки объектов, удовлетворяющих
заданному условию.
|
selects
|

|
Выбор нескольких значений из заданных альтернатив в
виде списка с множественным выделением. Варианты для выбора задаются в
характеристике value в виде списка: значение 1=вариант 1
значение 2=вариант 2
значение 3=вариант 3
|
mselects
|

|
Выбор нескольких значений из заданных альтернатив в
виде списка с множественным выделением. Варианты для выбора задаются в
характеристике value в виде строки SQL-запроса. Данный запрос должен вернуть не менее
одного объекта из базы данных. В
качестве альтернатив указываются заголовки объектов, удовлетворяющих
заданному условию.
|
const
|
|
Подзаголовок для группы параметров в форме.
|
hidden
|
|
Организация скрытого поля в форме.
|
custom
|
|
Пользовательский
тип параметра.
|
Описания и назначения
параметров типового проекта приведены в Приложении.
| 3.2.3. Модификаторы параметровМодификаторы предназначены в основном для задания внешнего вида параметров в интерактивных формах и различных служебных функций. Значение модификаторов задаются при вводе или редактировании параметров в поле "дополнительные" (longdescription) в виде отдельных строк в формате:
МОДИФИКАТОР1=ЗНАЧЕНИЕ1
МОДИФИКАТОР2=ЗНАЧЕНИЕ2
Модификатор
|
Используется
|
Описание
|
description=ТЕКСТ
description[ЯЗЫК]=ТЕКСТ
|
для параметров интерактивных форм
|
Текст, который будет отображаться в интерактивной форме перед полем для ввода данного параметра. На многоязычных сайтах можно указать различный текст для соответствующих ветвей сайта. Если данная характеристика не указана, то в форме отображается название параметра. Пример:
description=Ваше имя
description[ru]=Ваше имя
descriptionn[en]=Your Name
|
tdescription=ТЕКСТ
tdescription[ЯЗЫК]=ТЕКСТ
|
для параметров интерактивных форм
|
Текст, который будет отображаться при показе результатов введенной интерактивной формы перед значением данного параметра. На многоязычных сайтах можно указать различный текст для соответствующих ветвей сайта. Если данная характеристика не указана, то в форме отображается название параметра. Пример:
tdescription=Вы ввели имя
tdescription[ru]=Вы ввели имя
tdescription[en]=You enter name
|
desctext=ТЕКСТ
desctext[ЯЗЫК]=ТЕКСТ
|
для параметров интерактивных форм
|
Дополнительный текст, который будет отображаться в интерактивной форме рядом с названием параметра или характеристикой description
|
fdstyle=CSS_СТРОКА
|
для параметров интерактивных форм
|
Строка текста в формате CSS, задающая стиль показа описания параметра в интерактивной форме. Пример:
fdstyle=width:200px; font-weight:bold;
|
festyle=CSS_СТРОКА
|
для параметров интерактивных форм
|
Строка текста в формате CSS, задающая стиль показа поля для ввода параметра в интерактивной форме. Пример:
festyle=width:300px; border:1px solid #999;
|
onclick=ИМЯ_ФУНКЦИИ()
|
для параметров интерактивных форм
|
Указывает имя JavaScript функции, которая будет запускаться на событии onclick в поле ввода данного параметра в интерактивной форме.
|
onchange=ИМЯ_ФУНКЦИИ()
|
для параметров интерактивных форм
|
Указывает имя JavaScript функции, которая будет запускаться на событии onchange в поле ввода данного параметра в интерактивной форме.
|
onsubmitfunc=ИМЯ_ФУНКЦИИ
|
для параметров интерактивных форм
|
Указывает имя JavaScript функции, которая будет запускаться при вводе интерактивной формы с данным параметром. Как правило, используется для проверки корректности значений введенных параметров формы.
|
readonly=yes
|
для параметров интерактивных форм
|
Устанавливает атрибут readonly (запрещение редактирования) в поле ввода данного параметра в форме.
|
disabled=yes
|
для параметров интерактивных форм
|
Устанавливает атрибут disabled (запрещение) в поле ввода данного параметра в форме.
|
strip_tags=no
|
для параметров интерактивных форм типа text, textarea
|
Разрешает ввод HTML-тегов в поле данного параметра в форме. По-умолчанию, все HTML-теги из полей типа text и textarea в введенной форме удаляются. Используется в модулях form и forumx.
|
strip_tags=yes
strip_tags=1
|
для параметров типа text, textarea, number
|
Удаляет все HTML-теги из значений данного параметра при вводе, импорте и редактировании.
|
safe=yes
safe=1
|
для параметров типа text, textarea, number
|
При показе (выводе) значений данного параметра все HTML-теги преобразуются в HTML-мнемоники (текст)
|
femaxlength=ЧИСЛО
|
для параметров интерактивных форм типа text, textarea
|
Устанавливает значение атрибута maxlength (максимальная длина вводимого текста) в поле ввода данного параметра в интерактивной форме.
|
fesize=ЧИСЛО
|
для параметров интерактивных форм типа select, mselect
|
Устанавливает значение атрибута size (максимальное число строк) в поле ввода данного параметра в интерактивной форме.
|
fedateformat=ВИД_ДАТЫ
|
для параметров интерактивных форм типа date
|
Задает формат ввода даты (дня, месяца, года) и времени в виде списков или текстовых полей. Примеры:
fedateformat=dsmsys - ввод даты с помощью списков
fedateformat=dimiyiti - ввод даты и времени с помощью текстовых полей
fedateformat=t - ввод только времени в формате ЧЧ:ММ
|
fedstyle=CSS_СТРОКА
femstyle=CSS_СТРОКА
feystyle=CSS_СТРОКА
fetstyle=CSS_СТРОКА
|
для параметров интерактивных форм типа date
|
Строки текста в формате CSS, задающие стиль показа полей для ввода дня, месяца, года и времени в интерактивной форме. Указываются вместе с характеристикой fedateformat.
|
fedatecal=ФОРМАТ_ДАТЫ
|
для параметров интерактивных форм типа date
|
Задает формат ввода даты и времени с использованием календаря. Примеры:
fedatecal=%d.%m.%Y - ввод даты в формате ДД.ММ.ГГГГ
fedatecal=%d.%m.%Y %H:%M - ввод даты и времени
|
selected=ТЕКСТ
selected=$ PARAMS[имя]
selected=$ USER[имя]
|
для параметров интерактивных форм
|
Задает начальное значение поля формы. Поле заполняется указанным текстом или значением указанного параметра текущего объекта или пользователя (для авторизованных посетителей). Примеры:
selected=01.01.2005
selected=$ PARAMS[today]
selected=$ USER[name]
|
y_start=ГОД
|
для параметров интерактивных форм типа date
|
Задает начальное значение списка годов для ввода даты в формате fedateformat=dsmsys. Указывается четырехзначное число или ключевое слово today - текущий год.
|
y_end=ГОД
|
для параметров интерактивных форм типа date
|
Задает конечное значение списка годов для ввода даты в формате fedateformat=dsmsys. Указывается четырехзначное число или ключевое слово today - текущий год.
|
y_order=desc
|
для параметров интерактивных форм типа date
|
Задает обратный порядок для списка годов (от более позднего к раннему).
|
search=ИМЯ_ПАРАМЕТРА
|
для параметров, используемых в форме поиска
|
Указывает модулю поиска (search), с каким параметром (атрибутом) объекта надо сравнивать значение, введенное в поле данного параметра в форме посика. Примеры:
search=mess_header
search=art_type
|
searchcond=УСЛОВИЕ
|
для параметров, используемых в форме поиска
|
Указывает модулю поиска (search) условие сравнения значения параметра (атрибута) и числа, введенного в поле формы поиска. УСЛОВИЕ может быть следующим:
lt - параметр меньше введенного числа
le - параметр меньше или равен введенному числу
gt - параметр больше введенного числа
ge - параметр больше или равен введенному числу
eq - параметр равен введенному числу
like - параметр содержит введенную строку
bool - параметр содержит введенные слова (аналог расширенного запроса)
nl - искать пустые значения параметров, если в они не заданы в форме (для параметров list, checks, mselects, selects)
|
searchlist=УСЛОВИЕ
|
для параметров в форме поиска типа list, checks, mselects, selects
|
Указывает модулю поиска (search) условие проверки "многозначных" параметров и полей, заданных в форме (по умолчанию - and). УСЛОВИЕ может быть следующим:
or - параметр содержит любое указанное в форме значение
and - параметр содержит все указанные в форме значения
Для поиска "пустых" значений используется модификатор searchcond=nl (см. выше)
|
dependmaster=ИМЯ_ПАРАМЕТРА
|
для параметров типа mselect, mradio, list и mselects
|
Указывает имя "управляемого" параметра. Значения списка указанного параметра будут зависеть от выбранного значения данного параметра.
|
dependslave=ИМЯ_ПАРАМЕТРА
|
для параметров типа mselect, mradio, list и mselects
|
Указывает имя "управляющего" параметра. Значения списка данного параметра будут зависеть от выбранного значения указанного параметра.
|
limit=X,XX
|
для параметров типа mselect, mradio, list и mselects
|
Задает limit для создания списка значенией данного параметра.
|
order=SQL
|
для параметров типа mselect, mradio, list и mselects
|
Задает order для создания списка значенией данного параметра (по умолчанию - tree_order).
|
edit=no
|
для служебных параметров
|
Запрещает всем Пользователям изменение значений данного параметра в объектах с помощью модуля JM
|
edit_groups=СПИСОК
|
для служебных параметров
|
Задает список групп пользователей, которым разрешено редактирование данного параметра в объектах с помощью модуля JM
|
parse=1
parse=yes
|
для параметров типа textarea
|
Значения данного параметра в объектах задаются в виде отдельных строк в форматах:
КЛЮЧ1=ЗНАЧЕНИЕ1
КЛЮЧ2=ЗНАЧЕНИЕ2
КЛЮЧ3[]=ЗНАЧЕНИЕ31
КЛЮЧ3[]=ЗНАЧЕНИЕ32
КЛЮЧ4[индекс1]=ЗНАЧЕНИЕ41
КЛЮЧ4[индекс2]=ЗНАЧЕНИЕ42
В результирующие XML данные этот параметр попадет в виде набора узлов
< ПАРАМЕТР>
< КЛЮЧ1>ЗНАЧЕНИЕ1< /КЛЮЧ1>
< КЛЮЧ2>ЗНАЧЕНИЕ2< /КЛЮЧ2>
< КЛЮЧ3>
< item id="0">ЗНАЧЕНИЕ31< /item >
< item id="1">ЗНАЧЕНИЕ32< /item >
< /КЛЮЧ3>
< КЛЮЧ4>
< item id="индекс1">ЗНАЧЕНИЕ41< /item>
< item id="индекс2">ЗНАЧЕНИЕ42< /item>
< КЛЮЧ4>
< /ПАРАМЕТР>
|
modekey=ЧИСЛО
|
для параметра imagekey
|
Задает режим генерации защитного кода.
modekey=1 - генерируется одно число для ввода
modekey=2 - генерируется два числа для ввода суммы
|
keywidth=ЧИСЛО
keyheight=ЧИСЛО
|
для параметра imagekey
|
Задают ширину и высоту изображения защитного кода в пикселах. Если модификаторы не заданы, то код выводится размером 66х29.
|
max_file_size=ЧИСЛО
|
для параметров типа file, image
|
Задает максимальный размер загружаемых файлов в байтах
|
filename=ИМЯ_ФАЙЛА
|
для параметров типа file
|
Задает имя загружаемого файла, под которым он будет храниться на сервере
|
fileext=РАСШИРЕНИЕ_ФАЙЛА
|
для параметров типа file
|
Задает расширение загружаемого файла, под которым он будет храниться на сервере
|
allowext=xxx,yyy,zzz
|
для параметров типа file
|
Задает список допустимых расширений загружаемых файлов
|
textsize=mediumtext
textsize=longtext |
для параметров textarea
|
Установка модификатора изменит размер поля params в базе данных. Обычно поле params имеет тип TEXT и размер 65535 байт. С применением двухбайтной кодировки UTF-8 и русских букв допустимый размер поля уменьшается до 32768 символов.
Типы полей mysql и их лимиты:
TEXT - 65 535 байт
MEDIUMTEXT - 16 777 215 байт.
LONGTEXT - 4 294 967 295 байт.
|
| 3.2.4. Основные операции
- просмотр
характеристик параметра (группы)
- просмотр списка объектов, где
установлен параметр
- изменение
(редактирование) параметра (группы)
- добавление
новой группы
- добавление
нового параметра
- удаление
параметра (группы)
- передвижение
параметра в группе
- сортировка
параметров (групп)
- перенос
параметра
- дублирование
параметра
- копирование
и вставка параметра
- вырезание
и вставка параметра
| 3.3. Статистика
Административный
модуль Статистика (stat),
предназначен для просмотра и анализа статистической информации о посетителях
сайта. Возможно предоставление информации в различных формах - отдельно по
конкретной странице, по всем страницам, по любому посетителю. Модуль включает в
себя генератор статистических таблиц в формате CSV.
| 3.4. Пользователи
Административный
модуль Пользователи (users)
предназначен для управления пользователями, зарегистрированными на сайте.
Модуль позволяет заводить новые группы пользователей, новых пользователей,
изменять параметры зарегистрированных пользователей, включать их в различные
группы.
| 3.5. Стили
Административный
модуль Стили (styles)
предназначен для проверки синтаксиса, контроля и загрузки библиотеки XSL шаблонов сайта и отдельных блоков. Модуль
позволяет управлять установленными шаблонами и стилями отдельных объектов или
ветвей сайта.

|
Рис. 1. Внешний вид модуля Стили
|
| 3.6. Экранный менеджер
Для администраторов
сайта может быть доступен дополнительный административный модуль Экранный
менеджер, предназначенный для оперативного контроля и управления всеми
объектами непосредственно с соответствующих страниц сайта. После авторизации
администратора, на каждой странице сайта в нижней (или верхней) части экрана
будет выдаваться контрольная панель (рис. 1).

|
Рис. 1. Контрольная панель экранного менеджера.
|
Панель экранного
менеджера состоит из четырех секций: пиктограммы для перехода на основные административные
модули, управление объектом текущей страницы, пиктограммы служебных операций и
переключатель "привязки" панели к верхней части экрана. Если
администратору недоступны какие-либо действия над текущим объектом, то
соответствующая пиктограмма будет отсутствовать на панели.
|
Пиктограммы основных административных модулей
(данный набор может отличаться для разных проектов)
|

|
Выход
администратора из режима управления сайтом
|

|
Переход на
список всех административных модулей
|

|
Переход в
модуль Джей-менеджер
|

|
Переход в модуль Параметры
|

|
Переход в модуль Статистика
|

|
Переход в модуль Пользователи
|

|
Переход в модуль Стили
|

|
Переход в модуль Наблюдатель
|

|
Переход в
модуль Просмотра поисков
|

|
Переход на
список дополнительных административных модулей
|
|
Пиктограммы
управления текущим объектом
|

|
Переход в режим
редактирования текущего объекта в модуле JM
|

|
Редактирование текущего объекта
|

|
Удаление текущего объекта
|

|
Просмотр в
отдельном окне контента (основного текста) текущего объекта
|

|
Генерация
(создание) документа из контента текущего объекта в формате MS Word
|

|
Ссылка на
скачивание последнего документа, загруженного в данный объект через конвертор
|
|
Пиктограммы
дополнительных служебных операций
|

|
Перезагрузка XSL-стилей сайта (reloadstyles)
|

|
Включение/выключение
режима трассировки (timepoint)
|

|
Удаление всех
временных и кэш-файлов сайта (clearcache)
|

|
Включение
режима отладки шаблона страницы (debug)
|

|
Включение
режима отображения позиций текущего шаблона (showposition)
|

|
Просмотр в отдельном
окне XML-данных текущей
страницы (showxml)
|
В правой части панели
расположен ее фиксатор. В выключенном состоянии панель находится в стандартной
позиции текущего шаблона (как правило, в нижней части страницы в позиции TAIL). Во включенном состоянии панель всегда
находится в верхней части экрана, под меню броузера. Положение переключателя
для каждого сайта запоминается в cookie.
Режим трассировки
включается и выключается нажатием на пункт "трассировка" ( )
экранного менеджера. При включенном режиме внизу каждой страницы сайта будет
выводится таблица трассировки с временными интервалам ее формирования (рис. 2).

|
Рис. 2. Вывод страницы в режиме трассировки (timepoint)
|
В таблице указываются
номера строк и названия функций ядра системы, а также время выполнения каждой
функции в секундах и процентах от общего времени формирования страницы.
Отдельно перечисляются все формируемые блоки с указанием условия выбора,
условия показа и количества выбранных объектов. В последней строке таблицы
выдается общее время формирования страницы. Временные интервалы иллюстрируются
диаграммой.
В основном, данная
информация предназначена разработчикам системы для контроля и оптимизации
работы TreeGraph. Однако и
администратор сайта может изменять время формирования страницы, отключая
отдельные блоки или изменяя их параметры (условие выбора, количество и др.).
Режим отладки
включается нажатием на пункт "отладка" ( )
экранного менеджера. В этом режиме на странице над каждым сформированным блоком
будет выведена панель с отладочной информацией (рис. 3).

|
Рис. 3. Вывод страницы в режиме отладки (debug).
|
В начальном положении
все панели закрыты. В шапке панели указывается идентификатор блока, который
формирует данную выборку. Нажатие на идентификатор раскрывает или закрывает текущую
панель. В отладочной информации на панели выводится заголовок блока, перечисляются
все его установленные параметры со значениями и выдается список идентификаторов
объектов, которые попали в выборку блока. Все идентификаторы в панели являются
ссылками на редактирование данного объекта в модуле JM.
В основной позиции
шаблона (main) перед
заголовком выводится отладочная панель для объекта текущей страницы. В верхней
части панели перечисляются все установленные параметры объекта со значениями и
выдается список идентификаторов дочерних (или выбранных) объектов. Ниже
выдается таблица с атрибутами объекта, его собственными и наследуемыми
параметрами.
Режим отображения
позиций включается нажатием на пункт "показать позиции" ( )
экранного менеджера. В этом режиме на странице выдается структура шаблона, где вместо
сформированных блоков будет выведены панели с названием позиций каждого блока
(рис. 4).

|
Рис. 4. Вывод страницы в режиме отображения позиций шаблона.
|
Названия позиций в
панели являются ссылками на редактирование данного блока в модуле JM.
XML данные
текущей страницы можно получить, нажав на пункт "показать XML" ( )
экранного менеджера. Броузер откроет отдельное окно с XML-структурой данной страницы (рис. 5).

|
Рис. 5. Вывод страницы в режиме просмотра XML данных.
|
Структура XML данных описана в Приложении Структура XML-дерева страницы.
| 3.7. Наблюдатель
В системе TreeGraph ведется полный учет логов (действий администраторов) над
каждым объектом. Для просмотра логов проекта (в том числе и для удаленных объектов)
в системе TreeGraph имеется специальный модуль Наблюдатель (Watch).
В верхней форме модуля
задается требуемый интервал времени и различные уточняющие данные для
ограничения списка логов:
дата от - задает начальные день и время для вывода списка логов дата до - задает конечные день и
время для вывода списка логов ip-адрес - выводит логи операций, произведенных
только с указанного IP адреса пользователи (id) - выводит логи операций, произведенных
пользователем с указанным идентификатором пользователи (login) - выводит логи операций, произведенных
пользователем с указанным логином действие - выводит логи операций с
указанным действием объект - выводит логи операций,
произведенных над указанным объектом информация - выводит логи с
информацией, содержащей указанный текст
Поля формы количество и сортировка задают ограничение для списка логов и порядок вывода.

|
Рис. 1. Вывод логов проекта за указанный
интервал
|
Информация о логах выводится
в несколько колонок:
логи - уникальный номер записи лога (одного действия администратора) дата модификации - день и время,
когда произошла данная операция (серверное) пользователи - идентификатор и логин
пользователя, выполнившего данную операцию (для анонимных и неавторизованных
пользователей не заполняется) ip-адрес - IP адрес, с которого была произведена данная операция действие - краткое обозначение
операции объект - идентификатор объекта, над
которым производилась данная операция заголовок - заголовок объекта, над
которым производилась данная операция (до его изменения). стр - идентификатор страницы
(объекта), на которой находился пользователь, при выполнении данной операции
(как правило, идентификатор модуля JM) информация - комментарии к операции:
список редактируемых (удаляемых) параметров, имена загружаемых (удаляемых)
файлов и пр.
Необходимо отметить,
что некоторые действия администратора приводят к записи нескольких подряд
идущих логов. Например добавление нового объекта создает следующие логи: clone, sort, update, update params.
| 4. Стандартные модули
Общие модули TreeGraph реализуют стандартные (базовые) задачи проектов. К
ним относятся:
| 4.1. Интерактивные формыВ состав системы TreeGraph входит модуль Форма (form), позволяющий организовывать произвольные
интерактивные формы для связи с посетителями сайта (анкеты, отзывы, гостевые
книги, опросы и т.п.)
| 4.2. ФорумВ состав системы TreeGraph входит модуль Форум, позволяющий
организовывать различные дискуссии (с участием как анонимных, так и
привилегированных посетителей) и оперативно управлять процессом обсуждения
| 4.3. ГолосованияДля организации
упрощенных форм анкетирования посетителей, в состав системы TreeGraph включен стандартный модуль Голосование
(votesimple). Данный модуль создает форму с вариантами
ответа, подсчитывает число проголосовавших по каждому и сохраняет IP-адреса (или COOKIE) посетителей, принявших участие в данном
голосовании (рис. 1).

|
Рис. 1. Пример оформления голосования на сайте
|
Для создания нового
голосования на сайте нужно ввести объект с темой голосования в заголовке и
установить в нем параметр "обработчик" - votesimple и дополнительные параметры из группы
"ГОЛОСОВАНИЕ".
Для задания вариантов
ответов к объекту, которое является голосованием, добавляются дочерние с
вариантами ответов в заголовках. После каждого голосования в этих объектах автоматически
создаются и изменяются параметры с количеством проголосовавших и IP-адресами (или COOKIE) посетителей. Модуль не позволяет принять участие
в голосовании более одного раза посетителям с одного IP-адреса.
Оформление внешнего
вида таблицы с результатами и гистограммы заключено в стандартном XSL-стиле "голосование" из
библиотеки, который, при желании, можно модифицировать или заменить на другой.

|
Рис. 2. Пример голосования в отдельном окне
|
Модуль может работать
и в отдельном окне (рис. 2). Для этого необходимо в объекте с голосованием
добавить параметры из группы "ОКНО", задать высоту, ширину, тип окна
и установить параметр "шаблон сообщения" - пустой или аналогичный.
| 4.4. Поиск по сайтуВ состав системы TreeGraph входит общих модуль Поиск (search), позволяющий организовать различные вида поиска по
страницам сайта. В модуле возможна настройка поиска по отдельным разделам сайта
(с выбором этих разделов и без), по объектам определенного типа, с учетом
атрибутов и параметров (например, по дате публикации) и др.
| 4.5. Карта сайтаВ состав общих модулей системы TreeGraph входит генератор карты
сайта (sitemap). Данный модуль создает структурированный перечень требуемых
подразделов и страниц сайта и оформляет его в виде многоуровневых вложенных
списков (рис. 1) или раскрывающегося дерева (рис. 2).
В объекте "Карта сайта" должен быть установлен параметр
"обработчик" - sitemap. Для настройки карты в данный объект можно
добавить параметр "настройки менеджера". Данный параметр
представляет собой текстовое поле, каждая строка которого задает одну опцию и
имеет следующий синтаксис:
ОПЦИЯ1=ЗНАЧЕНИЕ1
ОПЦИЯ2=ЗНАЧЕНИЕ2
Возможны следующие опции и их значения:
Опция
|
Умолчние
|
Описание
|
style=show_list / show_tree
|
show_list
|
Задает стиль карты в виде многоуровневых списков или раскрывающегося дерева.
|
rootid=ЧИСЛО
|
1
|
Задает идентификатор начала карты сайта. Если параметр не задан, то карта
отображает все дерево сайта.
|
rootid=SQL
|
нет
|
Задает SQL-выражение для указания нескольких корней карты сайта
(Альтернатива предыдущей).
|
filter=SQL
|
нет
|
Задает SQL-выражение для указания фильтра объектов, показываемых в карте
сайта. Т.е. все объекты которые можно увидеть в карте сайта должны
удовлетворять заданному условию.
|
open=СПИСОК
|
нет
|
Задает список раскрытых объектов в карте сайта (для стиля show_tree).
|
maxlev=ЧИСЛО
|
4
|
Задает максимально число уровней в карте сайта
|
text=0/1
|
0
|
Задает текстовый режим работы карты сайта (для стиля
show_tree).
|
max_childs=ЧИСЛО
|
50
|
Задает максимальное число дочерних на одной странице при просмотре ветви
карты сайта (для стиля show_tree).
|
addfields[]=СТРОКА1
addfields[]=СТРОКА2
|
нет
|
Задает список дополнительных параметров для показа в карте сайта. (для
стиля show_tree). (См. Настройки
JM).
|
В группе "КАРТА САЙТА" есть дополнительные параметры,
позволяющих исключить некоторые подразделы или отдельные страницы из карты.
Параметр "не включать раздел в карту", установленный в каком-либо
объекте, полностью отменяет включение данной ветви в карту. Параметр "не
включать дочерние в карту" отменяет только включение дочерних объектов в
карту. Параметр "не делать ссылку на карте" включает данный объект в
карту, но без ссылки на него.
Карта сайта может функционировать и как дополнительная панель
навигации в отдельном окне (рис. 3).
Для этого необходимо в объекте "Карта сайта" добавить
параметры из группы "ОКНО" и задать высоту, ширину и тип окна -
"в новом фиксированном окне (resize)". Дополнительно можно установить
параметры "стиль сообщения" - контент и "шаблон сообщения"
- пустой из общей библиотеки шаблонов, или аналогичные собственные.
В этом случае, все ссылки на подразделы и страницы с карты сайта
будут изменять адрес и содержимое основного окна сайта.
На сайтах со сложной структурой (например, многоязычных) может
быть несколько объектов с данным обработчиком, создающими карты отдельных
подразделов (например, для каждой языковой версии сайта).
| 4.6. Печатная версия сайтаВ состав общих модулей системы TreeGraph включена функция,
позволяющая организовать полноценную работу сайта в режиме, максимально
приспособленном для печати на принтере. Данная функция использует XSL-шаблон с
именем print из библиотеки шаблонов.
Администратор может применить на сайте шаблон печатной версии из
общей библиотеки или создать свой собственный с таким же именем print, указав в
нем требуемый набор позиций для вывода информации. Общий шаблон print выводит
заголовок сайта, заголовок и содержимое текущей страницы, стандартный список
дочерних объектов, главное меню и переключатель на обычную версию сайта (рис.
2).
В качестве "переключателя" версий может служить любой
объект сайта, в котором установлен параметр "функция" со значением
func_setprint. На сайте можно создать отдельные блоки и стили с минимумом
графики специально для печатной версии.
| 4.7. Регистрация и подпискаВ системе TreeGraph, кроме административной регистрации (с
помощью модуля Пользователи), предусмотрена возможность on-line регистрации пользователей на сайте и оформления подписки на новости. Для
этой цели служит общий модуль Регистрация (register).
| 4.8. КалькуляторМодуль Калькулятор
позволяет рассчитать характеристики (цена, сроки, количество и т.д.) любой
сложной модели, состоящей из нескольких компонентов.
| 4.9. Каталог и корзина заказовМодуль каталог-корзина
заказов позволяет организовать на сайте специальный раздел произвольной
структуры с описанием категорий, подкатегорий, товаров (услуг) и т.п. Модуль
реализует управление корзиной заказов посетителей сайта - складирование,
удаление, автоматический расчет стоимости, пересчет валют, оформление заказа
выбранных товаров.
| 4.10. Экспорт в форматах RSS и XMLМодуль RSS предназначен для генерации RSS-файла (XML) с заданными
объектами сайта.
| 5. Приложения
| 5.1. Глоссарий
База данных сайта. SQL-база, состоящая из нескольких связанных таблиц с записями, в которых
хранится вся информация сайта. База включает в себя таблицы данных (объектов), типов данных,
пользователей, групп, статистической информации и др.
Дерево сайта. Таблица объектов в базе данных сайта, организованная в виде связанного
однонаправленного графа с одной корневой
вершиной. Вершинами дерева являются информационные и служебные объекты сайта, а ребрами (дугами) - связи между ними.
Объект (сообщение). Любая вершина (узел) в дереве сайта. Ей
соответствует одна запись в таблице объектов базы данных сайта. Объект может
представлять собой какую-либо информацию (раздел/страницу сайта) или служебную
запись. Каждый объект имеет уникальный номер (идентификатор), определенный уровень
в дереве сайта и набор прямых связей (общих ребер) с другими объектами.
Объект состоит из фиксированного набора основных полей (атрибутов),
возможных дополнительных полей (параметров)
и внешних файлов.
Идентификатор
объекта. Уникальный номер
(id), соответствующий объекту
в дереве сайта. Идентификатор корневого объекта равен 1. Доступ к любому
объекту на сайте можно получить (если есть права на просмотр) с помощью строки:
http://адрес_сайта/?id=XXXX или http:/адрес_сайта/XXXX
где XXXX - идентификатор объекта.
Строка http://адрес_сайта/ или с несуществующим идентификатором
равносильна строке: http://адрес_сайта/?id=1
Ребро (дуга). Прямая связь между двумя объектами. В
дереве сайта прямую связь имеют только "родственные" объекты - родительские и дочерние.
Уровень. Число связей (количество ребер в дереве сайта), соединяющее
данный объект с корневым. Для
корневого объекта уровень равен нулю.
Маршрут. Набор связей (ребер), соединяющих два
объекта на сайте. Для каждой пары объектов всегда имеется один и только один
маршрут. Прим. Жесткая иерархическая
структура сайта может быть расширена с помощью дополнительных взаимосвязей,
определяемых параметрами объектов.
Родитель. Объект, имеющее прямую связь с данным
(общее ребро в дереве сайта) и уровень
на единицу меньший, чем у данного. Любой объект на сайте, кроме корневого,
имеет одного и только одного родителя.
Корень (корневой
объект). Единственный
объект (вершина) в дереве сайта, которое не имеет родителя (уровень равен нулю). Идентификатор
корневого объекта равен 1. От корня "строится" все дерево сайта.
Дочерний объект. Объект, имеющее прямую связь с данным
(общее ребро в дереве сайта) и уровень
на единицу больший, чем у данного. Любой объект на сайте может иметь любое
количество дочерних объектов.
Потомки. Все объекты в дереве сайта с уровнем
большим, чем у данного и у которых маршрут
к корню проходит через данный объект.
Ветвь (поддерево). Какой-либо объект в дереве сайта и все
его потомки.
Братья. Все объекты, имеющие одного и того же родителя. Все объекты-братья имеют
одинаковый уровень и располагаются в
дереве сайта соответственно их приоритетам.
Приоритет. Внутренний числовой код объекта, задающий
его позицию в дереве сайта среди своих братьев.

Рис. 1.
|
На рис. 1.
изображен пример дерева сайта. Пронумерованные прямоугольники - это вершины дерева или объекты, а линии, связывающие их - ребра (дуги).
Прямоугольник 1 - корень дерева или корневой объект сайта.
Объекты 2, 3 и 4 являются братьями и дочерними
для объекта 1.
Объект 2 является родительским
для объектов 5 и 6.
Объекты 5, 6 и 8 - потомки
объекта 2.
Объекты 2, 5, 6 и 8 представляют собой ветвь дерева с вершиной 2. Уровень для объекта 1 равен
0; для объектов 2, 3 и 4 - равен 1; для объектов 5,
6 и 7 - равен 2; для объекта 8 - равен 3. Маршрут от объекта 8 до
корня представляет собой последовательность ребер 8-6-2-1.
Среди братьев 2, 3 и 4 объект 2 имеет
максимальный приоритет, а объект 4
-минимальный.
|
Атрибуты. Основные поля каждой записи в таблице
объектов. Часть атрибутов вводится администратором при добавлении
(редактировании) объекта, остальные заполняются и изменяются автоматически.
Имена переменных любых атрибутов
можно использовать для формирования различных SQL-выборок. Назначение атрибутов будет описано ниже.
Параметры. Дополнительные поля записи в таблице
объектов. Параметры имеют определенный тип данных (текст, число, дата, да/нет,
перечисление, графика, файл и пр.) и могут добавляться к любому объекту сайта.
Некоторые параметры могут использоваться
в качестве классификаторов для задания значений других параметров. Все
параметры объекта хранятся в "свернутом" виде в поле params. Отдельные параметры (те, у которых
отмечен признак "отдельное поле") хранятся так же, как и атрибуты
объекта, т.е. в отдельных полях каждой записи в таблице объектов. Имена таких
параметров можно использовать для формирования различных SQL-выборок, так же как и атрибутов.
Назначение отдельных параметров будет описано ниже.
Внешние файлы
объекта. Дополнительные
файлы, соответствующие данному объекту (графика в различных форматах, архивы,
документы и пр.). Количество их в одном объекте не ограничено. Добавить
внешний файл к объекту можно несколькими способами:
Установкой и вводом параметров типа "графика" или
"файл"
Указанием ссылки на локальный файл в основном тексте объекта
Вставкой в конвертируемый документ (MS Word, MS Excel, RTF)
графических иллюстрации.
Образцы. Специальные объекты-прототипы, в которых
установлен определенный набор параметров (и их значения по умолчанию), необходимый
для ввода новых объектов в ветви сайта. Образцы создаются и устанавливаются
администраторами сайта.
Классификаторы. Специальные объекты, заголовки и
идентификаторы которых используются в качестве значений других параметров объектов.
Например: тематики, рубрики, приоритеты и т.п.
Пользователь. Любой посетитель сайта может быть анонимным
или зарегистрированным пользователем. Если пользователь зарегистрирован на
сайте (т.е. его профиль занесен в базу данных), то после ввода им логина и
пароля на какой-либо странице сайта, он становится авторизованным посетителем в
данной сессии броузера. Каждый зарегистрированный пользователь может входить в
одну или несколько групп пользователей (это
задают администраторы сайта). Права
пользователя на определенные действия (просмотр страниц, редактирование объектов
и др.) определяются его принадлежностью к группам
и правами, установленными в объектах.
Группа пользователей. Набор (группа) пользователей, зарегистрированных на сайте, имеющих одинаковые права на какие-либо действия (подписка,
просмотр, редактирование, добавление) в определенных разделах сайта.
Группа on-line. Группа, в которую автоматически включается
пользователь, зарегистрировавшийся на сайте в режиме on-line. Как правило,
данная группа используется для организации подписки и автоматической рассылки
новостей сайта. Сменить группу или включить пользователя в другие группы могут
только администраторы сайта.
Владелец. Зарегистрированный пользователь, который ввел
данной объект в дерево сайта. Сменить владельца могут только администраторы сайта. Если объект введен
на сайт неавторизованным пользователем (например, с помощью интерактивной
формы), то владельцем его становится администратор сайта.
Права. Атрибуты
объекта, которые разрешают или запрещают отдельные операции над данным
объектом. К таким операциям относятся: чтение (r - просмотр страницы объекта на сайте), изменение
(w - редактирование и
удаление объекта с помощью модуля JM), добавление (x - ввод объектов, дочерних к данному, с помощью JM или интерактивных форм). Права (rwx) устанавливаются отдельно для группы и для
остальных пользователей. Под остальными пользователями подразумеваются
зарегистрированные и авторизованные посетители, не входящие в группу, которой
принадлежит данный объект, а также все неавторизованные посетители сайта (т.е. анонимные
пользователи).
Пример. В объекте
установлены следующие атрибуты:
владелец: Русаков Олег
группа: Дилеры
права
(rwx rwx): 101 100
В этом случае, на
данной объект устанавливаются следующие права:
Администраторы и
пользователь Русаков - полные права;
Дилеры (пользователи,
входящие в группу Дилеры) - права на просмотр и добавление новых объектов к
данному (r=1, w=0, x=1);
остальные - только
права на просмотр (r=1, w=0, x=0).
Примечание. Для того,
чтобы изменить объект или добавить к нему новое с помощью модуля JM, пользователь, кроме прав на данный
объект, должен еще иметь права на чтение самого модуля JM.
Библиотека
шаблонов. Файл,
содержащий набор шаблонов и стилей всех страниц сайта и отдельных блоков страниц.
Шаблон. Код, описывающий структуру всей страницы
сайта. Шаблон представляет собой XML/XSL-код с указанием позиций для вставки отдельных блоков. Сайт может иметь несколько
шаблонов для вывода отдельных страниц и ветвей.
Позиция. Место в шаблоне для вставки отдельных блоков.
Для разных шаблонов могут быть созданы различные наборы позиций.
Блок. Логическое структура, представляющая
собой один или несколько объектов сайта, скомпонованных с помощью заданного стиля в HTML-код, который выводятся в указанной позиции шаблона. Для блока задаются
условия выборки объектов, условия показа блока на определенных страницах
(разделах) сайта, количественные ограничения, порядок показа объектов в блоке и
различные дополнительные параметры. Для организации блока создается специальной
объект с требуемыми параметрами.
Стиль. Код, описывающий внешний вид блока (на
странице сайта) и логику его формирования. Стиль представляет собой XML/XSL-код с указанием выводимых атрибутов и параметров объекта. Результат
применения стиля к блоку представляет собой сформированный HTML-код, который выводится в указанную позицию шаблона.
Список. Код, описывающий внешний вид одного
объекта блока и логику его формирования. Самостоятельного значения списки не
имеют, а используются как вспомогательные подстили для некоторых стилей (с
управляемым списком)
Модуль
(обработчик). Программный
код, обеспечивающий необходимую функциональность какому-либо объекту (странице
или разделу) сайта. Все обработчики разбиты на несколько групп: главный модуль
проекта, общие административные модули, общие дополнительные модули и
специфические модули проекта.
| 5.2. Атрибуты объектов
название
|
переменная
|
тип
|
описание
|
идентификатор
|
id
|
number
|
Уникальный
числовой идентификатор объекта. Создается автоматически при вводе (создании)
объекта.
|
идентификатор
родителя
|
parent_id
|
number
|
Идентификатор
родительского объекта. Устанавливается автоматически при вводе и перемещении
объекта.
|
день
публикации
|
p_date
|
text
|
День публикации
объекта, указанный администратором при вводе или редактировании. Формат
ввода: ДД.ММ.ГГГГ
|
время
публикации
|
p_time
|
text
|
Время
публикации объекта, указанное администратором при вводе или редактировании. Формат
ввода: ЧЧ:ММ
|
заголовок
|
mess_header
|
text
|
Заголовок
объекта. Вводится администратором сайта или генерируется автоматически (для
интерактивных форм). Обязательный атрибут объекта.
|
аннотация
|
mess_short
|
textarea
|
Аннотация
объекта. Вводится администратором сайта. Используется в стилях при
формировании различных списков объектов (блоков).
|
текст
|
mess_content
|
textarea
|
Основной текст
объекта. Вводится администратором или формируется конвертором.
|
дата
публикации
|
publish_date
|
date
|
Дата и время публикации объекта в формате DATE.
Формируется автоматически из значений введенных полей p_date и p_time.
|
дата
ввода
|
enter_date
|
date
|
Дата и время ввода объекта. Устанавливается автоматически
при вводе (создании) объекта (серверное время).
|
дата
модификации
|
modify_date
|
date
|
Дата и время последнего изменения объекта. Устанавливается
и изменяется автоматически при любых операциях с объектом (серверное время).
|
родители
|
parents
|
text
|
Список идентификаторов родительских объектов через запятую
(маршрут от корня сайта до объекта).
|
приоритет
|
priority
|
number
|
Внутренний числовой код объекта, задающий его позицию в
дереве сайта среди своих братьев.
|
приоритет
в дереве
|
tree_order
|
text
|
Суммарный приоритет объекта, определяющий его позицию в
дереве сайта.
|
счетчик
|
counter
|
number
|
Число просмотров страницы объекта на сайте (в настоящий
момент не используется).
|
число
дочерних
|
cnt
|
number
|
Общее количество дочерних объектов у данного. Изменяется
автоматически при любых операциях с объектом и его дочерними.
|
владелец
|
user_id
|
number
|
Идентификатор пользователя - владельца объекта. При
удалении пользователя устанавливается в 1 (root).
|
группа
|
group_id
|
number
|
Идентификатор группы пользователей, которой принадлежит
данный объект. При удалении группы устанавливается в 1 (root).
|
права
группы на чтение
|
rg
|
number
|
Права для пользователей установленной группы group_id на чтение данного
объекта (0/1).
|
права
группы на изменение (удаление)
|
wg
|
number
|
Права для пользователей установленной группы group_id на изменение
(удаление) данного объекта (0/1).
|
права
группы на добавление
|
xg
|
number
|
Права для пользователей установленной группы group_id на добавление к
данному объекту новых дочерних объектов (0/1).
|
права
остальных на чтение
|
ro
|
number
|
Права для остальных пользователей на чтение данного объекта
(0/1).
|
права
остальных на изменение (удаление)
|
wo
|
number
|
Права для остальных пользователей на изменение (удаление) данного
объекта (0/1).
|
права
остальных на добавление
|
xo
|
number
|
Права для остальных пользователей на добавление к данному
объекту новых дочерних объектов (0/1).
|
IP адрес
|
ip
|
text
|
IP-адрес, с которого был введен объект. Устанавливается
автоматически при вводе.
|
хост
|
host
|
text
|
Хост, с которого был введен объект. Устанавливается
автоматически при вводе объекта.
|
параметры
|
params
|
text
|
Дополнительные параметры объекта, "свернутые" в
виде текстовой строки (описаны в Приложении Параметры объектов).
|
| 5.3. Типовые параметры объектов
группа / параметр
|
переменная
|
тип
|
назначение
|
ОБЩИЕ
|
site
|
|
параметры общего назначения
|
e-mail общий
|
site_email_admin
|
text
|
E-mail администратора сайта. На этот адрес отправляются сообщения о регистрации пользователей и об изменении их параметров (если не задан e-mail разработчиков). Также этот адрес показывается на сайте в качестве контактного, если это предусмотрено дизайном.
|
e-mail подраздела
|
site_email_local
|
text
|
E-mail администратора раздела. На этот адрес отправляются копии форм, заполненных посетителями. Можно указывать несколько адресов через запятую. Если параметр не установлен, то копии пересылаются на e-mail администратора сайта. Данный адрес не показывается на сайте.
|
e-mail post-мастера
|
site_email_post
|
text
|
Задает поле Return Path при генерации писем с сайта. Параметр должен содержать только (!) один адрес. Этот адрес должен в обязательном порядке быть рабочим и регулярно проверяться. На этот адрес высылаются оповещения почтовых служб о невозможности доставки писем подписчикам и администраторам разделов форумов, отзывов, заказов.
|
язык подраздела
|
site_lang
|
select
|
Задает язык интерфейса административных модулей и оформление страниц сайта (если это предусмотрено при разработке). По умолчанию - (ru) русский.
|
имя сайта
|
site_name
|
text
|
Краткое название сайта. Используется при формировании title страницы и при почтовой рассылке.
|
заголовок броузера
|
site_title
|
text
|
|
описание сайта
|
site_description
|
textarea
|
Краткое описание сайта или раздела для поисковых машин (META description). Обратите внимание на комментарии по SEO оптимизации.
|
ключевые слова
|
site_keywords
|
textarea
|
Набор ключевых слов сайта или раздела для поисковых машин (META keywords).
|
адрес
|
site_address
|
textarea
|
|
телефоны
|
site_phone
|
text
|
|
copyright сайта
|
site_copyright
|
text
|
Строка для шаблона с авторскими правами на информацию сайта.
|
дизайн сайта
|
site_design
|
text
|
Строка для шаблона авторскими правами на дизайн сайта.
|
тексты
|
site_txt
|
textarea
|
Позволяет создать произвольные текстовые константы или переопределить стандартные тексты в стилях и названия параметров в интерактивных формах. Формат:
ключ1=значение1
ключ2=значение2
где ключ - идентификатор текстовой строки или имя параметра. Подробнее здесь.
|
URL сайта
|
site_url
|
text
|
Адрес сайта в формате: http://www.xxx.yyy/
Используется при почтовой рассылке и в служебных целях.
|
домашняя страница
|
site_home_page
|
text
|
Задает синоним для адреса данного объекта в виде http://www.xxx.yyy/text
Установленные значения данного параметра должны быть уникальны для всех объектов сайта. Может иметь сложный вид, например news/first/index.html. Используется для отдачи данных при обращении к адресам вида /robots.txt и т.д. Если параметр установлен, то при обращении по старому адресу страницы (вида http://www.xxx.yyy/?id=12345) автоматически создается 301 редирект на новый адрес. Внимание! С осторожностью изменяйте значение данного параметра для уже существующих страниц. После такой операции без специальных действий страница станет недоступна по старому адресу, это может привести к временному исключению ее из индекса поисковиков и даже временной потери сайтом своих позиций в выдаче.
|
перенаправить
|
redirect
|
text
|
При показе данного объекта броузер автоматически перенаправляется на указанный адрес или другой объект на этом сайте. Формат:
http://www.xxx.yyy
##идентификатор##
|
ссылка
|
url
|
text
|
Данный параметр используется отдельными стилями для формирования ссылки при показе данного объекта. Формат:
http://www.xxx.yyy
##идентификатор##
|
onclick
|
onclick
|
text
|
Используется аналогично параметру "ссылка". Формируется "onclick=" в теге "a"
|
обработчик
|
handler
|
select
|
Программный код для обработки данного объекта при его показе.
|
onload
|
site_onload
|
text
|
|
подключить JS файлы
|
site_js_files
|
checks
|
Позволяет системе автоматически подключать на странице только нужные JS файлы, в зависимости от присутствия на странице различных компонент (блоков), избегать повторного подключения скриптов, управлять порядком их подключения.
В свойствах данного параметра, в формате «путь=значение» перечислены пути js файлов, которые нужно использовать на проекте. Например:
/comm/js/jquery/jquery.js=jquery.js
/comm/js/jquery/jquery.tg.js=jquery.tg.js
/comm/js/jquery/jquery.autocomplete.js=jquery.autocomplete.js
/comm/js/jquery/jquery.cookie.js=jquery.cookie.js
В разделах сайта, блоках, которые требуют подключения определенных скриптов, устанавливается данный параметр, отмечаются скрипты требуемые для конкретного раздела или блока. При формировании страницы система анализирует какие файлы нужно подключить и подключает их в правильном порядке (порядок подключения соответствует порядку перечисления файлов в свойствах параметра). Данная система позволяет исключить повторное подключение js файлов, подключение не нужных файлов на странице, подключение файлов в неправильном порядке. Порядок добавления своих js файлов:
1) в служебном разделе (например там где у вас находится robots.txt и favicon.icо создайте объект, загрузите в него ваш js используя параметр site_js_file
2) скопируйте прямой путь файла, которой получился, например /_data/objects/0000/0450/site_js_file.js
3) откройте на редактирование параметр и добавьте ваш файл в формате путь=название. Выберите правильное место, файлы подключаются в порядке перечисления.
4) установите параметр «подключить JS файлы» в нужном блоке/разделе. Вы увидите ваш файл среди возможных опций для подключения.
|
дополнительные META-тэги
|
site_meta
|
textarea
|
Позволяет создать любое количество любых мета-тегов. Например для подтверждения владения сайтом в сервисе Яндекс Вебмастер, сервисах Google и т.д.
Формат:
name[индекс]=значение
content[индекс]=значение
Пример:
name[0]=robots
content[0]=index,follow
name[1]=yandex-verification
content[1]=85d0f992cf484c6
На сайте создаюся два мета тега: robots и yandex-verification.
Количество записей не ограничено.
|
пользовательский JS файл
|
site_js_file
|
file
|
|
ШАБЛОНЫ И СТИЛИ
|
template
|
|
шаблоны и стили страниц и блоков
|
шаблон ветви
|
view_page
|
select
|
Задает шаблон всех страниц сайта или данной ветви. Значения для списка генерируются автоматически после загрузки библиотеки шаблонов.
|
шаблон сообщения
|
view_page_alt
|
select
|
Задает шаблон данной страницы сайта. Значения для списка генерируются автоматически после загрузки библиотеки шаблонов.
|
стиль ветви
|
view_block
|
select
|
Задает стиль данной ветви сайта или блока. Значения для списка генерируются автоматически после загрузки библиотеки шаблонов.
|
стиль сообщения
|
view_block_alt
|
select
|
Задает стиль данной страницы сайта. Значения для списка генерируются автоматически после загрузки библиотеки шаблонов.
|
список ветви
|
view_list
|
select
|
Задает вид списка дочерних для данной ветви сайта или блока. Значения для списка генерируются автоматически после загрузки библиотеки шаблонов. Используется совместно со стилями, отмеченными как "управляемый список"
|
список сообщения
|
view_list_alt
|
select
|
Задает вид списка дочерних для данной страницы сайта. Значения для списка генерируются автоматически после загрузки библиотеки шаблонов. Используется совместно со стилями, отмеченными как "управляемый список"
|
ПРОСМОТР
|
view
|
|
просмотр страниц и блоков
|
внешний файл
|
view_file
|
file
|
При показе данного объекта броузер перенаправляется на указанный файл (контент объекта должен быть пустой).
|
имя внешнего файла
|
view_file_name
|
text
|
Имя, под которым внешний файл, заданный параметром view_file, будет скачиваться с сайта.
|
получение братьев
|
view_get_brothers
|
select
|
Задает способ получения братьев для данного объекта и ветви (по умолчанию - нет).
|
получение братьев (сообщение)
|
view_get_br_alt
|
select
|
Задает способ получения братьев только для данного объекта (по умолчанию - нет).
|
получение дочерних
|
view_get_childs
|
select
|
Задает способ получения дочерних для данного объекта и ветви (по умолчанию - список).
|
получение дочерних (сообщение)
|
view_get_childs_alt
|
select
|
Задает способ получения дочерних только для данного объекта (по умолчанию - список).
|
сообщений на странице
|
view_max_childs
|
number
|
Максимальное число выводимых дочерних объектов на странице. Если не задан, то выводятся все объекты.
|
число страниц в списке
|
view_max_pages
|
number
|
Задает максимальное число страниц для многостраничных списков.
|
число колонок
|
view_cols
|
number
|
Число колонок для некоторых стилей (фотогалерея и др.).
|
не вкл. в меню
|
view_menu_item_no
|
check
|
Отменяет включение данного объекта в меню (используется в стилях некоторых меню).
|
не вкл. дочерние в меню
|
view_menu_child_no
|
check
|
Отменяет включение дочерних объектов в многоуровневые меню (используется в стилях некоторых меню).
|
не делать ссылку
|
view_nolink
|
check
|
Отменяет создание ссылки на объект в списке (для некоторых стилей).
|
обрабатывать ссылку
|
view_link_url
|
check
|
Устанавливает замену в списке ссылок на объекты на значения параметра "ссылка" этих объектов (для некоторых стилей).
|
заголовок раздела
|
view_title
|
text
|
Текстовый заголовок раздела сайта.
|
заголовок меню
|
view_title_menu
|
text
|
Заголовок пункта меню (используется в стилях некоторых меню).
|
показ параметров
|
view_params
|
checks
|
Управляет показом отдельных параметров в некоторых видах списков (например, "стандарт с иконкой управляемый")
|
настройки отображения
|
view_conf
|
textarea
|
|
ссылка на видео
|
view_video
|
text
|
|
добавить rel nofollow
|
view_nofollow
|
check
|
|
ОФОРМЛЕНИЕ
|
css
|
|
CSS оформление элементов стилей
|
css файл
|
site_css_file
|
file
|
CSS-файл с каскадными стилями сайта.
|
класс блока
|
view_class_block
|
text
|
Основной параметр, используемый при верстке. Каждый создаваемый в системе блок будет отображен на странице как div. Данный параметр задает CSS класс для этого div.
|
класс ссылки
|
view_class_link
|
text
|
Название css-класса для формирования основной ссылки в списке некоторыми стилями.
|
класс списка
|
view_class_cell
|
text
|
Название css-класса для контейнера с дочерними. Обрабатывается стилем «стандарт [управляемый список]»
|
класс концовки
|
view_class_tail
|
text
|
Название css-класса для контейнера концовки
|
класс заголовка
|
view_class_header
|
text
|
Название css-класса для контейнера заголовка
|
класс даты
|
view_class_date
|
text
|
Название css-класса для даты
|
класс архива
|
view_class_arch
|
text
|
Название css-класса для контейнера постраничной навигации
|
класс аннотации
|
view_class_short
|
text
|
Название css-класса для аннотации
|
класс body
|
view_class_body
|
text
|
Класс, который будет добавлен к body на странице (и в разделе), где данный параметр задан. Используется для задания специального оформления для отдельных разделов или страниц при верстке сайта.
|
cellspacing таблицы
|
view_table_spacing
|
text
|
Атрибут cellspacing для формирования таблиц некоторыми стилями. .
|
css таблицы
|
view_table_style
|
text
|
Атрибут style для формирования таблиц некоторыми стилями.
|
css ячейки
|
view_td_style
|
text
|
Атрибут style для формирования ячеек таблиц некоторыми стилями.
|
css первой ячейки
|
view_td1_style
|
text
|
Атрибут style для формирования первой ячейки таблицы (верхней - для вертикальной таблицы, или левой - для горизонтальной). Если не установлен - используется параметр view_td_style.
|
css последней ячейки
|
view_td2_style
|
text
|
Атрибут style для формирования последней ячейки таблицы (нижней - для вертикальной таблицы, или правой - для горизонтальной). Если не установлен - используется параметр view_td_style.
|
css ячейки маркера
|
view_td_list_style
|
text
|
Атрибут style для формирования ячейки таблицы с маркером для списоков "заголовок и марке"
|
css графики
|
icon_style
|
text
|
Атрибут style для основного графического изображения объекта.
|
css иконки
|
view_icon_style
|
text
|
Атрибут style для основного иконки объекта (view_icon_photo).
|
css формы
|
form_table_style
|
text
|
Атрибут style для таблиц с интерактивными формами.
|
css элементов форм
|
form_festyle_css
|
text
|
Атрибут style для полей интерактивных форм (типа input).
|
css кнопок
|
form_submit_css
|
text
|
Атрибут style для "кнопок" интерактивных форм.
|
css блока
|
block_css
|
text
|
Атрибут style для всего блока (заголовок, контент, список, концовка).
|
css заголовка
|
block_header_css
|
text
|
Атрибут style для заголовка блока (страницы).
|
css контента
|
block_mess_css
|
text
|
Атрибут style для контента блока (страницы).
|
css списка
|
block_cell_css
|
text
|
Атрибут style для списка дочерних блока (страницы).
|
css архива
|
block_arch_css
|
text
|
Атрибут style для постраничной разбивки списка блока (страницы).
|
css концовки
|
block_tail_css
|
text
|
Атрибут style для концовки блока (страницы).
|
css элемента
|
view_elem_css
|
text
|
|
css страницы
|
view_body_css
|
text
|
|
css id блока
|
block_css_id
|
text
|
|
max ширина графики
|
view_max_icon
|
number
|
Максимальная ширина (в пикселях) основной графики (параметр icon) при показе объектов.
|
max ширина иконки
|
view_max_icon_list
|
number
|
Максимальная ширина иконки (параметр view_icon_photo) при показе списка объектов.
|
max высота иконки
|
view_max_icony_list
|
number
|
Максимальная высота иконки (параметр view_icon_photo) при показе списка объектов.
|
ширина шаблона
|
view_template_width
|
text
|
Задает общую ширину (в пикселях или процентах) шаблона страницы.
|
css файлы
|
site_css_files
|
cheks
|
Позволяет управлять подключаемыми на странице CSS файлами в зависимости от раздела и наличии определенных блоках на странице. Полностью аналогичен параметру «подключить JS файлы» (site_js_files). См. описание site_js_files в данном документе.
|
БЛОК
|
block/blockadd
|
|
управляющие блоки
|
это оверкит?
|
overkit_is
|
check
|
|
это блок?
|
block_is
|
check
|
Устанавливает признак для данного объекта, что оно является блоком. Обязательно (если не задан фиксированный блок) требует наличия в объекте параметров: условие выбора, условие показа, сортировка, сколько, позиция, стиль ветви. Блок – основной строительный элемент сайта. Это правило, которое указывает что какие-то элементы сайта (условие выбора, сколько, сортировка) нужно показать на каких-то страницах (условие показа), в каком-то месте шаблона (позиция), с помощью какого-то стиля шаблонизатора (стиль ветви, [+ список ветви]).
Например, нужно показать два случайных баннера из папки id 300 в левой колонке на всех новостях типа «новость сайта».
Создаем блок:
это блок: 1
позиция: левая колонка
условие выбора: parent_id=300
сколько: 2
сортировка: случайная
условие показа: art_is=1 and art_type=”новость сайта”
стиль ветви: стандарт
список ветви: иконка/графика/флеш/контент
|
фиксированный блок?
|
block_fix
|
check
|
Указывает, что данный блок не требуется формировать динамически из данных сайта. Если установлен в блоке, то в таком блоке не нужны параметры: условие выбора, сортировка, сколько (а также не обязательные: общее количество, список ветви, получение дочерних).
Подходит для статических элементов: показа номеров телефона в шапке сайта, вставки кодов счетчиков и т.д. Все данные фиксированного (статического) блока указываются в контенте этого блока. Также разумно применять к таким блокам параметр «css класс» если нужно определить оформление.
|
позиция
|
block_pos
|
select
|
Задает позицию данного блока в шаблоне. Значения для списка генерируются автоматически после загрузки библиотеки шаблонов.
|
сортировка
|
block_order
|
select
|
Задает порядок показа объектов при выводе блока.
|
сколько (start,limit)
|
block_limit
|
text
|
Если указано одно число, то оно задает максимальное количество объектов в блоке. Если указано два числа, первое задает начальный объект, второе - максимальное количество объектов в блоке.
|
общее количество?
|
block_countall
|
check
|
Устанавливает признак для подсчета общего количества объектов, удовлетворяющих условию выбора. Используется для организации постраничной разбивки списка выбранных (дочерних).
|
условие выбора
|
block_where
|
text
|
SQL-условие для выбора объектов в данный блок (см. примеры). Данный параметр можно установить в блоке или на любой странице сайта. Во втором случае на странице вместо вложенных разделов покажутся разделы, соответствующие заданному условию. Проверять условия можно с помощью инструмента «фильтр» в JManager. Всегда задается вместе с параметрами «сортировка», «сколько».
|
условие показа
|
block_check
|
text
|
SQL-условие для показа данного блока на сайте. (см. примеры).
|
заголовок
|
block_header
|
text
|
Текст для заголовка блока. Выводится перед списком объектов блока после графического заголовка.
|
заголовок графический
|
block_header_image
|
image
|
Графика для заголовка блока. Выводится перед списком объектов.
|
ссылка заголовка
|
block_header_link
|
text
|
Ссылка для заголовка блока.
|
концовка
|
block_tail
|
text
|
Текст для концовки блока. Выводится после списка.
|
концовка графическая
|
block_tail_image
|
image
|
Графика для концовки блока. Выводится под текстовой концовкой, после списка.
|
ссылка концовки
|
block_tail_link
|
text
|
Ссылка для концовки блока.
|
функция выбора
|
block_where_func
|
select
|
Программный код, заменяющий условие выбора объектов в блок.
|
функция показа
|
block_check_func
|
select
|
Программный код, заменяющий условие показа блока на странице сайта.
|
функция дополнительная
|
block_add_func
|
select
|
Программный код, вызывающийся после формирования блока.
|
интервал кэширования
|
block_cache
|
select
|
Задает временной интервал кэширования блока в секундах.
|
дополнение выбора
|
block_what
|
text
|
Задает дополнение WHAT в SQL-операторе SELECT при формировании выборки блока. Например:
mess_short as mess_header - заменит заголовок на аннотацию.
|
группировка выбора
|
block_group
|
text
|
|
таблица выбора
|
block_table
|
select
|
Задает имя таблицы для условия выбора
|
подгружаемый блок
|
block_ajax
|
checkbox
|
Докачивает блок через ajax после отображения страницы в браузере.
|
путь для подгрузки блока
|
block_ajax_path
|
checkbox
|
Указывает использовать site_home_page как путь считывания блока, используется при соседстве сайта с другим движком.
|
МЕНЮ
|
menu
|
|
параметры для различных меню
|
смещение меню
|
block_menuonoff_add
|
text
|
Дополнительное смещение графического меню.
|
x меню с подсветкой
|
block_menuonoff_x
|
text
|
Позиция по горизонтали для выпадающего графического меню.
|
y меню с подсветкой
|
block_menuonoff_y
|
text
|
Позиция по вертикали для выпадающего графического меню.
|
направление меню
|
block_menu_dir
|
select
|
Направление графического меню (вертикальное / горизонтальное).
|
начальный уровень меню
|
block_menu_start
|
number
|
Начальный уровень подразделов для многоуровневого меню
|
конечный уровень меню
|
block_menu_stop
|
number
|
Конечный уровень подразделов для многоуровневого меню
|
ГРАФИКА
|
img
|
|
основные графические файлы
|
графика
|
icon
|
image
|
Основное графическое изображение объекта.
|
эффекты графики
|
icon_e
|
Textarea
|
Задает режимы обработки загружаемого файла в параметр "графика". Значения указываются в виде отдельных строк в формате
ключ1=значение1
ключ2=значение2
(Описание ключей см. Создание иконки объекта).
Аналогичный параметр с именем XXX_e можно создать для любого параметра типа "image", где XXX - имя переменной обрабатываемого графического параметра.
|
иконка
|
view_icon_photo
|
image
|
Уменьшенное графическое изображение для показа данного объекта в списках. Используется по умолчанию для генерации автоиконки параметра "графика".
|
эффекты иконки
|
view_icon_photo_e
|
textarea
|
Задает режимы обработки загружаемого файла в параметр "иконка" или режимы создания автоиконки, если загружается параметр "графика". Значения данного параметра задаются аналогично параметру "эффекты графики".
|
заголовок раздела
|
view_icon_title
|
image
|
Графический заголовок раздела сайта.
|
фон раздела
|
view_background
|
image
|
Графический фон раздела сайта.
|
графика меню
|
view_icon_menu
|
image
|
Основная (неактивная) "кнопка" графического меню.
|
графика меню on
|
view_icon_menu_on
|
image
|
Активная (текущая) "кнопка" графического меню.
|
графика дополнительная
|
view_icon_add
|
image
|
|
графика меню hover
|
view_icon_menu_hover
|
image
|
Накрытая "кнопка" графического меню.
|
графика списка
|
view_icon_list
|
image
|
Дополнительная графика, используемая некоторыми стилями.
|
пиктограмма в дереве
|
tree_folder
|
image
|
Пиктограмма объекта при показе в дереве сайта.
|
imagemap
|
imagemap
|
textarea
|
Атрибут area для параметра "графика", задающий форму активных областей на изображении и ссылки.
|
создавать автоиконки
|
view_make_icon
|
select
|
Устаревший. Заменен на параметр "эффекты иконки".
|
max ширина автоиконки
|
view_make_icon_x
|
text
|
Устаревший. Заменен на параметр "эффекты иконки".
|
max высота автоиконки
|
view_make_icon_y
|
text
|
Устаревший. Заменен на параметр "эффекты иконки".
|
начало автоиконки
|
view_make_icon_z
|
text
|
Устаревший. Заменен на параметр "эффекты иконки".
|
водяной знак
|
view_watermark
|
image
|
Графика для создания "водяных знаков" с помощью модуля resizer и эффектов графики.
|
флэш-файл
|
view_flash
|
file
|
Флэш-файл объекта.
|
флэш-параметры
|
view_flash_params
|
textarea
|
Параметры для флэш-файла. Формат:
ключ1=значение1
ключ2=значение2
Пример:
menu=true
FlashVars=key1=123456&key2=qwerty
width=100%
height=600
bgcolor=#86B2CD
Если данный параметр не задан, то флэш объект выводится со следующими значениями:
quality=best
wmode=transparent
menu=false
allowFullScreen=false
allowScriptAccess=sameDomain
FlashVars=url=URL&start=VIEW_FLASH_START
width=WINDOW_WIDTH
height=WINDOW_HEIGHT
где WINDOW_WIDTH, WINDOW_HEIGHT, URL и VIEW_FLASH_START - установленные значения соответствующих параметров
|
защитный код
|
imagekey
|
text
|
Специальный параметр, генерирующий числовой код для защиты интерактивных форм. Данный код выдается неавторизованным посетителям сайта и только в том случает, если imagekey указан в списке параметров для заполнения формы (параметр "имя формы или параметра").
Модификаторы параметра:
modekey=1 - одно число для ввода (по умолчанию)
modekey=2 - два числа для ввода суммы
keywidth=ЧИСЛО - ширина изображения кода в пикселах (умолч. - 66)
keyheight=ЧИСЛО - высота изображения кода в пикселах (умолч. - 29)
|
эффекты user фото
|
user_photo_e
|
textarea
|
|
Классификаторы
|
cl
|
|
объект типа "Новость"
|
спецкод?
|
cl_code_is
|
check
|
|
новость?
|
art_is
|
check
|
Устанавливает признак объекта, что он является новостью.
|
тип новости
|
art_type
|
mselect
|
Тип новости (произвольный список)
|
важность новости
|
art_prior
|
mselect
|
Важность новости (произвольный список)
|
ФОРМА
|
form
|
|
интерактивные формы
|
имя формы или параметра
|
form_name
|
text
|
Строка, задающая имя группы параметров или список параметров через запятую для организации интерактивной формы. Возможно указание защитного кода для неавторизованных посетителей (параметр imagekey).
|
заголовок формы
|
form_header
|
text
|
Заголовок интерактивной формы
|
подвал формы
|
form_footer
|
text
|
Концовка интерактивной формы
|
комментарий submit
|
form_submit_text
|
text
|
|
кнопка submit
|
form_submit
|
text
|
Текст на кнопке submit формы.
|
кнопка submit графика
|
form_submit_img
|
text
|
Графическое изображение кнопки submit формы.
|
кнопка cancel
|
form_cancel
|
text
|
Текст на кнопке cancel (сброс формы).
|
кнопка cancel графика
|
form_cancel_img
|
text
|
Графическое изображение кнопки cancel (сброс формы).
|
функция cancel
|
form_cancel_func
|
text
|
JavaScript функция для сброса формы (по умолчанию - reset()).
|
текст при записи
|
form_text_ok
|
text
|
Текст, выдающийся при записи заполненной формы в базу.
|
текст при ошибке
|
form_text_error
|
text
|
Текст, выдающийся при неправильном заполнении формы.
|
текст при ошибке ключа
|
form_text_error_key
|
text
|
Текст, выдающийся при неверном ключе формы (обработчик forumx)
|
права дочерних объектов
|
form_rights
|
select
|
Права за чтение, изменение и добавление для группы и остальных пользователей для новых объектов, создаваемых интерактивной формой.
|
владелец дочерних объектов
|
form_user_id
|
number
|
Идентификатор владельца новых объектов, создаваемых интерактивной формой.
|
группа дочерних объектов
|
form_group_id
|
number
|
Идентификатор группы для новых объектов, создаваемых интерактивной формой.
|
параметры для заголовка дочерних
|
form_mess_header_p
|
text
|
Список параметров, из которых будет сгенерирован заголовок, объектов создаваемых интерактивной формой (по умолчанию - первое текстовое поле формы).
|
кнопка календаря графика
|
form_cal_img
|
image
|
Графическое изображение кнопки вызова календаря для параметров типа "date".
|
вид формы
|
form_view
|
select
|
Задает вид интерактивной формы: стандартная (2 колонки), компактная (1 колонка) или упрощенная (в одну строку)
|
параметры профиля
|
form_name_user
|
text
|
Строка, задающая имя группы параметров или список параметров через запятую для показа профиля пользователя стилем show_user.
|
ОКНО
|
window
|
|
параметры управления окнами
|
тип окна
|
window_type
|
select
|
Тип и характеристики нового окна.
|
ширина окна
|
window_width
|
text
|
Ширина нового окна в пикселях.
|
высота окна
|
window_height
|
text
|
Высота нового окна в пикселях.
|
доп. ширина окна
|
window_width_add
|
text
|
Дополнительная ширина окна (добавляется к ширине графики).
|
доп. высота окна
|
window_height_add
|
text
|
Дополнительная высота окна (добавляется к высоте графики).
|
КАРТА САЙТА
|
sitemap
|
|
параметры модуля Карта сайта
|
стиль карты
|
sitemap_style
|
select
|
Устаревший. Заменен на "настройки менеджера".
|
глубина карты
|
sitemap_deep
|
number
|
Устаревший. Заменен на "настройки менеджера".
|
начало карты сайта
|
sitemap_root
|
number
|
Устаревший. Заменен на "настройки менеджера".
|
открытые разделы
|
sitemap_open
|
text
|
Устаревший. Заменен на "настройки менеджера".
|
не включать в карту
|
sitemap_no
|
check
|
Отменяет включение данного объекта (раздела) в карту сайта
|
не включать дочерние в карту
|
sitemap_no_childs
|
check
|
Отменяет включение дочерних объектов в карту сайта
|
не делать ссылку на карте
|
sitemap_nolink
|
check
|
Отменяет ссылку на данный объект в карте сайта (выводится только заголовок объекта)
|
ГОЛОСОВАНИЕ-РЕЙТИНГ
|
rate
|
|
параметра модуля Голосование
|
активно
|
rate_active
|
check
|
|
вид рейтинга
|
rate_type
|
mselect
|
|
вес оценки
|
rate_val
|
number
|
|
голосование
|
vote_is
|
check
|
Данный объект является голосованием.
|
активно?
|
vote_active
|
check
|
Признак того, что данное голосование еще активно. Стиль выводит форму для голосования.
|
благодарность
|
vote_thanks
|
text
|
Текст для проголосовавших посетителей.
|
уже голосовал
|
vote_already
|
text
|
Текст для проголосовавших посетителей.
|
режим голосование
|
vote_mode
|
radio
|
Задает режим уникальности голосования (по IP-адресам или cookies)
|
количество голосов
|
vote_cnt
|
number
|
Количество проголосовавших за данный вариант ответа.
|
ip или cookies
|
vote_data area
|
textarea
|
IP-адреса или cookies проголосовавших за данный вариант ответа (в зависимости от режима).
|
цвета для голосования
|
view_vote_colors
|
select
|
Задает набор цветов для рисования гистограммы с результатами
|
ИМПОРТ ЭКСПОРТ
|
impex
|
|
параметры импорта и экспорта
|
куда загружать
|
loader_to
|
number
|
Идентификатор родительского объекта для импорта
|
файл
|
loader_file
|
file
|
Тестовый файл для импорта с описанием полей (атрибутов и параметров) или архив (zip, rar) с файлом-описанием (list.txt) и другими внешними файлами.
|
xml канал для импорта
|
import_xml
|
text
|
|
разделитель записей
|
export_delimline
|
text
|
Разделитель записей для экспорта (по умолчанию - новая строка).
|
разделитель полей
|
export_delim
|
text
|
Разделитель полей для текстового формата (по умолчанию ;).
|
формат
|
export_format
|
select
|
Задает формат экспортного файла
|
кодировка
|
export_encode
|
select
|
|
атрибуты и параметры
|
export_params
|
text
|
Список параметров и атрибутов, которые необходимых экспортировать или * (все)
|
RSS ЭКСПОРТ
|
rss
|
|
параметры RSS экспорта
|
заголовок канала
|
rss_title
|
text
|
Задает заголовок RSS-канала (узел channel/title)
|
описание канала
|
rss_description
|
text
|
Задает описание RSS-канала (узел channel/description)
|
язык канала
|
rss_language
|
text
|
Задает язык RSS-канала (узел channel/language)
|
ttl канала (в минутах)
|
rss_ttl
|
text
|
Задает интервал в минутах канала (узел channel/ttl)
|
параметры категории
|
rss_cat
|
text
|
Задает имя параметра, значение которого необходимо использовать для категории объектов (узел item/category)
|
категории фиксированные
|
rss_category
|
text
|
|
Использовать yandex: fulltext
|
rss_yandex
|
check
|
Устанавливает наличие дополнительного узла объекта с его полным содержимым (узел item/yandex:full-text)
|
каналы для подписки
|
rss_links
|
textarea
|
|
жанр материала
|
rss_genre
|
select
|
|
МЕНЕДЖЕР
|
manager
|
|
параметры модуля JM
|
образец дочерних
|
manager_example
|
mselect
|
SQL-условие, задающее объекты, являющиеся "образцами" для ввода типовых объектов (по умолчанию - parent_id=95).
|
сортировка дочерних
|
manager_childs_sort
|
select
|
Устанавливает тип сортировки для вновь введенных объектов. По умолчанию - по дате ввода (последние наверху).
|
графические ресурсы
|
manager_icons
|
text
|
Идентификатор объекта с собственными пиктограммами для работы административных модулей.
|
ресурсы по умолчанию
|
manager_deficons
|
select
|
Задает стандартный набор пиктограмм для работы административных модулей.
|
настройки менеджера
|
jmanager_conf
|
textarea
|
Настройки модулей:
JManager
cм. Настройки JM
Корзина заказов (указаны умолчания)
ajax=0 — использовать ajax при обновлении корзины / добавлении товаров
compare=0 — добавить колонку сравнения товаров
updateblocks[]=1234
updateblocks[]=5555 — в таком формате указываются id блоков, которые система должна обновить после обновления корзины ajax-ом количество блоков не ограничено
compare=0 — добавить колонку для добавления товаров в сравнение
pos=1 — показывать порядковый номер товара или позицию (параметр prod_pos)
cnt=1 — позволить пользователю выбирать в корзине количество заказанных товаров
cntint=0 —число товаров может быть только целым
ut=1 — показывать единицы измерения (работает вместе с параметром prod_ut)
price=1 — показывать цену товара (работает вместе с параметрами prod_price или prod_price_XX )
inwords=1 — показывать сумму прописью
kop=1 — показывать копейки
print=1 — показывать печать заказа
pay=1 — включить оплату на сайте (требует хотя бы одну интегрированную платежную систему)
rating=1 — подсчитывать рейтинг товара (добавляет в момент создания заказа в каждый заказанный товар, в параметр prod_rating количество заказанных товаров, т.о. если включено в каждом товаре указано сколько раз его заказали). Параметр prod_rating должен существовать.
xml=0 — создавать xml-файл с заказом (должен существовать параметр order_file)
xmlname=order.xml — имя xml-файла с заказом
email=1 — отправлять копию заказа на e-mail заказчика (используется параметр order_email в заказе)
xmlpars= prod_art,prod_brand,prod_discount — (с версии 4.3.088) список параметров товара, которые записываются в заказе (в order_prod и order_file). По умолчанию пустой.
wherepromo — (с версии 4.3.084) sql-условие для выборки промокодов
для подключения Робокассы:
mrh0=логин в roboxchange
mrh1=password 1
mrh2=password 2
curr=предлагаемая валюта платежа PCR
Карта сайта
style='show_list' — вид карты show_list или show_tree (раньше - sitemap_style)
rootid=1 — корень менеджера (число или sql) (раньше - sitemap_root)
open=1 — список раскрытых ветвей (show_tree) (раньше - sitemap_open)
maxlev=4 — максимально число уровней(раньше - sitemap_deep)
filter=' ' — фильтр карты (sql)
text=0 — текстовый режим (show_tree)
max_childs=50 — число дочерних в ветви (show_tree)
iconsize=16 — размер иконок дерева по умолчанию 16/32
addfields=array() — [] - массив для показа дополнительных параметров, атрибутов, формат как для JManager
|
СЛУЖЕБНЫЕ
|
internal
|
|
служебные параметры
|
спецкод?
|
cl_code_is
|
check
|
Служебный признак классификаторов базы данных (спецобъектов).
|
текущая локаль
|
site_locale
|
text
|
Задает текущую локаль (национальные и языковые настройки) для правильного отображения дат, денежных единиц и пр. Устанавливается вместе с параметром "язык подраздела". По умолчанию - 'ru_RU.cp1251'
|
дополнение ссылки
|
block_addurl
|
text
|
Строка,. добавляемая ко всем ссылкам на дочерние объекты блока.
|
фильтр выборки блоков
|
filter_blocks
|
text
|
Дополнительное условие, ограничивающее условие выборки блоков.
|
фильтр выборки дочерних
|
filter_childs
|
text
|
Дополнительное условие, ограничивающее выборку дочерних объектов.
|
внешняя база данных
|
block_altbase
|
text
|
Имя альтернативной базы данных для обмена объектами разных сайтов на одном ядре.
|
внешний сайт
|
block_alturl
|
text
|
Имя альтернативного сайта на этом же ядре для обмена объектами.
|
формат полной даты
|
view_dateformat
|
text
|
Задает формат полной даты публикации (атрибут p_datetime). Использует текущую локаль (параметр site_locale). Синтаксис функции strftime(). По умолчанию: '%x %H:%M' (ДД.ММ.ГГГГ ЧЧ:ММ)
%a
|
сокращенное название дня недели в текущей локали
|
%A
|
полное название дня недели в текущей локали
|
%b
|
сокращенное название месяца недели в текущей локали
|
%B
|
полное название месяца недели в текущей локали
|
%c
|
предпочтительный формат даты и времени в текущей локали
|
%C
|
столетие (год/100 и огругленный до целого) от 00 до 99
|
%d
|
день месяца в виде десятичного числа от 01 до 31
|
%D
|
аналогично %m/%d/%y
|
%e
|
день месяца в виде десятичного числа от 1 до 31
|
%h
|
аналогично %b
|
%H
|
час от 00 до 23
|
%I
|
час от 01 до 12
|
%j
|
номер дня в году от 001 до 366
|
%m
|
номер месяца от 01 до 12
|
%M
|
минуты от 00 до 59
|
%n
|
символ "новой строки"
|
%p
|
"am" или "pm", или соответствующие строки в текущей локали
|
%r
|
время в формате a.m. или p.m.
|
%R
|
время в 24-часовом формате
|
%S
|
секунды от 00 до 59
|
%t
|
символ табуляции
|
%T
|
текущее время, аналогично %H:%M:%S
|
%u
|
номер дня недели от 1 до 7 (1 соответствует понедельнику)
|
%U
|
номер недели (1-й день 1-й недели - 1-е воскресенье года).
|
%W
|
номер недели (1-й день 1-й недели - 1-й понедельник года).
|
%w
|
номер дня недели от 0 до 6 (0 соответствует воскресенью)
|
%x
|
основной формат даты без времени (от настроек сервера)
|
%X
|
основной формат времени без даты (от настроек сервера)
|
%y
|
год без столетия от 00 до 99
|
%Y
|
год, включая столетие от 0000 до 9999
|
%Z
|
временная зона в виде смещения, аббривеатуры или имени
|
%%
|
символ "%"
|
|
домен
|
site_domain
|
textarea
|
Назначение отдельного домена (или нескольких) для определенной ветви сайта
|
функция
|
site_function
|
select
|
Дополнительный программный код для обработки данного объекта при показе его на странице.
|
функция блока
|
site_function_block
|
select
|
Дополнительный программный код для обработки данного объекта при показе его в блоке.
|
библиотека шаблонов
|
site_templates
|
file
|
XSL-файл с шаблонами сайта и отдельных блоков.
|
статистика по разделам
|
stat_branch
|
text
|
Задает "разделы" сайта для формирования статистики (SQL-условие)
|
запретить зеркала
|
site_one_domain
|
check
|
|
СЕКЬЮРИТИ
|
secur
|
|
управление IP-доступом
|
разрешенные IP
|
secur_ena_ip
|
text
|
Список IP-адресов, с которых разрешен просмотр данной страницы (ветви) сайта
|
разрешенные IP для записи
|
secur_ena_ip_post
|
text
|
Список IP-адресов, с которых разрешена отправка форм на данной странице (ветви) сайта
|
запрещенные IP
|
secur_dis_ip
|
text
|
Список IP-адресов, с которых запрещен просмотр данной страницы (ветви) сайта
|
запрещенные IP для записи
|
secur_dis_ip_post
|
text
|
Список IP-адресов, с которых запрещена отправка форм на данной странице (ветви) сайта
|
текст запрета
|
secur_dis_text
|
text
|
Текст, выдаваемый при запрете захода или записи на данной странице (ветви) сайта
|
запрещенные выражения
|
secur_dis_regexp
|
textarea
|
Запрещает ввод форм с определенными словами (выражениями). На каждой строке в значении параметра указывается слово или регулярное выражение, задающие запрещенные слова для ввода во все текстовые поля форм. В слове можно примерять знаки подстановки для обозначения любых букв (%*) или одной буквы (._). Регулярное выражение синтаксиса PCRE regex нужно заключать в /слеши/. (только forumx,form)
|
запрещенные данные посетителя
|
secur_dis_userdata
|
textarea
|
Запрещает ввод форм определенным посетителям сайта. Синтаксис аналогичен secur_dis_regex. Поиск ведется в полях, записываемых в параметр forum_userdata (только forumx,form)
|
ЗАПРОС HTTP
|
gethttp
|
|
получение данных по HTTP
|
host
|
gethttp_host
|
text
|
Адрес хоста для получения запроса. Пример: www.nic.ru
|
dir
|
gethttp_dir
|
text
|
Адрес директории для запроса. Пример: /whois/
|
query
|
gethttp_query
|
text
|
Строка GET-запроса. Пример: ?ip=212.67.0.83
|
timeinterval
|
gethttp_timeinterval
|
number
|
Интервал кэширование запроса в секундах.
|
process
|
gethttp_process area
|
textarea
|
Программный код для обработки результата запроса.
|
РАССЫЛКА
|
mailing
|
|
параметры рассылки новостей
|
раздел для подписки
|
site_subscribe
|
check
|
Устанавливает раздел сайта для подписки. Этот раздел будет доступен для выбора при оформлении подписки, и все объекты, введенные в данной ветви будут попадать в почтовую рассылку (с учетом прав доступа).
|
группа подписчиков
|
mail_group
|
number
|
Идентификатор группы пользователей-подписчиков сайта
|
проверять e-mail
|
mail_check
|
check
|
Формирует письмо для подтверждения подписки при регистрации пользователя на сайте или изменении профиля
|
текст подтверждения
|
mail_check_body
|
text
|
Текст письма для подтверждения подписки
|
заголовок подтверждения
|
mail_check_header
|
text
|
Заголовок письма для подтверждения подписки
|
From: для рассылки
|
mail_from
|
text
|
Поле From письма с рассылкой
|
Subject: для рассылки
|
mail_subject
|
text
|
Поле Subject письма с рассылкой
|
заголовок в рассылке
|
mail_header
|
textarea
|
Текст в начале письма с рассылкой
|
подпись в рассылке
|
mail_tail
|
textarea
|
Текст в конце письма с рассылкой
|
ПОИСК
|
search
|
|
параметры модуля Поиск
|
раздел для поиска
|
site_search
|
check
|
Устанавливает раздел сайта для поиска. Все объекты данной ветви будут доступны для поиска на сайте (по умолчанию доступны все объекты сайта, кроме спецрубрик).
|
текст
|
search_text2
|
text
|
Тест для поиска. Введенное в форме значение сравнивается с заголовком, аннотацией, контентом и параметрами объектов.
|
правила поиска
|
search_rules
|
select
|
Задает правила обработки поля search_text2 при поиске:
0=искать точную фразу (слово)
2=искать любое из указанных слов
3=искать все указанные слова
1=расширенный запрос (с использованием wildcard и логических выражений)
|
дата от
|
search_date1
|
date
|
Начальная дата публикации объектов для поиска. Возможно использование модификаторов usedate и defdate
|
дата до
|
search_date2
|
date
|
Конечная дата публикации объектов для поиска. Возможно использование модификаторов usedate и defdate
|
разделы сайта
|
search_rubrics
|
list
|
Разделы сайта для поиска.
|
сортировка
|
search_order
|
select
|
Задает порядок сортировки результатов поиска.
|
ограничение поиска
|
search_limit
|
number
|
Максимальное число найденных объектов.
|
в разделах для поиска
|
search_tree
|
check
|
Искать только в "разделах сайта для поиска".
|
условие для поиска
|
search_where
|
text
|
Дополнительное условие для поиска.
|
фильтр поиска
|
search_filter
|
select
|
Функция для дополнительной фильтрации (обработки) списка объектов, полученных в результате поискового запроса.
|
ФОРМА ОТЗЫВЫ
|
comment
|
|
|
имя
|
comment_name
|
text
|
|
e-mail
|
comment_email
|
text
|
|
вопрос
|
comment_text
|
textarea
|
|
ФОРУМ
|
forum
|
|
параметры модуля Форум (forumx)
|
имя
|
forum_name
|
text
|
Ник или имя посетителя. Может заполняться автоматически значением параметра user_nick или name, если пройдена авторизация или из COOKIE. Обработчик не допустит записи с ником или именем чужого посетителя
|
цена сообщения
|
forum_ratingcost
|
text
|
"Цена" одного сообщения форума. При добавлении / удалении сообщений значения параметра user_rating изменяется на величину forum_ratingcost
|
сообщений в теме
|
forum_cnt
|
text
|
Счетчик количества сообщений в теме форума. При добавлении / удалении сообщений параметр будет обновлен у всех родителей.
|
дата обновления темы
|
forum_update
|
date
|
Дата и время добавления последнего сообщения в теме.
|
настройки форума
|
forum_conf
|
textarea
|
Конфигурация и стартовые настройки модуля Форум (forumx):
view=tree - вид форума древовидный / линейный
sort=desc - сортировка сообщений для линейного вида
autofill=1 - заполнять поля формы (name, email)
bbtag=1 - обрабатывать bb-Тэги
cookieconf=1 - сохранять конфигурацию в COOKIE
showprofile=1 - отображать профили пользователей
subj_own=0 - владелец может удалять сообщения темы
textctrl=0 - показывать кнопки текстом или графикой
newtimer=300 - время для сброса New! в секундах
keytimer=300 - время ключей редактирования в сек
photo_x=50 - ширина аватара в пикселях
photo_y=50 - высота аватара в пикселях
icon_align_x=200 - предел обтекания графики текстом
icon_x=300 - не масштабировать если ширина меньше
icon_y=300 - не масштабировать если высота меньше
padding=25 - отступ для структурированного вида
smallwin=500,500,0,'resizable=yes’ - параметры окна для профиля пользователя
|
ФОРУМ ТЕМА
|
forumthem
|
|
|
тема
|
forum_subj
|
text
|
|
ФОРУМ СООБЩЕНИЕ
|
forummes
|
|
|
имя
|
forum_name
|
text
|
|
e-mail
|
forum_email
|
text
|
|
текст
|
forum_mess
|
textarea
|
|
ПОЛЬЗОВАТЕЛЬ
|
user
|
|
параметры регистрации
|
Имя
|
name
|
text
|
Имя зарегистрированного пользователя (автопараметр)
|
Login
|
login
|
text
|
Логин зарегистрированного пользователя (автопараметр)
|
Password
|
password
|
password
|
Пароль зарегистрированного пользователя (автопараметр)
|
E-mail
|
email
|
text
|
E-mail зарегистрированного пользователя
|
Ник для форума
|
user_nick
|
text
|
Ник пользователя в форуме (для forumx)
|
ПОЛЬЗОВАТЕЛЬ СЛ.
|
user_internal
|
|
служебные параметры пользователя
|
Настройки менеджера
|
user_jmanager_conf
|
textarea
|
Стартовые настройки модуля JM для данного пользователя. (См. Настройки JM).
|
Без изменения данных
|
user_noedit
|
check
|
Запрещает данному пользователю изменять свой профиль.
|
Автоматическая авторизация
|
user_autologin
|
check
|
Запоминает последний введенный login и password и автоматически авторизирует посетителя в течении одного года.
|
Запомнить на сайте
|
user_autologin
|
select
number
|
Запоминает последний login и password на указанное число дней и автоматически авторизирует посетителя в течении этого периода. Число дней должно быть больше 1. (Альтернатива предыдущему параметру)
|
Ник для форума
|
user_nick
|
text
|
|
Организация
|
user_org
|
text
|
|
Фотография
|
user_photo
|
image
|
|
Рейтинг
|
user_rating
|
text
|
Счетчик сообщений зарегистрированного посетителя в форуме. Изменяется при добавлении / удаления сообщений как им самим посетителем, так и модератором через интерфейс панели. "Цена" единицы указывается в параметре forum_ratingcost (для forumx)
|
ПОДПИСКА
|
user_subscribe
|
|
параметры подписки пользователя
|
Активизация подписки
|
subscribe_active
|
check
|
Включение/выключение подписки.
|
Интервал
|
subscribe_interval
|
select
|
Интервал подписки в часах.
|
Тип подписки
|
subscribe_style
|
select
|
Тип подписки (формат, объем).
|
Разделы сайта
|
subscribe_rubs
|
list
|
Разделы сайта, выбранные для подписки.
|
| 5.4. Синтаксис SQL-выражений
SQL-выражения
используются в системе TreeGraph для задания
значений параметров, управляющих различными выборками или условиями показа
объектов, а также при работе с фильтром модуля JM. В выборку попадают те объекты из базы данных, для которых установленное
выражение (условие) верно (истинно, =1). Синтаксис данных выражений полностью
соответствует определению WHERE в SQL-операторе SELECT. Выражение может содержать:
1. Имена переменных (любой атрибут объекта TreeGraph или параметр,
хранящийся в таблице в виде отдельного поля)
2. Круглые скобки () - для группировки
отдельных выражений и определения порядка выполнения операции.
3. Операторы сравнения
= - Равно
<> или != - Не равно
<= - Меньше или равно
< - Меньше
>= - Больше или равно
> - Больше
expr BETWEEN min AND max - Величина
выражения expr находится в
диапазоне min, max. Аналог (min<=expr AND expr<=max)
expr NOT BETWEEN min AND max - Величина
выражения expr находится вне
диапазона min, max.
expr IN (value,...) - Выражение expr равно любой величине
из списка IN
expr NOT IN (value,...) - Выражение expr не равно ни одной из
величин из списка IN
4. Логические операторы
NOT - Логическое
НЕ. Возвращает 1, если операнд равен 0, 0 если операнд - ненулевая величина.
AND - Логическое
И. Дает 1 если все операнды ненулевые, 0 если один или более операндов равны 0.
OR - Логическое
ИЛИ. Возвращает 1, если любой из операндов не 0, в остальных случаях возвращает
0.
XOR - Логический XOR (побитовое сложение по модулю 2). Возвращает 1
если нечетное количество операндов - не 0.
5. Функции сравнения строк
expr LIKE pat - Функция
производит сравнение с шаблоном, используя операции сравнения простых
регулярных выражений в SQL.
expr
NOT LIKE pat - Аналог NOT(expr LIKE pat).
Шаблон pat должен быть
ограничен кавычками или апострофами и может содержать произвольный текст и
следующие специальные символы:
% - Соответствует любому количеству символов, даже
нулевых
_ - Соответствует ровно одному символу
\% - Соответствует одному символу %
\_ - Соответствует одному символу _
expr REGEXP epat - Выполняет
сравнение строкового выражения expr с шаблоном epat (расширенное
регулярное выражение).
expr
NOT REGEXP epat - То
же, что и NOT(expr REGEXP epat).
Регулярное выражение epat должно быть ограничено кавычками или апострофами Кроме
текста, в нем могут использоваться любые специальные символы/структуры из числа
приведенных ниже:
^ - Соответствие началу строки.
$ - Соответствие концу строки.
. - Соответствие любому символу (включая перевод
строки).
a* - Соответствие любой последовательности из нуля или более символов "a".
a+ - Соответствие любой последовательности из одного или более символов
"a".
a? - Соответствие как нулю, так и одному символу "a".
de|abc -
Соответствие как последовательности de, так и последовательности abc.
(abc)* -
Соответствие нулю или более вхождениям последовательности abc.
a{i} - Последовательность, состоящая из i вхождений данного элемента.
a{i,} - Последовательность, состоящая из i и более вхождений данного элемента.
a{i,j} - Последовательность, состоящая от i до j вхождений данного
элемента.
[a-dX] - Устанавливает соответствие для любого символа, являющегося символом a, b, c, d или X
[^a-dX] - Устанавливает соответствие для любого символа, не являющегося символом a, b, c, d или X
MATCH (col1,col2,...) AGAINST (expr)
MATCH (col1,col2,...) AGAINST (expr IN BOOLEAN MODE) - Функция
используется для полнотекстового поиска и возвращает величину релевантности -
степень сходства между текстом в столбцах (col1,col2,...) и запросом expr. Величина
релевантности представляет собой положительное число с плавающей точкой.
Нулевая релевантность означает отсутствие сходства.
6. Арифметические операции
+ - Сложение
- - Вычитание
* - Умножение
/ - Деление
7. Строковые функции (см. описание MySQL)
8 .Математические функции (см. описание MySQL)
9. Функции даты и времени (см. описание MySQL)
10. Другие функции (см. описание MySQL)
11. Константы (числа, строки, даты)
В качестве констант также можно использовать выражение $PARAMS[имя_параметра]. В этом
случае при осуществлении выборки данное выражение заменяется на значение
указанного параметра для текущего объекта. Это значение может установлено как в
самом объекте, так и быть унаследовано от родителя или вышестоящих объектов
(см. примеры).
Выражение $PARAMS[имя_параметра] можно
использовать в основном тексте объекта (контенте) и в следующих параметрах:
ссылка - url
перенаправить -
redirect
onclick - onclick
условие выбора - block_where
условие показа - block_check
заголовок блока -
block_header
ссылка заголовка блока
- block_header_link
концовка блока -
block_tail
ссылка концовки блока
- block_tail_link
условие связки -
art_links
фильтр менеджера -
manager_filter
условие для поиска - search_where
http запрос - http_query'
В качестве имя_параметра можно указать имя
(переменную) любого параметра сайта, а также некоторые дополнительные ключевые
слова (перед ключевым словом PARAMS необходимо добавить
символ $):
PARAMS[today] - текущий день в формате ДД.ММ.ГГГГ
PARAMS[time] - текущее время в формате ЧЧ:ММ (время начала формирования HTML-страницы)
PARAMS[rand1] - сгенерированное случайное число 1
PARAMS[rand2] - сгенерированное случайное число 2
PARAMS[ip] - IP-адрес текущего
пользователя
PARAMS[user_id] - идентификатор текущего пользователь (если он авторизован)
PARAMS[id] - идентификатор текущего объекта (страницы)
|
|