udm_add_search_limit
(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
Description
bool
udm_add_search_limit
( resource $agent, int $var, string $val )
udm_add_search_limit()
ajoute différentes limitations de recherche. Cette fonction retourne TRUE
en cas de succès, FALSE
en cas d'échec.
agent
- un identifiant d'Agent, obtenu après un appel à udm_alloc_agent()
.
var
- nom du paramètre de limitation.
val
- Valeur du paramètre suscité.
var
peut prendre les valeurs suivantes :
- 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://my.domain.__/catalog'
peut remplacer http://my.domain.ru/catalog
ou http://my.domain.ua/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 :
Exemple 1518.
<?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.