\SearchWP\Statistics
Tabla de contenidos
\SearchWP\Statistics facilita la generación de datos estadísticos recopilados sobre las búsquedas de visitantes realizadas en su sitio.
Uso básico
\SearchWP\Statistics se puede utilizar para recuperar y mostrar datos registrados basándose en parámetros pasados de la siguiente manera:
| <?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 ); |
Hay parámetros adicionales que puede utilizar para refinar aún más los 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 ); |
Argumentos
No hay argumentos aceptados al instanciar \SearchWP\Statistics.
Métodos
get_popular_searches( array $args = [] )- Recupera las búsquedas populares basándose en los argumentos proporcionados.
- Acepta los siguientes parámetros
'days'(entero) El número de días a retroceder. (por defecto:1)'engine'(cadena) El nombre del\SearchWP\Enginea considerar. (por defecto:'default')'exclude'(cadena[]) Términos de búsqueda a ignorar, por ejemplo, spam, basura. (por defecto:[])'limit'(entero) El número de búsquedas populares a devolver. (por defecto:10)'min_hits'(falso|entero) Número mínimo de resultados devueltos para que se devuelvan las búsquedas. (por defecto:1)'max_hits'(falso|entero) Número máximo de resultados devueltos para que se devuelvan las búsquedas. (por defecto:false)'site'(entero[]) ID(s) del sitio para las búsquedas a devolver. (por defecto:[ get_current_blog_id() ])
Hooks
Hay una serie de ganchos disponibles para modificar aún más el comportamiento de \SearchWP\Statistics:

