MediaWiki master
MediaWiki\RecentChanges\ChangesListQuery\WatchlistLabelCondition Class Reference

Check if a change has a certain watchlist label. More...

Inherits MediaWiki\RecentChanges\ChangesListQuery\ChangesListConditionBase.

Collaboration diagram for MediaWiki\RecentChanges\ChangesListQuery\WatchlistLabelCondition:

Public Member Functions

 evaluate (stdClass $row, $value)
 Evaluate the filter condition against a row, determining whether it is true or false.Ignore the values set with require() and exclude(), use only the value passed as a parameter.To ensure that $row has the required fields present, capture() must be called before evaluate(). This will signal to prepareQuery() that the fields should be added.
Parameters
stdClass$row
mixed$valueThe validated value
Returns
bool

 
 validateValue ( $value)
 Validate a value and return its normalized form.
Parameters
mixed$value
Returns
mixed

 
- Public Member Functions inherited from MediaWiki\RecentChanges\ChangesListQuery\ChangesListConditionBase
 capture ()
 Set a flag indicating that evaluate() will be called with rows from the query result.
 
 isCaptured ()
 Check whether capture() has been called.
Returns
bool

 
- Public Member Functions inherited from MediaWiki\RecentChanges\ChangesListQuery\ChangesListCondition
 exclude ( $value)
 Add a value to the set of excluded values.
 
 prepareQuery (IReadableDatabase $dbr, QueryBackend $query)
 Add conditions and joins to the query in order to implement require() and exclude().
 

Public Attributes

const LABEL_IDS = 'wlm_label_summary'
 
- Public Attributes inherited from MediaWiki\RecentChanges\ChangesListQuery\ChangesListConditionBase
 function
 
- Public Attributes inherited from MediaWiki\RecentChanges\ChangesListQuery\ChangesListCondition
 function
 Add a value to the set of required values.
 

Protected Member Functions

 prepareCapture (IReadableDatabase $dbr, QueryBackend $query)
 
 prepareConds (IReadableDatabase $dbr, QueryBackend $query)
 Add conditions to the query according to the values passed to require() and exclude().Subclasses may use getUniqueValuesWithUnion() to get the required and excluded values.
Parameters
IReadableDatabase$dbr
QueryBackend$query

 

Additional Inherited Members

- Protected Attributes inherited from MediaWiki\RecentChanges\ChangesListQuery\ChangesListConditionBase
array $excluded = []
 
array $required = []
 

Detailed Description

Check if a change has a certain watchlist label.

Watchlist expiry is not checked here since this filter is typically used in conjunction with WatchedCondition.

Since
1.46

Definition at line 15 of file WatchlistLabelCondition.php.

Member Function Documentation

◆ evaluate()

MediaWiki\RecentChanges\ChangesListQuery\WatchlistLabelCondition::evaluate ( stdClass $row,
$value )

Evaluate the filter condition against a row, determining whether it is true or false.Ignore the values set with require() and exclude(), use only the value passed as a parameter.To ensure that $row has the required fields present, capture() must be called before evaluate(). This will signal to prepareQuery() that the fields should be added.

Parameters
stdClass$row
mixed$valueThe validated value
Returns
bool

Implements MediaWiki\RecentChanges\ChangesListQuery\ChangesListCondition.

Definition at line 28 of file WatchlistLabelCondition.php.

◆ prepareCapture()

◆ prepareConds()

MediaWiki\RecentChanges\ChangesListQuery\WatchlistLabelCondition::prepareConds ( IReadableDatabase $dbr,
QueryBackend $query )
protected

Add conditions to the query according to the values passed to require() and exclude().Subclasses may use getUniqueValuesWithUnion() to get the required and excluded values.

Parameters
IReadableDatabase$dbr
QueryBackend$query

Reimplemented from MediaWiki\RecentChanges\ChangesListQuery\ChangesListConditionBase.

Definition at line 47 of file WatchlistLabelCondition.php.

References MediaWiki\RecentChanges\ChangesListQuery\QueryBackend\distinct(), Wikimedia\Rdbms\IReadableDatabase\expr(), MediaWiki\RecentChanges\ChangesListQuery\QueryBackend\forceEmptySet(), MediaWiki\RecentChanges\ChangesListQuery\QueryBackend\joinForConds(), and MediaWiki\RecentChanges\ChangesListQuery\QueryBackend\where().

◆ validateValue()

MediaWiki\RecentChanges\ChangesListQuery\WatchlistLabelCondition::validateValue ( $value)

Validate a value and return its normalized form.

Parameters
mixed$value
Returns
mixed

Implements MediaWiki\RecentChanges\ChangesListQuery\ChangesListCondition.

Definition at line 20 of file WatchlistLabelCondition.php.

Member Data Documentation

◆ LABEL_IDS

const MediaWiki\RecentChanges\ChangesListQuery\WatchlistLabelCondition::LABEL_IDS = 'wlm_label_summary'

Definition at line 17 of file WatchlistLabelCondition.php.


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