Ditto 2.1.1 Создание ленты новостей или блога, вывод каталога товаров, сортировка и т.д.

[~[+id+]~] – Создает полный URL, основанный на ID, но не создает саму ссылку.

Например:

<h3><a href="[~[+id+]~]">[+title+]</a></h3>

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

где:

[!Ditto? &tpl=`news_tpl` &parents=`2` &orderBy=`pagetitle ASC`!]  

где:

&orderBy=`ASC pagetitle` - сортировать по возрастанию по полю заголовка документов

[!Ditto? &tpl=`news_tpl` &parents=`2` &id=`news` &paginate=`1` &display=`10`!]
 <div class="pagination">
       Страница  [+news_currentPage+] из [+news_totalPages+]  [+news_previous+][+news_pages+][+news_next+]
 </div>  

где:

При использовании идентификатора при постраничном разбиении, идентификатор должен быть добавлен в качестве суффикса к плэйсхолдерам пагинации, т.е. в данном случае плэйсхолдер [+pages+] должен превратиться в [+news_pages+].

[!Ditto? &tpl=`news_tpl` &parents=`2` &dateSource=`pub_date` &dateFormat=`%d.%m.%Y`!]  

где:

[!Ditto? &tpl=`news_tpl` &parents=`2` &filter=`id,10,2|id,20,2`!]  

где:

&filter=`id,10,2|id,20,2` - исключает документы с id 10 и 20

Описание: Предназначен для фильтрации документов по дате, может использоваться месте со сниппетом Reflect.

Параметры: &dateFilterSource, &dateFilterDefault, &month, &year, &day

Плейсхолдеры: [+year+], [+month+], [+day+], [+month_numeric+]

Пример:

<form id="dateFilterForm" method="get" action="[~[*id*]~]">
    <select size="1" name="year">
        <option selected value="">-- год --</option>
        <option value="2011">2011</option>
        <option value="2012">2012</option>
        <option value="2013">2013</option>
    </select>
    <select size="1" name="month">
        <option selected value="">-- месяц --</option>
        <option value="1">Январь</option>
        <option value="2">Февраль</option>
        <option value="3">Март</option>
        <option value="4">Апрель</option>
        <option value="5">Май</option>
        <option value="6">Июнь</option>
        <option value="7">Июль</option>
        <option value="8">Август</option>
        <option value="9">Сентябрь</option>
        <option value="10">Октябрь</option>
        <option value="11">Ноябрь</option>
        <option value="12">Декабрь</option>
    </select>
    <input type="submit" value="Ок" name="Submit">
</form>
<h3>[+year+] [+month+]</h3>
[!Ditto? &parents=`2` &extenders=`dateFilter` &dateSource=`createdon`!]

где:

• &extenders=`dateFilter` - имя используемого расширения
• &dateSource=`createdon` - поле по которому будет происходить фильтрация

Описание: Изменение параметров Ditto через URL.

Параметры: &stripTags, &bad, &good

Плейсхолдеры: нет

Пример:

<form action="[~[*id*]~]"  method="get">
    <p>Сортировать по...</p>
    <select name="ditto_id1_sortDir"> 
        <option value="">-- выбрать --</option> 
        <option value="ASC">Возрастанию</option> 
        <option value="DESC">Убыванию</option> 
    </select> 
    <input name="Submit" type="submit" value="Ок">
</form>
<h3>Результат</h3>
[!Ditto? &id=`id1` &parents=`4` &tpl=`@CODE [+pagetitle+]<br>` &extenders=`request` &sortBy=`pagetitle`!]

где:

• &extenders=`request` - имя используемого расширения
• &sortBy=`pagetitle` - параметр, по которому производится сортировка

Описание: Формирование краткого описания и подстановка этого описания в плейсхолдер [+summary+].

Параметры: &truncSplit, &trunc, &truncAt, &truncLen, &truncOffset, &truncText, &tplTrunc.

Плейсхолдеры: [+summary+], [+link+]

Пример: Вывести аннотации к документам, но поле [+introtext+] у документов не заполнено или заполнено не у всех документов. В шаблоне вместо плейсхолдера [+introtext+] вставляем плейсхолдер [+summary+], а вызов сниппета станет таким:

[!Ditto? &tpl=`@CODE:<h3>[+pagetitle+]</h3><p>[+summary+]</p><p>[+link+]</p>` &parents=`2` &extenders=`summary` &truncLen=`400` &truncText=`Подробнее...`!]

где:

• &extenders=`summary` - имя используемого расширения
• &truncLen=`400` - максимальное количество отображаемых символов
• &truncText=`Подробнее...` - текст ссылки на подробное описание

Описание: Фильтрация документов по тегам.

Параметры: &tagDocumentID, &tags, &tagMode, &tagDelimiter, &caseSensitive, &tagDisplayDelimiter, &tagSort, &tagData, &tagDisplayMode, &tplTagLinks, &tagCallback

Плейсхолдеры: [+tagLinks+], [+tags+]

Экстендер tagging автоматически подключается при использовании параметра &tagData. В качестве значения параметра &tagData используется имя TV-параметра с типом ввода Text, Radio Options или Check Box. По умолчанию, разделителем между тегами является пробел. Изменить разделитель можно с помощью параметра &tagDelimiter=`, `. Теги отображаются в плейсхолдере [+tagLinks+] в виде набора ссылок.

Пример:

[!Ditto? &parents=`4` &tagData=`keyw` &tagDelimiter=`,` &tagDisplayDelimiter=`, ` &tpl=`@CODE:<h3>[+pagetitle+] <small>[+tagLinks+]</small></h3>` &tagSort=`0` &tagDocumentID=`[*id*]`!]

где:

• &tagData=`keyw` - поле документа или переменная шаблона, содержащая теги
• &tagDelimiter=`,` - разделитель между тегами
• &tagDisplayDelimiter=`, ` - разделитель между тегами при их выводе
• &tagSort=`0` - отключаем сортировку тегов по алфавиту
• &tagDocumentID=`[*id*]` - ID документа, где будет выводиться список отфильтрованных документов

Источник: andFilter

Описание: Фильтрация по TV-параметру, имеющему несколько значений. Проверка на сооответствие каждому значению.

Параметры: &andFilterTv.

Плейсхолдеры: нет.

Пример: Вывести товары красного и зелёного цета, размеров L, XL и XXL

[!Ditto? &tpl=`tpl` &parents=`2` &extenders=`andFilter` &andFilterTv=`color:зелёный,красный;size:L,XL,XXL`!]

где:

• &extenders=`andFilter` - имя используемого расширения
• &andFilterTv=`color:зелёный,красный;size:L,XL,XXL` - параметры, по которым происходит фильтрация документов.

Описание: Подсчет количества документов.

Обязательные параметры: нет.

Плейсхолдеры: [+count+]

Пример: Вывести общее количество документов в контейнерах 3,4,5:

[!Ditto? &tpl=`@CODE:[+count+]` &parents=`3,4,5` &extenders=`countDocs` &display=`1`!]

где:

• &extenders=`countDocs` - имя используемого расширения
• &display=`1` - устанавливаем значение равное 1, так как нам необходимо вывести количесто только один раз.

Источник: distinct

Описание: Возвращает только уникальные результаты полей, указанных в качестве значения параметра &distinct=`param1,param2`.

Параметры: &distinct

Плейсхолдеры: нет

Пример: получить только уникальные заголовки страниц для каждой даты.

[!Ditto? &parents=`4` &extenders=`distinct` &distinct=`pagetitle,pub_date`!]

где:

• &extenders=`distinct` - имя используемого расширения
• &distinct=`pagetitle,pub_date` - параметры, по которым производится фильтрация

Источник: customsort

Описание: Пользовательский порядок сортировки документов в параметре &documents.

Параметры: &documents

Плейсхолдеры: нет

Пример: вывести список документов в строго заданном порядке.

[!Ditto? &parents=`4` &extenders=`customsort` &documents=`40,46,47,35,36,37,44,41,43,49,48,50,54,53`!]

где:

• &extenders=`customsort` - имя используемого расширения
• &documents=`40,46,47,35,36,37,44,41,43,49,48,50,54,53` - заданный порядок вывода документов

Источник: glossaryFilter

Описание: продвинутая фильтрация документов.

Параметры: &filterVar, &filterMode, &filterBy, &forceUTF8

Плейсхолдеры: нет

Пример: фильтрация документов по первым буквам алфавита.

<?php
$allowed_req = array(
    # 'label-for-button-or-link' => 'actual-value-for-regex-clause',
    'A' => 'A',
    'B' => 'B',
    'C' => 'C',
    'D' => 'D',
    'E' => 'E',
    'F' => 'F',
    'G' => 'G',
    'H' => 'H',
    'I' => 'I',
    'J' => 'J',
    'K' => 'K',
    'L' => 'L',
    'M' => 'M',
    'N' => 'N',
    'O' => 'O',
    'P' => 'P',
    'Q' => 'Q',
    'R' => 'R',
    'S' => 'S',
    'T' => 'T',
    'U' => 'U',
    'V' => 'V',
    'W' => 'W',
    'X' => 'X',
    'Y' => 'Y',
    'Z' => 'Z',
    '0-9' => '0|1|2|3|4|5|6|7|8|9',    
    'Все' => 'A|B|C|D|E|F|G|H|I|J|K|L|M|N|O|P|Q|R|S|T|U|V|W|X|Y|Z',
);
$cur_filter = isset($_POST['filter']) && isset($allowed_req[$_POST['filter']]) && $allowed_req[$_POST['filter']] ? $allowed_req[$_POST['filter']] : '';
$index = '<form method="post" action="[~[*id*]~]">';
foreach ($allowed_req as $label => $request) {
    if ($request) {
        $index .= '<input type="submit" name="filter" value="' . $label . '"' . ($request == $cur_filter ? ' disabled' : '') . '>' . ' ';
    }
}
$index .= '<input type="submit" name="clear" value="Очистить">' .
'</form>';
$params['parents']='4';
$params['orderBy']='pagetitle ASC';
$params['filterVar']='pagetitle';
$params['filterBy']= $cur_filter;
$params['depth']='1';
$params['extenders']='glossaryFilter';
$custom_filter = $modx->runSnippet('Ditto',$params);
return $index . ($cur_filter ?  $custom_filter  :   '');
?>

Описание: количество комментариев Jot к определенной странице в шаблоне Ditto.

Параметры: нет

Плейсхолдеры: [+jotcount+]

Пример: вывести количество комментариев.

[!Ditto? &parents=`4` &extenders=`jotcount` &tpl=`@CODE:<h3>[+pagetitle+] <small>[+jotcount+]</small></h3>`!]

где:

• &extenders=`jotcount` - имя используемого расширения

Описание: информация о комментариях Jot к определенной странице в шаблоне Ditto.

Параметры: &jotfilter, &jotauthorfield

Плейсхолдеры: [+jotcount+], [+jotlastdate+], [+jotlastauthor+]

Пример: вывести количество комментариев.

[!Ditto? &parents=`4` &extenders=`jotdatesort` &tpl=`@CODE:<h3><a href="[~[+id+]~]">[+title+]</a></h3>Количество комментариев: [+jotcount+]<br />Автор комментария: [+jotlastauthor+]<br />Дата последнего комментария: [+jotlastdate:date=`%d.%m.%Y, %H:%M:%S`+]<br />Дата поста: [+date+]<br />Автор поста: [+author+]` &jotfilter=`1` &jotauthorfield=`Гость`!]

где:

• &extenders=`jotdatesort` - имя используемого расширения
• &jotfilter=`1` - не выводить без комментариев
• &extenders=`jotdatesort` - имя автора комментария (гостя)

Описание: вывод документов определенного уровня.

Параметры: &level

Плейсхолдеры: нет

Пример: вывести количество комментариев.

[!Ditto? &parents=`4` &extenders=`level` &depth=`3` &level=`3`!]

где:

• &extenders=`level` - имя используемого расширения
• &depth=`3` - глубина сканирования
• &level=`3` - вывести документы 3-го уровня

Описание: поиск на Ditto.

Параметры: &searchFields, &searchOptions, &searchString, &searchOptionsSeparators

Плейсхолдеры: нет

Пример:

[!Ditto? &parents=`4` &extenders=`search` &searchString=`my search string` &searchFields=`content,tv1,tv2` &searchOptions=`caseSensitive` ...`!]

где:

• &extenders=`search` - имя используемого расширения
• &searchString=`my search string` - поисковый запрос
• &searchFields=`content,tv1,tv2` - поля и переменные шаблона, по которым происходит поиск
• &searchOptions=`caseSensitive` - производить поиск с учетом регистра

Описание: фильтрация документов по заданным TV.

Параметры: &tvFilterBy, &tvFilterMode

Плейсхолдеры: нет

Пример: показать все дочерние документы контейнеров 3, 4 и 5, к которым привязан TV-параметр dummy.

[!Ditto? &parents=`3,4,5` &extenders=`tvFilter` &tvFilterBy=`dummy` &tvFilterMode=`0`!]

где:

• &extenders=`tvFilter` - имя используемого расширения
• &tvFilterBy=`dummy` - имя TV-параметра, по которому происходит фильтрация
• &tvFilterMode=`0` - исключить документы, к которым НЕ привязан TV-параметр dummy

Описание: фильтрация строк переменной шаблона multiTv.

Параметры: &multiTvFilterBy, &multiTvFilterOptions

Плейсхолдеры: нет

Пример: показать все дочерние документы контейнеров 3, 4 и 5, у которых переменная шаблона multiTv event в столбце title не содержит Important.

[!Ditto? &parents=`3,4,5` &extenders=`@FILE assets/tvs/multitv/dittoExtender/multitvfilter.extender.inc.php` &multiTvFilterBy=`event`  &multiTvFilterOptions=`[{"name":"title","type":"text","value":"Important","mode":"contains"}]`!]

где:

• &extenders=`@FILE assets/tvs/multitv/dittoExtender/multitvfilter.extender.inc.php` - имя используемого расширения
• &multiTvFilterBy=`event` - имя переменной шаблона multiTv, по которой происходит фильтрация
• &multiTvFilterOptions=`[{"name":"title","type":"text","value":"Important","mode":"contains"}]` - исключить элементы, у которых в столбце title не содержится Important