확장기능:UserFunctions

미디어위키 확장 기능 설명서

UserFunctions 출시 상태: 안정
구현	파서 함수
설명	현재 사용자에게 동작하는 일련의 파서 함수 제공
만든 이	Algorithm, Toniher, Universal Omega, and others
최신 버전	2.8.1 (2022-07-20)
MediaWiki	1.35+
PHP	7.2+
데이터베이스 변경	아니오
Composer	mediawiki/user-functions
라이선스	GNU General Public License 2.0 or later
다운로드	확장 기능 다운로드 Git [?]: Git master 다운로드 저장소 보기 (Phabricator · GitHub) 커밋 기록 repository contributors (GitHub) 코드 리뷰
예제	sandbox.semantic-mediawiki.org
변수 $wgUFEnabledPersonalDataFunctions $wgUFAllowedNamespaces $wgUFEnableSpecialContexts
사용된 훅 ParserFirstCallInit ParserClearState
Quarterly downloads	23 (Ranked 117th)
UserFunctions 확장 기능 번역 (translatewiki.net에서 가능한 경우)

UserFunctions 확장기능은 현재 사용자에게 동작하는 일련의 동적인 파서 함수를 제공합니다.

사용법

By default, functions are only enabled in NS_MEDIAWIKI namespace, for enabling them in other namespaces, see the examples below.

If you are using these functions within your wiki's sidebar, you cannot set $wgEnableSidebarCache = true;.

Functions (always available)

The following four functions are always available for use:

• {{#ifanon:then|else}}

Tests whether the current user is anonymous.

• {{#ifblocked:then|else}}

Tests whether the current user is blocked.

• {{#ifsysop:then|else}}

Tests whether the current user is a sysop.

• {{#ifingroup:group|then|else}}

Tests whether the current user is a member of the group "group". You can check for multiple groups as well:

{{#ifingroup:group1, group2, group3|then|else}}

Functions (disabled by default)

The following five personal data functions are disabled by default (see #Installation for how to enable them):

The functions described below are called personal data functions. They can be used to leak some of your user's personal data like their email address and real name.

If unsure, do not activate personal data functions.

• {{#realname:alt}}

Returns the current user's real name. If the user is not logged in, this function returns the given alternate text or the user IP if no alternate is provided.

• {{#username:alt}}

Returns the current username. If the user is not logged in, this function returns the given alternate text or the user IP if no alternate is provided.

• {{#useremail:alt}}

Returns the current user's email address. If the user is not logged in, this function returns the given alternate text or the user IP if no alternate is provided.

• {{#nickname:alt}}

Returns the current user's nickname. If the user has no nickname, returns the username. If the user is not logged in, this function returns the given alternate text or the user IP if no alternate is provided.

• {{#ip:}}

Returns the current user's IP address.

설치

• 파일을 다운로드하고 UserFunctions 폴더를 extensions/ 디렉토리에 넣어 주세요.
  개발자와 코딩 기여자는 Git을 이용해 확장기능을 다운받는 것이 좋습니다.cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/UserFunctions
• 아래의 코드를 LocalSettings.php 코드의 마지막에 추가합니다.

  wfLoadExtension( 'UserFunctions' );
  

• If you want to use any of the following functions: #realname, #username, #useremail, #nickname or #ip, add the following just after that line:

  $wgUFEnabledPersonalDataFunctions = [
  	'ip',
  	'nickname',
  	'realname',
  	'useremail',
  	'username',
  ];
  

If you are using an older version of the extension, the functions were included in bulk via: $wgUFEnablePersonalDataFunctions = true;

• If you want to enable functions in other namespaces apart from NS_MEDIAWIKI (default), follow the model of some of the examples below.
•  완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.

이름공간별 허용 설정

By default, user functions only work in NS_MEDIAWIKI namespace.

Below there are some examples of allowing or disallowing the functions to work in other namespaces. The syntax is based on the one used with subpages.

// Enable user functions additionally in namespace "Main"
// Adds values to the existing array
$wgUFAllowedNamespaces[NS_MAIN] = true;

// Enable user functions in namespaces "Main" and "User", but not in namespace "MediaWiki"
// Replaces values in the existing array
$wgUFAllowedNamespaces = [
        NS_MAIN => true,
        NS_USER => true
];

// Enable user functions in namespaces with the indexes from 0 to 200
// Replaces values in the existing array
$wgUFAllowedNamespaces = array_fill( 0, 200, true );

More info on namespace numbering.

In other contexts (recognized as NS -1, but not always a Special Page), such as in Page Forms pages, check you have the following parameter enabled:

$wgUFEnableSpecialContexts = true;

The parameter above is enabled by default.

If you experience any problem with bots or maintenance scripts, turn it to false and report it to this talk page.

버전 역사

Authors: Algorithm and others

• Version 2.8.1 (2022년 7월 20일) Allow disabling/enabling specific personal data functions - Universal Omega

Prior to this, the $wgUFEnabledPersonalDataFunctions configuration variable was named $wgUFEnablePersonalDataFunctions, and setting it to true would enable all personal data functions, and was only able to enable/disable all of them or none of them.

• Version 2.8.0 (2021년 4월 18일) Convert to ExtensionRegistry and other code cleanups - Universal Omega
• Version 2.7.0 (2017년 7월 26일) Removed PHP i18n shim - Kghbln
• Version 2.6.1 (2014년 11월 15일) Provided syntax changes - Kghbln, Umherirrender
• Version 2.6.0 (2014년 9월 18일) Composer-compatible extension - Toniher
• Version 2.5.0 (2014년 4월 1일) Migrated to JSON i18n - Siebrand
• Version 2.4.3 (2014년 3월 16일) Accumulated fixes and code cleaning - Chad Uckelman
• Version 2.4.2 (2013년 4월 8일) Some code cleaning - Reedy
• Version 2.4.1 (2012년 7월 17일) Fixed problems with Sidebar (report Kghbln). Cleared PHP warnings in functions - Toniher
• Version 2.4 (2012년 6월 2일) Cleaned using current ParserFunctions models. Fix when editing Semantic Forms - Toniher
• Version 2.3 (2012년 5월 27일) fixed problems when using scripts and allowed multiple groups to be checked against in ifingroup. - Toniher
• Version 2.2 (2012년 1월 3일) added $wgUFAllowedNamespaces parameter. Users need to define in which allowed NS functions will work. - Toniher
• Version 2.1 (2011년 12월 21일) added $wgUFEnablePersonalDataFunctions parameter. Migrated $wgUser to ParserOptions equivalent - Toniher
• Version 2.0 (2011년 12월 13일) added i18n and compatibility with other parser function extensions - Toniher
• Version 1.5 (2011년 10월 30일) added ip - Kghbln
• Version 1.4 (2011년 9월 27일) added realname - Kghbln
• Version 1.3 (2010년 2월 13일) added useremail - Wikinaut
• Version 1.2 (2008년 7월 25일) added ifingroup - Louperivois
• Version 1.1 (2008년 6월 27일) added nickname - Lexw
• Version 1.0 (2006년 5월 21일) Algorithm

Issues and feature requests

• Please report them on the talk page.

Troubleshooting

Invalid magic word

If you are getting an error that looks like this Error: invalid magic word 'ifanon', then you should try rebuilding the localization cache. The functions within this extension will not load correctly without this extension's localization information within the cache.

같이 보기

• Extension:RightFunctions
• Extension:MyVariables