wiki.techinc.nl/includes/diff/Hook/DifferenceEngineNewHeaderHook.php
daniel 2e57447c58 Document hook names in hook interfaces.
Bug: T258665
Change-Id: Ifddbf57f8aa2e3eb0d5845601376cbafa08ed407
2020-09-27 12:03:12 +02:00

43 lines
1.9 KiB
PHP

<?php
namespace MediaWiki\Diff\Hook;
use DifferenceEngine;
/**
* This is a hook handler interface, see docs/Hooks.md.
* Use the hook name "DifferenceEngineNewHeader" to register handlers implementing this interface.
*
* @stable to implement
* @ingroup Hooks
*/
interface DifferenceEngineNewHeaderHook {
/**
* Use this hook to change the $newHeader variable, which contains information about
* the new revision, such as the revision's author, whether the revision was marked
* as a minor edit or not, etc.
*
* @since 1.35
*
* @param DifferenceEngine $differenceEngine
* @param string &$newHeader String containing the various #mw-diff-otitle[1-5] divs, which
* include things like revision author info, revision comment, RevisionDelete link and more
* @param array $formattedRevisionTools Array containing revision tools, some of which may have
* been injected with the DiffRevisionTools hook
* @param string $nextlink String containing the link to the next revision (if any); also
* included in $newHeader
* @param string $rollback Rollback link to roll this revision back to the previous one, if any
* @param string $newminor String indicating if the new revision was marked as a minor edit
* @param bool $diffOnly Boolean parameter passed to DifferenceEngine#showDiffPage, indicating
* whether we should show just the diff; passed in as a query string parameter to
* the various URLs constructed here (i.e. $nextlink)
* @param string $rdel RevisionDelete link for the new revision, if the current user is allowed
* to use the RevisionDelete feature
* @param bool $unhide Boolean parameter indicating whether to show RevisionDeleted revisions
* @return bool|void True or no return value to continue or false to abort
*/
public function onDifferenceEngineNewHeader( $differenceEngine, &$newHeader,
$formattedRevisionTools, $nextlink, $rollback, $newminor, $diffOnly, $rdel,
$unhide
);
}