settings_sections = $sections;
return $this;
}
/**
* Add a single section
*
* @param array $section
*/
function add_section($section) {
$this->settings_sections[] = $section;
return $this;
}
/**
* Set settings fields
*
* @param array $fields settings fields array
*/
function set_fields($fields) {
$this->settings_fields = $fields;
return $this;
}
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;
}
function 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) {
if ($section['id'] == 'ultimate_store_kit_api_settings') {
$section_class = ' bdt-child-width-1-3@xl';
} else {
$section_class = ' bdt-grid-small bdt-child-width-1-4@xl';
}
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 '
';
$this->do_settings_fields($page, $section['id']);
echo '
';
}
}
function 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 .= ' ' . esc_attr($field['args']['class']);
}
if (!empty($field['args']['widget_type'])) {
$class .= ' usk-widget-' . esc_attr($field['args']['widget_type']);
}
if (!empty($field['args']['widget_type']) && 'pro' == $field['args']['widget_type'] && true !== _is_usk_pro_activated()) {
$class .= ' usk-pro-inactive';
}
$used_widgets = self::get_used_widgets_obj();
$widget_name = 'usk-' . str_replace(' ', '-', strtolower($field['args']['id']));
$used_widgets_count = 0;
if (isset($used_widgets)) {
$used_widgets_count = (in_array($widget_name, array_keys($used_widgets)) ? $used_widgets[$widget_name] : 0);
if ($used_widgets_count === 0) {
$widget_name = str_replace('_', '-', $widget_name);
$used_widgets_count = (in_array($widget_name, array_keys($used_widgets)) ? $used_widgets[$widget_name] : 0);
}
}
$widget_used_status = ' usk-used'; // default used class
if ($used_widgets_count === 0) {
$widget_used_status = ' usk-unused'; // replace by unused class
}
$data_type = ' data-widget-type="' . esc_attr($field['args']['widget_type']) . '" data-content-type="' . esc_attr($field['args']['content_type']) . esc_attr($widget_used_status) . '" data-widget-name="' . strtolower($field['args']['name']) . '"';
if (!empty($field['args']['widget_type']) && 'pro' == $field['args']['widget_type'] && true !== _is_usk_pro_activated()) {
$data_type .= ' bdt-tooltip="Pro widget only works with Pro version."';
}
printf( '', esc_attr( $class ), esc_attr( $widget_used_status ), wp_kses_post( $data_type ) );
call_user_func($field['callback'], $field['args']);
echo '
';
}
}
/**
* 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.
*/
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'] = '' . esc_html($section['desc']) . '
';
$callback = function () use ($section) {
echo wp_kses_post(str_replace('"', '\"', esc_html($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'] : '';
$callback = isset($option['callback']) ? $option['callback'] : array($this, 'callback_' . $type);
$args = array(
'id' => $name,
'class' => isset($option['class']) ? 'bdt-' . $name . ' ' . $option['class'] : 'bdt-' . $name,
'label_for' => "bdt-{$section}[{$name}]",
'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'] : '',
'plugin_name' => !empty($option['plugin_name']) ? $option['plugin_name'] : null,
'plugin_path' => !empty($option['plugin_path']) ? $option['plugin_path'] : null,
'paid' => !empty($option['paid']) ? $option['paid'] : null,
'widget_type' => !empty($option['widget_type']) ? $option['widget_type'] : null,
'content_type' => !empty($option['content_type']) ? $option['content_type'] : null,
'demo_url' => !empty($option['demo_url']) ? $option['demo_url'] : null,
'video_url' => !empty($option['video_url']) ? $option['video_url'] : null,
);
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
', esc_html($args['desc']));
} else {
$desc = '';
}
return $desc;
}
public function get_control_output($output) {
$tags = [
'div' => ['class' => [], 'bdt-grid' => []],
'a' => ['href' => [], 'id' => [], 'target' => [], 'class' => [], 'data-bdt-tooltip' => [], 'data-tab-index' => []],
'label' => ['for' => []],
'span' => ['scope' => [], 'class' => []],
'input' => ['type' => [], 'class' => [], 'id' => [], 'name' => [], 'value' => [], 'placeholder' => [], 'checked' => []],
'i' => ['class' => [], 'aria-hidden' => []],
'fieldset' => [],
'br' => [],
'select' => [
'class' => [],
'name' => [],
'id' => [],
],
'option' => [
'value' => [],
'selected' => []
],
'h3' => [
'class' => []
],
'hr' => [
'class' => []
],
'ul' => [
'class' => [],
'bdt-tab' => [],
],
'li' => [],
];
if (isset($output)) {
echo wp_kses($output, $tags);
}
}
/**
* Displays a text field for a settings field
*
* @param array $args settings field args
*/
function callback_text($args) {
$value = esc_attr($this->get_option($args['id'], $args['section'], $args['std']));
$class = 'bdt-input';
$type = isset($args['type']) ? $args['type'] : 'text';
$placeholder = empty($args['placeholder']) ? '' : ' placeholder="' . $args['placeholder'] . '"';
$html = '';
$html .= '';
if ($args['video_url']) {
$html .= '
';
}
$html .= sprintf('
', $args['section'], $args['id']);
$html .= '' . $args['name'] . ' ';
$html .= ' ';
$html .= sprintf('
', $type, $class, $args['section'], $args['id'], $value, $placeholder);
$html .= $this->get_field_description($args);
$html .= '
';
$this->get_control_output($html);
}
/**
* Displays a url field for a settings field
*
* @param array $args settings field args
*/
function callback_url($args) {
$this->callback_text($args);
}
/**
* Displays a number field for a settings field
*
* @param array $args settings field args
*/
function callback_number($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'] : 'number';
$placeholder = empty($args['placeholder']) ? '' : ' placeholder="' . $args['placeholder'] . '"';
$min = ($args['min'] == '') ? '' : ' min="' . $args['min'] . '"';
$max = ($args['max'] == '') ? '' : ' max="' . $args['max'] . '"';
$step = ($args['step'] == '') ? '' : ' step="' . $args['step'] . '"';
$html = sprintf(' ', $type, $size, $args['section'], $args['id'], $value, $placeholder, $min, $max, $step);
$html .= $this->get_field_description($args);
$this->get_control_output($html);
}
/**
* Get used widgets.
*
* @access public
* @since 6.0.0
*
* @return array
*/
public static function get_used_widgets_obj() {
return UltimateStoreKit_Admin_Settings::get_used_widgets();
}
/**
* Get unused widgets.
*
* @access public
* @since 6.0.0
*
* @return array
*/
public static function get_unused_widgets_obj() {
return UltimateStoreKit_Admin_Settings::get_unused_widgets();
}
/**
* Displays a checkbox for a settings field
*
* @param array $args settings field args
*/
/**
* Displays a checkbox for a settings field
*
* @param array $args settings field args
*/
function callback_checkbox($args) {
$value = esc_attr($this->get_option($args['id'], $args['section'], $args['std']));
$plugin_name = isset($args['plugin_name']) ? $args['plugin_name'] : '';
$plugin_path = isset($args['plugin_path']) ? $args['plugin_path'] : '';
$paid = isset($args['paid']) ? $args['paid'] : '';
$used_widgets = self::get_used_widgets_obj();
$widget_name = 'usk-' . $args['id'];
$used_widgets_count = 0;
if (isset($used_widgets)) {
$used_widgets_count = (in_array($widget_name, array_keys($used_widgets)) ? $used_widgets[$widget_name] : 0);
if ($used_widgets_count === 0) {
$widget_name = str_replace('_', '-', $widget_name);
$used_widgets_count = (in_array($widget_name, array_keys($used_widgets)) ? $used_widgets[$widget_name] : 0);
}
}
$widget_using_status = ' Total Used - ' . esc_html($used_widgets_count) . ' ';
// remove counts
if (isset($args['id']) && $args['id'] == 'not') {
$widget_using_status = '';
}
$html = '';
$html .= '';
$html .= '
';
$html .= '
';
$html .= '
';
$html .= sprintf('
', $args['section'], $args['id']);
$html .= '' . $args['name'] . $widget_using_status;
$html .= ' ';
if ($args['demo_url']) {
$html .= '
';
}
if ($args['video_url']) {
$html .= '
';
}
$html .= '
';
$html .= '
';
// 3rd party widgets
if ($plugin_name and $plugin_path) {
if ($this->_is_plugin_installed($plugin_name, $plugin_path)) {
if (!current_user_can('activate_plugins')) {
return;
}
if (!is_plugin_active($plugin_path)) {
$active_link = wp_nonce_url('plugins.php?action=activate&plugin=' . $plugin_path . '&plugin_status=all&paged=1&s', 'activate-plugin_' . $plugin_path);
$html .= '
';
}
} else {
if ($paid) {
$html .= '
';
} else {
$install_link = wp_nonce_url(self_admin_url('update.php?action=install-plugin&plugin=' . $plugin_name), 'install-plugin_' . $plugin_name);
$html .= '
';
}
}
if ($this->_is_plugin_installed($plugin_name, $plugin_path) and is_plugin_active($plugin_path)) {
$html .= '
';
$html .= sprintf('', $args['section'], $args['id']);
$html .= sprintf(' ', $args['section'], $args['id']);
$html .= sprintf(' ', $args['section'], $args['id'], checked($value, 'on', false));
$html .= ' ';
$html .= ' ';
$html .= ' ';
}
} else { // core widgets
$html .= '
';
$html .= sprintf('', $args['section'], $args['id']);
$html .= sprintf(' ', $args['section'], $args['id']);
$html .= sprintf(' ', $args['section'], $args['id'], checked($value, 'on', false));
$html .= ' ';
$html .= ' ';
$html .= ' ';
}
$html .= '
';
$html .= '
';
$html .= '
';
$this->get_control_output($html);
}
function _is_plugin_installed($plugin, $plugin_path) {
$installed_plugins = get_plugins();
return isset($installed_plugins[$plugin_path]);
}
/**
* Displays a multicheckbox for a settings field
*
* @param array $args settings field args
*/
function callback_multicheck($args) {
$value = $this->get_option($args['id'], $args['section'], $args['std']);
$html = '';
$html .= sprintf(' ', $args['section'], $args['id']);
foreach ($args['options'] as $key => $label) {
$checked = isset($value[$key]) ? $value[$key] : '0';
$html .= sprintf('', $args['section'], $args['id'], $key);
$html .= sprintf(' ', $args['section'], $args['id'], $key, checked($checked, $key, false));
$html .= ' ';
$html .= sprintf('%1$s ', $label);
}
$html .= $this->get_field_description($args);
$html .= ' ';
$this->get_control_output($html);
}
/**
* Displays a radio button for a settings field
*
* @param array $args settings field args
*/
function callback_radio($args) {
$value = $this->get_option($args['id'], $args['section'], $args['std']);
$html = '';
foreach ($args['options'] as $key => $label) {
$html .= sprintf('', $args['section'], $args['id'], $key);
$html .= sprintf(' ', $args['section'], $args['id'], $key, checked($value, $key, false));
$html .= sprintf('%1$s ', $label);
}
$html .= $this->get_field_description($args);
$html .= ' ';
$this->get_control_output($html);
}
/**
* Displays a selectbox for a settings field
*
* @param array $args settings field args
*/
function callback_select($args) {
$value = esc_attr($this->get_option($args['id'], $args['section'], $args['std']));
$size = isset($args['size']) && !is_null($args['size']) ? $args['size'] : 'regular';
$html = sprintf('', $size, $args['section'], $args['id']);
foreach ($args['options'] as $key => $label) {
$html .= sprintf('%s ', $key, selected($value, $key, false), $label);
}
$html .= sprintf(' ');
$html .= $this->get_field_description($args);
$this->get_control_output($html);
}
/**
* Displays a textarea for a settings field
*
* @param array $args settings field args
*/
function callback_textarea($args) {
$value = esc_textarea($this->get_option($args['id'], $args['section'], $args['std']));
$size = isset($args['size']) && !is_null($args['size']) ? $args['size'] : 'regular';
$placeholder = empty($args['placeholder']) ? '' : ' placeholder="' . $args['placeholder'] . '"';
$html = sprintf('', $size, $args['section'], $args['id'], $placeholder, $value);
$html .= $this->get_field_description($args);
$this->get_control_output($html);
}
/**
* Displays the html for a settings field
*
* @param array $args settings field args
* @return string
*/
function callback_html($args) {
echo esc_html($args['desc']);
}
/**
* Displays a 2 colspan subheading field for a settings field
*
* @param array $args settings field args
*/
function callback_subheading($args) {
$html = '' . $args['name'] . ' ';
$html .= $this->get_field_description($args);
$html .= ' ';
$this->get_control_output($html);
}
function callback_start_group($args) {
$html = '';
$html .= sprintf('
', $args['section'], $args['id']);
$html .= '' . $args['name'] . ' ';
$html .= ' ';
if ($args['video_url']) {
$html .= '
';
}
$html .= $this->get_field_description($args);
$html .= '
';
$this->get_control_output($html);
}
function callback_end_group($args) {
$html = '
';
$html .= '
';
$this->get_control_output($html);
}
/**
* Displays a 2 colspan separator field for a settings field
*
* @param array $args settings field args
*/
function callback_separator($args) {
$html = ' ';
$html .= $this->get_field_description($args);
$this->get_control_output($html);
}
/**
* Displays a select box for creating the pages select box
*
* @param array $args settings field args
*/
function callback_pages($args) {
$dropdown_args = array(
'selected' => esc_attr($this->get_option($args['id'], $args['section'], $args['std'])),
'name' => $args['section'] . '[' . $args['id'] . ']',
'id' => $args['section'] . '[' . $args['id'] . ']',
'echo' => 0
);
$html = wp_dropdown_pages($dropdown_args);
$this->get_control_output($html);
}
/**
* Sanitize callback for Settings API
*
* @return mixed
*/
function sanitize_options($options) {
if (!$options) {
return $options;
}
foreach ($options as $option_slug => $option_value) {
$sanitize_callback = $this->get_sanitize_callback($option_slug);
// If callback is set, call it
if ($sanitize_callback) {
$options[$option_slug] = call_user_func($sanitize_callback, $option_value);
continue;
}
}
return $options;
}
/**
* Get sanitization callback for given option slug
*
* @param string $slug option slug
*
* @return mixed string or bool false
*/
function get_sanitize_callback($slug = '') {
if (empty($slug)) {
return false;
}
// Iterate over registered fields and see if we can find proper callback
foreach ($this->settings_fields as $section => $options) {
foreach ($options as $option) {
if ($option['name'] != $slug) {
continue;
}
// Return the callback name
return isset($option['sanitize_callback']) && is_callable($option['sanitize_callback']) ? $option['sanitize_callback'] : false;
}
}
return false;
}
/**
* Get the value of a settings field
*
* @param string $option settings field name
* @param string $section the section name this field belongs to
* @param string $default default text if it's not found
* @return string
*/
function get_option($option, $section, $default = '') {
$options = get_option($section);
if (isset($options[$option])) {
return $options[$option];
}
return $default;
}
/**
* Show navigations as tab
*
* Shows all the settings section labels as tab
*/
/**
* Show navigations as tab
*
* Shows all the settings section labels as tab
*/
function show_navigation() {
$html = '';
$html .= '
';
$html .= sprintf('%2$s ', 'ultimate_store_kit_welcome', 'Dashboard');
$count = 1;
foreach ($this->settings_sections as $tab) {
$html .= sprintf('%3$s ', $tab['id'], $count++, $tab['title']);
}
if (true !== _is_usk_pro_activated()) {
$html .= sprintf('%2$s ', 'pixel_gallery_get_pro', 'Get Pro');
}
// if ( !defined('BDTUSK_LO') ) {
// $html .= sprintf('%3$s ', 'pixel_gallery_license_settings', $count, 'License');
// }
if ((true == _is_usk_pro_activated()) && !defined('BDTUSK_LO')) {
$html .= sprintf('%2$s ', 'pixel_gallery_license_settings', 'License');
}
$html .= ' ';
$html .= '
';
echo wp_kses_post($this->get_control_output($html));
}
/**
* Custom sanitizer for option array element sanitize
* At first getting the full array then sanitize each element after sanitize them return again to array.
* @param array $post_data [description]
* @return array [description]
*/
function sanitize_usk_options($post_data) {
if (isset($post_data)) {
foreach ($post_data as $key => $value) {
$_options[sanitize_key($key)] = sanitize_key($value);
}
return $_options;
}
}
function ultimate_store_kit_settings_save() {
if (!check_ajax_referer('ultimate-store-kit-settings-save-nonce')) {
wp_send_json_error();
}
if (!current_user_can('manage_options')) {
return;
}
$moudle_id = sanitize_key($_POST['id']);
unset($_POST['id']);
$options = $this->sanitize_usk_options($_POST[$moudle_id]);
update_option($moudle_id, $options);
wp_send_json_success();
}
/**
* Show the section settings forms
*
* This function displays every sections in a different form
*/
/**
* Show the section settings forms
*
* This function displays every sections in a different form
*/
function show_forms() {
?>
settings_sections as $form) {
$i++; ?>