Статьи

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

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

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

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

Категории

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

Если перед названием категории имеется знак +, то этой категории принадлежат подкатегории. Добавить подкатегорию к категории можно, нажав на знак рядом с названием категории.

Порядок отображения категорий можно редактировать с помощью кнопок .

Кнопка служит для удаления категории. Кнопка служит для быстрой публикации категории (или, наоборот, блокирования). При удалении категории удаляются все вложенные подкатегории и статьи.

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

Основные:

  • Название;

  • Показывать на сайте;

  • Показывать в меню – добавляет ссылку в меню согласно структуре сайта. Подробнее смотрите в разделе модуль «Меню на сайте»;
  • Анонс – краткое описание категории, для публикации в списке;

  • Описание – описание категории.

Дополнительные:

  • Номер – номер категории;

  • Время последнего изменения – выводится в заголовке Last modify;

  • Заголовок окна в браузере, тэг Title – если не заполнен, тег title будет автоматически сформирован из Названия категории - Названия раздела - Названия сайта;

  • Ключевые слова, тэг Keywords – ключевые слова для мета-тега «keywords», используется для поисковой оптимизации;

  • Описание, тэг Description – описание для мета-тега «description», используется для поисковой оптимизации;

  • Псевдоссылка – ссылка на страницу категории будет генерироваться следующим образом: http://www.site.ru/псевдоссылка/. Если псевдоссылка не указана адрес страницы будет: http://www.site.ru/псевдоссылка_страницы/catНомер_категории/. При добавлении псевдоссылки к ней автоматически прикрепляется псевдоссылка страницы. При редактировании можно это исправить;

  • Вложенность: принадлежит – категория верхнего уровня;

  • Раздел сайта – принадлежность к странице сайта;

  • Сортировка: установить перед – редактирование порядка отображения пункта. Поле доступно для редактирования только для элементов, отображаемых на сайте;

  • Не показывать на карте сайта – скрывает отображение ссылки на категорию в файле sitemap.xml и модуле «Карта сайта».

Если в конфигурации модуля включен параметр «Показывать комментарии к категориям», то при редактировании категории будет отображена активная ссылка на комментарии к категории или надпись «Комментариев нет» при их отсутствии.

Статьи

В списке статьи выводятся с сортировкой по важности и новизне.

Кнопка служит для удаления статьи. Кнопка служит для быстрой публикации статьи (или, наоборот, блокирования).

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

Основные:

  • Название;

  • Дата – статьи, старше текущей даты начнут отображаться на сайте, начиная с указанной даты;

  • Изображения – возможность загрузки нескольких изображений, если в конфигурации модуля включен параметр «Использовать изображения». Изображение загружаются в двух вариантах: маленьком (предпросмотр) и большом (увеличенная версия). Также для отражения в административной части сайта генерируются дополнительные изображения (50х50, качество 70). Качество и размер загружаемых изображений для пользовательской части сайта указываются в настройках модуля;

  • Показывать на сайте – публикация на сайте, активность;

  • Категория – помимо основной можно указать дополнительные категории;
  • Анонс – краткое содержание статьи, для публикации в списке;

  • Описание – содержание статьи.

Дополнительные:

  • Показывать в меню – добавляет ссылку в меню согласно структуре сайта. Подробнее смотрите в разделе модуль «Меню на сайте»;
  • Номер – номер статьи;

  • Время последнего изменения – выводится в заголовке Last modify;

  • Заголовок окна в браузере, тэг Title – если не заполнен, тег title будет автоматически сформирован из Названия страницы - Названия раздела - Названия сайта;

  • Ключевые слова, тэг Keywords – ключевые слова для мета-тега «keywords», используется для поисковой оптимизации;

  • Описание, тэг Description – описание для мета-тега «description», используется для поисковой оптимизации;

  • Псевдоссылка – ссылка на страницу статьи будет генерироваться следующим образом: http://www.site.ru/псевдоссылка/. Если псевдоссылка не указана адрес страницы будет: http://www.site.ru/псевдоссылка_страницы/catНомер_категории/showНомер_статьи/. При добавлении псевдоссылки к ней автоматически прикрепляется псевдоссылка страницы и категории статьи. При редактировании можно это исправить;

  • Раздел сайта – принадлежность к странице сайта;

  • Важно (всегда сверху) – статья будет всегда сверху в списке всех статей, независимо от даты;

  • Не показывать на карте сайта – скрывает отображение ссылки на статью в файле sitemap.xml.

Если в конфигурации модуля включен параметр «Показывать комментарии к статьям», то при редактировании статьи будет отображена активная ссылка на комментарии к статье или надпись «Комментариев нет» при их отсутствии.

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

Если в конфигурации модуля включен параметр «Подключить теги», то при редактировании статьи появится возможность редактирования тегов, прикрепленных к статье.

Настройки

Можно сохранять разные конфигурации модуля для разных страниц, к которым прикреплен модуль.

Использовать категории – параметр позволяет включить/отключить категории статей.

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

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

Показывать статьи подкатегорий – этот параметр позволяет показывать в категории верхнего уровня не только статьи, принадлежащие текущей категории, но и статьи подкатегорий, принадлежащих данной категории.

Использовать изображения – параметр позволяет включить/отключить загрузку изображений к статье.

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

Размер маленького изображения – размер изображения предпросмотра.

Отображение изображений в списке статей – параметр принимает значения:

  • нет (отключает отображение изображений в списке);
  • показывать одно изображение;
  • показывать все изображения.

Использовать изображения для категории – параметр позволяет включить/отключить загрузку изображений для категорий.

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

Размер маленького изображения для категории – размер изображения предпросмотра.

Отображение изображений категорий в списке категорий – параметр принимает значения:

  • нет (отключает отображение изображений в списке);
  • показывать одно изображение;
  • показывать все изображения.

Использовать анимацию при увеличении изображений – параметр добавляет JavaScript код, позволяющий включить анимацию при увеличении изображений.

Максимальный объем загружаемых файлов – параметр показывает максимально допустимый объем загружаемых файлов, установленный в настройках хостинга.

Накладывать водяной знак – параметр позволяет включить/отключить наложение водяного знака на изображение.

Расположение водяного знак – расположение водяного знака в пикселях от левого края или от центра и от нижнего края или от центра.

Использовать водяной знак только для большого изображения – отключает наложение водяного знака на изображение предпросмотра.

Применить настройки ко всем ранее загруженным изображениям – позволяет переконвертировать размер уже загруженных изображений. Размер вновь созданных изображений не может быть больше размера большой копии уже загруженного изображения.

Формат даты – позволяет настроить отображение даты в модуле.

Показывать комментарии к статьям – подключение модуля «Комментарии». Параметр не будет включен, если модуль «Комментарии» не установлен. Подробности см. в разделе «Модуль Комментарии».

Показывать комментарии к категориям – подключение модуля «Комментарии» к категориям статей. Параметр не будет включен, если модуль «Комментарии» не установлен. Подробности см. в разделе «Модуль Комментарии».

Подключить теги – подключение модуля «Теги» к модулю «Статьи». Параметр не будет включен, если модуль «Теги» не установлен. Подробности см. в разделе «Модуль Теги».

Показывать рейтинг статей – подключение модуля «Рейтинг». Параметр не будет включен, если модуль «Рейтинг» не установлен. Подробности см. в разделе «Модуль Рейтинг»

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

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

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

Атрибуты:

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

site_id – страница, к которой прикреплен модуль, по умолчанию выбирается одна страница;

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

images – количество фотографий, прикрепленных к статьям;

sort – сортировка статей (rand – в случайном порядке, date – по дате). По умолчанию статьи сортируются по дате;

template – шаблон тега (функция в файле modules/clauses/clauses.view.php должна называться show_block_template; по умолчанию шаблон show_block).

Формат даты задается в конфигурации модуля.

Пример:

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

выведет 3 последние статьи сайта


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

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


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

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

Оформление блока в функции show_block в файле modules/clauses/clauses.view.php.

CSS-форматирование

Общие стили:

.clauses_name{} – название статьи

.clauses_date{} – дата статьи

.clauses_anons{} – анонс статьи

.clauses_text{} – текст статьи

.clauses_img{} – изображение, прикрепленное к статье

.clauses_all_img{} – все изображения, прикрепленные к статье

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

.clauses_list{} – список статей

.clauses_list .clauses{} – статья в списке

.clauses_list .clauses_name{} – название статьи

.clauses_list .clauses_img{} – изображение, прикрепленное к статье

.clauses_list .clauses_date{} – дата статьи

.clauses_list .clauses_anons{} – анонс статьи

.clauses_list .clauses_cat_anons{} – краткое описание категории статей

.clauses_list .clauses_cat_text{} – полное описание категории статей

.clauses_list .clauses_cat_img{} – изображение, прикрепленное к категории статей

.clauses_list .clauses_cat_all_img{} – все изображения, прикрепленные к категории статей

.clauses_list .clauses_cat_link{} – ссылка на вложенную категорию статей

.clauses_list .show_all{} – ссылка на все статьи в категории

.clauses_list .previous_next_links{} – ссылки на предыдущую, следующую категории

.clauses_list .previous_link{} – ссылка на предыдущую категорию

.clauses_list .next_link{} – ссылка на следующую категорию

Страница статьи:

.clauses_id{} – страница статьи

.clauses_id .clauses_date{} – дата статьи

.clauses_id .clauses_anons{} – анонс статьи

.clauses_id .clauses_text{} – текст статьи

.clauses_id .clauses_all_img{} – все изображения, прикрепленные к статье

.clauses_id .show_all{} – ссылка на все статьи

.clauses_id .previous_next_links{} – ссылки на предыдущую, следующую статью

.clauses_id .previous_link{} – ссылка на предыдущую статью

.clauses_id .next_link{} – ссылка на следующую статью

Шаблонная функция show_block:

.clauses_block{} – блок статей

.clauses_block h2{} – заголовок

.clauses_block .clauses{} – статья в блоке

.clauses_block .clauses_name{} – название статьи

.clauses_block .clauses_img{} – изображение статьи

.clauses_block .clauses_date{} – дата статьи

.clauses_block .clauses_anons{} – анонс статьи

.clauses_block .show_all{} – ссылка на все статьи

Файлы

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

  2. modules/clauses/clauses.model.php – формирование данных для страницы модуля;

  3. modules/clauses/clauses.view.php – шаблон модуля;

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

  5. modules/clauses/clauses.sitemap.php – карта модуля для файла sitemap.xml;

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

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

  8. modules/clauses/admin/clauses.admin.config.php – конфигурация модуля;

  9. modules/clauses/admin/clauses.admin.menu.php – формирование списка статей и категорий статей в административной части модуля «Меню».



Не понятно? Уточните