Как вывести контент в ModX Revolution с помощью GetResources

getResources это сниппет MODX Revolution, который извлекает содержимое полей из других ресурсов и выводит его в любом удобном для вас виде. Если вы знакомы MODX Evolution, getResources может считаться заменой Ditto.

getResources отлично подходит для случаев, где вам необходимо объединить и вывести информацию от различных ресурсов в одном месте и в необходимом формате. Наиболее очевидным применением сниппета getResources будет создание основной блоговой страницы сайта, другие возможные блоки использования - слайдеры, страница портфолио, новостная лента.

Ниже приведён список шагов описывающих процесс использования сниппета getResources. После того, как вы привыкните к его использованию, большинство описанных шагов будут происходить интуитивно, но так как вы только начинаете, то хорошо иметь под рукой некоторое подобие плана действий. Вот один описанный мною:

• Для начала установите сниппет getResources
• Далее необходимо решить как структурировать страницы, контент которых мы собираемся вывести и какой будет шаблон вывода страниц. Всё будет отличаться в зависимости от структуры вашего сайта и целей. Вы можете выводить отдельные страницы на вашем дереве сайтов либо размещать дочерние страницы в контейнере и использовать ИД контейнера, чтобы их вывести и др.
• Определиться какие поля будут показаны на выведенной странице. Вы можете, например, показать только список заголовков на вашем сайдбаре или показать только заголовок страницы и содержание, либо показать несколько полей и переменных шаблона, и т.д.
• Если у вас еще нет шаблона, то создайте шаблон для вашей странице вывода контента.
• Сделайте простой вызов getResources чтобы убедиться в том, что контент извлекается и выводится.
• Создайте чанк-шаблон для вывода полей, которые вы будете показывать на вашей странице.
• Добавьте нужные параметры в вызове сниппета getResources

Я уже установил getResources и мы будем его использовать для создания страницы статьи. Мы будем использовать для шаблона страницы блога шаблон 7 in 1 Business Success Site студии Themeforest. Страница блога (частично) будет выглядеть следующим образом:

Как видите, у нас есть страница с несколькими компонентами – заголовок, изображение, дата публикации, изображение и отрывок содержания со ссылкой “читать остальную часть записи” к целому посту. Этот шаблон мы будем использовать для объединённого вывода наших статей.

После установки сниппета getResources, смотрим на оформить стуктуру страниц отдельного вывода статей. Для этого я буду использовать шаблон отдельного поста нашей темы, который я взял из файла single.html. Я уже портировал данный шаблон в свой шаблон и назвал его “7in1 Single Article”. Вот как мой “7in1 Single Article” шаблон будет выглядеть:

Вы узнаете чанки шапки и подвала, мы уже их использовали, я добавил всего лишь два дополнительных чанка, один для содержимого сайдбара (7in1-articles-sidebar ) и одного временного чанка (articleCommentStuff_temp ) для секции комментирования, чтобы не нагромождать все элементы. В данный момент эти два чанка содержат статический контент нашего шаблона, но в следующий уроках мы сделаем их динамичными. Так же я добавил две дополнительных переменных шаблона, одну для вывода текста в теге изображения (article_image_title ) и другую для самого изображения (article_image – <тип ввода – изображение, тип вывода – текст>). Также я добавил другие поля, такие как ИД поста, урлы и др. многое из этого должно быть вам понятно из предыдущих уроков.

Последним моментом, на который я хотел обратить ваше внимание - вывод поля даты. Он производится через publishedon используя при этом функцию PHP strtotime для показа даты в необходимом виде (как в шаблоне нашей темы). Более детально про функцию strtotime и форматирование дат - в конце этого поста ссылки.

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

Отлично, теперь у нас есть шаблон для отдельных страниц и можно двигаться дальше. Создадим несколько статей для нашего сайта, используя этот шаблон, таким образом мы сможем проверить наш вызов getResources. В моём случае я создал контейнер Articles и установил шаблон для него Base Template. который я поменяю позже, когда буду готов выводить объединённый контент. Всередине я размещу парочку контейнеров для каждой категории или темы, которую покрывают мои статьи… например – новости, MODX уроки и др.

Размышляя об этом, я понимаю, что не хочу, чтобы мои статьи выводились в меню, также я хочу, чтобы они все использовали шаблон 7in1 Single Article. В рассуждениях о том, как же лучше сделать легче мою работу или работу клиента, я решил, что так как большинство новых ресурсов будут статьями, то есть здравый смысл в том, чтобы сделать соответствующими настройки по умолчанию для типа содержимого. Другими словами, сделайте все новые ресурсы с этого момента по умолчанию использующими шаблон 7in1 Single Article. а также они должны быть скрытыми от меню. Конечно же, можно отредактировать один за одним все ресурсы и это не будет проблемой, так как остальные мои страницы уже созданы и большинство новых ресурсов буду статьями. Итак, чтобы сделать это, идём System->System Settings. далее фильтр « area» и выбираем “Site”. Нужные настройки – Default Template. Hide from Menus Default.

После внесения изменений наблюдаем такую картину:

Теперь, при создании нового ресурса, он берёт шаблон отдельной статьи по умолчанию и уже поставлена галочка в Скрыть от меню (Hide From Menus).

Заметка: Обратите внимание, что такое поведение будет в случае, когда документ создаётся в корне. Если же вы зайдёте в любой контейнер и нажмёте «Создать документ здесь» (Create a Document Here), то он возмёт шаблон контейнера и скроет от меню. Поэтому будьте внимательны к настройкам каждого ресурса.

Давайте продолжим и создадим около 8 простых статей для нашего сайта, чтобы сниппет мог их объединить и вывести getResources. Я беру сгенерированный текст отсюда http://www.malevole.com/mv/misc/text/ и произовальные картинки из Гугла. Позже при наличии времени я заменю этот текст другим необходимым, здесь же в целях обучения будет достаточно наличия любого текста и картинок. Вот как выглядит дерево моего сайта в данный момент:

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

Если вы используете тот же шаблон, что и я, то посмотрите на код и вы увидите, что он почти не отличается от кода для обычного шаблона, но без секции комментирования и других аналогичных элементов, поэтому можно использовать те же чанки и код, что мы использовали ранее. Вот как будет выглядеть шаблон 7in1 Aggregated Articles.

Теперь я использую данный шаблон для вывода содержимого ресурсов - дочерних элементов следующих контейнеров – контейнер Articles и каждого из контейнеров для категорий, в моём случае - MODX News. MODX Web Development , MODX Tips and Tricks и Other Stuff. Теперь одна из категорий будет выглядить приблизительно так:

Давайте перейдём к выводу нашего контента.

Перед тем, как мы начнём формировать вызов сниппета и работать с getResources, важно познакомится с несколькими вещами, которые могут легко ввести в заблуждение, если вы до этого не были знакомы с getResources и даже если вы знакомы. Я называю их мои getResources уловки!

• Вызов getResources по-умолчанию не содержит шаблона вывода. Вам необходим шаблон - tpl-чанк, чтобы определить вывод содержимого ресурса (ресурсов).
• getResources по-умолчанию не покажет ресурсы, которые скрыты от меню, поэтому вам необходимо задать &showHidden=`1`
• getResources по-умолчанию не включит поля содержимого ваших ресурсов, поэтому вам необходимо задать &includeContent=`1`
• В дополнение, если даже вы установите includeContent, сниппет getResources по-умолчанию не включит переменные шаблона, поэтому вам необходимо задать &includeTVs=`1` и &processTVs=`1`
• Если вы зададите includeTVs и processTVs, сниппет getResources будет ожидать, что в вашем шаблоне tpl, вы будете обозначать ваши переменные шаблона префиксом “tv.”. Вы можете перезаписать это добавив &tvPrefix=` ` и далее использовать только лишь имя переменной шаблона как заполнитель.
• Если вы выводите необходимые ресурсы через параметр &resources=`1,2,3`, где 1,2,3 - выводимые ресурсы, то не забудьте обязательно указать параметр &parents=`-1`

Есть еще много моментов, но это основные, в которых легко допустить ошибку.

Как и у всех других сниппетов, вызов getResources выглядит так:

Базовый вызов позволит вам убедиться в том, что сниппет работает на нашем сайте. Если я размещу данный вызов на странице Articles page я ничего не получу. Вы можете подумать, что происходит что-то неправильное, но этому есть простое объяснение. Помните наш список находок? По умолчанию getResources ожидает, что ваши ресурсы не будут скрыты от меню, поэтому если вы хотите показать скрытые ресурсы вам необходимо добавить параметр &showHidden и установить его значение в true. Поэтому отредактируйте ваш вызов:

Если я перегружу страницу, то вот что я получу:

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

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

При работе с tpl-чанком мы используем синтаксис заполнителя [[+field_name]] для динамических кусков.

Итак берём HTML код для вывода поста блога в статическом коде файла шаблона blog.html:

Мы можем использовать данный код как базу нашего tpl чанка. Я заменю статические куски заполнителями. Для короткого содержимого поста я не хочу извлекать содержимое поля Content ресурса, мне нужна лишь короткая выдержка. Поэтому я буду использовать поле аннотация (Introtext) ресурса и далее выводить его, используя конструкцию [[+introtext]] можно также использовать Переменную шаблона [[+tv.tvname]]. Для вывода также можно использовать содержимое ресурса - поле Content. Я могу взять, например, первые 350 символов каждой статьи и вывести. Чтобы это сделать прикрепляю фильтр вывода :ellipsis=350 к моему заполнителю контента.

Помните о том, что мы оставляем секцию тегов статической в данный момент, потом к этому мы ещё вернёмся.

Теперь я могу сохранить этот код в чанк, который я назову articleTpl. Далее я изменю мой вызов getResources, добавив туда мой tpl-чанк.

Если мы перегрузим нашу страницу Articles, то сразу увидим разницу:

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

Обратите внимание, что если у вас более 5 статей, то только 5 появятся на странице. Так происходит потому что по умолчанию getResources ограничен количеством извлекаемых страниц, которое равно 5.

Вы можете перезаписать данный параметр добавив &limit и указав необходимое количество статей. Я установлю количество статей равным 10, чтобы убедится, что у меня работает всё так как нужно.

Вспоминая наши уловки описанные выше, мы знаем причину того, что аннотации контента не показываются и причину того, что наши заполнители картинок пусты, потому что нам необходимо использовать includeContent, includeTVs и processTVs. Давайте изменим наш вызов и добавим следующие элементы:

Если мы обновим нашу страницу теперь, то увидим изображения и короткие в 350 символов аннотации извлекаемого содержимого, как я указал в шаблонирующем tpl-чанке:

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

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

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

Если вы взглянете на вывод, то заметите, что страница Articles извлекается на странице категории, то бишь MODX News. MODX Web Development. MODX Tips & Tricks и Other Stuff. Очевидно, что я этого не хочу. Вместо этого, я хочу обозначить, что эти субконтейнеры являются предками ресурсов, которые я хочу показать и я хочу проникать только на один уровень вниз до этих субконтейнеров. По умолчанию, getResources предполагает, что ресурс, в котором вы разместили вызов вашего сниппета – это родительский ресурс и он показывает все ресурсы под собой и их дочерние ресурсы на глубину равную 10.

Поэтому я изменю мой вызов и добавлю ID субконтейнеров тех ресурсов, которые я хочу включить и определю глубину отображения ресурсов:

Теперь данный вызов покажет только статьи сами по себе, а не их родительские контейнеры. Есть еще несколько спобов сделать так же. Например, если вы собираетесь добавить контейнеры других категорий в будущем и не хотите помнить о том, как возвращаться к вызову, чтобы добавить их ID к параметру &parents, то можете использовать &hideContainers=`1` и далее убрать или отредактировать параметр &depth, чтобы он отвечал структуре вашего сайта. В этом случае вы можете полностью убрать &parents, так как getResources будет считать, что вызов сниппета происходит в родительском ресурсе или для завершения редактирования задайте его значение равным [[*id]]:

Ну вот мы и закончили работу над нашим сниппетом getResources. Надеюсь, вы нашли что-то для себя полезное и можете разобраться с расскрытым здесь вопросом и использовать это в построении ваших сайтов.

Вот маленькое домашнее задание для вас, чтобы протестировать знания, приобретённые в ходе урока.

• Поработайте над первой секцией сайдбара страницы articles, чтобы построить список и ссылки на категории статей. Можете использовать для этого Wayfinder или getResources, оставляю выбор за вами
• После этого, необходимо, чтобы страницы, на которые вели ссылки данных категорий содержали агрегацию контента только этой категории. Это просто сделать.

Разрабатываем социальную сеть на MODx Revolution

06 апреля 2013, 00:22

MODx развивается стремительными темпами, и я решил попробовать сделать социальную сеть на этом замечательном движке. Ведь в нем давно уже есть возможность работать с пользователями (регистрация, авторизация и пр.), встроенный механизм сообщений пользователей. он умеет работать с изображениями и много чего еще.

Для начала давайте разберемся с пользователями, дадим им возможность писать статьи, например, или добавлять свои события.

Для регистрации мы будем использовать сниппет Login. О самом сниппете написано уже много, покажу, что делает наш хук addUser :

После того, как пользователь подтвердил свой e-mail, направляем его на страничку редактирования информации о себе: Соответственно, сниппет editUserPage

Пусть у нас пользователи могут добавлять на свою страничку предстоящие и прошедшие события:

На нашем сайте пользователи могут зарегистрироваться, разместить информацию о себе, создавать события или писать статьи.

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

← Файловый менеджер для WEB — SPRUT.io

Реализация пошаговой работы PHP-скрипта с помощью AJAX →

MODX REVO -Дата на русском

Не так давно столкнулся с проблемой вывод даты в MODX на русском языке. Например, «1 сентября». Оказалось, я не одинок с этой проблемой и, погуглив, обнаружил, что можно решить ее с помощью настроек системы или с помощью внедрения нового сниппета. Каждому из этих способов найдется применение, так что — ближе к делу! Кроме того в статье полезнейшая табличка со всевозможными параметрами для даты и времени!

Для начала немного теории о способах вывода даты. Ее значение берется из следующих полей:

• createdon — дата создания ресурса
• deletedon — дата удаления
• editedon — дата последнего редактирования
• publishedon — дата публикации
• unpub_date — дата отмены публикации

Например: 21 June 2014, что будет означать «10 April 2013?.

Теперь переведем название месяца на русский язык. Для этого заходим в «система -> настройки системы», фильтр по разделу — «словарь и язык». Устанавливаем в поле «Локаль» значение ru_RU.UTF-8. Это все — теперь дата будет выглядеть вот таким вот образом: «10 апреля 2013?. Естественно, на русском теперь дни недели и сокращенное название месяца.

Одно время у меня была проблема с настройкой локали, а причина оказалась до безобразия простой — в значении отсутствовал дефис. Причем, эту ошибку я встречал на нескольких сайтах!

Но иногда возникает необходимость выводить необычные названия месяца или, хотя бы, избавиться от родительного падежа. В этом случае поможет простой сниппет. в который мы собственноручно внесем все необходимые значения. Итак, создаем сниппет «dateRus». Его код:

<?php
function returnDate($num, $tipe)<
$str;
switch($tipe)<
case "month":
$month_name = array("", "Пьянварь", "Фигвраль", "Кошмарт","Сопрель", "Сымай", "Теплюнь", "Жарюль", "Авгрусть", "Свистябрь", "Моктябрь", "Гноябрь", "Дубабрь");
$str = $month_name[floor($num)];
break;
case "day":
$day_name = array("", "Понедельник", "Вторник", "Среда","Четверг", "Пятница", "Суббота", "Воскресенье");
$str = $day_name[floor($num)];
break;
>
return $str;
>
echo date("j"). " ". returnDate(date("n"), "month"). " ". date("Y"). " ". returnDate(date("N"), "day");
?>

Вызов сниппета стандартный —. При использовании этого скрипта имейте ввиду, что он выводит строку «echo» целиком. У меня пока не хватает знаний php, а готовых решений я не нашел, чтобы извлечь из этого кода, например, только название месяца. Но для этого есть более «топорный» выход. Пишем так:

<?php
function returnDate($num, $tipe)<
$str;
switch($tipe)<
case "month":
$month_name = array("", "Пьянварь", "Фигвраль", "Кошмарт","Сопрель", "Сымай", "Теплюнь", "Жарюль", "Авгрусть", "Свистябрь", "Моктябрь", "Гноябрь", "Дубабрь");
$str = $month_name[floor($num)];
break;
>
return $str;
>
echo returnDate(date("n"), "month");
?>

И напоследок — таблица со всевозможными форматами даты и времени. Добавляйте в закладки!

Сообщения о несохраненных данных в MODx Revo

Для администрирования блога в MODx Revolution я использую дополнение Articles. Если такое сравнение корректно, то по своим возможностям такой плагин значительно уступает Wordpress. Но это вовсе не мешает ему являться практически единственной блог-площадкой, доступной пользователям MODx. И, надо сказать, площадкой с качественным и полноценным набором инструментов.

Полностью настроив Articles можно столкнуться с рядом шероховатостей, которые усложняют публикацию постов в блоге.

Одна из них — это сообщение о несохраненных данных. Воспроизвести проблему легко: достаточно добавить новую статью, сохранить ее, а затем попытаться перейти в любой другой раздел панели MODx Revo. Вас остановит следующее несуразное сообщение в браузере Chrome:

«Подтвердите переход. Есть несохраненные изменения. Вы уверены, что хотите покинуть эту страницу? Вы действительно хотите покинуть эту страницу?»

Или более лаконичное сообщение в браузере Firefox:

«Эта страница просит вас подтвердить, что вы хотите уйти — при этом введенные вами данные могут не сохраниться.»

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

О том, почему так происходит ведется старая дискуссия. которая, впрочем, дает решение. Достаточно зайти в «Настройки системы», в поле «Поиск по ключу. » ввести «confirm» и нажать Enter. Затем установить напротив ключа «confirm_navigation» значение «Нет» и снова нажать Enter.

После установки этой опции надоедливые сообщения исчезнут. Но есть одно «но» — эти сообщения исчезнут повсеместно и предупреждения о том, что вы действительно забыли сохранить данные — тоже пропадут.

Пока решение только такое. Скорее всего, все зависит от самих разработчиков дополнения Articles.

В следующей статье читайте о том, как добавить кнопку добавления нового поста в шапку админ-панели MODx Revo.