Урок 11 – Новостная лента
В прошлом уроке мы реализовали поиск по сайту и познакомились с еще одним сниппетом AjaxSearch. В рамках данного урока мы познакомимся еще с одним сниппетом MODx – Ditto.
Сниппет MODx Ditto служит для выборки и вывода групп ресурсов на странице. С помощью него чаще всего реализуют:
- Новостные ленты на сайте;
- Вывод дополнительных статей;
- Галереи изображений;
- RSS ленты;
- XML карты сайта;
- Многое другое, до чего дойдет фантазия.
Давайте приступим к созданию нашей новостной ленты. Откроем наш ресурс «Новости» для редактирования и в настройках ресурса уберем галочку «Кэшируемый» и «Использовать HTML-редактор».
Отключение кэша нам необходимо для корректного отображения списка наших новостей и корректной работы паджинации.
Редактор мы отключили для того, чтобы в область содержимого ресурса вставить вызов сниппета Ditto, и при сохранении ресурса редактор не заменил специальные символы.
Теперь вставьте в содержимое ресурса следующие строки:
[ [Ditto? &tpl=`article-tpl` &display=`10` &paginate=`1`]]
Эти строки представляют собой вызов сниппета Ditto с параметрами:
&tpl=`article-tpl` – это чанк, который используется в качестве шаблона представления анонса новости;
&display=`10` - это количество выводимых новостей на одной странице;
&paginate=`1` - означает, что для страницы новостей будет использоваться паджинация.
[ +previous+], [ +pages+], [ +next+] – плейсхолдеры для вывода паджинации.
Теперь как вы поняли нам нужно создать наш чанк «article-tpl», переходим «Элементы»- «Управление элементами»- «Чанки», создаем наш чанк и пропишем в его содержимое следующую информацию:
Отлично мы создали новостную ленту. Теперь давайте создадим несколько пробных новостей и посмотрим, как они у нас отображаются на нашей странице. Для этого кликаем на ресурс новости правой кнопкой мыши и в выпадающем меню выбираем «Добавить дочерний ресурс»:
Создаем несколько ресурсов, не забываем выставлять флаг «Публиковать», иначе наши ресурсы не отобразятся. Также заполняем поле «Аннотация», поскольку оно у нас используется в чанке article-tpl для вывода краткого описания новости.
Открываем наш браузер, заходим на сайт и переходим на страницу новостей, в итоге мы видим, что новости выводятся, однако довольно криво и не соответствуют общему стилю нашего сайта.
Для того, чтобы наши новости выводились красиво нам нужно прописать стили все в том же файле стилей layout.css. Открываем и прописываем следующее:
#article{padding:10px;margin:0 0 10px 0;border:1px solid #cecece;}
На самом деле вы можете прописывать любые стили, какие вам нравятся. Сохраняем и смотрим, что у нас получилось. У нас появились границы новости и отступы между новостями.
MODx Evo Ditto параметры
Рассмотрим параметры Ditto:
&display – количество отображаемых ресурсов;
&depth – глубина вложенности ресурсов для вывода;
&documents – список ID ресурсов для вывода;
&filter – фильтр для выборки документов;
&keywords – использование выборки по ключевым словам;
&noResults – сообщение, которое выводится если нет результатов;
&orderBy – порядок сортировки;
&parents – ID ресурсов, из которых будет проводиться выборка;
&randomize – рандомный выбор ресурсов;
&showInMenuOnly – только ресурсы, отображаемые в меню;
&showPublishedOnly – только опубликованные ресурсы;
&start – пропустить начальные ресурсы;
&total – количество возвращаемых документов;
Варианты шаблонов для Ditto:
&tpl – шаблон для записи ditto;
&tplAlt – шаблон для четных документов (удобно, если у вас выводятся документы в 2-е колонки с разными классами стилей);
&tplCurrent – Шаблон текущего документа;
&tplFirts – Шаблон для первого документа;
&tplLast – шаблон для последнего документа;
Параметры для паджинации:
&paginate – отображать/не отображать паджинацию;
&paginateSplitterCharacter – задает разделитель;
&tplPaginateCurrentPage – шаблон для ссылке текущей страницы;
&tplPaginateNext – шаблон для ссылки «Следующая»;
&tplPaginatePrevious – шаблон для ссылки «Предыдущая»;
&tplPaginatePage – шаблон для ссылок страниц.
Мы рассмотрели наиболее популярные и часто используемые параметры и шаблоны сниппета Ditto, на самом деле их значительно больше. Найти описание всех параметров и плейсхолдеров сниппета можно в официальной документации. На этом урок окончен, в следующем уроке мы познакомимся с еще одним термином MODx – TV параметры.
Постов: 1
Добавлен #1 на : Пт мая 01, 2015, 04:46:16