Abstract base class for a list of deletable items. More...

Inheritance diagram for RevDelList:

Collaboration diagram for RevDelList:

Public Member Functions
	__construct (IContextSource $context, Title $title, array $ids)

	areAnySuppressed ()
	Indicate whether any item in this list is suppressed. More...

	clearFileOps ()
	Clear any data structures needed for doPreCommitUpdates() and doPostCommitUpdates() STUB. More...

	doPostCommitUpdates (array $visibilityChangeMap)
	A hook for setVisibility(): do any necessary updates post-commit. More...

	doPreCommitUpdates ()
	A hook for setVisibility(): do batch updates pre-commit. More...

	getLogAction ()
	Get the log action for this list type. More...

	getLogParams ($params)
	Get log parameter array. More...

	getSuppressBit ()
	Get the integer value of the flag used for suppression. More...

	reloadFromMaster ()
	Reload the list data from the master DB. More...

	setVisibility (array $params)
	Set the visibility for the revisions in this list. More...

Public Member Functions inherited from RevisionListBase
	__construct (IContextSource $context, Title $title)
	Construct a revision list for a given title. More...

	current ()
	Get the current list item, or false if we are at the end. More...

	doQuery ($db)
	Do the DB query to iterate through the objects. More...

	filterByIds (array $ids)
	Select items only where the ID is any of the specified values. More...

	getType ()
	Get the internal type name of this list. More...

	key ()

	length ()
	Get the number of items in the list. More...

	newItem ($row)
	Create an item object from a DB result row. More...

	next ()
	Move the iteration pointer to the next list item, and return it. More...

	reset ()
	Start iteration. More...

	rewind ()

	valid ()

Public Member Functions inherited from ContextSource
	canUseWikiPage ()
	Check whether a WikiPage object can be get with getWikiPage(). More...

	exportSession ()
	Export the resolved user IP, HTTP headers, user ID, and session ID. More...

	getConfig ()
	Get the Config object. More...

	getContext ()
	Get the base IContextSource object. More...

	getLanguage ()
	Get the Language object. More...

	getOutput ()
	Get the OutputPage object. More...

	getRequest ()
	Get the WebRequest object. More...

	getSkin ()
	Get the Skin object. More...

	getStats ()
	Get the Stats object. More...

	getTiming ()
	Get the Timing object. More...

	getTitle ()
	Get the Title object. More...

	getUser ()
	Get the User object. More...

	getWikiPage ()
	Get the WikiPage object. More...

	msg ()
	Get a Message object with context set Parameters are the same as wfMessage() More...

	setContext (IContextSource $context)
	Set the IContextSource object. More...

Static Public Member Functions
static	getRelationType ()
	Get the DB field name associated with the ID list. More...

static	getRestriction ()
	Get the user right required for this list type Override this function. More...

static	getRevdelConstant ()
	Get the revision deletion constant for this list type Override this function. More...

static	suggestTarget ($target, array $ids)
	Suggest a target for the revision deletion Optionally override this function. More...

Protected Member Functions
	acquireItemLocks ()

	releaseItemLocks ()

Protected Member Functions inherited from RevisionListBase
	initCurrent ()
	Initialise the current iteration pointer. More...

Private Member Functions
	updateLog ($logType, $params)
	Record a log entry on the action. More...

Additional Inherited Members
Public Attributes inherited from RevisionListBase
Title	$title

Protected Attributes inherited from RevisionListBase
bool object	$current

array	$ids

ResultWrapper bool	$res

Detailed Description

Abstract base class for a list of deletable items.

The list class needs to be able to make a query from a set of identifiers to pull relevant rows, to return RevDelItem subclasses wrapping them, and to wrap bulk update operations.

Definition at line 28 of file RevDelList.php.

Constructor & Destructor Documentation

RevDelList::__construct	(	IContextSource	$context,
		Title	$title,
		array	$ids
	)

Definition at line 29 of file RevDelList.php.

References RevisionListBase\$ids.

Member Function Documentation

RevDelList::acquireItemLocks ( )

finalprotected

Definition at line 290 of file RevDelList.php.

References $status, as, and StatusValue\newGood().

Referenced by setVisibility().

RevDelList::areAnySuppressed ( )

Indicate whether any item in this list is suppressed.

Since: 1.25

Returns: bool

Definition at line 81 of file RevDelList.php.

References as, and getSuppressBit().

RevDelList::clearFileOps ( )

Clear any data structures needed for doPreCommitUpdates() and doPostCommitUpdates() STUB.

Definition at line 382 of file RevDelList.php.

Referenced by setVisibility().

RevDelList::doPostCommitUpdates ( array $visibilityChangeMap )

A hook for setVisibility(): do any necessary updates post-commit.

STUB

Parameters

array [id => ['oldBits' => $oldBits, 'newBits' => $newBits], ... ]

Returns: Status

Definition at line 400 of file RevDelList.php.

References StatusValue\newGood().

Referenced by setVisibility().

RevDelList::doPreCommitUpdates ( )

A hook for setVisibility(): do batch updates pre-commit.

STUB

Returns: Status

Definition at line 390 of file RevDelList.php.

References StatusValue\newGood().

Referenced by setVisibility().

RevDelList::getLogAction ( )

Get the log action for this list type.

Returns: string

Definition at line 360 of file RevDelList.php.

Referenced by updateLog().

RevDelList::getLogParams ( $params )

Get log parameter array.

Parameters

array $params Associative array of log parameters, same as updateLog()

Returns: array

Definition at line 369 of file RevDelList.php.

References $params, and RevisionListBase\getType().

Referenced by updateLog().

static RevDelList::getRelationType ( )

static

Get the DB field name associated with the ID list.

This used to populate the log_search table for finding log entries. Override this function.

Returns: string|null

Definition at line 40 of file RevDelList.php.

static RevDelList::getRestriction ( )

static

Get the user right required for this list type Override this function.

Since: 1.22

Returns: string|null

Definition at line 50 of file RevDelList.php.

static RevDelList::getRevdelConstant ( )

static

Get the revision deletion constant for this list type Override this function.

Since: 1.22

Returns: int|null

Definition at line 60 of file RevDelList.php.

RevDelList::getSuppressBit ( )

abstract

Get the integer value of the flag used for suppression.

Referenced by areAnySuppressed(), and setVisibility().

RevDelList::releaseItemLocks ( )

finalprotected

Definition at line 300 of file RevDelList.php.

References $status, as, and StatusValue\newGood().

Referenced by setVisibility().

RevDelList::reloadFromMaster ( )

Reload the list data from the master DB.

This can be done after setVisibility() to allow $item->getHTML() to show the new data.

Definition at line 314 of file RevDelList.php.

References DB_MASTER, RevisionListBase\doQuery(), and wfGetDB().

RevDelList::setVisibility ( array $params )

Set the visibility for the revisions in this list.

Logging and transactions are done here.

Parameters

array $params Associative array of parameters. Members are: value: ExtractBitParams() bitfield array comment: The log comment. perItemStatus: Set if you want per-item status reports

Returns: Status

Since: 1.23 Added 'perItemStatus' param

Definition at line 105 of file RevDelList.php.

References $comment, $status, acquireItemLocks(), DeferredUpdates\addCallableUpdate(), as, clearFileOps(), DB_MASTER, Revision\DELETED_RESTRICTED, doPostCommitUpdates(), doPreCommitUpdates(), RevisionListBase\doQuery(), RevisionDeleter\extractBitfield(), getSuppressBit(), IP\isIPAddress(), StatusValue\newFatal(), StatusValue\newGood(), DeferredUpdates\PRESEND, releaseItemLocks(), title, updateLog(), use, wfGetDB(), and wfGetLBFactory().

static RevDelList::suggestTarget	(		$target,
		array	$ids
	)

static

Suggest a target for the revision deletion Optionally override this function.

Since: 1.22

Parameters

Title \| null	$target	User-supplied target
array	$ids

Returns: Title|null

Definition at line 72 of file RevDelList.php.

RevDelList::updateLog	(	$logType,
		$params
	)

private

Record a log entry on the action.

Parameters

string	$logType	One of (delete,suppress)
array	$params	Associative array of parameters: newBits: The new value of the _deleted bitfield oldBits: The old value of the _deleted bitfield. title: The target title ids: The ID list comment: The log comment authorsIds: The array of the user IDs of the offenders authorsIPs: The array of the IP/anon user offenders

Exceptions

MWException

Definition at line 332 of file RevDelList.php.

References $params, getLogAction(), getLogParams(), RevisionDeleter\getRelationType(), RevisionListBase\getType(), and ContextSource\getUser().

Referenced by setVisibility().

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

includes/revisiondelete/RevDelList.php

Public Member Functions

Static Public Member Functions

Protected Member Functions

Private Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation