*/ class UsersWP_Admin_Settings { /** * Setting pages. * * @var array */ private static $settings = array(); /** * Error messages. * * @var array */ private static $errors = array(); /** * Update messages. * * @var array */ private static $messages = array(); public function __construct() { } /** * Include the settings page classes. */ public static function get_settings_pages() { if ( empty( self::$settings ) ) { $settings = array(); $settings[] = include 'class-uwp-settings-general.php'; $settings[] = include 'class-uwp-settings-redirects.php'; $settings[] = include 'class-uwp-settings-emails.php'; $settings[] = include 'class-uwp-settings-import-export.php'; $settings[] = include 'class-uwp-settings-addons.php'; $settings[] = include 'class-uwp-settings-uninstall.php'; self::$settings = apply_filters( 'uwp_get_settings_pages', $settings ); } return self::$settings; } /** * Save the settings. */ public static function save() { global $current_tab; if ( empty( $_REQUEST['_wpnonce'] ) || ! wp_verify_nonce( $_REQUEST['_wpnonce'], 'userswp-settings' ) ) { die( esc_html__( 'Action failed. Please refresh the page and retry.', 'userswp' ) ); } // Trigger actions do_action( 'uwp_settings_save_' . $current_tab ); do_action( 'uwp_update_options_' . $current_tab ); do_action( 'uwp_update_options' ); self::add_message( __( 'Your settings have been saved.', 'userswp' ) ); // Clear flush rules wp_schedule_single_event( time(), 'uwp_flush_rewrite_rules' ); do_action( 'uwp_settings_saved' ); } /** * Add a message. * @param string $text */ public static function add_message( $text ) { self::$messages[] = $text; } /** * Add an error. * @param string $text */ public static function add_error( $text ) { self::$errors[] = $text; } /** * Output messages + errors. */ public static function show_messages() { if ( sizeof( self::$errors ) > 0 ) { foreach ( self::$errors as $error ) { echo '

' . esc_html( $error ) . '

'; } } elseif ( sizeof( self::$messages ) > 0 ) { foreach ( self::$messages as $message ) { echo '

' . esc_html( $message ) . '

'; } } } /** * Settings page. * * Handles the display of the main userswp settings page in admin. */ public static function output( $tab = '' ) { global $current_section, $current_tab; do_action( 'uwp_settings_start' ); // Include settings pages self::get_settings_pages(); // Get current tab/section if ( $tab ) { $current_tab = sanitize_title( $tab ); } else { $current_tab = empty( $_GET['tab'] ) ? 'general' : sanitize_title( $_GET['tab'] ); } $current_section = empty( $_REQUEST['section'] ) ? '' : sanitize_title( $_REQUEST['section'] ); // Save settings if data has been posted if ( ! empty( $_POST ) ) { self::save(); } // Add any posted messages if ( ! empty( $_GET['uwp_error'] ) ) { self::add_error( stripslashes( $_GET['uwp_error'] ) ); } if ( ! empty( $_GET['uwp_message'] ) ) { self::add_message( stripslashes( $_GET['uwp_message'] ) ); } // Get tabs for the settings page $tabs = apply_filters( 'uwp_settings_tabs_array', array() ); include USERSWP_PATH . '/admin/views/html-admin-settings.php'; } /** * Output admin fields. * * Loops though the userswp options array and outputs each field. * * @param array $options Opens array to output */ public static function output_fields( $options ) { foreach ( $options as $value ) { if ( ! isset( $value['type'] ) ) { continue; } if ( ! isset( $value['id'] ) ) { $value['id'] = ''; } if ( ! isset( $value['title'] ) ) { $value['title'] = isset( $value['name'] ) ? $value['name'] : ''; } if ( ! isset( $value['class'] ) ) { $value['class'] = ''; } if ( ! isset( $value['css'] ) ) { $value['css'] = ''; } if ( ! isset( $value['default'] ) ) { $value['default'] = ''; } if ( ! isset( $value['desc'] ) ) { $value['desc'] = ''; } if ( ! isset( $value['desc_tip'] ) ) { $value['desc_tip'] = false; } if ( ! isset( $value['placeholder'] ) ) { $value['placeholder'] = ''; } // Custom attribute handling $custom_attributes = array(); if ( ! empty( $value['custom_attributes'] ) && is_array( $value['custom_attributes'] ) ) { foreach ( $value['custom_attributes'] as $attribute => $attribute_value ) { $custom_attributes[] = esc_attr( $attribute ) . '="' . esc_attr( $attribute_value ) . '"'; } } $wrap_class = $value['id'] . '-wrap'; // Description handling $field_description = self::get_field_description( $value ); $tooltip_html = $field_description['tooltip_html'] ? $field_description['tooltip_html'] : ''; $description = $field_description['description'] ? $field_description['description'] : ''; // Switch based on type switch ( $value['type'] ) { // Section Titles case 'title': if ( ! empty( $value['title'] ) ) { echo '

'; echo esc_html( $value['title'] ); if ( ! empty( $value['title_html'] ) ) { echo $value['title_html'];} // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped if ( isset( $value['desc_tip'] ) && $value['desc_tip'] ) { echo $tooltip_html; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped } echo '

'; } if ( ! empty( $value['desc'] ) && ( ! isset( $value['desc_tip'] ) || ! $value['desc_tip'] ) ) { echo wpautop( wptexturize( wp_kses_post( $value['desc'] ) ) ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped } echo '' . "\n\n"; if ( ! empty( $value['id'] ) ) { do_action( 'uwp_settings_' . sanitize_title( $value['id'] ) ); } break; // Section Ends case 'sectionend': if ( ! empty( $value['id'] ) ) { do_action( 'uwp_settings_' . sanitize_title( $value['id'] ) . '_end' ); } echo '
'; if ( ! empty( $value['id'] ) ) { do_action( 'uwp_settings_' . sanitize_title( $value['id'] ) . '_after' ); } break; // Standard text inputs and subtypes like 'number' case 'text': case 'email': case 'number': case 'url': case 'password': if ( isset( $value['value'] ) ) { $option_value = $value['value']; } else { $option_value = self::get_option( $value['id'], $value['default'] ); } ?> /> '; } else { $show_img = wp_get_attachment_image( $option_value, $image_size ); } } else { $remove_class = 'hidden'; $show_img = ''; } ?>
= 3.3 && function_exists( 'wp_editor' ) ) { wp_editor( stripslashes( $option_value ), $value['id'], array( 'textarea_name' => esc_attr( $value['id'] ), 'textarea_rows' => $rows, 'media_buttons' => false, 'editor_class' => 'uwp-wp-editor', 'editor_height' => 16 * $rows, ) ); } else { ?>
$title ) { if ( ! empty( $option_value ) && is_array( $option_value ) && in_array( $key, $option_value ) ) { $checked = true; } else { $checked = false; } ?>
/>
$value['id'], 'id' => $value['id'], 'sort_column' => 'menu_order', 'sort_order' => 'ASC', 'show_option_none' => ' ', 'class' => ' regular-text aui-select2 ' . $value['class'], 'echo' => false, 'selected' => (int) $option_value > 0 ? (int) $option_value : -1, ); if ( isset( $value['args'] ) ) { $args = wp_parse_args( $value['args'], $args ); } ?> 0 ) { ?> /> get_icons(); ?> " . __( 'Documentation', 'userswp' ) . ' '; if ( in_array( $value['type'], array( 'checkbox' ) ) ) { $description .= $docs_link; } else { $tooltip_html .= $docs_link; } } if ( $description && in_array( $value['type'], array( 'textarea', 'radio' ) ) ) { $description = '

' . wp_kses_post( $description ) . '

'; } elseif ( $description && in_array( $value['type'], array( 'checkbox' ) ) ) { $description = wp_kses_post( $description ); } elseif ( $description ) { $description = '' . wp_kses_post( $description ) . ''; } if ( $tooltip_html && in_array( $value['type'], array( 'checkbox' ) ) ) { $tooltip_html = '

' . $tooltip_html . '

'; } elseif ( $tooltip_html ) { $tooltip_html = uwp_help_tip( $tooltip_html ); } return array( 'description' => $description, 'tooltip_html' => $tooltip_html, ); } public function uwp_get_settings() { $settings = get_option( 'uwp_settings' ); if ( empty( $settings ) ) { // Update old settings with new single option $general_settings = is_array( get_option( 'uwp_settings_general' ) ) ? get_option( 'uwp_settings_general' ) : array(); $ext_settings = is_array( get_option( 'uwp_settings_extensions' ) ) ? get_option( 'uwp_settings_extensions' ) : array(); $settings = array_merge( $general_settings, $ext_settings ); update_option( 'uwp_settings', $settings ); } return apply_filters( 'uwp_get_settings', $settings ); } /** * Save admin fields. * * Loops though the userswp options array and outputs each field. * * @param array $options Options array to output * @param array $data Optional. Data to use for saving. Defaults to $_POST. * @return bool */ public static function save_fields( $options, $data = null ) { if ( is_null( $data ) ) { $data = $_POST; } if ( empty( $data ) ) { return false; } // Options to update will be stored here and saved later. $update_options = array(); // Loop options and get values to save. foreach ( $options as $option ) { if ( ! isset( $option['id'] ) || ! isset( $option['type'] ) ) { continue; } // Get posted value. if ( strstr( $option['id'], '[' ) ) { parse_str( $option['id'], $option_name_array ); $option_name = current( array_keys( $option_name_array ) ); $setting_name = key( $option_name_array[ $option_name ] ); $raw_value = isset( $data[ $option_name ][ $setting_name ] ) ? wp_unslash( $data[ $option_name ][ $setting_name ] ) : null; } else { $option_name = $option['id']; $setting_name = ''; $raw_value = isset( $data[ $option['id'] ] ) ? wp_unslash( $data[ $option['id'] ] ) : null; } // Format the value based on option type. switch ( $option['type'] ) { case 'checkbox': $value = '1' === $raw_value ? 1 : 0; break; case 'textarea': case 'editor': $value = wp_kses_post( trim( $raw_value ) ); break; case 'multiselect': case 'multi_select_countries': $value = array_filter( array_map( 'uwp_clean', (array) $raw_value ) ); break; case 'multicheckbox': $value = array_map( 'uwp_clean', (array) $raw_value ); break; case 'image_width': $value = array(); if ( isset( $raw_value['width'] ) ) { $value['width'] = uwp_clean( $raw_value['width'] ); $value['height'] = uwp_clean( $raw_value['height'] ); $value['crop'] = isset( $raw_value['crop'] ) ? 1 : 0; } else { $value['width'] = $option['default']['width']; $value['height'] = $option['default']['height']; $value['crop'] = $option['default']['crop']; } break; case 'select': $allowed_values = empty( $option['options'] ) ? array() : array_keys( $option['options'] ); if ( empty( $option['default'] ) && empty( $allowed_values ) ) { $value = null; break; } $default = ( empty( $option['default'] ) ? $allowed_values[0] : $option['default'] ); $value = in_array( $raw_value, $allowed_values ) ? $raw_value : $default; break; default: $value = uwp_clean( $raw_value ); break; } /** * Sanitize the value of an option. */ $value = apply_filters( 'uwp_admin_settings_sanitize_option', $value, $option, $raw_value ); /** * Sanitize the value of an option by option name. */ $value = apply_filters( "uwp_admin_settings_sanitize_option_$option_name", $value, $option, $raw_value ); if ( is_null( $value ) ) { continue; } // Check if option is an array and handle that differently to single values. if ( $option_name && $setting_name ) { if ( ! isset( $update_options[ $option_name ] ) ) { $update_options[ $option_name ] = self::get_option( $option_name, array() ); } if ( ! is_array( $update_options[ $option_name ] ) ) { $update_options[ $option_name ] = array(); } $update_options[ $option_name ][ $setting_name ] = $value; } else { $update_options[ $option_name ] = $value; } } // Save all options in our array. foreach ( $update_options as $name => $value ) { uwp_update_option( $name, $value ); } return true; } /** * Get a setting from the settings API. * * @param mixed $option_name * @param mixed $default * @return string */ public static function get_option( $option_name, $default = '' ) { return uwp_get_option( $option_name, $default ); } }