Jump to content

Manual:Hooks/ParserSectionCreate

From mediawiki.org
ParserSectionCreate
Available from version 1.19.0 (r92506, CodeReview archive)
Removed in version 1.40.0 (Gerrit change 861504)
Called each time the parser creates a document section from wikitext.
Define function:
public static function onParserSectionCreate( $parser, $section, &$sectionContent, $showEditLinks ) { ... }
Attach hook: In extension.json:
{
	"Hooks": {
		"ParserSectionCreate": "MediaWiki\\Extension\\MyExtension\\Hooks::onParserSectionCreate"
	}
}
Called from: File(s): parser/Parser.php
Interface: ParserSectionCreateHook.php

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


Details

[edit]

Use this to apply per-section modifications to HTML (like wrapping the section in a DIV). Caveat: DIVs are valid wikitext, and a DIV can begin in one section and end in another. Make sure your code can handle that case gracefully.

  • $parser: the calling Parser instance.
  • $section: the section number, zero-based, but section 0 is usually empty.
  • &$sectionContent: ref to the content of the section. modify this.
  • $showEditLinks: boolean describing whether this section has an edit link.