База знаний
Войдите в личный кабинет для возможности задавать вопросы и отвечать на комментарии.
Полезная информация

Хелперы для плагина "Бренды PRO"

Поддержка Bodysite
Поддержка Bodysite
15 августа 2018 18:03
+1

В данной инструкции представлены "хелперы", или специальные конструкции для получения информации из плагина "Бренды PRO". В первую очередь они предназначены для технических специалистов, обладающих знаниями вёрстки или доработки магазинов на Shop-script. Пожалуйста, имейте в виду, что примеры вывода представлены в упрощённом виде, не используйте их в таком формате на своём сайте.

Хелперы работают при их использовании:

  • в шаблонах темы дизайна
  • в описании товаров
  • в описании категорий
  • на информационных страницах, созданных в приложении "Магазин"

Хелперы не работают:

  • на информационных страницах, созданных в приложении "Сайт".

Получить бренд по ID:

{shopBrandViewHelper::getBrand($brand_id)}

$brand_id в данном случае это внутренний индентификатор бренда в плагине. Посмотреть его можно в URL при редактировании бренда

Пример получения информации:
{$product_brand = shopBrandViewHelper::getBrand(131)}

Получаемые данные:

  • $product_brand['id']
  • $product_brand['name']
  • $product_brand['url']
  • $product_brand['image']
  • $product_brand['description_short']
  • $product_brand['product_sort']
  • $product_brand['filter']['is_shown']
  • $product_brand['filter']['enable_client_sorting']
  • $product_brand['filter']['empty_page_response_mode']
  • $product_brand['filter']['sort']

Вывод брендов товара (продукта)

{shopBrandViewHelper::getProductBrand($product)}

Вывод всех брендов

{shopBrandViewHelper::getAllBrands()}

Вывод всех брендов с изображениями (с версии 1.1): 

{shopBrandViewHelper::getAllBrandsWithImages()}

Получить картинки бренда определенного размера

{$brand->getImageUrl('970')}

Получение списка брендов с товарами в наличии (c версии 1.20.0)

{shopBrandViewHelper::getBrandsWithProducts}


NEW (c версии 1.17.0):

Получить информацию бренда в карточке товара

{shopBrandViewHelper::getBrandMainPage($product)}

Например, для вывода описания бренда и доп. описания:

{$brand_page = shopBrandViewHelper::getBrandMainPage($product)}
{$brand_page.description}
{$brand_page.additional_description}

Получение списка брендов, сгруппированных по алфавиту

Хелпер:
{shopBrandViewHelper::getGroupedBrands()}

Пример получения информации

{$alphabet_brands = shopBrandViewHelper::getGroupedBrands()}
{foreach $alphabet_brands as $letter => $alphabet_brand}
  {$letter}
{foreach $alphabet_brand['brands'] as $a_brand} {$a_brand['name']} {/foreach} {/foreach}

Получаемые данные:

Array => (
    *буква бренда* => (
        'link' => *ссылка на якорь буквы в списке всех брендов*,
        'brands' => (
            'id' => ,
            'name' => ,
            'url' => ,
            'image' => ,
            'description_short' => ,
            'product_sort' => ,
            'filter' => (
                'is_shown' => ,
                'enable_client_sorting' => ,
                'empty_page_response_mode' => ,
                'sort' => 
            )
        )
    )
)
 

Вывод шаблона меню брендов, сгруппированных по алфавиту

{shopBrandViewHelper::showGroupedBrands()}

Редактирование файла шаблона доступно в настройках плагина


Примеры использования хелперов

1. Вывод картинки-ссылки на бренд в карточке товара

{$product_brand = shopBrandViewHelper::getProductBrand($product)}
{if $product_brand}
 <a href="{$product_brand.frontend_url}">
  {if $product_brand.image_url}
   <img src="{$product_brand.image_url}" alt="{$product_brand.name|escape}">
  {else}
   <span>{$product_brand.name|escape}</span>
  {/if}
 </a>
{/if}

2. Вывод ссылок на все бренды

{foreach shopBrandViewHelper::getAllBrands() as $brand}
 <a href="{$brand.frontend_url}">{$brand.name|escape}</a>
{/foreach}