DLSiblings: Вывод соседних ресурсов с шаблонизацией
- Дополнения
- DLSiblings
DLSiblings: Вывод соседних ресурсов с шаблонизацией
Вывод соседних ресурсов с шаблонизацией (множественная кольцевая перелинковка)
Скачивать здесь: DLSiblings
Параметры сниппета:
&idType, &parents, &documents, &ignoreEmpty
- как в ДокЛистере.
&Qty
(целое), кол-во предыдущих и следующих соседей. Имеет приоритете над &prevQty и &nextQty.
Если &Qty=`3`, то общее кол-во будет 6 - то есть 3 перед и 3 после.
Значение по умолчанию: 2.
&prevQty
Кол-во соседей-предшественников. Приоритет меньше $Qty
Значение по умолчанию:default 2
&nextQty
Кол-во соседей-последователей. Приоритет меньше $Qty
Значение по умолчанию: 2
Также можно использовать унаследованные от DocLister (такие же, как у него): условия выборки &addWhereList и &filters, условия сортировки &orderBy, глубина выборки &depth, prepare, многие другие параметры.
Нужно лишь понимать, имеют ли смысл эти параметры в вызове. Например, если задать &idType=`documents` и &documents=`1,2,3` (всего 3 документа), а &Qty задать как 6, то выводиться все равно будут всегда эти 3 документа - смысла в этом нет.
Параметры-исключения:
- режим api принудительно устанавливается в 1 (нет смысла задавать в сниппете)
- режим debug устанавливается в 0 (также нет смысла задавать).
- параметр &display принудительно устанавливается в &display=`0`, так как за кол-во отвечают параметры &Qty, &prevQty и &nextQty.
Шаблоны сниппета
- &ownerTPL, шаблон-обертка аналогично DocLister, но плейсхолдер НЕ [+dl.wrap+], а [+wrap+]. Значение по умолчанию null (вывод не оборачивается в ownerTPL).
- &tpl, &tplOdd и &tplEven, &tplIdN, &tplFirst и &tplLast Шаблоны элемента как в DocLister в порядке увеличения приоритета.
- &noneTPL Шаблон с информацией, что ничего нет, как в DocLister. По умолчанию - пусто.
- &noneWrapOuter Как в DocLister, оборачивать ли шаблон noneTPL в обёртку ownerTPL. Параметр &noneWrapOuter имеет смысл, только если ничего не нашлось и при этом задан ownerTPL.
Другие шаблоны DL не используются.
ВНИМАНИЕ:
!!! В шаблонах сниппета плейсхолдеры ТВ-параметров записываются НЕ через точку, а через нижнее подчеркивание. То есть, будет не [+tv.h1+], а [+tv_h1+]. То же самое касается экстендеров, например экстендера e: вместо [+e.title+] пишем [+e_title+].
В общем, в плейсхолдерах шаблонов (только в них!) все точки меняем на нижнее подчеркивание (см. примеры вызова сниппета ниже).
ПРИМЕРЫ
Пример 1: Простой вызов сниппета.
[[DLSiblings? &idType=`parents` &parents=`152` &tpl=`@CODE: <a href="[+url+]">[+tv_h1+]</a><br>` &Qty=`2` &tvList=`h1` ]]
Пример 2: Более сложный пример с prepare и превьюшками FastImage
[[DLSiblings? &idType=`parents` &parents=`152` &thumbSnippet=`sgThumb` &thumbOptions=`{"tv.article_intro_img":{"small":"280x160","medium":"700x400"}}` //Здесь НЕ надо менять точку на подчеркивание (это не шаблон) &ownerTPL=`@CODE:<div class="row latest-news inline-showcase">[+wrap+]</div><hr>` &tpl=`@CODE: <div class="column col-1-1-2-4-4 margin-bottom-30"> //А здесь везде надо менять (это шаблон) <div class="article-announce-img"> <img class="img-responsive" src="[+tv_article_intro_img_medium+]" alt="[+e_title+] | [(cfg_company_brand_name)]"> </div> <div class="article-announce-content"> <div class="article-announce-header"> <a href="[+url+]">[+tv_h1+]</a> </div> </div> <a href="[+url+]" class="wrapper-link"></a> </div>` &Qty=`2` &tvList=`article_intro_img,h1` &prepare=`FastImagePreviews` ]]
Примечание: Это только примеры. Для того, чтобы они заработали на вашем сайте, у вас должны быть такие же TV и такие же prepare-сниппеты.
Результат работы примера 2
Скорость работы
1) Кол-во запросов и т.д. при кешированном вызове сниппета на кешированном ресурсе на микро-сайте, выборка 4 из 8 статей с сортировкой
&orderBy=`if(pub_date=0,createdon,pub_date) DESC`
2) Кол-во запросов и т.д. при некешированном вызове сниппета на кешированном ресурсе на микро-сайте, выборка 4 из 8 статей с сортировкой
&orderBy=`if(pub_date=0,createdon,pub_date) DESC`
Недостатки
- Длинная JSON-строка, содержащая все поля, в том числе контент (расход памяти)
- Формирование доп. индексного массива $ids (время)
- В результате сниппет подойдет для не очень больших выборок (навскидку до 1-2 тыс. ресурсов), для больших сайтов требуется другое решение