MediaWiki  1.23.0
HistoryAction Class Reference

This class handles printing the history page for an article. More...

Inheritance diagram for HistoryAction:
Collaboration diagram for HistoryAction:

Public Member Functions

 feed ( $type)
 Output a subscription feed listing recent edits to this page. More...
 
 feedEmpty ()
 
 feedItem ( $row)
 Generate a FeedItem object from a given revision table row Borrows Recent Changes' feed generation functions for formatting; includes a diff to the previous revision (if any). More...
 
 fetchRevisions ( $limit, $offset, $direction)
 Fetch an array of revisions, specified by a given limit, offset and direction. More...
 
 getArticle ()
 Get the Article object we are working on. More...
 
 getName ()
 Return the name of the action this object responds to. More...
 
 onView ()
 Print the history page for an article. More...
 
 requiresUnblock ()
 Whether this action can still be executed by a blocked user. More...
 
 requiresWrite ()
 Whether this action requires the wiki not to be locked. More...
 
- Public Member Functions inherited from FormlessAction
 execute (array $data=null, $captureErrors=true)
 Execute the action silently, not giving any output. More...
 
 onSubmit ( $data)
 
 onSuccess ()
 
 show ()
 The main action entry point. More...
 
- Public Member Functions inherited from Action
 __construct (Page $page, IContextSource $context=null)
 Constructor. More...
 
 execute ()
 Execute the action in a silent fashion: do not display anything or release any errors. More...
 
 getContext ()
 Get the IContextSource in use here. More...
 
 getLang ()
 Shortcut to get the user Language being used for this instance. More...
 
 getLanguage ()
 Shortcut to get the user Language being used for this instance. More...
 
 getOutput ()
 Get the OutputPage being used for this instance. More...
 
 getRequest ()
 Get the WebRequest being used for this instance. More...
 
 getRestriction ()
 Get the permission required to perform this action. More...
 
 getSkin ()
 Shortcut to get the Skin being used for this instance. More...
 
 getTitle ()
 Shortcut to get the Title object from the page. More...
 
 getUser ()
 Shortcut to get the User being used for this instance. More...
 
 msg ()
 Get a Message object with context set Parameters are the same as wfMessage() More...
 

Public Attributes

array $message
 Array of message keys and strings *. More...
 
const DIR_NEXT = 1
 
const DIR_PREV = 0
 

Protected Member Functions

 getDescription ()
 Returns the description that goes below the <h1> tag. More...
 
 getPageTitle ()
 Returns the name that goes in the <h1> page title. More...
 
- Protected Member Functions inherited from FormlessAction
 getFormFields ()
 We don't want an HTMLForm. More...
 
- Protected Member Functions inherited from Action
 checkCanExecute (User $user)
 Checks if the given user (identified by an object) can perform this action. More...
 
 setHeaders ()
 Set output headers for noindexing etc. More...
 

Private Member Functions

 preCacheMessages ()
 As we use the same small set of messages in various methods and that they are called often, we call them once and save them in $this->message. More...
 

Additional Inherited Members

- Static Public Member Functions inherited from Action
static exists ( $name)
 Check if a given action is recognised, even if it's disabled. More...
 
static factory ( $action, Page $page, IContextSource $context=null)
 Get an appropriate Action subclass for the given action. More...
 
static getActionName (IContextSource $context)
 Get the action that will be executed, not necessarily the one passed passed through the "action" request parameter. More...
 
- Protected Attributes inherited from Action
IContextSource $context
 IContextSource if specified; otherwise we'll use the Context from the Page $context. More...
 
array $fields
 The fields used to create the HTMLForm $fields. More...
 
WikiPage Article ImagePage CategoryPage Page $page
 Page on which we're performing the action $page. More...
 

Detailed Description

This class handles printing the history page for an article.

In order to be efficient, it uses timestamps rather than offsets for paging, to avoid costly LIMIT,offset queries.

Construct it by passing in an Article, and call $h->history() to print the history.

Definition at line 36 of file HistoryAction.php.

Member Function Documentation

◆ feed()

HistoryAction::feed (   $type)

Output a subscription feed listing recent edits to this page.

Parameters
string$typefeed type

Definition at line 255 of file HistoryAction.php.

References $limit, $type, as, FeedUtils\checkFeedOutput(), DIR_NEXT, feedEmpty(), feedItem(), fetchRevisions(), Action\getRequest(), Action\getTitle(), global, and Action\msg().

Referenced by onView().

◆ feedEmpty()

HistoryAction::feedEmpty ( )

Definition at line 289 of file HistoryAction.php.

References Action\getTitle(), Action\msg(), text, TS_MW, and wfTimestamp().

Referenced by feed().

◆ feedItem()

HistoryAction::feedItem (   $row)

Generate a FeedItem object from a given revision table row Borrows Recent Changes' feed generation functions for formatting; includes a diff to the previous revision (if any).

Parameters
stdClass | array$rowdatabase row
Returns
FeedItem

Definition at line 308 of file HistoryAction.php.

References $rev, $title, $wgContLang, FeedUtils\formatDiffRow(), Action\getTitle(), global, Action\msg(), and FeedItem\stripComment().

Referenced by feed().

◆ fetchRevisions()

HistoryAction::fetchRevisions (   $limit,
  $offset,
  $direction 
)

Fetch an array of revisions, specified by a given limit, offset and direction.

This is now only used by the feeds. It was previously used by the main UI but that's now handled by the pager.

Parameters
int$limitThe limit number of revisions to get
int$offset
int$directionEither HistoryPage::DIR_PREV or HistoryPage::DIR_NEXT
Returns
ResultWrapper

Definition at line 219 of file HistoryAction.php.

References $dbr, $dirs, $limit, array(), DB_SLAVE, DIR_PREV, Action\exists(), Action\getTitle(), list, page, Revision\selectFields(), and wfGetDB().

Referenced by feed().

◆ getArticle()

HistoryAction::getArticle ( )

Get the Article object we are working on.

Returns
Page

Definition at line 72 of file HistoryAction.php.

References Action\$page.

◆ getDescription()

HistoryAction::getDescription ( )
protected

Returns the description that goes below the <h1> tag.

Returns
string

Reimplemented from Action.

Definition at line 58 of file HistoryAction.php.

References array(), Action\getTitle(), SpecialPage\getTitleFor(), Linker\linkKnown(), and Action\msg().

◆ getName()

HistoryAction::getName ( )

Return the name of the action this object responds to.

Returns
string Lowercase name

Reimplemented from Action.

Definition at line 42 of file HistoryAction.php.

◆ getPageTitle()

HistoryAction::getPageTitle ( )
protected

Returns the name that goes in the <h1> page title.

Returns
string

Reimplemented from Action.

Definition at line 54 of file HistoryAction.php.

References Action\getTitle(), and Action\msg().

◆ onView()

◆ preCacheMessages()

HistoryAction::preCacheMessages ( )
private

As we use the same small set of messages in various methods and that they are called often, we call them once and save them in $this->message.

Definition at line 80 of file HistoryAction.php.

References array(), as, message, and Action\msg().

Referenced by onView().

◆ requiresUnblock()

HistoryAction::requiresUnblock ( )

Whether this action can still be executed by a blocked user.

Returns
bool

Reimplemented from Action.

Definition at line 50 of file HistoryAction.php.

◆ requiresWrite()

HistoryAction::requiresWrite ( )

Whether this action requires the wiki not to be locked.

Returns
bool

Reimplemented from Action.

Definition at line 46 of file HistoryAction.php.

Member Data Documentation

◆ $message

array HistoryAction::$message

Array of message keys and strings *.

Definition at line 40 of file HistoryAction.php.

◆ DIR_NEXT

const HistoryAction::DIR_NEXT = 1

Definition at line 38 of file HistoryAction.php.

Referenced by feed().

◆ DIR_PREV

const HistoryAction::DIR_PREV = 0

Definition at line 37 of file HistoryAction.php.

Referenced by fetchRevisions().


The documentation for this class was generated from the following file: