Manual:Hooks/EditPage::showEditForm:initial

EditPage::showEditForm:initial
Available from version 1.6.0 Called just before the preview and edit form are rendered
Define function:	public static function onEditPage::showEditForm:initial( $editPage, $output ) { ... }
Attach hook:	$wgHooks['EditPage::showEditForm:initial'][] = 'MyExtensionHooks::onEditPage::showEditForm:initial';
Called from:	EditPage.php

For more information about attaching hooks, see Manual:Hooks.
For examples of extensions using this hook, see Category:EditPage::showEditForm:initial extensions.

Details

• $editPage: the current [EditPage] object.
• $output: the [OutputPage object] (added in version 1.12.0)

Notes

You can do something like:

if( $editPage->formtype == 'preview' ) {
    // performing a preview.
}

to only take action on certain types of edits.

Inject HTML

There are many locations within EditPage::showEditForm:initial that allow a user to inject HTML. These hook locations are represented by member variables of the [EditPage] object.

$editPage->editFormPageTop
$editPage->editFormTextTop
$editPage->editFormTextBeforeContent
$editPage->editFormTextAfterWarn
$editPage->editFormTextAfterTools
$editPage->editFormTextBottom

To inject your HTML, append your HTML to one of the aforementioned member variables, e.g.

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

Some hook locations are inside forms; some not. Those inside the form allow you to inject HTML form elements.

• Inside form
  • editFormTextBeforeContent
  • editFormTextAfterWarn
  • editFormTextAfterTools
  • editFormTextBottom
• Outside form
  • editFormPageTop
  • editFormTextTop

Normally, we use EditPage::showEditForm:fields for form elements, but there may be some circumstances for which it is necessary to use the aforementioned hook locations.