mirror of
https://gerrit.wikimedia.org/r/mediawiki/extensions/TemplateData
synced 2024-12-18 02:40:38 +00:00
001494f443
Effectively a no-op. This patch doesn't change what the code does. Tests are in place to prove this. As before, the tests are intentionally not moved but left in place. This is for later patches to clean up. Change-Id: If130e0d006a36d8c755288f8a4e4e9a4c42a6295
373 lines
12 KiB
PHP
373 lines
12 KiB
PHP
<?php
|
|
|
|
namespace MediaWiki\Extension\TemplateData;
|
|
|
|
use CommentStoreComment;
|
|
use EditPage;
|
|
use EventLogging;
|
|
use ExtensionRegistry;
|
|
use Html;
|
|
use MediaWiki\MediaWikiServices;
|
|
use MediaWiki\Revision\RenderedRevision;
|
|
use MediaWiki\Revision\RevisionRecord;
|
|
use MediaWiki\Revision\SlotRecord;
|
|
use MediaWiki\User\UserIdentity;
|
|
use OutputPage;
|
|
use Parser;
|
|
use ParserOutput;
|
|
use PPFrame;
|
|
use RequestContext;
|
|
use ResourceLoader;
|
|
use Status;
|
|
use Title;
|
|
use WikiPage;
|
|
|
|
/**
|
|
* Hooks for TemplateData extension
|
|
*
|
|
* @file
|
|
* @ingroup Extensions
|
|
*/
|
|
|
|
class Hooks {
|
|
|
|
/**
|
|
* @param EditPage $editPage
|
|
* @param OutputPage $out
|
|
*/
|
|
public static function onEditPageShowEditFormFields( EditPage $editPage, OutputPage $out ) {
|
|
// TODO: Remove when not needed any more, see T267926
|
|
if ( $out->getRequest()->getBool( 'TemplateDataGeneratorUsed' ) ) {
|
|
// Recreate the dynamically created field after the user clicked "preview"
|
|
$out->addHTML( Html::hidden( 'TemplateDataGeneratorUsed', true ) );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Register parser hooks
|
|
* @param Parser $parser
|
|
*/
|
|
public static function onParserFirstCallInit( Parser $parser ) {
|
|
$parser->setHook( 'templatedata', [ __CLASS__, 'render' ] );
|
|
}
|
|
|
|
/**
|
|
* Conditionally register the jquery.uls.data module, in case they've already been
|
|
* registered by the UniversalLanguageSelector extension or the VisualEditor extension.
|
|
*
|
|
* @param ResourceLoader &$resourceLoader
|
|
*/
|
|
public static function onResourceLoaderRegisterModules( ResourceLoader &$resourceLoader ) {
|
|
$resourceModules = $resourceLoader->getConfig()->get( 'ResourceModules' );
|
|
$name = 'jquery.uls.data';
|
|
if ( !isset( $resourceModules[$name] ) && !$resourceLoader->isModuleRegistered( $name ) ) {
|
|
$resourceLoader->register( [
|
|
'jquery.uls.data' => [
|
|
'localBasePath' => dirname( __DIR__ ),
|
|
'remoteExtPath' => 'TemplateData',
|
|
'scripts' => [
|
|
'lib/jquery.uls/src/jquery.uls.data.js',
|
|
'lib/jquery.uls/src/jquery.uls.data.utils.js',
|
|
],
|
|
'targets' => [ 'desktop', 'mobile' ],
|
|
]
|
|
] );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param RenderedRevision $renderedRevision
|
|
* @param UserIdentity $user
|
|
* @param CommentStoreComment $summary
|
|
* @param int $flags
|
|
* @param Status $hookStatus
|
|
* @return bool
|
|
*/
|
|
public static function onMultiContentSave(
|
|
RenderedRevision $renderedRevision, UserIdentity $user, CommentStoreComment $summary, $flags, Status $hookStatus
|
|
) {
|
|
$revisionRecord = $renderedRevision->getRevision();
|
|
$contentModel = $revisionRecord
|
|
->getContent( SlotRecord::MAIN )
|
|
->getModel();
|
|
|
|
if ( $contentModel !== CONTENT_MODEL_WIKITEXT ) {
|
|
return true;
|
|
}
|
|
|
|
// Revision hasn't been parsed yet, so parse to know if self::render got a
|
|
// valid tag (via inclusion and transclusion) and abort save if it didn't
|
|
$parserOutput = $renderedRevision->getRevisionParserOutput();
|
|
$templateDataStatus = self::getStatusFromParserOutput( $parserOutput );
|
|
if ( $templateDataStatus instanceof Status && !$templateDataStatus->isOK() ) {
|
|
// Abort edit, show error message from TemplateDataBlob::getStatus
|
|
$hookStatus->merge( $templateDataStatus );
|
|
return false;
|
|
}
|
|
|
|
// TODO: Remove when not needed any more, see T267926
|
|
self::logChangeEvent( $revisionRecord, $parserOutput->getPageProperty( 'templatedata' ), $user );
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* @param RevisionRecord $revisionRecord
|
|
* @param string|false $newPageProperty
|
|
* @param UserIdentity $user
|
|
*/
|
|
private static function logChangeEvent( RevisionRecord $revisionRecord, $newPageProperty, UserIdentity $user ) {
|
|
if ( !ExtensionRegistry::getInstance()->isLoaded( 'EventLogging' ) ) {
|
|
return;
|
|
}
|
|
|
|
$services = MediaWikiServices::getInstance();
|
|
$page = $revisionRecord->getPage();
|
|
$props = $services->getPageProps()->getProperties( $page, 'templatedata' );
|
|
|
|
$pageId = $page->getId();
|
|
// The JSON strings here are guaranteed to be normalized (and possibly compressed) the same
|
|
// way. No need to normalize them again for this comparison.
|
|
if ( $newPageProperty === ( $props[$pageId] ?? false ) ) {
|
|
return;
|
|
}
|
|
|
|
$generatorUsed = RequestContext::getMain()->getRequest()->getBool( 'TemplateDataGeneratorUsed' );
|
|
$userEditCount = MediaWikiServices::getInstance()->getUserEditTracker()->getUserEditCount( $user );
|
|
// Note: We know that irrelevant changes (e.g. whitespace changes) aren't logged here
|
|
EventLogging::logEvent(
|
|
'TemplateDataEditor',
|
|
-1,
|
|
[
|
|
// Note: The "Done" button is disabled unless something changed, which means it's
|
|
// very likely (but not guaranteed) the generator was used to make the changes
|
|
'action' => $generatorUsed ? 'save-tag-edit-generator-used' : 'save-tag-edit-no-generator',
|
|
'page_id' => $pageId,
|
|
'page_namespace' => $page->getNamespace(),
|
|
'page_title' => $page->getDBkey(),
|
|
'rev_id' => $revisionRecord->getId() ?? 0,
|
|
'user_edit_count' => $userEditCount ?? 0,
|
|
'user_id' => $user->getId(),
|
|
]
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Parser hook registering the GUI module only in edit pages.
|
|
*
|
|
* @param EditPage $editPage
|
|
* @param OutputPage $output
|
|
*/
|
|
public static function onEditPage( EditPage $editPage, OutputPage $output ) {
|
|
global $wgTemplateDataUseGUI;
|
|
if ( $wgTemplateDataUseGUI ) {
|
|
if ( $output->getTitle()->inNamespace( NS_TEMPLATE ) ) {
|
|
$output->addModules( 'ext.templateDataGenerator.editTemplatePage' );
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Include config when appropriate.
|
|
*
|
|
* @param array &$vars
|
|
* @param OutputPage $output
|
|
* @see https://www.mediawiki.org/wiki/Manual:Hooks/MakeGlobalVariablesScript
|
|
*/
|
|
public static function onMakeGlobalVariablesScript( array &$vars, OutputPage $output ) {
|
|
if ( $output->getTitle()->inNamespace( NS_TEMPLATE ) ) {
|
|
$vars['wgTemplateDataSuggestedValuesEditor'] =
|
|
$output->getConfig()->get( 'TemplateDataSuggestedValuesEditor' );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Parser hook for <templatedata>.
|
|
* If there is any JSON provided, render the template documentation on the page.
|
|
*
|
|
* @param string|null $input The content of the tag.
|
|
* @param array $args The attributes of the tag.
|
|
* @param Parser $parser Parser instance available to render
|
|
* wikitext into html, or parser methods.
|
|
* @param PPFrame $frame Can be used to see what template parameters ("{{{1}}}", etc.)
|
|
* this hook was used with.
|
|
*
|
|
* @return string HTML to insert in the page.
|
|
*/
|
|
public static function render( $input, $args, Parser $parser, $frame ) {
|
|
$ti = TemplateDataBlob::newFromJSON( wfGetDB( DB_REPLICA ), $input ?? '' );
|
|
|
|
$status = $ti->getStatus();
|
|
if ( !$status->isOK() ) {
|
|
self::setStatusToParserOutput( $parser->getOutput(), $status );
|
|
return Html::errorBox( $status->getHTML() );
|
|
}
|
|
|
|
// Store the blob as page property for retrieval by ApiTemplateData.
|
|
// But, don't store it if we're parsing a doc sub page, because:
|
|
// - The doc subpage should not appear in ApiTemplateData as a documented
|
|
// template itself, which is confusing to users (T54448).
|
|
// - The doc subpage should not appear at Special:PagesWithProp.
|
|
// - Storing the blob twice in the database is inefficient (T52512).
|
|
$title = $parser->getTitle();
|
|
$docPage = wfMessage( 'templatedata-doc-subpage' )->inContentLanguage();
|
|
if ( !$title->isSubpage() || $title->getSubpageText() !== $docPage->plain() ) {
|
|
$parser->getOutput()->setPageProperty( 'templatedata', $ti->getJSONForDatabase() );
|
|
}
|
|
|
|
$parser->getOutput()->addModuleStyles( [
|
|
'ext.templateData',
|
|
'ext.templateData.images',
|
|
'jquery.tablesorter.styles',
|
|
] );
|
|
$parser->getOutput()->addModules( [ 'jquery.tablesorter' ] );
|
|
$parser->getOutput()->setEnableOOUI( true );
|
|
|
|
$userLang = $parser->getOptions()->getUserLangObj();
|
|
|
|
// FIXME: this hard-codes default skin, but it is needed because
|
|
// ::getHtml() will need a theme singleton to be set.
|
|
OutputPage::setupOOUI( 'bogus', $userLang->getDir() );
|
|
|
|
$localizer = new TemplateDataMessageLocalizer( $userLang );
|
|
$formatter = new TemplateDataHtmlFormatter( $localizer, $userLang->getCode() );
|
|
return $formatter->getHtml( $ti );
|
|
}
|
|
|
|
/**
|
|
* Fetch templatedata for an array of titles.
|
|
*
|
|
* @todo Document this hook
|
|
*
|
|
* The following questions are yet to be resolved.
|
|
* (a) Should we extend functionality to looking up an array of titles instead of one?
|
|
* The signature allows for an array of titles to be passed in, but the
|
|
* current implementation is not optimized for the multiple-title use case.
|
|
* (b) Should this be a lookup service instead of this faux hook?
|
|
* This will be resolved separately.
|
|
*
|
|
* @param array $tplTitles
|
|
* @param \stdClass[] &$tplData
|
|
*/
|
|
public static function onParserFetchTemplateData( array $tplTitles, array &$tplData ): void {
|
|
$tplData = [];
|
|
|
|
$pageProps = MediaWikiServices::getInstance()->getPageProps();
|
|
|
|
// This inefficient implementation is currently tuned for
|
|
// Parsoid's use case where it requests info for exactly one title.
|
|
// For a real batch use case, this code will need an overhaul.
|
|
foreach ( $tplTitles as $tplTitle ) {
|
|
$title = Title::newFromText( $tplTitle );
|
|
if ( !$title ) {
|
|
// Invalid title
|
|
$tplData[$tplTitle] = null;
|
|
continue;
|
|
}
|
|
|
|
if ( $title->isRedirect() ) {
|
|
$title = ( new WikiPage( $title ) )->getRedirectTarget();
|
|
if ( !$title ) {
|
|
// Invalid redirecting title
|
|
$tplData[$tplTitle] = null;
|
|
continue;
|
|
}
|
|
}
|
|
|
|
if ( !$title->exists() ) {
|
|
$tplData[$tplTitle] = (object)[ "missing" => true ];
|
|
continue;
|
|
}
|
|
|
|
// FIXME: PageProps returns takes titles but returns by page id.
|
|
// This means we need to do our own look up and hope it matches.
|
|
// Spoiler, sometimes it won't. When that happens, the user won't
|
|
// get any templatedata-based interfaces for that template.
|
|
// The fallback is to not serve data for that template, which
|
|
// the clients have to support anyway, so the impact is minimal.
|
|
// It is also expected that such race conditions resolve themselves
|
|
// after a few seconds so the old "try again later" should cover this.
|
|
$pageId = $title->getArticleID();
|
|
$props = $pageProps->getProperties( $title, 'templatedata' );
|
|
if ( !isset( $props[$pageId] ) ) {
|
|
// No templatedata
|
|
$tplData[$tplTitle] = (object)[ "notemplatedata" => true ];
|
|
continue;
|
|
}
|
|
|
|
$tdb = TemplateDataBlob::newFromDatabase( wfGetDB( DB_REPLICA ), $props[$pageId] );
|
|
$status = $tdb->getStatus();
|
|
if ( !$status->isOK() ) {
|
|
// Invalid data. Parsoid has no use for the error.
|
|
$tplData[$tplTitle] = (object)[ "notemplatedata" => true ];
|
|
continue;
|
|
}
|
|
|
|
$tplData[$tplTitle] = $tdb->getData();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Write the status to ParserOutput object.
|
|
* @param ParserOutput $parserOutput
|
|
* @param Status $status
|
|
*/
|
|
public static function setStatusToParserOutput( ParserOutput $parserOutput, Status $status ) {
|
|
$parserOutput->setExtensionData( 'TemplateDataStatus',
|
|
self::jsonSerializeStatus( $status ) );
|
|
}
|
|
|
|
/**
|
|
* @param ParserOutput $parserOutput
|
|
* @return Status|null
|
|
*/
|
|
public static function getStatusFromParserOutput( ParserOutput $parserOutput ) {
|
|
$status = $parserOutput->getExtensionData( 'TemplateDataStatus' );
|
|
if ( is_array( $status ) ) {
|
|
return self::newStatusFromJson( $status );
|
|
}
|
|
return $status;
|
|
}
|
|
|
|
/**
|
|
* @param array $status contains StatusValue ok and errors fields (does not serialize value)
|
|
* @return Status
|
|
*/
|
|
public static function newStatusFromJson( array $status ): Status {
|
|
if ( $status['ok'] ) {
|
|
return Status::newGood();
|
|
} else {
|
|
$statusObj = new Status();
|
|
$errors = $status['errors'];
|
|
foreach ( $errors as $error ) {
|
|
$statusObj->fatal( $error['message'], ...$error['params'] );
|
|
}
|
|
$warnings = $status['warnings'];
|
|
foreach ( $warnings as $warning ) {
|
|
$statusObj->warning( $warning['message'], ...$warning['params'] );
|
|
}
|
|
return $statusObj;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param Status $status
|
|
* @return array contains StatusValue ok and errors fields (does not serialize value)
|
|
*/
|
|
public static function jsonSerializeStatus( Status $status ): array {
|
|
if ( $status->isOK() ) {
|
|
return [
|
|
'ok' => true
|
|
];
|
|
} else {
|
|
list( $errorsOnlyStatus, $warningsOnlyStatus ) = $status->splitByErrorType();
|
|
// note that non-scalar values are not supported in errors or warnings
|
|
return [
|
|
'ok' => false,
|
|
'errors' => $errorsOnlyStatus->getErrors(),
|
|
'warnings' => $warningsOnlyStatus->getErrors()
|
|
];
|
|
}
|
|
}
|
|
}
|