1	<?php
2
3	namespace MediaWiki\Extension\AbuseFilter\BlockedDomains;
4
5	use MediaWiki\Extension\AbuseFilter\ServiceNames;
6	use MediaWiki\Extension\AbuseFilter\Variables\VariableHolder;
7	use MediaWiki\Page\PageReference;
8	use MediaWiki\Status\Status;
9	use MediaWiki\User\UserIdentity;
10
11	interface IBlockedDomainFilter {
12
13	public const SERVICE_NAME = ServiceNames::BlockedDomainFilter;
14
15	/**
16	* Check for any disallowed domains
17	*
18	* This function logs any hits under Special:Log.
19	*
20	* @param VariableHolder $vars variables by the action
21	* @param UserIdentity $user User that tried to add the domain, used for logging
22	* @param PageReference $title Title of the page that was attempted on, used for logging
23	* @return Status Error status if it's a match, good status if not
24	*/
25	public function filter( VariableHolder $vars, UserIdentity $user, PageReference $title ): Status;
26	}