MediaWiki master
|
Represents a filter group (used on ChangesListSpecialPage and descendants) More...
Inherited by ChangesListBooleanFilterGroup, and ChangesListStringOptionsFilterGroup.
Public Member Functions | |
__construct (array $groupDefinition) | |
Create a new filter group with the specified configuration. | |
addOptions (FormOptions $opts, $allowDefaults, $isStructuredFiltersEnabled) | |
All the options represented by this filter group to $opts. | |
anySelected (FormOptions $opts) | |
Check if any filter in this group is selected. | |
conflictsWith ( $other, string $globalKey, string $forwardKey, string $backwardKey) | |
Marks that the given ChangesListFilterGroup or ChangesListFilter conflicts with this object. | |
getConflictingFilters () | |
Get filters conflicting with this filter group. | |
getConflictingGroups () | |
Get groups conflicting with this filter group. | |
getFilter ( $name) | |
Get filter by name. | |
getFilters () | |
getJsData () | |
Gets the JS data in the format required by the front-end of the structured UI. | |
getName () | |
getPriority () | |
getTitle () | |
getType () | |
modifyQuery (IReadableDatabase $dbr, ChangesListSpecialPage $specialPage, &$tables, &$fields, &$conds, &$query_options, &$join_conds, FormOptions $opts, $isStructuredFiltersEnabled) | |
Modifies the query to include the filter group. | |
setUnidirectionalConflict ( $other, $globalDescription, $contextDescription) | |
Marks that the given ChangesListFilterGroup or ChangesListFilter conflicts with this object. | |
Protected Member Functions | |
createFilter (array $filterDefinition) | |
Creates a filter of the appropriate type for this group, from the definition. | |
Protected Attributes | |
array | $conflictingFilters = [] |
Array of associative arrays with conflict information. | |
array | $conflictingGroups = [] |
Array of associative arrays with conflict information. | |
ChangesListFilter[] | $filters |
Associative array of filters, as ChangesListFilter objects, with filter name as key. | |
bool | $isFullCoverage |
Whether this group is full coverage. | |
string | $name |
Name (internal identifier) | |
int | $priority |
Priority integer. | |
string | $title |
i18n key for title | |
string | $type |
Type, from a TYPE constant of a subclass. | |
string null | $whatsThisBody |
i18n key for body of What's This? | |
string null | $whatsThisHeader |
i18n key for header of What's This? | |
string null | $whatsThisLinkText |
i18n key for What's This? link | |
string null | $whatsThisUrl |
URL of What's This? link. | |
Represents a filter group (used on ChangesListSpecialPage and descendants)
Definition at line 38 of file ChangesListFilterGroup.php.
ChangesListFilterGroup::__construct | ( | array | $groupDefinition | ) |
Create a new filter group with the specified configuration.
array | $groupDefinition | Configuration of group
|
Reimplemented in ChangesListBooleanFilterGroup, and ChangesListStringOptionsFilterGroup.
Definition at line 157 of file ChangesListFilterGroup.php.
References createFilter().
|
abstract |
All the options represented by this filter group to $opts.
FormOptions | $opts | |
bool | $allowDefaults | |
bool | $isStructuredFiltersEnabled |
Reimplemented in ChangesListBooleanFilterGroup, and ChangesListStringOptionsFilterGroup.
ChangesListFilterGroup::anySelected | ( | FormOptions | $opts | ) |
Check if any filter in this group is selected.
FormOptions | $opts |
Definition at line 421 of file ChangesListFilterGroup.php.
References getFilters(), and ChangesListFilter\isSelected().
Referenced by ChangesListFilter\activelyInConflictWithGroup().
ChangesListFilterGroup::conflictsWith | ( | $other, | |
string | $globalKey, | ||
string | $forwardKey, | ||
string | $backwardKey ) |
Marks that the given ChangesListFilterGroup or ChangesListFilter conflicts with this object.
WARNING: This means there is a conflict when both things are shown (not filtered out), even for the hide-based filters. So e.g. conflicting with 'hideanons' means there is a conflict if only anonymous users are shown.
ChangesListFilterGroup | ChangesListFilter | $other | |
string | $globalKey | i18n key for top-level conflict message |
string | $forwardKey | i18n key for conflict message in this direction (when in UI context of $this object) |
string | $backwardKey | i18n key for conflict message in reverse direction (when in UI context of $other object) |
Definition at line 230 of file ChangesListFilterGroup.php.
References setUnidirectionalConflict().
|
abstractprotected |
Creates a filter of the appropriate type for this group, from the definition.
array | $filterDefinition |
Reimplemented in ChangesListBooleanFilterGroup, and ChangesListStringOptionsFilterGroup.
Referenced by __construct().
ChangesListFilterGroup::getConflictingFilters | ( | ) |
Get filters conflicting with this filter group.
Definition at line 411 of file ChangesListFilterGroup.php.
ChangesListFilterGroup::getConflictingGroups | ( | ) |
Get groups conflicting with this filter group.
Definition at line 402 of file ChangesListFilterGroup.php.
ChangesListFilterGroup::getFilter | ( | $name | ) |
Get filter by name.
string | $name | Filter name |
Definition at line 320 of file ChangesListFilterGroup.php.
ChangesListFilterGroup::getFilters | ( | ) |
Definition at line 310 of file ChangesListFilterGroup.php.
Referenced by ChangesListBooleanFilterGroup\addOptions(), anySelected(), and ChangesListBooleanFilterGroup\modifyQuery().
ChangesListFilterGroup::getJsData | ( | ) |
Gets the JS data in the format required by the front-end of the structured UI.
Reimplemented in ChangesListStringOptionsFilterGroup.
Definition at line 331 of file ChangesListFilterGroup.php.
References ChangesListFilter\getPriority().
ChangesListFilterGroup::getName | ( | ) |
Definition at line 281 of file ChangesListFilterGroup.php.
Referenced by ChangesListStringOptionsFilterGroup\addOptions(), ChangesListStringOptionsFilterGroup\modifyQuery(), and MediaWiki\SpecialPage\ChangesListSpecialPage\registerFilterGroup().
ChangesListFilterGroup::getPriority | ( | ) |
Definition at line 302 of file ChangesListFilterGroup.php.
Referenced by MediaWiki\SpecialPage\ChangesListSpecialPage\getStructuredFilterJsData().
ChangesListFilterGroup::getTitle | ( | ) |
Definition at line 288 of file ChangesListFilterGroup.php.
ChangesListFilterGroup::getType | ( | ) |
Definition at line 295 of file ChangesListFilterGroup.php.
|
abstract |
Modifies the query to include the filter group.
The modification is only done if the filter group is in effect. This means that one or more valid and allowed filters were selected.
IReadableDatabase | $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 |
FormOptions | $opts | Wrapper for the current request options and their defaults |
bool | $isStructuredFiltersEnabled | True if the Structured UI is currently enabled |
Reimplemented in ChangesListBooleanFilterGroup, and ChangesListStringOptionsFilterGroup.
ChangesListFilterGroup::setUnidirectionalConflict | ( | $other, | |
$globalDescription, | |||
$contextDescription ) |
Marks that the given ChangesListFilterGroup or ChangesListFilter conflicts with this object.
Internal use ONLY.
ChangesListFilterGroup | ChangesListFilter | $other | |
string | $globalDescription | i18n key for top-level conflict message |
string | $contextDescription | i18n key for conflict message in this direction (when in UI context of $this object) |
Definition at line 255 of file ChangesListFilterGroup.php.
Referenced by conflictsWith().
|
protected |
Array of associative arrays with conflict information.
See setUnidirectionalConflict
Definition at line 125 of file ChangesListFilterGroup.php.
|
protected |
Array of associative arrays with conflict information.
See setUnidirectionalConflict
Definition at line 117 of file ChangesListFilterGroup.php.
|
protected |
Associative array of filters, as ChangesListFilter objects, with filter name as key.
Definition at line 101 of file ChangesListFilterGroup.php.
|
protected |
Whether this group is full coverage.
This means that checking every item in the group means no changes list (e.g. RecentChanges) entries are filtered out.
Definition at line 109 of file ChangesListFilterGroup.php.
|
protected |
Name (internal identifier)
Definition at line 44 of file ChangesListFilterGroup.php.
|
protected |
Priority integer.
Higher values means higher up in the group list.
Definition at line 94 of file ChangesListFilterGroup.php.
|
protected |
i18n key for title
Definition at line 51 of file ChangesListFilterGroup.php.
|
protected |
Type, from a TYPE constant of a subclass.
Definition at line 86 of file ChangesListFilterGroup.php.
|
protected |
i18n key for body of What's This?
Definition at line 65 of file ChangesListFilterGroup.php.
|
protected |
i18n key for header of What's This?
Definition at line 58 of file ChangesListFilterGroup.php.
|
protected |
i18n key for What's This? link
Definition at line 79 of file ChangesListFilterGroup.php.
|
protected |
URL of What's This? link.
Definition at line 72 of file ChangesListFilterGroup.php.