/**
* See title.txt
*
- * @package MediaWiki
*/
/** */
-require_once( 'normal/UtfNormal.php' );
+if ( !class_exists( 'UtfNormal' ) ) {
+ require_once( dirname(__FILE__) . '/normal/UtfNormal.php' );
+}
define ( 'GAID_FOR_UPDATE', 1 );
# reset the cache.
define( 'MW_TITLECACHE_MAX', 1000 );
+# Constants for pr_cascade bitfield
+define( 'CASCADE', 1 );
+
/**
* Title class
* - Represents a title, which may contain an interwiki designation or namespace
* - Can fetch various kinds of data from the database, albeit inefficiently.
*
- * @package MediaWiki
*/
class Title {
/**
* Please use the accessor functions
*/
- /**#@+
+ /**#@+
* @private
*/
- var $mTextform; # Text form (spaces not underscores) of the main part
- var $mUrlform; # URL-encoded form of the main part
- var $mDbkeyform; # Main part with underscores
- var $mNamespace; # Namespace index, i.e. one of the NS_xxxx constants
- var $mInterwiki; # Interwiki prefix (or null string)
- var $mFragment; # Title fragment (i.e. the bit after the #)
- var $mArticleID; # Article ID, fetched from the link cache on demand
- var $mLatestID; # ID of most recent revision
- var $mRestrictions; # Array of groups allowed to edit this article
- # Only null or "sysop" are supported
- var $mRestrictionsLoaded; # Boolean for initialisation on demand
- var $mPrefixedText; # Text form including namespace/interwiki, initialised on demand
- var $mDefaultNamespace; # Namespace index when there is no namespace
- # Zero except in {{transclusion}} tags
- var $mWatched; # Is $wgUser watching this page? NULL if unfilled, accessed through userIsWatching()
+ var $mTextform; # Text form (spaces not underscores) of the main part
+ var $mUrlform; # URL-encoded form of the main part
+ var $mDbkeyform; # Main part with underscores
+ var $mUserCaseDBKey; # DB key with the initial letter in the case specified by the user
+ var $mNamespace; # Namespace index, i.e. one of the NS_xxxx constants
+ var $mInterwiki; # Interwiki prefix (or null string)
+ var $mFragment; # Title fragment (i.e. the bit after the #)
+ var $mArticleID; # Article ID, fetched from the link cache on demand
+ var $mLatestID; # ID of most recent revision
+ var $mRestrictions; # Array of groups allowed to edit this article
+ var $mCascadeRestriction; # Cascade restrictions on this page to included templates and images?
+ var $mRestrictionsExpiry; # When do the restrictions on this page expire?
+ var $mHasCascadingRestrictions; # Are cascading restrictions in effect on this page?
+ var $mCascadeRestrictionSources;# Where are the cascading restrictions coming from on this page?
+ var $mRestrictionsLoaded; # Boolean for initialisation on demand
+ var $mPrefixedText; # Text form including namespace/interwiki, initialised on demand
+ var $mDefaultNamespace; # Namespace index when there is no namespace
+ # Zero except in {{transclusion}} tags
+ var $mWatched; # Is $wgUser watching this page? NULL if unfilled, accessed through userIsWatching()
/**#@-*/
* Constructor
* @private
*/
- /* private */ function Title() {
+ /* private */ function __construct() {
$this->mInterwiki = $this->mUrlform =
$this->mTextform = $this->mDbkeyform = '';
$this->mArticleID = -1;
$this->mDefaultNamespace = NS_MAIN;
$this->mWatched = NULL;
$this->mLatestID = false;
+ $this->mOldRestrictions = false;
}
/**
* instead of spaces, possibly including namespace and
* interwiki prefixes
* @return Title the new object, or NULL on an error
- * @static
- * @access public
*/
- /* static */ function newFromDBkey( $key ) {
+ public static function newFromDBkey( $key ) {
$t = new Title();
$t->mDbkeyform = $key;
if( $t->secureAndSplit() )
* @param int $defaultNamespace the namespace to use if
* none is specified by a prefix
* @return Title the new object, or NULL on an error
- * @static
- * @access public
*/
public static function newFromText( $text, $defaultNamespace = NS_MAIN ) {
if( is_object( $text ) ) {
* the given title's length does not exceed the maximum.
* @param string $url the title, as might be taken from a URL
* @return Title the new object, or NULL on an error
- * @static
- * @access public
*/
public static function newFromURL( $url ) {
global $wgLegalTitleChars;
*
* @param int $id the page_id corresponding to the Title to create
* @return Title the new object, or NULL on an error
- * @access public
- * @static
*/
- function newFromID( $id ) {
+ public static function newFromID( $id ) {
$fname = 'Title::newFromID';
- $dbr =& wfGetDB( DB_SLAVE );
+ $dbr = wfGetDB( DB_SLAVE );
$row = $dbr->selectRow( 'page', array( 'page_namespace', 'page_title' ),
array( 'page_id' => $id ), $fname );
if ( $row !== false ) {
/**
* Make an array of titles from an array of IDs
*/
- function newFromIDs( $ids ) {
- $dbr =& wfGetDB( DB_SLAVE );
+ public static function newFromIDs( $ids ) {
+ $dbr = wfGetDB( DB_SLAVE );
$res = $dbr->select( 'page', array( 'page_namespace', 'page_title' ),
'page_id IN (' . $dbr->makeList( $ids ) . ')', __METHOD__ );
* @param int $ns the namespace of the article
* @param string $title the unprefixed database key form
* @return Title the new object
- * @static
- * @access public
*/
public static function &makeTitle( $ns, $title ) {
$t = new Title();
$t->mInterwiki = '';
$t->mFragment = '';
- $t->mNamespace = intval( $ns );
+ $t->mNamespace = $ns = intval( $ns );
$t->mDbkeyform = str_replace( ' ', '_', $title );
$t->mArticleID = ( $ns >= 0 ) ? -1 : 0;
$t->mUrlform = wfUrlencode( $t->mDbkeyform );
* @param int $ns the namespace of the article
* @param string $title the database key form
* @return Title the new object, or NULL on an error
- * @static
- * @access public
*/
public static function makeTitleSafe( $ns, $title ) {
$t = new Title();
/**
* Create a new Title for the Main Page
- *
- * @static
* @return Title the new object
- * @access public
*/
public static function newMainPage() {
return Title::newFromText( wfMsgForContent( 'mainpage' ) );
}
/**
- * Create a new Title for a redirect
- * @param string $text the redirect title text
- * @return Title the new object, or NULL if the text is not a
- * valid redirect
- * @static
- * @access public
+ * Extract a redirect destination from a string and return the
+ * Title, or null if the text doesn't contain a valid redirect
+ *
+ * @param string $text Text with possible redirect
+ * @return Title
*/
public static function newFromRedirect( $text ) {
- $mwRedir = MagicWord::get( 'redirect' );
- $rt = NULL;
- if ( $mwRedir->matchStart( $text ) ) {
+ $redir = MagicWord::get( 'redirect' );
+ if( $redir->matchStart( $text ) ) {
+ // Extract the first link and see if it's usable
$m = array();
- if ( preg_match( '/\[{2}(.*?)(?:\||\]{2})/', $text, $m ) ) {
- # categories are escaped using : for example one can enter:
- # #REDIRECT [[:Category:Music]]. Need to remove it.
- if ( substr($m[1],0,1) == ':') {
- # We don't want to keep the ':'
- $m[1] = substr( $m[1], 1 );
- }
-
- $rt = Title::newFromText( $m[1] );
- # Disallow redirects to Special:Userlogout
- if ( !is_null($rt) && $rt->isSpecial( 'Userlogout' ) ) {
- $rt = NULL;
+ if( preg_match( '!\[{2}(.*?)(?:\||\]{2})!', $text, $m ) ) {
+ // Strip preceding colon used to "escape" categories, etc.
+ // and URL-decode links
+ if( strpos( $m[1], '%' ) !== false ) {
+ // Match behavior of inline link parsing here;
+ // don't interpret + as " " most of the time!
+ // It might be safe to just use rawurldecode instead, though.
+ $m[1] = urldecode( ltrim( $m[1], ':' ) );
}
+ $title = Title::newFromText( $m[1] );
+ // Redirects to Special:Userlogout are not permitted
+ if( $title instanceof Title && !$title->isSpecial( 'Userlogout' ) )
+ return $title;
}
}
- return $rt;
+ return null;
}
#----------------------------------------------------------------------------
*/
function nameOf( $id ) {
$fname = 'Title::nameOf';
- $dbr =& wfGetDB( DB_SLAVE );
+ $dbr = wfGetDB( DB_SLAVE );
$s = $dbr->selectRow( 'page', array( 'page_namespace','page_title' ), array( 'page_id' => $id ), $fname );
if ( $s === false ) { return NULL; }
/**
* Get a regex character class describing the legal characters in a link
* @return string the list of characters, not delimited
- * @static
- * @access public
*/
public static function legalChars() {
global $wgLegalTitleChars;
* @return string a stripped-down title string ready for the
* search index
*/
- /* static */ function indexTitle( $ns, $title ) {
+ public static function indexTitle( $ns, $title ) {
global $wgContLang;
$lc = SearchEngine::legalSearchChars() . '&#;';
* @return the associated URL, containing "$1", which should be
* replaced by an article title
* @static (arguably)
- * @access public
*/
- function getInterwikiLink( $key ) {
+ public function getInterwikiLink( $key ) {
global $wgMemc, $wgInterwikiExpiry;
global $wgInterwikiCache, $wgContLang;
$fname = 'Title::getInterwikiLink';
return $s->iw_url;
}
- $dbr =& wfGetDB( DB_SLAVE );
+ $dbr = wfGetDB( DB_SLAVE );
$res = $dbr->select( 'interwiki',
array( 'iw_url', 'iw_local', 'iw_trans' ),
array( 'iw_prefix' => $key ), $fname );
* More logic is explained in DefaultSettings
*
* @return string URL of interwiki site
- * @access public
*/
- function getInterwikiCached( $key ) {
+ public static function getInterwikiCached( $key ) {
global $wgInterwikiCache, $wgInterwikiScopes, $wgInterwikiFallbackSite;
static $db, $site;
*
* @return bool TRUE if this is an in-project interwiki link
* or a wikilink, FALSE otherwise
- * @access public
*/
- function isLocal() {
+ public function isLocal() {
if ( $this->mInterwiki != '' ) {
# Make sure key is loaded into cache
$this->getInterwikiLink( $this->mInterwiki );
* this project and is transcludable.
*
* @return bool TRUE if this is transcludable
- * @access public
*/
- function isTrans() {
+ public function isTrans() {
if ($this->mInterwiki == '')
return false;
# Make sure key is loaded into cache
return (bool)(Title::$interwikiCache[$k]->iw_trans);
}
- /**
- * Update the page_touched field for an array of title objects
- * @todo Inefficient unless the IDs are already loaded into the
- * link cache
- * @param array $titles an array of Title objects to be touched
- * @param string $timestamp the timestamp to use instead of the
- * default current time
- * @static
- * @access public
- */
- function touchArray( $titles, $timestamp = '' ) {
-
- if ( count( $titles ) == 0 ) {
- return;
- }
- $dbw =& wfGetDB( DB_MASTER );
- if ( $timestamp == '' ) {
- $timestamp = $dbw->timestamp();
- }
- /*
- $page = $dbw->tableName( 'page' );
- $sql = "UPDATE $page SET page_touched='{$timestamp}' WHERE page_id IN (";
- $first = true;
-
- foreach ( $titles as $title ) {
- if ( $wgUseFileCache ) {
- $cm = new HTMLFileCache($title);
- @unlink($cm->fileCacheName());
- }
-
- if ( ! $first ) {
- $sql .= ',';
- }
- $first = false;
- $sql .= $title->getArticleID();
- }
- $sql .= ')';
- if ( ! $first ) {
- $dbw->query( $sql, 'Title::touchArray' );
- }
- */
- // hack hack hack -- brion 2005-07-11. this was unfriendly to db.
- // do them in small chunks:
- $fname = 'Title::touchArray';
- foreach( $titles as $title ) {
- $dbw->update( 'page',
- array( 'page_touched' => $timestamp ),
- array(
- 'page_namespace' => $title->getNamespace(),
- 'page_title' => $title->getDBkey() ),
- $fname );
- }
- }
-
/**
* Escape a text fragment, say from a link, for a URL
*/
/**
* Get the text form (spaces not underscores) of the main part
* @return string
- * @access public
*/
- function getText() { return $this->mTextform; }
+ public function getText() { return $this->mTextform; }
/**
* Get the URL-encoded form of the main part
* @return string
- * @access public
*/
- function getPartialURL() { return $this->mUrlform; }
+ public function getPartialURL() { return $this->mUrlform; }
/**
* Get the main part with underscores
* @return string
- * @access public
*/
- function getDBkey() { return $this->mDbkeyform; }
+ public function getDBkey() { return $this->mDbkeyform; }
/**
* Get the namespace index, i.e. one of the NS_xxxx constants
* @return int
- * @access public
*/
- function getNamespace() { return $this->mNamespace; }
+ public function getNamespace() { return $this->mNamespace; }
/**
* Get the namespace text
* @return string
- * @access public
*/
- function getNsText() {
- global $wgContLang;
+ public function getNsText() {
+ global $wgContLang, $wgCanonicalNamespaceNames;
+
+ if ( '' != $this->mInterwiki ) {
+ // This probably shouldn't even happen. ohh man, oh yuck.
+ // But for interwiki transclusion it sometimes does.
+ // Shit. Shit shit shit.
+ //
+ // Use the canonical namespaces if possible to try to
+ // resolve a foreign namespace.
+ if( isset( $wgCanonicalNamespaceNames[$this->mNamespace] ) ) {
+ return $wgCanonicalNamespaceNames[$this->mNamespace];
+ }
+ }
return $wgContLang->getNsText( $this->mNamespace );
}
+ /**
+ * Get the DB key with the initial letter case as specified by the user
+ */
+ function getUserCaseDBKey() {
+ return $this->mUserCaseDBKey;
+ }
/**
* Get the namespace text of the subject (rather than talk) page
* @return string
- * @access public
*/
- function getSubjectNsText() {
+ public function getSubjectNsText() {
global $wgContLang;
return $wgContLang->getNsText( Namespace::getSubject( $this->mNamespace ) );
}
* Get the namespace text of the talk page
* @return string
*/
- function getTalkNsText() {
+ public function getTalkNsText() {
global $wgContLang;
return( $wgContLang->getNsText( Namespace::getTalk( $this->mNamespace ) ) );
}
-
+
/**
* Could this title have a corresponding talk page?
* @return bool
*/
- function canTalk() {
+ public function canTalk() {
return( Namespace::canTalk( $this->mNamespace ) );
}
-
+
/**
* Get the interwiki prefix (or null string)
* @return string
- * @access public
*/
- function getInterwiki() { return $this->mInterwiki; }
+ public function getInterwiki() { return $this->mInterwiki; }
/**
* Get the Title fragment (i.e. the bit after the #) in text form
* @return string
- * @access public
*/
- function getFragment() { return $this->mFragment; }
+ public function getFragment() { return $this->mFragment; }
/**
* Get the fragment in URL form, including the "#" character if there is one
- *
* @return string
- * @access public
*/
- function getFragmentForURL() {
+ public function getFragmentForURL() {
if ( $this->mFragment == '' ) {
return '';
} else {
/**
* Get the default namespace index, for when there is no namespace
* @return int
- * @access public
*/
- function getDefaultNamespace() { return $this->mDefaultNamespace; }
+ public function getDefaultNamespace() { return $this->mDefaultNamespace; }
/**
* Get title for search index
* @return string a stripped-down title string ready for the
* search index
*/
- function getIndexTitle() {
+ public function getIndexTitle() {
return Title::indexTitle( $this->mNamespace, $this->mTextform );
}
* Get the prefixed database key form
* @return string the prefixed title, with underscores and
* any interwiki and namespace prefixes
- * @access public
*/
- function getPrefixedDBkey() {
+ public function getPrefixedDBkey() {
$s = $this->prefix( $this->mDbkeyform );
$s = str_replace( ' ', '_', $s );
return $s;
* Get the prefixed title with spaces.
* This is the form usually used for display
* @return string the prefixed title, with spaces
- * @access public
*/
- function getPrefixedText() {
+ public function getPrefixedText() {
if ( empty( $this->mPrefixedText ) ) { // FIXME: bad usage of empty() ?
$s = $this->prefix( $this->mTextform );
$s = str_replace( '_', ' ', $s );
* (part beginning with '#')
* @return string the prefixed title, with spaces and
* the fragment, including '#'
- * @access public
*/
- function getFullText() {
+ public function getFullText() {
$text = $this->getPrefixedText();
if( '' != $this->mFragment ) {
$text .= '#' . $this->mFragment;
* Get the base name, i.e. the leftmost parts before the /
* @return string Base name
*/
- function getBaseText() {
+ public function getBaseText() {
global $wgNamespacesWithSubpages;
if( isset( $wgNamespacesWithSubpages[ $this->mNamespace ] ) && $wgNamespacesWithSubpages[ $this->mNamespace ] ) {
$parts = explode( '/', $this->getText() );
* Get the lowest-level subpage name, i.e. the rightmost part after /
* @return string Subpage name
*/
- function getSubpageText() {
+ public function getSubpageText() {
global $wgNamespacesWithSubpages;
if( isset( $wgNamespacesWithSubpages[ $this->mNamespace ] ) && $wgNamespacesWithSubpages[ $this->mNamespace ] ) {
$parts = explode( '/', $this->mTextform );
return( $this->mTextform );
}
}
-
+
/**
* Get a URL-encoded form of the subpage text
* @return string URL-encoded subpage name
*/
- function getSubpageUrlForm() {
+ public function getSubpageUrlForm() {
$text = $this->getSubpageText();
$text = wfUrlencode( str_replace( ' ', '_', $text ) );
$text = str_replace( '%28', '(', str_replace( '%29', ')', $text ) ); # Clean up the URL; per below, this might not be safe
/**
* Get a URL-encoded title (not an actual URL) including interwiki
* @return string the URL-encoded form
- * @access public
*/
- function getPrefixedURL() {
+ public function getPrefixedURL() {
$s = $this->prefix( $this->mDbkeyform );
$s = str_replace( ' ', '_', $s );
* for interwiki links
* @param string $variant language variant of url (for sr, zh..)
* @return string the URL
- * @access public
*/
- function getFullURL( $query = '', $variant = false ) {
+ public function getFullURL( $query = '', $variant = false ) {
global $wgContLang, $wgServer, $wgRequest;
if ( '' == $this->mInterwiki ) {
} else {
$baseUrl = $this->getInterwikiLink( $this->mInterwiki );
- $namespace = $wgContLang->getNsText( $this->mNamespace );
+ $namespace = wfUrlencode( $this->getNsText() );
if ( '' != $namespace ) {
# Can this actually happen? Interwikis shouldn't be parsed.
+ # Yes! It can in interwiki transclusion. But... it probably shouldn't.
$namespace .= ':';
}
$url = str_replace( '$1', $namespace . $this->mUrlform, $baseUrl );
- if( $query != '' ) {
- if( false === strpos( $url, '?' ) ) {
- $url .= '?';
- } else {
- $url .= '&';
- }
- $url .= $query;
- }
+ $url = wfAppendQuery( $url, $query );
}
# Finally, add the fragment.
* $wgArticlePath will be used.
* @param string $variant language variant of url (for sr, zh..)
* @return string the URL
- * @access public
*/
- function getLocalURL( $query = '', $variant = false ) {
+ public function getLocalURL( $query = '', $variant = false ) {
global $wgArticlePath, $wgScript, $wgServer, $wgRequest;
global $wgVariantArticlePath, $wgContLang, $wgUser;
$dbkey = wfUrlencode( $this->getPrefixedDBkey() );
if ( $query == '' ) {
if($variant!=false && $wgContLang->hasVariants()){
- if($wgVariantArticlePath==false)
+ if($wgVariantArticlePath==false) {
$variantArticlePath = "$wgScript?title=$1&variant=$2"; // default
- else
+ } else {
$variantArticlePath = $wgVariantArticlePath;
-
+ }
$url = str_replace( '$2', urlencode( $variant ), $variantArticlePath );
$url = str_replace( '$1', $dbkey, $url );
-
}
- else
+ else {
$url = str_replace( '$1', $dbkey, $wgArticlePath );
+ }
} else {
global $wgActionPaths;
$url = false;
* using in a link, without a server name or fragment
* @param string $query an optional query string
* @return string the URL
- * @access public
*/
- function escapeLocalURL( $query = '' ) {
+ public function escapeLocalURL( $query = '' ) {
return htmlspecialchars( $this->getLocalURL( $query ) );
}
*
* @return string the URL
* @param string $query an optional query string
- * @access public
*/
- function escapeFullURL( $query = '' ) {
+ public function escapeFullURL( $query = '' ) {
return htmlspecialchars( $this->getFullURL( $query ) );
}
* @param string $query an optional query string
* @param string $variant language variant of url (for sr, zh..)
* @return string the URL
- * @access public
*/
- function getInternalURL( $query = '', $variant = false ) {
+ public function getInternalURL( $query = '', $variant = false ) {
global $wgInternalServer;
$url = $wgInternalServer . $this->getLocalURL( $query, $variant );
wfRunHooks( 'GetInternalURL', array( &$this, &$url, $query ) );
* Get the edit URL for this Title
* @return string the URL, or a null string if this is an
* interwiki link
- * @access public
*/
- function getEditURL() {
+ public function getEditURL() {
if ( '' != $this->mInterwiki ) { return ''; }
$s = $this->getLocalURL( 'action=edit' );
* Get the HTML-escaped displayable text form.
* Used for the title field in <a> tags.
* @return string the text, including any prefixes
- * @access public
*/
- function getEscapedText() {
+ public function getEscapedText() {
return htmlspecialchars( $this->getPrefixedText() );
}
/**
* Is this Title interwiki?
* @return boolean
- * @access public
*/
- function isExternal() { return ( '' != $this->mInterwiki ); }
+ public function isExternal() { return ( '' != $this->mInterwiki ); }
/**
* Is this page "semi-protected" - the *only* protection is autoconfirm?
* @param string Action to check (default: edit)
* @return bool
*/
- function isSemiProtected( $action = 'edit' ) {
- $restrictions = $this->getRestrictions( $action );
- # We do a full compare because this could be an array
- foreach( $restrictions as $restriction ) {
- if( strtolower( $restriction ) != 'autoconfirmed' ) {
- return( false );
+ public function isSemiProtected( $action = 'edit' ) {
+ if( $this->exists() ) {
+ $restrictions = $this->getRestrictions( $action );
+ if( count( $restrictions ) > 0 ) {
+ foreach( $restrictions as $restriction ) {
+ if( strtolower( $restriction ) != 'autoconfirmed' )
+ return false;
+ }
+ } else {
+ # Not protected
+ return false;
}
+ return true;
+ } else {
+ # If it doesn't exist, it can't be protected
+ return false;
}
- return( true );
}
/**
* @param string $what the action the page is protected from,
* by default checks move and edit
* @return boolean
- * @access public
*/
- function isProtected( $action = '' ) {
+ public function isProtected( $action = '' ) {
global $wgRestrictionLevels;
- if ( NS_SPECIAL == $this->mNamespace ) { return true; }
-
+
+ # Special pages have inherent protection
+ if( $this->getNamespace() == NS_SPECIAL )
+ return true;
+
+ # Check regular protection levels
if( $action == 'edit' || $action == '' ) {
$r = $this->getRestrictions( 'edit' );
foreach( $wgRestrictionLevels as $level ) {
/**
* Is $wgUser is watching this page?
* @return boolean
- * @access public
*/
- function userIsWatching() {
+ public function userIsWatching() {
global $wgUser;
if ( is_null( $this->mWatched ) ) {
}
/**
- * Can $wgUser perform $action this page?
+ * Can $wgUser perform $action on this page?
+ * This skips potentially expensive cascading permission checks.
+ *
+ * Suitable for use for nonessential UI controls in common cases, but
+ * _not_ for functional access control.
+ *
+ * May provide false positives, but should never provide a false negative.
+ *
* @param string $action action that permission needs to be checked for
* @return boolean
- * @private
*/
- function userCan($action) {
+ public function quickUserCan( $action ) {
+ return $this->userCan( $action, false );
+ }
+
+ /**
+ * Determines if $wgUser is unable to edit this page because it has been protected
+ * by $wgNamespaceProtection.
+ *
+ * @return boolean
+ */
+ public function isNamespaceProtected() {
+ global $wgNamespaceProtection, $wgUser;
+ if( isset( $wgNamespaceProtection[ $this->mNamespace ] ) ) {
+ foreach( (array)$wgNamespaceProtection[ $this->mNamespace ] as $right ) {
+ if( $right != '' && !$wgUser->isAllowed( $right ) )
+ return true;
+ }
+ }
+ return false;
+ }
+
+ /**
+ * Can $wgUser perform $action on this page?
+ * @param string $action action that permission needs to be checked for
+ * @param bool $doExpensiveQueries Set this to false to avoid doing unnecessary queries.
+ * @return boolean
+ */
+ public function userCan( $action, $doExpensiveQueries = true ) {
+ global $wgUser;
+ return ( $this->getUserPermissionsErrorsInternal( $action, $wgUser, $doExpensiveQueries ) === array());
+ }
+
+ /**
+ * Can $user perform $action on this page?
+ * @param string $action action that permission needs to be checked for
+ * @param bool $doExpensiveQueries Set this to false to avoid doing unnecessary queries.
+ * @return array Array of arrays of the arguments to wfMsg to explain permissions problems.
+ */
+ public function getUserPermissionsErrors( $action, $user, $doExpensiveQueries = true ) {
+ $errors = $this->getUserPermissionsErrorsInternal( $action, $user, $doExpensiveQueries );
+
+ global $wgContLang;
+ global $wgLang;
+
+ if ( wfReadOnly() && $action != 'read' ) {
+ global $wgReadOnly;
+ $errors[] = array( 'readonlytext', $wgReadOnly );
+ }
+
+ global $wgEmailConfirmToEdit, $wgUser;
+
+ if ( $wgEmailConfirmToEdit && !$wgUser->isEmailConfirmed() )
+ {
+ $errors[] = array( 'confirmedittext' );
+ }
+
+ if ( $user->isBlockedFrom( $this ) ) {
+ $block = $user->mBlock;
+
+ // This is from OutputPage::blockedPage
+ // Copied at r23888 by werdna
+
+ $id = $user->blockedBy();
+ $reason = $user->blockedFor();
+ $ip = wfGetIP();
+
+ if ( is_numeric( $id ) ) {
+ $name = User::whoIs( $id );
+ } else {
+ $name = $id;
+ }
+
+ $link = '[[' . $wgContLang->getNsText( NS_USER ) . ":{$name}|{$name}]]";
+ $blockid = $block->mId;
+ $blockExpiry = $user->mBlock->mExpiry;
+ $blockTimestamp = $wgLang->timeanddate( wfTimestamp( TS_MW, $wgUser->mBlock->mTimestamp ), true );
+
+ if ( $blockExpiry == 'infinity' ) {
+ // Entry in database (table ipblocks) is 'infinity' but 'ipboptions' uses 'infinite' or 'indefinite'
+ $scBlockExpiryOptions = wfMsg( 'ipboptions' );
+
+ foreach ( explode( ',', $scBlockExpiryOptions ) as $option ) {
+ if ( strpos( $option, ':' ) == false )
+ continue;
+
+ list ($show, $value) = explode( ":", $option );
+
+ if ( $value == 'infinite' || $value == 'indefinite' ) {
+ $blockExpiry = $show;
+ break;
+ }
+ }
+ } else {
+ $blockExpiry = $wgLang->timeanddate( wfTimestamp( TS_MW, $blockExpiry ), true );
+ }
+
+ $intended = $user->mBlock->mAddress;
+
+ $errors[] = array ( ($block->mAuto ? 'autoblockedtext' : 'blockedtext'), $link, $reason, $ip, $name, $blockid, $blockExpiry, $intended, $blockTimestamp );
+ }
+
+ return $errors;
+ }
+
+ /**
+ * Can $user perform $action on this page?
+ * This is an internal function, which checks ONLY that previously checked by userCan (i.e. it leaves out checks on wfReadOnly() and blocks)
+ * @param string $action action that permission needs to be checked for
+ * @param bool $doExpensiveQueries Set this to false to avoid doing unnecessary queries.
+ * @return array Array of arrays of the arguments to wfMsg to explain permissions problems.
+ */
+ private function getUserPermissionsErrorsInternal( $action, $user, $doExpensiveQueries = true ) {
$fname = 'Title::userCan';
wfProfileIn( $fname );
- global $wgUser;
+ $errors = array();
- $result = null;
- wfRunHooks( 'userCan', array( &$this, &$wgUser, $action, &$result ) );
- if ( $result !== null ) {
- wfProfileOut( $fname );
- return $result;
+ if ( !wfRunHooks( 'userCan', array( &$this, &$user, $action, &$result ) ) ) {
+ return $result ? array() : array( array( 'badaccess-group0' ) );
}
if( NS_SPECIAL == $this->mNamespace ) {
- wfProfileOut( $fname );
- return false;
+ $errors[] = array('ns-specialprotected');
}
- // XXX: This is the code that prevents unprotecting a page in NS_MEDIAWIKI
- // from taking effect -ævar
- if( NS_MEDIAWIKI == $this->mNamespace &&
- !$wgUser->isAllowed('editinterface') ) {
- wfProfileOut( $fname );
- return false;
+
+ if ( $this->isNamespaceProtected() ) {
+ $ns = $this->getNamespace() == NS_MAIN
+ ? wfMsg( 'nstab-main' )
+ : $this->getNsText();
+ $errors[] = (NS_MEDIAWIKI == $this->mNamespace
+ ? array('protectedinterface')
+ : array( 'namespaceprotected', $ns ) );
}
if( $this->mDbkeyform == '_' ) {
# FIXME: Is this necessary? Shouldn't be allowed anyway...
- wfProfileOut( $fname );
- return false;
+ $errors[] = array('badaccess-group0');
}
# protect css/js subpages of user pages
# XXX: this might be better using restrictions
# XXX: Find a way to work around the php bug that prevents using $this->userCanEditCssJsSubpage() from working
if( $this->isCssJsSubpage()
- && !$wgUser->isAllowed('editinterface')
- && !preg_match('/^'.preg_quote($wgUser->getName(), '/').'\//', $this->mTextform) ) {
- wfProfileOut( $fname );
- return false;
+ && !$user->isAllowed('editinterface')
+ && !preg_match('/^'.preg_quote($user->getName(), '/').'\//', $this->mTextform) ) {
+ $errors[] = array('customcssjsprotected');
}
-
+
+ if ( $doExpensiveQueries && !$this->isCssJsSubpage() ) {
+ # We /could/ use the protection level on the source page, but it's fairly ugly
+ # as we have to establish a precedence hierarchy for pages included by multiple
+ # cascade-protected pages. So just restrict it to people with 'protect' permission,
+ # as they could remove the protection anyway.
+ list( $cascadingSources, $restrictions ) = $this->getCascadeProtectionSources();
+ # Cascading protection depends on more than this page...
+ # Several cascading protected pages may include this page...
+ # Check each cascading level
+ # This is only for protection restrictions, not for all actions
+ if( $cascadingSources > 0 && isset($restrictions[$action]) ) {
+ foreach( $restrictions[$action] as $right ) {
+ $right = ( $right == 'sysop' ) ? 'protect' : $right;
+ if( '' != $right && !$user->isAllowed( $right ) ) {
+ $pages = '';
+ foreach( $cascadingSources as $page )
+ $pages .= '* [[:' . $page->getPrefixedText() . "]]\n";
+ $errors[] = array( 'cascadeprotected', count( $cascadingSources ), $pages );
+ }
+ }
+ }
+ }
+
foreach( $this->getRestrictions($action) as $right ) {
// Backwards compatibility, rewrite sysop -> protect
if ( $right == 'sysop' ) {
$right = 'protect';
}
- if( '' != $right && !$wgUser->isAllowed( $right ) ) {
- wfProfileOut( $fname );
- return false;
+ if( '' != $right && !$user->isAllowed( $right ) ) {
+ $errors[] = array( 'protectedpagetext' );
}
}
- if( $action == 'move' &&
- !( $this->isMovable() && $wgUser->isAllowed( 'move' ) ) ) {
- wfProfileOut( $fname );
- return false;
- }
-
if( $action == 'create' ) {
- if( ( $this->isTalkPage() && !$wgUser->isAllowed( 'createtalk' ) ) ||
- ( !$this->isTalkPage() && !$wgUser->isAllowed( 'createpage' ) ) ) {
- wfProfileOut( $fname );
- return false;
+ if( ( $this->isTalkPage() && !$user->isAllowed( 'createtalk' ) ) ||
+ ( !$this->isTalkPage() && !$user->isAllowed( 'createpage' ) ) ) {
+ $errors[] = $user->isAnon() ? array ('nocreatetext') : array ('nocreate-loggedin');
}
+ } elseif( $action == 'move' &&
+ !( $this->isMovable() && $user->isAllowed( 'move' ) ) ) {
+ $errors[] = $user->isAnon() ? array ( 'movenologintext' ) : array ('movenotallowed');
+ } else if ( !$user->isAllowed( $action ) ) {
+ $return = null;
+ $groups = array();
+ global $wgGroupPermissions;
+ foreach( $wgGroupPermissions as $key => $value ) {
+ if( isset( $value[$action] ) && $value[$action] == true ) {
+ $groupName = User::getGroupName( $key );
+ $groupPage = User::getGroupPage( $key );
+ if( $groupPage ) {
+ $skin = $user->getSkin();
+ $groups[] = $skin->makeLinkObj( $groupPage, $groupName );
+ } else {
+ $groups[] = $groupName;
+ }
+ }
+ }
+ $n = count( $groups );
+ $groups = implode( ', ', $groups );
+ switch( $n ) {
+ case 0:
+ case 1:
+ case 2:
+ $return = array( "badaccess-group$n", $groups );
+ break;
+ default:
+ $return = array( 'badaccess-groups', $groups );
+ }
+ $errors[] = $return;
}
wfProfileOut( $fname );
- return true;
+ return $errors;
}
/**
* Can $wgUser edit this page?
* @return boolean
- * @access public
+ * @deprecated use userCan('edit')
*/
- function userCanEdit() {
- return $this->userCan('edit');
+ public function userCanEdit( $doExpensiveQueries = true ) {
+ return $this->userCan( 'edit', $doExpensiveQueries );
}
/**
* Can $wgUser create this page?
* @return boolean
- * @access public
+ * @deprecated use userCan('create')
*/
- function userCanCreate() {
- return $this->userCan('create');
+ public function userCanCreate( $doExpensiveQueries = true ) {
+ return $this->userCan( 'create', $doExpensiveQueries );
}
/**
* Can $wgUser move this page?
* @return boolean
- * @access public
+ * @deprecated use userCan('move')
*/
- function userCanMove() {
- return $this->userCan('move');
+ public function userCanMove( $doExpensiveQueries = true ) {
+ return $this->userCan( 'move', $doExpensiveQueries );
}
/**
* Some pages just aren't movable.
*
* @return boolean
- * @access public
*/
- function isMovable() {
+ public function isMovable() {
return Namespace::isMovable( $this->getNamespace() )
&& $this->getInterwiki() == '';
}
/**
* Can $wgUser read this page?
* @return boolean
- * @access public
+ * @todo fold these checks into userCan()
*/
- function userCanRead() {
+ public function userCanRead() {
global $wgUser;
$result = null;
return $result;
}
- if( $wgUser->isAllowed('read') ) {
+ if( $wgUser->isAllowed( 'read' ) ) {
return true;
} else {
global $wgWhitelistRead;
* Always grant access to the login page.
* Even anons need to be able to log in.
*/
- if( $this->isSpecial( 'Userlogin' ) ) {
+ if( $this->isSpecial( 'Userlogin' ) || $this->isSpecial( 'Resetpass' ) ) {
return true;
}
-
- /** some pages are explicitly allowed */
+
+ /**
+ * Check for explicit whitelisting
+ */
$name = $this->getPrefixedText();
- if( $wgWhitelistRead && in_array( $name, $wgWhitelistRead ) ) {
+ if( $wgWhitelistRead && in_array( $name, $wgWhitelistRead, true ) )
return true;
- }
-
- # Compatibility with old settings
+
+ /**
+ * Old settings might have the title prefixed with
+ * a colon for main-namespace pages
+ */
if( $wgWhitelistRead && $this->getNamespace() == NS_MAIN ) {
- if( in_array( ':' . $name, $wgWhitelistRead ) ) {
+ if( in_array( ':' . $name, $wgWhitelistRead ) )
return true;
- }
}
+
+ /**
+ * If it's a special page, ditch the subpage bit
+ * and check again
+ */
+ if( $this->getNamespace() == NS_SPECIAL ) {
+ $name = $this->getText();
+ list( $name, /* $subpage */) = SpecialPage::resolveAliasWithSubpage( $name );
+ $pure = SpecialPage::getTitleFor( $name )->getPrefixedText();
+ if( in_array( $pure, $wgWhitelistRead, true ) )
+ return true;
+ }
+
}
return false;
}
/**
* Is this a talk page of some sort?
* @return bool
- * @access public
*/
- function isTalkPage() {
+ public function isTalkPage() {
return Namespace::isTalk( $this->getNamespace() );
}
/**
* Is this a subpage?
* @return bool
- * @access public
*/
- function isSubpage() {
+ public function isSubpage() {
global $wgNamespacesWithSubpages;
if( isset( $wgNamespacesWithSubpages[ $this->mNamespace ] ) ) {
return false;
}
}
+
+ /**
+ * Could this page contain custom CSS or JavaScript, based
+ * on the title?
+ *
+ * @return bool
+ */
+ public function isCssOrJsPage() {
+ return $this->mNamespace == NS_MEDIAWIKI
+ && preg_match( '!\.(?:css|js)$!u', $this->mTextform ) > 0;
+ }
/**
* Is this a .css or .js subpage of a user page?
* @return bool
- * @access public
*/
- function isCssJsSubpage() {
- return ( NS_USER == $this->mNamespace and preg_match("/\\/.*\\.(css|js)$/", $this->mTextform ) );
+ public function isCssJsSubpage() {
+ return ( NS_USER == $this->mNamespace and preg_match("/\\/.*\\.(?:css|js)$/", $this->mTextform ) );
}
/**
* Is this a *valid* .css or .js subpage of a user page?
* Check that the corresponding skin exists
*/
- function isValidCssJsSubpage() {
+ public function isValidCssJsSubpage() {
if ( $this->isCssJsSubpage() ) {
$skinNames = Skin::getSkinNames();
return array_key_exists( $this->getSkinFromCssJsSubpage(), $skinNames );
/**
* Trim down a .css or .js subpage title to get the corresponding skin name
*/
- function getSkinFromCssJsSubpage() {
+ public function getSkinFromCssJsSubpage() {
$subpage = explode( '/', $this->mTextform );
$subpage = $subpage[ count( $subpage ) - 1 ];
return( str_replace( array( '.css', '.js' ), array( '', '' ), $subpage ) );
/**
* Is this a .css subpage of a user page?
* @return bool
- * @access public
*/
- function isCssSubpage() {
+ public function isCssSubpage() {
return ( NS_USER == $this->mNamespace and preg_match("/\\/.*\\.css$/", $this->mTextform ) );
}
/**
* Is this a .js subpage of a user page?
* @return bool
- * @access public
*/
- function isJsSubpage() {
+ public function isJsSubpage() {
return ( NS_USER == $this->mNamespace and preg_match("/\\/.*\\.js$/", $this->mTextform ) );
}
/**
*
* @return boolean
* @todo XXX: this might be better using restrictions
- * @access public
*/
- function userCanEditCssJsSubpage() {
+ public function userCanEditCssJsSubpage() {
global $wgUser;
return ( $wgUser->isAllowed('editinterface') or preg_match('/^'.preg_quote($wgUser->getName(), '/').'\//', $this->mTextform) );
}
/**
- * Loads a string into mRestrictions array
- * @param string $res restrictions in string format
- * @access public
+ * Cascading protection: Return true if cascading restrictions apply to this page, false if not.
+ *
+ * @return bool If the page is subject to cascading restrictions.
+ */
+ public function isCascadeProtected() {
+ list( $sources, /* $restrictions */ ) = $this->getCascadeProtectionSources( false );
+ return ( $sources > 0 );
+ }
+
+ /**
+ * Cascading protection: Get the source of any cascading restrictions on this page.
+ *
+ * @param $get_pages bool Whether or not to retrieve the actual pages that the restrictions have come from.
+ * @return array( mixed title array, restriction array)
+ * Array of the Title objects of the pages from which cascading restrictions have come, false for none, or true if such restrictions exist, but $get_pages was not set.
+ * The restriction array is an array of each type, each of which contains an array of unique groups
*/
- function loadRestrictions( $res ) {
- foreach( explode( ':', trim( $res ) ) as $restrict ) {
- $temp = explode( '=', trim( $restrict ) );
- if(count($temp) == 1) {
- // old format should be treated as edit/move restriction
- $this->mRestrictions["edit"] = explode( ',', trim( $temp[0] ) );
- $this->mRestrictions["move"] = explode( ',', trim( $temp[0] ) );
+ public function getCascadeProtectionSources( $get_pages = true ) {
+ global $wgEnableCascadingProtection, $wgRestrictionTypes;
+
+ # Define our dimension of restrictions types
+ $pagerestrictions = array();
+ foreach( $wgRestrictionTypes as $action )
+ $pagerestrictions[$action] = array();
+
+ if (!$wgEnableCascadingProtection)
+ return array( false, $pagerestrictions );
+
+ if ( isset( $this->mCascadeSources ) && $get_pages ) {
+ return array( $this->mCascadeSources, $this->mCascadingRestrictions );
+ } else if ( isset( $this->mHasCascadingRestrictions ) && !$get_pages ) {
+ return array( $this->mHasCascadingRestrictions, $pagerestrictions );
+ }
+
+ wfProfileIn( __METHOD__ );
+
+ $dbr = wfGetDb( DB_SLAVE );
+
+ if ( $this->getNamespace() == NS_IMAGE ) {
+ $tables = array ('imagelinks', 'page_restrictions');
+ $where_clauses = array(
+ 'il_to' => $this->getDBkey(),
+ 'il_from=pr_page',
+ 'pr_cascade' => 1 );
+ } else {
+ $tables = array ('templatelinks', 'page_restrictions');
+ $where_clauses = array(
+ 'tl_namespace' => $this->getNamespace(),
+ 'tl_title' => $this->getDBkey(),
+ 'tl_from=pr_page',
+ 'pr_cascade' => 1 );
+ }
+
+ if ( $get_pages ) {
+ $cols = array('pr_page', 'page_namespace', 'page_title', 'pr_expiry', 'pr_type', 'pr_level' );
+ $where_clauses[] = 'page_id=pr_page';
+ $tables[] = 'page';
+ } else {
+ $cols = array( 'pr_expiry' );
+ }
+
+ $res = $dbr->select( $tables, $cols, $where_clauses, __METHOD__ );
+
+ $sources = $get_pages ? array() : false;
+ $now = wfTimestampNow();
+ $purgeExpired = false;
+
+ while( $row = $dbr->fetchObject( $res ) ) {
+ $expiry = Block::decodeExpiry( $row->pr_expiry );
+ if( $expiry > $now ) {
+ if ($get_pages) {
+ $page_id = $row->pr_page;
+ $page_ns = $row->page_namespace;
+ $page_title = $row->page_title;
+ $sources[$page_id] = Title::makeTitle($page_ns, $page_title);
+ # Add groups needed for each restriction type if its not already there
+ # Make sure this restriction type still exists
+ if ( isset($pagerestrictions[$row->pr_type]) && !in_array($row->pr_level, $pagerestrictions[$row->pr_type]) ) {
+ $pagerestrictions[$row->pr_type][]=$row->pr_level;
+ }
+ } else {
+ $sources = true;
+ }
} else {
- $this->mRestrictions[$temp[0]] = explode( ',', trim( $temp[1] ) );
+ // Trigger lazy purge of expired restrictions from the db
+ $purgeExpired = true;
+ }
+ }
+ if( $purgeExpired ) {
+ Title::purgeExpiredRestrictions();
+ }
+
+ wfProfileOut( __METHOD__ );
+
+ if ( $get_pages ) {
+ $this->mCascadeSources = $sources;
+ $this->mCascadingRestrictions = $pagerestrictions;
+ } else {
+ $this->mHasCascadingRestrictions = $sources;
+ }
+
+ return array( $sources, $pagerestrictions );
+ }
+
+ function areRestrictionsCascading() {
+ if (!$this->mRestrictionsLoaded) {
+ $this->loadRestrictions();
+ }
+
+ return $this->mCascadeRestriction;
+ }
+
+ /**
+ * Loads a string into mRestrictions array
+ * @param resource $res restrictions as an SQL result.
+ */
+ private function loadRestrictionsFromRow( $res, $oldFashionedRestrictions = NULL ) {
+ $dbr = wfGetDb( DB_SLAVE );
+
+ $this->mRestrictions['edit'] = array();
+ $this->mRestrictions['move'] = array();
+
+ # Backwards-compatibility: also load the restrictions from the page record (old format).
+
+ if ( $oldFashionedRestrictions == NULL ) {
+ $oldFashionedRestrictions = $dbr->selectField( 'page', 'page_restrictions', array( 'page_id' => $this->getArticleId() ), __METHOD__ );
+ }
+
+ if ($oldFashionedRestrictions != '') {
+
+ foreach( explode( ':', trim( $oldFashionedRestrictions ) ) as $restrict ) {
+ $temp = explode( '=', trim( $restrict ) );
+ if(count($temp) == 1) {
+ // old old format should be treated as edit/move restriction
+ $this->mRestrictions["edit"] = explode( ',', trim( $temp[0] ) );
+ $this->mRestrictions["move"] = explode( ',', trim( $temp[0] ) );
+ } else {
+ $this->mRestrictions[$temp[0]] = explode( ',', trim( $temp[1] ) );
+ }
+ }
+
+ $this->mOldRestrictions = true;
+ $this->mCascadeRestriction = false;
+ $this->mRestrictionsExpiry = Block::decodeExpiry('');
+
+ }
+
+ if( $dbr->numRows( $res ) ) {
+ # Current system - load second to make them override.
+ $now = wfTimestampNow();
+ $purgeExpired = false;
+
+ while ($row = $dbr->fetchObject( $res ) ) {
+ # Cycle through all the restrictions.
+
+ // This code should be refactored, now that it's being used more generally,
+ // But I don't really see any harm in leaving it in Block for now -werdna
+ $expiry = Block::decodeExpiry( $row->pr_expiry );
+
+ // Only apply the restrictions if they haven't expired!
+ if ( !$expiry || $expiry > $now ) {
+ $this->mRestrictionsExpiry = $expiry;
+ $this->mRestrictions[$row->pr_type] = explode( ',', trim( $row->pr_level ) );
+
+ $this->mCascadeRestriction |= $row->pr_cascade;
+ } else {
+ // Trigger a lazy purge of expired restrictions
+ $purgeExpired = true;
+ }
+ }
+
+ if( $purgeExpired ) {
+ Title::purgeExpiredRestrictions();
}
}
+
$this->mRestrictionsLoaded = true;
}
+ public function loadRestrictions( $oldFashionedRestrictions = NULL ) {
+ if( !$this->mRestrictionsLoaded ) {
+ $dbr = wfGetDB( DB_SLAVE );
+
+ $res = $dbr->select( 'page_restrictions', '*',
+ array ( 'pr_page' => $this->getArticleId() ), __METHOD__ );
+
+ $this->loadRestrictionsFromRow( $res, $oldFashionedRestrictions );
+ }
+ }
+
+ /**
+ * Purge expired restrictions from the page_restrictions table
+ */
+ static function purgeExpiredRestrictions() {
+ $dbw = wfGetDB( DB_MASTER );
+ $dbw->delete( 'page_restrictions',
+ array( 'pr_expiry < ' . $dbw->addQuotes( $dbw->timestamp() ) ),
+ __METHOD__ );
+ }
+
/**
* Accessor/initialisation for mRestrictions
+ *
* @param string $action action that permission needs to be checked for
* @return array the array of groups allowed to edit this article
- * @access public
*/
- function getRestrictions($action) {
- $id = $this->getArticleID();
- if ( 0 == $id ) { return array(); }
-
- if ( ! $this->mRestrictionsLoaded ) {
- $dbr =& wfGetDB( DB_SLAVE );
- $res = $dbr->selectField( 'page', 'page_restrictions', 'page_id='.$id );
- $this->loadRestrictions( $res );
- }
- if( isset( $this->mRestrictions[$action] ) ) {
- return $this->mRestrictions[$action];
+ public function getRestrictions( $action ) {
+ if( $this->exists() ) {
+ if( !$this->mRestrictionsLoaded ) {
+ $this->loadRestrictions();
+ }
+ return isset( $this->mRestrictions[$action] )
+ ? $this->mRestrictions[$action]
+ : array();
+ } else {
+ return array();
}
- return array();
}
/**
* Is there a version of this page in the deletion archive?
* @return int the number of archived revisions
- * @access public
*/
- function isDeleted() {
+ public function isDeleted() {
$fname = 'Title::isDeleted';
if ( $this->getNamespace() < 0 ) {
$n = 0;
} else {
- $dbr =& wfGetDB( DB_SLAVE );
+ $dbr = wfGetDB( DB_SLAVE );
$n = $dbr->selectField( 'archive', 'COUNT(*)', array( 'ar_namespace' => $this->getNamespace(),
'ar_title' => $this->getDBkey() ), $fname );
if( $this->getNamespace() == NS_IMAGE ) {
* @param int $flags a bit field; may be GAID_FOR_UPDATE to select
* for update
* @return int the ID
- * @access public
*/
- function getArticleID( $flags = 0 ) {
+ public function getArticleID( $flags = 0 ) {
$linkCache =& LinkCache::singleton();
if ( $flags & GAID_FOR_UPDATE ) {
$oldUpdate = $linkCache->forUpdate( true );
return $this->mArticleID;
}
- function getLatestRevID() {
+ public function getLatestRevID() {
if ($this->mLatestID !== false)
return $this->mLatestID;
- $db =& wfGetDB(DB_SLAVE);
+ $db = wfGetDB(DB_SLAVE);
return $this->mLatestID = $db->selectField( 'revision',
"max(rev_id)",
array('rev_page' => $this->getArticleID()),
* Article::doDeleteArticle()
*
* @param int $newid the new Article ID
- * @access public
*/
- function resetArticleID( $newid ) {
+ public function resetArticleID( $newid ) {
$linkCache =& LinkCache::singleton();
$linkCache->clearBadLink( $this->getPrefixedDBkey() );
/**
* Updates page_touched for this page; called from LinksUpdate.php
* @return bool true if the update succeded
- * @access public
*/
- function invalidateCache() {
+ public function invalidateCache() {
global $wgUseFileCache;
if ( wfReadOnly() ) {
return;
}
- $dbw =& wfGetDB( DB_MASTER );
+ $dbw = wfGetDB( DB_MASTER );
$success = $dbw->update( 'page',
array( /* SET */
'page_touched' => $dbw->timestamp()
* @private
*/
/* private */ function prefix( $name ) {
- global $wgContLang;
-
$p = '';
if ( '' != $this->mInterwiki ) {
$p = $this->mInterwiki . ':';
}
if ( 0 != $this->mNamespace ) {
- $p .= $wgContLang->getNsText( $this->mNamespace ) . ':';
+ $p .= $this->getNsText() . ':';
}
return $p . $name;
}
* namespace prefixes, sets the other forms, and canonicalizes
* everything.
* @return bool true on success
- * @private
*/
- /* private */ function secureAndSplit() {
+ private function secureAndSplit() {
global $wgContLang, $wgLocalInterwiki, $wgCapitalLinks;
# Initialisation
if ( ':' == $dbkey{0} ) {
$this->mNamespace = NS_MAIN;
$dbkey = substr( $dbkey, 1 ); # remove the colon but continue processing
+ $dbkey = trim( $dbkey, '_' ); # remove any subsequent whitespace
}
# Namespace or interwiki prefix
$m = array();
if ( preg_match( "/^(.+?)_*:_*(.*)$/S", $dbkey, $m ) ) {
$p = $m[1];
- $lowerNs = $wgContLang->lc( $p );
- if ( $ns = Namespace::getCanonicalIndex( $lowerNs ) ) {
- # Canonical namespace
- $dbkey = $m[2];
- $this->mNamespace = $ns;
- } elseif ( $ns = $wgContLang->getNsIndex( $lowerNs )) {
+ if ( $ns = $wgContLang->getNsIndex( $p )) {
# Ordinary namespace
$dbkey = $m[2];
$this->mNamespace = $ns;
{
return false;
}
+
+ /**
+ * Magic tilde sequences? Nu-uh!
+ */
+ if( strpos( $dbkey, '~~~' ) !== false ) {
+ return false;
+ }
/**
* Limit the size of titles to 255 bytes.
* Don't force it for interwikis, since the other
* site might be case-sensitive.
*/
+ $this->mUserCaseDBKey = $dbkey;
if( $wgCapitalLinks && $this->mInterwiki == '') {
$dbkey = $wgContLang->ucfirst( $dbkey );
}
* members directly, which is what Linker::formatComment was doing previously.
*
* @param string $fragment text
- * @access kind of public
+ * @todo clarify whether access is supposed to be public (was marked as "kind of public")
*/
- function setFragment( $fragment ) {
+ public function setFragment( $fragment ) {
$this->mFragment = str_replace( '_', ' ', substr( $fragment, 1 ) );
}
/**
* Get a Title object associated with the talk page of this article
* @return Title the object for the talk page
- * @access public
*/
- function getTalkPage() {
+ public function getTalkPage() {
return Title::makeTitle( Namespace::getTalk( $this->getNamespace() ), $this->getDBkey() );
}
* talk page
*
* @return Title the object for the subject page
- * @access public
*/
- function getSubjectPage() {
+ public function getSubjectPage() {
return Title::makeTitle( Namespace::getSubject( $this->getNamespace() ), $this->getDBkey() );
}
*
* @param string $options may be FOR UPDATE
* @return array the Title objects linking here
- * @access public
*/
- function getLinksTo( $options = '', $table = 'pagelinks', $prefix = 'pl' ) {
+ public function getLinksTo( $options = '', $table = 'pagelinks', $prefix = 'pl' ) {
$linkCache =& LinkCache::singleton();
if ( $options ) {
- $db =& wfGetDB( DB_MASTER );
+ $db = wfGetDB( DB_MASTER );
} else {
- $db =& wfGetDB( DB_SLAVE );
+ $db = wfGetDB( DB_SLAVE );
}
$res = $db->select( array( 'page', $table ),
*
* @param string $options may be FOR UPDATE
* @return array the Title objects linking here
- * @access public
*/
- function getTemplateLinksTo( $options = '' ) {
+ public function getTemplateLinksTo( $options = '' ) {
return $this->getLinksTo( $options, 'templatelinks', 'tl' );
}
*
* @param string $options may be FOR UPDATE
* @return array the Title objects
- * @access public
*/
- function getBrokenLinksFrom( $options = '' ) {
+ public function getBrokenLinksFrom( $options = '' ) {
if ( $options ) {
- $db =& wfGetDB( DB_MASTER );
+ $db = wfGetDB( DB_MASTER );
} else {
- $db =& wfGetDB( DB_SLAVE );
+ $db = wfGetDB( DB_SLAVE );
}
$res = $db->safeQuery(
* page changes
*
* @return array the URLs
- * @access public
*/
- function getSquidURLs() {
+ public function getSquidURLs() {
global $wgContLang;
$urls = array(
return $urls;
}
- function purgeSquid() {
+ public function purgeSquid() {
global $wgUseSquid;
if ( $wgUseSquid ) {
$urls = $this->getSquidURLs();
/**
* Move this page without authentication
* @param Title &$nt the new page Title
- * @access public
*/
- function moveNoAuth( &$nt ) {
+ public function moveNoAuth( &$nt ) {
return $this->moveTo( $nt, false );
}
* @param bool $auth indicates whether $wgUser's permissions
* should be checked
* @return mixed true on success, message name on failure
- * @access public
*/
- function isValidMoveOperation( &$nt, $auth = true ) {
+ public function isValidMoveOperation( &$nt, $auth = true ) {
if( !$this or !$nt ) {
return 'badtitletext';
}
}
if ( $auth && (
- !$this->userCanEdit() || !$nt->userCanEdit() ||
- !$this->userCanMove() || !$nt->userCanMove() ) ) {
+ !$this->userCan( 'edit' ) || !$nt->userCan( 'edit' ) ||
+ !$this->userCan( 'move' ) || !$nt->userCan( 'move' ) ) ) {
return 'protectedpage';
}
* @param bool $auth indicates whether $wgUser's permissions
* should be checked
* @return mixed true on success, message name on failure
- * @access public
*/
- function moveTo( &$nt, $auth = true, $reason = '' ) {
+ public function moveTo( &$nt, $auth = true, $reason = '' ) {
$err = $this->isValidMoveOperation( $nt, $auth );
if( is_string( $err ) ) {
return $err;
$redirid = $this->getArticleID();
# Fixing category links (those without piped 'alternate' names) to be sorted under the new title
- $dbw =& wfGetDB( DB_MASTER );
+ $dbw = wfGetDB( DB_MASTER );
$categorylinks = $dbw->tableName( 'categorylinks' );
$sql = "UPDATE $categorylinks SET cl_sortkey=" . $dbw->addQuotes( $nt->getPrefixedText() ) .
" WHERE cl_from=" . $dbw->addQuotes( $pageid ) .
$u->doUpdate();
# Update site_stats
- if ( $this->getNamespace() == NS_MAIN and $nt->getNamespace() != NS_MAIN ) {
- # Moved out of main namespace
- # not viewed, edited, removing
- $u = new SiteStatsUpdate( 0, 1, -1, $pageCountChange);
- } elseif ( $this->getNamespace() != NS_MAIN and $nt->getNamespace() == NS_MAIN ) {
- # Moved into main namespace
- # not viewed, edited, adding
+ if( $this->isContentPage() && !$nt->isContentPage() ) {
+ # No longer a content page
+ # Not viewed, edited, removing
+ $u = new SiteStatsUpdate( 0, 1, -1, $pageCountChange );
+ } elseif( !$this->isContentPage() && $nt->isContentPage() ) {
+ # Now a content page
+ # Not viewed, edited, adding
$u = new SiteStatsUpdate( 0, 1, +1, $pageCountChange );
- } elseif ( $pageCountChange ) {
- # Added redirect
+ } elseif( $pageCountChange ) {
+ # Redirect added
$u = new SiteStatsUpdate( 0, 0, 0, 1 );
- } else{
+ } else {
+ # Nothing special
$u = false;
}
- if ( $u ) {
+ if( $u )
$u->doUpdate();
- }
-
+
global $wgUser;
wfRunHooks( 'TitleMoveComplete', array( &$this, &$nt, &$wgUser, $pageid, $redirid ) );
return true;
*
* @param Title &$nt the page to move to, which should currently
* be a redirect
- * @private
*/
- function moveOverExistingRedirect( &$nt, $reason = '' ) {
+ private function moveOverExistingRedirect( &$nt, $reason = '' ) {
global $wgUseSquid;
$fname = 'Title::moveOverExistingRedirect';
- $comment = wfMsgForContent( '1movedto2', $this->getPrefixedText(), $nt->getPrefixedText() );
+ $comment = wfMsgForContent( '1movedto2_redir', $this->getPrefixedText(), $nt->getPrefixedText() );
if ( $reason ) {
$comment .= ": $reason";
$now = wfTimestampNow();
$newid = $nt->getArticleID();
$oldid = $this->getArticleID();
- $dbw =& wfGetDB( DB_MASTER );
+ $dbw = wfGetDB( DB_MASTER );
$linkCache =& LinkCache::singleton();
# Delete the old redirect. We don't save it to history since
/**
* Move page to non-existing title.
* @param Title &$nt the new Title
- * @private
*/
- function moveToNewTitle( &$nt, $reason = '' ) {
+ private function moveToNewTitle( &$nt, $reason = '' ) {
global $wgUseSquid;
$fname = 'MovePageForm::moveToNewTitle';
$comment = wfMsgForContent( '1movedto2', $this->getPrefixedText(), $nt->getPrefixedText() );
$newid = $nt->getArticleID();
$oldid = $this->getArticleID();
- $dbw =& wfGetDB( DB_MASTER );
+ $dbw = wfGetDB( DB_MASTER );
$now = $dbw->timestamp();
$linkCache =& LinkCache::singleton();
* - Selects for update, so don't call it unless you mean business
*
* @param Title &$nt the new title to check
- * @access public
*/
- function isValidMoveTarget( $nt ) {
+ public function isValidMoveTarget( $nt ) {
$fname = 'Title::isValidMoveTarget';
- $dbw =& wfGetDB( DB_MASTER );
+ $dbw = wfGetDB( DB_MASTER );
# Is it a redirect?
$id = $nt->getArticleID();
# Return true if there was no history
return $row === false;
}
-
+
/**
- * Create a redirect; fails if the title already exists; does
- * not notify RC
+ * Can this title be added to a user's watchlist?
*
- * @param Title $dest the destination of the redirect
- * @param string $comment the comment string describing the move
- * @return bool true on success
- * @access public
+ * @return bool
*/
- function createRedirect( $dest, $comment ) {
- if ( $this->getArticleID() ) {
- return false;
- }
-
- $fname = 'Title::createRedirect';
- $dbw =& wfGetDB( DB_MASTER );
-
- $article = new Article( $this );
- $newid = $article->insertOn( $dbw );
- $revision = new Revision( array(
- 'page' => $newid,
- 'comment' => $comment,
- 'text' => "#REDIRECT [[" . $dest->getPrefixedText() . "]]\n",
- ) );
- $revision->insertOn( $dbw );
- $article->updateRevisionOn( $dbw, $revision, 0 );
-
- # Link table
- $dbw->insert( 'pagelinks',
- array(
- 'pl_from' => $newid,
- 'pl_namespace' => $dest->getNamespace(),
- 'pl_title' => $dest->getDbKey()
- ), $fname
- );
-
- Article::onArticleCreate( $this );
- return true;
+ public function isWatchable() {
+ return !$this->isExternal()
+ && Namespace::isWatchable( $this->getNamespace() );
}
/**
*
* @return array an array of parents in the form:
* $parent => $currentarticle
- * @access public
*/
- function getParentCategories() {
+ public function getParentCategories() {
global $wgContLang;
$titlekey = $this->getArticleId();
- $dbr =& wfGetDB( DB_SLAVE );
+ $dbr = wfGetDB( DB_SLAVE );
$categorylinks = $dbr->tableName( 'categorylinks' );
# NEW SQL
* Get a tree of parent categories
* @param array $children an array with the children in the keys, to check for circular refs
* @return array
- * @access public
*/
- function getParentCategoryTree( $children = array() ) {
+ public function getParentCategoryTree( $children = array() ) {
$parents = $this->getParentCategories();
if($parents != '') {
* the "page" table
*
* @return array
- * @access public
*/
- function pageCond() {
+ public function pageCond() {
return array( 'page_namespace' => $this->mNamespace, 'page_title' => $this->mDbkeyform );
}
* @param integer $revision Revision ID. Get the revision that was before this one.
* @return integer $oldrevision|false
*/
- function getPreviousRevisionID( $revision ) {
- $dbr =& wfGetDB( DB_SLAVE );
+ public function getPreviousRevisionID( $revision ) {
+ $dbr = wfGetDB( DB_SLAVE );
return $dbr->selectField( 'revision', 'rev_id',
'rev_page=' . intval( $this->getArticleId() ) .
' AND rev_id<' . intval( $revision ) . ' ORDER BY rev_id DESC' );
* @param integer $revision Revision ID. Get the revision that was after this one.
* @return integer $oldrevision|false
*/
- function getNextRevisionID( $revision ) {
- $dbr =& wfGetDB( DB_SLAVE );
+ public function getNextRevisionID( $revision ) {
+ $dbr = wfGetDB( DB_SLAVE );
return $dbr->selectField( 'revision', 'rev_id',
'rev_page=' . intval( $this->getArticleId() ) .
' AND rev_id>' . intval( $revision ) . ' ORDER BY rev_id' );
* @param integer $new Revision ID.
* @return integer Number of revisions between these IDs.
*/
- function countRevisionsBetween( $old, $new ) {
- $dbr =& wfGetDB( DB_SLAVE );
+ public function countRevisionsBetween( $old, $new ) {
+ $dbr = wfGetDB( DB_SLAVE );
return $dbr->selectField( 'revision', 'count(*)',
'rev_page = ' . intval( $this->getArticleId() ) .
' AND rev_id > ' . intval( $old ) .
* @param Title $title
* @return bool
*/
- function equals( $title ) {
+ public function equals( $title ) {
// Note: === is necessary for proper matching of number-like titles.
return $this->getInterwiki() === $title->getInterwiki()
&& $this->getNamespace() == $title->getNamespace()
&& $this->getDbkey() === $title->getDbkey();
}
+
+ /**
+ * Return a string representation of this title
+ *
+ * @return string
+ */
+ public function __toString() {
+ return $this->getPrefixedText();
+ }
/**
* Check if page exists
* @return bool
*/
- function exists() {
+ public function exists() {
return $this->getArticleId() != 0;
}
/**
- * Should a link should be displayed as a known link, just based on its title?
+ * Do we know that this title definitely exists, or should we otherwise
+ * consider that it exists?
*
- * Currently, a self-link with a fragment and special pages are in
- * this category. Special pages never exist in the database.
+ * @return bool
*/
- function isAlwaysKnown() {
- return $this->isExternal() || ( 0 == $this->mNamespace && "" == $this->mDbkeyform )
- || NS_SPECIAL == $this->mNamespace;
+ public function isAlwaysKnown() {
+ return $this->isExternal()
+ || ( $this->mNamespace == NS_MAIN && $this->mDbkeyform == '' )
+ || ( $this->mNamespace == NS_MEDIAWIKI && wfMsgWeirdKey( $this->mDbkeyform ) );
}
/**
* pages linking to this title. May be sent to the job queue depending
* on the number of links. Typically called on create and delete.
*/
- function touchLinks() {
+ public function touchLinks() {
$u = new HTMLCacheUpdate( $this, 'pagelinks' );
$u->doUpdate();
/**
* Get the last touched timestamp
*/
- function getTouched() {
- $dbr =& wfGetDB( DB_SLAVE );
+ public function getTouched() {
+ $dbr = wfGetDB( DB_SLAVE );
$touched = $dbr->selectField( 'page', 'page_touched',
array(
'page_namespace' => $this->getNamespace(),
return $touched;
}
- /**
- * Get a cached value from a global cache that is invalidated when this page changes
- * @param string $key the key
- * @param callback $callback A callback function which generates the value on cache miss
- *
- * @deprecated use DependencyWrapper
- */
- function getRelatedCache( $memc, $key, $expiry, $callback, $params = array() ) {
- return DependencyWrapper::getValueFromCache( $memc, $key, $expiry, $callback,
- $params, new TitleDependency( $this ) );
- }
-
- function trackbackURL() {
+ public function trackbackURL() {
global $wgTitle, $wgScriptPath, $wgServer;
return "$wgServer$wgScriptPath/trackback.php?article="
. htmlspecialchars(urlencode($wgTitle->getPrefixedDBkey()));
}
- function trackbackRDF() {
+ public function trackbackRDF() {
$url = htmlspecialchars($this->getFullURL());
$title = htmlspecialchars($this->getText());
$tburl = $this->trackbackURL();
* Generate strings used for xml 'id' names in monobook tabs
* @return string
*/
- function getNamespaceKey() {
+ public function getNamespaceKey() {
global $wgContLang;
switch ($this->getNamespace()) {
case NS_MAIN:
/**
* Returns true if this title resolves to the named special page
* @param string $name The special page name
- * @access public
*/
- function isSpecial( $name ) {
+ public function isSpecial( $name ) {
if ( $this->getNamespace() == NS_SPECIAL ) {
list( $thisName, /* $subpage */ ) = SpecialPage::resolveAliasWithSubpage( $this->getDBkey() );
if ( $name == $thisName ) {
* If the Title refers to a special page alias which is not the local default,
* returns a new Title which points to the local default. Otherwise, returns $this.
*/
- function fixSpecialName() {
+ public function fixSpecialName() {
if ( $this->getNamespace() == NS_SPECIAL ) {
$canonicalName = SpecialPage::resolveAlias( $this->mDbkeyform );
if ( $canonicalName ) {
}
return $this;
}
+
+ /**
+ * Is this Title in a namespace which contains content?
+ * In other words, is this a content page, for the purposes of calculating
+ * statistics, etc?
+ *
+ * @return bool
+ */
+ public function isContentPage() {
+ return Namespace::isContent( $this->getNamespace() );
+ }
+
}
-?>
+
+
dépôts / lhc / web / wiklou.git / blobdiff