Статьи

Модуль «Статьи» отображает статьи.

Модуль относится к части CMS «Контент» и может быть установлен опционально.

Модуль «Статьи» можно прикреплять к различным страницам сайта. Если модуль прикреплен к нескольким страницам, в административной части модуля появляется специальный фильтр «Раздел сайта» с возможностью фильтрации вывода (списка статей, категорий и настроек) по принадлежности к странице.

Модуль состоит из двух частей: категории статей и статьи.

Статьи

Список статей

В списке статьи выводятся с приоритетом по важности и согласно ручной сортировки.

Редактирование статьи

Статьи имеют следующие характеристики.

В модуль «Статьи» встроена автоматическая публикация статей в формате RSS.

Адрес RSS-ленты: http://site.ru/clauses/rss/.

У англоязычной версии сайта адрес RSS-ленты новостей будет иметь вид: http://site.ru/eng/clauses/rss/

Категории

Список категорий статей

Категории статей могут иметь неограниченное число подкатегорий. При необходимости категории можно не использовать. Для этого нужно отключить параметр «Использовать категории» в настройках модуля.

При удалении категории удаляются все вложенные подкатегории и статьи.

Редактирование категории статей

Категории имеют следующие характеристики.

Статистика

Статистика

Настройки

Настройки

Шаблонные теги

Для работы с модулем «Статьи» служат следующие шаблонные теги:

show_block – выводит последние статьи на всех страницах, кроме страницы статей, когда выводится список тех же статей, что и в функции.

Атрибуты:

count – количество выводимых статей (по умолчанию 3);

site_id – страницы, к которым прикреплен модуль. Идентификаторы страниц перечисляются через запятую. Можно указать отрицательное значение, тогда будут исключены статьи из указанного раздела. По умолчанию выбираются все страницы;

cat_id – категории статей, если в настройках модуля отмечено «Использовать категории». Идентификаторы категорий перечисляются через запятую. Можно указать отрицательное значение, тогда будут исключены статьи из указанной категории. Можно указать значение current, тогда будут показаны статьи из текущей (открытой) категории или из всех категорий, если ни одна категория не открыта. По умолчанию категория не учитывается, выводятся все статьи;

sort – сортировка статей: по умолчанию как на странице модуля, date – по дате, rand – в случайном порядке, keywords – статьи, похожие по названию для текущей страницы (должен быть подключен модуль «Поиск по сайту» и проиндексированы статьи);

images – количество изображений, прикрепленных к статье;

images_variation – тег размера изображений, задается в настроках модуля;

only_module – выводить блок только на странице, к которой прикреплен модуль «Статьи»: true – выводить блок только на странице модуля, по умолчанию блок будет выводиться на всех страницах;

tag – тег, прикрепленный к статьям;

defer – маркер отложенной загрузки шаблонного тега: event – загрузка контента только по желанию пользователя при нажатии кнопки "Загрузить", emergence – загрузка контента только при появлении в окне браузера клиента, async – асинхронная (одновременная) загрузка контента совместно с контентом шаблонных тегов с тем же маркером, sync – синхронная (последовательная) загрузка контента совместно с контентом шаблонных тегов с тем же маркером, по умолчанию отложенная загрузка не используется, обычный вывод шаблонных тегов в коде страницы;

defer_title – текстовая строка, выводимая на месте появления загружаемого контента с помощью отложенной загрузки шаблонного тега;

template – шаблон тега (файл modules/clauses/views/clauses.view.show_block_template.php; по умолчанию шаблон modules/clauses/views/clauses.view.show_block.php).

Пример:

<insert name="show_block" module="clauses">

выведет 3 статьи сайта


<insert name="show_block" module="clauses" count="5" sort="date">

выведет 5 последних статей сайта


<insert name="show_block" module="clauses" count="1" cat_id="35">

выведет одну статью сайта, из раздела статей с id=35

В шаблоне тега можно получить значение любого атрибута через переменную $result["attributes"]["название атрибута"].

show_block_rel – на странице статьи выводит похожие статьи. По умолчанию связи между статьями являются односторонними, это можно изменить, отметив опцию «В блоке похожих статей связь двусторонняя» в настройках модуля.

Атрибуты:

count – количество выводимых статей (по умолчанию 3);

images – количество изображений, прикрепленных к статье;

images_variation – тег размера изображений, задается в настроках модуля;

defer – маркер отложенной загрузки шаблонного тега: event – загрузка контента только по желанию пользователя при нажатии кнопки "Загрузить", emergence – загрузка контента только при появлении в окне браузера клиента, async – асинхронная (одновременная) загрузка контента совместно с контентом шаблонных тегов с тем же маркером, sync – синхронная (последовательная) загрузка контента совместно с контентом шаблонных тегов с тем же маркером, по умолчанию отложенная загрузка не используется, обычный вывод шаблонных тегов в коде страницы;

defer_title – текстовая строка, выводимая на месте появления загружаемого контента с помощью отложенной загрузки шаблонного тега;

template – шаблон тега (файл modules/clauses/views/clauses.view.show_block_rel_template.php; по умолчанию шаблон modules/clauses/views/clauses.view.show_block_rel.php).

Формат даты задается в настройках модуля.

Пример:

<insert name="show_block_rel" module="clauses">

выведет 3 статьи, прикрепленные к текущей статье

В шаблоне тега можно получить значение любого атрибута через переменную $result["attributes"]["название атрибута"].

show_previous_next – выводит ссылки на предыдущую и последующую страницы.

Атрибуты:

defer – маркер отложенной загрузки шаблонного тега: event – загрузка контента только по желанию пользователя при нажатии кнопки "Загрузить", emergence – загрузка контента только при появлении в окне браузера клиента, async – асинхронная (одновременная) загрузка контента совместно с контентом шаблонных тегов с тем же маркером, sync – синхронная (последовательная) загрузка контента совместно с контентом шаблонных тегов с тем же маркером, по умолчанию отложенная загрузка не используется, обычный вывод шаблонных тегов в коде страницы;

defer_title – текстовая строка, выводимая на месте появления загружаемого контента с помощью отложенной загрузки шаблонного тега;

template – шаблон тега (файл modules/clauses/views/clauses.view.show_previous_next_template.php; по умолчанию шаблон modules/clauses/views/clauses.view.show_previous_next.php).

Пример:

<insert name="show_previous_next" module="clauses">

В шаблоне тега можно получить значение любого атрибута через переменную $result["attributes"]["название атрибута"].

База данных

{clauses} – Статьи

{clauses_category} – Категории статей

{clauses_category_parents} – Родительские связи категорий статей

{clauses_category_rel} – Связи статей и категорий

{clauses_counter} – Счетчик просмотров статей

{clauses_rel} – Связи похожих статей

Файлы

Модуль находится в папке modules/clauses и устроен классически.

  1. modules/clauses/admin/clauses.admin.php – редактирование статей;

  2. modules/clauses/admin/clauses.admin.category.php – редактирование категорий статей;

  3. modules/clauses/admin/clauses.admin.config.php – настройки модуля;

  4. modules/clauses/admin/clauses.admin.counter.php – статистика просмотров;

  5. modules/clauses/admin/clauses.admin.express.fields.element.php – описание импорта/экспорта записей базы данных;

  6. modules/clauses/admin/clauses.admin.menu.php – карта ссылок для модуля «Меню на сайте»;

  7. modules/clauses/clauses.php – контроллер;

  8. modules/clauses/clauses.express.export.php – экспорт данных;

  9. modules/clauses/clauses.express.import.php – импорт данных;

  10. modules/clauses/clauses.install.php – установка модуля;

  11. modules/clauses/clauses.model.php – модель;

  12. modules/clauses/clauses.rss.php – RSS лента статей;

  13. modules/clauses/clauses.search.php – настройки для поисковой индексации для модуля «Поиск»;

  14. modules/clauses/clauses.sitemap.php – карта ссылок для модуля «Карта сайта»;

  15. modules/clauses/views/clauses.view.first_page.php – шаблон первой страницы модуля, если в настройках модуля подключен параметр «Использовать категории»;

  16. modules/clauses/views/clauses.view.id.php – шаблон страницы статьи;

  17. modules/clauses/views/clauses.view.list.php – шаблон списка статей;

  18. modules/clauses/views/clauses.view.list_search.php – шаблон списка статей;

  19. modules/clauses/views/clauses.view.rows.php – шаблон элементов в списке статей;

  20. modules/clauses/views/clauses.view.rows_block.php – шаблон блока статей;

  21. modules/clauses/views/clauses.view.rows_block_rel.php – шаблон блока похожих статей;

  22. modules/clauses/views/clauses.view.rows_gall.php – шаблон блока статей;

  23. modules/clauses/views/clauses.view.show_block.php – шаблон блока статей;

  24. modules/clauses/views/clauses.view.show_block_gall.php – шаблон блока статей;

  25. modules/clauses/views/clauses.view.show_block_rel.php – шаблон блока похожих статей;

  26. modules/clauses/views/clauses.view.show_previous_next.php – шаблон ссылок на предыдущую и следующую страницы сайта.

Дополнения

База знаний

Ваши комментарии и дополнения
11 августа 2016 г.
по дефолту count = 3, а если мне надо вывести все что есть и я за ранее не знаю сколько там может быть статей, как быть?
12 августа 2016 г.
Как вывести полное дерево категорий со статьями?
13 августа 2016 г.
На главной модуля выводяться категории первого уровня + вложенные в них статьи + вложенные в них категории. Количество категорий, вложенных категорий и вложенных статей определяется настройками.
Если нужно больше вложенностей, то нужно кастомизировать под себя функцию first_page() в modules/clauses/clauses.model.php и шаблон modules/clauses/views/clauses.view.first_page.php.

Зарегистрируйтесь или авторизируйтесь для того, чтобы оставить комментарий.