File: ChangesListSpecialPageQueryHook.php

package info (click to toggle)
mediawiki 1%3A1.43.3%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 417,464 kB
  • sloc: php: 1,062,949; javascript: 664,290; sql: 9,714; python: 5,458; xml: 3,489; sh: 1,131; makefile: 64
file content (39 lines) | stat: -rw-r--r-- 1,574 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
<?php

namespace MediaWiki\SpecialPage\Hook;

use MediaWiki\Html\FormOptions;

/**
 * This is a hook handler interface, see docs/Hooks.md.
 * Use the hook name "ChangesListSpecialPageQuery" to register handlers implementing this interface.
 *
 * @stable to implement
 * @ingroup Hooks
 */
interface ChangesListSpecialPageQueryHook {
	/**
	 * This hook is called when building an SQL query on pages inheriting from
	 * ChangesListSpecialPage (in core: RecentChanges, RecentChangesLinked and
	 * Watchlist). Do not use this to implement individual filters if they are
	 * compatible with the ChangesListFilter and ChangesListFilterGroup structure.
	 * Instead, use sub-classes of those classes in conjunction with the
	 * ChangesListSpecialPageStructuredFilters hook. This hook can be used to
	 * implement filters that do not implement that structure or custom behavior
	 * that is not an individual filter.
	 *
	 * @since 1.35
	 *
	 * @param string $name Name of the special page, e.g. 'Watchlist'
	 * @param array &$tables Array of tables to be queried
	 * @param array &$fields Array of columns to select
	 * @param array &$conds Array of WHERE conditionals for query
	 * @param array &$query_options Array of options for the database request
	 * @param array &$join_conds Join conditions for the tables
	 * @param FormOptions $opts FormOptions for this request
	 * @return bool|void True or no return value to continue or false to abort
	 */
	public function onChangesListSpecialPageQuery( $name, &$tables, &$fields,
		&$conds, &$query_options, &$join_conds, $opts
	);
}