О том, как создать ленту новостей с сортировкой по дате, введенной пользователем и пойдет речь.

Для этого нам потребуется модуль Ditto не ниже 2-ой версии (в нем есть параметры, которые отсутствовали в более ранних версиях).

Шаблон для новостей

Создадим шаблон для вывода подробной новости и присоединим к этому шаблону Template Variable.

Ресурсы -> Управление ресурсами-> Вкладка «Шаблоны»->Новый шаблон

По содержанию шаблон будет мало отличаться от шаблона внутренних страниц. Все зависит от желаемого отображения подробной новости.

У меня в шаблоне  место под подробную новость (контент) выглядит так:

1
2
3
4
5
6
7
8

<h2>Новости</h2>
<h5>[*pagetitle*]</h5>
<span><strong>[[convertDate?MyDate=`[*tvdate*]`]]</strong></span>
<div class="content_news">
[*#content*]
<br /><br />
<a href="../">Назад к списку новостей</a>
</div>

Пусть шаблон будет называться «Новости». Просто и понятно, а про сниппет convertDate поговорим чуть позже.

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

Template Variable для даты новости

Переходим:

Ресурсы -> Управление ресурсами-> Вкладка «Параметры (TV)»->Новый параметр (TV)

В имени параметра обязательно вводим название date, заголовок заполняем по своему вкусу, тип ввода ставим Date (При выборе даты будет отображаться удобное всплывающее окошко для работы с датой), визуальный компонент обязательно ставим Unixtime (по нему мы и будем сортировать в дальнейшем).

Создание папки для хранения новостей

Создадим документ-каталог, в котором будем хранить наши новости:

Осталось последнее действие в этой части, а именно вывод списка новостей. В месте для контента вводим вызов Ditto следующего содержания.

[[Ditto? &startID=`18` &tpl=`news_list` &sortDir=`DESC` &summarize=`20` &sortBy=`date` ]]

startID  - номер документа, откуда будем брать новости (у нас папка «Новости»)

tpl – название чанка для вывода одной новости

sortDir – сортировка по убыванию или возрастанию (у нас по убыванию)

summarize – количество новостей, выводимых на странице

sortBy – сортируем по нашему TV date

Создание новостей

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

В новом созданном документе применим следующие манипуляции:

1. В поле «Заголовок» вводим название новости
2. В поле «Аннотация» вводим краткое содержание новости
3. в поле «Шаблон» выбираем наш шаблон для новостей «Новости»
4. В содержании документа вводим саму новость. Можно добавлять изображения и всячески оформлять в соответствии со стилями сайта.
5. В дополнительном поле дату новости через кнопку   Как раз по этому полю и будем сортировать наши новости в списке.
6. Сохраняем наши изменения

По такому алгоритму и будем и создавать все наши новости. Естественно, не будем забывать, наши новости еще нужно и опубликовывать. Либо при нажатии правой кнопкой мыши на иконку рядом с новостью и выбрав в контекстном меню пункт «Опубликовать», либо при редактировании на вкладке «Настройки страницы» задать время публикации (и время снятия с публикации, если это Вам необходимо).

Создание чанка вывода одной новости в списке

Все зависит от верстки вашего сайта, а я приведу пример своего чанка.

Переходим в раздел Ресурсы -> Управление Ресурсами -> Чанки -> Новый чанк

Даем название чанку, к примеру, news_tpl

Содержание у меня такое:

1
2
3
4

<div>
<span class=”news_title”><a href="/[~[+id+]~]">[+pagetitle+]</a></span><span class=”news_date”> [[convertDate?MyDate=`[+tvdate+]`]]</span><br />
<p>[+introtext+]</p>
</div>

Наибольший интерес здесь, конечно же, представляет строчка [[convertDate?MyDate=`[+tvdate+]`]] . В ней мы вызываем специально написанный сниппет для конвертации даты в более читабельный вид. Параметром MyDate передаем текущую дату новости в списке новостей.

Создание сниппета для новости

Идем Ресурсы –> Управление Ресурсами –> Сниппеты –> Новый Сниппет

Назовем сниппет convertDate и содержание у него такое:

1
2
3
4
5
6
7

<?php
$monthes = array('','января','февраля','марта','апреля','мая','июня','июля','августа','сентября','октября','ноября','декабря');
$day = date("j",$MyDate);
$month = $monthes[date("n",$MyDate)];
$year = date("Y",$MyDate);
echo $day.' '.$month.' '.$year.' года';
?>

Простейший PHP-код по преобразованию даты. Создаем массив названий месяцев в родительном падеже, пропуская при этом нулевой элемент. Далее просто выводим дату в виде строки.

Выглядеть это будет примерно так.

Вот и всё. Список новостей готов. Сюда также можно добавить добавление новостей из разных папок. (если у вас идет деление новостей по разделам), добавив в параметр startID через запятую ID документов-папок с новостями.

Еще можно, а чаще всего даже нужно, создать переход по страницам для вывода новостей, но об этом уже в другой раз.

Ранее это статья публиковалась на хабре и сайте русского сообщества CMS MODx.

Рассмотрим не полный, но конкретный пример для одного из последних сайтов, который я сделал своим друзьям группе Танго и Кэш. Под не полным я имею ввиду, что не буду показывать исходного кода самих страниц. А реализовывать мы будем счетчик скачиваний для музыки, видео и всего остального, что только захотим посчитать.

Сразу скажу что пример буду показывать на примере MODx 0.9.6.3, но аналогичные действия позволят Вам создать собственные страницы и на последней версии CMS.

Для начала создадим файл-экшн который будет отображаться при открытии страницы в админке. Для этого в директории manager/actions/ cоздадим свой файл с названием download.counter.php. В отличии от многих фреймворков здесь не имеет значения как будет называться файл, поэтому, при желании, можно сделать название любым. Поместим в этот файл следующий код:

1
2
3
4

<?php
if(IN_MANAGER_MODE!="true") die("<b>INCLUDE_ORDERING_ERROR</b><br /><br />Please use the MODx Content Manager instead of accessing this file directly.");
$base = MODX_SITE_URL;
?>

Это стандартное начало практически всех экшенов в MODx. После третьей строчки кода можно уже добавлять свой содержание, но об этом позже.

Теперь нам нужно добавить информарцию о новом экшене в меню, для этого необходимо в файле manager/index.php добавить свой case-обработчик и придумать нашей странице идентификатор. Выбирать идентификатор можно любой не занятый, но если Вы планируете в будущем обновлять свою версию MODx, то лучше заведомо взять очень большое число.

Пример кода manager/index.php

914
915
916
917

case 666:
 //download counter
 include_once "actions/download.counter.php";
 break;

Как видите, я взял достаточно красивый и запоминающийся идентификатор для своего экшена 666

Следующий шаг наших действий – добавить название кнопки в словарь. В зависимости от того, на каком языке у Вас работает сайт и админка MODx, необходимо добавить новый элемент в массив $_lang. Я всегда использую вариант Russian-UTF8 и править буду соответсвующий файл manager/includes/lang/russian-UTF8.inc.php. Добавлю в него упоминание о моей кнопке:

1008

$_lang['counter'] = 'Счетчик скачиваний';

Именно этот текст будет на кнопке в панели управления.

Теперь осталось только добавить саму кнопку на панель, делается это в файле manager/frames/menu.php. В зависимости от того, в какой раздел Вы хотите поместить кнопку, нужно будет добавить код в соответствующий участок кода. Я добавил кнопку в главный раздел «Сайт» в самый конец:

246

$sitemenu[] = '<li><a onclick="this.blur();" href="index.php?a=666" target="main">'.$_lang['counter'].'</a></li>';

Вот и всё. Как видите, в атрибуте href мы задаем параметр ?a=666, где число и есть идентификатор экшена, который мы указали в файле manager/index.php. После обновления страницы в админке Вы увидите свою кнопку.

Таким способом можно создавать сколько угодно страниц и расширять бесконечно функциональность админки, все зависит от Ваших потребностей и навыков программирования.

Если есть у читателей интерес, я могу написать про то, как создавался счетчик скачиваний для сайта Танго и Кэш и как он работает.