`\SearchWP\Statistics`

Table des matières

\SearchWP\Statistics facilite la génération de données statistiques collectées sur les recherches des visiteurs effectuées sur votre site.

Utilisation de base

\SearchWP\Statistics peut être utilisé pour récupérer et afficher les données enregistrées en fonction des paramètres passés comme suit :

	<?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

Il existe des paramètres supplémentaires que vous pouvez utiliser pour affiner davantage les résultats :

	<?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

Il n'y a pas d'arguments acceptés lors de l'instanciation de \SearchWP\Statistics.

get_popular_searches( array $args = [] ): Récupère les recherches populaires en fonction des arguments fournis.; Accepte les paramètres suivants; 'days' (entier) Le nombre de jours à remonter. (défaut : 1); 'engine' (chaîne) Le nom du \SearchWP\Engine à considérer. (défaut : 'default'); 'exclude' (chaîne[]) Termes de recherche à ignorer, par exemple spam, indésirable. (défaut : []); 'limit' (entier) Le nombre de recherches populaires à retourner. (défaut : 10); 'min_hits' (faux|entier) Nombre minimum de résultats retournés pour les recherches à retourner. (défaut : 1); 'max_hits' (faux|entier) Nombre maximum de résultats retournés pour les recherches à retourner. (défaut : false); 'site' (entier[]) ID de site pour les recherches à retourner. (défaut : [ get_current_blog_id() ])

Il existe un certain nombre de hooks disponibles pour modifier davantage le comportement de \SearchWP\Statistics :