File "Hints_Abstract.php"

Full Path: /home/romayxjt/public_html/wp-content/plugins/the-events-calendar/common/src/Tribe/Onboarding/Hints_Abstract.php
File size: 1.54 KB
MIME-type: text/x-php
Charset: utf-8

<?php
namespace Tribe\Onboarding;

/**
 * Class Hints Abstract.
 *
 * @since 4.14.9
 */
abstract class Hints_Abstract {

	/**
	 * The hints ID.
	 *
	 * @since 4.14.9
	 *
	 * @var string
	 */
	public $hints_id;

	/**
	 * Times to display the hints.
	 *
	 * @since 4.14.9
	 *
	 * @var int
	 */
	public $times_to_display;

	/**
	 * Return if it's on page where it should be displayed.
	 *
	 * @since 4.14.9
	 *
	 * @return bool True if it is on page.
	 */
	public function is_on_page() {
		return false;
	}

	/**
	 * Should the hints display.
	 *
	 * @since 4.14.9
	 *
	 * @return boolean True if it should display.
	 */
	public function should_display() {
		// Bail if it's not on the page we want to display.
		if ( ! $this->is_on_page() ) {
			return false;
		}

		// Bail if the `Times to display` is set and it was reached.
		if (
			is_numeric( $this->times_to_display )
			&& ( tribe( 'onboarding' )->get_views( $this->hints_id ) > $this->times_to_display )
		) {
			return false;
		}

		return true;
	}

	/**
	 * Return the hints data.
	 *
	 * @since 4.14.9
	 *
	 * @return array The hints.
	 */
	abstract function hints();

	/**
	 * Return the CSS classes.
	 *
	 * @since 4.14.9
	 *
	 * @return array The CSS classes.
	 */
	public function css_classes() {
		return [];
	}

	/**
	 * The hints data, publicly accessible.
	 *
	 * @since 4.14.9.
	 *
	 * @param array $data An array with the hints data.
	 * @return array
	 */
	public function hints_data( array $data = [] ) {
		$data['hints']   = $this->hints();
		$data['classes'] = $this->css_classes();

		return $data;
	}
}