vjikSimpleNews - Модуль простых новостей для MODx

Пятница, 16 июля 2010 г.

Модуль простых новостей для MODx.
Работа с новостями производится на отдельной странице модуля. Новость состоит из 2х частей: дата и собственно сама новость. Отдельная страница для каждой новости не предусмотрена.

Установка

  • Скопируйте папку vjikSimpleNews в папку assets/modules.
  • Создайте новый модуль (Модуль - Управление модулями - Новый модуль).
    • Название модуля - vjikSimpleNews
    • Описание - <b>0.2.1</b> Модуль простых новостей
    • Код модуля скопируйте из файла module.vjikSimpleNews.tpl
  • Создайте новый сниппет (Элементы - Управление элементами - Сниппеты - Новый сниппет)
    • Название сниппета - vjikSimpleNews
    • Описание - Вывод новостей из модуля vjikSimpleNews
    • Код сниппета скопируйте из файла snippet.vjikSimpleNews.tpl

Обновление

  • Удалите старую папку vjikSimpleNews в assets/modules.
  • Скопируйте папку vjikSimpleNews из архива в папку assets/modules.
  • Обновите модуль (Модуль - Управление модулями - vjikSimpleNews).
    • Описание - <b>0.2.1</b> Модуль простых новостей
    • Код модуля скопируйте из файла module.vjikSimpleNews.tpl
  • Обновите сниппет (Элементы - Управление элементами - Сниппеты - vjikSimpleNews)
    • Код сниппета скопируйте из файла snippet.vjikSimpleNews.tpl

Работа с модулем

Добавление, редактирование и удаление новостей осуществляется на странице модуля (Модули - vjikSimpleNews).

Для вывода новостей на сайте используйте некэшируемый вызов сниппета vjikSimpleNews. Простейший пример: [!vjikSimpleNews!].

При использовании пагинации во время вывода новостей задается плейсхолдер vjikSimpleNews.pagination, содержащий блок со ссылками на страницы.

Параметры сниппета

count - количество выводимых новостей. Если 0 - выводятся все новости. По-умолчанию - 0.

tpl - шаблон для вывода новости (чанк). Поддерживаются следующие плейсхолдеры:

  • [+vjikSimpleNews.id+] - ID новости,
  • [+vjikSimpleNews.date+] - дата новости,
  • [+vjikSimpleNews.body+] - текст новости.

dateFormat - формат даты, которое выводится с помощью плейсхолдера. Значения: Любой валидный формат времени, который соответствует правилам функции PHP - strftime.

paginate - пагинация (0 - выключена, 1 - включена). По-умолчанию - 0.

display - количество новостей на странице. По-умолчанию - 12.

tplPagination - шаблон для пагинации (чанк). Поддерживаются следующие плейсхолдеры:

  • [+pagination.total+] - количество страниц,
  • [+pagination.items+] - список ссылок на страницы.

tplPaginationItem - шаблон для вывода ссылки на страницу (чанк). Поддерживаются следующие плейсхолдеры:

  • [+pagination.item.url+] - ссылка,
  • [+pagination.item.page+] - номер страницы.

tplPaginationCurrent - шаблон для вывода текущей страницы (чанк). Поддерживаются следующие плейсхолдеры:

  • [+pagination.item.url+] - ссылка,
  • [+pagination.item.page+] - номер страницы.

Скачать

Текущая версия: 0.2.1 (от 21 сентября 2010 года). Протестирована работа с MODx 1.0.4.

Скачать vjikSimpleNews 0.2.1 49 (vjiksimplenews0.2.1.zip, ~10,4kb)