[ms2Gallery] Версия 1.3.0 - сниппет ms2GalleryResources

Как и обещал, представляю вашему вниманию новую версию ms2Gallery со сниппетом для вывода ресурсов с прикреплёнными изображениями.

Честно говоря, это вопрос №1 в поддержке магазина по ms2Gallery — «как вывести документы из контейнера такого-то с присоединением превью такого-то?». И мне очень надоело объяснять, как работает вот эта портянка:

[[!pdoPage?
	&element=`pdoResources`
	&loadModels=`ms2gallery`
	&parents=`0`
	&tpl=`myRowTpl`
	&leftJoin=`{
		"120x90": {"class":"msResourceFile","alias":"120x90", "on": "120x90.resource_id = modResource.id AND 120x90.path LIKE '%/120x90/' AND 120x90.rank=0"}
		,"360x270": {"class":"msResourceFile","alias":"360x270", "on": "360x270.resource_id = modResource.id AND 360x270.path LIKE '%/360x270/' AND 360x270.rank=0"}
	}`
	&select=`{
		"modResource":"*"
		,"120x90":"120x90.url as 120x90"
		,"360x270":"360x270.url as 360x270"
	}`
]]
[[!+page.nav]]

Поэтому с версии 1.3.0 вы можете вызывать отдельный сниппет:

[[!pdoPage?
	&element=`ms2GalleryResources`
	&parents=`0`
	&tpl=`@INLINE
	<p>
		<a href="[[+uri]]">[[+pagetitle]]</a>
		<a href="[[+120x90.original]]"><img src="[[+120x90]]" title="[[+120x90.name]]" /></a>
	</p>
	`
	&typeOfJoin=`inner`
	&includeThumbs=`120x90,360x270`
	&includeOriginal=`1`
]]
[[!+page.nav]]

Как видите, теперь всё стало гораздо проще.

Сниппет называется ms2GalleryResources, потому что внутри у него старый добрый pdoResources. По большому счету, новый сниппет — это просто обёртка, которая готовит параметры и передаёт их в родительский сниппет.

Соответственно, вы можете использовать любые параметры pdoResources, плюс 3 новых:

• typeOfJoin — Тип присоединения картинок ресурса. Left — это Left Join, то есть, ресурсы будут выбираться, даже если у них нет картинок. И inner — это Inner Join, будут выбираться только ресурсы с картинками.
• includeThumbs — Список разрешенных превью через запятую. Например «120x90,360x270».
• includeOriginal — Добавление в выборку дополнительного join со ссылкой на оригинальное изображение. Будет доступно в массиве ресурса как «разрешение.original», например «120x90.original».

Чтобы увидеть все доступные свойства ресурса и изображений — просто не указывайте &tpl и вы получите распечатанный массив данных.

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

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

Обновляемся, пишем отзывы.

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

if ($row['type'] != 'image') {
				$row['thumbnail'] = (file_exists(MODX_ASSETS_PATH . 'components/ms2gallery/img/mgr/extensions/' . $row['type'] . '.png'))
					? MODX_ASSETS_URL . 'components/minishop2/img/mgr/extensions/' . $row['type'] . '.png'
					: MODX_ASSETS_URL . 'components/minishop2/img/mgr/extensions/other.png';
			}

if ($row['type'] != 'image') {
				$row['thumbnail'] = (file_exists(MODX_ASSETS_PATH . 'components/ms2gallery/img/mgr/extensions/'.$row['type'].'.png'))
					? MODX_ASSETS_URL . 'components/ms2gallery/img/mgr/extensions/'.$row['type'].'.png'
					: MODX_ASSETS_URL . 'components/ms2gallery/img/mgr/extensions/other.png';
			}

<a href=""><img class="shk-image" src="[[+360x270]]" alt="[[+pagetitle]]"/></a>