Shortcodes

Versão atual: 1.8.5

Esta extensão fornece Shortcodes que geram formulários de pesquisa e páginas de resultados para os mecanismos de pesquisa do SearchWP. É útil se você não se sentir confortável (ou não puder) editar arquivos de tema diretamente para implementar seus formulários de pesquisa e loops de resultados.

Após ativar os Shortcodes, os seguintes estarão disponíveis para você:

Shortcode	Atributo(s)
`searchwp_search_form` Exibe um formulário de pesquisa para um mecanismo de pesquisa específico	`target` — A ação do formulário (Padrão é o permalink existente) `engine` — Nome do mecanismo de pesquisa (Padrão é `default`) `var` — O nome da variável da consulta de pesquisa (Padrão é `swpquery`) `button_text` — Texto do botão do formulário (Padrão é `Search`) `hide_button` — “true” ou “false”, oculta o botão de envio do formulário de pesquisa `placeholder` — Texto do placeholder da entrada do formulário (Padrão é `Search`) `live_search` — “true” ou “false”, força a ativação/desativação da Pesquisa Ajax em Tempo Real para este formulário, ignorando o valor da configuração global “Ativar Pesquisa em Tempo Real”
`searchwp_search_results` Exibe a lista de resultados da pesquisa após o envio de uma pesquisa	`engine` — Nome do mecanismo de pesquisa (Padrão é `default`) `var` — O nome da variável da consulta de pesquisa (Padrão é `swpquery`) `posts_per_page` — Quantos posts por página exibir Note que este não é um Shortcode auto-fechável, a marcação para cada resultado de pesquisa deve ser aninhada dentro dele, veja o exemplo abaixo
`searchwp_search_result_link` Exibe um link para o resultado da pesquisa atual com o texto do título do resultado	`direct` — “true” ou “false”, quando true, linka diretamente para o permalink, se for um anexo, linka diretamente para o seu URL, não para a página pai
`searchwp_search_result_excerpt` Exibe o excerto para o resultado da pesquisa atual	Nenhum
`searchwp_search_results_none` Saída se nenhum resultado de pesquisa foi encontrado	Nenhum Note que este não é um Shortcode auto-fechável, a marcação para cada resultado de pesquisa deve ser aninhada dentro dele, veja o exemplo abaixo
`searchwp_search_results_pagination` Exibe a paginação dos resultados da pesquisa	`engine` — Nome do mecanismo de pesquisa (Padrão é `default`) `direction` — “prev” ou “next” `link_text` — O texto a ser usado no link `var` — O nome da variável da consulta de pesquisa (Padrão é `swpquery`)
`searchwp_search_results_paginate_links` Exibe links paginados para os resultados da pesquisa	`engine` — Nome do mecanismo de busca (Padrão é `default`) `var` — O nome da variável da consulta de pesquisa (Padrão é `swpquery`) Além do acima, os argumentos de `paginate_links` também são suportados.
`searchwp_search_result_image` Exibe a Imagem Destacada para o resultado atual	`size` — Tamanho da imagem (Padrão é `thumb`)
`searchwp_search_result_permalink` Exibe o link permanente para o resultado atual com o texto do link permanente do resultado	`direct` — Se deve vincular diretamente a arquivos de mídia (Padrão é `'true'`)
`searchwp_total_results` Exibe o número total de resultados para a pesquisa atual	`engine` — Nome do mecanismo de busca (Padrão é `default`) `var` — O nome da variável da consulta de pesquisa (Padrão é `swpquery`) `text` — O texto a ser usado junto com o número de resultados. Suporta os placeholders `%total%` e `%query%` para formatação precisa.`[searchwp_total_results text="Found %total% results for %query%"]` é convertido para “Found 0 results for example search”.

Aqui está um exemplo de uma implementação abrangente de Shortcodes que pesquisa um mecanismo suplementar com o nome my_test_engine:

	<h3>Search Form</h3>
	[searchwp_search_form engine="my_test_engine" target="http://example.com/supplemental-search/" var="swpquery" button_text="Find Results"]

	<div class="search-results-wrapper">
	[searchwp_total_results text="Found %total% results for %query%" engine="my_test_engine" var="swpquery"]
	[searchwp_search_results engine="my_test_engine" var="swpquery" posts_per_page=10]
	<h2>[searchwp_search_result_link direct="true"]</h2>
	[searchwp_search_result_excerpt]
	[/searchwp_search_results]
	</div>

	<div class="no-search-results-found">
	[searchwp_search_results_none]
	No results found, please search again.
	[/searchwp_search_results_none]
	</div>

	<div class="search-results-pagination">
	[searchwp_search_results_pagination direction="prev" link_text="Previous" var="swpquery" engine="my_test_engine"]
	[searchwp_search_results_pagination direction="next" link_text="Next" var="swpquery" engine="my_test_engine"]
	</div>

view raw gistfile1.html hosted with ❤ by GitHub

Você pode personalizar os atributos de acordo com a tabela acima.

Registro de alterações

1.8.5

[Correção] Atributo FOR do rótulo não correspondia ao ID de entrada quando uma variável de pesquisa personalizada era usada.

1.8.4

[Novo] Opção adicionada para ocultar o botão de envio.

1.8.3

[Novo] Compatibilidade com Live Ajax Search.
[Melhoria] O shortcode searchwp_total_results suporta personalizações de texto.

1.8.2

[Correção] Prevenção de erro devido à recursão de Shortcode.
[Atualização] Atualizador atualizado.

1.8.1

[Correção] Atributo posts_per_page não refletido ao usar SearchWP 4.

1.8.0

[Novo] Novo Shortcode searchwp_search_results_paginate_links para links paginados.
[Novo] Novo Shortcode searchwp_search_result_image para a exibição da Imagem Destacada do resultado.
[Novo] Novo Shortcode searchwp_search_result_permalink para a exibição do link permanente do resultado.
[Atualização] Atualizador atualizado.

1.7.0

[Novo] Compatibilidade com SearchWP 4.

1.6.1

[Correção] Problema com o manuseio de aspas.

1.6

[Novo] Novo Shortcode: searchwp_total_results para exibir o número total de resultados da pesquisa.
[Novo] Adiciona o argumento placeholder ao Shortcode searchwp_search_form.
[Atualização] Atualizador atualizado.

1.5.4

[Correção] Verificações adicionais para prevenir a redeclaração de função em casos extremos.
[Atualização] Atualizador atualizado.

1.5.3

[Novo] Novo filtro: searchwp_shortcodes_engine.
[Novo] Novo filtro: searchwp_shortcodes_paginate_links.
[Novo] Novo filtro: searchwp_shortcodes_pagination_prev.
[Novo] Novo filtro: searchwp_shortcodes_pagination_next.
[Atualização] Atualizador atualizado.

1.5.1

[Novo] Novo Shortcode [searchwp_search_result_excerpt_global].
[Novo] Novo Shortcode [searchwp_search_result_excerpt_document].
[Melhoria] Escapamento refinado para melhor compatibilidade com Destaque de Termo.

1.5

[Melhoria] Suporte para atualizações automáticas com base na sua chave de licença do SearchWP.

1.2.1

[Novo] Adicionadas algumas ações durante a saída.

1.2

[Mudança] Permitir que a variável GET seja definida no atributo Shortcode, entre outras coisas.

1.1

[Correção] Corrigido um problema em que os atributos não eram passados para o callback do Shortcode.

1.0

Lançamento inicial.