Ditto и Reflect
PDF
Перейти

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

Параметры

Формат: путь
Значение по умолчанию: /var/www/user3026/data/www/i--gu.ru/assets/snippets/reflect/
Примечание:
Пример:
&reflect_base=``
Формат: Числа или буквы английского алфавита. Строка чувствительна к регистру.
Значение по умолчанию: нет
Примечание:
Пример:
&id=`wp`
Формат: default | wordpress | CONFIG_NAME (путь или @FILE)
Значение по умолчанию: default
Примечание: Файл конфигурации должен находиться в папке reflect/configs и называться name.config.php
Пример:
&config=`wordpress`
Формат: 0 | 1
Значение по умолчанию: 0
Примечание:
Пример:
&getDocuments=`1`
Формат: 0 | 1
Значение по умолчанию: 1
Примечание:
Пример:
&showItems=`0`
Формат: 0 | 1
Значение по умолчанию: 1
Примечание:
Пример:
&groupByYears=`0`
Формат: ID документа
Значение по умолчанию: текущий документ
Примечание: ID страницы с вызовом Ditto, где будет происходить сортировка: extenders=`dateFilter`
Пример:
&targetID=`55`
Формат: createdon, pub_date, editedon или TV-параметр содержащий дату
Значение по умолчанию: createdon
Примечание:
Пример:
&dateSource=`pub_date`
Формат: Любой валидный формат времени, который соответствует правилам функции PHP - strftime
Значение по умолчанию: %d-%b-%y %H:%M
Примечание: Определяет формат времени, которое выводится с помощью плейсхолдера [+date+]
Пример:
&dateFormat=`%d.%m.%Y`
Формат: ASC | DESC
Значение по умолчанию: DESC
Примечание:
Пример:
&yearSortDir=`ASC`
Формат: ASC | DESC
Значение по умолчанию: ASC
Примечание:
Пример:
&monthSortDir=`DESC`
Формат: число
Значение по умолчанию: 0
Примечание:
Пример:
&start=`5`
Формат: 0 | 1
Значение по умолчанию: 1
Примечание:
Пример:
&phx=`0`
Формат: Любые валидные параметры Ditto в формате name:value разделенные (|)
Значение по умолчанию: нет
Примечание: Этот параметр необходим только для config, start, и phx, теперь вы можете просто использовать параметры, как если бы Reflect был Ditto
Пример:
&dittoSnippetParameters=`parents:69`
Формат: Любое валидное название сниппета
Значение по умолчанию: Ditto
Примечание:
Пример:
&source=``
Формат: любое валидное имя чанка | @CODE | @FILE
Значение по умолчанию: default.tempates.php
Примечание:
Пример:
&tplContainer=``
Формат: любое валидное имя чанка | @CODE | @FILE
Значение по умолчанию: default.tempates.php
Примечание:
Пример:
&tplYear=``
Формат: любое валидное имя чанка | @CODE | @FILE
Значение по умолчанию: default.tempates.php
Примечание:
Пример:
&tplYearInner=``
Формат: любое валидное имя чанка | @CODE | @FILE
Значение по умолчанию: default.tempates.php
Примечание:
Пример:
&tplMonth=``
Формат: любое валидное имя чанка | @CODE | @FILE
Значение по умолчанию: default.tempates.php
Примечание:
Пример:
&tplMonthInner=``
Формат: любое валидное имя чанка | @CODE | @FILE
Значение по умолчанию: default.tempates.php
Примечание:
Пример:
&tplItem=``

Примеры

Вызов сниппета Reflect делается на странице, на которой необходимо вывести архив по годам. Размещаем примерно такой вызов сниппета:

[!Reflect?config=`wordpress` &id=`wp` &targetID=`111` &dittoSnippetParameters=`parents:100` &getDocuments=`1`!]

где:

config=`wordpress` — имя конфигурации сниппета Reflect;
id=`wp` — уникальный идентификатор для сниппета Ditto;
targetID=`111` — ID ресурса, в который нужно выводить результаты. Если результаты выводятся на этой же странице, то параметр можно не указывать;
dittoSnippetParameters=`parents:100` — параметр Ditto ‘parents’ со значением 100, то есть какую папку сортировать по датам.

Создаем документ с ID 111 (указываем этот ID в targetID) и вставляем такой код:

[+wp_month+] [+wp_day+] [+wp_year+]
[!Ditto? &id=`wp` &extenders=`dateFilter` &parents=`100`!]

Конфигурация по умолчанию

[!Reflect? &id=`wp` &targetID=`111` &dittoSnippetParameters=`parents:100` &getDocuments=`1` &showItems=`0`!]

Надпись Archives берётся из файла assets/snippets/reflect/default.templates.php, там же находятся и шаблоны для вывода архива.

Конфигурация wordpress

[!Reflect?config=`wordpress` &id=`wp` &targetID=`111` &dittoSnippetParameters=`parents:100` &getDocuments=`1`!]

Внимание: Конфигурация wordpress не поддерживает некоторые параметры сниппета, так как они жестко заданы в конфигурационном файле  assets/snippets/reflect/configs/wordpress.config.php. Вы можете изменить конфигурационный файл, создать свой собственный или использовать конфигурацию по умолчанию. 

Поделитесь ссылкой

Статистика

Яндекс цитирования
© 2011 - 2023 Школа MODX
Напишите нам в Telegram