Контакты | E-mail: info@modx-evo.ru | Заказать обратный звонок



Урок 11 – Новостная лента

В прошлом уроке мы реализовали поиск по сайту и познакомились с еще одним сниппетом AjaxSearch. В рамках данного урока мы познакомимся еще с одним сниппетом MODx – Ditto.

Сниппет MODx Ditto служит для выборки и вывода групп ресурсов на странице. С помощью него чаще всего реализуют:

Давайте приступим к созданию нашей новостной ленты. Откроем наш ресурс «Новости» для редактирования и в настройках ресурса уберем галочку «Кэшируемый» и «Использовать HTML-редактор».

modx ditto

Отключение кэша нам необходимо для корректного отображения списка наших новостей и корректной работы паджинации.

Редактор мы отключили для того, чтобы в область содержимого ресурса вставить вызов сниппета Ditto, и при сохранении ресурса редактор не заменил специальные символы.

Теперь вставьте в содержимое ресурса следующие строки:

[ [Ditto? &tpl=`article-tpl` &display=`10` &paginate=`1`]]

[ +previous+] [ +pages+] [ +next+]

Эти строки представляют собой вызов сниппета Ditto с параметрами:

&tpl=`article-tpl` – это чанк, который используется в качестве шаблона представления анонса новости;

&display=`10` - это количество выводимых новостей на одной странице;

&paginate=`1` - означает, что для страницы новостей будет использоваться паджинация.

[ +previous+], [ +pages+], [ +next+] – плейсхолдеры для вывода паджинации.

Теперь как вы поняли нам нужно создать наш чанк «article-tpl», переходим «Элементы»- «Управление элементами»- «Чанки», создаем наш чанк и пропишем в его содержимое следующую информацию:

modx evo ditto параметры

Отлично мы создали новостную ленту. Теперь давайте создадим несколько пробных новостей и посмотрим, как они у нас отображаются на нашей странице. Для этого кликаем на ресурс новости правой кнопкой мыши и в выпадающем меню выбираем «Добавить дочерний ресурс»:

ditto параметры

Создаем несколько ресурсов, не забываем выставлять флаг «Публиковать», иначе наши ресурсы не отобразятся. Также заполняем поле «Аннотация», поскольку оно у нас используется в чанке 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 параметры.


Просмотров: 3397


Статьи по теме:


Написать комментарий

Поля помеченные * обязательны для заполнения.


flokinOl
Постов: 1
Comment
Супер
Добавлен #1 на : Пт. Май 01, 2015, 04:46:16
Классная статья
Отредактирован: Июль 02, 2015, 12:06:57 admin  

Будь в курсе!

Введите Ваш Email и имя.

Digital Newsletter

Чтобы отписаться нажмите сюда ».