<?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;
}
}