<?php
/**
 * Eventin Organizers Tool
 *
 * @package Aisentic\Integrations\Eventin
 */

declare(strict_types=1);

namespace Aisentic\Integrations\Eventin;

defined( 'ABSPATH' ) || exit;

/**
 * How many organizers, who one organizer is, and who organizes an event.
 */
class Eventin_Organizers_Tool extends Eventin_People_Stats_Tool {

	/**
	 * Constructor.
	 *
	 * @param Eventin_Stats_Query|null $query Queries; tests pass a fake.
	 */
	public function __construct( ?Eventin_Stats_Query $query = null ) {
		parent::__construct(
			'eventin-organizers',
			'Answer questions about Eventin organizers in one call. Pass nothing for how many organizers there are, how many are on an event, and who organizes the most events. Pass name for one organizer: job, company, groups, and how many events and which. Pass event_id or event_name for who organizes that event. Use this instead of counting the rows of other organizer tools. Every result has a status: "ok" means say the facts from it; "needs_clarification" means ask the question it gives and never pick for them; "not_found" means say plainly you cannot find it and open the page in the result. To open a page, use the page url in the result.',
			$query
		);
	}

	/**
	 * Role this tool reads.
	 *
	 * @return string
	 */
	protected function role(): string {
		return 'organizer';
	}

	/**
	 * Page that lists organizers.
	 *
	 * @return array{title:string,url:string}
	 */
	protected function people_page(): array {
		return $this->page( __( 'Organizers', 'aisentic' ), '/organizers' );
	}
}