Расширение:Бета-воозможности
![]() Статус релиза: стабильно |
|
---|---|
![]() |
|
Реализация | Медиафайлы, Хук , База данных |
Описание | Позволяет другим расширениям добавить их бета-возможности в пользовательские настройки |
Автор(ы) | Mark Holmquist (MarkTraceurобсуждение) |
Последняя версия | 0.1 (Continous updates) |
Политика совместимости | Снэпшоты выходят вместе с MediaWiki. Мастер не имеет обратной совместимости. |
MediaWiki | 1.25+ |
PHP | 5.4+ |
Изменения в БД | Да |
Таблицы | betafeatures_user_counts |
Лицензия | GNU General Public License 2.0 или позднее |
Скачать | |
Пример | Special:Preferences#mw-prefsection-betafeatures |
Special |
|
|
|
Ежеквартальные загрузки | 61 (Ranked 86th) |
Использование общедоступными вики | 1,031 (Ranked 249th) |
Переведите расширение BetaFeatures, если оно доступно на translatewiki.net | |
Проблемы | Открытые задачи · Сообщить об ошибке |
Расширение BetaFeatures позволяет другим расширениям MediaWiki регистрировать бета-возможности в списке пользовательских настроек на вики. Расширение использует существующую архитектуру пользовательских настроек и несколько служебных страниц для выполнения своей работы.
Установка
- Скачайте и распакуйте файл(ы) в папку с названием
BetaFeatures
в вашей папкеextensions/
.
Вместо этого разработчикам и соавторам кода следует установить расширение из Git, используя:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/BetaFeatures - Добавьте следующий код в конце вашего файла LocalSettings.php :
wfLoadExtension( 'BetaFeatures' );
- Выполните скрипт обновления, который автоматически создаст необходимые таблицы, используемые расширением.
- Настройте, как вам требуется.
- Готово – Перейдите на страницу Special:Version на своей вики, чтобы удостовериться в том, что расширение успешно установлено.
Использование новых приёмов в вашем расширении
Использование этого расширения для поддержки вашей бета-возможности это просто. Зарегистрируйте хук (hook) типа "GetBetaFeaturePreferences
" в вашем файле расширения extension.json
— синтаксис практически идентичен хуку GetPreferences
, но с небольшими изменениями для поддержки необходимого нам в этом случае типа настройки.
В extension.json
:
"Hooks": {
"GetBetaFeaturePreferences": "MediaWiki\\Extension\\MyExtension\\Hooks::onGetBetaFeaturePreferences"
},
В MyExtension/includes/Hooks.php
:
namespace MediaWiki\Extension\MyExtension;
class Hooks {
public static function onGetBetaFeaturePreferences( User $user, array &$betaPrefs ) {
$extensionAssetsPath = MediaWikiServices::getInstance()
->getMainConfig()
->get( 'ExtensionAssetsPath' );
$betaPrefs['myextension-awesome-feature'] = [
// The first two are message keys
'label-message' => 'myextension-awesome-feature-message',
'desc-message' => 'myextension-awesome-feature-description',
// Paths to images that represents the feature.
// The image is usually different for ltr and rtl languages.
// Images for specific languages can also specified using the language code.
'screenshot' => array(
'ru' => "$extensionAssetsPath/MyExtension/images/screenshot-ru.png",
'ltr' => "$extensionAssetsPath/MyExtension/images/screenshot-ltr.png",
'rtl' => "$extensionAssetsPath/MyExtension/images/screenshot-rtl.png",
),
// Link to information on the feature - use subpages on mw.org, maybe?
'info-link' => 'https://www.mediawiki.org/wiki/Special:MyLanguage/Extension:MyExtension/MyFeature',
// Link to discussion about the feature - talk pages might work
'discussion-link' => 'https://www.mediawiki.org/wiki/Special:MyLanguage/Help_talk:Extension:MyExtension/MyFeature',
];
}
}
'label-message'
, 'desc-message'
, 'info-link'
и 'discussion-link'
. Убедитесь, что вы используете все из них!Затем вы можете использовать функцию, предоставленную BetaFeatures для удобства, чтобы проверить, включена ли эта бета-возможность.
// SpecialMyExtension.php
class SpecialMyExtension extends SpecialPage {
public function execute() {
if ( BetaFeatures::isFeatureEnabled( $this->getUser(), 'my-awesome-feature' ) ) {
// Implement the feature!
}
}
}
Вы также можете использовать обычные проверки на настройки, но не проверяйте на истинные и ложные значения, а используйте значения из класса HTMLFeatureField
.
// SpecialMyExtension.php
class SpecialMyExtension extends SpecialPage {
public function execute() {
if ( $this->getUser()->getOption( 'my-awesome-feature' ) === HTMLFeatureField::OPTION_ENABLED ) {
// Implement the feature!
}
}
}
Поскольку класс BetaFeatures
должен присутствовать везде, вы можете использовать эту функцию для удобства в любом хуке, служебной странице или где-либо ещё. Но будьте готовы к возможным проблем с производительностью и кэшированием, которые вы можете создать такими изменениями.
Если вы хотите также использовать ваше расширение «без» BetaFeatures, вам также следует проверить его существование, например:
if (
!ExtensionRegistry::getInstance()->isLoaded( 'BetaFeatures' )
|| \BetaFeatures::isFeatureEnabled( $user, 'my-awesome-feature' )
) {
// Implement the feature!
}
Конфигурация
Переменная конфигурации $wgBetaFeaturesWhitelist
может использоваться для ограничения бета-функций, отображаемых в настройках.
По умолчанию он пуст, и отображаются все бета-функции.
Если он используется, то для того, чтобы бета-функция отображалась в настройках, она должна быть указана в белом списке.
Эта переменная конфигурации принимает массив строк.
Каждая строка должна быть именем бета-функции, как указано в определении предпочтения, переданном в onGetBetaFeaturePreferences()
.
Например, в приведенном выше коде название бета-функции — myextension-awesome-feature
, поэтому вам нужно будет добавить эту строку в массив $wgBetaFeaturesWhitelist
в конфигурации вашей вики:
$wgBetaFeaturesWhitelist = [
'myextension-awesome-feature'
];
Расширенное использование
Хотите увидеть кое-что по-настоящему крутое?
Группы автоматического включения
В этом примере мы зарегистрируем функцию с "автоматическим включением": если участник её включит, и выйдут новые возможности, принадлежащие какой-либо конкретной группе, участник автоматически будет включён в пользователи этих возможностей.
// MyExtensionHooks.php
class MyExtensionHooks {
static function getPreferences( $user, &$prefs ) {
global $wgExtensionAssetsPath;
$prefs['my-awesome-feature-auto-enroll'] = array(
// The first two are message keys
'label-message' => 'beta-feature-autoenroll-message',
'desc-message' => 'beta-feature-autoenroll-description',
// Link to information on the feature - use subpages on mw.org, maybe?
'info-link' => 'https://wwww.mediawiki.org/wiki/Special:MyLanguage/MyFeature',
// Link to discussion about the feature - talk pages might work
'discussion-link' => 'https://www.mediawiki.org/wiki/Talk:MyFeature',
// Enable auto-enroll for this group
'auto-enrollment' => 'my-awesome-feature-group',
);
$prefs['my-awesome-feature'] = array(
// The first two are message keys
'label-message' => 'beta-feature-message',
'desc-message' => 'beta-feature-description',
// Paths to images that represents the feature.
// The image is usually different for ltr and rtl languages.
// Images for specific languages can also specified using the language code.
'screenshot' => array(
'ru' => "$wgExtensionAssetsPath/MyExtension/images/screenshot-ru.png",
'ltr' => "$wgExtensionAssetsPath/MyExtension/images/screenshot-ltr.png",
'rtl' => "$wgExtensionAssetsPath/MyExtension/images/screenshot-rtl.png",
),
// Link to information on the feature - use subpages on mw.org, maybe?
'info-link' => 'https://www.mediawiki.org/wiki/Special:MyLanguage/Extension:MyExtension/SomeFeature',
// Link to discussion about the feature - talk pages might work
'discussion-link' => 'https://www.mediawiki.org/wiki/Extension_talk:MyExtension/SomeFeature',
// Add feature to this group
'group' => 'my-awesome-feature-group',
);
}
}
Управление зависимостями
Затем мы можем на самом деле определить управление зависимостями для каждой возможности. Чтобы сделать это, мы сначала регистрируем название (name) хука, которое мы хотим использовать для этого, для «GetBetaFeatureDependencyHooks », затем мы регистрируем тип хука, который проверяет зависимости и возвращает true, если найдены, иначе возвращает false.
// MyExtension.php
$wgAutoloadClasses['MyExtensionHooks'] = __DIR__ . '/MyExtensionHooks.php';
Hooks::register( 'GetBetaFeaturePreferences', 'MyExtensionHooks::getPreferences' );
Hooks::register( 'GetBetaFeatureDependencyHooks', 'MyExtensionHooks::getDependencyCallbacks' );
Hooks::register( 'CheckDependenciesForMyExtensionFeature', 'MyExtensionHooks::checkDependencies' );
// MyExtensionHooks.php
class MyExtensionHooks {
static function getPreferences( $user, &$prefs ) {
global $wgExtensionAssetsPath;
$prefs['my-awesome-feature'] = array(
// The first two are message keys
'label-message' => 'beta-feature-message',
'desc-message' => 'beta-feature-description',
// Paths to images that represents the feature.
// The image is usually different for ltr and rtl languages.
// Images for specific languages can also specified using the language code.
'screenshot' => array(
'ru' => "$wgExtensionAssetsPath/MyExtension/images/screenshot-ru.png",
'ltr' => "$wgExtensionAssetsPath/MyExtension/images/screenshot-ltr.png",
'rtl' => "$wgExtensionAssetsPath/MyExtension/images/screenshot-rtl.png",
),
// Link to information on the feature - use subpages on mw.org, maybe?
'info-link' => 'https://www.mediawiki.org/wiki/Special:MyLanguage/Extension:MyExtension/SomeFeature',
// Link to discussion about the feature - talk pages might work
'discussion-link' => 'https://www.mediawiki.org/wiki/Extension_talk:MyExtension/SomeFeature',
// Mark as dependent on something
'dependent' => true,
);
}
static function getDependencyCallbacks( &$depHooks ) {
$depHooks['my-awesome-feature'] = 'CheckDependenciesForMyExtensionFeature';
return true;
}
static function checkDependencies() {
$dependenciesMet = false;
// Do some fancy checking and return the result
return $dependenciesMet;
}
}
Вы можете злоупотреблять использовать эту возможность, чтобы выполнять отключение возможностей, отмеченных как зависимые, для каждой вики. Но это уже просто запредельное хакерство. Вам, скорее всего, не следует этого делать. Я слышу, как вы об этом подумываете вот прямо сейчас. Прекратите.
Базы данных
Определена таблица базы данных (betafeatures_user_counts
), которая используется BetaFeatures. Но вы можете оказаться в замешательстве, если попытаетесь использовать её локально.
Мы используем очередь заданий, чтобы выполнять обновление этой таблицы, когда кэш устаревает (TTL 30 минут). Если ваша вики настроена так, чтобы выполнять задания по каждому запросу, то будет выполнен один ооооооочень медленный запрос каждые 30 минут, а остальное будет относительно быстрым. Если вы настраиваете свою вики, чтобы она выполняла задания через cron, всё будет работать намного лучше.
Troubleshootings
Usage counts
The usage counts might not reflect exactly the number of users having some beta features activated at this precise moment. These should be interpreted as approximate numbers.
This number is computed by a job, which could be delayed or long-running. In the past, there was also a 30-minutes cache on these figures.
Смотрите также
Это расширение используется в одном или нескольких проектах Викимедиа. Вероятно, это означает, что расширение стабильно и работает достаточно хорошо, чтобы использоваться такими сайтами с высоким трафиком. Найдите название этого расширения в файлах конфигурации Викимедиа CommonSettings.php и InitialiseSettings.php, чтобы узнать, где оно установлено. Полный список расширений, установленных на конкретной вики, можно увидеть на странице Special:Version wiki. |
Это расширение включено в следующие вики-фермы/хостинги и/или пакеты: Это не исчерпывающий список. Некоторые вики-фермы/хостинги и/или пакеты могут содержать это расширение, даже если они не перечислены здесь. Всегда сверяйтесь со своими вики-фермами/хостингами или комплектами/бандлами для подтверждения. |