Вывод в теме

Откуда брать данные

Плагин расширяет форму редактора баннеров. Имена полей формы записывают значения в rule_params[banners] соответствующего правила промоакции.

Дополнительные ключи в данных отдельного баннера:

У плагина нет собственного хелпера для темы, методов получения баннеров или обработчика вывода на витрине. Используйте тот код получения и перебора промобаннеров, который уже есть в вашей теме. Проверьте, что он передаёт дополнительные ключи в шаблон баннера.

Универсального имени файла темы для вставки кода нет: найдите шаблон, в котором ваша тема выводит текущий баннер.

Пример Smarty

Фрагмент ниже вставляется внутрь существующего цикла баннеров. Здесь $banner — переменная с данными одного баннера. Если в теме она называется иначе, замените имя переменной во всём фрагменте.

{if !empty($banner.advertiser_name) || !empty($banner.erid)}
    <div class="promo-advertiser">
        {if !empty($banner.advertiser_name)}
            <span>Рекламодатель: {$banner.advertiser_name|escape}</span>
        {/if}
        {if !empty($banner.erid)}
            <span>ERID: {$banner.erid|escape}</span>
        {/if}
    </div>
{/if}

{if !empty($banner.ewshopmarketing_links)}
    <ul class="promo-extra-links">
        {foreach $banner.ewshopmarketing_links as $extra_link}
            {if !empty($extra_link.name) && !empty($extra_link.link)}
                <li>
                    <a href="{$extra_link.link|escape}">{$extra_link.name|escape}</a>
                </li>
            {/if}
        {/foreach}
    </ul>
{/if}

Пример выводит только заполненные значения; ссылка показывается, если заполнены и название, и адрес. Классы promo-advertiser и promo-extra-links приведены для примера: оформление задайте средствами темы.

В этом фрагменте нет вызовов хелпера плагина: он обращается к данным баннера. Проверки !empty позволяют пропустить отсутствующие или пустые значения.

escape экранирует значения для HTML. Этот модификатор не проверяет схему URL: вводите в поле Ссылка адреса страниц, предназначенные для перехода посетителя.

Проверка интеграции

1. Заполните данные и одну дополнительную ссылку у тестового баннера, сохраните промоакцию.
2. Снова откройте редактор и проверьте сохранённые значения.
3. На витрине проверьте вывод названия рекламодателя и ERID, а также переход по ссылке.
4. Проверьте баннер с пустыми дополнительными полями: фрагмент не должен создавать для него пустые блоки.

Если данные есть в редакторе, но недоступны в шаблоне, проверьте код темы между получением промобаннеров и их выводом: он может формировать собственный сокращённый массив. Способ получения баннеров и сохранность дополнительных ключей нужно проверить на используемой версии Shop-Script и темы.