File: DeleteUnknownPreferencesHook.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 (33 lines) | stat: -rw-r--r-- 1,277 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
<?php

namespace MediaWiki\Hook;

use Wikimedia\Rdbms\IReadableDatabase;

/**
 * This is a hook handler interface, see docs/Hooks.md.
 * Use the hook name "DeleteUnknownPreferences" to register handlers implementing this interface.
 *
 * @stable to implement
 * @ingroup Hooks
 */
interface DeleteUnknownPreferencesHook {
	/**
	 * This hook is called by the cleanupPreferences.php maintenance script
	 * to build a WHERE clause with which to delete preferences that are not
	 * known about. This hook is used by extensions that have dynamically-named
	 * preferences that should not be deleted in the usual cleanup process.
	 * For example, the Gadgets extension creates preferences prefixed with
	 * 'gadget-', so anything with that prefix is excluded from the deletion.
	 *
	 * @since 1.35
	 *
	 * @param array &$where Array that will be passed as the $cond parameter to
	 *   IReadableDatabase::select() to determine what will be deleted from the user_properties
	 *   table
	 * @param IReadableDatabase $db IReadableDatabase object,
	 *  useful for accessing $db->expr() to build expressions with IExpression::LIKE and LikeValue
	 * @return bool|void True or no return value to continue or false to abort
	 */
	public function onDeleteUnknownPreferences( &$where, $db );
}