RevisionDeleter Class Reference

General controller for RevDel, used by both SpecialRevisiondelete and ApiRevisionDelete. More...

Static Public Member Functions
static	createList ( $typeName, IContextSource $context, PageIdentity $page, array $ids)
	Instantiate the appropriate list class for a given list of IDs.
static	extractBitfield (array $bitPars, $oldfield)
	Put together a rev_deleted bitfield.
static	getCanonicalTypeName ( $typeName)
	Gets the canonical type name, if any.
static	getChanges ( $n, $o)
	Gets an array of message keys describing the changes made to the visibility of the revision.
static	getRelationType ( $typeName)
	Get DB field name for URL param... Future code for other things may also track other types of revision-specific changes.
static	getRestriction ( $typeName)
	Get the user right required for the RevDel type.
static	getRevdelConstant ( $typeName)
	Get the revision deletion constant for the RevDel type.
static	getTypes ()
	Lists the valid possible types for revision deletion.
static	suggestTarget ( $typeName, $target, array $ids)
	Suggest a target for the revision deletion.

Static Protected Member Functions
static	checkItem ( $desc, $field, $diff, $new, &$arr)
	Checks for a change in the bitfield for a certain option and updates the provided array accordingly.

Detailed Description

General controller for RevDel, used by both SpecialRevisiondelete and ApiRevisionDelete.

Definition at line 21 of file RevisionDeleter.php.

Member Function Documentation

checkItem()

static RevisionDeleter::checkItem ( $desc, $field, $diff, $new, & $arr )

staticprotected

Checks for a change in the bitfield for a certain option and updates the provided array accordingly.

Parameters

string	$desc	Description to add to the array if the option was enabled / disabled.
int	$field	The bitmask describing the single option.
int	$diff	The xor of the old and new bitfields.
int	$new	The new bitfield
array	&$arr	The array to update.

Definition at line 147 of file RevisionDeleter.php.

createList()

static RevisionDeleter::createList ( $typeName, IContextSource $context, PageIdentity $page, array $ids )

static

Instantiate the appropriate list class for a given list of IDs.

Since

1.22

Parameters

string	$typeName	RevDel type, see RevisionDeleter::getTypes()
IContextSource	$context
PageIdentity	$page
array	$ids

Returns

RevDelList

Definition at line 117 of file RevisionDeleter.php.

Referenced by MediaWiki\Api\ApiRevisionDelete\execute().

extractBitfield()

static RevisionDeleter::extractBitfield ( array $bitPars, $oldfield )

static

Put together a rev_deleted bitfield.

Since

1.22

Parameters

array	$bitPars	associative array mapping bit masks to 0, 1 or -1. A value of 0 unsets the bits in the mask, 1 will set the bits in the mask, and any other value will retain the bits already present in $oldfield.
int	$oldfield	Current bitfield

Access: internal

Returns

int

Definition at line 269 of file RevisionDeleter.php.

getCanonicalTypeName()

static RevisionDeleter::getCanonicalTypeName ( $typeName )

static

Gets the canonical type name, if any.

Since

1.22

Parameters

string

$typeName

Returns

string|null

Definition at line 100 of file RevisionDeleter.php.

getChanges()

static RevisionDeleter::getChanges ( $n, $o )

static

Gets an array of message keys describing the changes made to the visibility of the revision.

If the resulting array is $arr, then $arr[0] will contain an array of keys describing the items that were hidden, $arr[1] will contain an array of keys describing the items that were unhidden, and $arr[2] will contain an array with a single message key, which can be one of "revdelete-restricted", "revdelete-unrestricted" indicating (un)suppression or null to indicate nothing in particular. You can turn the keys in $arr[0] and $arr[1] into message keys by appending -hid and -unhid to the keys respectively.

Parameters

int	$n	The new bitfield.
int	$o	The old bitfield.

Returns

array An array as described above.

Since

1.19 public

Definition at line 171 of file RevisionDeleter.php.

getRelationType()

static RevisionDeleter::getRelationType ( $typeName )

static

Get DB field name for URL param... Future code for other things may also track other types of revision-specific changes.

Parameters

string

$typeName

Returns

string|null One of log_id/rev_id/fa_id/ar_timestamp/oi_archive_name

Definition at line 198 of file RevisionDeleter.php.

getRestriction()

static RevisionDeleter::getRestriction ( $typeName )

static

Get the user right required for the RevDel type.

Since

1.22

Parameters

string

$typeName

Returns

string|null User right

Definition at line 213 of file RevisionDeleter.php.

Referenced by MediaWiki\Api\ApiRevisionDelete\execute().

getRevdelConstant()

static RevisionDeleter::getRevdelConstant ( $typeName )

static

Get the revision deletion constant for the RevDel type.

Since

1.22

Parameters

string

$typeName

Returns

int|null RevDel constant

Definition at line 228 of file RevisionDeleter.php.

Referenced by MediaWiki\Api\ApiRevisionDelete\execute().

getTypes()

static RevisionDeleter::getTypes ( )

static

Lists the valid possible types for revision deletion.

Since

1.22

Returns

array

Definition at line 89 of file RevisionDeleter.php.

Referenced by MediaWiki\Api\ApiRevisionDelete\getAllowedParams().

suggestTarget()

static RevisionDeleter::suggestTarget ( $typeName, $target, array $ids )

static

Suggest a target for the revision deletion.

Since

1.22

Parameters

string	$typeName
Title | null	$target	User-supplied target
array	$ids

Returns

Title|null

Definition at line 245 of file RevisionDeleter.php.

Referenced by MediaWiki\Api\ApiRevisionDelete\execute().

---

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

• includes/RevisionDelete/RevisionDeleter.php