*/
class Accessibility_Onetap_Settings_Manager {
/**
* Settings sections array.
*
* @var array
*/
protected $settings_sections = array();
/**
* Settings fields array.
*
* @var array
*/
protected $settings_fields = array();
/**
* Initialize __construct.
*/
public function __construct() {
add_action( 'admin_enqueue_scripts', array( $this, 'admin_enqueue_scripts' ) );
}
/**
* Enqueue scripts and styles for the admin area.
*
* This function ensures that necessary scripts and styles are loaded on
* specific admin pages of the plugin. It loads the WordPress color picker,
* media uploader, jQuery, and a custom JavaScript file for managing settings.
*
* @param string $hook The current admin page hook suffix.
*/
public function admin_enqueue_scripts( $hook ) {
// Enqueue the WordPress color picker style.
wp_enqueue_style( 'wp-color-picker' );
// Enqueue the media uploader script.
wp_enqueue_media();
// Enqueue the WordPress color picker script.
wp_enqueue_script( 'wp-color-picker' );
// Enqueue the jQuery library.
wp_enqueue_script( 'jquery' );
// Conditionally enqueue the settings manager script for specific plugin admin pages.
if ( 'toplevel_page_accessibility-onetap-settings' === $hook || 'onetap_page_accessibility-onetap-modules' === $hook || 'admin_page_onetap-module-labels' === $hook ) {
wp_enqueue_script( 'accessibility-onetap-settings-manager', ACCESSIBILITY_ONETAP_PLUGINS_URL . 'assets/js/settings-manager.min.js', array( 'jquery' ), ACCESSIBILITY_ONETAP_VERSION, true );
}
}
/**
* Set settings sections.
*
* @param array $sections setting sections array.
*/
public function set_sections( $sections ) {
$this->settings_sections = $sections;
return $this;
}
/**
* Add a single section.
*
* @param array $section The section details.
*/
public function add_section( $section ) {
$this->settings_sections[] = $section;
return $this;
}
/**
* Set settings fields.
*
* @param array $fields settings fields array.
*/
public function set_fields( $fields ) {
$this->settings_fields = $fields;
return $this;
}
/**
* Add settings fields.
*
* @param array $section settings section array.
* @param array $field settings fields array.
*/
public function add_field( $section, $field ) {
$defaults = array(
'name' => '',
'label' => '',
'desc' => '',
'type' => 'text',
);
$arg = wp_parse_args( $field, $defaults );
$this->settings_fields[ $section ][] = $arg;
return $this;
}
/**
* Initialize and registers the settings sections and fileds to WordPress.
*
* Usually this should be called at `admin_init` hook.
*
* This function gets the initiated settings sections and fields. Then
* registers them to WordPress and ready for use.
*/
public function admin_init() {
// register settings sections.
foreach ( $this->settings_sections as $section ) {
if ( false === get_option( $section['id'] ) ) {
add_option( $section['id'] );
}
if ( isset( $section['desc'] ) && ! empty( $section['desc'] ) ) {
$section['desc'] = '' . $section['desc'] . '
';
$callback = function () use ( $section ) {
echo esc_html( str_replace( '"', '\"', $section['desc'] ) );
};
} elseif ( isset( $section['callback'] ) ) {
$callback = $section['callback'];
} else {
$callback = null;
}
add_settings_section( $section['id'], $section['title'], $callback, $section['id'] );
}
// register settings fields.
foreach ( $this->settings_fields as $section => $field ) {
foreach ( $field as $option ) {
$name = $option['name'];
$type = isset( $option['type'] ) ? $option['type'] : 'text';
$label = isset( $option['label'] ) ? $option['label'] : '';
$group_title = isset( $option['group_title'] ) ? $option['group_title'] : '';
$group_description = isset( $option['group_description'] ) ? $option['group_description'] : '';
$site_title = isset( $option['site_title'] ) ? $option['site_title'] : '';
$status = isset( $option['status'] ) ? $option['status'] : '';
$anchor = isset( $option['anchor'] ) ? $option['anchor'] : '';
$site_description = isset( $option['site_description'] ) ? $option['site_description'] : '';
$label_checkbox = isset( $option['label_checkbox'] ) ? $option['label_checkbox'] : '';
$icon = isset( $option['icon'] ) ? $option['icon'] : '';
$callback = isset( $option['callback'] ) ? array( $this, $option['callback'] ) : array( $this, 'callback_' . $type );
$args = array(
'id' => $name,
'class' => isset( $option['class'] ) ? $option['class'] : $name,
'label_for' => "{$section}[{$name}]",
'group_title' => $group_title,
'group_description' => $group_description,
'icon' => $icon,
'status' => $status,
'anchor' => $anchor,
'site_title' => $site_title,
'site_description' => $site_description,
'label_checkbox' => $label_checkbox,
'desc' => isset( $option['desc'] ) ? $option['desc'] : '',
'name' => $label,
'section' => $section,
'size' => isset( $option['size'] ) ? $option['size'] : null,
'options' => isset( $option['options'] ) ? $option['options'] : '',
'std' => isset( $option['default'] ) ? $option['default'] : '',
'sanitize_callback' => isset( $option['sanitize_callback'] ) ? $option['sanitize_callback'] : '',
'type' => $type,
'placeholder' => isset( $option['placeholder'] ) ? $option['placeholder'] : '',
'min' => isset( $option['min'] ) ? $option['min'] : '',
'max' => isset( $option['max'] ) ? $option['max'] : '',
'step' => isset( $option['step'] ) ? $option['step'] : '',
);
add_settings_field( "{$section}[{$name}]", $label, $callback, $section, $section, $args );
}
}
// creates our settings in the options table.
foreach ( $this->settings_sections as $section ) {
register_setting( $section['id'], $section['id'], array( $this, 'sanitize_options' ) );
}
}
/**
* Get field description for display.
*
* @param array $args settings field args.
*/
public function get_field_description( $args ) {
if ( ! empty( $args['desc'] ) ) {
$desc = sprintf( '%s
', $args['desc'] );
} else {
$desc = '';
}
return $desc;
}
/**
* Displays a text field for a settings field.
*
* @param array $args settings field args.
*/
public function callback_text( $args ) {
$value = esc_attr( $this->get_option( $args['id'], $args['section'], $args['std'] ) );
$size = isset( $args['size'] ) && ! is_null( $args['size'] ) ? $args['size'] : 'regular';
$type = isset( $args['type'] ) ? $args['type'] : 'text';
$placeholder = empty( $args['placeholder'] ) ? '' : esc_attr( $args['placeholder'] );
$html = '';
$html .= '
' . esc_html( $site_title ) . ' ';
$html .= '
' . esc_html( $site_description ) . ' ';
$html .= '
';
$html .= '' . esc_html( $name ) . ' ';
$html .= '' . esc_html__( 'Save Changes', 'accessibility-onetap' ) . ' ';
$html .= '
';
$html .= '
';
$html .= '
' . esc_html( $site_title ) . ' ';
$html .= '
' . $site_description . ' ';
$html .= '
';
$html .= '
' . esc_html( $label_checkbox ) . ' ';
$html .= '
';
// Loop for generata box.
foreach ( $icons as $icon_value => $icon_image ) {
$checked = ( isset( $value ) && $value === $icon_value ) ? 'checked' : '';
$html .= '
';
}
$html .= '
'; // .boxes.
$html .= '
'; // .box-control.
$html .= '
';
$html .= '
' . esc_html( $site_title ) . ' ';
$html .= '
' . esc_html( $site_description ) . ' ';
$html .= '
';
$html .= '
' . esc_html( $label_checkbox ) . ' ';
$html .= '
';
// Loop for generata box.
foreach ( $icons as $icon_value => $icon_image ) {
$checked = ( isset( $value ) && $value === $icon_value ) ? 'checked' : '';
$html .= '
';
}
$html .= '
'; // .boxes.
$html .= '
'; // .box-control.
$html .= '
';
$html .= '
' . esc_html( $site_title ) . ' ';
$html .= '
' . esc_html( $site_description ) . ' ';
$html .= '
';
$html .= '
' . esc_html( $label_checkbox ) . ' ';
$html .= '
';
// Loop for generata box.
foreach ( $icons as $icon_value => $icon_image ) {
$checked = ( isset( $value ) && $value === $icon_value ) ? 'checked' : '';
$html .= '
';
}
$html .= '
'; // .boxes.
$html .= '
' . esc_html__( 'Save Changes', 'accessibility-onetap' ) . ' ';
$html .= '
'; // .box-control.
$html .= '
';
$html .= '
' . esc_html( $site_title ) . ' ';
$html .= '
' . $site_description . ' ';
$html .= '
';
$html .= '
';
$html .= '
';
$html .= '';
$html .= esc_html__( 'Desktop', 'accessibility-onetap' );
$html .= ' ';
$html .= ' ';
$html .= '
';
$html .= '';
$html .= esc_html__( 'Tablet', 'accessibility-onetap' );
$html .= ' ';
$html .= ' ';
$html .= '
';
$html .= '';
$html .= esc_html__( 'Mobile', 'accessibility-onetap' );
$html .= ' ';
$html .= ' ';
$html .= '
';
$html .= '
';
$html .= '
';
$html .= '' . esc_html( $name ) . ' ';
$html .= '' . esc_html__( 'Save Changes', 'accessibility-onetap' ) . ' ';
$html .= '
';
$html .= '
';
$html .= '
' . esc_html( $site_title ) . ' ';
$html .= '
' . esc_html( $site_description ) . ' ';
$html .= '
';
$html .= '' . esc_html( $name ) . ' ';
$html .= '' . esc_html__( 'Save Changes', 'accessibility-onetap' ) . ' ';
$html .= '
';
$html .= '
';
$html .= '';
$html .= ' ';
$html .= ' ';
// List of allowed HTML elements.
$allowed_html = array(
'fieldset' => array(),
'label' => array(
'for' => array(),
),
'input' => array(
'type' => array(),
'class' => array(),
'id' => array(),
'name' => array(),
'value' => array(),
),
);
echo wp_kses( $html, $allowed_html );
}
/**
* Displays a custom input text for a settings field.
*
* @param array $args settings field args.
*/
public function callback_template_custom_input_text( $args ) {
$value = esc_attr( $this->get_option( $args['id'], $args['section'], $args['std'] ) );
$status = $args['status'] ? ' onetap-pro' : ' onetap-free';
$html = '';
$html .= '
';
$html .= '
';
$html .= '
';
$html .= '
';
$html .= '
';
if ( $args['status'] ) {
$value = false;
$html .= '' . esc_html__( 'PRO', 'accessibility-onetap' ) . ' ';
}
$html .= '' . esc_html( $args['name'] ) . ' ';
$html .= '' . esc_html( $args['desc'] ) . ' ';
$html .= '
';
$html .= '
';
$html .= '
';
$html .= '';
$html .= esc_html__( 'Custom Label', 'accessibility-onetap' );
$html .= ' ';
$html .= '
';
$html .= '
';
$html .= '';
$html .= ' ';
// List of allowed HTML elements.
$allowed_html = array(
'fieldset' => array(),
'label' => array(
'for' => array(),
),
'input' => array(
'type' => array(),
'class' => array(),
'id' => array(),
'name' => array(),
'value' => array(),
),
'br' => array(),
);
echo wp_kses( $html, $allowed_html );
}
/**
* Displays a radio button for a settings field.
*
* @param array $args settings field args.
*/
public function callback_radio( $args ) {
$value = $this->get_option( $args['id'], $args['section'], $args['std'] );
$html = '';
foreach ( $args['options'] as $key => $label ) {
$html .= '';
$html .= ' ';
// List of allowed HTML elements.
$allowed_html = array(
'fieldset' => array(),
'label' => array(
'for' => array(),
),
'input' => array(
'type' => array(),
'class' => array(),
'id' => array(),
'name' => array(),
'value' => array(),
),
'br' => array(),
);
echo wp_kses( $html, $allowed_html );
}
/**
* Displays a selectbox for a settings field.
*
* @param array $args settings field args.
*/
public function callback_select( $args ) {
$value = esc_attr( $this->get_option( $args['id'], $args['section'], $args['std'] ) );
$size = isset( $args['size'] ) && ! is_null( $args['size'] ) ? esc_attr( $args['size'] ) : 'regular';
$html = '';
foreach ( $args['options'] as $key => $label ) {
$html .= '' . esc_html( $label ) . ' ';
}
$html .= ' ';
$html .= $this->get_field_description( $args );
// List of allowed HTML elements.
$allowed_html = array(
'select' => array(
'class' => array(),
'name' => array(),
'id' => array(),
),
'option' => array(
'value' => array(),
'selected' => array(),
),
);
echo wp_kses( $html, $allowed_html );
}
/**
* Displays a selectbox for a settings field.
*
* @param array $args settings field args.
*/
public function callback_template_language( $args ) {
$value = esc_attr( $this->get_option( $args['id'], $args['section'], $args['std'] ) );
$size = isset( $args['size'] ) && ! is_null( $args['size'] ) ? esc_attr( $args['size'] ) : 'regular';
$name = isset( $args['name'] ) ? esc_html( $args['name'] ) : '';
$label_for = isset( $args['label_for'] ) ? esc_attr( $args['label_for'] ) : '';
$site_title = isset( $args['site_title'] ) ? esc_html( $args['site_title'] ) : '';
$site_description = isset( $args['site_description'] ) ? $args['site_description'] : '';
$html = '';
$html .= '
' . $site_title . ' ';
$html .= '
' . $site_description . ' ';
$html .= '
';
$html .= '' . $name . ' ';
$html .= '';
foreach ( $args['options'] as $key => $label ) {
$html .= '' . esc_html( $label ) . ' ';
}
$html .= ' ';
$html .= $this->get_field_description( $args );
$html .= '' . esc_html__( 'Save Changes', 'accessibility-onetap' ) . ' ';
$html .= '
';
$html .= '
';
$html .= '
' . $site_title . ' ';
$html .= '
' . $site_description . ' ';
$html .= '
';
$html .= '' . $name . ' ';
$html .= '';
foreach ( $args['options'] as $key => $label ) {
$html .= '' . esc_html( $label ) . ' ';
}
$html .= ' ';
$html .= $this->get_field_description( $args );
$html .= '' . esc_html__( 'Save Changes', 'accessibility-onetap' ) . ' ';
$html .= '
';
$html .= '
';
$editor_settings = array(
'teeny' => true,
'textarea_name' => $args['section'] . '[' . $args['id'] . ']',
'textarea_rows' => 10,
);
if ( isset( $args['options'] ) && is_array( $args['options'] ) ) {
$editor_settings = array_merge( $editor_settings, $args['options'] );
}
$html .= wp_editor( $value, $args['section'] . '-' . $args['id'], $editor_settings );
$html .= '
';
$html .= wp_kses_post( $this->get_field_description( $args ) );
return $html;
}
/**
* Displays a file upload field for a settings field.
*
* @param array $args settings field args.
*/
public function callback_file( $args ) {
$value = esc_attr( $this->get_option( $args['id'], $args['section'], $args['std'] ) );
$size = isset( $args['size'] ) && ! is_null( $args['size'] ) ? esc_attr( $args['size'] ) : 'regular';
$id = esc_attr( $args['section'] ) . '[' . esc_attr( $args['id'] ) . ']';
$label = isset( $args['options']['button_label'] ) ? esc_html( $args['options']['button_label'] ) : esc_html__( 'Choose File', 'accessibility-onetap' );
$html = '';
$html .= '
' . esc_html( $site_title ) . ' ';
$html .= '
' . $site_description . ' ';
$html .= '
';
$html .= '' . esc_html( $name ) . ' ';
$html .= '' . esc_html__( 'Save Changes', 'accessibility-onetap' ) . ' ';
$html .= '
';
$html .= '
';
$html .= '' . esc_html( $group_title ) . ' ';
$html .= '' . esc_html( $group_description ) . ' ';
$html .= '
';
// List of allowed HTML elements.
$allowed_html = array(
'div' => array(
'class' => array(),
),
'span' => array(
'id' => array(),
'class' => array(),
),
);
echo wp_kses( $html, $allowed_html );
}
/**
* Display save changes.
*/
public function callback_template_save_changes() {
$html = '' . esc_html__( 'Save Changes', 'accessibility-onetap' ) . ' ';
// List of allowed HTML elements.
$allowed_html = array(
'button' => array(
'class' => array(),
),
);
echo wp_kses( $html, $allowed_html );
}
/**
* Displays a checkbox for a settings field.
*
* @param array $args settings field args.
*/
public function callback_template_checkbox( $args ) {
$value = esc_attr( $this->get_option( $args['id'], $args['section'], $args['std'] ) );
$status = $args['status'] ? ' onetap-pro' : ' onetap-free';
$html = '';
$html .= '
';
$html .= '
';
$html .= '
';
$html .= '
';
$html .= '
';
if ( $args['status'] ) {
$value = false;
$html .= '' . esc_html__( 'PRO', 'accessibility-onetap' ) . ' ';
}
$html .= '' . esc_html( $args['name'] ) . ' ';
$html .= '' . esc_html( $args['desc'] ) . ' ';
$html .= '
';
$html .= '
';
$html .= '
';
$html .= '';
$html .= ' ';
$html .= '
';
$html .= '
';
$count = count( $this->settings_sections );
// Don't show the navigation if only one section exists.
if ( 1 === $count ) {
return;
}
foreach ( $this->settings_sections as $tab ) {
$html .= '' . esc_html( $tab['title'] ) . ' ';
}
$html .= ' ';
echo wp_kses(
$html,
array(
'h2' => array(),
'a' => array(
'href' => array(),
'class' => array(),
'id' => array(),
),
)
);
}
/**
* Show the section settings forms.
*
* This function displays every sections in a different form.
*/
public function show_forms() {
?>