mediawiki-extensions-Math/src/Hooks.php
Umherirrender fb29f08e74 Use HookHandlers for core hooks
The use of "HookHandlers" attribute in extension.json makes it possible
to inject services into hook handler classes in a future patch.

Bug: T263364
Change-Id: Id8d9d0dcc6bb6ab60c5df3074803d132393415e9
2023-08-16 01:12:17 +00:00

115 lines
3.8 KiB
PHP

<?php
/**
* MediaWiki math extension
*
* @copyright 2002-2015 various MediaWiki contributors
* @license GPL-2.0-or-later
*/
namespace MediaWiki\Extension\Math;
// phpcs:disable MediaWiki.NamingConventions.LowerCamelFunctionsName.FunctionName
use ConfigException;
use ExtensionRegistry;
use Maintenance;
use MediaWiki\Hook\MaintenanceRefreshLinksInitHook;
use MediaWiki\MediaWikiServices;
use MediaWiki\Settings\SettingsBuilder;
use MediaWiki\SpecialPage\Hook\SpecialPage_initListHook;
use RequestContext;
class Hooks implements
SpecialPage_initListHook,
MaintenanceRefreshLinksInitHook
{
/**
* Extension registration callback, used to apply dynamic defaults for configuration variables.
*/
public static function onConfig( array $extInfo, SettingsBuilder $settings ) {
$config = $settings->getConfig();
$fullRestbaseUrl = $config->get( 'MathFullRestbaseURL' );
$internalRestbaseURL = $config->get( 'MathInternalRestbaseURL' );
$useInternalRestbasePath = $config->get( 'MathUseInternalRestbasePath' );
$virtualRestConfig = $config->get( 'VirtualRestConfig' );
if ( !$fullRestbaseUrl ) {
if ( $config->has( 'VisualEditorFullRestbaseURL' ) ) {
$settings->warning( "MathFullRestbaseURL is falling back to using VisualEditorFullRestbaseURL. " .
"Please configure the Mathoid API URL explicitly." );
$fullRestbaseUrl = $config->get( 'VisualEditorFullRestbaseURL' );
$settings->overrideConfigValue( 'MathFullRestbaseURL', $fullRestbaseUrl );
} else {
throw new ConfigException(
'Math extension can not find Restbase URL. Please specify $wgMathFullRestbaseURL.'
);
}
}
if ( !$useInternalRestbasePath ) {
if ( $internalRestbaseURL ) {
$settings->warning( "The MathInternalRestbaseURL setting will be ignored " .
"because MathUseInternalRestbasePath is set to false." );
}
// Force the use of the external URL for internal calls as well.
$settings->overrideConfigValue( 'MathInternalRestbaseURL', $fullRestbaseUrl );
} elseif ( !$internalRestbaseURL ) {
if ( isset( $virtualRestConfig['modules']['restbase'] ) ) {
$settings->warning( "The MathInternalRestbaseURL is falling back to " .
"VirtualRestConfig. Please set MathInternalRestbaseURL explicitly." );
$restBaseUrl = $virtualRestConfig['modules']['restbase']['url'];
$restBaseUrl = rtrim( $restBaseUrl, '/' );
$restBaseDomain = $virtualRestConfig['modules']['restbase']['domain'] ?? 'localhost';
// Ensure the correct domain format: strip protocol, port,
// and trailing slash if present. This lets us use
// $wgCanonicalServer as a default value, which is very convenient.
// XXX: This was copied from RestbaseVirtualRESTService. Use UrlUtils::parse instead?
$restBaseDomain = preg_replace(
'/^((https?:)?\/\/)?([^\/:]+?)(:\d+)?\/?$/',
'$3',
$restBaseDomain
);
$internalRestbaseURL = "$restBaseUrl/$restBaseDomain/";
} else {
// Default to using the external URL for internal calls as well.
$internalRestbaseURL = $fullRestbaseUrl;
}
$settings->overrideConfigValue( 'MathInternalRestbaseURL', $internalRestbaseURL );
}
}
/**
* MaintenanceRefreshLinksInit handler; optimize settings for refreshLinks batch job.
*
* @param Maintenance $maint
*/
public function onMaintenanceRefreshLinksInit( $maint ) {
$user = RequestContext::getMain()->getUser();
// Don't parse LaTeX to improve performance
MediaWikiServices::getInstance()->getUserOptionsManager()
->setOption( $user, 'math', MathConfig::MODE_SOURCE );
}
/**
* Remove Special:MathWikibase if the Wikibase client extension isn't loaded
*
* @param array &$list
*/
public function onSpecialPage_initList( &$list ) {
if ( !ExtensionRegistry::getInstance()->isLoaded( 'WikibaseClient' ) ) {
unset( $list['MathWikibase'] );
}
}
}