1	<?php
2
3	namespace MediaWiki\Extension\AbuseFilter\Hooks;
4
5	use MediaWiki\Extension\AbuseFilter\AbuseFilterPermissionStatus;
6	use MediaWiki\Permissions\Authority;
7
8	interface AbuseFilterCanViewProtectedVariablesHook {
9	/**
10	* Called when determining if the user can view the specified protected variables.
11	*
12	* Implement this hook to define additional restrictions viewing any number of protected
13	* variable(s). This is also called when viewing the value of these variables.
14	*
15	* @since 1.44
16	* @param Authority $performer The user viewing the protected variable values.
17	* @param string[] $variables The protected variables that are being viewed.
18	* @param AbuseFilterPermissionStatus $status Modify this status to make it fatal if user does
19	*   not meet the additional restrictions. You can call {@link AbuseFilterPermissionStatus::setBlock}
20	*   and {@link AbuseFilterPermissionStatus::setPermission} where relevant.
21	*/
22	public function onAbuseFilterCanViewProtectedVariables(
23	Authority $performer, array $variables, AbuseFilterPermissionStatus $status
24	): void;
25	}