Полное описание TreeGraph на одной странице

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 винчестер уменьшит задержки по всем операциям.

На что обратить внимание при установке.

  1. Очень желателен RAID уровня 1, 5, 10.
  2. Очень желателен отдельный винт под бекапы.
  3. VLM не используем. Дробим разделы, чтобы сделать отдельными /var/log /tmp /www /mysql. Последние в отношении размеров 50 на 50. Это соотношение действует для большинства проектов. Основной принцип в разметке - в случае краха иметь возможность вытащить данные.
  4. FTP и Apache должны уметь создавать файлы, общие для редактирования. Для ProFTPd и Apache это возможно.
  5. Меры защиты типа jail, chroot и т.д. теоретически возможны, но могут потребовать дополнительной совместной работы в плане доступа к необходимым библиотекам php.
  6. Замена Apache на более "легкий" сервер возможна, но не обкатана.
  7. Очень желателен кэширующий DNS.
  8. При настройке фаирвола следует учесть, что сайт может обращаться к другим серверам, зачитывая 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):

  1. выберите параметр(ы), где нужно произвести поиск и замену текста
  2. заполните поля «найти» и «заменить»
  3. ввести изменения

Рис.9

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

  • учитывать регистр (по умолчанию регистр не учитывается)
  • регулярные выражения
  • обрабатывать в полях «найти» и «заменить на»
  • тестовый режим

Учитывать регистр (по умолчанию регистр не учитывается)

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

 

Регулярные выражения

Выбор этой настройки позволит вводить в поле «найти» регулярные выражения, для более сложного поиска в строке, подробнее о регулярных выражениях по ссылке http://php.net/manual/ru/reference.pcre.pattern.syntax.php

 

Обрабатывать $PARAMS в полях «найти» и «заменить на»

Выбор этой настройки позволит вводить в поля «найти» и «заменить на» выражения типа $PARAMS[] подробнее по ссылке http://graphit.ru/?id=2514 .

 

Тестовый режим

Выбор этой настройки позволит сымитировать замену не внося изменения в сами объекты. Результат имитации доступен в текстовом отчете в модуле «Информации» (он появится после нажатия кнопки «Ввести»)

Рис.10

Добавить (заменить) выбранные параметры

Рис.11

Алгоритм работы с режимом «Добавить (заменить) выбранные параметры» по умолчанию добавляет и заменяет (удаляя старое значение) (Рис.11):

  1. выберите параметр(ы) которые нужно добавить (заменить)
  2. укажите значение параметров
  3. введите изменения

Для данного режима предусмотрены дополнительные настройки:

  • сохранять установленные параметры
  • удалять невыбранные параметры
  • обрабатывать в значениях параметров

Сохранять установленные параметры

Эта настройка позволит сохранить старое значение параметра, если оно уже есть в объекте.

 

Удалять невыбранные параметры

Применение этой настройки удалит ВСЕ старые параметры и добавит ТОЛЬКО новые.

 

Обрабатывать $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).

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

Импорт (объект | параметры ) - режим работы импорта - загрузка объектов или параметров и их групп.

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

Будьте внимательны при использовании данного модуля! Результаты операции пакетного редактирования не обратимы.

Допустимы следующие способы импорта объектов:

  1. Используется поле "Файл": загружается текстовый операционный файл (list.txt)

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

  1. Используется поле "Список"

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

Пример.

Задача: создать пять новых разделов внутри каталога с id 12345.

Вместо того, чтобы создавать объекты руками – используем импорт. В поле "список" достаточно вставить один столбец с заголовками, если нужны другие параметры (с общими для всех новых объектов значениями) выбираем при импорте нужный образец или устанавливаем образец для раздела в которой производится импорт (с помощью параметра "образец дочерних" из группы "МЕНЕДЖЕР").

Куда загружать: 12345

Список:
mess_header
Первый раздел
Второй раздел
Третий раздел
Четвертый раздел
Последний раздел

  1. Используется поле "Файл": 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 и наоборот.

  1. Используется поле "Файл": ZIP/RAR без list.txt (фотогалереи)

Существует упрощенный режим импорта объектов, предназначенный для наиболее распространенной операции – загрузки фотографий на сайт. Данный режим "включается" в случае, если в загруженном архиве нет операционного файла, а поля "список", "управление" и "данные" (см. ниже) пустые.

Все что нужно сделать чтобы загрузить на сайт фотографии (или иную графику) – запаковать в zip или rar архив графические файлы (gif / jpg / png), затем отправить такой архив в модуль импорта.

В этом случае:

  • обязательно нужно заполнить поле "куда загружать" (указать id галереи);
  • создастся столько объектов, сколько графических файлов будет в архиве;
  • картинки будут загружены в параметр "графика", если нужно загружать их в другой параметр – используйте автогенерацию операционного файла (см. ниже);
  • если в самой галерее нет параметра "образец дочерних", а в каждой фотографии требуются какие-то специальные параметры – нужно выбрать образец с этими специальными параметрами в поле формы импорта "образец дочерних";
  • если нужно автоматически создавать иконки для фотографий – можно это сделать "по требованию" после импорта используя фильтр или же заранее (до импорта) настроить параметр "эффекты иконки".
  1. Используются поля "Управление" / "Данные", "Файл": 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

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


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" () экранного менеджера. Броузер откроет отдельное окно с 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
где ключ - идентификатор текстовой строки или имя параметра. Подробнее здесь. Наследуется. По умолчанию установка ниже по дереву отменяет наследование всех ключей, не только установленных ниже по дереву. Чаще всего задается в корне языковой версии сайта (в id 1 для основной версии).

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-класса для формирования основной ссылки в списке некоторыми стилями. Наследуется. Используется редко. Для оформления ссылок предпочтительно использовать класс блока или класс body с каскадированием.

класс списка

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 классы. Если нужно определить для раздела или блока используйте параметры «класс body» и «класс блока».

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 класс» если нужно определить оформление. Не наследуется. Старые версии XSL стилей могут не понимать этот параметр. Для исправления нужно модифицировать mess_standart.

позиция

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

Графика для заголовка блока. Выводится перед списком объектов. Не наследуется. Как правило, не используется. Более современный способ – CSS.

ссылка заголовка

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

Задает имя таблицы для условия выбора Не наследуется.

МЕНЮ

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) устарели в связи с вводом модуля rate (голосования и рейтинги).

активно?

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-файл с шаблонами сайта и отдельных блоков. Не наследуется. Основной файл шаблонизатора можно загрузить только через модуль styles.

статистика по разделам

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] - идентификатор текущего объекта (страницы)

PARAMS[parent_id] - идентификатор родительского объекта текущей страницы

PARAMS[mess_header] - заголовок текущего объекта (страницы)

PARAMS[p_date] - день публикации текущего объекта в формате ДД.ММ.ГГГГ

PARAMS[parents_list] - список родительской ветви текущего объекта от корня до самого объекта через запятую

PARAMS[query_string] - строка запроса броузера

 

Примеры задания параметра "условие выбора" block_where

Описание выборки

id=1210

выбрать объект с идентификатором 1210

id=110 or id=111 or id=112

выбрать объекты с идентификаторами 110, 111, 112

id in (110,111,112)

выбрать объекты с идентификаторами 110, 111, 112

parent_id=201

выбрать объекты, дочерние для объекта с идентификатором 201

parent_id=201 and id<>111

выбрать объекты, дочерние для объекта с идентификатором 201, кроме объекта 111

parent_id in (201,202) and id not in (111,112)

выбрать объекты, дочерние для объектов 201 и 202, кроме объектов с идентификаторами 111, 112

parent_id=200 and ro=1

выбрать объекты дочерние к 200 и открытые всем на чтение