mirror of
https://gerrit.wikimedia.org/r/mediawiki/extensions/Cite
synced 2024-12-01 01:56:20 +00:00
f94b400474
1. Most existing CiteTests can be unit tests. They run so much faster this way. 2. I modified some test cases to cover all trim() in the code. 3. The strict type hint in CiteHooks is removed because the parameter is not used. Having a hard type hint for what is effectively dead code makes the code more brittle for changes done outside of this codebase. Change-Id: I1bff1d6e02d9ef17d5e6b66aeec3ee42bba99cf4
314 lines
11 KiB
PHP
314 lines
11 KiB
PHP
<?php
|
|
/**
|
|
* @copyright 2011-2018 VisualEditor Team's Cite sub-team and others; see AUTHORS.txt
|
|
* @license MIT
|
|
*/
|
|
|
|
use MediaWiki\Linker\LinkTarget;
|
|
use MediaWiki\MediaWikiServices;
|
|
|
|
class CiteHooks {
|
|
|
|
/**
|
|
* Convert the content model of a message that is actually JSON to JSON. This
|
|
* only affects validation and UI when saving and editing, not loading the
|
|
* content.
|
|
*
|
|
* @param Title $title
|
|
* @param string &$model
|
|
*/
|
|
public static function onContentHandlerDefaultModelFor( LinkTarget $title, &$model ) {
|
|
if (
|
|
$title->inNamespace( NS_MEDIAWIKI ) &&
|
|
(
|
|
$title->getText() == 'Visualeditor-cite-tool-definition.json' ||
|
|
$title->getText() == 'Cite-tool-definition.json'
|
|
)
|
|
) {
|
|
$model = CONTENT_MODEL_JSON;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Conditionally register the unit testing module for the ext.cite.visualEditor module
|
|
* only if that module is loaded
|
|
*
|
|
* @param array[] &$testModules The array of registered test modules
|
|
* @param ResourceLoader $resourceLoader
|
|
*/
|
|
public static function onResourceLoaderTestModules(
|
|
array &$testModules,
|
|
ResourceLoader $resourceLoader
|
|
) {
|
|
$resourceModules = $resourceLoader->getConfig()->get( 'ResourceModules' );
|
|
|
|
if (
|
|
isset( $resourceModules[ 'ext.visualEditor.mediawiki' ] ) ||
|
|
$resourceLoader->isModuleRegistered( 'ext.visualEditor.mediawiki' )
|
|
) {
|
|
$testModules['qunit']['ext.cite.visualEditor.test'] = [
|
|
'scripts' => [
|
|
'modules/ve-cite/tests/ve.dm.citeExample.js',
|
|
'modules/ve-cite/tests/ve.dm.Converter.test.js',
|
|
'modules/ve-cite/tests/ve.dm.InternalList.test.js',
|
|
'modules/ve-cite/tests/ve.dm.Transaction.test.js',
|
|
'modules/ve-cite/tests/ve.ui.DiffElement.test.js',
|
|
'modules/ve-cite/tests/ve.ui.MWWikitextStringTransferHandler.test.js',
|
|
],
|
|
'dependencies' => [
|
|
'ext.cite.visualEditor',
|
|
'test.VisualEditor'
|
|
],
|
|
'localBasePath' => dirname( __DIR__ ),
|
|
'remoteExtPath' => 'Cite',
|
|
];
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Conditionally register resource loader modules that depend on
|
|
* other MediaWiki extensions.
|
|
*
|
|
* @param ResourceLoader $resourceLoader
|
|
*/
|
|
public static function onResourceLoaderRegisterModules( ResourceLoader $resourceLoader ) {
|
|
$dir = dirname( __DIR__ ) . DIRECTORY_SEPARATOR;
|
|
|
|
$uxEnhancementsModule = [
|
|
'localBasePath' => $dir . 'modules',
|
|
'remoteExtPath' => 'Cite/modules',
|
|
'scripts' => [
|
|
'ext.cite.a11y.js',
|
|
'ext.cite.highlighting.js',
|
|
],
|
|
'styles' => [
|
|
'ext.cite.a11y.css',
|
|
'ext.cite.highlighting.css',
|
|
],
|
|
'messages' => [
|
|
'cite_reference_link_prefix',
|
|
'cite_references_link_accessibility_label',
|
|
'cite_references_link_many_accessibility_label',
|
|
'cite_references_link_accessibility_back_label',
|
|
],
|
|
];
|
|
if ( ExtensionRegistry::getInstance()->isLoaded( 'EventLogging' ) ) {
|
|
// Temporary tracking for T231529
|
|
$uxEnhancementsModule['scripts'][] = 'ext.cite.tracking.js';
|
|
$uxEnhancementsModule['dependencies'][] = 'ext.eventLogging';
|
|
}
|
|
$resourceLoader->register( 'ext.cite.ux-enhancements', $uxEnhancementsModule );
|
|
|
|
if ( !ExtensionRegistry::getInstance()->isLoaded( 'VisualEditor' ) ) {
|
|
return;
|
|
}
|
|
|
|
$resourceLoader->register( "ext.cite.visualEditor.core", [
|
|
'localBasePath' => $dir . 'modules',
|
|
'remoteExtPath' => 'Cite/modules',
|
|
"scripts" => [
|
|
"ve-cite/ve.dm.MWReferenceModel.js",
|
|
"ve-cite/ve.dm.MWReferencesListNode.js",
|
|
"ve-cite/ve.dm.MWReferenceNode.js",
|
|
"ve-cite/ve.ce.MWReferencesListNode.js",
|
|
"ve-cite/ve.ce.MWReferenceNode.js",
|
|
"ve-cite/ve.ui.MWReferencesListCommand.js"
|
|
],
|
|
"styles" => [
|
|
"ve-cite/ve.ce.MWReferencesListNode.css",
|
|
"ve-cite/ve.ce.MWReferenceNode.css"
|
|
],
|
|
"dependencies" => [
|
|
"ext.visualEditor.mwcore"
|
|
],
|
|
"messages" => [
|
|
"cite-ve-referenceslist-isempty",
|
|
"cite-ve-referenceslist-isempty-default",
|
|
"cite-ve-referenceslist-missingref",
|
|
"cite-ve-referenceslist-missingref-in-list",
|
|
"cite-ve-referenceslist-missingreflist",
|
|
"visualeditor-internal-list-diff-default-group-name-mwreference",
|
|
"visualeditor-internal-list-diff-group-name-mwreference"
|
|
],
|
|
"targets" => [
|
|
"desktop",
|
|
"mobile"
|
|
]
|
|
] );
|
|
|
|
$resourceLoader->register( "ext.cite.visualEditor.data",
|
|
[ "class" => "CiteDataModule" ] );
|
|
|
|
$resourceLoader->register( "ext.cite.visualEditor", [
|
|
'localBasePath' => $dir . 'modules',
|
|
'remoteExtPath' => 'Cite/modules',
|
|
"scripts" => [
|
|
"ve-cite/ve.ui.MWReferenceGroupInputWidget.js",
|
|
"ve-cite/ve.ui.MWReferenceSearchWidget.js",
|
|
"ve-cite/ve.ui.MWReferenceResultWidget.js",
|
|
"ve-cite/ve.ui.MWUseExistingReferenceCommand.js",
|
|
"ve-cite/ve.ui.MWCitationDialog.js",
|
|
"ve-cite/ve.ui.MWReferencesListDialog.js",
|
|
"ve-cite/ve.ui.MWReferenceDialog.js",
|
|
"ve-cite/ve.ui.MWReferenceDialogTool.js",
|
|
"ve-cite/ve.ui.MWCitationDialogTool.js",
|
|
"ve-cite/ve.ui.MWReferenceContextItem.js",
|
|
"ve-cite/ve.ui.MWReferencesListContextItem.js",
|
|
"ve-cite/ve.ui.MWCitationContextItem.js",
|
|
"ve-cite/ve.ui.MWCitationAction.js",
|
|
"ve-cite/ve.ui.MWReference.init.js",
|
|
"ve-cite/ve.ui.MWCitationNeededContextItem.js",
|
|
],
|
|
"styles" => [
|
|
"ve-cite/ve.ui.MWReferenceDialog.css",
|
|
"ve-cite/ve.ui.MWReferenceContextItem.css",
|
|
"ve-cite/ve.ui.MWReferenceGroupInputWidget.css",
|
|
"ve-cite/ve.ui.MWReferenceResultWidget.css",
|
|
"ve-cite/ve.ui.MWReferenceSearchWidget.css"
|
|
],
|
|
"dependencies" => [
|
|
"oojs-ui.styles.icons-alerts",
|
|
"oojs-ui.styles.icons-editing-citation",
|
|
"oojs-ui.styles.icons-interactions",
|
|
"ext.cite.visualEditor.core",
|
|
"ext.cite.visualEditor.data",
|
|
"ext.cite.style",
|
|
"ext.cite.styles",
|
|
"ext.visualEditor.mwtransclusion",
|
|
"ext.visualEditor.mediawiki"
|
|
],
|
|
"messages" => [
|
|
"cite-ve-changedesc-ref-group-both",
|
|
"cite-ve-changedesc-ref-group-from",
|
|
"cite-ve-changedesc-ref-group-to",
|
|
"cite-ve-changedesc-reflist-group-both",
|
|
"cite-ve-changedesc-reflist-group-from",
|
|
"cite-ve-changedesc-reflist-group-to",
|
|
"cite-ve-changedesc-reflist-item-id",
|
|
"cite-ve-changedesc-reflist-responsive-set",
|
|
"cite-ve-changedesc-reflist-responsive-unset",
|
|
"cite-ve-citationneeded-button",
|
|
"cite-ve-citationneeded-description",
|
|
"cite-ve-citationneeded-title",
|
|
"cite-ve-dialog-reference-editing-reused",
|
|
"cite-ve-dialog-reference-editing-reused-long",
|
|
"cite-ve-dialog-reference-options-group-label",
|
|
"cite-ve-dialog-reference-options-group-placeholder",
|
|
"cite-ve-dialog-reference-options-name-label",
|
|
"cite-ve-dialog-reference-options-responsive-label",
|
|
"cite-ve-dialog-reference-options-section",
|
|
"cite-ve-dialog-reference-placeholder",
|
|
"cite-ve-dialog-reference-title",
|
|
"cite-ve-dialog-reference-useexisting-tool",
|
|
"cite-ve-dialog-referenceslist-contextitem-description-general",
|
|
"cite-ve-dialog-referenceslist-contextitem-description-named",
|
|
"cite-ve-dialog-referenceslist-title",
|
|
"cite-ve-dialogbutton-citation-educationpopup-title",
|
|
"cite-ve-dialogbutton-citation-educationpopup-text",
|
|
"cite-ve-dialogbutton-reference-full-label",
|
|
"cite-ve-dialogbutton-reference-tooltip",
|
|
"cite-ve-dialogbutton-reference-title",
|
|
"cite-ve-dialogbutton-referenceslist-tooltip",
|
|
"cite-ve-reference-input-placeholder",
|
|
"cite-ve-toolbar-group-label",
|
|
"cite-ve-othergroup-item"
|
|
],
|
|
"targets" => [
|
|
"desktop",
|
|
"mobile"
|
|
]
|
|
] );
|
|
}
|
|
|
|
/**
|
|
* Callback for LinksUpdate hook
|
|
* Post-output processing of references property, for proper db storage
|
|
* Deferred to avoid performance overhead when outputting the page
|
|
*
|
|
* @param LinksUpdate $linksUpdate
|
|
*/
|
|
public static function onLinksUpdate( LinksUpdate $linksUpdate ) {
|
|
global $wgCiteStoreReferencesData, $wgCiteCacheRawReferencesOnParse;
|
|
if ( !$wgCiteStoreReferencesData ) {
|
|
return;
|
|
}
|
|
$refData = $linksUpdate->getParserOutput()->getExtensionData( Cite::EXT_DATA_KEY );
|
|
if ( $refData === null ) {
|
|
return;
|
|
}
|
|
if ( $wgCiteCacheRawReferencesOnParse ) {
|
|
// caching
|
|
$cache = MediaWikiServices::getInstance()->getMainWANObjectCache();
|
|
$articleID = $linksUpdate->getTitle()->getArticleID();
|
|
$key = $cache->makeKey( Cite::EXT_DATA_KEY, $articleID );
|
|
$cache->set( $key, $refData, Cite::CACHE_DURATION_ONPARSE );
|
|
}
|
|
// JSON encode
|
|
$ppValue = FormatJson::encode( $refData, false, FormatJson::ALL_OK );
|
|
// GZIP encode references data at maximum compression
|
|
$ppValue = gzencode( $ppValue, 9 );
|
|
// split the string in smaller parts that can fit into a db blob
|
|
$ppValues = str_split( $ppValue, Cite::MAX_STORAGE_LENGTH );
|
|
foreach ( $ppValues as $num => $ppValue ) {
|
|
$key = 'references-' . intval( $num + 1 );
|
|
$linksUpdate->mProperties[$key] = $ppValue;
|
|
}
|
|
$linksUpdate->getParserOutput()->setExtensionData( Cite::EXT_DATA_KEY, null );
|
|
}
|
|
|
|
/**
|
|
* Callback for LinksUpdateComplete hook
|
|
* If $wgCiteCacheRawReferencesOnParse is set to false, purges the cache
|
|
* when references are modified
|
|
*
|
|
* @param LinksUpdate $linksUpdate
|
|
*/
|
|
public static function onLinksUpdateComplete( LinksUpdate $linksUpdate ) {
|
|
global $wgCiteStoreReferencesData, $wgCiteCacheRawReferencesOnParse;
|
|
if ( !$wgCiteStoreReferencesData || $wgCiteCacheRawReferencesOnParse ) {
|
|
return;
|
|
}
|
|
// if we can, avoid clearing the cache when references were not changed
|
|
if ( method_exists( $linksUpdate, 'getAddedProperties' )
|
|
&& method_exists( $linksUpdate, 'getRemovedProperties' )
|
|
) {
|
|
$addedProps = $linksUpdate->getAddedProperties();
|
|
$removedProps = $linksUpdate->getRemovedProperties();
|
|
if ( !isset( $addedProps['references-1'] )
|
|
&& !isset( $removedProps['references-1'] )
|
|
) {
|
|
return;
|
|
}
|
|
}
|
|
$cache = MediaWikiServices::getInstance()->getMainWANObjectCache();
|
|
$articleID = $linksUpdate->getTitle()->getArticleID();
|
|
$key = $cache->makeKey( Cite::EXT_DATA_KEY, $articleID );
|
|
// delete with reduced hold off period (LinksUpdate uses a master connection)
|
|
$cache->delete( $key, WANObjectCache::MAX_COMMIT_DELAY );
|
|
}
|
|
|
|
/**
|
|
* Adds extra variables to the global config
|
|
* @param array &$vars
|
|
*/
|
|
public static function onResourceLoaderGetConfigVars( array &$vars ) {
|
|
$config = MediaWikiServices::getInstance()->getConfigFactory()->makeConfig( 'cite' );
|
|
$vars['wgCiteVisualEditorOtherGroup'] = $config->get( 'CiteVisualEditorOtherGroup' );
|
|
$vars['wgCiteResponsiveReferences'] = $config->get( 'CiteResponsiveReferences' );
|
|
}
|
|
|
|
/**
|
|
* Hook: APIQuerySiteInfoGeneralInfo
|
|
*
|
|
* Expose configs via action=query&meta=siteinfo
|
|
*
|
|
* @param ApiQuerySiteinfo $api
|
|
* @param array &$data
|
|
*/
|
|
public static function onAPIQuerySiteInfoGeneralInfo( $api, array &$data ) {
|
|
$config = MediaWikiServices::getInstance()->getConfigFactory()->makeConfig( 'cite' );
|
|
$data['citeresponsivereferences'] = $config->get( 'CiteResponsiveReferences' );
|
|
}
|
|
|
|
}
|