<?php

namespace WebpConverter\Notice;

/**
 * Interface for class that supports notice displayed in admin panel.
 */
interface NoticeInterface {

	/**
	 * Returns name for option that specifies whether to display notice.
	 *
	 * @return string Option name.
	 */
	public function get_option_name(): string;

	/**
	 * Returns default value for option that specifies whether to display notice.
	 *
	 * @return string|null Default value.
	 */
	public static function get_default_value(): ?string;

	/**
	 * Returns status if notice is available.
	 *
	 * @return bool Is notice available?
	 */
	public function is_available(): bool;

	/**
	 * Returns status if notice is active.
	 *
	 * @return bool Is notice active?
	 */
	public function is_active(): bool;

	/**
	 * Returns value of option meaning to hide notice.
	 *
	 * @return string
	 */
	public function get_disable_value(): string;

	/**
	 * Returns server path for view template.
	 *
	 * @return string Server path relative to plugin root.
	 */
	public function get_output_path(): string;

	/**
	 * Returns variables with values using in view template.
	 *
	 * @return mixed[]|null Args extract in view template.
	 */
	public function get_vars_for_view();

	/**
	 * Returns name of action using in WP Ajax.
	 *
	 * @return string|null Name of ajax action.
	 */
	public function get_ajax_action_to_disable();
}