(PHP 4 >= 4.0.5, PHP 5 <= 5.0.5, PECL mnogosearch >= 1.0.0)
udm_add_search_limit — Ajoute différentes limitations de recherche
$agent
, int $var
, string $val
)udm_add_search_limit() ajoute différentes limitations de recherche.
agent
Un identifiant d'Agent, obtenu après un appel à udm_alloc_agent().
var
Nom du paramètre de limitation.
Les valeurs possibles pour var
sont :
UDM_LIMIT_URL
: définit les limitations sur les URL, pour
limiter les recherches à une partie de la base. Ce
paramètre supporte les jokers SQL "%" et "_" : "%" remplace
n'importe quel nombre de caractères, même zéro
caractères, et "_" remplace exactement un caractère.
Par exemple, http://www.example.___/catalog peut
remplacer http://www.example.com/catalog ou
http://www.example.net/catalog.
UDM_LIMIT_TAG
: définit les limitations par étiquettes.
Lors de l'indexation, vous pouvez assigner des étiquettes sur
différentes parties d'un site. Les étiquettes de
mnoGoSearch 3.1.x sont des lignes, qui peuvent contenir les jokers
"%" et "_" : "%" remplace n'importe quel nombre de caractères,
même zéro caractères, et "_" remplace exactement
un caractère. Par exemple, si vous avez les étiquettes
ABCD et ABCE, la limitation de recherche ABC_
limitera la recherche à ces deux étiquettes.
UDM_LIMIT_LANG
: définit les limitations par langue.
UDM_LIMIT_CAT
: définit les limitations par catégorie.
Les catégories sont similaires aux étiquettes, mais
elles peuvent être imbriquées. Vous pouvez donc placer
des catégories dans d'autres catégories. Vous devez
utiliser deux caractères pour chaque niveau. Vous pouvez
utiliser des nombres hexadécimaux allant de 0 à
F ou bien sûr une base de 36, allant de 0 à Z. Par
exemple la catégorie supérieure "Auto" vaut 01. Si elle
a une sous catégorie "Renault", cette dernière sera
repérée par 01 (catégorie mère) suivie de
01 (dans sa catégorie), ce qui donne "0101". Si "Auto" a une
autre sous-catégorie "Peugeot", cette dernière aura le
numéro 02, et sera identifiée par
0102. Si "Peugeot" a elle-même une autre
sous-catégorie, "Moteur", elle sera numéroté 01,
et identifiée uniquement par 010201. Si
vous voulez restreindre les recherches à cette
catégorie uniquement, passez cat=010201.
UDM_LIMIT_DATE
: définit les limitations par date de
modification du document.
Format de la valeur : une chaîne de caractères, dont le premier caractère est < ou >, puis une date au format unixtimestamp. Par exemple :
<?php
udm_add_search_limit($udm, UDM_LIMIT_DATE, "<908012006");
?>
Si > est utilisé, la recherche sera limitée aux documents dont la date de modification est plus grande que celle qui a été entrée. Avec <, c'est le contraire.
val
Définit la valeur du paramètre courant.
Cette fonction retourne TRUE
en cas de
succès ou FALSE
si une erreur survient.