/** * Extract a redirect destination from a string and return an * array of Titles, or null if the text doesn't contain a valid redirect * The last element in the array is the final destination after all redirects * have been resolved (up to $wgMaxRedirects times) * * @param string $text Text with possible redirect * @return Title[] Array of Titles, with the destination last * @deprecated since 1.21, use Content::getRedirectChain instead. */ public static function newFromRedirectArray($text) { ContentHandler::deprecated(__METHOD__, '1.21'); $content = ContentHandler::makeContent($text, null, CONTENT_MODEL_WIKITEXT); return $content->getRedirectChain(); }
/** * Return an applicable autosummary if one exists for the given edit. * @param string|null $oldtext the previous text of the page. * @param string|null $newtext The submitted text of the page. * @param int $flags bitmask: a bitmask of flags submitted for the edit. * @return string An appropriate autosummary, or an empty string. * * @deprecated since 1.21, use ContentHandler::getAutosummary() instead */ public static function getAutosummary( $oldtext, $newtext, $flags ) { // NOTE: stub for backwards-compatibility. assumes the given text is wikitext. will break horribly if it isn't. ContentHandler::deprecated( __METHOD__, '1.21' ); $handler = ContentHandler::getForModelID( CONTENT_MODEL_WIKITEXT ); $oldContent = is_null( $oldtext ) ? null : $handler->unserializeContent( $oldtext ); $newContent = is_null( $newtext ) ? null : $handler->unserializeContent( $newtext ); return $handler->getAutosummary( $oldContent, $newContent, $flags ); }
/** * @return string * * @deprecated Since 1.21, use getContent() instead. */ function getText() { ContentHandler::deprecated(__METHOD__, '1.21'); return $this->text; }
/** * Use specified text instead of loading from the database * @deprecated since 1.21, use setContent() instead. */ public function setText($oldText, $newText) { ContentHandler::deprecated(__METHOD__, "1.21"); $oldContent = ContentHandler::makeContent($oldText, $this->getTitle()); $newContent = ContentHandler::makeContent($newText, $this->getTitle()); $this->setContent($oldContent, $newContent); }
/** * Get text of an article from database * Does *NOT* follow redirects. * * @protected * @note this is really internal functionality that should really NOT be used by other functions. For accessing * article content, use the WikiPage class, especially WikiBase::getContent(). However, a lot of legacy code * uses this method to retrieve page text from the database, so the function has to remain public for now. * * @return mixed string containing article contents, or false if null * @deprecated in 1.21, use WikiPage::getContent() instead */ function fetchContent() { #BC cruft! ContentHandler::deprecated(__METHOD__, '1.21'); if ($this->mContentLoaded && $this->mContent) { return $this->mContent; } wfProfileIn(__METHOD__); $content = $this->fetchContentObject(); $this->mContent = ContentHandler::getContentText($content); #@todo: get rid of mContent everywhere! ContentHandler::runLegacyHooks('ArticleAfterFetchContent', array(&$this, &$this->mContent)); wfProfileOut(__METHOD__); return $this->mContent; }
/** * Get text of an article from database * Does *NOT* follow redirects. * * @protected * @note This is really internal functionality that should really NOT be * used by other functions. For accessing article content, use the WikiPage * class, especially WikiBase::getContent(). However, a lot of legacy code * uses this method to retrieve page text from the database, so the function * has to remain public for now. * * @return string|bool String containing article contents, or false if null * @deprecated since 1.21, use WikiPage::getContent() instead */ function fetchContent() { // BC cruft! ContentHandler::deprecated(__METHOD__, '1.21'); if ($this->mContentLoaded && $this->mContent) { return $this->mContent; } $content = $this->fetchContentObject(); if (!$content) { return false; } // @todo Get rid of mContent everywhere! $this->mContent = ContentHandler::getContentText($content); ContentHandler::runLegacyHooks('ArticleAfterFetchContent', array(&$this, &$this->mContent)); return $this->mContent; }
/** * Attempts to merge text content with base and current revisions * * @param $editText string * * @return bool * @deprecated since 1.21, use mergeChangesIntoContent() instead */ function mergeChangesInto(&$editText) { ContentHandler::deprecated(__METHOD__, "1.21"); $editContent = $this->toEditContent($editText); $ok = $this->mergeChangesIntoContent($editContent); if ($ok) { $editText = $this->toEditText($editContent); return true; } return false; }
/** * Fetch revision text without regard for view restrictions * * @return String * * @deprecated since 1.21. Instead, use Revision::getContent( Revision::RAW ) * or Revision::getSerializedData() as appropriate. */ public function getRawText() { ContentHandler::deprecated(__METHOD__, "1.21"); return $this->getText(self::RAW); }
/** * Call to WikiPage function for backwards compatibility. * @see WikiPage::getText */ public function getText($audience = Revision::FOR_PUBLIC, User $user = null) { ContentHandler::deprecated(__METHOD__, '1.21'); return $this->mPage->getText($audience, $user); }
/** * Call to WikiPage function for backwards compatibility. * @see WikiPage::replaceSection */ public function replaceSection($sectionId, $text, $sectionTitle = '', $edittime = null) { ContentHandler::deprecated(__METHOD__, '1.21'); return $this->mPage->replaceSection($sectionId, $text, $sectionTitle, $edittime); }
/** * @private * @todo document * * @param $editText string * * @return bool * @deprecated since 1.21, use mergeChangesIntoContent() instead */ function mergeChangesInto(&$editText) { ContentHandler::deprecated(__METHOD__, "1.21"); wfProfileIn(__METHOD__); $db = wfGetDB(DB_MASTER); // This is the revision the editor started from $baseRevision = $this->getBaseRevision(); if (is_null($baseRevision)) { wfProfileOut(__METHOD__); return false; } $baseText = $baseRevision->getText(); // The current state, we want to merge updates into it $currentRevision = Revision::loadFromTitle($db, $this->mTitle); if (is_null($currentRevision)) { wfProfileOut(__METHOD__); return false; } $currentText = $currentRevision->getText(); $result = ''; $editText = $this->toEditText($editText); if (wfMerge($baseText, $editText, $currentText, $result)) { $editText = $result; wfProfileOut(__METHOD__); return true; } else { wfProfileOut(__METHOD__); return false; } }
/** * Fetch revision text if it's available to the specified audience. * If the specified audience does not have the ability to view this * revision, an empty string will be returned. * * @param int $audience One of: * Revision::FOR_PUBLIC to be displayed to all users * Revision::FOR_THIS_USER to be displayed to the given user * Revision::RAW get the text regardless of permissions * @param User $user User object to check for, only if FOR_THIS_USER is passed * to the $audience parameter * * @deprecated since 1.21, use getContent() instead * @todo Replace usage in core * @return string */ public function getText($audience = self::FOR_PUBLIC, User $user = null) { ContentHandler::deprecated(__METHOD__, '1.21'); $content = $this->getContent($audience, $user); return ContentHandler::getContentText($content); # returns the raw content text, if applicable }
/** * Generate a diff, no caching * * @param string $otext Old text, must be already segmented * @param string $ntext New text, must be already segmented * * @return bool|string * @deprecated since 1.21, use generateContentDiffBody() instead! */ public function generateDiffBody($otext, $ntext) { ContentHandler::deprecated(__METHOD__, "1.21"); return $this->generateTextDiffBody($otext, $ntext); }