2006-07-03 11:07:00 +00:00
|
|
|
<?php
|
2010-08-22 14:31:05 +00:00
|
|
|
/**
|
|
|
|
|
* Parser functions provided by MediaWiki core
|
|
|
|
|
*
|
|
|
|
|
* @file
|
|
|
|
|
*/
|
2006-07-03 11:07:00 +00:00
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Various core parser functions, registered in Parser::firstCallInit()
|
WARNING: HUGE COMMIT
Doxygen documentation update:
* Changed alls @addtogroup to @ingroup. @addtogroup adds the comment to the group description, but doesn't add the file, class, function, ... to the group like @ingroup does. See for example http://svn.wikimedia.org/doc/group__SpecialPage.html where it's impossible to see related files, classes, ... that should belong to that group.
* Added @file to file description, it seems that it should be explicitely decalred for file descriptions, otherwise doxygen will think that the comment document the first class, variabled, function, ... that is in that file.
* Removed some empty comments
* Removed some ?>
Added following groups:
* ExternalStorage
* JobQueue
* MaintenanceLanguage
One more thing: there are still a lot of warnings when generating the doc.
2008-05-20 17:13:28 +00:00
|
|
|
* @ingroup Parser
|
2006-07-03 11:07:00 +00:00
|
|
|
*/
|
|
|
|
|
class CoreParserFunctions {
|
2011-02-08 23:18:13 +00:00
|
|
|
/**
|
|
|
|
|
* @param $parser Parser
|
|
|
|
|
* @return void
|
|
|
|
|
*/
|
2008-02-20 08:53:12 +00:00
|
|
|
static function register( $parser ) {
|
|
|
|
|
global $wgAllowDisplayTitle, $wgAllowSlowParserFunctions;
|
2008-04-14 07:45:50 +00:00
|
|
|
|
2008-02-20 08:53:12 +00:00
|
|
|
# Syntax for arguments (see self::setFunctionHook):
|
|
|
|
|
# "name for lookup in localized magic words array",
|
|
|
|
|
# function callback,
|
2010-03-18 11:42:26 +00:00
|
|
|
# optional SFH_NO_HASH to omit the hash from calls (e.g. {{int:...}}
|
2008-02-20 08:53:12 +00:00
|
|
|
# instead of {{#int:...}})
|
|
|
|
|
|
|
|
|
|
$parser->setFunctionHook( 'int', array( __CLASS__, 'intFunction' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'ns', array( __CLASS__, 'ns' ), SFH_NO_HASH );
|
2009-08-02 18:16:56 +00:00
|
|
|
$parser->setFunctionHook( 'nse', array( __CLASS__, 'nse' ), SFH_NO_HASH );
|
2008-02-20 08:53:12 +00:00
|
|
|
$parser->setFunctionHook( 'urlencode', array( __CLASS__, 'urlencode' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'lcfirst', array( __CLASS__, 'lcfirst' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'ucfirst', array( __CLASS__, 'ucfirst' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'lc', array( __CLASS__, 'lc' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'uc', array( __CLASS__, 'uc' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'localurl', array( __CLASS__, 'localurl' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'localurle', array( __CLASS__, 'localurle' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'fullurl', array( __CLASS__, 'fullurl' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'fullurle', array( __CLASS__, 'fullurle' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'formatnum', array( __CLASS__, 'formatnum' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'grammar', array( __CLASS__, 'grammar' ), SFH_NO_HASH );
|
2009-01-26 09:48:17 +00:00
|
|
|
$parser->setFunctionHook( 'gender', array( __CLASS__, 'gender' ), SFH_NO_HASH );
|
2008-02-20 08:53:12 +00:00
|
|
|
$parser->setFunctionHook( 'plural', array( __CLASS__, 'plural' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'numberofpages', array( __CLASS__, 'numberofpages' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'numberofusers', array( __CLASS__, 'numberofusers' ), SFH_NO_HASH );
|
2009-02-17 23:05:04 +00:00
|
|
|
$parser->setFunctionHook( 'numberofactiveusers', array( __CLASS__, 'numberofactiveusers' ), SFH_NO_HASH );
|
2008-02-20 08:53:12 +00:00
|
|
|
$parser->setFunctionHook( 'numberofarticles', array( __CLASS__, 'numberofarticles' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'numberoffiles', array( __CLASS__, 'numberoffiles' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'numberofadmins', array( __CLASS__, 'numberofadmins' ), SFH_NO_HASH );
|
2008-08-28 00:04:57 +00:00
|
|
|
$parser->setFunctionHook( 'numberingroup', array( __CLASS__, 'numberingroup' ), SFH_NO_HASH );
|
2008-02-20 08:53:12 +00:00
|
|
|
$parser->setFunctionHook( 'numberofedits', array( __CLASS__, 'numberofedits' ), SFH_NO_HASH );
|
2008-10-28 09:24:52 +00:00
|
|
|
$parser->setFunctionHook( 'numberofviews', array( __CLASS__, 'numberofviews' ), SFH_NO_HASH );
|
2008-02-20 08:53:12 +00:00
|
|
|
$parser->setFunctionHook( 'language', array( __CLASS__, 'language' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'padleft', array( __CLASS__, 'padleft' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'padright', array( __CLASS__, 'padright' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'anchorencode', array( __CLASS__, 'anchorencode' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'special', array( __CLASS__, 'special' ) );
|
|
|
|
|
$parser->setFunctionHook( 'defaultsort', array( __CLASS__, 'defaultsort' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'filepath', array( __CLASS__, 'filepath' ), SFH_NO_HASH );
|
2008-04-07 22:11:31 +00:00
|
|
|
$parser->setFunctionHook( 'pagesincategory', array( __CLASS__, 'pagesincategory' ), SFH_NO_HASH );
|
2008-04-18 15:01:04 +00:00
|
|
|
$parser->setFunctionHook( 'pagesize', array( __CLASS__, 'pagesize' ), SFH_NO_HASH );
|
2009-01-08 23:21:06 +00:00
|
|
|
$parser->setFunctionHook( 'protectionlevel', array( __CLASS__, 'protectionlevel' ), SFH_NO_HASH );
|
2009-03-04 18:59:28 +00:00
|
|
|
$parser->setFunctionHook( 'namespace', array( __CLASS__, 'mwnamespace' ), SFH_NO_HASH );
|
2009-01-31 01:35:18 +00:00
|
|
|
$parser->setFunctionHook( 'namespacee', array( __CLASS__, 'namespacee' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'talkspace', array( __CLASS__, 'talkspace' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'talkspacee', array( __CLASS__, 'talkspacee' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'subjectspace', array( __CLASS__, 'subjectspace' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'subjectspacee', array( __CLASS__, 'subjectspacee' ), SFH_NO_HASH );
|
2009-01-31 22:25:01 +00:00
|
|
|
$parser->setFunctionHook( 'pagename', array( __CLASS__, 'pagename' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'pagenamee', array( __CLASS__, 'pagenamee' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'fullpagename', array( __CLASS__, 'fullpagename' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'fullpagenamee', array( __CLASS__, 'fullpagenamee' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'basepagename', array( __CLASS__, 'basepagename' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'basepagenamee', array( __CLASS__, 'basepagenamee' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'subpagename', array( __CLASS__, 'subpagename' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'subpagenamee', array( __CLASS__, 'subpagenamee' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'talkpagename', array( __CLASS__, 'talkpagename' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'talkpagenamee', array( __CLASS__, 'talkpagenamee' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'subjectpagename', array( __CLASS__, 'subjectpagename' ), SFH_NO_HASH );
|
|
|
|
|
$parser->setFunctionHook( 'subjectpagenamee', array( __CLASS__, 'subjectpagenamee' ), SFH_NO_HASH );
|
2008-02-20 08:53:12 +00:00
|
|
|
$parser->setFunctionHook( 'tag', array( __CLASS__, 'tagObj' ), SFH_OBJECT_ARGS );
|
2010-02-11 14:57:43 +00:00
|
|
|
$parser->setFunctionHook( 'formatdate', array( __CLASS__, 'formatDate' ) );
|
2008-02-20 08:53:12 +00:00
|
|
|
|
|
|
|
|
if ( $wgAllowDisplayTitle ) {
|
|
|
|
|
$parser->setFunctionHook( 'displaytitle', array( __CLASS__, 'displaytitle' ), SFH_NO_HASH );
|
|
|
|
|
}
|
|
|
|
|
if ( $wgAllowSlowParserFunctions ) {
|
|
|
|
|
$parser->setFunctionHook( 'pagesinnamespace', array( __CLASS__, 'pagesinnamespace' ), SFH_NO_HASH );
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2011-02-19 01:02:56 +00:00
|
|
|
/**
|
|
|
|
|
* @param $parser Parser
|
|
|
|
|
* @param string $part1
|
|
|
|
|
* @return array
|
|
|
|
|
*/
|
2006-09-30 04:53:36 +00:00
|
|
|
static function intFunction( $parser, $part1 = '' /*, ... */ ) {
|
|
|
|
|
if ( strval( $part1 ) !== '' ) {
|
|
|
|
|
$args = array_slice( func_get_args(), 2 );
|
2011-02-04 16:52:26 +00:00
|
|
|
$message = wfMessage( $part1, $args )->inLanguage( $parser->getOptions()->getUserLang() )->plain();
|
2011-01-26 15:42:04 +00:00
|
|
|
$message = $parser->replaceVariables( $message ); // like MessageCache::transform()
|
2008-08-15 16:02:00 +00:00
|
|
|
return $message;
|
2006-09-30 04:53:36 +00:00
|
|
|
} else {
|
|
|
|
|
return array( 'found' => false );
|
|
|
|
|
}
|
|
|
|
|
}
|
2009-06-08 16:53:39 +00:00
|
|
|
|
2011-02-19 01:02:56 +00:00
|
|
|
/**
|
|
|
|
|
* @param $parser Parser
|
|
|
|
|
* @param $date
|
|
|
|
|
* @param null $defaultPref
|
|
|
|
|
* @return mixed|string
|
|
|
|
|
*/
|
2009-03-10 05:19:05 +00:00
|
|
|
static function formatDate( $parser, $date, $defaultPref = null ) {
|
2009-03-10 01:07:47 +00:00
|
|
|
$df = DateFormatter::getInstance();
|
2009-06-08 16:53:39 +00:00
|
|
|
|
2010-02-11 14:57:43 +00:00
|
|
|
$date = trim( $date );
|
2009-06-08 16:53:39 +00:00
|
|
|
|
2010-10-15 23:10:05 +00:00
|
|
|
$pref = $parser->getOptions()->getDateFormat();
|
2009-06-08 16:53:39 +00:00
|
|
|
|
2009-03-18 21:32:58 +00:00
|
|
|
// Specify a different default date format other than the the normal default
|
2009-06-08 16:53:39 +00:00
|
|
|
// iff the user has 'default' for their setting
|
2010-02-11 14:57:43 +00:00
|
|
|
if ( $pref == 'default' && $defaultPref )
|
2009-03-10 05:19:05 +00:00
|
|
|
$pref = $defaultPref;
|
2009-06-08 16:53:39 +00:00
|
|
|
|
2010-02-11 14:57:43 +00:00
|
|
|
$date = $df->reformat( $pref, $date, array( 'match-whole' ) );
|
2009-03-10 01:07:47 +00:00
|
|
|
return $date;
|
|
|
|
|
}
|
2009-06-03 14:51:08 +00:00
|
|
|
|
2006-07-03 11:07:00 +00:00
|
|
|
static function ns( $parser, $part1 = '' ) {
|
|
|
|
|
global $wgContLang;
|
|
|
|
|
if ( intval( $part1 ) || $part1 == "0" ) {
|
2008-10-09 00:56:26 +00:00
|
|
|
$index = intval( $part1 );
|
2006-07-03 11:07:00 +00:00
|
|
|
} else {
|
2008-10-09 00:56:26 +00:00
|
|
|
$index = $wgContLang->getNsIndex( str_replace( ' ', '_', $part1 ) );
|
2006-07-03 11:07:00 +00:00
|
|
|
}
|
2008-10-09 00:56:26 +00:00
|
|
|
if ( $index !== false ) {
|
|
|
|
|
return $wgContLang->getFormattedNsText( $index );
|
2006-07-03 11:07:00 +00:00
|
|
|
} else {
|
|
|
|
|
return array( 'found' => false );
|
|
|
|
|
}
|
|
|
|
|
}
|
2010-02-11 14:57:43 +00:00
|
|
|
|
2009-08-02 18:16:56 +00:00
|
|
|
static function nse( $parser, $part1 = '' ) {
|
|
|
|
|
return wfUrlencode( str_replace( ' ', '_', self::ns( $parser, $part1 ) ) );
|
|
|
|
|
}
|
2006-07-03 11:07:00 +00:00
|
|
|
|
2010-04-08 00:29:58 +00:00
|
|
|
/**
|
|
|
|
|
* urlencodes a string according to one of three patterns: (bug 22474)
|
|
|
|
|
*
|
|
|
|
|
* By default (for HTTP "query" strings), spaces are encoded as '+'.
|
|
|
|
|
* Or to encode a value for the HTTP "path", spaces are encoded as '%20'.
|
|
|
|
|
* For links to "wiki"s, or similar software, spaces are encoded as '_',
|
|
|
|
|
*
|
2010-06-09 14:57:59 +00:00
|
|
|
* @param $parser Parser object
|
2010-04-08 00:29:58 +00:00
|
|
|
* @param $s String: The text to encode.
|
|
|
|
|
* @param $arg String (optional): The type of encoding.
|
|
|
|
|
*/
|
|
|
|
|
static function urlencode( $parser, $s = '', $arg = null ) {
|
|
|
|
|
static $magicWords = null;
|
|
|
|
|
if ( is_null( $magicWords ) ) {
|
|
|
|
|
$magicWords = new MagicWordArray( array( 'url_path', 'url_query', 'url_wiki' ) );
|
|
|
|
|
}
|
|
|
|
|
switch( $magicWords->matchStartToEnd( $arg ) ) {
|
|
|
|
|
|
|
|
|
|
// Encode as though it's a wiki page, '_' for ' '.
|
|
|
|
|
case 'url_wiki':
|
|
|
|
|
return wfUrlencode( str_replace( ' ', '_', $s ) );
|
|
|
|
|
|
|
|
|
|
// Encode for an HTTP Path, '%20' for ' '.
|
|
|
|
|
case 'url_path':
|
|
|
|
|
return rawurlencode( $s );
|
|
|
|
|
|
|
|
|
|
// Encode for HTTP query, '+' for ' '.
|
|
|
|
|
case 'url_query':
|
|
|
|
|
default:
|
|
|
|
|
return urlencode( $s );
|
|
|
|
|
}
|
2006-07-03 11:07:00 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
static function lcfirst( $parser, $s = '' ) {
|
|
|
|
|
global $wgContLang;
|
|
|
|
|
return $wgContLang->lcfirst( $s );
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
static function ucfirst( $parser, $s = '' ) {
|
|
|
|
|
global $wgContLang;
|
|
|
|
|
return $wgContLang->ucfirst( $s );
|
|
|
|
|
}
|
|
|
|
|
|
2011-02-19 01:02:56 +00:00
|
|
|
/**
|
|
|
|
|
* @param $parser Parser
|
|
|
|
|
* @param string $s
|
|
|
|
|
* @return
|
|
|
|
|
*/
|
2006-07-03 11:07:00 +00:00
|
|
|
static function lc( $parser, $s = '' ) {
|
|
|
|
|
global $wgContLang;
|
2008-01-24 09:07:47 +00:00
|
|
|
if ( is_callable( array( $parser, 'markerSkipCallback' ) ) ) {
|
|
|
|
|
return $parser->markerSkipCallback( $s, array( $wgContLang, 'lc' ) );
|
|
|
|
|
} else {
|
|
|
|
|
return $wgContLang->lc( $s );
|
|
|
|
|
}
|
2006-07-03 11:07:00 +00:00
|
|
|
}
|
|
|
|
|
|
2011-02-19 01:02:56 +00:00
|
|
|
/**
|
|
|
|
|
* @param $parser Parser
|
|
|
|
|
* @param string $s
|
|
|
|
|
* @return
|
|
|
|
|
*/
|
2006-07-03 11:07:00 +00:00
|
|
|
static function uc( $parser, $s = '' ) {
|
|
|
|
|
global $wgContLang;
|
2008-01-24 09:07:47 +00:00
|
|
|
if ( is_callable( array( $parser, 'markerSkipCallback' ) ) ) {
|
|
|
|
|
return $parser->markerSkipCallback( $s, array( $wgContLang, 'uc' ) );
|
|
|
|
|
} else {
|
|
|
|
|
return $wgContLang->uc( $s );
|
|
|
|
|
}
|
2006-07-03 11:07:00 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
static function localurl( $parser, $s = '', $arg = null ) { return self::urlFunction( 'getLocalURL', $s, $arg ); }
|
|
|
|
|
static function localurle( $parser, $s = '', $arg = null ) { return self::urlFunction( 'escapeLocalURL', $s, $arg ); }
|
|
|
|
|
static function fullurl( $parser, $s = '', $arg = null ) { return self::urlFunction( 'getFullURL', $s, $arg ); }
|
|
|
|
|
static function fullurle( $parser, $s = '', $arg = null ) { return self::urlFunction( 'escapeFullURL', $s, $arg ); }
|
|
|
|
|
|
|
|
|
|
static function urlFunction( $func, $s = '', $arg = null ) {
|
|
|
|
|
$title = Title::newFromText( $s );
|
|
|
|
|
# Due to order of execution of a lot of bits, the values might be encoded
|
|
|
|
|
# before arriving here; if that's true, then the title can't be created
|
|
|
|
|
# and the variable will fail. If we can't get a decent title from the first
|
|
|
|
|
# attempt, url-decode and try for a second.
|
|
|
|
|
if( is_null( $title ) )
|
2010-02-13 23:58:30 +00:00
|
|
|
$title = Title::newFromURL( urldecode( $s ) );
|
2008-12-23 21:12:43 +00:00
|
|
|
if( !is_null( $title ) ) {
|
|
|
|
|
# Convert NS_MEDIA -> NS_FILE
|
|
|
|
|
if( $title->getNamespace() == NS_MEDIA ) {
|
2009-05-24 08:29:10 +00:00
|
|
|
$title = Title::makeTitle( NS_FILE, $title->getDBkey() );
|
2008-12-23 21:12:43 +00:00
|
|
|
}
|
|
|
|
|
if( !is_null( $arg ) ) {
|
2006-07-03 11:07:00 +00:00
|
|
|
$text = $title->$func( $arg );
|
|
|
|
|
} else {
|
|
|
|
|
$text = $title->$func();
|
|
|
|
|
}
|
|
|
|
|
return $text;
|
|
|
|
|
} else {
|
|
|
|
|
return array( 'found' => false );
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2011-02-19 01:02:56 +00:00
|
|
|
/**
|
|
|
|
|
* @param $parser Parser
|
|
|
|
|
* @param string $num
|
|
|
|
|
* @param null $raw
|
|
|
|
|
* @return
|
|
|
|
|
*/
|
2008-03-15 10:39:56 +00:00
|
|
|
static function formatNum( $parser, $num = '', $raw = null) {
|
|
|
|
|
if ( self::israw( $raw ) ) {
|
|
|
|
|
return $parser->getFunctionLang()->parseFormattedNumber( $num );
|
|
|
|
|
} else {
|
|
|
|
|
return $parser->getFunctionLang()->formatNum( $num );
|
|
|
|
|
}
|
2006-07-03 11:07:00 +00:00
|
|
|
}
|
2007-01-13 12:58:33 +00:00
|
|
|
|
2011-02-19 01:02:56 +00:00
|
|
|
/**
|
|
|
|
|
* @param $parser Parser
|
|
|
|
|
* @param string $case
|
|
|
|
|
* @param string $word
|
|
|
|
|
* @return
|
|
|
|
|
*/
|
2006-11-29 05:45:03 +00:00
|
|
|
static function grammar( $parser, $case = '', $word = '' ) {
|
2006-07-03 11:07:00 +00:00
|
|
|
return $parser->getFunctionLang()->convertGrammar( $word, $case );
|
|
|
|
|
}
|
|
|
|
|
|
2011-02-19 01:02:56 +00:00
|
|
|
/**
|
|
|
|
|
* @param $parser Parser
|
|
|
|
|
* @param $user User
|
|
|
|
|
* @return
|
|
|
|
|
*/
|
2009-01-26 09:48:17 +00:00
|
|
|
static function gender( $parser, $user ) {
|
2009-06-03 06:28:19 +00:00
|
|
|
wfProfileIn( __METHOD__ );
|
2009-01-26 09:48:17 +00:00
|
|
|
$forms = array_slice( func_get_args(), 2);
|
|
|
|
|
|
|
|
|
|
// default
|
|
|
|
|
$gender = User::getDefaultOption( 'gender' );
|
2009-06-08 16:53:39 +00:00
|
|
|
|
2009-03-24 06:58:43 +00:00
|
|
|
// allow prefix.
|
|
|
|
|
$title = Title::newFromText( $user );
|
2009-06-08 16:53:39 +00:00
|
|
|
|
2010-02-11 14:57:43 +00:00
|
|
|
if ( is_object( $title ) && $title->getNamespace() == NS_USER )
|
2009-03-24 06:58:43 +00:00
|
|
|
$user = $title->getText();
|
2009-01-26 09:48:17 +00:00
|
|
|
|
2010-12-10 18:17:20 +00:00
|
|
|
// check parameter, or use the ParserOptions if in interface message
|
2009-01-26 09:48:17 +00:00
|
|
|
$user = User::newFromName( $user );
|
|
|
|
|
if ( $user ) {
|
|
|
|
|
$gender = $user->getOption( 'gender' );
|
2010-10-15 23:10:05 +00:00
|
|
|
} elseif ( $parser->getOptions()->getInterfaceMessage() ) {
|
2010-12-10 18:17:20 +00:00
|
|
|
$gender = $parser->getOptions()->getUser()->getOption( 'gender' );
|
2009-01-26 09:48:17 +00:00
|
|
|
}
|
2009-06-03 06:28:19 +00:00
|
|
|
$ret = $parser->getFunctionLang()->gender( $gender, $forms );
|
|
|
|
|
wfProfileOut( __METHOD__ );
|
|
|
|
|
return $ret;
|
2009-01-26 09:48:17 +00:00
|
|
|
}
|
2011-02-19 01:02:56 +00:00
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* @param $parser Parser
|
|
|
|
|
* @param string $text
|
|
|
|
|
* @return
|
|
|
|
|
*/
|
2010-02-11 14:57:43 +00:00
|
|
|
static function plural( $parser, $text = '' ) {
|
|
|
|
|
$forms = array_slice( func_get_args(), 2 );
|
2006-12-23 18:58:44 +00:00
|
|
|
$text = $parser->getFunctionLang()->parseFormattedNumber( $text );
|
2007-11-18 20:15:49 +00:00
|
|
|
return $parser->getFunctionLang()->convertPlural( $text, $forms );
|
2006-07-03 11:07:00 +00:00
|
|
|
}
|
|
|
|
|
|
2007-06-25 15:51:09 +00:00
|
|
|
/**
|
2008-04-18 14:19:00 +00:00
|
|
|
* Override the title of the page when viewed, provided we've been given a
|
|
|
|
|
* title which will normalise to the canonical title
|
2007-06-25 15:51:09 +00:00
|
|
|
*
|
2010-02-14 21:23:38 +00:00
|
|
|
* @param $parser Parser: parent parser
|
|
|
|
|
* @param $text String: desired title text
|
|
|
|
|
* @return String
|
2007-06-25 15:51:09 +00:00
|
|
|
*/
|
2009-04-19 23:48:50 +00:00
|
|
|
static function displaytitle( $parser, $text = '' ) {
|
|
|
|
|
global $wgRestrictDisplayTitle;
|
2009-06-08 16:53:39 +00:00
|
|
|
|
|
|
|
|
#parse a limited subset of wiki markup (just the single quote items)
|
|
|
|
|
$text = $parser->doQuotes( $text );
|
|
|
|
|
|
|
|
|
|
#remove stripped text (e.g. the UNIQ-QINU stuff) that was generated by tag extensions/whatever
|
|
|
|
|
$text = preg_replace( '/' . preg_quote( $parser->uniqPrefix(), '/' ) . '.*?'
|
|
|
|
|
. preg_quote( Parser::MARKER_SUFFIX, '/' ) . '/', '', $text );
|
|
|
|
|
|
2009-04-19 23:48:50 +00:00
|
|
|
#list of disallowed tags for DISPLAYTITLE
|
|
|
|
|
#these will be escaped even though they are allowed in normal wiki text
|
2009-06-08 16:53:39 +00:00
|
|
|
$bad = array( 'h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'div', 'blockquote', 'ol', 'ul', 'li', 'hr',
|
|
|
|
|
'table', 'tr', 'th', 'td', 'dl', 'dd', 'caption', 'p', 'ruby', 'rb', 'rt', 'rp', 'br' );
|
|
|
|
|
|
2009-04-09 05:15:43 +00:00
|
|
|
#only requested titles that normalize to the actual title are allowed through
|
2009-06-08 16:53:39 +00:00
|
|
|
#if $wgRestrictDisplayTitle is true (it is by default)
|
2009-04-09 05:15:43 +00:00
|
|
|
#mimic the escaping process that occurs in OutputPage::setPageTitle
|
2009-04-19 23:48:50 +00:00
|
|
|
$text = Sanitizer::normalizeCharReferences( Sanitizer::removeHTMLtags( $text, null, array(), array(), $bad ) );
|
|
|
|
|
$title = Title::newFromText( Sanitizer::stripAllTags( $text ) );
|
2008-12-31 16:49:38 +00:00
|
|
|
|
2009-04-19 23:48:50 +00:00
|
|
|
if( !$wgRestrictDisplayTitle ) {
|
|
|
|
|
$parser->mOutput->setDisplayTitle( $text );
|
|
|
|
|
} else {
|
|
|
|
|
if ( $title instanceof Title && $title->getFragment() == '' && $title->equals( $parser->mTitle ) ) {
|
|
|
|
|
$parser->mOutput->setDisplayTitle( $text );
|
|
|
|
|
}
|
2008-08-17 21:08:58 +00:00
|
|
|
}
|
2009-04-09 05:15:43 +00:00
|
|
|
|
2006-07-03 11:07:00 +00:00
|
|
|
return '';
|
|
|
|
|
}
|
|
|
|
|
|
2006-11-29 05:45:03 +00:00
|
|
|
static function isRaw( $param ) {
|
2006-07-03 11:07:00 +00:00
|
|
|
static $mwRaw;
|
|
|
|
|
if ( !$mwRaw ) {
|
2006-07-14 15:39:23 +00:00
|
|
|
$mwRaw =& MagicWord::get( 'rawsuffix' );
|
2006-07-03 11:07:00 +00:00
|
|
|
}
|
|
|
|
|
if ( is_null( $param ) ) {
|
|
|
|
|
return false;
|
|
|
|
|
} else {
|
|
|
|
|
return $mwRaw->match( $param );
|
|
|
|
|
}
|
|
|
|
|
}
|
2008-04-14 07:45:50 +00:00
|
|
|
|
2008-03-18 22:34:10 +00:00
|
|
|
static function formatRaw( $num, $raw ) {
|
|
|
|
|
if( self::isRaw( $raw ) ) {
|
|
|
|
|
return $num;
|
2006-07-03 13:55:52 +00:00
|
|
|
} else {
|
2006-07-03 11:07:00 +00:00
|
|
|
global $wgContLang;
|
2008-03-18 22:34:10 +00:00
|
|
|
return $wgContLang->formatNum( $num );
|
2006-07-03 11:07:00 +00:00
|
|
|
}
|
|
|
|
|
}
|
2008-03-18 22:34:10 +00:00
|
|
|
static function numberofpages( $parser, $raw = null ) {
|
|
|
|
|
return self::formatRaw( SiteStats::pages(), $raw );
|
|
|
|
|
}
|
|
|
|
|
static function numberofusers( $parser, $raw = null ) {
|
|
|
|
|
return self::formatRaw( SiteStats::users(), $raw );
|
|
|
|
|
}
|
2009-02-17 23:05:04 +00:00
|
|
|
static function numberofactiveusers( $parser, $raw = null ) {
|
2009-02-04 22:16:35 +00:00
|
|
|
return self::formatRaw( SiteStats::activeUsers(), $raw );
|
|
|
|
|
}
|
2008-03-18 22:34:10 +00:00
|
|
|
static function numberofarticles( $parser, $raw = null ) {
|
|
|
|
|
return self::formatRaw( SiteStats::articles(), $raw );
|
|
|
|
|
}
|
|
|
|
|
static function numberoffiles( $parser, $raw = null ) {
|
|
|
|
|
return self::formatRaw( SiteStats::images(), $raw );
|
|
|
|
|
}
|
|
|
|
|
static function numberofadmins( $parser, $raw = null ) {
|
2008-07-28 15:49:44 +00:00
|
|
|
return self::formatRaw( SiteStats::numberingroup('sysop'), $raw );
|
2008-03-18 22:34:10 +00:00
|
|
|
}
|
|
|
|
|
static function numberofedits( $parser, $raw = null ) {
|
|
|
|
|
return self::formatRaw( SiteStats::edits(), $raw );
|
|
|
|
|
}
|
2008-10-19 04:11:02 +00:00
|
|
|
static function numberofviews( $parser, $raw = null ) {
|
|
|
|
|
return self::formatRaw( SiteStats::views(), $raw );
|
|
|
|
|
}
|
2006-11-29 05:45:03 +00:00
|
|
|
static function pagesinnamespace( $parser, $namespace = 0, $raw = null ) {
|
2008-03-18 22:34:10 +00:00
|
|
|
return self::formatRaw( SiteStats::pagesInNs( intval( $namespace ) ), $raw );
|
2006-07-03 11:07:00 +00:00
|
|
|
}
|
2008-08-28 00:04:57 +00:00
|
|
|
static function numberingroup( $parser, $name = '', $raw = null) {
|
|
|
|
|
return self::formatRaw( SiteStats::numberingroup( strtolower( $name ) ), $raw );
|
2009-06-08 16:53:39 +00:00
|
|
|
}
|
|
|
|
|
|
2008-04-14 07:45:50 +00:00
|
|
|
|
2009-03-04 18:59:28 +00:00
|
|
|
/**
|
|
|
|
|
* Given a title, return the namespace name that would be given by the
|
|
|
|
|
* corresponding magic word
|
|
|
|
|
* Note: function name changed to "mwnamespace" rather than "namespace"
|
|
|
|
|
* to not break PHP 5.3
|
|
|
|
|
*/
|
|
|
|
|
static function mwnamespace( $parser, $title = null ) {
|
2009-01-31 01:35:18 +00:00
|
|
|
$t = Title::newFromText( $title );
|
2010-02-11 14:57:43 +00:00
|
|
|
if ( is_null( $t ) )
|
2009-01-31 01:35:18 +00:00
|
|
|
return '';
|
|
|
|
|
return str_replace( '_', ' ', $t->getNsText() );
|
|
|
|
|
}
|
|
|
|
|
static function namespacee( $parser, $title = null ) {
|
|
|
|
|
$t = Title::newFromText( $title );
|
2010-02-11 14:57:43 +00:00
|
|
|
if ( is_null( $t ) )
|
2009-01-31 01:35:18 +00:00
|
|
|
return '';
|
|
|
|
|
return wfUrlencode( $t->getNsText() );
|
|
|
|
|
}
|
|
|
|
|
static function talkspace( $parser, $title = null ) {
|
|
|
|
|
$t = Title::newFromText( $title );
|
2010-02-11 14:57:43 +00:00
|
|
|
if ( is_null( $t ) || !$t->canTalk() )
|
2009-01-31 01:35:18 +00:00
|
|
|
return '';
|
|
|
|
|
return str_replace( '_', ' ', $t->getTalkNsText() );
|
|
|
|
|
}
|
|
|
|
|
static function talkspacee( $parser, $title = null ) {
|
|
|
|
|
$t = Title::newFromText( $title );
|
2010-02-11 14:57:43 +00:00
|
|
|
if ( is_null( $t ) || !$t->canTalk() )
|
2009-01-31 01:35:18 +00:00
|
|
|
return '';
|
|
|
|
|
return wfUrlencode( $t->getTalkNsText() );
|
|
|
|
|
}
|
|
|
|
|
static function subjectspace( $parser, $title = null ) {
|
|
|
|
|
$t = Title::newFromText( $title );
|
2010-02-11 14:57:43 +00:00
|
|
|
if ( is_null( $t ) )
|
2009-01-31 01:35:18 +00:00
|
|
|
return '';
|
|
|
|
|
return str_replace( '_', ' ', $t->getSubjectNsText() );
|
|
|
|
|
}
|
|
|
|
|
static function subjectspacee( $parser, $title = null ) {
|
|
|
|
|
$t = Title::newFromText( $title );
|
2010-02-11 14:57:43 +00:00
|
|
|
if ( is_null( $t ) )
|
2009-01-31 01:35:18 +00:00
|
|
|
return '';
|
|
|
|
|
return wfUrlencode( $t->getSubjectNsText() );
|
|
|
|
|
}
|
2009-01-31 22:25:01 +00:00
|
|
|
/*
|
|
|
|
|
* Functions to get and normalize pagenames, corresponding to the magic words
|
|
|
|
|
* of the same names
|
|
|
|
|
*/
|
|
|
|
|
static function pagename( $parser, $title = null ) {
|
|
|
|
|
$t = Title::newFromText( $title );
|
2010-02-11 14:57:43 +00:00
|
|
|
if ( is_null( $t ) )
|
2009-01-31 22:25:01 +00:00
|
|
|
return '';
|
|
|
|
|
return wfEscapeWikiText( $t->getText() );
|
|
|
|
|
}
|
|
|
|
|
static function pagenamee( $parser, $title = null ) {
|
|
|
|
|
$t = Title::newFromText( $title );
|
2010-02-11 14:57:43 +00:00
|
|
|
if ( is_null( $t ) )
|
2009-01-31 22:25:01 +00:00
|
|
|
return '';
|
2011-01-18 20:15:50 +00:00
|
|
|
return wfEscapeWikiText( $t->getPartialURL() );
|
2009-01-31 22:25:01 +00:00
|
|
|
}
|
|
|
|
|
static function fullpagename( $parser, $title = null ) {
|
|
|
|
|
$t = Title::newFromText( $title );
|
2010-02-11 14:57:43 +00:00
|
|
|
if ( is_null( $t ) || !$t->canTalk() )
|
2009-01-31 22:25:01 +00:00
|
|
|
return '';
|
|
|
|
|
return wfEscapeWikiText( $t->getPrefixedText() );
|
|
|
|
|
}
|
|
|
|
|
static function fullpagenamee( $parser, $title = null ) {
|
|
|
|
|
$t = Title::newFromText( $title );
|
2010-02-11 14:57:43 +00:00
|
|
|
if ( is_null( $t ) || !$t->canTalk() )
|
2009-01-31 22:25:01 +00:00
|
|
|
return '';
|
2011-01-18 20:15:50 +00:00
|
|
|
return wfEscapeWikiText( $t->getPrefixedURL() );
|
2009-01-31 22:25:01 +00:00
|
|
|
}
|
|
|
|
|
static function subpagename( $parser, $title = null ) {
|
|
|
|
|
$t = Title::newFromText( $title );
|
2010-02-11 14:57:43 +00:00
|
|
|
if ( is_null( $t ) )
|
2009-01-31 22:25:01 +00:00
|
|
|
return '';
|
2011-01-18 20:15:50 +00:00
|
|
|
return wfEscapeWikiText( $t->getSubpageText() );
|
2009-01-31 22:25:01 +00:00
|
|
|
}
|
|
|
|
|
static function subpagenamee( $parser, $title = null ) {
|
|
|
|
|
$t = Title::newFromText( $title );
|
2010-02-11 14:57:43 +00:00
|
|
|
if ( is_null( $t ) )
|
2009-01-31 22:25:01 +00:00
|
|
|
return '';
|
2011-01-18 20:15:50 +00:00
|
|
|
return wfEscapeWikiText( $t->getSubpageUrlForm() );
|
2009-01-31 22:25:01 +00:00
|
|
|
}
|
|
|
|
|
static function basepagename( $parser, $title = null ) {
|
|
|
|
|
$t = Title::newFromText( $title );
|
2010-02-11 14:57:43 +00:00
|
|
|
if ( is_null( $t ) )
|
2009-01-31 22:25:01 +00:00
|
|
|
return '';
|
2011-01-18 20:15:50 +00:00
|
|
|
return wfEscapeWikiText( $t->getBaseText() );
|
2009-01-31 22:25:01 +00:00
|
|
|
}
|
|
|
|
|
static function basepagenamee( $parser, $title = null ) {
|
|
|
|
|
$t = Title::newFromText( $title );
|
2010-02-11 14:57:43 +00:00
|
|
|
if ( is_null( $t ) )
|
2009-01-31 22:25:01 +00:00
|
|
|
return '';
|
2011-01-18 20:15:50 +00:00
|
|
|
return wfEscapeWikiText( wfUrlEncode( str_replace( ' ', '_', $t->getBaseText() ) ) );
|
2009-06-08 16:53:39 +00:00
|
|
|
}
|
2009-01-31 22:25:01 +00:00
|
|
|
static function talkpagename( $parser, $title = null ) {
|
|
|
|
|
$t = Title::newFromText( $title );
|
2010-02-11 14:57:43 +00:00
|
|
|
if ( is_null( $t ) || !$t->canTalk() )
|
2009-01-31 22:25:01 +00:00
|
|
|
return '';
|
|
|
|
|
return wfEscapeWikiText( $t->getTalkPage()->getPrefixedText() );
|
|
|
|
|
}
|
|
|
|
|
static function talkpagenamee( $parser, $title = null ) {
|
|
|
|
|
$t = Title::newFromText( $title );
|
2010-02-11 14:57:43 +00:00
|
|
|
if ( is_null( $t ) || !$t->canTalk() )
|
2009-01-31 22:25:01 +00:00
|
|
|
return '';
|
2011-01-18 20:15:50 +00:00
|
|
|
return wfEscapeWikiText( $t->getTalkPage()->getPrefixedUrl() );
|
2009-01-31 22:25:01 +00:00
|
|
|
}
|
|
|
|
|
static function subjectpagename( $parser, $title = null ) {
|
|
|
|
|
$t = Title::newFromText( $title );
|
2010-02-11 14:57:43 +00:00
|
|
|
if ( is_null( $t ) )
|
2009-01-31 22:25:01 +00:00
|
|
|
return '';
|
|
|
|
|
return wfEscapeWikiText( $t->getSubjectPage()->getPrefixedText() );
|
|
|
|
|
}
|
|
|
|
|
static function subjectpagenamee( $parser, $title = null ) {
|
|
|
|
|
$t = Title::newFromText( $title );
|
2010-02-11 14:57:43 +00:00
|
|
|
if ( is_null( $t ) )
|
2009-01-31 22:25:01 +00:00
|
|
|
return '';
|
2011-01-18 20:15:50 +00:00
|
|
|
return wfEscapeWikiText( $t->getSubjectPage()->getPrefixedUrl() );
|
2009-01-31 22:25:01 +00:00
|
|
|
}
|
2009-06-08 16:53:39 +00:00
|
|
|
|
2008-04-18 14:19:00 +00:00
|
|
|
/**
|
|
|
|
|
* Return the number of pages in the given category, or 0 if it's nonexis-
|
|
|
|
|
* tent. This is an expensive parser function and can't be called too many
|
|
|
|
|
* times per page.
|
|
|
|
|
*/
|
2008-04-18 14:34:38 +00:00
|
|
|
static function pagesincategory( $parser, $name = '', $raw = null ) {
|
|
|
|
|
static $cache = array();
|
|
|
|
|
$category = Category::newFromName( $name );
|
|
|
|
|
|
2008-04-18 14:42:24 +00:00
|
|
|
if( !is_object( $category ) ) {
|
|
|
|
|
$cache[$name] = 0;
|
|
|
|
|
return self::formatRaw( 0, $raw );
|
|
|
|
|
}
|
|
|
|
|
|
2008-04-18 14:34:38 +00:00
|
|
|
# Normalize name for cache
|
|
|
|
|
$name = $category->getName();
|
|
|
|
|
|
|
|
|
|
$count = 0;
|
2008-04-18 14:42:24 +00:00
|
|
|
if( isset( $cache[$name] ) ) {
|
|
|
|
|
$count = $cache[$name];
|
|
|
|
|
} elseif( $parser->incrementExpensiveFunctionCount() ) {
|
2008-04-18 14:34:38 +00:00
|
|
|
$count = $cache[$name] = (int)$category->getPageCount();
|
2008-04-07 22:11:31 +00:00
|
|
|
}
|
2008-04-18 14:34:38 +00:00
|
|
|
return self::formatRaw( $count, $raw );
|
2008-04-07 22:11:31 +00:00
|
|
|
}
|
2006-07-03 11:07:00 +00:00
|
|
|
|
2008-04-18 15:01:04 +00:00
|
|
|
/**
|
|
|
|
|
* Return the size of the given page, or 0 if it's nonexistent. This is an
|
|
|
|
|
* expensive parser function and can't be called too many times per page.
|
|
|
|
|
*
|
2011-05-17 22:03:20 +00:00
|
|
|
* @todo FIXME: This doesn't work correctly on preview for getting the size
|
2010-02-14 21:23:38 +00:00
|
|
|
* of the current page.
|
2011-05-17 22:03:20 +00:00
|
|
|
* @todo FIXME: Title::getLength() documentation claims that it adds things
|
2010-02-14 21:23:38 +00:00
|
|
|
* to the link cache, so the local cache here should be unnecessary, but
|
|
|
|
|
* in fact calling getLength() repeatedly for the same $page does seem to
|
2008-04-18 15:01:04 +00:00
|
|
|
* run one query for each call?
|
2011-02-08 23:18:13 +00:00
|
|
|
* @param $parser Parser
|
2008-04-18 15:01:04 +00:00
|
|
|
*/
|
|
|
|
|
static function pagesize( $parser, $page = '', $raw = null ) {
|
|
|
|
|
static $cache = array();
|
2010-02-11 14:57:43 +00:00
|
|
|
$title = Title::newFromText( $page );
|
2008-04-18 15:01:04 +00:00
|
|
|
|
|
|
|
|
if( !is_object( $title ) ) {
|
|
|
|
|
$cache[$page] = 0;
|
|
|
|
|
return self::formatRaw( 0, $raw );
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
# Normalize name for cache
|
|
|
|
|
$page = $title->getPrefixedText();
|
|
|
|
|
|
|
|
|
|
$length = 0;
|
|
|
|
|
if( isset( $cache[$page] ) ) {
|
|
|
|
|
$length = $cache[$page];
|
|
|
|
|
} elseif( $parser->incrementExpensiveFunctionCount() ) {
|
2010-02-11 14:57:43 +00:00
|
|
|
$rev = Revision::newFromTitle( $title );
|
2008-12-11 01:33:27 +00:00
|
|
|
$id = $rev ? $rev->getPage() : 0;
|
|
|
|
|
$length = $cache[$page] = $rev ? $rev->getSize() : 0;
|
2009-06-08 16:53:39 +00:00
|
|
|
|
2008-04-18 15:01:04 +00:00
|
|
|
// Register dependency in templatelinks
|
2008-12-11 01:17:17 +00:00
|
|
|
$parser->mOutput->addTemplate( $title, $id, $rev ? $rev->getId() : 0 );
|
2009-06-08 16:53:39 +00:00
|
|
|
}
|
2008-04-18 15:01:04 +00:00
|
|
|
return self::formatRaw( $length, $raw );
|
|
|
|
|
}
|
2009-06-08 16:53:39 +00:00
|
|
|
|
2009-01-08 23:21:06 +00:00
|
|
|
/**
|
|
|
|
|
* Returns the requested protection level for the current page
|
|
|
|
|
*/
|
|
|
|
|
static function protectionlevel( $parser, $type = '' ) {
|
|
|
|
|
$restrictions = $parser->mTitle->getRestrictions( strtolower( $type ) );
|
|
|
|
|
# Title::getRestrictions returns an array, its possible it may have
|
|
|
|
|
# multiple values in the future
|
|
|
|
|
return implode( $restrictions, ',' );
|
|
|
|
|
}
|
2008-04-18 15:01:04 +00:00
|
|
|
|
2006-11-29 05:45:03 +00:00
|
|
|
static function language( $parser, $arg = '' ) {
|
2006-07-03 11:07:00 +00:00
|
|
|
global $wgContLang;
|
|
|
|
|
$lang = $wgContLang->getLanguageName( strtolower( $arg ) );
|
|
|
|
|
return $lang != '' ? $lang : $arg;
|
|
|
|
|
}
|
2007-01-13 12:58:33 +00:00
|
|
|
|
2009-01-14 17:54:52 +00:00
|
|
|
/**
|
|
|
|
|
* Unicode-safe str_pad with the restriction that $length is forced to be <= 500
|
|
|
|
|
*/
|
|
|
|
|
static function pad( $string, $length, $padding = '0', $direction = STR_PAD_RIGHT ) {
|
2009-06-08 16:53:39 +00:00
|
|
|
$lengthOfPadding = mb_strlen( $padding );
|
2009-01-14 17:54:52 +00:00
|
|
|
if ( $lengthOfPadding == 0 ) return $string;
|
2009-06-08 16:53:39 +00:00
|
|
|
|
2009-01-14 17:54:52 +00:00
|
|
|
# The remaining length to add counts down to 0 as padding is added
|
|
|
|
|
$length = min( $length, 500 ) - mb_strlen( $string );
|
2009-06-08 16:53:39 +00:00
|
|
|
# $finalPadding is just $padding repeated enough times so that
|
2009-01-14 17:54:52 +00:00
|
|
|
# mb_strlen( $string ) + mb_strlen( $finalPadding ) == $length
|
|
|
|
|
$finalPadding = '';
|
|
|
|
|
while ( $length > 0 ) {
|
|
|
|
|
# If $length < $lengthofPadding, truncate $padding so we get the
|
|
|
|
|
# exact length desired.
|
|
|
|
|
$finalPadding .= mb_substr( $padding, 0, $length );
|
|
|
|
|
$length -= $lengthOfPadding;
|
|
|
|
|
}
|
2009-06-08 16:53:39 +00:00
|
|
|
|
2009-01-14 17:54:52 +00:00
|
|
|
if ( $direction == STR_PAD_LEFT ) {
|
|
|
|
|
return $finalPadding . $string;
|
|
|
|
|
} else {
|
|
|
|
|
return $string . $finalPadding;
|
|
|
|
|
}
|
2006-08-21 11:07:58 +00:00
|
|
|
}
|
2007-01-13 12:58:33 +00:00
|
|
|
|
2009-01-14 17:54:52 +00:00
|
|
|
static function padleft( $parser, $string = '', $length = 0, $padding = '0' ) {
|
|
|
|
|
return self::pad( $string, $length, $padding, STR_PAD_LEFT );
|
2006-08-18 17:30:35 +00:00
|
|
|
}
|
2007-01-13 12:58:33 +00:00
|
|
|
|
2009-01-14 17:54:52 +00:00
|
|
|
static function padright( $parser, $string = '', $length = 0, $padding = '0' ) {
|
|
|
|
|
return self::pad( $string, $length, $padding );
|
2006-08-18 17:30:35 +00:00
|
|
|
}
|
2007-01-13 12:58:33 +00:00
|
|
|
|
2011-02-08 23:18:13 +00:00
|
|
|
/**
|
|
|
|
|
* @param $parser Parser
|
|
|
|
|
* @param $text
|
|
|
|
|
* @return string
|
|
|
|
|
*/
|
2006-11-29 05:45:03 +00:00
|
|
|
static function anchorencode( $parser, $text ) {
|
2010-06-20 23:43:39 +00:00
|
|
|
return substr( $parser->guessSectionNameFromWikiText( $text ), 1);
|
2006-08-30 07:51:44 +00:00
|
|
|
}
|
2006-10-31 13:25:47 +00:00
|
|
|
|
2006-11-29 05:45:03 +00:00
|
|
|
static function special( $parser, $text ) {
|
2011-04-17 11:31:11 +00:00
|
|
|
list( $page, $subpage ) = SpecialPageFactory::resolveAlias( $text );
|
2010-03-16 19:47:24 +00:00
|
|
|
if ( $page ) {
|
|
|
|
|
$title = SpecialPage::getTitleFor( $page, $subpage );
|
|
|
|
|
return $title;
|
2006-10-31 13:25:47 +00:00
|
|
|
} else {
|
|
|
|
|
return wfMsgForContent( 'nosuchspecialpage' );
|
|
|
|
|
}
|
|
|
|
|
}
|
2008-04-14 07:45:50 +00:00
|
|
|
|
2011-02-08 23:18:13 +00:00
|
|
|
/**
|
|
|
|
|
* @param $parser Parser
|
|
|
|
|
* @param $text
|
|
|
|
|
* @return string
|
|
|
|
|
*/
|
2006-12-29 10:39:35 +00:00
|
|
|
public static function defaultsort( $parser, $text ) {
|
|
|
|
|
$text = trim( $text );
|
2008-11-02 14:21:04 +00:00
|
|
|
if( strlen( $text ) == 0 )
|
|
|
|
|
return '';
|
|
|
|
|
$old = $parser->getCustomDefaultSort();
|
|
|
|
|
$parser->setDefaultSort( $text );
|
|
|
|
|
if( $old === false || $old == $text )
|
|
|
|
|
return '';
|
|
|
|
|
else
|
|
|
|
|
return( '<span class="error">' .
|
2010-08-12 13:23:28 +00:00
|
|
|
wfMsgForContent( 'duplicate-defaultsort',
|
2008-11-02 14:21:04 +00:00
|
|
|
htmlspecialchars( $old ),
|
|
|
|
|
htmlspecialchars( $text ) ) .
|
|
|
|
|
'</span>' );
|
2006-12-29 10:39:35 +00:00
|
|
|
}
|
2008-04-14 07:45:50 +00:00
|
|
|
|
2011-01-23 13:09:15 +00:00
|
|
|
// Usage {{filepath|300}}, {{filepath|nowiki}}, {{filepath|nowiki|300}} or {{filepath|300|nowiki}}
|
|
|
|
|
public static function filepath( $parser, $name='', $argA='', $argB='' ) {
|
2007-09-14 15:29:52 +00:00
|
|
|
$file = wfFindFile( $name );
|
2011-01-23 13:09:15 +00:00
|
|
|
$size = '';
|
2011-01-23 14:34:19 +00:00
|
|
|
$argA_int = intval( $argA );
|
|
|
|
|
$argB_int = intval( $argB );
|
2011-01-23 13:09:15 +00:00
|
|
|
|
2011-01-23 14:34:19 +00:00
|
|
|
if ( $argB_int > 0 ) {
|
2011-01-23 13:09:15 +00:00
|
|
|
// {{filepath: | option | size }}
|
2011-01-23 14:34:19 +00:00
|
|
|
$size = $argB_int;
|
2011-01-23 13:09:15 +00:00
|
|
|
$option = $argA;
|
|
|
|
|
|
2011-01-23 14:34:19 +00:00
|
|
|
} elseif ( $argA_int > 0 ) {
|
2011-01-23 13:09:15 +00:00
|
|
|
// {{filepath: | size [|option] }}
|
2011-01-23 14:34:19 +00:00
|
|
|
$size = $argA_int;
|
2011-01-23 13:09:15 +00:00
|
|
|
$option = $argB;
|
|
|
|
|
|
|
|
|
|
} else {
|
|
|
|
|
// {{filepath: [|option] }}
|
|
|
|
|
$option = $argA;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
if ( $file ) {
|
2011-04-23 19:38:53 +00:00
|
|
|
$url = $file->getFullUrl();
|
2011-01-23 13:09:15 +00:00
|
|
|
|
|
|
|
|
// If a size is requested...
|
|
|
|
|
if ( is_integer( $size ) ) {
|
|
|
|
|
$mto = $file->transform( array( 'width' => $size ) );
|
|
|
|
|
// ... and we can
|
|
|
|
|
if ( $mto && !$mto->isError() ) {
|
|
|
|
|
// ... change the URL to point to a thumbnail.
|
|
|
|
|
$url = wfExpandUrl( $mto->getUrl() );
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
if ( $option == 'nowiki' ) {
|
2008-12-23 11:59:37 +00:00
|
|
|
return array( $url, 'nowiki' => true );
|
2007-09-14 15:29:52 +00:00
|
|
|
}
|
|
|
|
|
return $url;
|
|
|
|
|
} else {
|
|
|
|
|
return '';
|
|
|
|
|
}
|
|
|
|
|
}
|
2008-01-09 07:13:54 +00:00
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Parser function to extension tag adaptor
|
|
|
|
|
*/
|
|
|
|
|
public static function tagObj( $parser, $frame, $args ) {
|
|
|
|
|
if ( !count( $args ) ) {
|
|
|
|
|
return '';
|
|
|
|
|
}
|
|
|
|
|
$tagName = strtolower( trim( $frame->expand( array_shift( $args ) ) ) );
|
2008-01-16 07:46:27 +00:00
|
|
|
|
|
|
|
|
if ( count( $args ) ) {
|
|
|
|
|
$inner = $frame->expand( array_shift( $args ) );
|
|
|
|
|
} else {
|
|
|
|
|
$inner = null;
|
|
|
|
|
}
|
|
|
|
|
|
2008-01-09 07:13:54 +00:00
|
|
|
$stripList = $parser->getStripList();
|
|
|
|
|
if ( !in_array( $tagName, $stripList ) ) {
|
2008-04-14 07:45:50 +00:00
|
|
|
return '<span class="error">' .
|
2010-08-12 13:23:28 +00:00
|
|
|
wfMsgForContent( 'unknown_extension_tag', $tagName ) .
|
2008-01-09 07:13:54 +00:00
|
|
|
'</span>';
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
$attributes = array();
|
|
|
|
|
foreach ( $args as $arg ) {
|
2008-01-26 05:40:51 +00:00
|
|
|
$bits = $arg->splitArg();
|
|
|
|
|
if ( strval( $bits['index'] ) === '' ) {
|
2008-10-06 07:37:37 +00:00
|
|
|
$name = trim( $frame->expand( $bits['name'], PPFrame::STRIP_COMMENTS ) );
|
2008-01-26 05:40:51 +00:00
|
|
|
$value = trim( $frame->expand( $bits['value'] ) );
|
2008-01-19 09:03:45 +00:00
|
|
|
if ( preg_match( '/^(?:["\'](.+)["\']|""|\'\')$/s', $value, $m ) ) {
|
|
|
|
|
$value = isset( $m[1] ) ? $m[1] : '';
|
2008-01-09 07:13:54 +00:00
|
|
|
}
|
2008-01-16 07:46:27 +00:00
|
|
|
$attributes[$name] = $value;
|
|
|
|
|
}
|
2008-01-09 07:13:54 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
$params = array(
|
|
|
|
|
'name' => $tagName,
|
|
|
|
|
'inner' => $inner,
|
2008-01-19 09:03:45 +00:00
|
|
|
'attributes' => $attributes,
|
|
|
|
|
'close' => "</$tagName>",
|
2008-01-09 07:13:54 +00:00
|
|
|
);
|
|
|
|
|
return $parser->extensionSubstitution( $params, $frame );
|
|
|
|
|
}
|
2006-07-03 11:07:00 +00:00
|
|
|
}
|