Show Menu
TÓPICOS×

Modelos

Modelos

Tags de modelo de apresentação

Uma lista de tags e atributos de pesquisa/comercialização do site para modelos de apresentação.
Um modelo de apresentação é um arquivo HTML que inclui marcas de modelo de apresentação definidas pela pesquisa/comercialização do site. Essas tags indicam como os resultados da pesquisa que os clientes veem são formatados.
Consulte Sobre Modelos .
Você pode selecionar entre os seguintes grupos de tags de apresentação:

Declarações

Declarações são tags de declaração guiadas especiais que podem ser definidas na parte superior de um modelo de apresentação de nível superior. Quaisquer declarações subsequentes são ignoradas, incluindo declarações em modelos incluídos.
Adicionar tag
Descrição
1
<guided-content-type-header content="content-type">
Por padrão, o modelo de apresentação é enviado de volta com um tipo mime de text/html. Você pode alterar o tipo de conteúdo usado com essa tag.
Declarar esta tag o mais alto possível no modelo de apresentação. Não adicione outro texto na mesma linha com essa tag.
2
<guided-xml-declare [charset="charset"]>
Se estiver retornando XML, você pode usar essa tag para criar a declaração XML. Torne esta tag a primeira linha do modelo de apresentação. Quando você usa essa tag, o tipo de conteúdo é automaticamente definido como text/xml, a menos que você a substitua por <guided-content-type-header> na primeira linha. Se você não especificar um charset, o padrão será UTF-8. Essa tag resulta na seguinte saída no documento XML:
<?xml version="1.0" encoding="charset-name" standalone="yes" ?>

Resultados

Adicionar tag
Descrição
1
<guided-results [gsname="search-name"]></guided-results>
A tag guided-results define os limites de um loop de resultados. Qualquer conjunto de resultados pode ser acessado especificando um atributo gsname . Se nenhum gsname for fornecido, os resultados de pesquisa padrão serão exibidos.
2
<guided-result-link [gsname="fieldname"] [Zbigniew="value"]+></guided-result-link>
Para criar um link para um determinado resultado, use a tag guided-result-link . Ao definir um atributo gsname , você pode usar um campo do índice em vez da tag "loc" padrão que faz referência ao "search-url". Quaisquer outros atributos, como classe e destino, também podem ser transmitidos, que são enviados na tag âncora resultante.
3
<guided-result-img gsname="fieldname" [Zbigniew="value"]+>
A tag <guided-result-img> ajuda a criar tags de imagem em vez de incorporar variáveis dentro de uma tag img .
Especifique o campo a ser usado para o caminho da imagem no atributo gsname . O resultado é uma tag img com qualquer atributo HTML padrão que você definiu e passou. Então, o exemplo a seguir:
<guided-result-img gsname="thumbnail"  class="thumb" border="0"/>
becomes:
<img src="prod8172.jpg" class="thumb"  border="0"/>
4
<guided-result-field gsname="fieldname" [escape="html|url|js|json|ijson|0"]/>
Qualquer informação a ser apresentada nos resultados é exibida como uma tag <guided-result-field> (exceto ao usar tags de geração automática, como a tag <guided-result-img> ).
Especifique o nome do campo Índice de pesquisa no gsname . A string exata transmitida é saída no modelo.
Você pode especificar uma opção de escape se desejar que esse campo escape seja diferente do que foi especificado no modelo de transporte.
Essa codificação é aplicada sobre qualquer codificação especificada no modelo de transporte.
5
<guided-if[-not]-result-field gsname="fieldname></guided-if-result-field>
Esse conjunto de tags condicionais é verdadeiro se houver conteúdo no campo específico a ser exibido. Se nenhum conteúdo existir, a condição será false. Você pode usar as tags para decidir se o HTML ao redor será exibido ou não se houver um valor ou se uma imagem diferente será exibida, e assim por diante.
<guided-if-result-field gsname="thumbnail">     <guided-result-img gsname="thumbnail" class="thumb" /> <guided-else-result-field>     <img src="nothumb.jpg" class="nothumb" /> </guided-if-result-field>
6
<guided-if[-not]-result-wrap> <guided-else-result-wrap> </guided-if[-not]-result-wrap>
Ao exibir resultados em colunas, essa tag é usada para identificar se o resultado atual marca o final de uma coluna.
Quando a condição Booliana for verdadeira, o HTML será adicionado ao final do resultado para finalizar a linha e iniciar uma nova. Quando for a última, uma nova linha não será iniciada.
Consulte <guided-if-not-last> para saber mais sobre essa tag.
<guided-if-result-wrap>      </div>      <guided-if-not-last>          <div>      </guided-if-not-last>  </guided-if-result-wrap>
7
<guided-results-found [gsname="search name"]/>
Retorna um 1 se a solicitação de pesquisa de back-end retornar resultados e 0 se não tiver retornado. Se nenhum gsname for especificado, a tag assumirá a pesquisa primária. Essa tag é útil para passar lógica para rotinas JavaScript.
8
<guided-results-total [gsname="search name"]/>
Retorna o número total de resultados no conjunto de resultados especificado. Assume a pesquisa padrão quando nenhum gsname é fornecido.
9
<guided-results-lower [gsname="search name"]/>
Retorna o número de resultado menor na página para o conjunto de resultados especificado. Assume a pesquisa padrão quando nenhum gsname é fornecido.
10
<guided-results-top [gsname="search name"]/>
Retorna o número do resultado superior na página para o conjunto de resultados especificado. Assume a pesquisa padrão quando nenhum gsname é fornecido.
11
&amp;lt;/guided-if[-not]-results-found&amp;gt; &lt;/code> &lt;/p> &lt;/td>

Mostra o conteúdo quando os resultados são encontrados. Ou não mostra nenhum resultado HTML quando os resultados não são encontrados.
<guided-if-results-found gsname="products">     <guided-results gsname="products">         ...     </guided-results> <guided-else-results-found>      No results were found. </guided-if-results-found>
12
<guided-result-title/>
A tag <guided-result-title> fornece o valor do campo do modelo de transporte de título especificado com a tag de transporte <title> .
13
<guided-result-description/>
A tag <guided-result-description> fornece o valor do campo do modelo de transporte de descrição especificado com a tag de transporte <description> .
14
<guided-result-loc/>
A tag < guided-result-loc> fornece o valor do campo do modelo de transporte loc especificado com a tag de transporte <loc> .
15
&amp;lt;/guided-if-result-field&amp;gt; &lt;/code> &lt;/p> &lt;/td>

True se houver conteúdo no campo específico a ser exibido. Se nenhum conteúdo existir, a condição será false. Use as tags para decidir se o HTML circundante será exibido ou não se um valor não existir ou se uma imagem diferente for exibida e assim por diante.
<guided-if-result-field gsname="thumbnail">      <guided-result-img gsname="thumbnail" class="thumb"/> <guided-else-result-field>      <img src="nothumb.jpg" class="nothumb"/> </guided-if-result-field>
16
<guided-result-attribute-table gsname="tablename">
Esta tag fornece um loop pela tabela de atributos definida no modelo de transporte com a tag de transporte <attribute_table> . Há <guided-result-attribute-table-field> tag para exibir valores de campos de tabela de atributos. Além disso, é possível usar uma tag de campo de resultado simples guiada dentro do loop para exibir outros campos de resultado.
17
<guided-result-attribute-table-field gsname="fieldname" [escape="html|url|js|json|0"]/>
Exibe o campo da tabela de atributos, conforme definido no modelo de transporte.
...
    
    &amp;lt;ul&amp;gt;
    
    &amp;lt;guided-result-attribute-table&amp;nbsp;gsname=&quot;downloads&quot;&amp;gt;
    &amp;nbsp;&amp;nbsp;lt;li&amp;gt;
    &amp;nbsp;&amp;nbsp;&amp;nbsp; amp;nbsp;&amp;nbsp;&amp;lt;a&amp;href=&quot;&amp;lt;guided-result-attribute-table-field-field;nbsp;gsname=&quot;download_link&quot;&amp;nbsp;/&amp;gt;&quot;&amp;gt;
    &amp;nbsp;&amp;nbsp;; amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;lt;guided-result-attribute-table-field-field;nbsp;gsname=&quot;download_title&quot;&amp;nbsp;/&amp;gt;
    &amp;bnbsp;nbsp sp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;lt;/a&amp;gt;&amp;nbsp;(&amp;lt;guided-result-field&amp;nbsp;gsname=&quot;title&quot;/&amp;gt;)
    &amp;nbsp;;&amp;lt;/li&amp;gt;
    &amp;lt;/guided-result-attribute-table&amp;gt;
    
    &amp;lt;/ul&amp;gt;
    
    ...
    
    &amp;lt;/guided-results&amp;gt; &lt;/code> &lt;/p> &lt;/td>

18
<guided-trace [gsname="search name"]/>
Gera as informações de rastreamento encontradas nos dados de rastreamento na seção geral da saída de dados JSON pelo modelo de transporte para a pesquisa em questão.
Se nenhum nome de pesquisa for fornecido, o padrão será assumido.
19
<guided-result-trace/>
Gera o conteúdo JSON encontrado em resultados > informações de rastreamento da saída de dados JSON pelo modelo de transporte para o resultado da pesquisa atual.
Essa tag é válida somente no loop <guided-results></guided-results> .

Aspectos

As facetas são componentes de navegação que permitem detalhar os resultados da pesquisa. Você pode usar as marcas de aspecto para exibir várias facetas no modelo de apresentação. Você faz referência a aspectos por nome.
Consulte Sobre aspectos .
Consulte Sobre aspectos dinâmicos.
Adicionar tag
Descrição
1
<guided-dynamic-facets></guided-dynamic-facets>
Um contexto de loop para quaisquer aspectos dinâmicos de uma determinada pesquisa.
A tag do modelo de apresentação <guided-facet> é editada para que o atributo gsname seja automaticamente fornecido pelo contexto de loop <guided-dynamic-facets> .
2
<guided-facet-display-name gsname=" facetname "/>
Retorna o rótulo de exibição da faceta.
Se o aspecto usar a tag <nome-de-exibição> no modelo de transporte, o conteúdo dessa tag se tornará o rótulo.
3
<guided-facet-Rail></guided-facet-Rail>
Define uma seção do modelo de apresentação que é usada como um padrão de repetição para cada faceta no painel de facetas.
Cada aspecto que pertence ao painel de facetas usa esta seção para avaliar sua saída.
A seguir está um exemplo de um painel de facetas:
<guided-facet-rail>   <guided-facet>     <guided-facet-display-name/>     ...     </guided-facet>   </guided-facet-rail>
Observe que as tags a seguir não precisam do atributo gsname quando a tag <guided-facet-Rail> estiver localizada dinamicamente no momento da pesquisa e for substituída corretamente:
  • aspecto guiado
  • facet guided-display-name
  • contagem total de facetas guiadas
  • link guided-facet-undo
  • guided-facet-undo-path
  • comportamento de faceta guiada
Os critérios de classificação na página Facet Rail determinam a posição das facetas. Você pode escolher a ordem de classificação na lista suspensa Método de classificação de aspectos.
Como opção, essa tag pode aceitar um valor de atributo gsname de _dynamic_facets , que fornece um contexto de loop para quaisquer aspectos dinâmicos para essa pesquisa. Esse painel de facetas predefinido também é exposto na interface do usuário de Regras comerciais para o faceta de push de ação X no painel de facetas '_dynamic_facets' para posicionar Y ".
Consulte também Sobre aspectos dinâmicos .
4
<guided-facet gsname=" facetname " height=" 60px " width=" 120px "></guided-facet>
Use a tag de aspecto guiado para definir uma área dentro da qual todas as tags de aspecto se relacionam a uma faceta específica. Essa tag também é uma tag booleana que oculta todo o conteúdo se não houver valores na faceta. Nesse caso, não faz sentido ultrapassar os valores de faceta).
Os atributos de altura e largura são opcionais e as dimensões são especificadas em pixels (px). O Visual Rule Builder (VRB) usa esses dois atributos e exibe uma caixa pontilhada como um espaço reservado interativo quando a faceta está oculta.
Quando o nome de exibição está na faceta e a faceta está oculta, o nome também fica oculto. No entanto, se o nome estiver fora da faceta, você poderá ocultar o nome somente se uma tag zone ou uma tag guided-if-facet-visible estiver envolvida.
5
<guided-if[-not]-facet-long [gsname="facetname"]></guided-if[-not]-facet-long>
Essa tag condicional é verdadeira quando o número de valores de aspecto está acima do limite de comprimento definido na configuração. Use-o para exibir uma faceta como um elemento de interface diferente (como uma lista truncada ou uma caixa de rolagem) quando a lista for muito longa.
<guided-facet name="category">     <guided-if-facet-long>         <select>             <guided-facet-values>                 <guided-facet-option />             </guided-facet-values>         </select>     <guided-else-facet-long>         <guided-facet-values>             <guided-facet-value-link><guided-facet-value /></guided-facet-link>         </guided-facet-values>     </guided-if-facet-long> </guided-facet>
Você também pode usar essa condição fora do contexto de um bloco guided-facet nomeado referenciando uma faceta específica diretamente pelo uso do atributo gsname .
<guided-if-facet-long gsname="category">     The category facet is very long! </guided-if-facet-long>
6
<guided-if[-not]-facet-seleted [gsname="facetname"]></guided-if[-not]-facet-seleted>
Essa tag condicional é verdadeira quando a faceta é clicada pelo menos uma vez e um valor de faceta é selecionado no momento. É usado para mostrar ou ocultar tags HTML ou gs, dependendo se uma faceta foi clicada.
<guided-facet name="category">     <guided-if-facet-selected>         This facet has been selected.  You can no longer refine it.     <guided-else-facet-selected>     <guided-facet-values>         <guided-facet-value-link><guided-facet-value /></guided-facet-link>     </guided-facet-values>     </guided-if-facet-selected> </guided-facet>
Você também pode usar essa condição fora do contexto de um bloco guided-facet nomeado referenciando uma faceta específica diretamente pelo uso do atributo gsname .
<guided-if-facet-selected gsname="category">     The category facet is selected! </guided-if-facet-selected>
7
<guided-if[-not]-facet-single [gsname="facetname"]></guided-if[-not]-facet-single>
Essa tag condicional é verdadeira quando há apenas um valor de aspecto. Use a tag para alterar a exibição da faceta quando ela não puder refinar os resultados.
<guided-facet name="category">     <guided-if-facet-single>         Facet is not refinable.     <guided-else-facet-single>         <guided-facet-values>             <guided-facet-value-link><guided-facet-value /></guided-facet-link>         </guided-facet-values>     </guided-if-facet-single> </guided-facet>
Você também pode usar essa condição fora do contexto de um bloco guided-facet nomeado referenciando uma faceta específica diretamente pelo uso do atributo gsname .
<guided-if-facet-single gsname="category">     There is only one value in the category facet! </guided-if-facet-single>
8
<guided-if[-not]-facet-multiselect [gsname="facetname"]></guided-if[-not]-facet-multiselect>
Essa tag condicional é verdadeira quando a faceta é de seleção múltipla. Use a tag para alterar a exibição da faceta dentro das tags <guided-facet-Rail> ou <guided-dynamic-facets> .
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;lt;guided-if-facet-multiselect&amp;gt;
    &amp;nbsp;...
    &amp;nbsp;&amp;lt;guided-else-facet-multiselect&amp;gt;
    &amp;nbsp;...
    &amp;nbsp;&amp;lt;/guided-if-facet-multiselect&amp;gt;
    &amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;...
    &amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;lt;/guided-facet&amp;gt;
    &amp;nbsp;&amp;nbsp;&amp;lt;/guided-facet-Rail&amp;gt; &lt;/code> &lt;/p> &lt;/td>

9
<guided-facet-values [gsname=" facetname "]></guided-facet-values>
Esta é a marca iteradora de loop de valor de aspecto. Você pode defini-lo no contexto de um bloco de facetas guiadas nomeado , e nesse caso, pode omitir o gsname . Ou você pode defini-lo fora de qualquer bloco de faceta guiada, mas isso requer o atributo gsname para identificar qual conjunto de valores de faceta é exibido.
Você também pode usar essa tag para exibir os valores de aspecto fora do contexto de um bloco guiado com nome de faceta. Você faz referência direta a uma faceta específica usando o atributo gsname .
<script>      registerFacetValues('category', '<guided-facet-values gsname="category"><guided-facet-value/>,</guided-facet-values>'); </script>
10
<guided-facet-value [escape="html|url|js|json|0"]/>
Gera a string do valor de aspecto atual.
Por padrão, o valor é de escape HTML. Você pode usar a opção de escape para alterar como o valor é escapado.
11
<guided-facet-count/>
Gera o número de resultados que correspondem ao valor de aspecto atual.
12
<guided-facet-value-link [nome="valor"]+></guided-facet-value-link>
Cria um link em torno da string de valor da faceta para o visitante do site clicar. O caminho é gerado automaticamente para restringir os resultados pelo valor de aspecto atual. Ele suporta a transmissão de qualquer atributo diretamente para a tag âncora.
<guided-facet-values>     <guided-facet-value-link class="facetlink"><guided-facet-value /></guided-facet-value-link> </guided-facet-values>
13
<guided-if-facet-value-selected> <guided-else-facet- value-selected> </guided-if-facet-value-selected>
Altera a exibição do valor da faceta quando está selecionado no momento. Se já foi escolhida, na maioria dos casos, já não é passível de ligação.
<guided-facet-values>      <guided-if-facet-value-selected>          <b><guided-facet-value/></b>      <guided-else-facet-value-selected>          <guided-facet-link><guided-facet-value/></guided-facet-link>         </guided-if-facet-value-selected> </guided-facet-values>
14
&amp;lt;/guided-if[-not]-facet-value-ghost&amp;gt; &lt;/code> &lt;/p> &lt;/td>

Altera a exibição do valor da faceta quando ele é um valor fantasma. Quando um valor de faceta é um valor fantasma, geralmente é exibido em itálico para indicar que o valor está ausente ou "duplicado".
O seguinte trecho de código é um exemplo de um bloco de facetas:
<guided-facet-values>     <guided-if-facet-value-selected>         <b><guided-facet-value /> (<guided-facet-count />)</b>             <guided-else-facet-value-selected>                 <guided-if-facet-value-ghost>                     <i><guided-facet-value /> (0)</i>                 <guided-else-facet-value-ghost>             <guided-facet-link class="link"><guided-facet-value /></guided-facet-link> (<guided-facet-count />)         </guided-if-facet-value-ghost>     </guided-if-facet-value-selected> </guided-facet-values>
15
<guided-facet-undo-link gsname=" facetname "></guided-facet-undo-link>
Exibe um link desfazer para uma determinada faceta. Se houver aspectos de seleção múltipla, esse link cancela a seleção de todos os valores da faceta. Dê um nome à faceta. Se a faceta não estiver selecionada no momento, o link será o caminho atual.
Este é um exemplo do uso desta tag:
<guided-if-facet-selected gsname="category">     <guided-facet-undo-link gsname="category">Undo Category</guided-facet-undo-link> </guided-if-facet-selected>
16
Essa tag condicional é verdadeira quando o número de valores de aspecto está acima do limite de comprimento definido na configuração. Use-o para exibir uma faceta como um elemento diferente da interface do usuário (como uma lista truncada ou uma caixa de rolagem) quando a lista for muito longa.
<guided-facet gsname="category">      <guided-if-facet-long>          <div class="long_facet">              <guided-facet-values>                  <guided-facet-link><guided-facet-value/></guided-facet-link>              </guided-facet-values>          </div>      <guided-else-facet-long>          <div class="facet">              <guided-facet-values>                  <guided-facet-link><guided-facet-value/></guided-facet-link>              </guided-facet-values>          </div>      </guided-if-facet-long>  </guided-facet>
Você também pode usar essa condição fora do contexto de um bloco guided-facet nomeado , referenciando uma faceta específica diretamente pelo uso do atributo gsname .
<guided-if-facet-long gsname="category">      The category facet is very long! </guided-if-facet-long>
17
<guided-if-facet-selected [gsname="facetname"]> <guided-else-facet-selected></guided-if-facet-selected>
Essa tag condicional é verdadeira quando a faceta é clicada pelo menos uma vez e um valor de faceta é selecionado no momento. Ele pode ser usado para mostrar ou ocultar tags HTML ou gs, dependendo se uma faceta é clicada.
<guided-facet gsname="category">      <guided-if-facet-selected>          This facet has been selected.  You can no longer refine it.      <guided-else-facet-selected>          <guided-facet-values>              <guided-facet-link><guided-facet-value/></guided-facet-link>          </guided-facet-values>      </guided-if-facet-selected> </guided-facet>
Você também pode usar essa condição fora do contexto de um bloco guided-facet nomeado referenciando uma faceta específica diretamente pelo uso do atributo gsname .
<guided-if-facet-selected gsname="category">      The category facet is selected! </guided-if-facet-selected>
18
Essa tag condicional é verdadeira quando há apenas um valor de aspecto. Ele pode ser usado para alterar a exibição da faceta quando não tem capacidade de refinar os resultados.
<guided-facet gsname="category">      <guided-if-facet-single>          Facet is not refinable.      <guided-else-facet-single>          <guided-facet-values>              <guided-facet-link><guided-facet-value/></guided-facet-link>          </guided-facet-values>      </guided-if-facet-single> </guided-facet>
Você também pode usar essa condição fora do contexto de um bloco guided-facet nomeado , referenciando uma faceta específica diretamente pelo uso do atributo gsname .
<guided-if-facet-single gsname="category">      There is only one value in the category facet! </guided-if-facet-single>
19
Essa condição permite verificar se a faceta especificada tem algum valor. Você pode usá-lo para mostrar outra faceta em vez de uma vazia.
20
<guided-facet-total count gsname=" facetname "/>
Gera o número total de resultados que estão dentro de uma determinada faceta.
21
<guided-facet-value gsname=" valor de aspecto personalizado associado " [escape="html|url|js|json|0"]/>
Gera a string de um valor associado à faceta. É possível ter 0 ou mais campos associados a uma faceta. Ter campos associados é raro e, portanto, configurar o modelo de transporte.
22
<guided-if-facet-value gsname=" valor de faceta personalizado associado "/><guided-else-facet-value></guided-if-facet-value>
Testa se o valor de aspecto tem um valor de campo associado.
23
<guided-facet-link [attribute=" value "]+></guided-facet-link>
Cria um link em torno da string de valor da faceta para o cliente clicar. O caminho é gerado automaticamente para restringir os resultados pelo valor de aspecto atual. Ele suporta a transmissão de qualquer atributo diretamente para a tag âncora.
<guided-facet-values>      <guided-facet-link class="facetlink"><guided-facet-value/></guided-facet-link> </guided-facet-values>
24
<guided-facet-value-path [escape="html|url|js|json|0"]/>
Cria seu próprio link para um valor de faceta.
<guided-facet-values>      <guided-lt/>a href="<guided-facet-value-path/>"<guided-gt/><guided-facet-value/></a> </guided-facet-values>
Por padrão, o valor é um URL escapado. Entretanto, é possível adicionar outra camada de codificação especificando qual modo de escape você deseja usar por meio do parâmetro de escape.
25
<guided-facet-value-child></guided-facet-value-child>
Conforme <guided-facet-values> repete por cada valor de aspecto, essa tag repete todos os valores filho de uma faceta aninhada. Dentro dessa tag, use as tags facetas típicas para criar links, criar links desfazer e exibir valores de facetas. Essa tag deve estar dentro de <guided-facet-values> porque ela possui loops aninhados.
Um exemplo de uso dessa tag é o seguinte:
<guided-facet-values>   <guided-facet-link title='<guided-facet-value />'><guided-facet-value /> (<guided-facet-count />)</guided-facet-link>   <guided-if-facet-value-has-children>    <guided-facet-value-children>     <guided-facet-link title='<guided-facet-value />'><guided-facet-value /> (<guided-facet-count />)</guided-facet-link>    </guided-facet-value-children>   </guided-if-facet-value-has-children> </guided-facet-values>
26
<guided-if-facet-value-has-children> <guided-else-facet- value-has-children> </guided-if-facet-value-has-children>
Testa se o valor de aspecto atual tem valores secundários. Recomendado para usar antes de usar as tags <guided-facet-value-child> . A cláusula "else" é opcional.
27
&amp;lt;guided-else[-not]-facet-value-above-length-limit&amp;gt;
    
    &amp;lt;/guided-if[-not]-facet-value-above-length-limit&amp;gt; &lt;/code> &lt;/p> &lt;/td>

Determina se o valor de aspecto atual dentro do loop de valores de aspecto está acima do limite de comprimento. Normalmente, é usado para exibir apenas valores abaixo do limite em uma faceta longa (a menos que o usuário tenha selecionado anteriormente um link "Ver mais" exibido abaixo da faceta).
28
&amp;lt;guided-else[-not]-facet-value-equals-length-limit&amp;gt;
    
    &amp;lt;/guided-if[-not]-facet-value-equals-length-limit&amp;gt; &lt;/code> &lt;/p> &lt;/td>

Determina se o valor de aspecto atual dentro do loop de valores de aspecto é igual ao limite de comprimento.
29
<guided-facet-value-undo-link></guided-facet-value-undo-link>
Exibe um link desfazer para um determinado valor de aspecto selecionado. Use-o para exibir um link para desfazer ao lado de um valor de faceta selecionado. Como esse link desfazer apenas desfaz esse valor selecionado em particular, ele é diferente de <guided-facet-undo-link> , que desmarca todos os valores selecionados.
Observação: Se a faceta não tiver um comportamento de seleção múltipla, os dois links desfazer terão o mesmo comportamento. Ou seja, a faceta só pode ter um valor selecionado.
Se a faceta não estiver selecionada no momento, o link será o caminho atual. Use essa tag somente em um loop de valores de aspecto guiado .
30
<guided-facet-value-undo-path/>
Crie seu próprio link para desfazer o valor da faceta.
31
<guided-facet-undo-path gsname=" facetname "/>
Crie seu próprio link de desfazer de faceta.
Semelhante à tag <guided-facet-undo-link> , exceto que ela fornece o caminho bruto para criar seu próprio link para desfazer.
32
Exibir condicionalmente o HTML quando a faceta em questão tiver o "valor" selecionado ou o valor único. Esse conjunto de tags é frequentemente usado para exibir uma faceta com base no valor selecionado em outra faceta.
33
<guided-facet-behaviour gsname=" facetname "/>
Determine o comportamento de uma faceta, como normal, fixo ou seleção múltipla. É útil para clientes que recebem resultados XML e desejam alterar dinamicamente como a faceta é exibida com base em seu comportamento.
34
&amp;lt;/guided-if-facet[-not]-visible&amp;gt; &lt;/code> &lt;/p> &lt;/td>

O conteúdo que essa tag envolve está oculto ou é revelado com base no estado de visibilidade da faceta. Se uma regra de negócios ocultar ou revelar a faceta diretamente, qualquer conteúdo dentro da faceta será oculto ou revelado. Não é necessário que essas tags se enrolem na faceta.
Um uso comum para essa tag é ocultar o nome de exibição quando o nome está fora da faceta. Vincular essa tag ao redor do nome de exibição faz com que o nome desapareça quando a faceta está oculta.
Essa tag substitui a zona e tem muitos dos mesmos benefícios de desempenho que o uso de zonas.

Trilha

Consulte Sobre Trilhas .
Adicionar tag
Descrição
1
<guided-breadcrumb [gsname=" breadcrumbname "]></guided-breadcrumb>
A tag de loop para a navegação estrutural. Qualquer conteúdo entre as tags de abertura e fechamento é repetido para cada número de consulta do estado atual.
Se gsname for omitido, então a navegação estrutural chamada "default" será usada.
2
<guided-breadcrumb-link [gsname="goto|remove|drop"] [attribute="value"]+></guided-breadcrumb-link>
Cria um link na navegação estrutural. O comportamento padrão é o comportamento "goto". Se o link se comporta de forma diferente, use o atributo opcional gsname para especificar "remove" ou "drop". Qualquer atributo incluído na tag é passado para a tag âncora resultante.
<guided-breadcrumb>      <guided-breadcrumb-link gsname="remove" class="bc_link">          <guided-breadcrumb-value/>      </guided-breadcrumb-link> </guided-breadcrumb>
3
<guided-breadcrumb-value />
A tag value imprime o valor transformado da iteração da navegação estrutural atual. É usado apenas no contexto de um bloco de navegação guiado .
<guided-breadcrumb>      <guided-breadcrumb-link>          <guided-breadcrumb-value/>      </guided-breadcrumb-link> </guided-breadcrumb>
4
<guided-breadcrumb-label />
A tag label gera um rótulo para um valor de navegação estrutural detalhando qual aspecto foi selecionado para gerar esse item de navegação estrutural. É usado apenas no contexto de um bloco de navegação guiado .
<guided-breadcrumb>      <guided-breadcrumb-link>          <guided-breadcrumb-label/>: <guided-breadcrumb-value/>      </guided-breadcrumb-link> </guided-breadcrumb>
5
<guided-if-breadcrumb-label> <guided-else- breadcrumb-label> <guided-if-breadcrumb-label />
Essa tag condicional é usada para exibir condicionalmente o conteúdo se o valor da navegação estrutural atual tiver um rótulo. É usado para exibir somente rótulos e conteúdo relacionado quando um rótulo realmente existe. É usado apenas no contexto de um bloco de navegação guiado .
<guided-breadcrumb>      <guided-breadcrumb-link>          <guided-if-breadcrumb-label>              <guided-breadcrumb-label/>:          </guided-if-breadcrumb-label>      <guided-breadcrumb-value/></guided-breadcrumb-link> </guided-breadcrumb>
6
<guided-breadcrumb-path [gsname="goto|remove|drop"]/>
Usado para criar seu próprio link de navegação estrutural.

Menus

Consulte Sobre menus .
Adicionar tag
Descrição
1
<guided-menu gsname="menuname"></guided-menu>
Esta é a tag do iterador de loop de valor de menu. Use o atributo gsname para identificar qual conjunto de itens de menu é exibido.
2
<guided-menu-item-link [att="value"]+></guided-menu-item-link>
Fornece o URL para refinar a pesquisa atual para o item de menu.
3
<menu guiado-item-option [nome="valor"]+ />
Normalmente, um menu é exibido em um controle selecionado em um modelo. Essa tag facilita a construção do controle de seleção, pois gera o HTML para gerar a opção para o controle de seleção.
Por exemplo, o seguinte bloco de código:
<select name="sort" onchange="gcGo(this);"> <guided-menu gsname="sort"> <guided-menu-item-option/> </guided-menu> </select>
Pode gerar HTML da seguinte maneira:
<select name="sort" onchange="gcGo(this);">   <option value="?sort=relevance;sp_sfvl_field=product-type|category|size;" selected="selected">Sort by Relevance</option>   <option value="?sort=avail-code;sp_sfvl_field=product-type|category|size;">Sort by Availability</option>   <option value="?sort=price;sp_sfvl_field=product-type|category|size;">Sort by Price</option> </select>
4
<guided-menu-item-value />
Retorna a string do valor associado ao menu.
5
<guided-menu-item-label />
Retorna a string do rótulo associado ao menu.
6
<guided-menu-item-path />
Retorna a string de caminho. Use a tag se desejar adicionar um parâmetro ao caminho e criar um link personalizado.
7
<guided-if-menu-item-selected> <guided-else-menu- item-selected> </guided-if-menu-item-selected>
Retorna um 1 ou 0 indicando se o item de menu atual está selecionado.

Pagenav

As tags de navegação da página podem ser usadas para criar um conjunto de links que permitem que o usuário vá até a página pelos resultados da pesquisa.
Adicionar tag
Descrição
1
<páginas guiadas></páginas guiadas>
A tag de loop para a navegação da página. Qualquer conteúdo entre as tags de abertura e fechamento é repetido para cada página.
2
<guided-page-link [att="value"]+></guided-page-link>
Cria um link na navegação da página.
3
<guided-page-link gsname="first|prev|next|last|viewall|viewpages" [nome="valor"]+></guided-page-link>
Cria um link para a primeira, a anterior, a próxima ou a última página. Ele também pode criar um link para exibir todas as páginas em uma página.
4
<guided-page-number />
Retorna uma string com o número de página atual.
5
<guided-if-page-selected> <guided-else-page- selected> </guided-if-page-selected>
Esse conjunto de tags condicionais é verdadeiro se a página que está sendo repetida no momento estiver selecionada. Normalmente, é usado para exibir de forma diferente o número da página no controle de navegação da página.
6
<guided-if[-not]-page-prev> <guided-else-page- prev> </guided-if[-not]-page-prev>
Esse conjunto de tags condicionais é verdadeiro se a página atual tiver uma página anterior. Normalmente, é usado para exibir um link anterior na navegação da página, quando faz sentido.
7
<guided-if[-not]-page-next> <guided-else-page- next> </guided-if[-not]-page-next>
Esse conjunto de tags condicionais é verdadeiro se a página atual tiver uma próxima página. Normalmente, é usado para exibir um link anterior na navegação da página, quando faz sentido.
8
<guided-if[-not]-page-viewall> <guided-else-page- viewall> </guided-if[-not]-page-viewall>
Quando uma pesquisa retorna um conjunto de resultados grande, talvez você não queira oferecer a capacidade de exibir todos os resultados. Portanto, você pode usar esse conjunto de tags condicionais para determinar quando exibir o link Exibir todos.
9
<guided-if[-not]-page-viewpages> <guided-else-page- viewpages> </guided-if[-not]-page-viewpages>
Você pode usar esse conjunto de tags condicionais para determinar quando exibir o link Exibir páginas. Normalmente, é usado para permitir que um cliente visualize determinadas páginas.
10
&amp;lt;guided-else-page-link&amp;gt;
    &amp;lt;/guided-if[-not]-page-link&amp;gt; &lt;/code> &lt;/p> &lt;/td>

Testa se a navegação da página tem uma primeira página, página anterior, próxima página e assim por diante.
11
<guided-page-total />
Retorna uma string com o número total de páginas dos resultados da pesquisa.
12
<guided-pagination gsname= "pagination_name"></guided-pagination>
Use a tag de paginação guiada para definir uma área na qual todas as tags de paginação se relacionam a uma configuração de paginação específica caso você tenha poucas Configurações de navegação de página definidas.
13
next|last|viewall|viewpages]/&amp;gt; &lt;/code> &lt;/p> &lt;/td>

Cria seu próprio link na navegação da página.
14
<guided-if-page-high-eq-last> <guided-else-page- high-eq-last> </guided-if-page-high-eq-last>
Testa se a página mais alta na navegação da página é igual ao número total de páginas.
15
<guided-if-page-low-eq-first> <guided-else-page-low-eq-first> </guided-if-page-low-eq-first>
Testa se a página mais baixa na navegação da página é igual à página.
16
<guided-if-page-is-multi-page> <guided-else-page-is-multipage> </guided-if-page-is-multipage>
Testa se há uma única página de resultados ou várias páginas de resultados.

Pesquisas recentes

Você pode usar tags de pesquisa recentes para criar um conjunto de links que permitem ao usuário executar rapidamente uma pesquisa anterior, como no exemplo a seguir:
<guided-if-recent-searches> 
    <span>Recent Searches</span><br/> 
    <guided-recent-searches> 
        <guided-recent-searches-link><guided-recent-searches-value></guided-recent-searches-link><br/> 
    </guided-recent-searches> 
    <guided-recent-searches-clear-link>Clear Recent Searches</guided-recent-searches-clear-link> 
</guided-if-recent-searches>

Consulte Configuração de pesquisas recentes.
Adicionar tag
Descrição
1
<guided-recent-search></guided-recent-search>
A tag de loop para pesquisas recentes. Qualquer conteúdo entre as tags de abertura e fechamento é repetido para cada página.
2
<guided-recent-searches-link [attr="value"]+> </guided-recent-searches-link>
Permite criar um link para uma pesquisa recente. Ele suporta a transmissão de qualquer atributo HTML diretamente para a tag âncora.
3
<guided-recent-search-path/>
Permite que você capture o caminho do URL relativo para uma pesquisa recente, dentro de um loop de pesquisa guiado-recente . Normalmente, você usaria um link de pesquisa guiado-recente- . No entanto, se você quiser criar seu próprio link, poderá usar essa tag. Este é um exemplo:
<guided-lt/>a&nbsp;href="<guided_recent_searches_path>"><guided-recent-searches-value></a>
4
<guided-recent-search-value>
Permite que você capture o termo de consulta associado a uma pesquisa recente.
5
<guided-recent-search-clear-link [nome="valor"]+></guided-recent-search-clear-link>
Permite que você ofereça aos clientes a capacidade de apagar pesquisas salvas recentemente.
6
<guided-recent-search-clear-path/>
Retorna o caminho que <guided-recent-search-clear-link> usa para criar seu próprio link.
7
&amp;lt;/guided-if-recent-search&amp;gt; &lt;/code> &lt;/p> &lt;/td>

Permite exibir as pesquisas recentes quando um cliente tiver realizado uma pesquisa recente.

Você quis dizer

Você pode usar as tags Você quis dizer para criar um conjunto de links para sugestões quando uma pesquisa não retorna resultados e o termo Pesquisa não está no dicionário da conta. Este é um exemplo de uso das tags Você quis dizer:
<guided-if-suggestions> 
    <span>Did You Mean?</span><br/> 
    <guided-suggestions> 
        <guided-suggestion-link><guided-suggestion/></guided-suggestion-link><br/> 
    </guided-suggestions> 
</guided-if-suggestions>

Adicionar tag
Descrição
1
<guided-guide-guide></guided-guide-guide>
Esta é a tag de loop para fazer loop sobre as sugestões.
2
<guided-sugestão-link [attribute="value"]+></guided-suges-link>
Cria um link para a sugestão fornecida.
3
<guided-sugestão-value />
4
<guided-if[-not]-suggestions><guided-else[-not]- suggestions></guided-if[-not]-suggestions>
Permite testar se há sugestões.
5
<guided-sugere-path/>
Retorna a string de caminho para a sugestão. Você pode usá-lo para criar sua própria tag de âncora. Geralmente, em vez disso, é usado um link de sugestão guiada.
6
<sugestões guiadas/>
Uma sugestão.
7
<guided-sugesment-result-count/>
Contagem de resultados para a sugestão.
8
<guided-if[-not]-suggestion-autosearch> <guided-else[-not]-suggestion-autosearch> </guided-if[-not]-suggestion-autosearch>
Permite testar se a pesquisa automática por sugestão em resultados zero foi realizada, caso esse recurso esteja ativado.
9
<guided-sugere-original-query/>
Retorna a consulta original se a pesquisa automática foi realizada.
Exemplo de uso:
<guided-if-suggestion-autosearch>     Search for <guided-query-param gsname="q" /> instead of <guided-suggestion-original-query /> </guided-if-suggestion-autosearch>
10
<guided-if[-not]-suggestion-low-results> <guided-else[-not]-suggestion-low-results> </guided-if[-not]-suggestion-low-results>
Essa condição é verdadeira se houver sugestões devido a uma baixa contagem de resultados, caso esse recurso esteja ativado.
Este é um exemplo de uso desta tag:
<guided-if-suggestion-low-results>    You have a low result count for <guided-query-param gsname="q" />.    Did you mean: <guided-suggestions>        <guided-suggestion-link>           <guided-suggestion />        </guided-suggestion-link><guided-if-not-last>, </guided-if-not-last>    </guided-suggestions> </guided-if-suggestion-low-results>

Completar automaticamente

As tags a seguir podem ser usadas para adicionar o preenchimento automático ao formulário de pesquisa. As tags head-content e form-content são necessárias para fazer com que o preenchimento automático funcione corretamente. É recomendável usar as tags em vez de codificar o Javascript de preenchimento automático e o CSS no modelo de apresentação. O motivo é que as tags permitem que seus modelos captem novas IDs de cache de derrota sempre que você alterar suas configurações de preenchimento automático sem a necessidade de atualizar manualmente seu modelo.
Adicionar tag
Descrição
1
<guided-if-autocomplete> <guided-else-autocomplete> </guided-if-autocomplete>
Detecta se o recurso de completar automaticamente está ativado. Você pode usar as tags para selecionar opcionalmente o cabeçalho e o conteúdo do formulário necessários para o preenchimento automático. Por sua vez, isso permite que você ative e desative o recurso e não precise alterar seus modelos de apresentação.
2
<guided-ac-css/>
Usado no cabeçalho do modelo de apresentação e substituído pelo script CSS apropriado inclui o preenchimento automático.
3
<guided-ac-form-content/>
Usado no formulário de pesquisa (entre as tags <form> e </form> ) do modelo de apresentação, em vez de codificar as tags de preenchimento automático no formulário. As tags são substituídas pelo HTML apropriado necessário para fazer o preenchimento automático funcionar.
4
<guided-ac-javascript/>
Gera os links para o JavaScript de preenchimento automático. Para obter o melhor desempenho, é recomendável colocar essa tag perto da parte inferior da página antes de fechar a tag "body".

Store

Use as seguintes tags para testar e exibir a loja em que um usuário está atualmente.
Adicionar tag
Descrição
1
<loja guiada/>
Gera a loja atual.
2
<guided-if-store-defined> <guided-else-store-defined> </guided-if-store-defined>
Detecta se o usuário está em uma loja.
3
<guided-if-store gsname="store"> <guided-else-store> </guided-if-store>
Detecta se o usuário está na loja especificada pelo parâmetro gsname .

Zonas

Adicionar tag
Descrição
1
<zona guiada gsname="zona area" [search="pesquisa associada"] [facet="aspecto associado"] [width="xx" height="yy"]>
É possível vincular qualquer conteúdo em tags de zona para criar uma zona fora dessa área. Isso permite que você use regras comerciais para exibir a zona conforme necessário. Por padrão, as zonas são sempre exibidas. Você pode usar os parâmetros opcionais de pesquisa e lapso para indicar qual pesquisa ou aspecto está associado à zona. Essa funcionalidade permite que o software ignore pesquisas ou facetas quando uma zona está oculta, melhorando o desempenho do tempo de pesquisa. Os atributos de altura e largura são opcionais e são usados para configurar como o espaço reservado é exibido no Construtor de regras visual quando uma zona é removida.
Use a tag guided-if-facet[-not]-visible em vez da tag zone onde possível. Ele simplifica o modelo de apresentação.
2
<guided-if-zone gsname="zone area"> <guided-else-zone> </guided-if-zone>
Esse conjunto de tags permite o teste se uma zona estiver sendo exibida no momento. É útil quando você tem conteúdo em outro lugar da página que você deseja exibir somente quando a zona for exibida.

Indicadores de loop

Você pode usar cada um dos seguintes indicadores de loop em qualquer um desses blocos de loop:
  • resultados guiados
  • valores de faceta guiada
  • trilha de navegação guiada
  • itens de menu guiado
  • páginas guiadas
Adicionar tag
Descrição
1
<guided-if[-not]-first><guided-else[-not]-first> </guided-if[-not]-first>
Essa condição é verdadeira quando a iteração atual é a primeira iteração do loop. Isso não significa necessariamente o primeiro resultado ou a primeira página, mas o primeiro mostrado. Se o visitante do site estiver na página 2 de um conjunto de resultados que seja 10 por página, a primeira repetição será 11.
2
<guided-if[-not]-last><guided-else[-not]-last> </guided-if[-not]-last>
Essa condição é verdadeira quando a iteração atual é a última iteração do loop. Isso não significa necessariamente o último resultado ou a última página, mas o último mostrado no contexto atual (página). Se o visitante do site estiver na página 1 de um conjunto de resultados que contenha 200 resultados, mas tenha apenas 10 resultados por página, a última iteração será 10 em vez do resultado 200.
3
<guided-if[-not]-odd><guided-else[-not]-odd> </guided-if[-not]-odd>
Essa condição é verdadeira quando a iteração atual é uma iteração ímpar do loop (versus uma iteração par). Isso é útil para exibir cores de linhas variáveis.
4
<guided-if[-not]-even><guided-else[-not]-even> </guided-if[-not]-even>
Essa condição é verdadeira quando a iteração atual é uma iteração par do loop (versus uma iteração ímpar). Isso é útil para exibir cores de linhas variáveis.
5
<guided-if[-not]-alt><guided-else[-not]-alt> </guided-if[-not]-alt>
Essa condição é verdadeira quando a iteração atual é uma iteração par do loop. Isso é útil para exibir cores de linhas variáveis.
6
<guided-if[-not]-inner><guided-else[-not]-inner> </guided-if[-not]-inner>
Inclui o texto entre eles se a iteração atual não for a primeira ou a última.
7
<guided-if[-not]-outer><guided-else[-not]-outer> </guided-if[-not]-outer>
Inclui o texto entre eles se a iteração atual for a primeira ou a última.
8
<guided-loop-index>
Um número inteiro (começando em 0) cujo valor é incrementado para cada repetição do loop.
9
<guided-loop-counter>
Um número inteiro (a partir de 1) cujo valor é incrementado para cada repetição do loop.

Idioma Diversos

As tags a seguir estão disponíveis para permitir que você faça coisas mais avançadas com seu modelo, como criar sua própria minifaceta.
Adicionar tag
Descrição
1
<guided-current-path [escape="html|url|js|json|0"] />
Fornece o caminho atual usado. Normalmente, é usado para criar um link que adiciona um novo parâmetro à pesquisa existente. Por padrão, o caminho é um URL escapado. Você pode especificar qual modo de escape deseja usar por meio do parâmetro escape.
Exemplo:
<a href="<guided-current-path />&lang=fr"> French Version
Neste exemplo, uma regra de processamento de pesquisa usa lang para selecionar a versão em francês.
O caminho atual sempre tem pelo menos um parâmetro de consulta. Se não houver outros parâmetros de consulta, ele será definido como q=* , facilitando a adição de mais parâmetros.
2
Caminho básico
Se você quiser criar um link usando o caminho de base, use / no início da href e adicione parâmetros.
<a href="/">All Products</a> Would create a link "All Products" to your basepath, for example https://search.mycompany.com/
3
<guided-query-param gsname="query_parameter" [escape="html|url"] />
Permite capturar o valor existente de um parâmetro de consulta que está no URL. Se o parâmetro não existir, essa tag retornará uma string vazia. Se você não especificar uma opção de escape, a sequência retornada será automaticamente objeto de escape HTML, você poderá especificar a saída de HTML ou URL.
Exemplo:
&amp;lt;guided-query-param&amp;nbsp;gsname=&quot;q&quot;&amp;nbsp;/&amp;gt;
    dá&amp;nbsp;vbsp;the&amp;nbsp;value&amp;nbsp;calças
    
    &amp;lt;guided-query-param&amp;nbsp;gsbsp;gsp;lt name=&quot;lang&quot;&amp;nbsp;nbsp;/&amp;gt;
    Dá&amp;nbsp;o&amp;nbsp;value&amp;nbsp;en
    
    &amp;lt;guided-query-param&amp;nbsp;gsname=&quot;test&quot;&amp;nbsp;/&amp;gt;
    Dá&amp;nbsp;you&amp;nbsp;an&amp;vazio&amp;nbsp;string
    &amp;nbsp;
    &amp;nbsp;nbsp;nbsp;nbsp;nbsp;nbsp;nbsp;nbsp;&amp;nbsp;nbsp;&amp;nbsp; &lt;/code> &lt;/p> &lt;/td>

4
<guided-query-param-name gsname="param#" offset="offset_number"/>
A Pesquisa guiada tem a noção de um número de consulta, que é usado no controle de navegação estrutural. guided-query-param-name permite definir parâmetros como parte de um link no modelo de apresentação no qual a Pesquisa guiada identifica o número de consulta correto para você. O gsname tem um "x" nele, que a Pesquisa guiada substitui pelo número correto. O valor de deslocamento pode ser de 0 a 15, onde 0 indica que o próximo número de consulta disponível é usado. Um 1 indica que você deseja adicionar 1 a ele e assim por diante.
Combinado ao caminho guiado-atual , você pode criar seu próprio link mini facet ou permitir um nível de detalhamento adicional.
Exemplo:
<a href="<guided-current-path         />&<guided-query-param-name gsname="q#" offset="0"         />=mens&<guided-query-param-name gsname="x#" offset="0"         />=category" >Category:Men</a>        
<a href="<guided-current-path         />&<guided-query-param-name gsname="sp_q_exact_#" offset="0"         />=mens&<guided-query-param-name gsname="sp_x_#" offset="0"         />=category&<guided-query-param-name gsname="sp_q_exact_#" offset="1"         />=Jeans&<guided-query-param-name gsname="sp_x_#" offset="1"         />=product-type" >Cat:Men - Product:Jeans</a>
5
<guided-include gsfile="filename" />
Permite incluir outros arquivos de modelo. Essa funcionalidade significa que você pode criar vários modelos usando submodelos como módulos.
No exemplo a seguir, os arquivos de navegação estrutural e facetas são incluídos:
<guided-include gsfile='breadcrumbs.tmpl' /> <guided-include gsfile='facets.tmpl' />
As inclusões dinâmicas não são suportadas. Em outras palavras, gsfile não pode ser uma variável.
6
<guided-search-time>
Identifica quanto tempo a pesquisa demorou. O valor do tempo de pesquisa retornado é especificado em ms.
7
<guided-fall-through-search>
Retorna a contagem de pesquisas de núcleos usadas para criar a página de resultados de pesquisa.
8
<guided-if-fall-through-search></guided-if-fall-through-search>
Testa se a contagem de pesquisas principais é maior que uma.
9
<guided-if[-not]-even><guided-else[-not]-even> </guided-if[-not]-even>
Essa condição é verdadeira quando a iteração atual é uma iteração par do loop (versus uma iteração ímpar). Isso é útil para exibir cores de linhas variáveis.
10
<guided-if[-not]-alt><guided-else[-not]-alt> </guided-if[-not]-alt>
Essa condição é verdadeira quando a iteração atual é uma iteração par do loop. Isso é útil para exibir cores de linhas variáveis.
11
<guided-if[-not]-inner><guided-else[-not]-inner> </guided-if[-not]-inner>
Inclui o texto entre eles se a iteração atual não for a primeira ou a última.
12
<guided-if[-not]-outer><guided-else[-not]-outer> </guided-if[-not]-outer>
Inclui o texto entre eles se a iteração atual for a primeira ou a última.
13
<guided-if-first-search><guided-else-first-search> </guided-if-first-search>
Permite verificar se você está ou não na pesquisa inicial (a consulta foi o resultado de uma pesquisa da caixa de pesquisa).
14
<guided-search-url/>
É possível usar essa tag no modelo para salvar você da codificação da ação do formulário de pesquisa. Ele detecta quando você está no ambiente Staged ou Live e muda de acordo.
15
<guided-if-query-param-defined gsname="query_parameter"> <guided-else-query-param-defined> </guided-if-query-param-defined>
Esse conjunto de tags permite testar quais parâmetros CGI são definidos no caminho de pesquisa. Você pode testar os valores dos parâmetros somente se eles estiverem definidos.
16
<guided-next-query-number [gsname="offset"] />
O mecanismo de pesquisa guiada que direciona o modelo tem a noção de números de consulta flutuantes nos quais cada novo link gerado pelo mecanismo usa o próximo número de consulta disponível. Essa tag permite que você capture o próximo número ou deslocamentos de consulta para que você possa criar links personalizados que fazem drill-down no conjunto de resultados. O deslocamento permite deslocar para o próximo número de consulta. Por exemplo, se você selecionou um aspecto, o próximo número de consulta é 2, com um deslocamento de 1 o número de consulta retornado é 3.
17
<guided-custom-var gsname="custom_variable" [escape="html|url|js|json|0"]/>
Permite que você capture o valor existente de uma variável personalizada que suas regras de processamento definem. Se você não especificar uma opção de escape, a sequência retornada será automaticamente um escape HTML, será possível especificar html , url , js ou 0 . Se você usar uma regra de processamento para copiar um parâmetro CGI de entrada para uma variável personalizada e, em seguida, exibir ou usar essa variável no modelo com escape definido como none ou js, você poderá criar uma vulnerabilidade XSS na pesquisa.
18
<guided-if-custom-var-defined gsname="custom_variable"> <guided-else-custom-var-defined> </guided-if-custom-var-defined>
Habilita o teste se uma variável personalizada estiver definida nas regras de processamento (limpeza de consulta, processamento pré-pesquisa e processamento pós-pesquisa).
19
<guided-general-field gsname="search name" field="fieldname" [escape="html|url|js|json|0"]/>
Permite exibir o conteúdo de um campo geral definido no modelo de transporte. Se você não especificar uma opção de escape, a string retornada será codificada no formato especificado no modelo de transporte para esse campo. A especificação de uma opção de escape se aplica sobre qualquer formato que você esteja codificando o campo como no modelo de transporte. Você pode especificar html , url , js , json ou 0 .
20
<guided-if-general-field gsname="search-name" field="fieldname"> <guided-else-general-field> </guided-if-general-field>
Permite o teste se o conteúdo de um campo geral, conforme definido no modelo de transporte, existir.
21
<guided-cookie-value gsname="cookie_name" [escape="html|url|js|json|0"]/>
Permite que você capture o valor de um cookie, supondo que o cookie esteja disponível. Se você não especificar uma opção de escape, a sequência retornada será automaticamente um escape HTML, será possível especificar html , url , js , json ou 0 .
22
<guided-if-cookie gsname="cookie_name"> <guided-else-cookie> </guided-if-cookie>
Habilita o teste se houver um cookie.
23
<guided-banner gsname="banner area" [escape="html|url|js|json|0"] [width="xx" height="yy"]/>
Gera o banner para uma determinada área. Os atributos opcionais de largura e altura são usados no Construtor de regras visuais para permitir a exibição de um espaço reservado significativo para permitir que os usuários selecionem um banner. Por padrão, os banners não são escapados. Em vez disso, insira o HTML no modelo de apresentação. No entanto, se você estiver criando um modelo JSON, considere usar a opção de escape js.
Exemplo:
<guided-banner gsname="top" width="400px"  height="50px"/>
24
<guided-if-banner-set gsname="banner area"> <guided-else-banner-set> </guided-if-banner-set>
Habilita o teste se uma área de banner estiver definida.
25
<guided-if-simulator-mode> <guided-else-simulator-mode> </guided-if-simulator-mode>
Permite detectar quando você está visualizando sua pesquisa no Simulador ou no Construtor de regras visual. Normalmente, é usado para exibir informações de depuração adicionais para você.
26
<guided-if-tnt-business-rules> <guided-else-tnt-business-rules> </guided-if-tnt-business-rules>
Permite detectar se você tem alguma regra de negócios que faz referência a uma campanha do Adobe Target . Normalmente, ele é usado como parte da integração com o Adobe Target para evitar ocorrências nos servidores do Target quando não é necessário.
27
<guided-redirect/>
Por padrão, os redirecionamentos são executados automaticamente. No entanto, se você tiver configurado a pesquisa/comercialização do site para retornar uma resposta XML ou JSON ao seu aplicativo da Web, poderá optar por analisar a resposta 302/301 no aplicativo da Web ou enviar o redirecionamento para você como parte do conjunto de resultados. Se você estiver transmitindo o redirecionamento como parte do conjunto de resultados, essa tag poderá ser usada no modelo para exibir o local de redirecionamento.
28
<guided-if-redirect> <guided-else-redirect> </guided-if-redirect>
Quando você configurou a pesquisa/comercialização do site para redirecionar os redirecionamentos no conjunto de resultados, esse conjunto de tags pode ser usado para determinar se há um redirecionamento para saída.
29
<guided-lt/> <guided-gt/>
Esse conjunto de tags permite que você incorpore tags de modelo guiadas nos atributos HTML.
Exemplo:
<guided-lt/>div <guided-if-facet-long>         style="height: 125px; overflow:         auto;"</guided-if-facet-long><guided-gt/>

Tags de modelo de transporte

Os modelos de transporte são modelos XML que transmitem dados da pesquisa de backend para a camada de apresentação da Pesquisa guiada.
Na camada de apresentação, você pode ter um único modelo de apresentação que apresenta os resultados de várias pesquisas. Cada pesquisa pode usar o mesmo modelo de transporte ou um modelo de transporte personalizado para passar os dados para a camada de apresentação.
Como o modelo de transporte é usado apenas para passar dados para a camada de apresentação, ele não tem nenhum HTML que esteja preocupado em exibir os resultados da pesquisa. O modelo de transporte usa tags XML de modelo de transporte para passar os resultados da pesquisa para preencher os componentes de Pesquisa guiada, como facetas, navegações estruturais e menus. Dentro dessas tags, as tags de modelo de pesquisa padrão são usadas para exibir os valores reais.
Consulte Pesquisar marcas de modelo.
Tag do modelo de transporte
Descrição
<guided-xml></guided-xml>
As tags XML raiz que a camada de apresentação usa para detectar o que é analisado do modelo de transporte.
<general></general>
As tags delimitam as tags do modelo de pesquisa que fornecem dados de resumo com base no conjunto de resultados. Normalmente, essas tags contêm tags de pesquisa para o número total de resultados, menor resultado e maior resultado. Você pode definir qualquer número de campos globais adicionais que desejar com a tag de campo geral, como no exemplo a seguir:
<general>   <total><search-total /></total>   <lower><search-lower /></lower>   <upper><search-upper /></upper>   <general-field name="my_custom_field">Some global content</general-field> </general>
<results></results>
As tags são vinculadas aos resultados da pesquisa, para que a Pesquisa guiada saiba onde procurá-las.
<resultado></resultado>
As tags são vinculadas ao redor de cada resultado de pesquisa, de modo que a Pesquisa guiada reconheça onde o conteúdo de um único resultado de pesquisa começa e termina, como no exemplo a seguir:
<results>   <search-results>     <result>       <index><search-index /></index>       <loc><search-cdata><search-url length="500" /></search-cdata></loc>     </result>   </search-results> </results>
<attribute-table name="tablename">
Permite executar um loop por cada item em uma lista de vários valores para um único resultado. Use essa tag somente em um resultado. Sua finalidade é permitir que você itere sobre atributos que pertencem a um campo de resultado, como no exemplo a seguir:
<results>   <search-results>     <result>       <index><search-index /></index>       <loc><search-url /></loc>       <title><search-title /></title>       <attribute-table name="downloads">         <field name="download_title"><search-display-field name="download_title" /></field>         <field name="download_link" delimiter="|"><search-display-field name="download_link" /></field>       </attribute-table>     </result>   </search-results> </results>
<facetas></facetas>
Passa os resultados que preenchem as facetas.
<dynamic-facet></dynamic-facet>
Você pode designar uma faceta como uma faceta dinâmica e como membro de um painel de facetas. No entanto, seu tratamento é independente em relação às tags de modelo de apresentação relacionadas.
Em outras palavras, não é permitido o aninhamento de um contexto de loop do painel de facetas em um contexto de loop de facetas dinâmicas, ou vice-versa.
Para aspectos dinâmicos e de linhas, somente as facetas dinâmicas que foram retornadas para uma determinada pesquisa são visíveis no contexto de loop do painel de facetas.
<facet name="name"></facet>
Cada faceta tem suas próprias marcas de aspecto, onde o parâmetro name corresponde ao nome da faceta. As tags de pesquisa são usadas nas tags facet para os valores de faceta, como no exemplo a seguir:
<facets>   <facet name="brand">     <values><search-field-value-list name="brand" quotes="no" commas="yes" data="values" sortby="values" /></values>     <counts><search-field-value-list name="brand" quotes="no" commas="yes" data="counts" sortby="values" /></counts>   </facet>   <facet name="category">     <values><search-field-value-list name="category" quotes="no" commas="yes" data="values" sortby="values" /></values>     <counts><search-field-value-list name="category" quotes="no" commas="yes" data="counts" sortby="values" /></counts>   </facet> </facets>
As contas que usam aspectos com slot podem usar a tag dinâmica e a tag de nomes para exibição. Ambas as tags ajudam a facilitar o mapeamento entre facetas alocadas e facetas reais ao criar regras de negócios.
<facets>   <facet name="facet_values01">  <dynamic>1</dynamic>  <display-names><search-field-value-list name="facet_names01" quotes="no" commas="yes" data="values" sortby="values" /></display-names>     <values><search-field-value-list name="facet_values01" quotes="no" commas="yes" data="values" sortby="values" /></values>     <counts><search-field-value-list name="facet_values01" quotes="no" commas="yes" data="counts" sortby="values" /></counts>   </facet>
<search-display-field separator=",">
O atributo separator permite alterar o delimitador usado ao gerar dados de campo de exibição de pesquisa para listas. O padrão é uma vírgula.
Geralmente, o delimitador usado deve ser algo que não aparece prontamente no conteúdo de campo.
<sugestões></sugestões>
Encapsule suas sugestões de "Você quis dizer" com tags para que a Pesquisa guiada reconheça quais nós XML contêm sugestões.
<sugestão></sugestão>
Vincule cada sugestão Você quis dizer com tags, como no exemplo a seguir:
<search-if-suggestions>   <suggestions>     <search-suggestions>       <suggestion><search-suggestion-text /></suggestion>     </search-suggestions>   </suggestions> </search-if-suggestions>

Pesquisar marcas de modelo

Um modelo de pesquisa é um arquivo HTML que inclui tags de modelo que a pesquisa/comercialização do site define. Essas tags indicam como os resultados da pesquisa são formatados. A referência a seguir contém uma breve descrição de cada tag do modelo de pesquisa e seus atributos.
Use somente tags de modelo de pesquisa nos arquivos de modelo de transporte (.tpl).
Você pode selecionar entre os seguintes grupos de tags de modelo de pesquisa e material de referência.
As tags que são válidas somente no loop de resultados incluem o seguinte:
As tags válidas em todo o modelo incluem o seguinte:
Tópicos de referência do modelo de pesquisa

Sobre tags de loop Results

A tag de loop de resultados é a base de trabalho do sistema de modelo. Quando a tag é encontrada durante uma pesquisa, o HTML é repetido e outras tags entre as tags de loop de resultados inicial e final, substituindo quaisquer outras tags pelos resultados da pesquisa.
<search-results> ... </search-results>
As tags de loop de resultados circundam o HTML que mostra os resultados da pesquisa. O HTML entre as tags é repetido para cada resultado e é exibido na página.
As tags a seguir são válidas somente no loop de resultados:

Tags de string de loop de resultados

As tags a seguir retornam uma string.
Consulte Sobre tags de loop Results.
Adicionar tag
Descrição
1
<search-index>
Retorna o índice numérico do resultado atual.
2
<search-title length="XX">
Retorna o título da página do resultado atual. O atributo de comprimento opcional é usado para limitar o comprimento das strings exibidas, com um padrão de 80 caracteres.
3
<search-body-text length="XX" encoding="html/javascript/json/perl/url/none" >
Retorna o texto do corpo a partir da parte superior da página. Os termos relevantes são apresentados a negrito. O atributo de comprimento opcional é usado para limitar o comprimento das strings exibidas, com um padrão de 80 caracteres. O atributo encoding é opcional e pode codificar caracteres de saída com codificação HTML (padrão), codificação Javascript, codificação Perl ou nenhum.
4
<search-description length="XX" encoding="html/javascript/json/perl/url/none">
Retorna a descrição do resultado atual. Se a tag de descrição meta existir e o atributo de conteúdo não estiver vazio, esse texto será exibido. Caso contrário, o início do texto do corpo da página será exibido. O atributo de comprimento opcional é usado para limitar o comprimento das strings exibidas, com um padrão de 80 caracteres.
O atributo opcional de codificação controla se a saída é codificada em HTML, codificada em JavaScript, codificada em Perl, codificada em URL ou não, para saída na página de resultados. O valor padrão da codificação é html . Normalmente, não é necessário especificar o atributo de codificação.
5
<search-score rank="dynamic/static/dynamic-raw/static-raw/final-raw" precisão="XX">
Retorna a pontuação do resultado atual, que é um número de 0 a 100. Se você tiver definido um campo de classificação em Opções > Metadados > Definições , poderá exibir a classificação de página dinâmica definindo o atributo de classificação como dinâmico ( <search-score rank="dynamic"> ). Você pode exibir a classificação de página estática definindo o atributo de classificação como estático ( <search-score rank="static"> ). Você pode usar o atributo de precisão opcional para especificar o número de casas decimais a serem exibidas. O padrão é 0, que exibe a pontuação do número inteiro).
6
<search-date length="XX" none="text" date-format="date-format-string" gmt="yes/no" language="0/2/language-id">
Retorna a data do resultado atual. O valor de texto opcional "nenhum" será exibido se não houver data associada ao resultado atual. Se o valor opcional "nenhum" não for fornecido, o texto "Nenhuma data" será exibido se não houver nenhuma data associada ao resultado atual.
O atributo "date-format" usa uma string de formato de data no estilo UNIX, como "%A, %B %d, %Y" (para "segunda-feira, 25 de julho de 2016"). "gmt" assume como padrão "yes" e controla se a parte do tempo da string de data deve ser exibida em GMT ("yes") ou no fuso horário da conta ("no").
O atributo "language" controla as convenções de idioma e localidade da string de data de saída. "0" (o padrão) significa "Usar o idioma da conta". "2" significa "Usar Idioma do Documento". O valor "idioma" "1" está reservado para uso futuro. Qualquer outro valor de "idioma" é interpretado como um identificador de idioma específico, por exemplo, "en_US" significa "inglês (Estados Unidos)".
O atributo de comprimento opcional é usado para limitar o comprimento das strings exibidas, com um padrão de 80 caracteres.
7
<search-size>
Retorna o tamanho do resultado atual em bytes.
8
<search-url length="XX" encoding="html/javascript/json/perl/url/none" >
Retorna o URL do resultado atual.
Use o atributo de comprimento opcional para limitar o comprimento das strings exibidas, com um padrão de caracteres ilimitados.
O atributo encoding é opcional e pode codificar caracteres de saída com codificação HTML, codificação Javascript, codificação Perl ou nenhum.
9
<search-url-path-query length="XX">
Retorna as partes de caminho e consulta, incluindo o ponto de interrogação do URL do resultado atual.
Use o atributo de comprimento opcional para limitar o comprimento das strings exibidas, com um padrão de caracteres ilimitados.
10
<search-context length="XX" encoding="html/javascript/json/perl/url/none" >
Retorna a próxima linha de contexto do termo de pesquisa. Os termos relevantes são apresentados a negrito. Chame essa tag repetidamente para exibir mais de uma linha de contexto para o resultado atual.
Use o atributo de comprimento opcional para limitar o comprimento das strings exibidas, com um padrão de 80 caracteres. O atributo length será ignorado se essa tag for incluída nos conjuntos de tags <search-if-context> ou <search-if-any-context> que contêm um atributo length.
O atributo encoding é opcional e pode codificar caracteres de saída com codificação HTML (padrão), codificação Javascript, codificação Perl ou nenhum.
11
<search-display-field name="field-name" length="XX" none="text" date-format="date-format-string" gmt="yes/no" language="0/2/language-id" encoding="html/javascript/json/perl/url/none" asotes="yes/no" vírgulas="yes/no" unidades="milhas/kilomeekomeze ters" separator="|">
Essa tag avançada exibe o conteúdo do campo de metadados (url, title, desc, keys, target, body, alt, date, charset e idioma ou campos definidos em Opções > Metadados > Definições) especificados no atributo name , para o resultado atual. Por exemplo:
<search-display-field name="title" length="70" none="no title">
Gera o título da página para um resultado de pesquisa. Se o atributo opcional nenhum for especificado, seu valor será exibido na página de resultados somente se não houver conteúdo associado ao campo.
Os atributos de formato de data , gmt e idioma só são relevantes se o tipo de conteúdo do campo especificado for data .
O atributo date-format usa uma string de formato de data no estilo UNIX, como %A, %B %d, %Y (para segunda-feira, 25 de julho de 2016). gmt assume como padrão yes e controla se a parte do tempo da string de data é saída em GMT ( sim ) ou no fuso horário da conta ( não ).
Consulte Strings de formato de data.
O atributo language controla as convenções de idioma e localidade da string de data de saída. 0 (o padrão) significa "Usar o idioma da conta". 2 significa "Usar Idioma do Documento". O valor de idioma 1 está reservado para uso futuro). Qualquer outro valor de idioma é interpretado como um identificador de idioma específico, por exemplo, en_US significa "Inglês (Estados Unidos)".
Consulte Identificadores de idioma.
O atributo length opcional é usado para limitar o comprimento das strings exibidas, com um padrão de 80 caracteres.
O atributo opcional de codificação controla se a saída é codificada em HTML, codificada em JavaScript, codificada em Perl, codificada em URL ou não, para saída na página de resultados. O valor padrão da codificação é html . Normalmente, não é necessário especificar o atributo de codificação.
O atributo opcional de aspas controla se a saída de itens individuais está entre aspas duplas (ou aspas simples, se encoding=perl ). O valor padrão das cotações é não .
O atributo opcional de vírgulas controla se a saída de itens individuais é separada por vírgulas. O valor padrão de vírgulas é sim . O atributo de vírgulas é ignorado para campos que não sejam do tipo lista.
O atributo opcional de unidades controla as unidades de distância aplicadas a um campo de saída de pesquisa de proximidade. O valor padrão de unidades é determinado a partir da configuração "Unidades padrão" do campo tipo localização associado ao campo de saída de pesquisa de proximidade especificado.
Consulte Sobre pesquisa de proximidade.
O atributo separator opcional define o caractere único, ou delimitador, que é inserido entre os valores da saída para campos de tipo de lista.
12
<search-display-field-values name="field-name"> ...<search-display-field-values>
Essa tag cria um loop para enumerar valores de campo de metadados (url, title, desc, keys, target, body, alt, date, charset e idioma ou campos definidos em Opções > Metadados > Definições ) para o resultado atual. Não aninhe essa tag dentro de outra tag <search-display-field-values> . O atributo name especifica o nome do campo que contém os valores a serem enumerados. Essa tag é mais útil com campos que têm o atributo Permitir listas marcado (em Opções > Metadados > Definições ).
13
<search-display-field-value date-format="date-format-string" gmt="yes/no" language="0/language-id" encoding="html/javascript/json/perl/url/none">
Essa tag gera o valor do campo de metadados (url, title, desc, keys, target, body, alt, date, charset e idioma ou campos definidos em Opções > Metadados > Definições ) para a iteração de loop <search-display-field-values> atual. Essa tag é válida somente dentro de um loop <search-display-field-values> . Os atributos date-format , gmt e language só são relevantes se o tipo de conteúdo do nome do campo especificado na tag <search-display-field-values> anexada for date . O atributo date-format usa uma string de formato de data no estilo UNIX, como "%A , %B %d , %Y " (para "segunda-feira, 25 de julho de 2016"). O atributo gmt assume como padrão yes (sim) e controla se a parte de tempo da string de data é saída em GMT ( sim ) ou no fuso horário da conta ( não ).
O atributo language controla as convenções de idioma e localidade da string de data de saída. 0 (o padrão) significa "Usar o idioma da conta". Qualquer outro valor de idioma é interpretado como um identificador de idioma específico, por exemplo, en_US significa "Inglês (Estados Unidos)".
O atributo opcional de codificação controla se a saída é codificada em HTML, codificada em JavaScript, codificada em Perl, codificada em URL ou não, para saída na página de resultados. O valor padrão da codificação é html . Normalmente, não é necessário especificar o atributo de codificação.
14
<search-display-field-value-count name="field-name">
Gera o número total de valores no resultado atual para o campo de metadados (url, title, desc, keys, target, body, alt, date, charset e idioma ou campos definidos em Opções > Metadados > Definições ) especificados com o atributo name. Essa tag pode aparecer em qualquer lugar no loop de resultados.
15
<search-display-field-value-counter>
Gera o contador ordinal (1, 2, 3 e assim por diante) para a iteração de loop <search-display-field-values> atual. Essa tag é válida somente dentro de um loop <search-display-field-values> .
16
<search-dynamic-facet-fields>
Inicia um contexto de loop para qualquer campo de aspecto dinâmico retornado para esta pesquisa.
17
<search-dynamic-facet-field-name>
Gera o nome do campo de aspecto dinâmico atual, para essa repetição de loop.
18
<search-result-trace encoding="html/javascript/ json/perl/url/none">
Gera informações relacionadas à colocação do resultado atual, por exemplo, quaisquer ações baseadas em resultados que afetaram a posição do resultado.
O formato de saída desta tag é JSON, como no exemplo a seguir:
{   "sliceID": 5,   "indexID": 5894,   "finalScore": 98.5,   "dynamicScore": 15.3,   "staticScore": 55.456,   "position": 1,   "rbtaActionListID": 117,   "rbtaActionID": 57 }
O atributo encoding é opcional; o valor padrão é html .
Observação: Essa tag só terá saída se sp_trace=1 for especificado com os parâmetros de consulta de pesquisa principais.
Consulte a linha 48 na tabela encontrada nos parâmetros CGI de pesquisa de backend.

Tags condicionais do loop de resultados

As tags a seguir incluem condicionalmente o HTML entre elas.
Consulte Sobre tags de loop Results.
Adicionar tag
Descrição
1
<search-if-title> ... </search-if-title>
<search-if-not-title> ... </search-if-not-title>
Essas tags incluem o HTML entre elas se a próxima chamada para <search-title> retornar (ou não retornar) o texto do título do documento.
2
<search-if-description length="XX"> ... /search-if-description>
<search-if-not-description> ... </search-if-not-description>
Essas tags incluem o HTML entre elas se a próxima chamada para <search-description> retornar (ou não retornar) o texto da descrição do documento.
3
<search-if-body-text> ... </search-if-body-text>
<search-if-not-body-text> ... </search-if-not-body-text>
Essas tags incluem o HTML entre elas se a próxima chamada para <search-body-text> retornar (ou não retornar) o texto do corpo do documento.
4
<search-if-context length="XX"> ... </search-if-context>
<search-if-not-context> ... </search-if-not-context>
Essas tags incluem o HTML entre elas se a próxima chamada para <search-context> retornar (ou não retornar) uma string de contexto não vazia. O atributo length substitui o atributo length em qualquer tag <search-context> .
5
<search-if-any-context length="XX"> ... /search-if-any-context>
<search-if-not-any-context> ... </search-if-not-any-context>
Essas tags incluem o HTML entre elas se houver (ou não) uma string de contexto associada ao resultado. O atributo length substitui o atributo length em qualquer tag <search-context> .
6
<search-if-score lower="XX" top="yy" rank="dynamic/static/dynamic-raw/static-raw/final-raw"> ... </search-if-score>
<search-if-not-score lower=XX top=yy rank="dynamic/static"> ... </search-if-not-score>
Essas tags incluem o HTML entre elas se a pontuação do resultado atual estiver (ou não) entre XX e YY. Útil para adicionar marcadores ou gráficos para mostrar o quão relevante o resultado é. Se você tiver definido um campo de tipo de classificação em Opções > Metadados > Definições , poderá verificar a classificação de página dinâmica definindo o atributo de classificação como dinâmico ( <search-if-score rank="dynamic" lower=XX top=YY> ). Você pode verificar a classificação de página estática definindo o atributo de classificação como estático ( <search-if-score rank="static" lower=XX top=YY> ).
7
<search-if-field name="field-name" value="value"> ... </search-if-field>
<search-if-not-field name="field-name" value="value"> ... </search-if-not-field>
Essas tags avançadas incluem o HTML entre elas com base no fato de o campo especificado no atributo "name" ter ou não conteúdo. Se o atributo "value" opcional for especificado, as tags incluirão o HTML entre elas com base no fato de o valor especificado corresponder (ou não) ao valor do campo no resultado atual. Essas tags funcionam somente no loop de resultados (entre as tags <search-results> e </search-results> ).

Tags de link de âncora de loop de resultados

Consulte Sobre tags de loop Results.
Adicionar tag
Descrição
1
<search-link target="frame-name" hbx-enable="yes/no" hbx-linchild-name="field-name" hbx-linchild-none="text" hbx-linchild-length="XX" > ... </search-link>
Esse par de tags cria um link de âncora em torno do HTML entre elas. Quando o link é clicado, a página de resultados é exibida. Um atributo de destino opcional especifica a janela nomeada na qual os navegadores compatíveis com quadros devem exibir a página de resultados.
Defina o atributo hbx-enable como "yes" para aproveitar as vantagens das análises disponíveis por meio do HBX. Defina hbx-linchild-name como o nome de um campo Meta-data que você deseja rastrear. Por exemplo, para rastrear os resultados de pesquisa por número SKU, defina hbx-linkname como o nome do campo Metadados que contém as informações SKU.
Campos de tipo de data não são suportados no momento. O valor de hbx-linchild-name é anexado à ID do link na âncora gerada. O valor do atributo hbx-linboy-none é anexado à ID do link sempre que o campo Metadados nomeado está vazio. O valor de hbx-linchild-length limita o número de caracteres obtidos e exibidos da tag Meta. O número padrão de caracteres é 12.
2
<search-smart-link target="frame-name" hbx-enable="yes/no" hbx-linchild-name="field-name" hbx-linchild-none="text" hbx-linchild-length="XX"> ... </search-smart-link>
Esse par de tags é semelhante ao <search-link> ... tags </search-link> . Quando os links de âncora gerados são clicados, a página de resultados é exibida, mas com a página rolada até a tag de âncora mais próxima que antecede o resultado. Para links de PDF, o visualizador do Acrobat exibe a página que contém o resultado. Um atributo de destino opcional especifica a janela nomeada na qual os navegadores compatíveis com quadros devem exibir a página de resultados.
Defina o atributo hbx-enable como "yes" para aproveitar as vantagens das análises disponíveis por meio do HBX. Defina hbx-linchild-name como o nome de um campo Meta-data que você deseja rastrear. Por exemplo, para rastrear os resultados de pesquisa por número SKU, defina hbx-linkname como o nome do campo Metadados que contém as informações SKU.
Campos de tipo de data não são suportados no momento. O valor de hbx-linchild-name é anexado à ID do link na âncora gerada. O valor do atributo hbx-linboy-none é anexado à ID do link sempre que o campo Metadados nomeado está vazio. O valor de hbx-linchild-length limita o número de caracteres obtidos e exibidos da tag Meta. O número padrão de caracteres é 12.
3
<search-if-link-extension> ... </search-if-link-extension>
<search-if-not-link-extension> ... </search-if-not-link-extension>
Essas tags incluem o HTML entre elas se um atributo de valor especificar uma extensão que corresponde ao final do URL para o resultado. Essa tag é útil para incluir um gráfico nos resultados da pesquisa com base na extensão do link. O atributo value é uma lista de uma ou mais extensões (separadas por espaço) da seguinte maneira: VALUE=".pdf" ou VALUE=".html.htm".

Tags condicionais de posição de loop

As tags a seguir incluem condicionalmente o texto entre elas. Eles só podem aparecer dentro das tags "looping": < search-results> e <search-field-values> . Eles são usados para testar a posição do resultado atual dentro do conjunto de resultados.
Consulte Sobre tags de loop Results.
Adicionar tag
Descrição
1
<search-if-first> ... </search-if-first>
<search-if-not-first> ... </search-if-not-first>
Essas tags incluem o texto entre elas se o resultado atual for (ou não) o primeiro resultado na página (quando usado dentro de <search-results> ) ou o primeiro valor de campo (quando usado dentro de <search-field-values> ).
2
<search-if-last> ... </search-if-last>
<search-if-not-last> ... </search-if-not-last>
Essas tags incluem o texto entre elas se o resultado atual for (ou não) o último resultado na página (quando usado dentro de <search-results> ) ou o último valor do campo (quando usado dentro de <search-field-values> ). Essa tag pode ser usada para inserir um separador entre os resultados. Por exemplo, isso insere uma tag <hr> entre os resultados:
<search-results>    <search-lt>tr<search-if-alt> class="alt"</search-if-alt><search-gt>       <td><search-url></td>    </tr> </search-results>
3
<search-if-inner> ... </search-if-inner>
<search-if-not-inner> ... </search-if-not-inner>
Essas tags incluem o texto entre elas se o resultado atual não for o primeiro nem o último resultado na página (quando usado dentro de <search-results> ) ou se não for o primeiro nem o último valor do campo (quando usado dentro de <search-field-values> ). A versão not da tag testa se o resultado é o primeiro ou o último.
4
<search-if-alt> ... </search-if-alt>
<search-if-not-alt> ... </search-if-not-alt>
Essas tags incluem o texto entre elas se o resultado atual for (ou não) um resultado alternativo na página (quando usado dentro de <search-results> ) ou um valor de campo alternativo (quando usado dentro de <search-field-values> ). Os resultados "alternativos" são o segundo, quarto, sexto e assim por diante, na página. Este exemplo aplica uma classe diferente a linhas de tabela alternativas. Observe o uso de <search-lt> e <search-gt> para permitir que a tag <search-if-alt> seja colocada "dentro" da tag <tr> .
    <search-results>        <search-lt>tr<search-if-alt> class="alt"</search-if-alt><search-gt>           <td><search-url></td>        </tr>     </search-results>
5
<search-if-even> ... </search-if-even>
<search-if-not-even> ... </search-if-not-even>
Essas tags incluem o texto entre elas se o resultado atual for (ou não) um resultado par numerado (quando usado dentro de <search-results> ) ou um valor de campo par numerado (quando usado dentro de <search-field-values> ). Um resultado de pesquisa é par-numerado se seu valor <search-index> for par. Em outras palavras, se sua posição dentro de todo o conjunto de resultados for par. Isso pode ser diferente de <search-if-alt> , que testa a posição de um resultado na página, não dentro do conjunto de resultados inteiro. As duas tabelas a seguir ilustram a diferença:

Primeira página, sp_n=1

Índice
Resultado
Mesmo?
Alt?
1
Primeiro resultado
Não
Não
2
Segundo resultado
Sim
Sim
3
Terceiro resultado
Não
Não
4
Quarto resultado
Sim
Sim
5
Quinto resultado
Não
Não

Página posterior, sp_n=10

Índice
Resultado
Mesmo?
Alt?
10
Décimo resultado
Sim
Não
11
Décimo primeiro resultado
Não
Sim
12
Décimo segundo resultado
Sim
Não
13
Décimo terceiro resultado
Não
Sim
14
Décimo quarto resultado
Sim
Não
Finalmente, observe que <search-if-even> é sempre o mesmo que <search-if-alt> para valores de campo de pesquisa, pois os valores de campo não são paginados.

Tags de lista de valores de campo

Os valores de campo de saída de tags avançadas a seguir e os dados relacionados de todo o conjunto de resultados da pesquisa. Essas tags só geram saída para campos especificados pelos parâmetros sp-sfvl-field CGI na consulta de pesquisa.
Adicionar tag
Descrição
1
<search-field-value-list name="field-name" asotes="yes/no" vírgulas="yes/no" data="values/counts/results" separator="X" sortby="none/values/counts/results" max-items="XX" date-format="date-format-string" gmt="yes/no" language="0/language-id" encoding="httx ml/javascript/json/perl/url/none">
Essa tag exibe uma lista de valores de campo exclusivos, contagens de valores ou contagens de resultados em todo o conjunto de resultados.
Essa tag só gera saída para campos especificados pelos parâmetros sp_sfvl_field CGI na consulta de pesquisa. O atributo opcional "aspas" controla se a saída de itens individuais está entre aspas duplas (ou aspas simples, se encoding=perl). O valor padrão de "aspas" é "sim". O atributo opcional "vírgulas" controla se a saída de itens individuais é separada por vírgulas. O valor padrão de "vírgulas" é "sim". O atributo "data" opcional controla se cada valor de campo exclusivo é de saída (data="values"), a contagem total de cada valor de campo exclusivo é de saída (data="counts") ou o número de resultados que contém cada valor exclusivo (data="results") é de saída. O valor padrão de "data" é "valores". Para campos que não sejam do tipo lista, data="counts" e data="resultados" são equivalentes. O atributo separator define o caractere único, ou delimitador, a ser inserido entre os valores da saída. O atributo opcional "sortby" controla a ordem da saída; Sortby="none" significa sem ordem específica, sortby="values" significa classificar por valores de campo (em ordem crescente ou decrescente de acordo com a propriedade Classificação do campo), sortby="counts" significa classificar em ordem decrescente de contagem de valores de campo e classificar por="resultados" significa classificar em ordem decrescente do número de resultados que contém cada valor.
Observe que Sortby="counts" e sortby="resultados" são equivalentes para campos que não são do tipo lista. O atributo opcional "max-items" limita o número de itens à saída. O valor padrão de "max-items" é -1, o que significa "output all items".
Existe um limite absoluto de 100 para itens máximos. Os atributos "date-format", "gmt" e "language" só são relevantes se o tipo de conteúdo do campo especificado for "date". O atributo "date-format" usa uma string de formato de data no estilo UNIX, como "%A, %B %d, %Y" (para "segunda-feira, 25 de julho de 2016"). "gmt" assume como padrão "yes" e controla se a parte do tempo da string de data deve ser exibida em GMT ("yes") ou no fuso horário da conta ("no").
Consulte Strings de formato de data.
O atributo "language" controla as convenções de idioma e localidade da string de data de saída. "0" (o padrão) significa "Usar o idioma da conta". Qualquer outro valor de "idioma" é interpretado como um identificador de idioma específico, por exemplo, "en_US" significa "inglês (Estados Unidos)". O atributo opcional "encoding" controla se os caracteres da string de saída são codificados em HTML, codificados em JavaScript, codificados em Perl, codificados em URL ou não, para saída na página de resultados. O valor padrão de "encoding" é "html".
Consulte Identificadores de idioma.
2
<search-field-value-list-count name="field-name" value="field-value" results="yes/no">
Essa tag exibe informações de contagem para uma determinada lista de valores de campo de pesquisa. Há três usos distintos para essa tag. Se apenas o atributo "name" for fornecido, essa tag resultará no número de valores exclusivos para o campo nomeado dentro de todo o conjunto de resultados. Se os atributos "nome" e "valor" forem ambos fornecidos, essa tag resultará na contagem total do valor especificado dentro de todo o conjunto de resultados (para os resultados="não") ou na contagem total de resultados que contêm o valor especificado em todo o conjunto de resultados (para os resultados="sim"). O valor padrão de "results" é "no". Observação: Para campos que não sejam do tipo lista, os resultados="yes" e os resultados="no" são equivalentes. O valor de "results" será ignorado se o atributo "value" não for fornecido. Essa tag só gera saída para campos especificados pelos parâmetros sp-sfvl-field CGI na consulta de pesquisa.
3
<search-if-field-value-list-count name="field-name" value="field-value"> ... </search-if-field-value-list-count>
<search-if-not-field-value-list-count name="field-name" value="field-value"> ... </search-if-not-field-value-list-count>
Essas tags exibem o HTML entre elas se a chamada equivalente para <search-field-value-list-count name="field-name" value="field-value"> com os atributos fornecidos retornasse (ou não) um valor maior que zero.
4
<search-if-single-field-value-list-count name="field-name"> ... </search-if-single-field-value-list-count>
Essas tags exibem o conteúdo entre elas se a chamada equivalente para <search-field-value-list-count name="field-name" value="field-value"> com os atributos fornecidos retornasse (ou não) um único valor. Normalmente, isso é usado quando uma conta está usando slots de facetas. Com slots de faceta, você geralmente só deseja exibir o slot de valor quando o slot de nome associado tem um único item. Fazer essa verificação no modelo de transporte é mais eficiente do que fazer isso na camada de apresentação.

Tags de loop da lista de valores do campo

As tags avançadas a seguir enumeram e produzem valores de campo e dados relacionados de todo o conjunto de resultados de pesquisa usando uma construção de loops. Essas tags só geram saída para campos especificados pelos parâmetros sp-sfvl-field CGI na consulta de pesquisa.
Adicionar tag
Descrição
1
<search-field-values name="field-name" sortby="none/values/counts/results" max-items="XX"> ... </search-field-values>
Essa tag cria um loop para enumerar valores de campo e dados relacionados para um campo específico em todo o conjunto de resultados. Não aninhe essa tag dentro de outra tag <search-field-values> . O atributo "name" especifica o nome do campo que contém os valores a serem enumerados. O atributo opcional "sortby" controla a ordem de enumeração: "none" significa nenhuma ordem específica, "values" significa classificar por valores de campo (em ordem crescente ou decrescente de acordo com a propriedade Sorting do campo), sortby="counts" significa classificar em ordem decrescente das contagens de valor de campo, e sortby="results" significa classificar em ordem decrescente do número de resultados que contém cada valor.
Observe que Sortby="counts" e sortby="resultados" são equivalentes para campos que não são do tipo lista. . O atributo opcional "max-items" limita o número de iterações ao valor especificado. O valor padrão para "max-items" é -1, o que significa "enumerar todos os valores".
2
<search-field-value date-format="date-format-string" encoding="html/javascript/json/perl/url/none" gmt="yes/no" language="0/language-id">
Essa tag gera o valor do campo para a iteração de loop <search-field-values> atual. Essa tag é válida somente dentro de um loop <search-field-values> . Os atributos "date-format", "gmt" e "language" só são relevantes se o tipo de conteúdo do nome do campo especificado na tag <search-field-values> anexada for "date". O atributo "date-format" usa uma string de formato de data no estilo UNIX, como "%A, %B %d, %Y" (para "segunda-feira, 25 de julho de 2020").
Consulte Strings de formato de data.
O atributo opcional "encoding" controla se os caracteres da string de saída são codificados em HTML, codificados em JavaScript, codificados em Perl, codificados em URL ou não, para saída na página de resultados. O valor padrão de "encoding" é "none". Normalmente, não é necessário especificar o atributo de codificação. "gmt" assume como padrão "yes" e controla se a parte do tempo da string de data deve ser exibida em GMT ("yes") ou no fuso horário da conta ("no"). O atributo "language" controla as convenções de idioma e localidade da string de data de saída. "0" (o padrão) significa "Usar o idioma da conta". Qualquer outro valor de "idioma" é interpretado como um identificador de idioma específico, por exemplo, "en_US" significa "inglês (Estados Unidos)".
Consulte Identificadores de idioma.
3
<search-field-value-count results="yes/no">
Essa tag gera a contagem associada à iteração de loop <search-field-values> atual. A contagem de saída é o número de resultados em todo o conjunto de resultados que contém o valor do campo (results="yes") ou a contagem total do valor do campo em todo o conjunto de resultados. O valor padrão de "results" é "no".
Para campos que não sejam do tipo lista, os resultados="yes" e os resultados="no" são equivalentes. Essa tag é válida somente dentro de um loop <search-field-values> .
4
<search-field-value-counter>
Essa tag gera o contador ordinal para a iteração de loop <search-field-values> atual. Essa tag é válida somente dentro de um loop <search-field-values> .

Sugerir tags

Sugestão fornece um "Você quis dizer?" amigável serviço para sugerir termos de pesquisa alternativos. Se um usuário tiver escrito incorretamente um termo de pesquisa, por exemplo, Sugest pode ajudar o usuário a encontrar resultados sugerindo uma ortografia correta. O sistema também pode sugerir palavras-chave relacionadas que podem ajudar um usuário a descobrir resultados. Ao gerar sugestões, o serviço Sugerir usa dois dicionários: um com base no idioma da conta (definido em Indexing > Words and Languages > Language ) e o outro com base nas palavras-chave no índice da conta.
O serviço Suggest não funciona para chinês, japonês ou coreano.
Adicionar tag
Descrição
1
<pesquisar-se-sugestões> ... </search-if-guide>
Envolva essas tags com quaisquer tags de modelo "Sugerir", como <search-sugestion> , <search-sugestion-link> , e assim por diante. Se a pesquisa gerar sugestões, o mecanismo de pesquisa gera e processa tudo entre a tag aberta e close. Se a pesquisa não gerar sugestões, nenhum conteúdo aninhado será gerado.
2
<pesquisa-sugestões> ... </search-guide>
Essa tag gera o loop "Sugestão", que contém uma lista de termos de pesquisa sugeridos (por exemplo, "intenção", "intenção" e "intenção", para uma consulta originalmente inserida como "intenções"). Ao gerar a lista de termos, o mecanismo de pesquisa repete qualquer HTML aninhado e/ou tags de modelo até cinco vezes, que é o número máximo de sugestões. Use o atributo count para especificar o número de sugestões geradas (entre 0 e 5).
A tag <search-sugestivas> pode aparecer várias vezes na página para repetir a lista de sugestões. Várias sugestões são classificadas de acordo com o número de resultados de cada produção.
Aninhe a tag <search-sugestivas> entre as tags open e close <search-if-sug> .
3
<link de sugestão de pesquisa> ... </search-sug-link>
Essa tag gera um link para a consulta de pesquisa original usando o termo de pesquisa sugerido selecionado em vez do termo original. A tag aceita e simplesmente imprime qualquer atributo HTML, como classe, destino e estilo. A tag também pode aceitar um atributo de URL, cujo valor é usado como URL base para o link gerado. As tags só podem aparecer dentro do loop <search-sugestivas> .
4
<search-sugesment-text/>
Essa tag imprime o termo de consulta sugerido atualmente (por exemplo, "pretende" para uma consulta originalmente inserida como "intenções"). A tag não tem atributos e só pode aparecer dentro do loop <search-sugestivas> .
5
<pesquisar-se-não-sugestões> ... </search-if-not-guide>
Se a pesquisa não gerar sugestões, o mecanismo de pesquisa resultará e processará tudo entre as tags open e close. Se a pesquisa gerar sugestões, nenhum conteúdo aninhado será gerado.
6
<search-if[-not]-first-sugestão> ... </search-if[-not]-first-sugestão>
Essas tags condicionais incluem o HTML entre elas com base no fato de o termo sugerido ser o primeiro termo no loop Sugest. As tags devem ser exibidas entre as tags <search-sugestão> abertas e fechadas.
7
<search-if[-not]-last-sugestão> ... </search-if[-not]-last-sugestão>
Essas tags condicionais incluem o HTML entre elas com base no fato de o termo sugerido ser o último termo no loop Sugest. As tags devem ser exibidas entre as tags <search-sugestão> abertas e fechadas.
8
<search-sugere-index>
Essa tag retorna o índice numérico do termo de pesquisa sugerido atual. A tag deve ser exibida entre as tags <search-sugestion> e open.
9
<pesquisa-sugestivo-total>
Essa tag retorna o número total de termos de pesquisa sugeridos gerados. A tag deve ser exibida entre as tags <search-sugestion> e open.
10
<pesquisa-sugestão-resultado-count>
Essa tag retorna o número total de resultados para o termo de pesquisa sugerido. A tag deve ser exibida entre as tags <search-sugestion> e open.

Tags de string de modelo

As tags a seguir exibem uma string no HTML nesse ponto do modelo.
Adicionar tag
Descrição
1
<search-body>
A tag body HTML com qualquer configuração de Cor do link de pesquisa definida pela Seção de aparência básica no link Modelo. Adicione um atributo de plano de fundo a essa tag para exibir imagens de plano de fundo na página de resultados. Quaisquer atributos de cor adicionados a essa tag substituem as configurações de Cor do link de pesquisa definidas pela seção Aparência básica.
2
<search-header>
O HTML do cabeçalho de resultados da pesquisa, conforme definido na seção Aparência básica sob o link Modelo.
3
<search-cdata> ... </search-cdata>
As tags search-cdata são substituídas por seus equivalentes XML: <search-cdata> é substituído por <![CDATA[" e a tag </search-cdata> são substituídas por " ]]> ". Um analisador XML não analisa nenhuma informação entre a tag open e close.
4
<search-query query query-number="XX" encoding="html/javascript/json/perl/url/none">
A consulta que o visitante inseriu. O atributo "query-number" avançado e opcional controla a sequência de caracteres de consulta numerada que é produzida por essa tag. Por exemplo, <search-query-query-number=1> gera o conteúdo do parâmetro sp_q_1 cgi. Se "query-number" não for especificado, ou se o query-number for "0", a consulta principal ( sp_q ) será a saída. O atributo opcional "encoding" controla se a saída é codificada em HTML, codificada em JavaScript, codificada em Perl, codificada em URL ou não, para saída na página de resultados. O valor padrão de "encoding" é "html". Normalmente, não é necessário especificar o atributo de codificação.
5
<search-total>
A contagem total de resultados desta pesquisa.
6
<search-count>
A contagem de resultados reportados para esta página.
7
<search-lower>
O número do primeiro resultado reportado para esta página.
8
<search-top>
O número do último resultado relatado para esta página.
9
<search-prev-count>
O número de resultados reportados para a página anterior.
10
<search-next-count>
O número de resultados reportados para a próxima página.
11
<tempo de pesquisa>
O tempo em segundos para esta pesquisa.
12
<search-logo>
O HTML do logotipo de pesquisa configurado para sua conta, se houver. Este logotipo é a imagem que dá crédito à pesquisa/comercialização do site
A maioria das contas não tem um logotipo de pesquisa associado no momento.
13
<search-collection all="name">
A coleção de resultados desta pesquisa. O atributo "tudo" opcional é usado para fornecer o nome da coleção que representa o site inteiro.
14
<forma de pesquisa> ...</search-form>
Insere marcas de formulário de início e fim. Insere os atributos de método e ação na tag de formulário inicial. Aceita atributos adicionais, incluindo o atributo dir="RTL" para idioma, bem como os atributos "name" e "onSubmit" relacionados ao JavaScript.
15
<search-input-account>
Insere uma tag de entrada de formulário que especifica o número da sua conta.
16
<search-input-gallery>
Insere uma tag de entrada de formulário que especifica o número da galeria.
17
<search-input-query query query query-number="XX">
Insere uma tag de entrada de formulário que especifica a string de consulta. O atributo "número de consulta" avançado e opcional controla qual consulta numerada é usada para a tag de entrada de formulário. Por exemplo, <search-input-query query query-number=1> gera uma tag de entrada de formulário para a consulta sp_q_1 . Se "query-number" não for especificado, ou se "query-number" for "0", uma tag de entrada para a consulta sp_q principal será inserida.
18
<search-input-collections all="name">
Insere uma tag de seleção de formulário e o HTML associado que exibem o menu de seleção de coleções. O atributo "tudo" opcional é usado para fornecer o nome da coleção que representa o site inteiro.
19
<search-lt>
Insere a saída de uma das tags de modelo de Pesquisa em outras tags HTML ou modelo na página de resultados. <search-lt> insere um caractere menor que. O uso de <search-lt> e <search-gt> fornece uma maneira de escapar da definição de uma tag para que você possa usar as tags de modelo de pesquisa como valores de atributo. Quando o modelo é renderizado em resposta a uma pesquisa, um sinal de menor que (<) substitui a tag <search-lt> . Por exemplo, <search-link> equivale a <search-lt>a href="<search-url>"<search-gt> .
20
<search-gt>
Insere a saída de uma das tags de modelo de Pesquisa em outras tags HTML ou modelo na página de resultados. <search-gt> insere um caractere maior que. O uso de <search-lt> e <search-gt> fornece uma maneira de escapar da definição de uma tag para que você possa usar outras tags de modelo como valores de atributo. Quando o modelo é renderizado em resposta a uma pesquisa, um sinal maior (>) substitui a tag <search-gt> . Por exemplo, <search-link> equivale a <search-lt>a href="<search-url>"<search-gt> .
21
<search-param name="param-name" length="XX" encoding="html/javascript/json/perl/url/none">
Retorna o valor do parâmetro cgi chamado "param-name" da solicitação de pesquisa atual. O atributo opcional "encoding" controla se a saída é codificada em HTML, codificada em JavaScript, codificada em Perl, codificada em URL ou não, para saída na página de resultados. O valor padrão de "encoding" é "html". Normalmente, não é necessário especificar o atributo de codificação.
22
<search-trace encoding="html/javascript/ json/perl/url/none">
O atributo encoding é opcional; o valor padrão é json .
Observação: Essa tag só terá saída se sp_trace=1 for especificado com os parâmetros de consulta de pesquisa principais.
Consulte a linha 48 na tabela encontrada nos parâmetros CGI de pesquisa de backend.

Tags de link de âncora de modelo

A seguir estão as tags que fazem com que um link de âncora delimite o HTML entre elas. Quando clicado, o link de âncora solicita outra página de resultados para exibição. O atributo opcional "count" solicita que muitos resultados na página sejam exibidos. Se não for especificado, a contagem solicitada na página atual será usada. O atributo avançado e opcional "URL" controla o domínio para o qual o link associado é direcionado. Por padrão, o domínio é https://search.atomz.com/search/ , mas você pode alterá-lo usando o atributo URL.
Adicionar tag
Descrição
1
<search-next URL="https://search.yourdomain.com/search/"> ... </search-next>
<search-prev URL="https://search.yourdomain.com/search/"> ... </search-prev>
Exibe a próxima página ou a página anterior dos resultados.
2
<search-sort-by-date URL="https://search.yourdomain.com/search/"> ... </search-sort-by-date>
<search-sort-by-score URL="https://search.yourdomain.com/search/"> ... </search-sort-by-score>
Classifica os resultados por data ou relevância.
3
<search-show-resume URL="https://search.yourdomain.com/search/"> ... </search-show-sumaries>
<search-hide-resume URL="https://search.yourdomain.com/search/"> ... </search-hide-resums>
Mostra ou oculta os resumos.

Tags condicionais do modelo

Tags que permitem incluir HTML condicionalmente entre elas.
Adicionar tag
Descrição
1
<search-if-results> ... </search-if-results>
<search-if-not-results> ...</search-if-not-results>
Essas tags incluem HTML se a página atual contiver algum (ou nenhum) resultado de pesquisa.
2
<search-if-prev-count> ... </search-if-prev-count>
<search-if-not-prev-count> ... </search-if-not-prev-count>
<search-if-next-count> ... </search-if-next-count>
<search-if-not-next-count> ... </search-if-not-next-count>
Essas tags incluem HTML se a página anterior ou a próxima página tiver algum resultado associado (ou nenhum).
3
<search-if-sort-by-score> ... </search-if-sort-by-score>
<search-if-not-sort-by-score> ... </search-if-not-sort-by-score>
<search-if-sort-by-date> ... </search-if-sort-by-date>
<search-if-not-sort-by-date> ... </search-if-not-sort-by-date>
Essas tags incluem HTML se a página atual for ou não classificada por relevância ou data.
4
<search-if-show-suposições> ... </search-if-show-sumaries>
<search-if-hide-suposições> ... </search-if-hide-suposições>
Essas tags incluem HTML se a página atual estiver mostrando ou ocultando resumos. Você pode usar essas tags para incluir ou excluir qualquer parte do resultado da pesquisa.
5
<search-if-input-collections> ... </search-if-input-collections>
<search-if-not-input-collections> ... </search-if-not-input-collections>
Essas tags incluem HTML se uma coleção foi especificada na geração de resultados de pesquisa para a página atual.
6
<search-if-advanced> ... </search-if-advanced>
<search-if-not-advanced> ... </search-if-not-advanced>
Essas tags incluem HTML se o parâmetro sp_advanced=1 CGI foi especificado para a consulta de pesquisa.
7
<search-if-bad-param name="parameter-name"> ... </search-if-bad-param>
<search-if-not-bad-param name="parameter-name"> ... </search-if-not-bad-param>
Essas tags incluem ou excluem o HTML entre elas se o parâmetro especificado for ou não inválido.
Atualmente, apenas o parâmetro sp_q_location[_#] é suportado.
8
<search-if-param name="param-name" value="param-value"> ... </search-if-param>
<search-if-not-param name="param-name" value="param-value"> ... </search-if-not-param>
Essas tags avançadas incluem o HTML entre elas com base no fato de o parâmetro CGI especificado no atributo "name" ter o valor especificado no atributo "value".
9
<search-if-sort-by-field name="field-name"> ... </search-if-sort-by-field>
<search-if-not-sort-by-field name="field-name"> ... </search-if-not-sort-by-field>
Essas tags avançadas incluem o HTML entre elas se a página atual for ou não classificada pelo nome do campo fornecido.

Tags de controle de formulário de modelo

Tags que permitem controlar o estado de seleção padrão para caixas de seleção, botões de opção e caixas de listagem dentro de uma lista <form> no modelo de pesquisa.
Adicionar tag
Descrição
1
<search-input>
Usado em um modelo no lugar de uma tag <input> . Quando a tag é gravada no navegador, a palavra input substitui a search-input e todas as outras informações na tag são exibidas como estão. Além disso, se o nome especificado na tag for listado como um parâmetro CGI e se o valor especificado na tag for o valor desse parâmetro CGI, a palavra verificada será adicionada no final da tag. Dessa forma, você pode tornar automaticamente o estado padrão do botão de opção ou da caixa de seleção no resultado da pesquisa igual à consulta atual.
Por exemplo, o código HTML de uma caixa de seleção pode ser semelhante ao seguinte:
<input type=checkbox name="sp_w" value="exato">Nenhum som parecido correspondente
O código de modelo correspondente para essa caixa de seleção é o seguinte:
<search-input type=checkbox name="sp_w" value="exato">Nenhuma correspondência de som semelhante
Se a string do parâmetro CGI para a consulta contiver sp_w=exato , a tag gravada no navegador com os resultados da pesquisa será semelhante ao seguinte (a palavra marcada é inserida no final da tag):
<input type=checkbox name="sp_w" value="exato" marcado>Nenhum som semelhante correspondente
Se a string do parâmetro CGI para a consulta não contiver sp_w=exato , a tag gravada no navegador com os resultados da pesquisa será semelhante ao seguinte (a palavra marcada não é listada na tag):
<input type=checkbox name="sp_w" value="exato">Nenhum som parecido correspondente
A tag <search-input> é útil para colocar caixas de seleção e botões de opção em seu modelo de pesquisa. Se você tiver caixas de seleção ou botões de opção que deseja adicionar ao <form> no modelo de pesquisa, use <search-input...> no lugar de <input...> .
2
<search-select> ... </search-select>
<opção de pesquisa> ... </search-option>
Caixas de listagem suspensas em uma tag <form> são iniciadas com uma tag <select> e terminadas com uma tag </select> . O nome do parâmetro CGI associado está listado dentro da tag <select> . A seguir, a tag <select> é uma lista de tags <option> que especificam os valores a serem exibidos na caixa de listagem.
As tags <search-select> , </search-select> , <search-option> e </search-option> fornecem uma funcionalidade semelhante à tag <search-input> . Ou seja, a palavra selecionada é adicionada automaticamente no final da tag <option> enviada para o navegador se o nome na tag <search-select> estiver listado como um parâmetro CGI e se o valor desse parâmetro CGI estiver listado como o valor em uma tag específica <search-select>. Dessa forma, você pode fazer automaticamente a escolha da caixa de listagem padrão em seu resultado de pesquisa igual à consulta atual.
Por exemplo, uma caixa de listagem típica tem a seguinte aparência:
<select name="sp_x" size=1> <option value="any" selected>Anywhere</option> <option value="title">Title</option> <option value="desc">Description</option> <option value="keys">Keywords</option> <option value="body">Body</option> <option value="alt">Alternate text</option> <option value="url">URL</option> <option value="target">Target</option> </select>
O código de modelo correspondente para essa caixa de listagem é o seguinte:
<search-select name="sp_x" size=1> <search-option value="any">Anywhere</search-option> <search-option value="title">Title</search-option> <search-option value="desc">Description</search-option> <search-option value="keys">Keywords</search-option> <search-option value="body">Body</search-option> <search-option value="alt">Alternate text</search-option> <search-option value="url">URL</search-option> <search-option value="target">Target</search-option> </search-select>
Se você tiver caixas de listagem que deseja adicionar ao <form> em seu modelo de pesquisa, use <search-select...> no lugar de <select...> , </search-select> no lugar de </select> , <search-option...> no lugar de <option...> , </search-option em vez de option>.
3
<search-sort-by-field name="field-name" count="XX"> ... </search-sort-by-field>
Essas tags avançadas criam um link de âncora em torno do HTML entre elas. Quando essa âncora é clicada, uma página de resultados classificados no campo especificado é exibida. O atributo count opcional especifica o número de resultados a serem exibidos na página de resultados. Se a contagem for omitida, a contagem usada na página atual será usada.

Strings de formato de data

Você pode usar as seguintes especificações de conversão em strings de formato de data:
String de formato de data
Descrição
%Um
Corresponde à representação nacional do nome do dia da semana inteiro, por exemplo, "Segunda-feira." A configuração em Linguística > Palavras e Idiomas > Idioma determina a representação nacional.
%a
Corresponde à representação nacional do nome abreviado do dia da semana, onde a abreviação é os três primeiros caracteres, por exemplo "Mon". A configuração em Linguística > Palavras e Idiomas > Idioma determina a representação nacional.
%B
Corresponde à representação nacional do nome do mês inteiro, por exemplo, "June". A configuração em Linguística > Palavras e Idiomas > Idioma determina a representação nacional.
%b
Corresponde à representação nacional do nome abreviado do mês, em que a abreviação corresponde aos três primeiros caracteres, por exemplo "Jun." A configuração em Linguística > Palavras e Idiomas > Idioma determina a representação nacional.
%D
Equivalente a "%m/%d/%y", por exemplo "07/25/13".
%d
Corresponde ao dia do mês como um número decimal (01-31).
%e
Corresponde ao dia do mês como um número decimal (1-31). Um branco precede um dígito único.
%H
Corresponde ao relógio de 24 horas como um número decimal (00-23).
%h
Corresponde à representação nacional do nome abreviado do mês, em que a abreviação corresponde aos três primeiros caracteres, por exemplo "Jun" (o mesmo que %b).
%I
Corresponde ao relógio de 12 horas como um número decimal (01-12).
%j
Corresponde ao dia do ano como um número decimal (001-366).
%k
Corresponde ao (relógio de 24 horas como um número decimal (0-23). Um branco precede um dígito único.
%l
Corresponde ao relógio de 12 horas da hora como um número decimal (1-12). Um branco precede um dígito único.
%M
Corresponde ao minuto como um número decimal (00-59).
%m
Corresponde ao mês como um número decimal (01-12).
%p
Corresponde à representação nacional de "ante meridiem" ou "post meridiem", conforme apropriado, por exemplo "PM". A configuração em Linguística > Palavras e Idiomas > Idioma determina a representação nacional.
%R
Equivalente a "%H:%M", por exemplo, "13:23".
%r
Equivalente a "%I:%M:%S %p", por exemplo, "01:23:45 PM".
%S
Corresponde ao segundo como um número decimal (00-60).
%T
Equivalente a "%H:%M:%S", por exemplo, "13:26:47".
%U
Corresponde ao número da semana do ano (domingo como primeiro dia da semana) como um número decimal (00-53).
%v
Equivalente a "%e-%b-%Y", por exemplo, "25-jul-2013".
%S
Corresponde ao ano com século como um número decimal, por exemplo, "2013".
%y
Corresponde ao ano sem século como um número decimal (00-99).
%Z
Corresponde ao nome do fuso horário.
%%
Corresponde "%".

Identificadores de idioma

A tabela a seguir contém os identificadores de idioma para cada idioma suportado. Você pode usar esses identificadores como valores para o atributo "language" opcional nas seguintes tags de modelo:
Idioma
Identificador do idioma
Búlgaro (Bulgária)
bg_BG
Chinês (China)
zh_CN
Chinês (Hong Kong)
zh_HK
Chinês (Cingapura)
zh_SG
Chinês (Taiwan)
zh_TW
Tcheco (República Tcheca)
cs_CZ
Dinamarquês (Dinamarca)
da_DK
Holandês (Bélgica)
nl_BE
Holandês (Países Baixos)
nl_NL
Inglês (Austrália)
en_AU
Inglês (Canadá)
en_CA
Inglês (Grã-Bretanha)
en_GB
Inglês (Estados Unidos)
en_US
Francês (Bélgica)
fr_BE
Francês (Canadá)
fr_CA
Finlandês (Finlândia)
fi_FI
Francês (França)
fr_FR
Francês (Suíça)
fr_CH
Alemão (Áustria)
de_AT
Alemão (Alemanha)
de_DE
Alemão (Suíça)
de_CH
Grego (Grécia)
el_GR
Gaélico Irlandês (Irlanda)
ga_IE
Italiano (Itália)
it_IT
Japonês (Japão)
ja_JP
Coreano (Coreia)
ko_KR
Norueguês (Noruega)
no_NO
Polonês (Polônia)
pl_PL
Português (Brasil)
pt_BR
Português (Portugal)
pt_PT
Russo (antiga União Soviética)
ru_SU
Eslovaco (Eslováquia)
sk_SK
Eslovaco (Eslovênia)
sl_SI
Espanhol (México)
es_MX
Espanhol (Espanha)
es_ES
Sueco (Suécia)
sv_SE

Especificação do cabeçalho HTTP tipo conteúdo

Você pode especificar o cabeçalho de resposta HTTP Tipo de conteúdo usando a seguinte tag:
<search-content-type-header [content="MIME-type"] [charset="charset-name"]>
Os atributos content e charset são opcionais. Essa tag deve aparecer o mais cedo possível no modelo. Também é recomendável que ele seja exibido antes <search-html-meta-charset> ou <search-xml-decl> , pois afeta o comportamento dessas tags.
Se você não especificar o content atributo, o valor do padrão será MIME-type o valor definido em Settings > Crawling > Content Types . Se você especificar um content atributo, ele será usado como o content atributo padrão para a <search-html-meta-charset> tag .
Se você não especificar o charset atributo, nenhum charset valor será gravado no content-type cabeçalho.
Se você especificar charset="1" , o valor real para charset-name será o valor do parâmetro sp_f CGI. Se nenhum parâmetro sp_f CGI for enviado com a pesquisa, o valor real para charset-name será lido nas configurações da sua conta. Você pode exibir ou alterar o conjunto de caracteres associado à sua conta em Settings > My Profile > Personal Information > Character Encoding .
Consulte Configuração das informações pessoais do usuário.
É possível escolher um nome de conjunto de caracteres específico ao listá-lo como o charset valor, como charset="iso-8859-1" ou charset="Shift-JIS" .
Se você especificar um charset atributo, ele será usado como o charset atributo padrão para as tags <search-html-meta-charset> e <search-xml-decl> , bem como como como saída para o content-type cabeçalho.

Especificação de um conjunto de caracteres em um modelo HTML

Os modelos de resultados de pesquisa HTML padrão especificam o conjunto de caracteres associado à conta atual por meio da seguinte tag:
<search-html-meta-charset [content="MIME-type"] [charset="charset-name"]>
Os atributos de conteúdo e conjunto de caracteres são opcionais. Essa tag deve aparecer na <head> seção HTML do modelo. Essa tag resulta na seguinte tag na página HTML gerada a partir do modelo:
<meta http-equiv="content-type" content="MIME-type; charset=charset-name">
Se você não especificar o atributo content, o valor real de MIME-type padrão assumirá um de dois valores. Se a <search-content-type-header> tag especificou um content atributo, esse valor será usado. Caso contrário, o valor usado será aquele definido na guia Templates > Settings > Content Type .
Se você não especificar o charset atributo, o valor real de charset-name assumirá dois valores como padrão. Se a <search-content-type-header> tag especificou um charset atributo, esse valor será usado. Caso contrário, o valor real para charset-name será lido nas configurações da sua conta. Você pode exibir ou alterar o conjunto de caracteres associado à sua conta em Settings > My Profile > Personal Information > Character Encoding .
Consulte Configuração das informações pessoais do usuário.
Se você especificar charset="1" , o valor real para charset-name será o valor do parâmetro sp_f CGI. Se nenhum parâmetro sp_f CGI for enviado com a pesquisa, o valor real para charset-name será o valor definido na <search-content-type-header> tag, se for especificado, ou o valor definido nas configurações da sua conta.
É possível especificar um nome de conjunto de caracteres específico, como em charset="charset-name" . For example, charset="iso-8859-1" or charset="Shift-JIS" .
A <search-html-meta-charset> tag é opcional. Se você removê-lo, o navegador assumirá os valores padrão para content-type , que são os seguintes: content="text/html; charset=ISO-8859-1" . Você também pode optar por substituir a <search-html-meta-charset> tag por sua própria http-equiv tag.

Especificação de um conjunto de caracteres em um modelo XML

O modelo de resultado de pesquisa XML padrão especifica o conjunto de caracteres associado à conta atual por meio da seguinte tag:
<search-xml-decl [charset="charset-name"]>
O charset atributo é opcional. Essa tag deve aparecer na parte superior do modelo, mas após qualquer <search-content-type-header> tag. Essa tag resulta na seguinte tag no documento XML gerado a partir do modelo:
<?xml version="1.0" encoding="charset-name" standalone="yes" ?>
Se você não especificar o charset , o valor real de charset-name assumirá um dos dois valores como padrão. Se um <search-content-type-header> atributo foi charset especificado, esse valor será usado. Caso contrário, o valor real para charset-name será lido nas configurações da sua conta. Você pode exibir ou alterar o conjunto de caracteres associado à sua conta em Settings > My Profile > Personal Information > Character Encoding .
Consulte Configuração das informações pessoais do usuário.
Se você especificar charset="1" , o valor real para charset-name será o valor do parâmetro sp_f CGI. Se nenhum parâmetro sp_f CGI for enviado com a pesquisa, o valor real para charset-name será o valor definido na <search-content-type-header> tag se for especificado, ou o valor definido nas configurações da sua conta.
É possível especificar um nome de conjunto de caracteres específico, como em, se desejar, charset="charset-name" . Por exemplo, charset="iso-8859-1" or charset="Shift-JIS" .
Você pode optar por substituir a <search-xml-decl> tag por sua própria ?xml tag.

Incluindo um modelo de pesquisa em outro

Para incluir um modelo de pesquisa em outro, use a <search-include> tag , definindo o atributo de arquivo para o nome do arquivo de modelo que você deseja incluir como no exemplo a seguir:
<search-include file="seo/seo_search_title.tpl" />
Os segmentos do modelo de pesquisa SEO estão na seo/ subpasta e os modelos de pesquisa normais estão na templates/ subpasta. Somente arquivos .tpl são significativos para incluir neste contexto.

Gerenciar vários modelos de transporte para seu site

Você pode controlar a aparência dos resultados da pesquisa em seu site usando diferentes modelos de transporte de pesquisa para cada área.
Para realizar esse tipo de funcionalidade de pesquisa, você pode gerenciar seus modelos de transporte na pesquisa/comercialização do site. Ou você pode gerenciar seus modelos de transporte em Publicar. Como pesquisa/comercialização do site, a Publicação permite que você edite, visualize e publique vários modelos de transporte de pesquisa.
Para configurar seus formulários de pesquisa para usar um modelo de transporte específico (diferente do padrão), use o parâmetro de sp_t consulta. Por exemplo, suponha que você tenha um modelo de pesquisa chamado "desistência" para a área de vendas marcada do site. Use o formulário de pesquisa HTML padrão com o seguinte código de formulário adicional:
<input type=hidden name="sp_t" value="clearance">
Quando um cliente clica em um formulário padrão que contém essa linha de código, o modelo de transporte de pesquisa "eliminação" é exibido junto com os resultados da pesquisa.
Consulte Amostra de formulário de pesquisa avançada.