DLSiblings

    DLSiblings: Вывод соседних ресурсов с шаблонизацией

    Вывод соседних ресурсов с шаблонизацией (множественная кольцевая перелинковка).

    Вывод соседних ресурсов с шаблонизацией (множественная кольцевая перелинковка)

    Автор: Aharito

    &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

    siblings_demo_1

    Скорость работы

    1) Кол-во запросов и т.д. при кешированном вызове сниппета на кешированном ресурсе на микро-сайте, выборка 4 из 8 статей с сортировкой

    &orderBy=`if(pub_date=0,createdon,pub_date) DESC`

    siblings_requests

    2) Кол-во запросов и т.д. при некешированном вызове сниппета на кешированном ресурсе на микро-сайте, выборка 4 из 8 статей с сортировкой

    &orderBy=`if(pub_date=0,createdon,pub_date) DESC`

    siblings_requests_nocache

    Недостатки

    • Длинная JSON-строка, содержащая все поля, в том числе контент (расход памяти)
    • Формирование доп. индексного массива $ids (время)
    • В результате сниппет подойдет для не очень больших выборок (навскидку до 1-2 тыс. ресурсов), для больших сайтов требуется другое решение