Викиновости:Фильтр правок/Руководство

Руководство по созданию фильтров с предварительным тестированием.

• Читаем документацию mw:Extension:AbuseFilter/Rules format (англ.)
• Тестируем кусочки кода на странице Средства отладки

  К примеру, если нужен фильтр, реагирующий на слова «кролика», «кролику», пишем

  'кролика' rlike 'кролик[ау]'

  и нажимаем «опробовать». Если результат «1», то выражение верное, и позже в коде фильтра мы можем использовать что-то вроде

  lcase(added_lines) rlike 'кролик[ау]'

• Переходим на страницу Пакетное тестирование

  Здесь сверху вставляем нужный кусок кода, в поле «изменения сделаны участником» добавляем участника, который недавно (в своих последних 100 правках, сделанных не позже месяца назад) совершал действия, под которые пишется фильтр, и нажимаем кнопку «проверить».

  Смотрим на результаты и проверяем, что фильтр действительно поймал нужные действия.

  Если срабатываний нет, то включаем галочку «показывать изменения, не попадающие под фильтр», снова нажимаем «проверить», находим нужную правку и открываем (в новом окне браузера) ссылку «просмотреть», попадая на страницу «Просмотр отдельных изменений».

  Здесь можно изучить переменные сделанной правки и понять каким образом нужно изменить код фильтра для получения корректного срабатывания, при необходимости возвращаясь к странице «средства отладки» для проверки отдельных выражений.

  Если неясно, что именно не сработало, то можно поочерёдно оставлять в окне кода только нужное выражение и нажимать кнопку «проверить фильтр».

• Проверяем код на свежих правках

  Добавляем код на страницу пакетное тестирование, временно убрав условия, ограничивающие участников (вида 'autoconfirmed' in user_groups), и на этот раз оставив остальные поля пустыми

  Нажимаем кнопку «проверить» каждые несколько минут, таким образом тестируя фильтр на 100 последних правках в проекте.

  При нахождении ложных срабатываний дорабатываем код фильтра.

  Этот шаг в принципе необязателен, но помогает уменьшить количество последующих изменений фильтра.

• Создание фильтра

  Со страницы списка фильтров нажимаем «создать новый фильтр» и создаём пока бездействующий (без предупреждений или запретов) фильтр. В поле описания кратко описываем назначение фильтра и тот факт, что фильтр пока тестируется.

  После отсутствия ложных срабатываний в течение нескольких дней добавляем (по необходимости) нужное предупреждение и/ли запрет.

Для уменьшения времени, необходимого системе для проверки всех фильтров, каждый фильтр должен начинаться с более «лёгких» условий (проверка пространства, группы участника), которые отсеют многие правки, не переходя к более сложным (проверке добавленного текста и т.п.).