Manual:Hooks/EditPage::showEditForm:initial/cs

From Linux Web Expert

EditPage::showEditForm:initial
<translate> Available from <tvar name=1><translate> version <tvar </tvar></translate>
Volá se těsně před vykreslením náhledu a formuláře pro úpravy
<translate> Define function:</translate>
public static function onEditPage_showEditForm_initial( EditPage $editPage, OutputPage $output ) { ... }
<translate> Attach hook:</translate> <translate> In <tvar name=1>extension.json</tvar>:</translate>
{
	"Hooks": {
		"EditPage::showEditForm:initial": "MediaWiki\\Extension\\MyExtension\\Hooks::onEditPageshowEditForminitial"
	}
}
<translate> Called from:</translate> <translate> File(s):</translate> EditPage.php
<translate> Interface:</translate> EditPage__showEditForm_initialHook.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:EditPage::showEditForm:initial extensions/cs</tvar>.</translate>

Podrobnosti

  • $editPage: Aktuální objekt EditPage.
  • $output: Objekt OutputPage (přidaný ve verzi 1.20.0).

Poznámky

Můžete udělat něco jako:

if( $editPage->formtype == 'preview' ) {
    // provedení náhledu.
}

provádět akce pouze u určitých typů úprav.

Vložení HTML

V EditPage::showEditForm:initial je mnoho umístění, která uživateli umožňují vkládat HTML. Tato umístění háčků jsou reprezentována proměnnými objektu EditPage.(Všimněte si, že není jasné, jak jste schopni vložit text pomocí tohoto háčku před MW 1.9!)

$editPage->editFormPageTop                 // MW >= 1.9
$editPage->editFormTextTop                 // MW >= 1.9
$editPage->editFormTextBeforeContent       // MW >= 1.12
$editPage->editFormTextAfterWarn           // MW >= 1.9
$editPage->editFormTextAfterTools          // MW >= 1.9
$editPage->editFormTextBottom              // MW >= 1.9	

Chcete-li vložit svůj HTML, připojte svůj HTML k jedné z výše uvedených proměnných, např.

$editPage->editFormPageTop .= "<span>Hello World!</span>";

Některá umístění háčků jsou uvnitř formulářů. Některá ne. Ty uvnitř formuláře vám umožňují vkládat prvky formuláře HTML.

  • Vnitřní forma
    • editFormTextBeforeContent
    • editFormTextAfterWarn
    • editFormTextAfterTools
    • editFormTextBottom
  • Vnější forma
    • editFormPageTop
    • editFormTextTop

Normálně používáme EditPage::showEditForm:fields pro prvky formuláře, ale mohou existovat určité okolnosti, pro které je nutné použít výše uvedená umístění háčků.

Pouze ke čtení

V režimu pouze pro čtení existuje podobný EditPage::showReadOnlyForm:initial-háček