BP_Admin_Tab

abstract class BP_Admin_Tab {

	/**
	 * Global variable name that store the tab instances
	 *
	 * @since BuddyBoss 1.0.0
	 * @var string
	 */
	public $global_tabs_var  = '';

	/**
	 * Admin menu page name
	 *
	 * @since BuddyBoss 1.0.0
	 * @var string
	 */
	public $menu_page = '';

	/**
	 * Tab label name
	 *
	 * @since BuddyBoss 1.0.0
	 * @var string
	 */
	public $tab_label         = '';

	/**
	 * Tab url slug
	 *
	 * @since BuddyBoss 1.0.0
	 * @var string
	 */
	public $tab_name         = '';

	/**
	 * Tab order
	 *
	 * @since BuddyBoss 1.0.0
	 * @var integer
	 */
	public $tab_order        = 50;

	public function __construct() {
		$this->initialize();
		$this->register_tab();
		$this->register_hook();

		if ( $this->is_active() ) {
			$this->register_fields();
			do_action( 'bp_admin_tab_fields_registered', $this->tab_name, $this );
			add_action( 'bp_admin_init', [$this, 'maybe_save_admin_settings'], 100 );
		}
	}

	/**
	 * Cutom class initialization
	 *
	 * @since BuddyBoss 1.0.0
	 */
	public function initialize() {
		// nothing
	}

	/**
	 * Determine whether this tab is active
	 *
	 * @since BuddyBoss 1.0.0
	 */
	public function is_active() {
		return true;
	}

	/**
	 * Register the tab to global variable
	 *
	 * @since BuddyBoss 1.0.0
	 */
	public function register_tab() {
		global ${$this->global_tabs_var};

		${$this->global_tabs_var}[$this->tab_name] = $this;
	}

	public function register_hook() {
		add_action('admin_head', [$this, 'register_admin_script']);
	}

	public function register_admin_script() {
		wp_enqueue_script( 'bp-admin',
			buddypress()->plugin_url . 'bp-core/admin/js/settings-page.js',
			[ 'jquery' ],
			buddypress()->version,
			true
		);

		wp_localize_script( 'bp-admin', 'BP_ADMIN', [
			'ajax_url' => admin_url( 'admin-ajax.php' ),
			'tools'    => array(
				'default_data' => array(
					'submit_button_message' => esc_js( __( 'Are you sure you want to import data? This action is going to alter your database. If this is a live website you may want to create a backup of your database first.', 'buddyboss' ) ),
					'clear_button_message'  => esc_js( __( "Are you sure you want to delete all Default Data content? Content that was created by you and others, and not by this default data installer, will not be deleted.", 'buddyboss' ) ),
				)
			),
		] );
	}

	/**
	 * Register setting fields belong to this group
	 *
	 * @since BuddyBoss 1.0.0
	 */
	public function register_fields() {
		// nothing
	}

	/**
	 * Save the fields if it's form post request
	 *
	 * @since BuddyBoss 1.0.0
	 */
	public function maybe_save_admin_settings() {
		if ( ! $this->is_saving() ) {
  			return false;
		}

		check_admin_referer( $this->tab_name . '-options' );

		$this->settings_save();
		do_action( 'bp_admin_tab_setting_save', $this->tab_name, $this );

		$this->settings_saved();
		do_action( 'bp_admin_tab_setting_saved', $this->tab_name, $this );
	}

	/**
	 * Determine whether current request is saving on the current tab
	 *
	 * @since BuddyBoss 1.0.0
	 */
	public function is_saving() {
		if ( ! isset( $_GET['page'] ) || ! isset( $_POST['submit'] ) ) {
			return false;
		}

		if ( $this->menu_page != $_GET['page'] ) {
			return false;
		}

		if ( $this->tab_name != $this->get_active_tab() ) {
			return false;
		}

		return true;
	}

	/**
	 * Method to save the fields
	 *
	 * By default it'll loop throught the setting group's fields, but allow
	 * extended classes to have their own logic if needed
	 *
	 * @since BuddyBoss 1.0.0
	 */
	public function settings_save() {
		global $wp_settings_fields;

		$fields = isset( $wp_settings_fields[ $this->tab_name ] )? (array) $wp_settings_fields[ $this->tab_name ] : [];

		foreach( $fields as $section => $settings ) {
			foreach( $settings as $setting_name => $setting ) {
				$value = isset( $_POST[$setting_name] ) ? $_POST[$setting_name] : '';
				bp_update_option( $setting_name, $value );
			}
		}
	}

	/**
	 * Method trigger after data are saved
	 *
	 * @since BuddyBoss 1.0.0
	 */
	abstract public function settings_saved();

	/**
	 * Method that should return the current active tab
	 *
	 * @since BuddyBoss 1.0.0
	 */
	abstract public function get_active_tab();

	/**
	 * Return if the tab should be visible. Default to if there's any setting fields
	 *
	 * @since BuddyBoss 1.0.0
	 */
	public function is_tab_visible() {
		return $this->has_fields();
	}

	/**
	 * Return if this tab has setting fields
	 *
	 * @since BuddyBoss 1.0.0
	 */
	public function has_fields() {
		global $wp_settings_fields;

		return ! empty( $wp_settings_fields[ $this->tab_name ] );
	}

	/**
	 * Output the form html on the setting page (not including tab and page title)
	 *
	 * @since BuddyBoss 1.0.0
	 */
	public function form_html() {
		settings_fields( $this->tab_name );
		$this->bp_custom_do_settings_sections( $this->tab_name );

		printf(
			'<p class="submit">
				<input type="submit" name="submit" class="button-primary" value="%s" />
			</p>',
			esc_attr__( 'Save Settings', 'buddyboss' )
		);
	}

	/**
	 * Add a wp setting section into current tab. Chainable
	 *
	 * @since BuddyBoss 1.0.0
	 */
	public function add_section( $id, $title, $callback = '__return_null' ) {
		add_settings_section( $id, $title, $callback, $this->tab_name );
		$this->active_section = $id;

		return $this;
	}

	/**
	 * Add a wp setting field to a wp setting section. Chainable
	 *
	 * @since BuddyBoss 1.0.0
	 */
	public function add_field( $name, $label, $callback, $field_args = [], $callback_args = [], $id = null ) {
		if ( !$id ) {
			$id = $this->active_section;
		}

		add_settings_field( $name, $label, $callback, $this->tab_name, $id, $callback_args );
		register_setting( $this->tab_name, $name, $field_args );

		return $this;
	}

	/**
	 * Alias to add input text box field
	 *
	 * @since BuddyBoss 1.0.0
	 */
	public function add_input_field( $name, $label, $callback_args = [], $field_args = 'sanitize_text_field', $id = null ) {
		$callback = [$this, 'render_input_field_html'];

		$callback_args = wp_parse_args( $callback_args, [
			'input_type'        => 'text',
			'input_name'        => $this->get_input_name( $name ),
			'input_id'          => $this->get_input_id( $name ),
			'input_description' => '',
			'input_value'       => $this->get_input_value( $name ),
			'input_placeholder' => ''
		] );

		return $this->add_field( $name, $label, $callback, $field_args, $callback_args, $id );
	}

	/**
	 * Alias to add input check box field
	 *
	 * @since BuddyBoss 1.0.0
	 */
	public function add_checkbox_field( $name, $label, $callback_args = [], $field_args = 'intval', $id = null ) {
		$callback = [$this, 'render_checkbox_field_html'];

		$callback_args = wp_parse_args( $callback_args, [
			'input_name'        => $this->get_input_name( $name ),
			'input_id'          => $this->get_input_id( $name ),
			'input_text'        => '',
			'input_description' => '',
			'input_value'       => $this->get_input_value( $name, null ),
			'input_default'     => 0,
			'input_run_js'      => false,
		] );

		return $this->add_field( $name, $label, $callback, $field_args, $callback_args, $id );
	}

	/**
	 * Alias to add input select field
	 *
	 * @since BuddyBoss 1.0.0
	 */
	public function add_select_field( $name, $label, $callback_args = [], $field_args = 'sanitize_text_field', $id = null ) {
		$callback = [$this, 'render_select_field_html'];

		$callback_args = wp_parse_args( $callback_args, [
			'input_name'        => $this->get_input_name( $name ),
			'input_id'          => $this->get_input_id( $name ),
			'input_options'     => [],
			'input_description' => '',
			'input_value'       => $this->get_input_value( $name, null ),
			'input_default'     => 0,
		] );

		return $this->add_field( $name, $label, $callback, $field_args, $callback_args, $id );
	}

	/**
	 * Output the input field html based on the arguments
	 *
	 * @since BuddyBoss 1.0.0
	 */
	public function render_input_field_html( $args ) {
		printf(
			'<input name="%s" type="%s" id="%s" value="%s" placeholder="%s" class="regular-text" /> %s',
			$args['input_name'],
			$args['input_type'],
			$args['input_id'],
			$args['input_value'],
			$args['input_placeholder'],
			$args['input_description']? $this->render_input_description( $args['input_description'] ) : ''
		);
	}

	/**
	 * Output the checkbox field html based on the arguments
	 *
	 * @since BuddyBoss 1.0.0
	 */
	public function render_checkbox_field_html( $args ) {
		$input_value = is_null( $args['input_value'] )? $args['input_default'] : $args['input_value'];

		printf(
			'
				<input id="%1$s" name="%2$s" type="hidden" value="0" />
				<input id="%1$s" name="%2$s" type="checkbox" value="1" %3$s %4$s autocomplete="off"/>
				<label for="%1$s">%5$s</label>
				%6$s
			',
			$args['input_id'],
			$args['input_name'],
			checked( (bool) $input_value, true, false ),
			$args['input_run_js']? "data-run-js-condition=\"{$args['input_run_js']}\"" : '',
			$args['input_text'],
			$args['input_description']? $this->render_input_description( $args['input_description'] ) : ''
		);
	}

	/**
	 * Output the select field html based on the arguments
	 *
	 * @since BuddyBoss 1.0.0
	 */
	public function render_select_field_html( $args ) {
		$input_value = is_null( $args['input_value'] )? $args['input_default'] : $args['input_value'];
		$input_name = $args['input_name'];

        printf(
        	'<select name="%s" id="%s" autocomplete="off" %s>',
        	$args['input_name'],
        	$args['input_id'],
			$args['input_run_js']? "data-run-js-condition=\"{$args['input_run_js']}\"" : ''
        );

        foreach ($args['input_options'] ?: [] as $key => $value) {
        	$selected = $input_value == $key? 'selected' : '';
        	printf( '<option value="%s" %s>%s</option>', $key, $selected, $value );
        }

        echo '</select>';

        if ( $args['input_description'] ) {
			echo $this->render_input_description($args['input_description']);
        }
	}

	protected function render_input_description( $text ) {
		return "<p class=\"description\">{$text}</p>";
	}

	protected function get_input_name( $name ) {
		return $name;
	}

	protected function get_input_id( $id ) {
		return sanitize_title( $id );
	}

	protected function get_input_value( $key, $default = '' ) {
		return bp_get_option( $key, $default );
	}

	/**
	 * Prints out all settings sections added to a particular settings page
	 *
	 * Part of the Settings API. Use this in a settings page callback function
	 * to output all the sections and fields that were added to that $page with
	 * add_settings_section() and add_settings_field()
	 *
	 * @global $wp_settings_sections Storage array of all settings sections added to admin pages
	 * @global $wp_settings_fields Storage array of settings fields and info about their pages/sections
	 * @since BuddyPress 2.7.0
	 *
	 * @param string $page The slug name of the page whose settings sections you want to output
	 */
	public function bp_custom_do_settings_sections( $page ) {
		global $wp_settings_sections, $wp_settings_fields;

		if ( ! isset( $wp_settings_sections[$page] ) )
			return;

		foreach ( (array) $wp_settings_sections[$page] as $section ) {
			echo "<div class='bp-admin-card section-{$section['id']}'>";
			if ( $section['title'] ) {
				echo "<h2>{$section['title']}</h2>\n";
			}

			if ( $section['callback'] ) {
				call_user_func( $section['callback'], $section );
			}

			if ( ! isset( $wp_settings_fields ) || !isset( $wp_settings_fields[$page] ) || !isset( $wp_settings_fields[$page][$section['id']] ) ) {
				continue;
			}

			echo '<table class="form-table">';
			$this->bp_custom_do_settings_fields( $page, $section['id'] );
			echo '</table></div>';
		}
	}

	/**
	 * Print out the settings fields for a particular settings section
	 *
	 * Part of the Settings API. Use this in a settings page to output
	 * a specific section. Should normally be called by do_settings_sections()
	 * rather than directly.
	 *
	 * @global $wp_settings_fields Storage array of settings fields and their pages/sections
	 *
	 * @since BuddyPress 2.7.0
	 *
	 * @param string $page Slug title of the admin page who's settings fields you want to show.
	 * @param string $section Slug title of the settings section who's fields you want to show.
	 */
	public function bp_custom_do_settings_fields($page, $section) {
		global $wp_settings_fields;

		if ( ! isset( $wp_settings_fields[$page][$section] ) )
			return;

		foreach ( (array) $wp_settings_fields[$page][$section] as $field ) {
			$class = '';

			if ( ! empty( $field['args']['class'] ) ) {
				$class = ' class="' . esc_attr( $field['args']['class'] ) . '"';
			}

			echo "<tr{$class}>";

			if ( ! empty( $field['args']['label_for'] ) ) {
				echo '<th scope="row"><label for="' . esc_attr( $field['args']['label_for'] ) . '">' . $field['title'] . '</label></th>';
			} else {
				echo '<th scope="row">' . $field['title'] . '</th>';
			}

			echo '<td>';
			call_user_func($field['callback'], $field['args']);
			echo '</td>';
			echo '</tr>';
		}
	}
}