File "Tour_Abstract.php"

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

<?php
namespace Tribe\Onboarding;

/**
 * Class Tour Abstract.
 *
 * @since 4.14.9
 */
abstract class Tour_Abstract {

	/**
	 * The tour ID.
	 *
	 * @since 4.14.9
	 *
	 * @var string
	 */
	public $tour_id;

	/**
	 * Times to display the tour.
	 *
	 * @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 tour 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->tour_id ) > $this->times_to_display )
		) {
			return false;
		}

		return true;
	}

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

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

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

		return $data;
	}
}