Manual:Hooks/GetDifferenceEngine/cs

From Linux Web Expert

GetDifferenceEngine
<translate> Available from <tvar name=1><translate> version <tvar (Gerrit change 166143)</tvar></translate>
Umožňuje použít při generování rozdílů jinou utilitu, než jakou používá Extension:WikEdDiff.
<translate> Define function:</translate>
public static function onGetDifferenceEngine( $context, $old, $new, $refreshCache, $unhide, &$differenceEngine ) { ... }
<translate> Attach hook:</translate> <translate> In <tvar name=1>extension.json</tvar>:</translate>
{
	"Hooks": {
		"GetDifferenceEngine": "MediaWiki\\Extension\\MyExtension\\Hooks::onGetDifferenceEngine"
	}
}
<translate> Called from:</translate> <translate> File(s):</translate> content/ContentHandler.php
<translate> Interface:</translate> GetDifferenceEngineHook.php

<translate> For more information about attaching hooks, see <tvar name=1>Příručka:Háčky </tvar>.</translate>
<translate> For examples of extensions using this hook, see <tvar name=cat>Category:GetDifferenceEngine extensions/cs</tvar>.</translate>

Podrobnosti

Volá se v okamžiku, kdy se má pro vygenerování rozdílů použít jiná utilita. Pro validní objekt $differenceEngine vrací false, a pro výchozí srovnávací utilitu true.

  • $context: IContextSource context který se má použít k vygenerování rozdílového souboru (diffu)
  • $old: ID starší revize, vůči které se zobrazí rozdíly (diff)
  • $new: ID další revize, nebo některý z následujících řetězců: 'cur' (pro aktuální revizi), 'prev' (pro předchozí revizi) nebo 'next' (pro následující revizi)
  • $refreshCache: Pokud není tento parametr prázdný, tak se při zobrazení zaktualizuje i nakešovaná strána se zobrazením rozdílů.
  • $unhide: Pokud není tento parametr prázdný, tak se povolí i zobrazování rozdílů vůči obsahu smazaných revizí.
  • &$differenceEngine: parametr ovlivňuje zobrazení výstupu; pro vygenerování rozdílů lze totiž využít různé utility