Relacionado

Esta Extensão requer uma licença Pro

Versão atual: 1.5.5

Use o SearchWP para impulsionar conteúdo relacionado em seu site!

A extensão Related do SearchWP foi projetada para operar com sobrecarga mínima, ao mesmo tempo que oferece amplas opções de personalização para atender aos requisitos de design e funcionalidade do seu site. Exibir conteúdo relacionado aos visitantes é uma estratégia eficaz para manter o engajamento e incentivar os usuários a explorar páginas adicionais em seu site. Se você estiver usando atualmente outro sistema de conteúdo relacionado, o Related do SearchWP provavelmente reduzirá a sobrecarga do servidor, utilizando o índice de conteúdo que o SearchWP já criou.

Observação: O algoritmo Related do SearchWP usa títulos de entradas de posts como fonte de palavras-chave padrão para identificar e exibir conteúdo relacionado em todo o seu site, garantindo sugestões relevantes e contextualmente apropriadas para seus visitantes.

Configuração e Integração

Como todas as Extensões SearchWP, Related é um plugin WordPress autônomo que roda em conjunto com o SearchWP. Uma vez instalado, a extensão Related permanece inativa por padrão até que você a configure de acordo com suas preferências. Você pode acessar todas as opções de configuração e personalizar como o conteúdo relacionado aparece em suas páginas de post, navegando para Configurações do SearchWP → Related em sua área de back-end do WordPress.

Temas de Layout

A seção de temas de layout oferece vários estilos pré-projetados para exibir seu bloco de conteúdo relacionado no front-end do seu site. Você pode alternar facilmente entre diferentes temas de layout e visualizar cada opção antes de salvar suas alterações para garantir que o design corresponda à estética do seu site.

Minimalista: Este tema apresenta um layout de lista limpo e simples que exibe apenas títulos de posts organizados em um formato de grade organizado.

Colunas: Este layout de grade exibe resultados em várias colunas, apresentando títulos e descrições de posts para fornecer aos visitantes mais contexto sobre cada item relacionado.

Miniatura: Este layout combina uma estrutura de grade com imagens em destaque de tamanho grande ao lado de títulos de posts, criando uma exibição visualmente atraente que enfatiza o conteúdo visual.

Rico: Esta opção de layout abrangente oferece a apresentação visualmente mais envolvente, apresentando imagens grandes, títulos de posts e descrições em um formato de grade atraente que maximiza o apelo visual e a densidade de informações.

Personalizado: Esta opção flexível permite que você crie um layout completamente personalizado combinando e ajustando várias configurações da seção de configuração de conteúdo relacionado para atender aos seus requisitos de design específicos.

Estilo de Layout

A configuração de estilo de layout permite que você escolha entre os formatos de visualização em grade e em lista para exibir seu conteúdo relacionado. Adicionalmente, você pode especificar o número exato de resultados relacionados a serem exibidos em cada bloco de conteúdo relacionado, proporcionando controle preciso sobre a quantidade de conteúdo apresentada aos visitantes.

Título do Bloco

A configuração do título do bloco determina o texto do cabeçalho que aparece acima da sua seção de conteúdo relacionado no frontend. O valor padrão é “Conteúdo Relacionado”, mas você pode editá-lo de acordo com o conteúdo do seu site.

Imagens

Escolha o tamanho da imagem exibida com cada post relacionado. As opções de tamanho disponíveis são pequeno, médio e grande.

Descrições:
Um seletor para mostrar ou ocultar descrições para o conteúdo do bloco relacionado.

Motor

A configuração do motor define qual motor SearchWP será usado para determinar os tipos de postagem incluídos nas sugestões de conteúdo relacionado. Apenas fontes de postagem que foram adicionadas ao seu motor selecionado serão elegíveis para exibição no bloco de conteúdo relacionado.

Funcionalidade de Anexar Automaticamente

O recurso de anexar automaticamente permite que você selecione tipos de postagem específicos onde o bloco de conteúdo relacionado aparecerá automaticamente nas páginas de postagem, sem a necessidade de posicionamento manual. Apenas tipos de postagem que foram adicionados ao seu motor SearchWP estarão disponíveis para seleção nesta configuração.

Você também pode especificar a posição exata onde o conteúdo relacionado deve aparecer em suas páginas, com opções para exibir o bloco no final do seu conteúdo ou após um parágrafo específico dentro do conteúdo do seu post.

Excluir Entradas

A opção de excluir entradas fornece controle granular sobre quais posts aparecem em suas sugestões de conteúdo relacionado. Você pode excluir IDs de postagem específicos de aparecer em quaisquer blocos de conteúdo relacionado em todo o seu site.

Alternativamente, ao selecionar a opção “Pesquisar apenas IDs selecionados”, você pode restringir o conteúdo relacionado a uma lista definida de posts.

Incorporando Seu Bloco

Além da opção de anexar automaticamente, você pode incorporar o bloco de Conteúdo Relacionado manualmente de várias maneiras:

Integração de Bloco Gutenberg

O método de bloco Gutenberg fornece integração perfeita com o editor de blocos moderno do WordPress, permitindo que você incorpore o conteúdo relacionado do SearchWP diretamente em qualquer postagem ou página. Ao editar qualquer postagem ou página no editor Gutenberg, basta procurar pelo bloco “Relacionado” e adicioná-lo à localização desejada.

Implementação de Shortcode

Você pode utilizar o shortcode [searchwp_related] para exibir conteúdo relacionado em qualquer área compatível com shortcode do seu site.

Integração de Widget

Para temas que utilizam áreas de barra lateral com funcionalidade de widget, o SearchWP Related fornece uma opção de widget dedicada que permite exibir conteúdo relacionado em áreas de barra lateral em suas páginas de postagem.

Integração de Código PHP

Se você estiver trabalhando com modelos de postagem personalizados ou arquivos de tema, pode implementar conteúdo relacionado usando integração direta de código PHP. Este método fornece o controle mais técnico e permite que os desenvolvedores coloquem blocos de conteúdo relacionado precisamente dentro do código do modelo de tema personalizado e das estruturas de estilo.

Configurações Específicas do Post

Quando você seleciona tipos de post específicos na opção de anexar automaticamente, configurações adicionais da extensão SearchWP Related ficam disponíveis sob o título “Conteúdo Relacionado SearchWP” na tela de edição de posts para esses tipos de post.

Palavras-chave Personalizadas

Por padrão, o algoritmo de conteúdo relacionado analisa as palavras-chave encontradas nos títulos dos posts para identificar sugestões de conteúdo relacionado para cada post. No entanto, a opção de palavras-chave personalizadas permite que você especifique palavras-chave alternativas para encontrar conteúdo relacionado para posts específicos.

Este recurso inclui uma pré-visualização de “Amostra de Resultados” que exibe quais posts aparecerão no bloco de conteúdo relacionado com base nas suas seleções de palavras-chave personalizadas, permitindo que você verifique a relevância do conteúdo sugerido antes de publicar.

Configurações de Sempre Incluir

O botão de configurações localizado à direita da seção de palavras-chave personalizadas, revela opções de configuração adicionais, incluindo o recurso “Sempre Incluir”.

Esta opção poderosa permite que você selecione manualmente posts específicos que deseja garantir que apareçam no bloco de conteúdo relacionado para o post atual, independentemente da correspondência algorítmica. Isso garante que conteúdo importante ou estrategicamente relacionado sempre apareça em suas sugestões de conteúdo relacionado, fornecendo controle editorial sobre recomendações automatizadas.

Personalizando a saída: o carregador de modelos

Assim como acontece com a Pesquisa ao Vivo, o Related também usa um carregador de modelos para permitir a personalização completa dos resultados Related. Existe um modelo padrão que se parece com isto:

Screen Shot 2017-04-14 at 10.10.33 AM - SearchWP — O modelo padrão Related combinará a fonte e as cores do seu tema em certa medida

Na pasta do plugin Related, há outra pasta chamada templates contendo este modelo Related padrão (related.php) usado para exibir o conteúdo Related.

~/wp-content/plugins/searchwp-related/templates/related.php

O conteúdo deste arquivo é o seguinte: related.php

Não edite este arquivo diretamente. Se você instalar uma atualização do Related, quaisquer personalizações que você fizer neste arquivo serão substituídas!

Em vez disso, você pode utilizar o carregador de modelos integrado ao Related para adicionar seu próprio modelo personalizado dentro do seu tema.

Para personalizar a saída do conteúdo Related, crie uma nova pasta dentro do seu tema e cole uma cópia do modelo Related padrão nessa pasta, mantendo o mesmo nome de arquivo:

~/wp-content/themes/my-theme/searchwp-related/related.php

Você pode personalizar totalmente este modelo para atender às suas necessidades. Ele é baseado no The Loop, e você pode fazer qualquer coisa dentro do modelo que faria em qualquer outro modelo de tema.

Opções de Modelo

Embora o modelo usado para exibir o conteúdo Related seja principalmente um modelo de tema padrão, você pode influenciar como o Related se comporta editando o bloco de comentários opcional no topo do arquivo:

/** * SearchWP Engine: default * Maximum Results: 3 */<code></code>

Você pode personalizar o motor SearchWP usado e o número máximo de entradas Relacionadas exibidas editando a linha aplicável no topo do template.

As amostras de Resultados incluirão todos os motores disponíveis. Se você quiser limitar as amostras exibidas a apenas alguns motores, você pode usar este filtro:

~/wp-content/themes/meu-tema/searchwp-related/related-page.php

Ele seria usado apenas para Páginas. Todos os outros tipos de postagem usariam o template base.

Recuperar programaticamente conteúdo Relacionado

Se você quiser usar o carregador de templates, mas em um local diferente do que a caixa de seleção de anexo automático usa, deixe essa caixa desmarcada e edite seu arquivo de template para incluir o seguinte onde você deseja a saída Relacionada:

	<?php

	// This should be within your single.php or other applicable template that has the $post defined
	$related = new SearchWP_Related\Template();
	echo $related->get_template();

view raw single.php hosted with ❤ by GitHub

Você também pode pular completamente o carregador de templates e, em vez disso, recuperar o conteúdo Relacionado diretamente no código do seu tema. Veja como você pode fazer isso:

	<?php

	/*
	* Programmatically find Related content from SearchWP Related
	*/

	// Instantiate SearchWP Related
	$searchwp_related = new SearchWP_Related();

	// Use the keywords as defined in the SearchWP Related meta box
	$keywords = get_post_meta( get_the_ID(), $searchwp_related->meta_key, true );

	$args = array(
	's' => $keywords, // The stored keywords to use
	'engine' => 'default', // the SearchWP engine to use
	'posts_per_page' => 3, // how many entries to find
	);

	// Retrieve Related content for the current post
	$related_content = $searchwp_related->get( $args );

	// Returns an array of Post objects for you to loop through
	print_r( $related_content );

view raw functions.php hosted with ❤ by GitHub

Há uma série de argumentos que você pode passar para personalizar como o Relacionado encontrará conteúdo relacionado, aqui está uma análise completa dos argumentos possíveis:

	<?php

	// Use the saved keywords from the meta box
	$keywords = get_post_meta( get_the_ID(), $searchwp_related->meta_key, true );

	$defaults = array(
	'engine' => 'default', // Engine to use
	's' => $keywords, // Terms to search
	'fields' => 'all', // Return post objects, use 'ids' to return IDs
	'posts_per_page' => 3, // How many results to return
	'log' => false, // Log the search?
	'post__in' => array(), // Limit results pool?
	'post__not_in' => array() // Exclude posts from results?
	);

view raw functions.php hosted with ❤ by GitHub

Sugere-se que você configure algum tipo de cache (por exemplo, via Transient) para reduzir o uso de recursos.

Personalizando o input: definindo o conteúdo Relacionado

Por padrão, o Relacionado criará uma lista de palavras-chave a partir do título das suas entradas. Palavras comuns são removidas para aumentar a relevância dos resultados Relacionados. Em cada tela de edição de entrada, o Relacionado exibirá uma meta box permitindo que você personalize quais palavras-chave são usadas para determinar o conteúdo Relacionado:

searchwp-related - SearchWP — Amostras de resultados em tempo real ao personalizar palavras-chave

Um conjunto de três amostras de resultados é exibido, permitindo que você personalize as palavras-chave que está usando, se desejar. Esta é apenas uma amostra, o carregador de templates controla como os resultados são exibidos no front-end, e o SearchWP determina quais entradas exibir em tempo de execução.

The Results samples will include all the available engines. If you want to limit the samples displayed to only some engines you can use this filter:

	<?php

	// Define the engines to use for the metabox samples.
	add_filter( 'searchwp_related_meta_box_sample_engines', function( $engines ) {
	return [ 'default', 'products' ];
	} );

view raw functions.php hosted with ❤ by GitHub

Registro de alterações

1.5.5

[Atualização] Compatibilidade atualizada com WP 6.9.
[Correção] Linha vazia extra removida em itens de dropdown.

1.5.4

[Correção] Rascunhos, posts pendentes listados na opção Incluir Sempre e potencialmente exibidos no frontend.
[Atualização] Atualizador atualizado.

1.5.3

[Novo] Adicionado hook searchwp_related_meta_box_sample_engines para filtrar os motores exibidos nas amostras da meta box.
[Mudança] Amostras de resultados agora são responsivas.

1.5.2

[Correção] Erro de JavaScript se a opção "Ocultar Anúncio" do SearchWP estiver habilitada.

1.5.1

[Mudança] Adicionada tag "Testado até" para indicar a compatibilidade com a versão mais recente do WP
[Mudança] Arquivos de build removidos para evitar acionar automações em alguns sistemas
[Correção] Erro de PHP quando o plugin SearchWP não está ativo

1.5.0

[Novo] A área de configurações é reformulada, proporcionando mais controle sobre o conteúdo e a aparência visual do bloco Relacionado
[Novo] Novo bloco Gutenberg e Shortcode são adicionados para incorporação manual
[Alteração] A versão mínima exigida do SearchWP para a extensão Related é 4.2.6
[Alteração] Funções e métodos redundantes/não utilizados removidos

1.4.8

[Correção] Erro em versões do PHP anteriores à 7.3 causado por vírgula final em chamada de função
[Correção] Lista de sugestões não é renderizada novamente na alteração do campo Keywords na metabox do post
[Correção] Avisos de depreciação no PHP 8.2

1.4.7

[Correção] Erro de análise para PHP 7.2 e inferior
[Correção] Compatibilidade com SearchWP 4.2.0 e superior

1.4.6

[Novo] Array de contexto adicionado a searchwp_related_default_keywords
[Correção] Aviso PHP
[Correção] Posts excluídos na pré-visualização em alguns casos

1.4.5

[Correção] Renderização inicial da pré-visualização

1.4.4

[Correção] Aviso PHP, Erro em alguns casos
[Atualização] Atualizador atualizado

1.4.3

[Correção] Impede o registro em Métricas do SearchWP quando aplicável

1.4.2

[Correção] Corrige Erro ao usar SearchWP 4

1.4.0

[Novo] Adiciona suporte para SearchWP 4

1.3

[Novo] Forçar entradas Related específicas para cada entrada
[Novo] Conteúdo Related agora é armazenado em cache por 12 horas
[Novo] Hook para controlar o TTL do cache de consulta em segundos searchwp_related_cache_length
[Novo] Hook para controlar se o cache é usado searchwp_related_cache_enabled
[Correção] Auto-append não funcionando em alguns casos
[Correção] Paginação não respeitada em alguns casos
[Correção] Palavras-chave padrão não preenchidas em alguns casos
[Correção] Links para a documentação
[Alteração] Meta box não aparece mais em tipos de postagem não públicos por padrão
[Alteração] Resultados adicionais encontrados se o conjunto de resultados inicial for muito restrito pelo SearchWP
[Atualização] Fonte de tradução
[Atualização] Atualizador atualizado

1.1.1

[Alteração] O conjunto de palavras-chave de fallback agora é definido quando os Rascunhos são salvos (anteriormente era ao Publicar)

1.1

[Novo] Adiciona Widget
[Novo] Novos hooks para controlar a posição da metabox searchwp_related_meta_box_context e searchwp_related_meta_box_priority

1.0.4

[Correção] Corrigido um problema com enfileiramentos excessivos

1.0.3

[Correção] Corrigido um problema onde entradas relacionadas não eram encontradas em certas circunstâncias
[Atualização] Atualizador atualizado

1.0.2

[Correção] Entradas recém-publicadas não são mais automaticamente ignoradas se nenhuma palavra-chave for inserida, usarão fallbacks por padrão
[Correção] Implementação do filtro searchwp_related_excluded_post_types agora é aplicada corretamente e funciona

1.0.1

[Correção] Impede erro fatal PHP(<5.5) Não é possível usar o valor de retorno da função em contexto de escrita

1.0.0

Lançamento inicial

Relacionado

Configuração e Integração

Temas de Layout

Estilo de Layout

Incorporando Seu Bloco

Configurações Específicas do Post

Personalizando a saída: o carregador de modelos

Opções de Modelo

Recuperar programaticamente conteúdo Relacionado

Personalizando o input: definindo o conteúdo Relacionado

Registro de alterações

1.5.5

1.5.4

1.5.3

1.5.2

1.5.1

1.5.0

1.4.8

1.4.7

1.4.6

1.4.5

1.4.4

1.4.3

1.4.2

1.4.0

1.3

1.1.1

1.1

1.0.4

1.0.3

1.0.2

1.0.1

1.0.0

Crie uma Experiência de Pesquisa WordPress Melhor Hoje