Gecko [ paroquia-rio-de-mouro.pt ]

Name	Size	Permission	Date
code-coverage	[ DIR ]	drwxr-xr-x	2016-11-28 20:20
databases	[ DIR ]	drwxr-xr-x	2016-11-28 20:20
html	[ DIR ]	drwxr-xr-x	2016-11-28 20:20
kss	[ DIR ]	drwxr-xr-x	2016-11-28 20:20
php-memcached	[ DIR ]	drwxr-xr-x	2016-11-28 20:20
uidesign	[ DIR ]	drwxr-xr-x	2016-11-28 20:20
.htaccess	197 B	-r--r--r--	2026-08-22 08:29
README	830 B	-rw-r--r--	2016-11-28 20:20
contenthandler.txt	10.8 KB	-rw-r--r--	2016-11-28 20:20
database.txt	8.62 KB	-rw-r--r--	2016-11-28 20:20
deferred.txt	1.63 KB	-rw-r--r--	2016-11-28 20:20
design.html	526 B	-rw-r--r--	2011-05-14 18:46
design.txt	5 KB	-rw-r--r--	2016-11-28 20:20
distributors.txt	11.28 KB	-rw-r--r--	2016-11-28 20:20
doxygen_first_page.php	480 B	-rw-r--r--	2016-11-28 20:20
export-0.1.xsd	2.28 KB	-rw-r--r--	2016-11-28 20:20
export-0.10.xsd	9.93 KB	-rw-r--r--	2016-11-28 20:20
export-0.2.xsd	3.05 KB	-rw-r--r--	2016-11-28 20:20
export-0.3.xsd	4.7 KB	-rw-r--r--	2016-11-28 20:20
export-0.4.xsd	7.21 KB	-rw-r--r--	2016-11-28 20:20
export-0.5.xsd	7.32 KB	-rw-r--r--	2016-11-28 20:20
export-0.6.xsd	7.59 KB	-rw-r--r--	2016-11-28 20:20
export-0.7.xsd	9.2 KB	-rw-r--r--	2016-11-28 20:20
export-0.8.xsd	9.73 KB	-rw-r--r--	2016-11-28 20:20
export-0.9.xsd	9.85 KB	-rw-r--r--	2016-11-28 20:20
export-demo.xml	6.22 KB	-rw-r--r--	2016-11-28 20:20
extension.schema.json	17.55 KB	-rw-r--r--	2016-11-28 20:20
globals.txt	2.14 KB	-rw-r--r--	2016-11-28 20:20
hooks.txt	164.15 KB	-rw-r--r--	2016-11-28 20:20
injection.txt	14.58 KB	-rw-r--r--	2016-11-28 20:20
language.txt	168 B	-rw-r--r--	2016-11-28 20:20
linkcache.txt	973 B	-rw-r--r--	2016-11-28 20:20
logger.txt	3.55 KB	-rw-r--r--	2016-11-28 20:20
magicword.txt	3.04 KB	-rw-r--r--	2016-11-28 20:20
maintenance.txt	1.65 KB	-rw-r--r--	2016-11-28 20:20
memcached.txt	7.73 KB	-rw-r--r--	2016-11-28 20:20
schema.txt	360 B	-rw-r--r--	2016-11-28 20:20
scripts.txt	2.21 KB	-rw-r--r--	2016-11-28 20:20
sitelist-1.0.xsd	2 KB	-rw-r--r--	2016-11-28 20:20
sitelist.txt	3.07 KB	-rw-r--r--	2016-11-28 20:20
sitescache.txt	1.02 KB	-rw-r--r--	2016-11-28 20:20
skin.txt	3.03 KB	-rw-r--r--	2016-11-28 20:20
title.txt	3.88 KB	-rw-r--r--	2016-11-28 20:20
upload.txt	135 B	-rw-r--r--	2009-08-26 19:05
wp-blog-header.php	2.74 KB	-r--r--r--	2026-08-22 08:29
wp-cron.php	2.74 KB	-rw-r--r--	2026-08-22 08:29

Rename

magicword.txt

Magic Words are some phrases used in the wikitext. They are used for two things:
* Variables (like {{PAGENAME}}, {{SERVER}}, ...): part of wikitext, that looks
  like templates but that don't accept any parameter.
* Parser functions (like {{fullurl:...}}, {{#special:...}}): behaves like 
  functions and accepts parameters.

The localized arrays keys are the internal name, and the values are an array, 
whose include their case-sensitivity and their alias forms. The first form 
defined is used by the program, for example, when moving a page and its old name
should include #REDIRECT.

They can be added in several arrays:
* By adding a file to $wgExtensionMessagesFiles and defining there $magicWords.
  This array is associative with the language code in the first dimension key
  and then a "normal" array of magic words.
* Localized arrays (languages/messages/LanguageXX.php) include their different 
  names to be used by the users.

To add a new variable, you should use the "MagicWordwgVariableIDs" hook to add
the internal name to the $magicWords array. You'll need to define the value of
the variable with the "ParserGetVariableValueSwitch" hook.

For example to add a new variable:

Create a file called ExtensionName.i18n.magic.php with the following contents:
----
<?php

$magicWords = array();

$magicWords['en'] = array(
	// Case sensitive.
	'mag_custom' => array( 1, 'CUSTOM' ),
);

$magicWords['es'] = array(
	'mag_custom' => array( 1, 'ADUANERO' ),
);
----

$wgExtensionMessagesFiles['ExtensionNameMagic'] = __DIR__ . '/ExtensionName.i18n.magic.php';
$wgHooks['MagicWordwgVariableIDs'][] = 'wfAddCustomMagicWordID';
$wgHooks['ParserGetVariableValueSwitch'][] = 'wfGetCustomMagicWordValue';

function wfAddCustomMagicWordID( &$magicWords ) {
	$magicWords[] = 'mag_custom';
	return true;
}

function wfGetCustomMagicWordValue( &$parser, &$varCache, &$index, &$ret ){
	if( $index == 'mag_custom' ){
		$ret = $varCache['mag_custom'] = "Custom value";
	}
	return true;
}

And to add a new parser function:

Create a file called ExtensionName.i18n.magic.php with the following contents:
----
<?php

$magicWords = array();

$magicWords['en'] = array(
	// Case insensitive.
	'mag_custom' => array( 0, 'custom' ),
);

$magicWords['es'] = array(
	'mag_custom' => array( 0, 'aduanero' ),
);
----

$wgExtensionMessagesFiles['ExtensionNameMagic'] = __DIR__ . '/ExtensionName.i18n.magic.php';
$wgHooks['ParserFirstCallInit'][] = 'wfRegisterCustomMagicWord';

function wfRegisterCustomMagicWord( &$parser ){
	$parser->setFunctionHook( 'mag_custom', 'wfGetCustomMagicWordValue' );
	return true;
}

function wfGetCustomMagicWordValue( &$parser, $var1, $var2 ){
	return "custom: var1 is $var1, var2 is $var2";
}

Note: the 'ParserFirstCallInit' hook is only available since 1.12. To work with
an older version, you'll need to use an extension function.

Online documentation (contains more informations):
Magic words: https://www.mediawiki.org/wiki/Manual:Magic_words
Variables: https://www.mediawiki.org/wiki/Manual:Variable
Parser functions: https://www.mediawiki.org/wiki/Manual:Parser_functions