Banners - fronteficaz/UcommerceDocs GitHub Wiki

Implementar banner no template

Para carregar os banners, será enviado uma array com os parâmetro desejados.

PARAMETROS VALOR NOTAS
category banner-home ou all banner-home (tipo de banner), este valor é definido no painel de admin. Em banners e em gerenciar categoria. Para exibir todas as categorias pode ser colocado o parâmetro all
format slide slide este parâmetro não é obrigatório, se nele for colocado slide a coleção de banner será transformado em um carrossel
name banner1 Para exibir um banner especifico, é retornado apena um banner
post_name__in ['banner1', 'banner2'] ou array('banner1', 'banner2') Para exibir uma coleção de banners especifico, são colocados as slug dos banner em uma array, essa exibição não depende da categoria, por isso o parâmetro category é definido com o valor all

Exemplo

<?php banners('banners') -> getBanners(array(
    "category" => "banner-home",
    "format" => "slide"
)); ?>
    
    
    /* Exemplo de retorno
    	<div class="ucbanner ucslide">
    		<div class="ucbanner_content">
        		<img src="https://www.enderecodaloja.com.br/wordpress/wp-content/uploads/2019/03/banner_home_03.png">
   			</div>
    		<div class="ucbanner_content">
        		<img src="https://www.enderecodaloja.com.br/wordpress/wp-content/uploads/2019/03/banner_home_02.png">
            </div>
        </div>
    */

Para exibir um unico banner

Para exibir um único banner basta definir o parâmetro category com o valor all e adicionar na array o baratrometria name e coloca o valor a slug do banner, normalmente a slug do banner é o título do banner, porem escrito tudo em minusculo e causo haja espaço, é trocando por um traço.

Emeplo

banners('banners') -> getBanners(array(
    "category" => "all",
    "name" => "banner1"
));

banners('banners') -> getBanners(array(
    "category" => "all",
    "name" => "banner-home" // Causo haja espaço no titulo
));

Para exibir varios banner especificos

Para exibir uma coleção de banners especifico, são colocados as slug dos banner em uma array, essa exibição não depende da categoria, por isso o parâmetro category é definido com o valor all

Exemplo

banners('banners') -> getBanners(array(
    "category" => "all",
    "post_name__in" => ['banner1', 'banner-exemplo']
));

banners('banners') -> getBanners(array(
    "category" => "all",
    "post_name__in" => array('banner1', 'banner-exemplo')
));
⚠️ **GitHub.com Fallback** ⚠️