SearchWP Documentation

Consultez le guide d’installation, parcourez la base de connaissances, découvrez les nombreux hooks de SearchWP

\SearchWP\Rule

\SearchWP\Rule est responsable de la modélisation des contraintes entourant les résultats de recherche (\SearchWP\Entry) qui sont pris en compte lors de l'exécution d'une \SearchWP\Query. Par exemple :

  • Exclure les articles de la catégorie « Non classé »
  • Afficher uniquement les mises à jour publiées au cours des 6 derniers mois
  • etc…

Contrairement à db_where() dans une \SearchWP\Source qui s'applique *toujours*, les \SearchWP\Rules sont visibles par l'utilisateur et sont établis lors de la configuration des Moteurs. Les \SearchWP\Rules sont appliqués à la fois lors de l'indexation et de la recherche.

Arguments

Lors de l'instanciation d'une nouvelle \SearchWP\Rule, un array des éléments suivants peut être fourni :

name (string)
Un nom unique. (défaut : '')
label (string)
Libellé d'affichage. (défaut : valeur de name)
options (false|array|callable)
Options. (défaut : false)
option_values_ajax_tag (string)
Callback AJAX pour récupérer les options à la volée. (défaut : valeur de '')
conditions (false|array)
Conditions qui peuvent être appliquées. (défaut : false)
Lorsque array les valeurs suivantes peuvent être utilisées : '=', '!=', '>', '>=', '<', '<=', 'LIKE', 'NOT LIKE', 'IN', 'NOT IN', 'BETWEEN', 'NOT BETWEEN', 'EXISTS', 'NOT EXISTS'
values (false|\SearchWP\Option[])
Lorsque les options sont disponibles, ce sont les values correspondantes à choisir. (défaut : false)
Lorsque callable les arguments suivants sont passés :
$option (string) L'option choisie.
$search (string) Chaîne de recherche lors de la recherche.
$include (string) options à utiliser comme limite lors du retour.
application (array|callable)
L'application de cette \SearchWP\Rule. Retourne soit une instruction SQL préparée qui s'applique, soit un array d'IDs d'\SearchWP\Entry qui satisfont la \SearchWP\Rule. (défaut : null)
Lorsque callable l'argument suivant (array avec les clés suivantes) est passé :
'option' (string) L'option choisie.
'value' (string) La valeur choisie.
'condition' (string) La condition choisie.

Méthodes

Lorsque vous travaillez avec \SearchWP\Rule, un certain nombre de méthodes sont à considérer.

get_name()
Obtenseur pour le nom.
get_label()
Getter pour le libellé.
get_options()
Accesseur pour les options.
get_conditions()
Accesseur pour les conditions.
get_values( $option = '', $search = false, array $include = [] )
Accesseur pour les valeurs.
get_application( array $settings )
Accesseur pour l'application.
get_settings()
Accesseur pour les paramètres (c'est-à-dire tels qu'ils sont considérés par un \SearchWP\Engine).

Créez dès aujourd'hui une meilleure expérience de recherche WordPress

Ne perdez plus jamais de visiteurs à cause de résultats de recherche inutiles. SearchWP rend la création de votre propre recherche WordPress intelligente rapide et facile.

Get SearchWP Now
Icône de moteurs de recherche multiples