Edit Review Improvements/New filters for edit review/How to implement a filter/fr



Produit et architecture
D'abord, il faut poser quelques questions au sujet du produit et de l'architecture :


 * But et effets du filtre - tenez compte de l'experience de l'utilisateur et des cas d'utilisation. Ensemble, cela va vous permettre de décider ce que le filtre doit faire, et vous donner la manière de le décrire.
 * Choisir un texte - vous aurez besoin d'une étiquette (label) et d'une description (description), qui seront placées comme indiqué sur l'image User registration. Ces deux chaînes doivent être concises. Si vous créez un nouveau groupe, vous aurez aussi besoin d'un titre de groupe (group title); vous pouvez aussi spécifier (facultatif) le texte What's This? (qu'est-ce ?) pour fournir davantage d'informations concernant le groupe.

Auditeur
Déclarez un auditeur qui va écouter sur l'accroche. Cela vous donnera accès à, une instance de ChangesListSpecialPage utilisée ci-dessous.

Groupe
D'abord, choisissez si vous voulez créer un ChangesListStringOptionsFilterGroup ou un ChangesListBooleanFilterGroup. est meilleur si vous avez beaucoup d'options, elles ne sont naturellement pas exprimées comme des filtres cachés initialement (hideanons - cachés et anonymes), et/ou leur couverture n'est pas totale (une couverture totale signifie que toutes les cases d'un groupe sont cochées et c'est la même chose que s'il n'y en avait aucune). est meilleur pour les filtres habituellement masqués (comme ), ou les filtres qui peuvent être exprimés simplement en utilisant ce concept.

Si vous créez un nouveau groupe, créez un objet pour cela. est un identifiant interne. Néanmoins, pour, il est aussi utilisé en tant que paramètre d'URL. Sinon (voir ci-dessus) :

ou :

Par ailleurs, vous devez ensuite enregistrer le groupe avec :

Vous pouvez facultativement inclure des informations pour la fenêtre popup What's this ? (, ,  , et   - voir l'image en vignette). A la place, utilisez ceci si vous devez accéder à un groupe existant (par exemple, défini par le noyau) :

Filtres
Indépendamment du fait que vous ayez créé un groupe, vous pouvez vouloir ajouter des filtres aux nouveaux groupes ou aux groupes existants.

Si tous les filtres appartiennent à un groupe que vous créez, vous devez mettre les définitions dans le paramètre  du constructeur du groupe; ce qui les classera pour vous. Pour ajouter des filtres à des groupes préexistants, suivez les intructions ci-dessous.

Il existe actuellement deux types de filtres, ChangesListBooleanFilter et ChangesListStringOptionsFilter. Chacun d'eux ne va uniquement dans le groupe correspondant à son type. 'name' est utilisé comme identificateur et il apparaît aussi dans l'URL. Utilisez :

ou :

Vous n'avez plus rien à faire, une fois que le filtre est construit.