Index: trunk/phase3/RELEASE-NOTES =================================================================== --- trunk/phase3/RELEASE-NOTES (revision 19062) +++ trunk/phase3/RELEASE-NOTES (revision 19063) @@ -1,111 +1,113 @@ = MediaWiki release notes = Security reminder: MediaWiki does not require PHP's register_globals setting since version 1.2.0. If you have it on, turn it *off* if you can. == MediaWiki 1.10 == THIS IS NOT A RELEASE YET. MediaWiki is now using a "continuous integration" development model with quarterly snapshot releases. The latest development code is always kept "ready to run", and in fact runs our own sites on Wikipedia. Release branches will continue to receive security updates for about a year from first release, but nonessential bugfixes and feature development happen will be made on the development trunk and appear in the next quarterly release. Those wishing to use the latest code instead of a branch release can obtain it from source control: http://www.mediawiki.org/wiki/Download_from_SVN == Configuration changes == == Major new features == == Changes since 1.9 == * (bug 7292) Fix site statistics when moving pages in/out of content namespaces * (bug 6937) Introduce "statistics-footer" message, appended to Special:Statistics * (bug 8531) Correct local name of Lingála (patch by Raymond) * (bug 6638) List block flags in block log entries * New script maintenance/language/checkExtensioni18n.php used to check i18n progress in the extension repository. * Running maintenance/parserTests.php with '--record' option, will now automaticly tries to create its database tables. * Made the PLURAL: parser function return singular on -1 per default. * Fixed up the AjaxSearch * (bugs 5051, 5376) Tooltips and accesskeys no longer require JavaScript +* Added SkinTemplateOutputPageBeforeExec hook before SkinTemplate::outputPage() + starts page output (http://lists.wikimedia.org/pipermail/wikitech-l/2007-January/028554.html) == Languages updated == * Hebrew (he) == Compatibility == MediaWiki 1.10 requires PHP 5 (5.1 recommended). PHP 4 is no longer supported. PHP 5.0.x fails on 64-bit systems due to serious bugs with array processing: http://bugs.php.net/bug.php?id=34879 Upgrade affected systems to PHP 5.1 or higher. MySQL 3.23.x is no longer supported; some older hosts may need to upgrade. At this time we still recommend 4.0, but 4.1/5.0 will work fine in most cases. == Upgrading == Some minor database changes have been made since 1.7: * new fields and indexes on ipblocks * index change on recentchanges Several changes from 1.5 and 1.6 do require updates to be run on upgrade. To ensure that these tables are filled with data, run refreshLinks.php after the upgrade. If you are upgrading from MediaWiki 1.4.x or earlier, some major database changes are made, and there is a slightly higher chance that things could break. Don't forget to always back up your database before upgrading! See the file UPGRADE for more detailed upgrade instructions. === Caveats === Some output, particularly involving user-supplied inline HTML, may not produce 100% valid or well-formed XHTML output. Testers are welcome to set $wgMimeType = "application/xhtml+xml"; to test for remaining problem cases, but this is not recommended on live sites. (This must be set for MathML to display properly in Mozilla.) For notes on 1.5.x and older releases, see HISTORY. === Online documentation === Documentation for both end-users and site administrators is currently being built up on Meta-Wikipedia, and is covered under the GNU Free Documentation License: http://www.mediawiki.org/wiki/Documentation === Mailing list === A MediaWiki-l mailing list has been set up distinct from the Wikipedia wikitech-l list: http://lists.wikimedia.org/mailman/listinfo/mediawiki-l A low-traffic announcements-only list is also available: http://lists.wikimedia.org/mailman/listinfo/mediawiki-announce It's highly recommended that you sign up for one of these lists if you're going to run a public MediaWiki, so you can be notified of security fixes. === IRC help === There's usually someone online in #mediawiki on irc.freenode.net Index: trunk/phase3/docs/hooks.txt =================================================================== --- trunk/phase3/docs/hooks.txt (revision 19062) +++ trunk/phase3/docs/hooks.txt (revision 19063) @@ -1,533 +1,537 @@ hooks.txt This document describes how event hooks work in MediaWiki; how to add hooks for an event; and how to run hooks for an event. ==Glossary== event Something that happens with the wiki. For example: a user logs in. A wiki page is saved. A wiki page is deleted. Often there are two events associated with a single action: one before the code is run to make the event happen, and one after. Each event has a name, preferably in CamelCase. For example, 'UserLogin', 'ArticleSave', 'ArticleSaveComplete', 'ArticleDelete'. hook A clump of code and data that should be run when an event happens. This can be either a function and a chunk of data, or an object and a method. hook function The function part of a hook. ==Rationale== Hooks allow us to decouple optionally-run code from code that is run for everyone. It allows MediaWiki hackers, third-party developers and local administrators to define code that will be run at certain points in the mainline code, and to modify the data run by that mainline code. Hooks can keep mainline code simple, and make it easier to write extensions. Hooks are a principled alternative to local patches. Consider, for example, two options in MediaWiki. One reverses the order of a title before displaying the article; the other converts the title to all uppercase letters. Currently, in MediaWiki code, we would handle this as follows (note: not real code, here): function showAnArticle($article) { global $wgReverseTitle, $wgCapitalizeTitle; if ($wgReverseTitle) { wfReverseTitle($article); } if ($wgCapitalizeTitle) { wfCapitalizeTitle($article); } # code to actually show the article goes here } An extension writer, or a local admin, will often add custom code to the function -- with or without a global variable. For example, someone wanting email notification when an article is shown may add: function showAnArticle($article) { global $wgReverseTitle, $wgCapitalizeTitle; if ($wgReverseTitle) { wfReverseTitle($article); } if ($wgCapitalizeTitle) { wfCapitalizeTitle($article); } # code to actually show the article goes here if ($wgNotifyArticle) { wfNotifyArticleShow($article)); } } Using a hook-running strategy, we can avoid having all this option-specific stuff in our mainline code. Using hooks, the function becomes: function showAnArticle($article) { if (wfRunHooks('ArticleShow', array(&$article))) { # code to actually show the article goes here wfRunHooks('ArticleShowComplete', array(&$article)); } } We've cleaned up the code here by removing clumps of weird, infrequently used code and moving them off somewhere else. It's much easier for someone working with this code to see what's _really_ going on, and make changes or fix bugs. In addition, we can take all the code that deals with the little-used title-reversing options (say) and put it in one place. Instead of having little title-reversing if-blocks spread all over the codebase in showAnArticle, deleteAnArticle, exportArticle, etc., we can concentrate it all in an extension file: function reverseArticleTitle($article) { # ... } function reverseForExport($article) { # ... } The setup function for the extension just has to add its hook functions to the appropriate events: setupTitleReversingExtension() { global $wgHooks; $wgHooks['ArticleShow'][] = 'reverseArticleTitle'; $wgHooks['ArticleDelete'][] = 'reverseArticleTitle'; $wgHooks['ArticleExport'][] = 'reverseForExport'; } Having all this code related to the title-reversion option in one place means that it's easier to read and understand; you don't have to do a grep-find to see where the $wgReverseTitle variable is used, say. If the code is well enough isolated, it can even be excluded when not used -- making for some slight savings in memory and load-up performance at runtime. Admins who want to have all the reversed titles can add: require_once('extensions/ReverseTitle.php'); ...to their LocalSettings.php file; those of us who don't want or need it can just leave it out. The extensions don't even have to be shipped with MediaWiki; they could be provided by a third-party developer or written by the admin him/herself. ==Writing hooks== A hook is a chunk of code run at some particular event. It consists of: * a function with some optional accompanying data, or * an object with a method and some optional accompanying data. Hooks are registered by adding them to the global $wgHooks array for a given event. All the following are valid ways to define hooks: $wgHooks['EventName'][] = 'someFunction'; # function, no data $wgHooks['EventName'][] = array('someFunction', $someData); $wgHooks['EventName'][] = array('someFunction'); # weird, but OK $wgHooks['EventName'][] = $object; # object only $wgHooks['EventName'][] = array($object, 'someMethod'); $wgHooks['EventName'][] = array($object, 'someMethod', $someData); $wgHooks['EventName'][] = array($object); # weird but OK When an event occurs, the function (or object method) will be called with the optional data provided as well as event-specific parameters. The above examples would result in the following code being executed when 'EventName' happened: # function, no data someFunction($param1, $param2) # function with data someFunction($someData, $param1, $param2) # object only $object->onEventName($param1, $param2) # object with method $object->someMethod($param1, $param2) # object with method and data $object->someMethod($someData, $param1, $param2) Note that when an object is the hook, and there's no specified method, the default method called is 'onEventName'. For different events this would be different: 'onArticleSave', 'onUserLogin', etc. The extra data is useful if we want to use the same function or object for different purposes. For example: $wgHooks['ArticleSaveComplete'][] = array('ircNotify', 'TimStarling'); $wgHooks['ArticleSaveComplete'][] = array('ircNotify', 'brion'); This code would result in ircNotify being run twice when an article is saved: once for 'TimStarling', and once for 'brion'. Hooks can return three possible values: * true: the hook has operated successfully * "some string": an error occurred; processing should stop and the error should be shown to the user * false: the hook has successfully done the work necessary and the calling function should skip The last result would be for cases where the hook function replaces the main functionality. For example, if you wanted to authenticate users to a custom system (LDAP, another PHP program, whatever), you could do: $wgHooks['UserLogin'][] = array('ldapLogin', $ldapServer); function ldapLogin($username, $password) { # log user into LDAP return false; } Returning false makes less sense for events where the action is complete, and will normally be ignored. ==Using hooks== A calling function or method uses the wfRunHooks() function to run the hooks related to a particular event, like so: class Article { # ... function protect() { global $wgUser; if (wfRunHooks('ArticleProtect', array(&$this, &$wgUser))) { # protect the article wfRunHooks('ArticleProtectComplete', array(&$this, &$wgUser)); } } wfRunHooks() returns true if the calling function should continue processing (the hooks ran OK, or there are no hooks to run), or false if it shouldn't (an error occurred, or one of the hooks handled the action already). Checking the return value matters more for "before" hooks than for "complete" hooks. Note that hook parameters are passed in an array; this is a necessary inconvenience to make it possible to pass reference values (that can be changed) into the hook code. Also note that earlier versions of wfRunHooks took a variable number of arguments; the array() calling protocol came about after MediaWiki 1.4rc1. ==Events and parameters== This is a list of known events and parameters; please add to it if you're going to add events to the MediaWiki code. 'AbortNewAccount': Return false to cancel account creation. $user: the User object about to be created (read-only, incomplete) $message: out parameter: error message to display on abort 'AddNewAccount': after a user account is created $user: the User object that was created. (Parameter added in 1.7) 'ArticleDelete': before an article is deleted $article: the article (object) being deleted $user: the user (object) deleting the article $reason: the reason (string) the article is being deleted 'ArticleDeleteComplete': after an article is deleted $article: the article that was deleted $user: the user that deleted the article $reason: the reason the article was deleted 'ArticleProtect': before an article is protected $article: the article being protected $user: the user doing the protection $protect: boolean whether this is a protect or an unprotect $reason: Reason for protect $moveonly: boolean whether this is for move only or not 'ArticleProtectComplete': after an article is protected $article: the article that was protected $user: the user who did the protection $protect: boolean whether it was a protect or an unprotect $reason: Reason for protect $moveonly: boolean whether it was for move only or not 'ArticleSave': before an article is saved $article: the article (object) being saved $user: the user (object) saving the article $text: the new article text $summary: the article summary (comment) $isminor: minor flag $iswatch: watch flag $section: section # 'ArticleSaveComplete': after an article is saved $article: the article (object) saved $user: the user (object) who saved the article $text: the new article text $summary: the article summary (comment) $isminor: minor flag $iswatch: watch flag $section: section # 'AuthPluginSetup': update or replace authentication plugin object ($wgAuth) Gives a chance for an extension to set it programattically to a variable class. &$auth: the $wgAuth object, probably a stub 'AutoAuthenticate': called to authenticate users on external/environmental means $user: writes user object to this parameter 'BadImage': When checking against the bad image list $name: Image name being checked &$bad: Whether or not the image is "bad" Change $bad and return false to override. If an image is "bad", it is not rendered inline in wiki pages or galleries in category pages. 'BlockIp': before an IP address or user is blocked $block: the Block object about to be saved $user: the user _doing_ the block (not the one being blocked) 'BlockIpComplete': after an IP address or user is blocked $block: the Block object that was saved $user: the user who did the block (not the one being blocked) 'DiffViewHeader': called before diff display $diff: DifferenceEngine object that's calling $oldRev: Revision object of the "old" revision (may be null/invalid) $newRev: Revision object of the "new" revision 'EditPage::attemptSave': called before an article is saved, that is before insertNewArticle() is called &$editpage_Obj: the current EditPage object 'EditFormPreloadText': Allows population of the edit form when creating new pages &$text: Text to preload with &$title: Title object representing the page being created 'EditFilter': Perform checks on an edit $editor: Edit form (see includes/EditPage.php) $text: Contents of the edit box $section: Section being edited &$error: Error message to return Return false to halt editing; you'll need to handle error messages, etc. yourself. Alternatively, modifying $error and returning true will cause the contents of $error to be echoed at the top of the edit form as wikitext. Return true without altering $error to allow the edit to proceed. 'EmailConfirmed': When checking that the user's email address is "confirmed" $user: User being checked $confirmed: Whether or not the email address is confirmed This runs before the other checks, such as anonymity and the real check; return true to allow those checks to occur, and false if checking is done. 'EmailUser': before sending email from one user to another $to: address of receiving user $from: address of sending user $subject: subject of the mail $text: text of the mail 'EmailUserComplete': after sending email from one user to another $to: address of receiving user $from: address of sending user $subject: subject of the mail $text: text of the mail 'FetchChangesList': When fetching the ChangesList derivative for a particular user &$user: User the list is being fetched for &$skin: Skin object to be used with the list &$list: List object (defaults to NULL, change it to an object instance and return false override the list derivative used) 'GetInternalURL': modify fully-qualified URLs used for squid cache purging $title: Title object of page $url: string value as output (out parameter, can modify) $query: query options passed to Title::getInternalURL() 'GetLocalURL': modify local URLs as output into page links $title: Title object of page $url: string value as output (out parameter, can modify) $query: query options passed to Title::getLocalURL() 'GetFullURL': modify fully-qualified URLs used in redirects/export/offsite data $title: Title object of page $url: string value as output (out parameter, can modify) $query: query options passed to Title::getFullURL() 'LogPageValidTypes': action being logged. DEPRECATED: Use $wgLogTypes &$type: array of strings 'LogPageLogName': name of the logging page(s). DEPRECATED: Use $wgLogNames &$typeText: array of strings 'LogPageLogHeader': strings used by wfMsg as a header. DEPRECATED: Use $wgLogHeaders &$headerText: array of strings 'LogPageActionText': strings used by wfMsg as a header. DEPRECATED: Use $wgLogActions &$actionText: array of strings 'MarkPatrolled': before an edit is marked patrolled $rcid: ID of the revision to be marked patrolled $user: the user (object) marking the revision as patrolled $wcOnlySysopsCanPatrol: config setting indicating whether the user needs to be a sysop in order to mark an edit patrolled 'MarkPatrolledComplete': after an edit is marked patrolled $rcid: ID of the revision marked as patrolled $user: user (object) who marked the edit patrolled $wcOnlySysopsCanPatrol: config setting indicating whether the user must be a sysop to patrol the edit 'MathAfterTexvc': after texvc is executed when rendering mathematics $mathRenderer: instance of MathRenderer $errmsg: error message, in HTML (string). Nonempty indicates failure of rendering the formula 'OutputPageBeforeHTML': a page has been processed by the parser and the resulting HTML is about to be displayed. $parserOutput: the parserOutput (object) that corresponds to the page $text: the text that will be displayed, in HTML (string) 'PageRenderingHash': alter the parser cache option hash key A parser extension which depends on user options should install this hook and append its values to the key. $hash: reference to a hash key string which can be modified 'PersonalUrls': Alter the user-specific navigation links (e.g. "my page, my talk page, my contributions" etc). &$personal_urls: Array of link specifiers (see SkinTemplate.php) &$title: Title object representing the current page 'PingLimiter': Allows extensions to override the results of User::pingLimiter() &$user : User performing the action $action : Action being performed &$result : Whether or not the action should be prevented Change $result and return false to give a definitive answer, otherwise the built-in rate limiting checks are used, if enabled. 'PreferencesUserInformationPanel': Add HTML bits to user information list in preferences form $form : PreferencesForm object &$html : HTML to append to 'SiteNoticeBefore': Before the sitenotice/anonnotice is composed &$siteNotice: HTML returned as the sitenotice Return true to allow the normal method of notice selection/rendering to work, or change the value of $siteNotice and return false to alter it. 'SiteNoticeAfter': After the sitenotice/anonnotice is composed &$siteNotice: HTML sitenotice Alter the contents of $siteNotice to add to/alter the sitenotice/anonnotice. +'SkinTemplateOutputPageBeforeExec': Before SkinTemplate::outputPage() starts page output +&$sktemplate: SkinTemplate object +&$tpl: Template engine object + 'TitleMoveComplete': after moving an article (title) $old: old title $nt: new title $user: user who did the move $pageid: database ID of the page that's been moved $redirid: database ID of the created redirect 'UnknownAction': An unknown "action" has occured (useful for defining your own actions) $action: action name $article: article "acted on" 'UnwatchArticle': before a watch is removed from an article $user: user watching $article: article object to be removed 'UnwatchArticle': after a watch is removed from an article $user: user that was watching $article: article object removed 'UploadForm:initial': before the upload form is generated $form: UploadForm object You might set the member-variables $uploadFormTextTop and $uploadFormTextAfterSummary to inject text (HTML) either before or after the editform. 'UploadForm:BeforeProcessing': at the beginning of processUpload() $form: UploadForm object Lets you poke at member variables like $mUploadDescription before the file is saved. 'UploadVerification': additional chances to reject an uploaded file string $saveName: destination file name string $tempName: filesystem path to the temporary file for checks string &$error: output: HTML error to show if upload canceled by returning false 'UploadComplete': Upon completion of a file upload $image: Image object representing the file that was uploaded 'UserCan': To interrupt/advise the "user can do X to Y article" check $title: Title object being checked against $user : Current user object $action: Action being checked $result: Pointer to result returned if hook returns false. If null is returned, UserCan checks are continued by internal code 'UserCreateForm': change to manipulate the login form $template: SimpleTemplate instance for the form 'UserLoginComplete': after a user has logged in $user: the user object that was created on login 'UserLoginForm': change to manipulate the login form $template: SimpleTemplate instance for the form 'UserLogout': before a user logs out $user: the user object that is about to be logged out 'UserLogoutComplete': after a user has logged out $user: the user object _after_ logout (won't have name, ID, etc.) 'UserRights': After a user's group memberships are changed $user : User object that was changed $add : Array of strings corresponding to groups added $remove: Array of strings corresponding to groups removed 'WatchArticle': before a watch is added to an article $user: user that will watch $article: article object to be watched 'WatchArticleComplete': after a watch is added to an article $user: user that watched $article: article object watched 'UnwatchArticleComplete': after a watch is removed from an article $user: user that watched $article: article object that was watched 'CategoryPageView': before viewing a categorypage in CategoryPage::view $catpage: CategoryPage instance 'SkinTemplateContentActions': after building the $content_action array right before returning it, see Content_action.php in the extensions/examples/ directory ( http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/examples/ ) for a demonstration of how to use this hook. $content_actions: The array of content actions 'BeforePageDisplay': Called just before outputting a page (all kinds of, articles, special, history, preview, diff, edit, ...) Can be used to set custom CSS/JS $out: OutputPage object More hooks might be available but undocumented, you can execute ./maintenance/findhooks.php to find hidden one. Index: trunk/phase3/includes/SkinTemplate.php =================================================================== --- trunk/phase3/includes/SkinTemplate.php (revision 19062) +++ trunk/phase3/includes/SkinTemplate.php (revision 19063) @@ -1,1172 +1,1177 @@ _context[$varName] = $value; } function translate($value) { $fname = 'SkinTemplate-translate'; wfProfileIn( $fname ); // Hack for i18n:attributes in PHPTAL 1.0.0 dev version as of 2004-10-23 $value = preg_replace( '/^string:/', '', $value ); $value = wfMsg( $value ); // interpolate variables $m = array(); while (preg_match('/\$([0-9]*?)/sm', $value, $m)) { list($src, $var) = $m; wfSuppressWarnings(); $varValue = $this->_context[$var]; wfRestoreWarnings(); $value = str_replace($src, $varValue, $value); } wfProfileOut( $fname ); return $value; } } /** * * @package MediaWiki */ class SkinTemplate extends Skin { /**#@+ * @private */ /** * Name of our skin, set in initPage() * It probably need to be all lower case. */ var $skinname; /** * Stylesheets set to use * Sub directory in ./skins/ where various stylesheets are located */ var $stylename; /** * For QuickTemplate, the name of the subclass which * will actually fill the template. */ var $template; /**#@-*/ /** * Setup the base parameters... * Child classes should override this to set the name, * style subdirectory, and template filler callback. * * @param OutputPage $out */ function initPage( &$out ) { parent::initPage( $out ); $this->skinname = 'monobook'; $this->stylename = 'monobook'; $this->template = 'QuickTemplate'; } /** * Create the template engine object; we feed it a bunch of data * and eventually it spits out some HTML. Should have interface * roughly equivalent to PHPTAL 0.7. * * @param string $callback (or file) * @param string $repository subdirectory where we keep template files * @param string $cache_dir * @return object * @private */ function setupTemplate( $classname, $repository=false, $cache_dir=false ) { return new $classname(); } /** * initialize various variables and generate the template * * @param OutputPage $out * @public */ function outputPage( &$out ) { global $wgTitle, $wgArticle, $wgUser, $wgLang, $wgContLang, $wgOut; global $wgScript, $wgStylePath, $wgContLanguageCode; global $wgMimeType, $wgJsMimeType, $wgOutputEncoding, $wgRequest; global $wgXhtmlDefaultNamespace, $wgXhtmlNamespaces; global $wgDisableCounters, $wgLogo, $action, $wgFeedClasses, $wgHideInterlanguageLinks; global $wgMaxCredits, $wgShowCreditsIfMax; global $wgPageShowWatchingUsers; global $wgUseTrackbacks; global $wgArticlePath, $wgScriptPath, $wgServer, $wgLang, $wgCanonicalNamespaceNames; $fname = 'SkinTemplate::outputPage'; wfProfileIn( $fname ); // Hook that allows last minute changes to the output page, e.g. // adding of CSS or Javascript by extensions. wfRunHooks( 'BeforePageDisplay', array( &$out ) ); $oldid = $wgRequest->getVal( 'oldid' ); $diff = $wgRequest->getVal( 'diff' ); wfProfileIn( "$fname-init" ); $this->initPage( $out ); $this->mTitle =& $wgTitle; $this->mUser =& $wgUser; $tpl = $this->setupTemplate( $this->template, 'skins' ); #if ( $wgUseDatabaseMessages ) { // uncomment this to fall back to GetText $tpl->setTranslator(new MediaWiki_I18N()); #} wfProfileOut( "$fname-init" ); wfProfileIn( "$fname-stuff" ); $this->thispage = $this->mTitle->getPrefixedDbKey(); $this->thisurl = $this->mTitle->getPrefixedURL(); $this->loggedin = $wgUser->isLoggedIn(); $this->iscontent = ($this->mTitle->getNamespace() != NS_SPECIAL ); $this->iseditable = ($this->iscontent and !($action == 'edit' or $action == 'submit')); $this->username = $wgUser->getName(); $userPage = $wgUser->getUserPage(); $this->userpage = $userPage->getPrefixedText(); if ( $wgUser->isLoggedIn() || $this->showIPinHeader() ) { $this->userpageUrlDetails = self::makeUrlDetails( $this->userpage ); } else { # This won't be used in the standard skins, but we define it to preserve the interface # To save time, we check for existence $this->userpageUrlDetails = self::makeKnownUrlDetails( $this->userpage ); } $this->usercss = $this->userjs = $this->userjsprev = false; $this->setupUserCss(); $this->setupUserJs(); $this->titletxt = $this->mTitle->getPrefixedText(); wfProfileOut( "$fname-stuff" ); wfProfileIn( "$fname-stuff2" ); $tpl->set( 'title', $wgOut->getPageTitle() ); $tpl->set( 'pagetitle', $wgOut->getHTMLTitle() ); $tpl->set( 'displaytitle', $wgOut->mPageLinkTitle ); $tpl->set( 'pageclass', Sanitizer::escapeClass( 'page-'.$wgTitle->getPrefixedText() ) ); $nsname = isset( $wgCanonicalNamespaceNames[ $this->mTitle->getNamespace() ] ) ? $wgCanonicalNamespaceNames[ $this->mTitle->getNamespace() ] : $this->mTitle->getNsText(); $tpl->set( 'nscanonical', $nsname ); $tpl->set( 'nsnumber', $this->mTitle->getNamespace() ); $tpl->set( 'titleprefixeddbkey', $this->mTitle->getPrefixedDBKey() ); $tpl->set( 'titletext', $this->mTitle->getText() ); $tpl->set( 'articleid', $this->mTitle->getArticleId() ); $tpl->set( 'currevisionid', isset( $wgArticle ) ? $wgArticle->getLatest() : 0 ); $tpl->set( 'isarticle', $wgOut->isArticle() ); $tpl->setRef( "thispage", $this->thispage ); $subpagestr = $this->subPageSubtitle(); $tpl->set( 'subtitle', !empty($subpagestr)? ''.$subpagestr.''.$out->getSubtitle(): $out->getSubtitle() ); $undelete = $this->getUndeleteLink(); $tpl->set( "undelete", !empty($undelete)? ''.$undelete.'': '' ); $tpl->set( 'catlinks', $this->getCategories()); if( $wgOut->isSyndicated() ) { $feeds = array(); foreach( $wgFeedClasses as $format => $class ) { $linktext = $format; if ( $format == "atom" ) { $linktext = wfMsg( 'feed-atom' ); } else if ( $format == "rss" ) { $linktext = wfMsg( 'feed-rss' ); } $feeds[$format] = array( 'text' => $linktext, 'href' => $wgRequest->appendQuery( "feed=$format" ) ); } $tpl->setRef( 'feeds', $feeds ); } else { $tpl->set( 'feeds', false ); } if ($wgUseTrackbacks && $out->isArticleRelated()) { $tpl->set( 'trackbackhtml', $wgTitle->trackbackRDF() ); } else { $tpl->set( 'trackbackhtml', null ); } $tpl->setRef( 'xhtmldefaultnamespace', $wgXhtmlDefaultNamespace ); $tpl->set( 'xhtmlnamespaces', $wgXhtmlNamespaces ); $tpl->setRef( 'mimetype', $wgMimeType ); $tpl->setRef( 'jsmimetype', $wgJsMimeType ); $tpl->setRef( 'charset', $wgOutputEncoding ); $tpl->set( 'headlinks', $out->getHeadLinks() ); $tpl->set('headscripts', $out->getScript() ); $tpl->setRef( 'wgScript', $wgScript ); $tpl->setRef( 'skinname', $this->skinname ); $tpl->set( 'skinclass', get_class( $this ) ); $tpl->setRef( 'stylename', $this->stylename ); $tpl->set( 'printable', $wgRequest->getBool( 'printable' ) ); $tpl->setRef( 'loggedin', $this->loggedin ); $tpl->set('nsclass', 'ns-'.$this->mTitle->getNamespace()); $tpl->set('notspecialpage', $this->mTitle->getNamespace() != NS_SPECIAL); /* XXX currently unused, might get useful later $tpl->set( "editable", ($this->mTitle->getNamespace() != NS_SPECIAL ) ); $tpl->set( "exists", $this->mTitle->getArticleID() != 0 ); $tpl->set( "watch", $this->mTitle->userIsWatching() ? "unwatch" : "watch" ); $tpl->set( "protect", count($this->mTitle->isProtected()) ? "unprotect" : "protect" ); $tpl->set( "helppage", wfMsg('helppage')); */ $tpl->set( 'searchaction', $this->escapeSearchLink() ); $tpl->set( 'search', trim( $wgRequest->getVal( 'search' ) ) ); $tpl->setRef( 'stylepath', $wgStylePath ); $tpl->setRef( 'articlepath', $wgArticlePath ); $tpl->setRef( 'scriptpath', $wgScriptPath ); $tpl->setRef( 'serverurl', $wgServer ); $tpl->setRef( 'logopath', $wgLogo ); $tpl->setRef( "lang", $wgContLanguageCode ); $tpl->set( 'dir', $wgContLang->isRTL() ? "rtl" : "ltr" ); $tpl->set( 'rtl', $wgContLang->isRTL() ); $tpl->set( 'langname', $wgContLang->getLanguageName( $wgContLanguageCode ) ); $tpl->set( 'showjumplinks', $wgUser->getOption( 'showjumplinks' ) ); $tpl->set( 'username', $wgUser->isAnon() ? NULL : $this->username ); $tpl->setRef( 'userpage', $this->userpage); $tpl->setRef( 'userpageurl', $this->userpageUrlDetails['href']); $tpl->set( 'userlang', $wgLang->getCode() ); $tpl->set( 'pagecss', $this->setupPageCss() ); $tpl->setRef( 'usercss', $this->usercss); $tpl->setRef( 'userjs', $this->userjs); $tpl->setRef( 'userjsprev', $this->userjsprev); global $wgUseSiteJs; if ($wgUseSiteJs) { if($this->loggedin) { $tpl->set( 'jsvarurl', self::makeUrl('-','action=raw&smaxage=0&gen=js') ); } else { $tpl->set( 'jsvarurl', self::makeUrl('-','action=raw&gen=js') ); } } else { $tpl->set('jsvarurl', false); } $newtalks = $wgUser->getNewMessageLinks(); if (count($newtalks) == 1 && $newtalks[0]["wiki"] === wfWikiID() ) { $usertitle = $this->mUser->getUserPage(); $usertalktitle = $usertitle->getTalkPage(); if( !$usertalktitle->equals( $this->mTitle ) ) { $ntl = wfMsg( 'youhavenewmessages', $this->makeKnownLinkObj( $usertalktitle, wfMsgHtml( 'newmessageslink' ), 'redirect=no' ), $this->makeKnownLinkObj( $usertalktitle, wfMsgHtml( 'newmessagesdifflink' ), 'diff=cur' ) ); # Disable Cache $wgOut->setSquidMaxage(0); } } else if (count($newtalks)) { $sep = str_replace("_", " ", wfMsgHtml("newtalkseperator")); $msgs = array(); foreach ($newtalks as $newtalk) { $msgs[] = wfElement("a", array('href' => $newtalk["link"]), $newtalk["wiki"]); } $parts = implode($sep, $msgs); $ntl = wfMsgHtml('youhavenewmessagesmulti', $parts); $wgOut->setSquidMaxage(0); } else { $ntl = ''; } wfProfileOut( "$fname-stuff2" ); wfProfileIn( "$fname-stuff3" ); $tpl->setRef( 'newtalk', $ntl ); $tpl->setRef( 'skin', $this); $tpl->set( 'logo', $this->logoText() ); if ( $wgOut->isArticle() and (!isset( $oldid ) or isset( $diff )) and $wgArticle and 0 != $wgArticle->getID() ) { if ( !$wgDisableCounters ) { $viewcount = $wgLang->formatNum( $wgArticle->getCount() ); if ( $viewcount ) { $tpl->set('viewcount', wfMsgExt( 'viewcount', array( 'parseinline' ), $viewcount ) ); } else { $tpl->set('viewcount', false); } } else { $tpl->set('viewcount', false); } if ($wgPageShowWatchingUsers) { $dbr =& wfGetDB( DB_SLAVE ); $watchlist = $dbr->tableName( 'watchlist' ); $sql = "SELECT COUNT(*) AS n FROM $watchlist WHERE wl_title='" . $dbr->strencode($this->mTitle->getDBKey()) . "' AND wl_namespace=" . $this->mTitle->getNamespace() ; $res = $dbr->query( $sql, 'SkinTemplate::outputPage'); $x = $dbr->fetchObject( $res ); $numberofwatchingusers = $x->n; if ($numberofwatchingusers > 0) { $tpl->set('numberofwatchingusers', wfMsg('number_of_watching_users_pageview', $numberofwatchingusers)); } else { $tpl->set('numberofwatchingusers', false); } } else { $tpl->set('numberofwatchingusers', false); } $tpl->set('copyright',$this->getCopyright()); $this->credits = false; if (isset($wgMaxCredits) && $wgMaxCredits != 0) { require_once("Credits.php"); $this->credits = getCredits($wgArticle, $wgMaxCredits, $wgShowCreditsIfMax); } else { $tpl->set('lastmod', $this->lastModified()); } $tpl->setRef( 'credits', $this->credits ); } elseif ( isset( $oldid ) && !isset( $diff ) ) { $tpl->set('copyright', $this->getCopyright()); $tpl->set('viewcount', false); $tpl->set('lastmod', false); $tpl->set('credits', false); $tpl->set('numberofwatchingusers', false); } else { $tpl->set('copyright', false); $tpl->set('viewcount', false); $tpl->set('lastmod', false); $tpl->set('credits', false); $tpl->set('numberofwatchingusers', false); } wfProfileOut( "$fname-stuff3" ); wfProfileIn( "$fname-stuff4" ); $tpl->set( 'copyrightico', $this->getCopyrightIcon() ); $tpl->set( 'poweredbyico', $this->getPoweredBy() ); $tpl->set( 'disclaimer', $this->disclaimerLink() ); $tpl->set( 'privacy', $this->privacyLink() ); $tpl->set( 'about', $this->aboutLink() ); $tpl->setRef( 'debug', $out->mDebugtext ); $tpl->set( 'reporttime', $out->reportTime() ); $tpl->set( 'sitenotice', wfGetSiteNotice() ); $tpl->set( 'bottomscripts', $this->bottomScripts() ); $printfooter = "
\n" . $this->printSource() . "
\n"; $out->mBodytext .= $printfooter ; $tpl->setRef( 'bodytext', $out->mBodytext ); # Language links $language_urls = array(); if ( !$wgHideInterlanguageLinks ) { foreach( $wgOut->getLanguageLinks() as $l ) { $tmp = explode( ':', $l, 2 ); $class = 'interwiki-' . $tmp[0]; unset($tmp); $nt = Title::newFromText( $l ); $language_urls[] = array( 'href' => $nt->getFullURL(), 'text' => ($wgContLang->getLanguageName( $nt->getInterwiki()) != ''?$wgContLang->getLanguageName( $nt->getInterwiki()) : $l), 'class' => $class ); } } if(count($language_urls)) { $tpl->setRef( 'language_urls', $language_urls); } else { $tpl->set('language_urls', false); } wfProfileOut( "$fname-stuff4" ); # Personal toolbar $tpl->set('personal_urls', $this->buildPersonalUrls()); $content_actions = $this->buildContentActionUrls(); $tpl->setRef('content_actions', $content_actions); // XXX: attach this from javascript, same with section editing if($this->iseditable && $wgUser->getOption("editondblclick") ) { $tpl->set('body_ondblclick', 'document.location = "' .$content_actions['edit']['href'] .'";'); } else { $tpl->set('body_ondblclick', false); } if( $this->iseditable && $wgUser->getOption( 'editsectiononrightclick' ) ) { $tpl->set( 'body_onload', 'setupRightClickEdit()' ); } else { $tpl->set( 'body_onload', false ); } $tpl->set( 'sidebar', $this->buildSidebar() ); $tpl->set( 'nav_urls', $this->buildNavUrls() ); + // original version by hansm + if( !wfRunHooks( 'SkinTemplateOutputPageBeforeExec', array( &$this, &$tpl ) ) ) { + wfDebug( __METHOD__ . ': Hook SkinTemplateOutputPageBeforeExec broke outputPage execution!' ); + } + // execute template wfProfileIn( "$fname-execute" ); $res = $tpl->execute(); wfProfileOut( "$fname-execute" ); // result may be an error $this->printOrError( $res ); wfProfileOut( $fname ); } /** * Output the string, or print error message if it's * an error object of the appropriate type. * For the base class, assume strings all around. * * @param mixed $str * @private */ function printOrError( &$str ) { echo $str; } /** * build array of urls for personal toolbar * @return array * @private */ function buildPersonalUrls() { global $wgTitle, $wgShowIPinHeader; $fname = 'SkinTemplate::buildPersonalUrls'; $pageurl = $wgTitle->getLocalURL(); wfProfileIn( $fname ); /* set up the default links for the personal toolbar */ $personal_urls = array(); if ($this->loggedin) { $personal_urls['userpage'] = array( 'text' => $this->username, 'href' => &$this->userpageUrlDetails['href'], 'class' => $this->userpageUrlDetails['exists']?false:'new', 'active' => ( $this->userpageUrlDetails['href'] == $pageurl ) ); $usertalkUrlDetails = $this->makeTalkUrlDetails($this->userpage); $personal_urls['mytalk'] = array( 'text' => wfMsg('mytalk'), 'href' => &$usertalkUrlDetails['href'], 'class' => $usertalkUrlDetails['exists']?false:'new', 'active' => ( $usertalkUrlDetails['href'] == $pageurl ) ); $href = self::makeSpecialUrl( 'Preferences' ); $personal_urls['preferences'] = array( 'text' => wfMsg( 'mypreferences' ), 'href' => self::makeSpecialUrl( 'Preferences' ), 'active' => ( $href == $pageurl ) ); $href = self::makeSpecialUrl( 'Watchlist' ); $personal_urls['watchlist'] = array( 'text' => wfMsg( 'watchlist' ), 'href' => $href, 'active' => ( $href == $pageurl ) ); $href = self::makeSpecialUrlSubpage( 'Contributions', $this->username ); $personal_urls['mycontris'] = array( 'text' => wfMsg( 'mycontris' ), 'href' => $href, // FIXME # 'active' was disabed in r11346 with message: "disable bold link to my contributions; link was bold on all // Special:Contributions, not just current user's (fix me please!)". Until resolved, explicitly setting active to false. 'active' => false # ( ( $href == $pageurl . '/' . $this->username ) ); $personal_urls['logout'] = array( 'text' => wfMsg( 'userlogout' ), 'href' => self::makeSpecialUrl( 'Userlogout', $wgTitle->isSpecial( 'Preferences' ) ? '' : "returnto={$this->thisurl}" ), 'active' => false ); } else { if( $wgShowIPinHeader && isset( $_COOKIE[ini_get("session.name")] ) ) { $href = &$this->userpageUrlDetails['href']; $personal_urls['anonuserpage'] = array( 'text' => $this->username, 'href' => $href, 'class' => $this->userpageUrlDetails['exists']?false:'new', 'active' => ( $pageurl == $href ) ); $usertalkUrlDetails = $this->makeTalkUrlDetails($this->userpage); $href = &$usertalkUrlDetails['href']; $personal_urls['anontalk'] = array( 'text' => wfMsg('anontalk'), 'href' => $href, 'class' => $usertalkUrlDetails['exists']?false:'new', 'active' => ( $pageurl == $href ) ); $personal_urls['anonlogin'] = array( 'text' => wfMsg('userlogin'), 'href' => self::makeSpecialUrl( 'Userlogin', 'returnto=' . $this->thisurl ), 'active' => $wgTitle->isSpecial( 'Userlogin' ) ); } else { $personal_urls['login'] = array( 'text' => wfMsg('userlogin'), 'href' => self::makeSpecialUrl( 'Userlogin', 'returnto=' . $this->thisurl ), 'active' => $wgTitle->isSpecial( 'Userlogin' ) ); } } wfRunHooks( 'PersonalUrls', array( &$personal_urls, &$wgTitle ) ); wfProfileOut( $fname ); return $personal_urls; } /** * Returns true if the IP should be shown in the header */ function showIPinHeader() { global $wgShowIPinHeader; return $wgShowIPinHeader && isset( $_COOKIE[ini_get("session.name")] ); } function tabAction( $title, $message, $selected, $query='', $checkEdit=false ) { $classes = array(); if( $selected ) { $classes[] = 'selected'; } if( $checkEdit && $title->getArticleId() == 0 ) { $classes[] = 'new'; $query = 'action=edit'; } $text = wfMsg( $message ); if ( wfEmptyMsg( $message, $text ) ) { global $wgContLang; $text = $wgContLang->getFormattedNsText( Namespace::getSubject( $title->getNamespace() ) ); } return array( 'class' => implode( ' ', $classes ), 'text' => $text, 'href' => $title->getLocalUrl( $query ) ); } function makeTalkUrlDetails( $name, $urlaction = '' ) { $title = Title::newFromText( $name ); $title = $title->getTalkPage(); self::checkTitle( $title, $name ); return array( 'href' => $title->getLocalURL( $urlaction ), 'exists' => $title->getArticleID() != 0 ? true : false ); } function makeArticleUrlDetails( $name, $urlaction = '' ) { $title = Title::newFromText( $name ); $title= $title->getSubjectPage(); self::checkTitle( $title, $name ); return array( 'href' => $title->getLocalURL( $urlaction ), 'exists' => $title->getArticleID() != 0 ? true : false ); } /** * an array of edit links by default used for the tabs * @return array * @private */ function buildContentActionUrls () { global $wgContLang, $wgOut; $fname = 'SkinTemplate::buildContentActionUrls'; wfProfileIn( $fname ); global $wgUser, $wgRequest; $action = $wgRequest->getText( 'action' ); $section = $wgRequest->getText( 'section' ); $content_actions = array(); $prevent_active_tabs = false ; wfRunHooks( 'SkinTemplatePreventOtherActiveTabs', array( &$this , &$prevent_active_tabs ) ) ; if( $this->iscontent ) { $subjpage = $this->mTitle->getSubjectPage(); $talkpage = $this->mTitle->getTalkPage(); $nskey = $this->mTitle->getNamespaceKey(); $content_actions[$nskey] = $this->tabAction( $subjpage, $nskey, !$this->mTitle->isTalkPage() && !$prevent_active_tabs, '', true); $content_actions['talk'] = $this->tabAction( $talkpage, 'talk', $this->mTitle->isTalkPage() && !$prevent_active_tabs, '', true); wfProfileIn( "$fname-edit" ); if ( $this->mTitle->userCanEdit() && ( $this->mTitle->exists() || $this->mTitle->userCanCreate() ) ) { $istalk = $this->mTitle->isTalkPage(); $istalkclass = $istalk?' istalk':''; $content_actions['edit'] = array( 'class' => ((($action == 'edit' or $action == 'submit') and $section != 'new') ? 'selected' : '').$istalkclass, 'text' => wfMsg('edit'), 'href' => $this->mTitle->getLocalUrl( $this->editUrlOptions() ) ); if ( $istalk || $wgOut->showNewSectionLink() ) { $content_actions['addsection'] = array( 'class' => $section == 'new'?'selected':false, 'text' => wfMsg('addsection'), 'href' => $this->mTitle->getLocalUrl( 'action=edit§ion=new' ) ); } } else { $content_actions['viewsource'] = array( 'class' => ($action == 'edit') ? 'selected' : false, 'text' => wfMsg('viewsource'), 'href' => $this->mTitle->getLocalUrl( $this->editUrlOptions() ) ); } wfProfileOut( "$fname-edit" ); wfProfileIn( "$fname-live" ); if ( $this->mTitle->getArticleId() ) { $content_actions['history'] = array( 'class' => ($action == 'history') ? 'selected' : false, 'text' => wfMsg('history_short'), 'href' => $this->mTitle->getLocalUrl( 'action=history') ); if ( $this->mTitle->getNamespace() !== NS_MEDIAWIKI && $wgUser->isAllowed( 'protect' ) ) { if(!$this->mTitle->isProtected()){ $content_actions['protect'] = array( 'class' => ($action == 'protect') ? 'selected' : false, 'text' => wfMsg('protect'), 'href' => $this->mTitle->getLocalUrl( 'action=protect' ) ); } else { $content_actions['unprotect'] = array( 'class' => ($action == 'unprotect') ? 'selected' : false, 'text' => wfMsg('unprotect'), 'href' => $this->mTitle->getLocalUrl( 'action=unprotect' ) ); } } if($wgUser->isAllowed('delete')){ $content_actions['delete'] = array( 'class' => ($action == 'delete') ? 'selected' : false, 'text' => wfMsg('delete'), 'href' => $this->mTitle->getLocalUrl( 'action=delete' ) ); } if ( $this->mTitle->userCanMove()) { $moveTitle = SpecialPage::getTitleFor( 'Movepage', $this->thispage ); $content_actions['move'] = array( 'class' => $this->mTitle->isSpecial( 'Movepage' ) ? 'selected' : false, 'text' => wfMsg('move'), 'href' => $moveTitle->getLocalUrl() ); } } else { //article doesn't exist or is deleted if( $wgUser->isAllowed( 'delete' ) ) { if( $n = $this->mTitle->isDeleted() ) { $undelTitle = SpecialPage::getTitleFor( 'Undelete' ); $content_actions['undelete'] = array( 'class' => false, 'text' => wfMsgExt( 'undelete_short', array( 'parsemag' ), $n ), 'href' => $undelTitle->getLocalUrl( 'target=' . urlencode( $this->thispage ) ) #'href' => self::makeSpecialUrl( "Undelete/$this->thispage" ) ); } } } wfProfileOut( "$fname-live" ); if( $this->loggedin ) { if( !$this->mTitle->userIsWatching()) { $content_actions['watch'] = array( 'class' => ($action == 'watch' or $action == 'unwatch') ? 'selected' : false, 'text' => wfMsg('watch'), 'href' => $this->mTitle->getLocalUrl( 'action=watch' ) ); } else { $content_actions['unwatch'] = array( 'class' => ($action == 'unwatch' or $action == 'watch') ? 'selected' : false, 'text' => wfMsg('unwatch'), 'href' => $this->mTitle->getLocalUrl( 'action=unwatch' ) ); } } wfRunHooks( 'SkinTemplateTabs', array( &$this , &$content_actions ) ) ; } else { /* show special page tab */ $content_actions[$this->mTitle->getNamespaceKey()] = array( 'class' => 'selected', 'text' => wfMsg('specialpage'), 'href' => $wgRequest->getRequestURL(), // @bug 2457, 2510 ); wfRunHooks( 'SkinTemplateBuildContentActionUrlsAfterSpecialPage', array( &$this, &$content_actions ) ); } /* show links to different language variants */ global $wgDisableLangConversion; $variants = $wgContLang->getVariants(); if( !$wgDisableLangConversion && sizeof( $variants ) > 1 ) { $preferred = $wgContLang->getPreferredVariant(); $vcount=0; foreach( $variants as $code ) { $varname = $wgContLang->getVariantname( $code ); if( $varname == 'disable' ) continue; $selected = ( $code == $preferred )? 'selected' : false; $content_actions['varlang-' . $vcount] = array( 'class' => $selected, 'text' => $varname, 'href' => $this->mTitle->getLocalURL('',$code) ); $vcount ++; } } wfRunHooks( 'SkinTemplateContentActions', array( &$content_actions ) ); wfProfileOut( $fname ); return $content_actions; } /** * build array of common navigation links * @return array * @private */ function buildNavUrls () { global $wgUseTrackbacks, $wgTitle, $wgArticle; $fname = 'SkinTemplate::buildNavUrls'; wfProfileIn( $fname ); global $wgUser, $wgRequest; global $wgEnableUploads, $wgUploadNavigationUrl; $action = $wgRequest->getText( 'action' ); $oldid = $wgRequest->getVal( 'oldid' ); $nav_urls = array(); $nav_urls['mainpage'] = array( 'href' => self::makeMainPageUrl() ); if( $wgEnableUploads ) { if ($wgUploadNavigationUrl) { $nav_urls['upload'] = array( 'href' => $wgUploadNavigationUrl ); } else { $nav_urls['upload'] = array( 'href' => self::makeSpecialUrl( 'Upload' ) ); } } else { if ($wgUploadNavigationUrl) $nav_urls['upload'] = array( 'href' => $wgUploadNavigationUrl ); else $nav_urls['upload'] = false; } $nav_urls['specialpages'] = array( 'href' => self::makeSpecialUrl( 'Specialpages' ) ); // default permalink to being off, will override it as required below. $nav_urls['permalink'] = false; // A print stylesheet is attached to all pages, but nobody ever // figures that out. :) Add a link... if( $this->iscontent && ($action == '' || $action == 'view' || $action == 'purge' ) ) { $revid = $wgArticle ? $wgArticle->getLatest() : 0; if ( !( $revid == 0 ) ) $nav_urls['print'] = array( 'text' => wfMsg( 'printableversion' ), 'href' => $wgRequest->appendQuery( 'printable=yes' ) ); // Also add a "permalink" while we're at it if ( (int)$oldid ) { $nav_urls['permalink'] = array( 'text' => wfMsg( 'permalink' ), 'href' => '' ); } else { if ( !( $revid == 0 ) ) $nav_urls['permalink'] = array( 'text' => wfMsg( 'permalink' ), 'href' => $wgTitle->getLocalURL( "oldid=$revid" ) ); } wfRunHooks( 'SkinTemplateBuildNavUrlsNav_urlsAfterPermalink', array( &$this, &$nav_urls, &$oldid, &$revid ) ); } if( $this->mTitle->getNamespace() != NS_SPECIAL ) { $wlhTitle = SpecialPage::getTitleFor( 'Whatlinkshere', $this->thispage ); $nav_urls['whatlinkshere'] = array( 'href' => $wlhTitle->getLocalUrl() ); if( $this->mTitle->getArticleId() ) { $rclTitle = SpecialPage::getTitleFor( 'Recentchangeslinked', $this->thispage ); $nav_urls['recentchangeslinked'] = array( 'href' => $rclTitle->getLocalUrl() ); } else { $nav_urls['recentchangeslinked'] = false; } if ($wgUseTrackbacks) $nav_urls['trackbacklink'] = array( 'href' => $wgTitle->trackbackURL() ); } if( $this->mTitle->getNamespace() == NS_USER || $this->mTitle->getNamespace() == NS_USER_TALK ) { $id = User::idFromName($this->mTitle->getText()); $ip = User::isIP($this->mTitle->getText()); } else { $id = 0; $ip = false; } if($id || $ip) { # both anons and non-anons have contri list $nav_urls['contributions'] = array( 'href' => self::makeSpecialUrlSubpage( 'Contributions', $this->mTitle->getText() ) ); if ( $wgUser->isAllowed( 'block' ) ) { $nav_urls['blockip'] = array( 'href' => self::makeSpecialUrlSubpage( 'Blockip', $this->mTitle->getText() ) ); } else { $nav_urls['blockip'] = false; } } else { $nav_urls['contributions'] = false; $nav_urls['blockip'] = false; } $nav_urls['emailuser'] = false; if( $this->showEmailUser( $id ) ) { $nav_urls['emailuser'] = array( 'href' => self::makeSpecialUrlSubpage( 'Emailuser', $this->mTitle->getText() ) ); } wfProfileOut( $fname ); return $nav_urls; } /** * Generate strings used for xml 'id' names * @return string * @private */ function getNameSpaceKey () { return $this->mTitle->getNamespaceKey(); } /** * @private */ function setupUserCss() { $fname = 'SkinTemplate::setupUserCss'; wfProfileIn( $fname ); global $wgRequest, $wgAllowUserCss, $wgUseSiteCss, $wgContLang, $wgSquidMaxage, $wgStylePath, $wgUser; $sitecss = ''; $usercss = ''; $siteargs = '&maxage=' . $wgSquidMaxage; if( $this->loggedin ) { // Ensure that logged-in users' generated CSS isn't clobbered // by anons' publicly cacheable generated CSS. $siteargs .= '&smaxage=0'; } # Add user-specific code if this is a user and we allow that kind of thing if ( $wgAllowUserCss && $this->loggedin ) { $action = $wgRequest->getText('action'); # if we're previewing the CSS page, use it if( $this->mTitle->isCssSubpage() and $this->userCanPreview( $action ) ) { $siteargs = "&smaxage=0&maxage=0"; $usercss = $wgRequest->getText('wpTextbox1'); } else { $usercss = '@import "' . self::makeUrl($this->userpage . '/'.$this->skinname.'.css', 'action=raw&ctype=text/css') . '";' ."\n"; } $siteargs .= '&ts=' . $wgUser->mTouched; } if( $wgContLang->isRTL() ) { global $wgStyleVersion; $sitecss .= "@import \"$wgStylePath/$this->stylename/rtl.css?$wgStyleVersion\";\n"; } # If we use the site's dynamic CSS, throw that in, too if ( $wgUseSiteCss ) { $query = "usemsgcache=yes&action=raw&ctype=text/css&smaxage=$wgSquidMaxage"; $sitecss .= '@import "' . self::makeNSUrl( 'Common.css', $query, NS_MEDIAWIKI) . '";' . "\n"; $sitecss .= '@import "' . self::makeNSUrl( ucfirst( $this->skinname ) . '.css', $query, NS_MEDIAWIKI ) . '";' . "\n"; $sitecss .= '@import "' . self::makeUrl( '-', 'action=raw&gen=css' . $siteargs ) . '";' . "\n"; } # If we use any dynamic CSS, make a little CDATA block out of it. if ( !empty($sitecss) || !empty($usercss) ) { $this->usercss = "/**/'; } wfProfileOut( $fname ); } /** * @private */ function setupUserJs() { $fname = 'SkinTemplate::setupUserJs'; wfProfileIn( $fname ); global $wgRequest, $wgAllowUserJs, $wgJsMimeType; $action = $wgRequest->getText('action'); if( $wgAllowUserJs && $this->loggedin ) { if( $this->mTitle->isJsSubpage() and $this->userCanPreview( $action ) ) { # XXX: additional security check/prompt? $this->userjsprev = '/*getText('wpTextbox1') . ' /*]]>*/'; } else { $this->userjs = self::makeUrl($this->userpage.'/'.$this->skinname.'.js', 'action=raw&ctype='.$wgJsMimeType.'&dontcountme=s'); } } wfProfileOut( $fname ); } /** * Code for extensions to hook into to provide per-page CSS, see * extensions/PageCSS/PageCSS.php for an implementation of this. * * @private */ function setupPageCss() { $fname = 'SkinTemplate::setupPageCss'; wfProfileIn( $fname ); $out = false; wfRunHooks( 'SkinTemplateSetupPageCss', array( &$out ) ); wfProfileOut( $fname ); return $out; } /** * returns css with user-specific options * @public */ function getUserStylesheet() { $fname = 'SkinTemplate::getUserStylesheet'; wfProfileIn( $fname ); $s = "/* generated user stylesheet */\n"; $s .= $this->reallyDoGetUserStyles(); wfProfileOut( $fname ); return $s; } /** * This returns MediaWiki:Common.js and MediaWiki:[Skinname].js concate- * nated together. For some bizarre reason, it does *not* return any * custom user JS from subpages. Huh? * * There's absolutely no reason to have separate Monobook/Common JSes. * Any JS that cares can just check the skin variable generated at the * top. For now Monobook.js will be maintained, but it should be consi- * dered deprecated. * * @return string */ public function getUserJs() { $fname = 'SkinTemplate::getUserJs'; wfProfileIn( $fname ); $s = parent::getUserJs(); $s .= "\n\n/* MediaWiki:".ucfirst($this->skinname).".js (deprecated; migrate to Common.js!) */\n"; // avoid inclusion of non defined user JavaScript (with custom skins only) // by checking for default message content $msgKey = ucfirst($this->skinname).'.js'; $userJS = wfMsgForContent($msgKey); if ( !wfEmptyMsg( $msgKey, $userJS ) ) { $s .= $userJS; } wfProfileOut( $fname ); return $s; } } /** * Generic wrapper for template functions, with interface * compatible with what we use of PHPTAL 0.7. * @package MediaWiki * @subpackage Skins */ class QuickTemplate { /** * @public */ function QuickTemplate() { $this->data = array(); $this->translator = new MediaWiki_I18N(); } /** * @public */ function set( $name, $value ) { $this->data[$name] = $value; } /** * @public */ function setRef($name, &$value) { $this->data[$name] =& $value; } /** * @public */ function setTranslator( &$t ) { $this->translator = &$t; } /** * @public */ function execute() { echo "Override this function."; } /** * @private */ function text( $str ) { echo htmlspecialchars( $this->data[$str] ); } /** * @private */ function jstext( $str ) { echo Xml::escapeJsString( $this->data[$str] ); } /** * @private */ function html( $str ) { echo $this->data[$str]; } /** * @private */ function msg( $str ) { echo htmlspecialchars( $this->translator->translate( $str ) ); } /** * @private */ function msgHtml( $str ) { echo $this->translator->translate( $str ); } /** * An ugly, ugly hack. * @private */ function msgWiki( $str ) { global $wgParser, $wgTitle, $wgOut; $text = $this->translator->translate( $str ); $parserOutput = $wgParser->parse( $text, $wgTitle, $wgOut->parserOptions(), true ); echo $parserOutput->getText(); } /** * @private */ function haveData( $str ) { return isset( $this->data[$str] ); } /** * @private */ function haveMsg( $str ) { $msg = $this->translator->translate( $str ); return ($msg != '-') && ($msg != ''); # ???? } } ?>