Extension:BetaFeatures/ru

Расширение BetaFeatures позволяет другим расширениям MediaWiki регистрировать бета-возможности в списке пользовательских настроек на вики. Расширение использует существующую архитектуру пользовательских настроек и несколько служебных страниц для выполнения своей работы.

Установка


Использование новых приёмов в вашем расширении
Использование этого расширения для поддержки вашей бета-возможности это просто. Зарегистрируйте хук (hook) типа "" в вашем файле расширения — синтаксис практически идентичен хуку, но с небольшими изменениями для поддержки необходимого нам в этом случае типа настройки.

В :

В :

Затем вы можете использовать функцию, предоставленную BetaFeatures для удобства, чтобы проверить, включена ли эта бета-возможность.

Вы также можете использовать обычные проверки на настройки, но не проверяйте на истинные и ложные значения, а используйте значения из класса HTMLFeatureField.

Поскольку класс BetaFeatures должен присутствовать везде, вы можете использовать эту функцию для удобства в любом хуке, служебной странице или где-либо ещё. Но будьте готовы к возможным проблем с производительностью и кэшированием, которые вы можете создать такими изменениями.

If you want to also use your extension without BetaFeatures, you should also check for its existence, e.g.:

Конфигурация
The config variable can be used to limit which beta features are shown in preferences. By default it is empty, and all beta features are shown.

If it is used then in order for a beta feature to show up in the preferences it needs to be listed in the whitelist. This config variable accepts an array of strings. Each string should be the name of a beta feature as specified in the preference definition passed to. For example, in the code given above, the name of the beta feature is, so you would need to add that string to the  array in your wiki's configuration:



Расширенное использование
Хотите увидеть кое-что по-настоящему крутое?



Группы автоматического включения
В этом примере мы зарегистрируем функцию с "автоматическим включением": если участник её включит, и выйдут новые возможности, принадлежащие какой-либо конкретной группе, участник автоматически будет включён в пользователи этих возможностей.



Управление зависимостями
Затем мы можем на самом деле определить управление зависимостями для каждой возможности. Чтобы сделать это, мы сначала регистрируем название (name) хука, которое мы хотим использовать для этого, для «», затем мы регистрируем тип хука, который проверяет зависимости и возвращает true, если найдены, иначе возвращает false.

Вы можете злоупотреблять использовать эту возможность, чтобы выполнять отключение возможностей, отмеченных как зависимые, для каждой вики. Но это уже просто запредельное хакерство. Вам, скорее всего, не следует этого делать. Я слышу, как вы об этом подумываете вот прямо сейчас. Прекратите.



Фигня про базы данных
Определена таблица базы данных, которая используется BetaFeatures. Но вы можете оказаться в замешательстве, если попытаетесь использовать её локально.

Мы используем очередь заданий, чтобы выполнять обновление этой таблицы, когда кэш устаревает (TTL 30 минут). Если ваша вики настроена так, чтобы выполнять задания по каждому запросу, то будет выполнен один ооооооочень медленный запрос каждые 30 минут, а остальное будет относительно быстрым. Если вы настраиваете свою вики, чтобы она выполняла задания через cron, всё будет работать намного лучше.

