Главная → Вопросы → Веб-инженеру → Создание контентного модуля

Создание контентного модуля

Базовые этапы

Система → Структура → Контент - Создание нового или копирование уже существенного модуля, конфигурация и шаблонизация.
Система → Аутентификация → Группы → Выбрать группу → закладка "Контент" - настроить права доступа к модулю
Веб-сайт → Стуктура сайта - подключить новый модуль к сайту (вывести в меню)

Конфигурация

Вкладка "Содержание"

Зайдите в административную часть сайта.
Нажмите вверху кнопку "Система" - она находится между кнопками "Рабочий стол" и "Службы".
Далее пройдите по пути Структуры/Контент. Появиться список уже созданных контентных модулей.
Справа вверху от листинга нажмите кнопку "Добавить". Появиться окно добавления нового модуля и только одна вкладка - "Содержание".
Здесь в строке "Заголовок" напишите название контентного модуля. Например, "Новости"
Далее в этой же строке правее выберите класс листинга ( он пока один - Grid2)
Далее в "Тип листинга" выберите форму, в которой будет выводится листинг модуля. Некоторые типы требуют пояснения:
- Список - стандартный список материалов. К примеру, как здесь http://re-port.ru/news/ В этом списке обычно выводятся заголовки материалов, их краткое описания, дата создания. Часто выводится Категория, к которой принадлежит материал, его Фильтр.
- Поиск - используйте этот тип, если у вас есть необходимость отобразить в листинге только форму поиска. Как например реализовано здесь http://cpk-germany.com/sklad/
- Поиск+Список - используйте этот тип, если Вам необходимо отобразить не только форму поиска, но и листинг материалов. Как например реализовано здесь http://re-port.ru/vacancies/
- По рубрикам - используйте этот тип листинга, если Вам необходимо отобразить листинг с группировокой элементов листинга по рубрикам. Рубрикам необходимо задать сортировку.
- По дате - используйте этот тип листинга, если Вам необходимо отобразить листинг с группировокой элементов листинга по дате создания материала.
- Группировка по плейсхолдеру - используйте этот тип листинга, если Вам необходимо отобразить листинг с группировкой элементов по справочнику, пользователям и т.д.
Далее правее выберите "Класс элемента". Item2 необходимо выбирать только в одном случае - если требуется выводить в виде меню свзяки данного модуля с другими модулями.
В строке, которая идёт ниже введите значение для сортировки материалов. В xevian существует несколько предопределённых значений сортировки, которые нужно ввести в это поле в зависимости от вашей потребности:
- Если в поле сортировки Вы введёте "id" - метериалы отсортируются в листинге по их идентификацонным номерам (id). Это тип сортировки рекомендуется для использования, т.к. при его использовании создаётся наименьшая нагрузка на сервер, нежели при использовании других типов сортировки.
- Если в поле сортировки Вы введёте "title" - метериалы отсортируются в листинге по названию своих заголовков.
- Если в поле сортировки Вы введёте "date_expired" - метериалы отсортируются в листинге по дате окончания публикации. Как, например, здесь http://re-port.ru/exhibitions/
- Если в поле сортировки Вы введёте "date_modified" - метериалы отсортируются в листинге по дате своего изменения.
- Если в поле сортировки Вы введёте комбинированное значение "special desc, content_items.date_modified" - акцентированные материалы отобразятся в самом верху списка, далее пойдут обычные материалы с сортировкой по дате изменения.
Далее, правее выберите направление сортировки, воспользовавшись селектбоксом "Сортировка - направление".
В селектбоксе Limit выберите, сколько материалов будет отображаться на одной странице листинга. Если число, указанное вами здесь превышает количество опубликованных материалов модуля, внизу выведется пагинатор (пейджер), с помощью которого можно будет выйти на последующие страницы листинга.
Далее в третьей сверху строке выберите статус публикации будущих материалов модуля с помощью селектбокса "По умолчанию":
- При выборе "Публиковать" - материалы модуля публикуются по умолчанию
- При выборе "Не публиковать" - материалы модуля по умолчанию не публикуются.
- При выборе "Акцентировать" - материалы модуля по умолчанию акцентируются. Акцентированные материалы - это материалы, над которыми поставили акцент, имеют нестандарное оформление. Это оформление используется для выделения этих материалов из общей массы. Например здесь http://re-port.ru/companies/?companies=47 заголовки акцентированных материалов выделены красным цветом и сероц рамкой.
"Access control" - здесь вы можете включить контроль доступа.
В следующей строке включите при необходимости поддержку папок, используя селектбокс "Folders". ( Мы будет рассматривать вариант, когда все функции включены). Папки используются для того, чтобы присвоить нескольким материалам определённых свойств (к примеру акцентировать их). А также для того чтобы , к примеру, дать доступ к материалам из какой либо папки определённой группе Пользователей. ( Чаще всего на наших проектах используются два вида папок - Бесплатное и Платное размещение )
Включите при необходимости поддержку модулем фильтров, используя селектбокс "Filters". К примеру, в модуле Новости на re-port.ru включена поддержка фильтров. Здесь http://re-port.ru/news/82710/ фильтром является "Правительство" ( над кратким описанием) - при клике на фильтр - появляется список материалов с таким же фильтром.
Включите при необходимости поддержку модулем категорий, используя селектбокс "Categories". К примеру, в модуле Новости на re-port.ru включена поддержка категорий. Категории отображаюся под заголовком модуля. При клике по любой из них, появятся материалы из этой категории.
В следующем селектбоксе "Комментарии" включите при необходимости поддержку модулем комментариев.
Далее перейдите на строку ниже. В первом селектбоксе "Оценки" включите при необходимости поддержку оценки материалов.
Правее во втором селектбоксе "Фотогаллереи" включите при необходимости поддержку фотогаллереи в материалах модуля.
В следующем селектбоксе "Expiration" влючите при необходимости поддержку модулем "Даты окончания публикации". Это также необходимо для работы интервала у материалов.
В самом правом селектбоксе строки "Calendar" влючите при необходимости тот календарь, который Вас устраивает. Это может быть Ежедневник либо Годовой календарь.
В следующей строке выберите в "Timestamp" при необходимости поддержку функции выбора дня рождения в материале модуля.
Если на вашем сайте предусмотрена продажа каких-либо товаров или услуг, активируйте функцию "Cartable" (она предназначена для того, чтобы на внутренней странице материала (во фронтенде) с помощью плейсхолдера ADD2CART отобразилась форма добавления какого либо товара/услуги в корзину) и функцию Pricable (она предназначена для того, чтобы у материала (в backend) появилась вкладка Цены, в которую можно добавить список цен на товары определённой марки)
В селектбоксе "Файлы" включите при необходимости поддуржку вложений файлов для материалов модуля.
В следующей строке вы можете включить поддержку "Видео" в материале, (в селектбоксе Params) поддержку параметров (параметры - при их использовании у вас появится возможность добавлять дополнительные данные в материал, такие как email, сайт, количество чего-либо и пр.), Rss-ленту модуля (к примеру ссылка на rss-ленту новостей re-port.ru имеет вид http://re-port.ru/rss/news/), указать Комментарий к RSS-ленте.
В следующей строке, в первом селекбоксе вы можете указать, будет ли включёны материалы данного модуля в подписку, т.е. будет ли модуль учавствовать в рассылке (Селектбокс - Подписка).
Правее вы можете указать комментарий к подписке ( "Подписка - комментарий")
В следующем селектбоксе включите при необходимости возможность отсылать сообщения с помощью спец. формы( из фронтенда) пользователям в данный модуль. (Селектбокс - Сообщения). Правее вы также можете указать "Сообщения - Заголовок".
Чтобы включить возможность добавления материала, в следующей строке активируйте селектбокс "Добавление". ( Пример реализации вы можете посмотреть здесь http://xevian.com/faq (нажмите ссылку "Добавить вопрос")). Для того, чтобы задать текст ссылки на форму добавления материала, заполните поле "Добавление - заголовок". Чуть правее вы можете также указать "Добавление - Комментарий".
Поддержку Тегов вы можете включить в самом правом селектбоксе этой строки "TAGS".
Для включения логов модуля используйте селектбокс "Logs".
Нажмите кнопку "Сохранить". Появится ещё множество вкладок, которые мы рассмотрим ниже.

Вкладка "Справочники"

Перейдите во вкладку "Cправочники". Здесь вы можете указать связку с теми справочниками, которые вам понадобятся при формировании контента модуля. Допустим если вам нужно, чтобы в материале была возможность добавить город, выберите справочник "Город" в списке и нажмите кнопку "Cохранить".
Здесь вы можете также указать тип связки. Single - единичная связка (к примеру если вы подключили к модулю справочник "Город", при использовании этой связки вы можете выбрать только один город для данного материала). Multiple - мультисвязка (Эта связка используется к примеру если вам нужно присвоить несколько рубрик одной организации. После включения связки модуля, например со справочником "Рубрикатор", в форме добавления материала появляется дополнительная закладка, при открытии которой появятся чекбоксы, с их помощью вы можете включить ваш материал в несколько разделов рубрикатора).
В столбике breadcrumbs можно включить вывод пунктов справочника в хлебные крошки (строку пути) при навигации по модулю.

Вкладка "Связки"

В этой вкладке вы можете указать связки данного модуля с другими модулями. К примеру если Товары производит какая-то организация, разумно сделать связку у модуля "Товары" с модулем "Организации".
Здесь вы также можете указать тип связки Multiple, либо Simple. Припцип их (типов) работы такой же, как и во вкладке "Справочники".

Вкладка "Определения"

В этой вкладке вы можете задать названия полей в форме добавления материала: Для заголовка, иконки, картинки, краткого и подробного описания. Если нужно скрыть - присвоить значение "none"

Вкладка "Листинг"

Эта вкладка используется для шаблонизации листинга в модуле. Она содержит несколько полей для ввода html-кода:

Шаблон заголовка листинга - в этом поле шаблонизируется заголовок листинга. Для вывода заголовка используйте плейсхолдер header.
Шаблон каркаса листинга. Основной плейсхолдер, который здесь необходим - items. В него выводится содержимое поля "Шаблон элемента листинга".
Шаблон элемента листинга. Здесь шаблонизируется листинг материалов модуля. Основные плейсхолдеры, которые здесь используются: title - выводит заголовок материала, intro - выводит краткое описание материала.
Шаблон акцентированных элементов листинга. Если ваш материал акцентирован, шаблон для элементов листинга система будет брать из этого поля.
Шаблон каркаса листинга - для субконтента. Шаблон для табов модуля в других модулях или в профиле пользователя. Если шаблон пуст, то визуализация формируется из шаблона каркаса листинга

Вкладка "Страница"

Используется для шаблонизации внутренней страницы модуля. Она содержит несколько полей для ввода html-кода:

Шаблон заголовка - содержит шаблон для визуализации заголовка модуля. Для его вывода используйте плейсхолдер title.
Шаблон каркаса страницы. Работает, когда в конфигурации модуля включён класс элемента Item2. Это поле предназначено для отображения меню материала, либо табов. В этих табах отображаются названия модулей, с которыми связан текущий модуль, в также таб, при клике на который появляется форма обратной связи.
В этом шаблоне используются плейсхолдеры content_tabs и content_body. content_tabs - в него выводятся табы, либо меню материала. content_body - в него выводится содержимое шаблона страницы.
В Шаблоне каркаса страницы используется также плейсхолдер params. В него выводятся параметры.
Шаблон страницы - используется для визуализации страницы. В основном здесь используюся плейсхолдеры title - выводит заголовок материала, intro - его краткое описание, description - подробное описание материала, date_added - дату добавления материала.

Вкладка "Доп. шаблоны"

Здесь визуализируется вывод параметров в плейсхолдер params. В каркасе используется плейсхолдер items. В шаблоне элементов - плейсхолдеры title (заголовок элемента) и value (значение элемента в данном материале).

Вкладка "Subsite"

Здесь визуализируются листинг и страница материалов, выводимых в Конструктор сайтов.

Вкладка "Поиск"

Сюда вносится шаблон поисковой формы, использование которой планируется в модуле.

Вкладка "Форма"

Шаблон формы добавления материала в контентный модуль в личном кабинете пользователя. Здесь используются плейсхоледры tpl_content_multiple_модуль, tpl_content2content_модуль, tpl_content_multiple, tpl_content2content, tpl_params, tpl_image, tpl_directories_справочник_simple и некоторые другие. Если вкладку оставить пустой, подключается общий шаблон /auth/content/forms/content.html.

Обзор вкладок контентного модуля

Материалы - вкладка, которая отображает список материалов модуля. Здесь Вы можете:
- сделать поиск по материалам ( по id, заголовку материала, либо по пользователю, опубликовавшему материал).
- просмотреть материалы за определённое число/месяц/год, воспользовавшись календарём
- Добавить новый материал, нажав кнопку "Добавить".
- Зайти в конфигурацию модуля, нажав кнопку справа от кнопки "Добавить".
- Задать удобную для вас последовательность столбцов нажав кнопку под кнопкой "Добавить".
- Задать удобное для вас количество отображения материалов в листинге, используя селектбокс снизу справа.
- Внизу слева вы можете использовать стрелки навигации, для перехода по страницам листинга. Здесь же для быстрого перехода на определённую страницу листинга есть селектбокс с номером страницы перехода.
- После выделения материала, внизу доступны функции его Публикации, Акцентирования, Копирования и Удаления. Кнопка "Обновить" применяет изменения, сделанные в сортировке.
Комментарии - вкладка, в которой доступны для просмотра все комментарии модуля, приходящие от пользователей.
Оценки - вкладка, в которой доступны для просмотра все оценки модуля.
Рубрикатор - вкладка, внутри которой вы можете создать необходимые вам рубрики для материалов модуля.
Фильтры - вкладка, внутри которой вы можете создать необходимые вам фильтры для материалов модуля.
Параметры - внутри этой вкладки отображаются параметры для материалов. Краткая инструкция по добавлению параметров в модуль:
- Нажмите кнопку "Добавить".
- Введите название параметра в поле "Заголовок". Например, Имя
- Ниже введите "Идентификатор". Например, name
- Далее выберите с помощью селектбокса тип параметра. Чаще всего этот тип - text. Если вам нужно будет указывать в материале цену - выберите тип price. При этом в материале справа от поля ввода цены появится селектбокс выбора валюты - изначально он пуст. Если у вас на сайте планируется использовать несколько валют, выполните следующие действия для их создания:
  - Вам необходимо включить себе доступ с разделу Валюта. Для этого Перейдите в админке по пути: Система-->Группы-->"Нужная вам группа". Во вкладке права включите Валюты ( вместо Валюты может стоять плейсхолдер TEXT_CURRENCIES).
  - Далее перейдите по пути Система-->Конфигурация-->Валюты
  - Нажмите справа вверху кнопку "Добавить".
  - В заголовке валюты введите, например "Руб."
  - В поле код , если вам нужен рубль, введите "RUB"
  - В поле курс введите текущий курс валюты. Для рубля здесь нужно ввести "1", т.к. все остальные валюты определены по отношению к рублю
  - Для всех остальных валют нужно сделать по аналогии с рублём.
- Если в листинге у вас будет поисковая форма, то для нужного вам параметра укажите тип поискового поля с помощью селектбокса. Здесь Вам доступны следующие варианты:
  - Совпадение - означает, что запрос, который введёт пользователь в поле данного параметра на сайте во время поиска должен точно совпадать со значением параметра материала. Тогда в результатах поиска, выведется этот материал.
  - Интервал - в поисковой форме у параметра с таким поисковым полем появляется интервал значений. Часто используется для зар. платы. Когда нужно указать з.п., к примеру 15000-20000
  - Не больше.
  - Не меньше.

Группировки контентных модулей

Зайдите в административную часть сайта.
Нажмите вверху кнопку "Система" - она находится между кнопками "Рабочий стол" и "Службы".
Далее пройдите по пути Структуры/Контент. Во вкладке "Материалы" появится список уже созданных ранее контентных модулей.
Справа от вкладки "Материалы" находится вкладка "Группировки".
При переходе в неё мы видим список созданных ранее групп контентных модулей.
Чтобы создать новую группу для контентных модулей, во вкладке "Группировки" нажимаем кнопку "Добавить".
Ввести только название в поле "Заголовок".
Сохранить. Группа создана.
Для того, чтобы перенести модуль в группу, во вкладке "Материалы" нужно зайти в тот модуль, который мы хотим перенести в созданную группу или уже существующую группу.
После того, как Вы зашли в соответствующий контентный модуль, Вы попали сразу на вкладку "Содержание". Справа от поля "Заголовок", где хранится название модуля, располагается поле-селектбокс "Расположение". Именно здесь выбирается группа.
Выбираете соответствующую группу, затем нажимаете "Сохранить".
Нажмите вверху кнопку "Рабочий стол". В левой колонке нажмите на папку "Контент" - Вы увидите древовидную структуру, состоящую из групп, в которых находятся выбранные модули, и непривязанных модулей.

автор:

Администратор