Оглавление

Quick Start. Быстрый старт

 

Как подключить или создать модуль?

 

В левой верхней панели щелкнуть правой кнопкой мыши на элементе "Модули" и выбрать пункт "Добавить модуль". Справа откроется форма добавления модуля.

 

использовать уже готовый модуль:

 

  1. выбрать нужный модуль в выпадающем списке "Название модуля";
  2. выбрать нужный тип подключения модуля в поле "Тип модуля";Если ты подключаешь модуль как "общий", то ты не сможешь изменять структуру объектов в нем, однако будут доступны все изменения, происходящие в нем в будущем. При подключении модуля как "собственного" позволяет в дальнейшем вносить изменения в структуру его объектов.
  3. Нажать кнопку "Добавить".

 

создать свой собственный модуль:

 

  1. ввести имя нового модуля в поле "Название модуля";
  2. заполнить, если нужно, поля "Псевдоним" и "Описание";
  3. Нажать кнопку "Создать".

вверх

 

Как добавить или отредактировать тип объектов?

 

В левой верхней панели найти интересующий тебя модуль в папке "Модули".

 

добавить новый тип объектов в модуль:

 

  1. Щелкнуть правой кнопкой мыши на модуле и выбрать пункт "Добавить тип объекта";
  2. В открывшейся справа форме ввести название модуля и его псевдоним;
  3. В поле "Поля сортировки" можно ввести через запятую названия полей, по которым всегда будут сортироваться объекты этого типа;Например, если ты создаешь тип объектов "Новость", в этом поле ты можешь сразу указать, что новости должны всегда сортироваться по дате, в обратном порядке – самые свежие новости вверху (CDate desc).
  4. Отметить флажок "Является группой", если объекты этого типа могут содержать дочерние объект;Если ты установил этот флажок, появится вкладка "Типы дочерних объектов", в которой ты сможешь отметить те типы, которые может содержать текущий объект.
  5. Добавить нужные поля в объект. Для этого нажать кнопку "Добавить поле" и заполнить появившиеся поля: "Псевдоним", "Название", "Тип";Если необходимо, можно отметить флажок "Необязательное", по умолчанию все поля являются обязательными.
  6. Нажать кнопку "Сохранить".

 

отредактировать уже существующий тип объектов:

 

  1. Щелкнуть правой кнопкой мыши на нужном типе объектов и выбрать пункт "Редактировать". В открывшейся форме отредактировать нужные поля;
  2. Нажать кнопку "Сохранить".

вверх

 

Как управлять содержанием?

 

В левой верхней панели щелкнуть правой кнопкой на нужном модуле и выбрать пункт "Загрузить".

В нижней левой панели откроется дерево объектов. В нем можно добавлять новые объекты, редактировать уже имеющиеся, удалять объекты, копировать и перемещать их.

 

Добавить объект:

 

  1. Щелкнуть правой кнопкой мыши на объекте, в который нужно добавить новый объект, и выбрать пункт "Добавить объект";
  2. В открывшейся справа форме выбрать тип добавляемого объекта;Список допустимых типов дочерних объектов задается в форме редактирования типа объектов – см. раздел Работа со структурой объектов модуля.
  3. В открывшейся форме заполнить нужные поля;
  4. Нажать кнопку "Сохранить".

 

Редактировать объект:

 

  1. Щелкнуть правой кнопкой мыши на объекте, который необходимо редактировать и выбрать пункт "Редактировать";
  2. В открывшейся форме отредактировать нужные поля;
  3. Нажать кнопку "Сохранить.

 

Удалить объект:

 

  1. Щелкнуть правой кнопкой мыши на объекте, который необходимо удалить и выбрать пункт "Удалить"

 

Копировать объект:

 

  1. Удерживая кнопку Ctrl перетащить копируемый объект в нужную группу.

 

Переместить объект:

 

  1. Просто перетащить мышью объект в нужную группу.

вверх

 

Как вывести содержание на сайте?

 

Для вывода содержания на сайте используются шаблоны, написанные на языке Smarty. Это обычный HTML c вкраплениями команд Smarty. Шаблоны можно подсоединять: как ко всему проекту в целом, так и к конкретному модулю или к конкретному типу объектов. Каждый шаблон может комплектоваться так называемым "процессором" – это файл с кодом PHP, в котором могут подготавливаться данные для шаблона. Наличие процессора необязательно.Если ты добавил в свой проект общий модуль, то его шаблоны (заготовки с уже реализованной логикой работы) также автоматически добавятся в проект. Ты сможешь их просто отредактировать, добавив в них нужный HTML-код.

 

подключить шаблон:

 

  1. В левой верхней панели найти нужный проект, модуль или тип объекта в зависимости от того, к чему подключается шаблон. Щелкнуть правой кнопкой мыши на выбранном элементе и выбрать пункт "Методы";
  2. В появившейся справа форме нажать кнопку "Добавить";
  3. В появившейся панели с помощью флажков указать, необходимо ли добавить шаблон или процессор, или и то и другое вместе. Выбрать в полях файлы для закачки, а также указать название метода;Метод – это всего лишь способ отличать одни шаблоны от других. Например, ты добавляешь шаблон для показа текста одной новости. Ты можешь указать, что это шаблон с методом "show", или, например, "pokazhi_novost", или "show_my_news" - название ты придумываешь сам.
  4. Нажать кнопку "Ок".

 

редактировать шаблон:

 

  1. В левой верхней панели найти нужный проект, модуль или тип объекта в зависимости от того, к чему необходимо подключить шаблон. Щелкнуть правой кнопкой мыши на выбранном элементе и выбрать пункт "Шаблоны";
  2. В появившемся списке щелкнуть на нужном шаблоне. Слева появится список действий, который можно с ним произвести;С помощью списка действий можно заменять, удалять, скачивать или переименовывать шаблон и процессор
  3. Нажать кнопку "Ок".

 

просмотр шаблонов на сайте:

 

URL страницы, сформированной по определенному шаблону, имеет следующий формат: http://домен_проекта/модуль/объект/метод/атрибут.htm. Обязательными параметрами являются только модуль и метод.

Допустим, подключен шаблон с методом "show" к типу объектов page в модуле articles. Cледовательно, страница, сформированная этим шаблоном, будет доступна по адресу: http://домен_проекта/articles/page/show/

Теперь допустим, подключен шаблон show_list просто к модулю articles, тогда страница, соответствующая этому шаблону будет доступна по адресу: http://домен_проекта/articles/show_list/

Если шаблон подключен непосредственно к проекту, то страница, соответствующая этому шаблону будет доступна по адресу: http://домен_проекта/show_list/

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

Например, необходимо сообщить шаблону, что требуется показать страницу с идентификатором 5. Ты можешь передать этот параметр следующим образом: http://домен_проекта/articles/page/show/5.htm. В шаблоне все переданные параметры доступны в виде массива с именем $_THE.PARAMS. Соответственно, наш параметр 5, будет доступен в шаблоне через конструкцию $_THE.PARAMS[0] – он первый и единственный параметр.

 

вставить один шаблон в другой:

 

Иногда нужно, чтобы один шаблон был вставлен внутрь другого (include/инклюд). Используй для этого команду {xs2Fetch mod="модуль" obj="объект" met="метод" atr="атрибут"}.

С помощью параметров этой команды ты указываешь шаблон какого модуля и/или объекта, метода и с каким атрибутом необходимо вставить. В параметре atr атрибуту нужно указывать через точку, например, вот так – {xs2Fetch mod="articles" obj="page" met="show" atr="5.3.all"}

вверх

 

Ресурсы

 

В дизайне страницы часто используются различные дополнительные ресурсы: графика, флэш, javascript, css и.т.п. Их также можно подключить к модулям и типам для дальнейшего использования в шаблонах.

 

добавить ресурс (изображение, javascript, css):

 

  1. В левой верхней панели найти нужный модуль или тип объекта в зависимости от того, куда подключается ресурс. Щелкнуть правой кнопкой мыши на выбранном элементе и выбрать пункт "Ресурсы";
  2. В появившейся справа форме нажать кнопку "Добавить";
  3. В появившейся панели выбрать файл для закачки;
  4. Нажать кнопку "Ок".

 

отредактировать ресурс:

 

  1. В левой верхней панели найти нужный модуль или тип объекта в зависимости от того, к подключается шаблон. Щелкнуть правой кнопкой мыши на выбранном элементе и выбрать пункт "Ресурсы"
  2. В появившемся списке щелкнуть на нужном ресурсе. Слева появится список действий, который можно с ним произвести.С помощью списка действий можно заменять, удалять, скачивать или переименовывать ресурс
  3. Нажать кнопку "Ок".

 

поставить ссылку на ресурс в шаблоне:

 

Для того, чтобы в шаблон при выводе данных был вставлен путь к ресурсу, необходимо в шаблоне в том месте, где должен вывестись путь, вставить следующую команду: {xs2Src mod="модуль" obj="объект" name="имя ресурса"}

Параметры команд:

  • mod – название модуля, к которому подключен ресурс (обязательный параметр)
  • obj – название типа объекта, к которому подключен ресурс (необязательный параметр – если ресурс подключен к модулю, а не к типу объектов, то и указывать obj не следует)
  • name – имя ресурса (фактически, это имя файла, например, header.jpg или rolik.swf)

вверх

 

Как запросить данные из системы?

 

Для показа данных из системы на сайте, необходимо в шаблонах использовать специальные команды. Основных команд всего 4. Выбрав данные с помощью этих команд, ты можешь выводить их с помощью языка Smarty.

 

Список основных команд:

 

  • {xs2GetNode NodId="идентификатор объекта" var="название переменной"} – возвращает определенный объект. Идентификатор объекта можно посмотреть в форме его редактирования в поле ID. Параметр var указывает, как называется переменная, в которую вернется найденный объект.Например, ты хочешь выбрать объект номер 5 – {xs2GetNode NodId=5 var="node"}. После выполнения этой команды, ты можешь выводить поля этого объекта. Например, для вывода даты создания объекта – {$node.CDate}.
  • {xs2GetNodes NType="имя типа объектов" var="название переменной"} – возвращает набор объектов типа NType.Например, ты хочешь получить все статьи, имеющиеся в системе – {xs2GetNodes NType="article" var="articles"}. После выполнения этой команды в переменной $articles будет содержаться набор (массив) всех статей. Все статьи их этого набора, можно, например вывести с помощью стандартных методов организации цикла в Smarty (команда {foreach}).
  • {xs2GetChildren ParId="идентификатор объекта" var="имя переменной"} – возвращает набор всех дочерних объектов объекта с идентификатором ParId.
  • {xs2GetLinks NodId="идентификатор объекта" field="поле в ссылающемся объекте" NType="тип ссылающихся объектов"} – возвращает набор объектов типа NType, у которых в поле field есть ссылка на узел с идентификатором NodId.Слегка замороченная команда, но иногда бывает очень полезной. Представь, что ты делаешь модуль "Блог". В блогах часто есть возможность добавлять в друзья других пользователей. В модуле у типа объектов Пользователь ты наверняка сделаешь поле типа "Ссылка", в которой и можно указывать других пользователей. Теперь, на странице нужно вывести список всех пользователей, которые имеют в друзьях текущего пользователя. Вот здесь и пригодится функция {xs2GetLinks}. Представим, что идентификатор текущего пользователя равен 10. Пишем {xs2GetLinks NodId=10 NType="user" field="friends"} – возвращаем всех пользователей, у которых в поле friends есть ссылка на пользователя номер 10.

вверх