Параметры Ditto 2

Файл конфигурации может включать значения различных параметров Ditto, избавляя от неудобств, связанных с ограничениями, накладываемыми MODx на значения параметров сниппетов (нельзя использовать &, `, <enter> т.п.).

Примечание. Файлы конфигурации сохраняются в папке &ditto_base/configs/. Их имена имею формат &config.config.php

Определяем формат времени, которое выводится с помощью плейсхолдера

Значения: Любой валидный формат времени, который соответствует правилам функции PHP - strftime.

По умолчанию: [LANG]

Пример:

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

Результат:

09.06.2009

Значения: Любое значение времени в формате UNIX timestamp изполя MODx или TV-параметра, как например createdon, pub_date, or editedon.

Режим отладки позволяет разобраться в сложных и непонятных ситуациях. Особенно актуальная возможндость для крупных сайтов, где множество вызовов Ditto могут конфликтовать между собой. При включенном режиме отладки помимо результатов работы выводится множество полезной для разработчика информации (все параметры, список документов результата, их ID и т.п.)

Число уровней в глубину для поиска документов. Документы будут найдены внутри документов-контейнеров, указанных в &startID и &parents и вложенных документов-контейнеров до уровня указанного в &depth. Т.е. если этот параметр равен 1, то будут брать только непосредственно дочерние документы, указанных в &startID и &parents. Если &depth = 2, в поиск пройдет еще и в дочерних.

Значения:

• # - Любое число
• "all" - Все найденные документы

Папка со слэшем на конце, указывающая размещение фалов Ditto на сервере. Как правило этот параметр изменять не приходится.

Этот параметр должен сожержать список ID'ов тех документов, которые будут отображены в результатах. Т. е. можно жестко задать список документов, которые будут отображаться.

Указывает Ditto, какие расширения следует загрузить. Пример расширения с комментариями (на английском) иожно найти по пути: &ditto_base/extenders/example.extender.inc.php

Примечение. Все расширения находятся в папке &ditto_base/extenders/ и имена файлов имею формат: name.extender.inc.php

Используется формат поле,критерий, режим с запятой между значениями

*Mode* - *Meaning*

• 1 - !=
• 2 - ==
• 3 - <
• 4 - >
• 5 - <=
• 6 - >=
• 7 - Текста нет в значении поля
• 8 - Текст в значении поля

@EVAL:

                               @EVAL in filtersworks the same as it does in MODx exect it can only be used

                               with basicfiltering, not custom filtering (tagging, etc). Make sure that

                               you return thevalue you wish Ditto to filter by and that the code is valid PHP.

Ditto умеет работать с различными форматами данных. Например, он может выводить RSS ленту новостей или данные в XML формате.

Значение: любой сивол, который не будет использоваться в правиле фильтра

Значения: Любое название параметра MODx или TV-параметра, перечисленные череззапятую.

Значения:

• 0 - оставить папки
• 1 - исключить папки

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

К примеру, Вы выводите наодной странице спосок новостей и список последних публикаций, причемоба списка имеют пэйджер. Если Вы вставите дважды [+pages+], то обапэйджера будут управлять двумя списками сразу. Это во-первых. Аво-вторых оба пэйджера буду отражать страницы первого списка. Т.е.когда MODx обработает первый вызов, он заменит оба плэйсхолдера [+pages+] на это значение. А список страниц второго списка никуда непопадет.

Так вот в таком случае следует использовать для каждого вызова Ditto свой id. А глобальные плэйсхолдеры примут вид [+id_placeholder+]. Символ подчеркивания между идентификатором и названием плэйсхолдера добавится автоматически.

Примечание: Используется как [+keywords+] или источник tagData

Значения:

• 0 - off
• 1 - on

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

Примечание. Ditto сначала загружает свой стандартный языковой файл, а уже после этого тот файл, что указан в данном параметре. Таким образом, если в файле указанном пользователем нет какой-либо строки, она будет использована из стандартного файла.

Примечание. Языковые файлы находятся в папке &ditto_base/lang/. Имена имею формат: &language.inc.php

Значение: любой сивбол, который не будет использоваться в параметре фильтра

Значения: Любое текст или название чанка

Включает / выключает разбиение по страницам выдачи. На каждой странице выведется &show документов. Для вывода пэйджера используются глобальные плэйсхолдеры:

[+next+] – Кнопка «Следующее»
[+previous+] – Кнопка «Предыдущее»
[+pages+] – Список страниц
[+totalpages+] – Общее количество страниц
[+start+] – Номер первой показываемой страницы
[+stop+] – Номер последней показываемой страницы
[+current+] – Номер показываемой текущей страницы
[+total+] – Общее количество страниц

В случае если страницы для перехода нет (крайние страницы), то ссылка Previous или Next будет показана в виде текста без ссылки и будет заключена в тэг <spanclass="ditto_off">Privious</span>

Значения:

• 0 - показывать ссылки Next и Previous только, если существуют страницы для перехода
• 1 - всегда показывать ссылки Next и Privious

Указывает Ditto список идентификаторов (id) документов-контейнеров, откуда будут браться документы для вывода Ditto. Документы беруться до глубины &depth.

В Ditto имеетвы встроенный парсер PHx. Эта опция включает / выключает его.

Значения:

• # - любое число
• 0 - нет ограничения
  

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

Значения: Любое название чанка, которое используется привыводе

Значения:

• 0 - off; returns output
• 1 - remaining; returns output
• 2 - all;
• 3 - all; returns ph only

Примечание: Используется если глубина (&depth) больше 1

Значения:

• 0 - off
• 1 - on

Значения:

• 0 - показывать все документы
• 1 - показывать только документы у которых поставлен флаг «Показывать в меню»

Значения:

• 0 - показывать только неопубликованные документы
• 1 - показывать только опубликованные документы

По умолчанию: 1 - показывать только опубликованные документы

Значения: Любое поле документа или TV-параметр

Значения:

• ASC - по возрастанию
• DESC - по убыванию

Значения: любое число

Аналогично &parents, только в &startID указывается всего один документ-контейнер.

Значения:

• # - любое число
• "all" - Все найденные документы

Значения:

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

Значения:

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

Значения:

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

Значения:

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

Значения:

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

Значения:

• Валидное имя чанка
• Код (через @CODE)
• Файл (через @FILE)

Значения:

• Валидное имя чанка
• Код (через @CODE)
• Файл (через @FILE)

Значения:

• Имя существуещего чанка
• Код, определяемый через @CODE:
• Файл, определяемый через @FILE:

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

• - URL документа
• - &truncText

Значения:

• 0 - выкл
• 1 - вкл

Значения: Любой уникальный текст или код, который содержится в содержании каждого документа

Значения: Любое число больше чем &truncOffset

Значения: Любое число не превышающее &truncLen

Значения: Любой текст или отрывок html-кода

Значения: Любое валидное выражение MySQL WHERE.

Примечание: Используется только для параметров документов.Не поддерживает TV-параметры.