La recherche de marks possède pas mal de paramètres. L'interprétation de tous ces paramètres mélangés ou pris individuellement (ticket #63) n'est pas évidente. J'ai mis les quelques remarques que j'avais pour l'instant, si vous n'êtes pas d'accord ou si vous avez d'autres remarques ...

Liste des paramètres de recherche :

• title : <string>

Recherche textuelle dans title (LIKE %...%).

• summary : <string>

Recherche textuelle dans summary (LIKE %...%).

• related : <string>

Recherche textuelle dans related (LIKE %...%).

• regexp : true

La recherche textuelle est remplacée par une recherche par regexp.

• private : <boolean>

Spécifie s'il on veut les marks privés.

• author : <string>

Recherche des marks du login spécifié.

• include_tags : array ( 'title' => <titre du tag>, 'status' => <'private' | 'public'>

Recherche les marks contenant exactement le(s) tag(s) spécifié(s) (contrairement à ce qui est dit dans le ticket #63).

• exclude_tags : array ( 'title' => <titre du tag>, 'status' => <'private' | 'public'>

Exclue les marks contenant exactement le(s) tag(s) spécifié(s).

• order_by : <'created | 'modified' | 'issued' | 'author'> (created par défaut)

Range le feed résultat.

• order_type : <'asc' | 'desc'> (desc par defaut)

Ordonne le feed résultat.

• last : <int>

Limite le nombre de réponses

• before : Date

renvoit les marks créés avant cette date.

• after : Date

Renvoit les marks créés après cette date.

Discussions

Tous les paramètres peuvent être présents ensembles : pas de restriction ou de paramètres qui s'annulent.

Paramètres de recherche

• recherche textuelle et de tags en même temps

?title=xml&include_tags=xml : doit renvoyer tous les marks contenant xml dans le titre ou possédant le tag xml

• author : exclusif

On ne doit récupérer que les marks de cet utilisateur

• exclude_tags : exclusif

On ne doit recevoir aucun mark contenant un des tags spécifiés (même s'il convient pour une recherche textuelle par exemple)

• befor, after : exclusif

Ils sont ajoutés à la requête avec un AND. On ne doit recevoir que les marks qui respectent cette condition

Ordre des résultats

Les paramètres order_by, order_type et last peuvent être présent sur n'importe quel type de requête. Pas de problème d'interprétation.