<?php

namespace MediaWiki\Extension\AbuseFilter\Hooks;

use MediaWiki\Content\Content;

interface AbuseFilterContentToStringHook {
	/**
	 * Hook runner for the `AbuseFilter-contentToString` hook
	 *
	 * Called when converting a Content object to a string to which
	 * filters can be applied. If the hook function returns true, Content::getTextForSearchIndex()
	 * will be used for non-text content.
	 *
	 * @param Content $content
	 * @param ?string &$text Set this to the desired text
	 * @return bool|void True or no return value to continue or false to abort
	 */
	public function onAbuseFilter_contentToString(
		Content $content,
		?string &$text
	);
}
