`\SearchWP\Statistics`

Sumário

\SearchWP\Statistics facilita a geração de dados estatísticos coletados sobre as pesquisas de visitantes realizadas em seu site.

Uso Básico

\SearchWP\Statistics pode ser usado para recuperar e exibir dados registrados com base em parâmetros passados, como segue:

	<?php
	// @link https://searchwp.com/documentation/classes/searchwp-statistics/
	// Retrieve the most commmon searches for the
	// Default engine from the past thirty days.
	$statistics = \SearchWP\Statistics::get_popular_searches( [
	'days' => 30,
	'engine' => 'default',
	] );

	// Display the results in a <table>.
	\SearchWP\Statistics::display( $statistics );

view raw functions.php hosted with ❤ by GitHub

Existem parâmetros adicionais que você pode usar para refinar ainda mais os resultados:

	<?php
	// @link https://searchwp.com/documentation/classes/searchwp-statistics/
	$statistics = \SearchWP\Statistics::get_popular_searches( [
	// 7 days old or newer.
	'days' => 7,

	// The Engine used for searches.
	'engine' => 'default',

	// The search queries to ignore i.e. spam, junk.
	'exclude' => [ 'spam search query', 'lorem ipsum' ],

	// How many search queries to return.
	'limit' => 5,

	// With at least one result.
	'min_hits' => 1,

	// With at most 100 results.
	'max_hits' => 100,

	// Which site(s) to consider.
	'site' => [ get_current_blog_id() ],
	] );

	// Display the stats in a <table>.
	\SearchWP\Statistics::display( $statistics );

view raw functions.php hosted with ❤ by GitHub

Não há argumentos aceitos ao instanciar \SearchWP\Statistics.

get_popular_searches( array $args = [] ): Recupera pesquisas populares com base nos argumentos fornecidos.; Aceita os seguintes parâmetros; 'days' (integer) O número de dias a serem considerados. (padrão: 1); 'engine' (string) O nome do \SearchWP\Engine a ser considerado. (padrão: 'default'); 'exclude' (string[]) Termos de pesquisa a serem ignorados, por exemplo, spam, lixo. (padrão: []); 'limit' (integer) O número de pesquisas populares a serem retornadas. (padrão: 10); 'min_hits' (false|integer) Número mínimo de resultados retornados para que as pesquisas sejam exibidas. (padrão: 1); 'max_hits' (false|integer) Número máximo de resultados retornados para que as pesquisas sejam exibidas. (padrão: false); 'site' (integer[]) ID(s) do site para as pesquisas a serem retornadas. (padrão: [ get_current_blog_id() ])

Há uma série de ganchos disponíveis para modificar ainda mais o comportamento de \SearchWP\Statistics: