An individual filter in a boolean group. More...

Inheritance diagram for ChangesListBooleanFilter:

Collaboration diagram for ChangesListBooleanFilter:

Public Member Functions
	__construct ( $filterDefinition)
	Create a new filter with the specified configuration. More...

	displaysOnUnstructuredUi ()
	@inheritDoc More...

	getDefault ( $structuredUI=false)
	Get the default value. More...

	getJsData ()
	@inheritDoc More...

	getShowHide ()

	isActive (FormOptions $opts, $isStructuredUI)

	isFeatureAvailableOnStructuredUi ()
	@inheritDoc More...

	isSelected (FormOptions $opts)
	@inheritDoc More...

	modifyQuery (IDatabase $dbr, ChangesListSpecialPage $specialPage, &$tables, &$fields, &$conds, &$query_options, &$join_conds)
	Modifies the query to include the filter. More...

	setDefault ( $defaultValue)
	Sets default. More...

Public Member Functions inherited from ChangesListFilter
	__construct (array $filterDefinition)
	Creates a new filter with the specified configuration, and registers it to the specified group. More...

	activelyInConflictWithFilter (ChangeslistFilter $filter, FormOptions $opts)
	Check if the conflict with a filter is currently "active". More...

	activelyInConflictWithGroup (ChangesListFilterGroup $group, FormOptions $opts)
	Check if the conflict with a group is currently "active". More...

	applyCssClassIfNeeded (IContextSource $ctx, RecentChange $rc, array &$classes)
	Add CSS class if needed. More...

	conflictsWith ( $other, $globalKey, $forwardKey, $backwardKey)
	Marks that the given ChangesListFilterGroup or ChangesListFilter conflicts with this object. More...

	displaysOnStructuredUi ()
	Checks whether the filter should display on the structured UI This refers to the exact filter. More...

	getConflictingFilters ()
	Get filters conflicting with this filter. More...

	getConflictingGroups ()
	Get groups conflicting with this filter. More...

	getDescription ()

	getGroup ()

	getLabel ()

	getName ()

	getPriority ()

	setAsSupersetOf (ChangesListFilter $other)
	Marks that the current instance is (also) a superset of the filter passed in. More...

	setUnidirectionalConflict ( $other, $globalDescription, $contextDescription)
	Marks that the given ChangesListFilterGroup or ChangesListFilter conflicts with this object. More...

Protected Attributes
	$activeValue
	Value that defined when this filter is considered active. More...

	$defaultValue
	Default. More...

	$isReplacedInStructuredUi
	Whether there is a feature designed to replace this filter available on the structured UI. More...

	$queryCallable
	Callable used to do the actual query modification; see constructor. More...

	$showHide
	Main unstructured UI i18n key. More...

Protected Attributes inherited from ChangesListFilter
	$conflictingFilters = []
	Array of associative arrays with conflict information. More...

	$conflictingGroups = []
	Array of associative arrays with conflict information. More...

	$cssClassSuffix
	CSS class suffix used for attribution, e.g. More...

	$description
	i18n key of description for structured UI More...

	$group
	Group. More...

	$isRowApplicableCallable
	Callable that returns true if and only if a row is attributed to this filter. More...

	$label
	i18n key of label for structured UI More...

	$name
	Filter name. More...

	$priority
	Priority integer. More...

	$subsetFilters = []
	Array of associative arrays with subset information. More...

Additional Inherited Members
Public Attributes inherited from ChangesListFilter
const	RESERVED_NAME_CHAR = '_'

Protected Member Functions inherited from ChangesListFilter
	getCssClass ()
	Gets the CSS class. More...

	getSiblings ()
	Get filters in the same group. More...

Detailed Description

An individual filter in a boolean group.

Since: 1.29

Definition at line 32 of file ChangesListBooleanFilter.php.

Constructor & Destructor Documentation

◆ __construct()

ChangesListBooleanFilter::__construct ( $filterDefinition )

Create a new filter with the specified configuration.

It infers which UI (it can be either or both) to display the filter on based on which messages are provided.

If 'label' is provided, it will be displayed on the structured UI. If 'showHide' is provided, it will be displayed on the unstructured UI. Thus, 'label', 'description', and 'showHide' are optional depending on which UI it's for.

Parameters

array

$filterDefinition

ChangesListFilter definition

$filterDefinition['name'] string Name. Used as URL parameter.
$filterDefinition['group'] ChangesListFilterGroup Group. Filter group this belongs to.
$filterDefinition['label'] string i18n key of label for structured UI.
$filterDefinition['description'] string i18n key of description for structured UI.
$filterDefinition['showHide'] string Main i18n key used for unstructured UI.
$filterDefinition['isReplacedInStructuredUi'] bool Whether there is an equivalent feature available in the structured UI; this is optional, defaulting to true. It does not need to be set if the exact same filter is simply visible on both.
$filterDefinition['default'] bool Default
$filterDefinition['activeValue'] bool This filter is considered active when its value is equal to its activeValue. Default is true.
$filterDefinition['priority'] int Priority integer. Higher value means higher up in the group's filter list.
$filterDefinition['queryCallable'] callable Callable accepting parameters, used to implement filter's DB query modification. Required, except for legacy filters that still use the query hooks directly. Callback parameters:
- string $specialPageClassName Class name of current special page
- IContextSource $context Context, for e.g. user
- IDatabase $dbr Database, for addQuotes, makeList, and similar
- array &$tables Array of tables; see IDatabase::select $table
- array &$fields Array of fields; see IDatabase::select $vars
- array &$conds Array of conditions; see IDatabase::select $conds
- array &$query_options Array of query options; see IDatabase::select $options
- array &$join_conds Array of join conditions; see IDatabase::select $join_conds

Definition at line 116 of file ChangesListBooleanFilter.php.

References setDefault().

Member Function Documentation

◆ displaysOnUnstructuredUi()

ChangesListBooleanFilter::displaysOnUnstructuredUi ( )

@inheritDoc

Reimplemented from ChangesListFilter.

Definition at line 179 of file ChangesListBooleanFilter.php.

References $showHide.

◆ getDefault()

ChangesListBooleanFilter::getDefault ( $structuredUI = false )

Get the default value.

Parameters

bool $structuredUI Are we currently showing the structured UI

Returns: bool|null Default value

Definition at line 152 of file ChangesListBooleanFilter.php.

References $defaultValue.

◆ getJsData()

ChangesListBooleanFilter::getJsData ( )

@inheritDoc

Reimplemented from ChangesListFilter.

Definition at line 228 of file ChangesListBooleanFilter.php.

References $defaultValue, and $output.

◆ getShowHide()

ChangesListBooleanFilter::getShowHide ( )

Returns: string Main i18n key for unstructured UI

Definition at line 172 of file ChangesListBooleanFilter.php.

References $showHide.

◆ isActive()

ChangesListBooleanFilter::isActive	(	FormOptions	$opts,
			$isStructuredUI
	)

Parameters

FormOptions	$opts	Query parameters merged with defaults
bool	$isStructuredUI	Whether the structured UI is currently enabled

Returns: bool Whether this filter should be considered active

Definition at line 254 of file ChangesListBooleanFilter.php.

References $activeValue, and ChangesListFilter\getName().

◆ isFeatureAvailableOnStructuredUi()

ChangesListBooleanFilter::isFeatureAvailableOnStructuredUi ( )

@inheritDoc

Reimplemented from ChangesListFilter.

Definition at line 186 of file ChangesListBooleanFilter.php.

◆ isSelected()

ChangesListBooleanFilter::isSelected ( FormOptions $opts )

@inheritDoc

Reimplemented from ChangesListFilter.

Definition at line 239 of file ChangesListBooleanFilter.php.

References ChangesListFilter\getName(), ChangesListFilter\getSiblings(), and use.

◆ modifyQuery()

ChangesListBooleanFilter::modifyQuery	(	IDatabase	$dbr,
		ChangesListSpecialPage	$specialPage,
		&	$tables,
		&	$fields,
		&	$conds,
		&	$query_options,
		&	$join_conds
	)

Modifies the query to include the filter.

This is only called if the filter is in effect (taking into account the default).

Parameters

IDatabase	$dbr	Database, for addQuotes, makeList, and similar
ChangesListSpecialPage	$specialPage	Current special page
array	&$tables	Array of tables; see IDatabase::select $table
array	&$fields	Array of fields; see IDatabase::select $vars
array	&$conds	Array of conditions; see IDatabase::select $conds
array	&$query_options	Array of query options; see IDatabase::select $options
array	&$join_conds	Array of join conditions; see IDatabase::select $join_conds