Статьи

• Статьи
• Категории
• Статистика
• Настройки
• Шаблонные теги
• База данных
• Файлы
• База знаний
• Дополнения

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

Модуль относится к части 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).

В шаблоне тега можно получить значение любого атрибута через переменную $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).

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

В шаблоне тега можно получить значение любого атрибута через переменную $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).

В шаблоне тега можно получить значение любого атрибута через переменную $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 – шаблон ссылок на предыдущую и следующую страницы сайта.

Дополнения

База знаний