Сниппет Ditto

Опубликовано: 12 Мая 2014

Ditto - выводит информацию из ресурсов по заданному шаблону.

Параметр

Описание

По умолчанию

Пример

&config

Загрузка выборочной конфигурации

default

&config=``

&dateFormat

Формат времени для PHP

[LANG]

&dateFormat= `%d.%m.%Y`

&dateSource

Источник определяющий значение [+date+]

createdon

&dateSource= `pub_date`

&debug

Включить / выключить режим отладки

0

&debug=`1`

& depth

Глубина поиска документов

1

&depth=`5`

&display

Число отображаемых документов

3

&display=`10`

&ditto_base

Расположение фалов Ditto

[(base_path)]assets/snippets/ditto/

&ditto_base=``

&documents

Список ID документов для результата

нет

&documents=`1, 35, 122`

&extenders

Имена расширений

нет

&extenders= `summary`

&filter

Фильтр для отсеивания документов

1 - != (не соответствует критерию)
2 - == (соответствует критерию)
3 - < (меньше критерия)
4 - > (больше критерия)
5 - <= (меньше или равен критерию)
6 - >= (больше или равен критерию)
7 - (не содержит текст критерия)
8 - (содержит текст критерия)
Может содержать несколько запросов, разделенных глобальным разделителем |.

NULL

&filter= `id,10,2|id,20,2`

&format

Используемый формат для вывода

html

&format=`rss`

&globalFilterDelimiter

Разделитель правил фильтра

|

&globalFilterDelimiter=``

&hiddenFields

Возвращать необработанные поля

NULL

&hiddenFields=``

&hideFolders

Скрывать документы-контейнеры

0

&hideFolders=`1`

&hidePrivate

Запрещает показ документов если пользователь не имеет разрешения на просмотр

1

&hidePrivate=`0`

&id

Уникальный ID сессии Ditto

нет

&id=`nav`

&keywords

Использование выборки ключевых слов

0

&keywords=`1`

&language

Язык Ditto

english

&language=`russian-UTF8`

&localFilterDelimiter

Разделитель, используемый для разделения отдельных параметров в каждой строке фильтра

,

&localFilterDelimiter=``

&noResults

Текст выводимый если нет результата

LANG

&noResults= `Документы не найдены

&orderBy

Порядок и направление, используемые для сортировки результатов

createdon DESC

&orderBy= `pagetitle ASC`

&parents

Идентификаторы контейнеров

Текущий документ

&parents=`1, 5, 8`

&phx

Использование PHx форматирования

1

&phx=`0`

&queryLimit

Лимит на запрос в базе

0

&queryLimit=``

&randomize

Вывод документов в случайном порядке

0

&randomize=`1`

&removeChunk

Названия вырезаемых чанков

NULL

&removeChunk=``

&save

Сохранить результат в плэйсхолдер

0 - выкл; возвращает вывод
1 - остальные; возвращает вывод
2 - все;
3 - все; возвращается рН только

0

&save=`3`

&seeThruUnpub

Смотреть сквозь неопубликованные документы

1

&seeThruUnpub=`1`

&showInMenuOnly

Показывать только документы видимые в меню

0

&showInMenuOnly=`1`

&showPublishedOnly

Показывать только опубликованные документы

1

&showPublishedOnly =`0`

&start

Пропуск начальных документов

0

&start=`5`

&total

Число возвращаемых документов

all

&total=`10`

&where

Специальное условие для запроса

NULL

&where=``

&paginate

Включает / выключает разбиение по страницам

На каждой странице выведется &show документов. Для вывода пэйджера используются глобальные плэйсхолдеры:
[+next+] – Кнопка «Следующее»
[+previous+] – Кнопка «Предыдущее»
[+pages+] – Список страниц
[+totalPages+] – Общее количество страниц
[+start+] – Номер первой показываемой страницы
[+stop+] – Номер последней показываемой страницы
[+currentPage+] – Номер показываемой текущей страницы
[+total+] – Общее количество страниц

0

&paginate=`1`

&paginateAlwaysShowLinks

Показывать ли [+next+] и [+previous+] всегда

0

&paginateAlwaysShowLinks=`1`

&paginateSplitterCharacter

Символ для разделения Previous и Next

|

&paginateSplitterCharacter=``

&tplPaginateCurrentPage

Шаблон для ссылки текущей страницы

имя чанка | @FILE | @CODE

Любое валидное название чанка
Код через @CODE
Файл через @FILE

LANG

&tplPaginateCurrentPage=``

&tplPaginateNext

Шаблон оформления ссылки Next
(формат аналогично &tplPaginateCurrentPage)

LANG

&tplPaginateNext =`newsPaginateNext`

&tplPaginateNextOff

Шаблон для внутренней части следующей ссылки

(формат аналогично &tplPaginateCurrentPage)

LANG

&tplPaginateNextOff=``

&tplPaginatePage

Шаблон для ссылок на страницы

(формат аналогично &tplPaginateCurrentPage)

LANG

&tplPaginatePage=``

&tplPaginatePrevious

Шаблон оформления ссылки Previous

(формат аналогично &tplPaginateCurrentPage)

LANG

&tplPaginatePrevious =`newsPaginatePrevious`

&tplPaginatePreviousOff

Шаблон для предыдущей ссылки, когда он выключен

(формат аналогично &tplPaginateCurrentPage)

LANG

&tplPaginatePreviousOff=``

&tpl

Шаблон для записи

(формат аналогично &tplPaginateCurrentPage)

LANG

&tpl=`news`

&tplAlt

Шаблон для четных документов

(формат аналогично &tplPaginateCurrentPage)

&tpl

&tplAlt=`news_alt`

&tplCurrentDocument

Шаблон текущего документа

(формат аналогично &tplPaginateCurrentPage)

&tpl

&tplCurrentDocument =`news_current`

&tplFirst

Шаблон для первого документа

(формат аналогично &tplPaginateCurrentPage)

&tpl

&tplFirst=`news_first`

&tplLast

Шаблон для последнего документа

(формат аналогично &tplPaginateCurrentPage)

&tpl

&tplLast=`news_last`

&dateFilterDefault

Установить значения фильтра по умолчанию, текущий год, месяц или день

0,1,2,3 (выключено, текущий год, текущий месяц, сегодня)

0

&dateFilterDefault=`1`

&dateFilterSource

Источник фильтрации данных

get

&dateFilterSource=``

&day

День для фильтрации

нет

&day=`25`

&month

Месяц для фильтрации

нет

&month=`10`

&year

Год для фильтрации

нет

&year=`2012`

&caseSensitive

Включает/выключает дублирование тегов, чувствителен к регистру

0

&caseSensitive=`1`

&tagCallback

Имя функции для обработки тегов

нет

&tagCallback=``

&tagData

Поле, содержащее информацию

нет

&tagData=`tags`

&tagDelimiter

Разделитель между тегами

пробел

&tagDelimiter=`,`

&tagDisplayDelimiter

Разделитель между тегами при их выводе

значение параметра tagDelimiter

&tagDisplayDelimiter=`,`

&tagDisplayMode

Формат отображения тегов в плэйсхолдере tagLinks

1

&tagDisplayMode=`2`

&tagDocumentID

ID документа содержащего теги

нет

&tagDocumentID=``

&tagMode

Выбрать или скрыть документы со всеми или любым из тегов

- onlyAllTags показать документа, содержащие все теги из параметра tags
- onlyTags показать документы, которые имеют любой из тегов tags
- removeAllTags удалить документы, которые содержат все теги tags
- removeTags удалить документы, которые имеют любой из тегов tags

onlyTags

&tagMode=`onlyAllTags`

&tags

Установить теги для фильтрации

нет

&tags=``

&tagSort

Сортировать теги по алфавиту

1

&tagSort=`0`

&tplTagLinks

Шаблон для вывода плэйсхолдера tagLinks

нет

&tplTagLinks=``

&bad

Параметры, которые не могут быть установлены через экстендер

seeThroughtUnpub, showInMenuOnly, showPublishedOnly, debug, start, config, extenders, dittoID

&bad=``

&good

Параметры, которые могут быть установлены с помощью экстендера

Все параметры, которые не вошли в список bad

&good=``

&stripTags

Удаление HTML-тегов из предоставленных параметров

1

&stripTags=`0`

&tplTrunc

Шаблон для [+link+]

(формат аналогично &tplPaginateCurrentPage)

&truncText

&tplTrunc=``

&trunc

Включить\отключить обрезание для [+summary+]

1

&trunc=`0`

&truncAt

Текст, служащий разделителем для [+summary+]

<!-- splitter -->

&truncAt=``

&truncLen

Ограничение длины в [+summary+]

300

&truncLen=`800`

&truncOffset

Количество "блуждающих" символов от truncLen

30

&truncOffset=`50`

&truncSplit

Документ должен быть получен в итоге с разделителем

1

&truncSplit=`0`

&truncText

Текст ссылки в [+link+]

Read more...

&truncText=`Читать далее...`

Плэйсхолдеры

[~[+id+]~] – Создает полный URL, основанный на ID, но не создает саму ссылку.
[+pagetitle+] – Заголовок документа.
[+longtitle+] – Расширенный заголовок документа.
[+description+] – Описание документа.
[+introtext+] – Аннотация документа.
[+content+] – Содержимое документа.
[+alias+] – Псевдоним страницы. Используется для создания ЧПУ.
[+menutitle+] – Название документа в меню.
[+id+] – Целое число обозначающее или показывающее id документа.
[+parent+] – id родительского документа.
[+isfolder+] – Целое число. true (1) если документ является контейнером или false (0) если нет.
[+menuindex+] – Целое число показывающее позицию в меню.
[+hidemenu+] – Возвращает 1 (true) или 0 (false) – соответственно если этот документ показывается в меню или нет.
[+type+] – Возвращает строчный параметр 'document' для страниц или 'reference' для ссылок.
[+contentType+] – Возвращает строчный параметр типа содержимого из выпадающего меню Content Type в панели администратора.
[+published+] – Целое число показывающее статус публикования (0 = нет, 1 = да).
[+pub_date+] – Дата с которой документ опубликуется (в секундах с 1 января 1970 г.). Примечание: если этот параметр указан, ['published'] автоматически устанавливается в true (1).
[+unpub_date+] – Дата окончания публикации документа (в секундах с 1 января 1970 г.). Примечание: установка этого параметра НЕ имеет эффекта на изменение статуса установок ['published'].
[+richtext+] – true (1) или false (0), устанавливается, если в администраторской панели должен использоваться rich text editor.
[+template+] – id шаблона, используемого для этого документа.
[+searchable+] – Возвращает 1 (true) или 0 (false), что означает что этот документ доступен или не доступен для поиска.
[+cacheable+] – Возвращает 1 (true) or 0 (false) если этот документ должен быть кэширован. По умолчанию установлено в false для нормального функционирования динамических сниппетов.
[+createdby+] – Возвращает id пользователя, создавшего документ.
[+createdon+] – Дата (в секундах с 1 января 1970 г.), когда документ был создан.
[+editedby+] – Возвращает id пользователя, который последний редактировал документ.
[+editedon+] – Возвращает дату последнего редактирования (в секундах с 1 января 1970 г.).
[+deleted+] – Возвращает 1 (true) or 0 (false). Когда true, этот документ находится в корзине до ее очистки. После этого запись стирается полностью из базы данных (удаляется ПО-НАСТОЯЩЕМУ).
[+deletedon+] – Возвращает дату удаления документа (в секундах с 1 января 1970 г.).
[+deletedby+] – Позвращает id пользователя, удалившего этот документ.
[+donthit+] – True (1) or False (0) показывает установлен или нет счетчик посещений страницы.
[+haskeywords+] – True (1) or False (0) показывает установлены или нет ключевые слова для данного документа.
[+hasmetatag+] – True (1) or False (0) показывает установлены или нет метатэги для данного документа.
[+privateweb+] – True (1) or False (0) показывает установлены ли разрешения на просмотр этого документа для веб-пользователей.
[+privatemgr+] – True (1) or False (0) показывает установлены ли разрешения на просмотр этого документа для менеджеров.
[+content_dispo+] – Строка внедрения или прикрепления. Внедренные документы показываются в веб-браузерах. Прикрепленные документ могут быть загружены на локальную машину через диалоговое окно загрузки файла веб-браузера.
[+author+] – Имя автора. Сначала createdby->fullname, createdby->username, admin
[+title+] – Содержимое поля заголовка.
[+url+] - Ссылка на документ
[+ditto_iteration+] - Порядковый номер полученного документа в пределах текущей страницы
[+ditto_sort +] - Порядковый номер полученного документа в пределах полного набора документов
[+date+] – Дата в установленном формате. По умолчанию используется createdon (editedon и pub_date как варианты).
[+next+] – Кнопка «Следующее»
[+previous+] – Кнопка «Предыдущее»
[+splitter+] – Разделитель если всегда показывается 0
[+start+] – Номер первой показываемой страницы
[+urlStart+] – номер текущей страницы, как показано в адресной строке (?start=)
[+stop+] – Номер последней показываемой страницы
[+total+] – Общее количество страниц
[+pages+] – Список страниц
[+currentPage+] – Номер показываемой текущей страницы
[+perPage+] – Отображаемых элементов на странице (равно &display)
[+totalPages+] – Общее количество страниц
[+ditto_pagination_set+] – 1 если &paginate включено
[+item[x]+] – Сформированный вывод индивидуального документа
[+content+] – Содержание поля content, если оно не пустое, или усеченный текст
[+summary+] – Поле аннотация (введение) полностью, если указано, или начальная часть содержимого страницы.
[+link+] – Ссылка на полный текст. Текст ссылки установливается параметром &trunctText. По умолчанию из файла языка Ditto.
[+tagLinks+] – Список тэгов, связанных с документом, разделенных &tagDelimiter
[+tags+] – На странице, содержащей результат: теги, используемые для фильтрации отображаемых документов.
[+year+] – Год для фильтра. Двух или четырех значное значение.
[+month+] – Месяц для фильтра.
[+day+] – День для фильтра.
[+month_numeric+] - Численное значение месяца.

TV параметр в Ditto

[+templatevariablename+]

Использование

[ !Ditto? &tpl=`news_tpl` &parents=`2`!] // некэшируемый вызов

[ [Ditto? &tpl=`news_tpl` &parents=`2`]] // кэшируемый вызов

Комментарии (0)


Оставить комментарий




Разрешённые теги: <b><i><br>Добавить новый комментарий: