Manual Técnico Direct Commerce©

6 Funções da mostra_produto.asp

O Include mostra_produto.asp disponibiliza todas as funções de visualização dos produtos e departamentos na loja virutal.

Abaixo, listamos as principais funções disponibilizadas:

6.1 Sub-rotina mostra_produto

Sintaxe:
 
 Mostra_produto(srt tipo, opt str param1)

A função mostra_produto() mostra a lista de produtos dentro do site, tratando quando necessário a paginação e navegação pelos produtos e departamentos.

Abaixo, segue a lista de valores para str tipo , suas ações e respectivos parâmetros:

6.1.1 Str tipo = "normal" :

Mostra a listagem padrão de produtos e departamentos.

Recebe indiretamente o parâmetro cod_depto (passada por método POST ou GET na chamada da pagina) e mostra o(s) departamento(s) e produtos associados.

Quando chamada sem o parâmetro cod_depto, mostra a lista raiz de departamentos, de forma a permitir a navegação pelos produtos e departamentos do site.

A mascara de exibição dos produtos e departamentos segue os padrões definidos no tópico "arquivos de layout".

A string parâmetros é de preenchimento opcional e visa limitar o critério de exibição dos produtos.

Ela recebe uma sentença booleana em dialeto sql onde voce pode, por exemplo, filtrar os resultados de acordo com uma ação do site. A lista completa de campos da tabela "produtos" está disponível no capítulo variáveis de templates.

Exemplo:
 
 mostra_produto "normal", "desc4_produto='masculino' "

Este exemplo filtraria a exibição dos produtos apenas onde o conteúdo do campo desc4_produto fosse igual a "masculino"

6.1.2 Str tipo = "produto" :

Mostra apenas listagem de produtos, sem departamentos. Utilizada normalmente para mostrar-se detalhes de um produto.

O Parâmetro recebido é um filtro em dialeto sql afim de informar o produto à ser exibido, como no exemplo abaixo:

Exemplo:
 
 mostra_produto "produto", "cod_produto=" & request("cod_produto")

Este exemplo mostra apenas o produto cujo código é recebido pelo parâmetro "cod_produto" na chamada da página.

6.1.3 Str tipo = "promocao" :

Mostra apenas os produtos que estão em promoção. Não aceita parâmetros em param1.

Exemplo:
 
 mostra_produto "promocao", ""

6.1.4 Str tipo = "pesquisa" :

Pesquisa na base de dados os produtos e departamentos pela string passada pelo parâmetro param1.

Apenas os campos código, nome, descrição resumida.

Exemplo:
 
 mostra_produto "pesquisa", request("searchtext")

O exemplo acima mostra os resultados da pesquisa pela variável searchtext passada por método post ou get à pagina.

6.1.5 Str tipo = "pesquisa-fulltext" :

O parâmetro acima trabalha da mesma forma que o tipo "pesquisa", porém utiliza uma outra forma de pesquisa no banco de dados, a pesquisa por linguagem natural. Esta pesquisa normalmente mostra resultados mais precisos, porém não responde por parte de palavras.

6.1.6 Str tipo = "vitrine" :

O parâmetro vitrine mostra a vitrine da loja. Os parâmetros de visualização são passados por meio de flag's locais (veja lista completa em tópico abaixo)

Exemplo:
 
 ind_vitrine_rotativa = true
 max_prod_vit_rot = 3
 
 mostra_produto "vitrine", ""

6.2 Flag's locais

As flag's locais controlam diversos parâmetros de disponibilização dos produtos e devem ser setadas antes da chamada da função.

Segue abaixo a lista de flag's e seu uso:

6.2.1 Boolean display_depto

Configura se a função mostrará a lista de departamentos ou não. O valor padrão depende do tipo de ação solicitada em mostra_produto()

6.2.2 Boolean display_produto

Configura se a função mostrará a lista de produtos ou não. Seu default depende do tipo de ação solicitada em mostra_produto()

6.2.3 str path_header_depto_default

Path relativo ao diretório raiz do site do arquivo template do cabeçalho da área de departamentos.

Exemplo:
 
 path_header_depto_default = "header_depto.asp"
 mostra_produto "normal", ""

O exemplo acima utilizará o arquivo http://www.seusite.com.br/header_depto.asp como header da área de departamentos

6.2.4 str path_layout_depto_default

Path relativo ao diretório raiz do site do arquivo template do conteúdo dos departamentos.

6.2.5 str path_footer_depto_default

Path relativo ao diretório raiz do site do arquivo template do rodapé da area de departamentos.

6.2.6 str path_header_produto_default

Path relativo ao diretório raiz do site do arquivo template do rodapé da área de produtos.

6.2.7 str path_layout_produto_default

Path relativo ao diretório raiz do site do arquivo template do conteúdo dos produtos.

6.2.8 str path_layout_vitrine_default

Path relativo ao diretório raiz do site do arquivo template do conteúdo de cada produto dentro da tabela da vitrine.

6.2.9 str header_tabela_vitrine

Cabeçalho da tabela que monta a vitrine, em HTML. O valor padrão é:

header_tabela_vitrine = "<table align=""center"" 
           cellpadding=""1"" cellspacing=""1"" 
           border=""0"" width=""100%"">"

6.2.10 str header_tr_vitrine

Cabeçalho da linha (<tr>) da tabela de vitrine. O valor default é:

header_tr_vitrine = "<tr align=""center"" valign=""middle"">"

6.2.11 str header_td_vitrine

Cabeçalho da coluna (<td>) da tabela de vitrine. O valor padrão é:

header_td_vitrine = "<td>"

6.2.12 str footer_tr_vitrine

Rodapé da linha (</tr>) da tabela de vitrine. O valor default é:

footer_tr_vitrine = "</tr>"

6.2.13 str footer_td_vitrine

Rodapé da coluna (</td>) da tabela de vitrine. O valor padrão é:

footer_td_vitrine = "</td>"

6.2.14 str footer_tabela_vitrine

Rodapé da tabela que monta a vitrine, em HTML. O valor padrão é:

footer_tabela_vitrine = "</table>"

6.2.15 boolean ind_vitrine_rotativa

Flag que controla a exibição dos produtos de forma randômica na vitrine do site. O valor padrão da variável é false.

6.2.16 int max_prod_vit_rot

Número máximo de produtos mostrados na vitrine rotativa. O valor padrão é 9

6.2.17 int num_coluna_vitrine

Número de colunas da vitrine. O valor badrao é 3.
O número de linhas varia de acordo com a quantidade de produtos à ser exibida.

6.3 Sub-rotina lista_depto

Sintaxe:
 
 lista_depto(largura_tabela, altura_td, css_tabela, 
           css_link, css_link_atual, url_mecanica_produtos)

Constrói a lista de departamentos da loja dentro de uma tabela. os parâmetros são:

6.3.1 str largura_tabela

Valor da largura da tabela à ser gerada. O valor pode ser passado em pixel ou em porcentagem.

6.3.2 str altura_td

Altura da coluna da tabela. O valor pode ser passado em pixel ou em porcentagem.

6.3.3 str css_tabela

Nome do css à ser aplicado na tabela.

6.3.4 str css_link

Nome do css do link normal dos departamentos.

6.3.5 str css_link_atual

Nome do css do departamento atual (clicado por último)

6.3.6 str url_mecanica_produtos

Path relativo (a raiz do site) da mecânica de exibição dos produtos.

6.3.7 Exemplos de chamada:

Exemplos:
 
 lista_depto "100%" , "19", "" , "depto", "deptolinks" , "default.asp?id_menu=2"
 
 Ou:
 
 lista_depto "50" , "25", "" , "depto", "depto_selecionado" , "produtos.asp"