Extensión:GetUserName

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Extension:GetUserName and the translation is 33% complete.

Other languages:
Deutsch • ‎English • ‎Nederlands • ‎dansk • ‎español • ‎magyar • ‎polski • ‎sicilianu • ‎中文 • ‎日本語
MediaWiki extensions manual
OOjs UI icon advanced.svg
GetUserName
Release status: estable
Implementación Variable
Descripción Allows the current user's name to be put in a page
Autor(es) (Ejcaputotalk)
Última versión 1.0 (2010-07-10)
Licencia GNU General Public License 2.0
Descarga See the code section
Hooks que usa
ParserFirstCallInit
LanguageGetMagic
Translate the GetUserName extension if it is available at translatewiki.net
Verificar uso y versión de la matriz.
This extension IS maintained, it works even with the latest versions of MediaWiki (tested with 1.31). I find it to be a useful function, albeit extremely simple and not useful for large wikis, but if I'm the only one using it, or there are other extensions which do the same thing but better (e.g. MyVariables), I suppose that it makes sense to delete it.

The GetUserName extension allows to obtain the current user's name from wgUser and insert it on a page.

Uso

When {{#USERNAME:}} is found in the page, it will replace it with the current user name. I wrote this because I wanted to make a link where the users could create draft documents easily, with unique names, in their user namespace. I added this to my page:

Create a document "[[User:{{#USERNAME:}}/Draft-{{CURRENTTIMESTAMP}}]]"
This extension is not suitable for large wikis or long pages, because the cache is invalidated for pages using this extension (see Extension_talk:GetUserName page).

Instalación

  • Añade el siguiente código a tu LocalSettings.php (preferiblemente al final):
    require_once "$IP/extensions/GetUserName/GetUserName.php";
    
  • Yes Listo – Navega a Special:Version en tu wiki para verificar que la apariencia se haya instalado correctamente.

Código

GetUserName.php
<?php
if ( !defined( 'MEDIAWIKI' ) ) {
    die( 'This file is a MediaWiki extension and not a valid entry point' );
}
 
$wgExtensionCredits['parserhook'][] = array(
    'path' => __FILE__,
    'name' => 'GetUserName',
    'version' => '1.0',
    'url' => 'https://www.mediawiki.org/wiki/Extension:GetUserName',
    'author' => 'Ejcaputo',
    'description' => "Allows the current user's name to be put in a page"
);  

$wgHooks[ 'ParserFirstCallInit' ][] = "ExtGetUserName::setup";
$wgHooks[ 'LanguageGetMagic' ][]  = 'ExtGetUserName::languageGetMagic';

class ExtGetUserName {
    private static $parserFunctions = array(
        'USERNAME' => 'getUserName',
    );
 
    public static function setup( &$parser ) {
        // register each hook
        foreach( self::$parserFunctions as $hook => $function )
            $parser->setFunctionHook( $hook,
                array( __CLASS__, $function ), SFH_OBJECT_ARGS );
 
        return true;
    }
 
    public static function languageGetMagic( &$magicWords, $langCode ) {
        $magicWords[ 'USERNAME' ] = array( 0, 'USERNAME' ); 
        return true;
    }
 
    public static function getUserName( &$parser, $frame, $args ) {
        $parser->disableCache();
	global $wgUser;
        return trim( $wgUser->getName() );
    }
}


Véase también