Hooks.php

<?php

/**
 * @file
 * @ingroup Extensions
 * @license GPL-2.0-or-later
 */

class FormWizardHooks {

	/**
	 * Hook for BeforePageDisplay.
	 *
	 * Enables JavaScript.
	 *
	 * @param OutputPage &$out The OutputPage object.
	 * @param Skin &$skin Skin object that will be used to generate the page,
	 *  added in 1.13.
	 */
	public static function onBeforePageDisplay(
		OutputPage &$out,
		Skin &$skin
	) {
		$out->addModules( [
			'ext.formWizard'
		] );
	}

	public static function onParserSetup( &$parser ) {
		// Create a function hook associating the "formwizard" magic word with renderExample()
		$parser->setFunctionHook( 'formwizard', 'FormWizardHooks::showProjectButton' );
	}

	/**
	 * Converts an array of values in form [0] => "name=value" into a real
	 * associative array in form [name] => value. If no = is provided,
	 * true is assumed like this: [name] => true
	 *
	 * @param array $options
	 * @return array Parser function options
	 */
	public static function extractOptions( array $options ) {
		$results = [];

		foreach ( $options as $option ) {
			$pair = explode( '=', $option, 2 );
			if ( count( $pair ) === 2 ) {
				$name = trim( $pair[0] );
				$value = trim( $pair[1] );
				$results[$name] = $value;
			}
			if ( count( $pair ) === 1 ) {
				$name = trim( $pair[0] );
				$results[$name] = true;
			}
		}
		return $results;
	}

	/**
	 * Construct button from parser arguments.
	 *
	 * @param string $parser The parser name
	 * @return string Constructed button output
	 */
	public static function showProjectButton( $parser ) {
		$options = self::extractOptions( array_slice( func_get_args(), 1 ) );
		$setUpOptions = (object)$options;
		if ( isset( $setUpOptions->project ) &&
			isset( $setUpOptions->config ) &&
			isset( $setUpOptions->mode )
		) {
			$parser->getOutput()->addJsConfigVars( 'formWizardProject', $options[ 'project' ] );
			$parser->getOutput()->addJsConfigVars( 'formWizardConfig', $options[ 'config' ] );
			$parser->getOutput()->addJsConfigVars( 'formWizardPageMode', $options[ 'mode' ] );
			// The input parameters are wikitext with templates expanded.
			// The output should be wikitext too.
			$output = "<div id='mw-formwizard-init-form'>
						<span class='mw-ui-button mw-ui-progressive'
								id='mw-formwizard-launch'
								role='button'
								aria-disabled='false'>" . $options[ 'action' ] . "
						</span>" .
					"</div>";
		} else {
			$output = "<span class='error'>" .
					wfMessage( 'formwizard-parser-function-error' )->text() .
					"</span>";
		}
		$parser->getOutput()->preventClickjacking( true );
		return $output;
	}
}