settings_sections = $sections; return $this; } /** * Add a single section * * @since 1.8.0 * @param array $section */ function add_section( $section ) { $this->settings_sections[] = $section; return $this; } /** * Set settings fields * * @since 1.8.0 * @param array $fields settings fields array */ function set_fields( $fields ) { $this->settings_fields = $fields; return $this; } /** * Add settings fields * * @since 1.8.0 * @param string $section settings section * @param array $fields field args */ function add_field( $section, $field ) { $defaults = array( 'name' => '', 'label' => '', 'desc' => '', 'desc_paragraph' => '', 'note' => '', 'note_paragraph' => '', 'type' => 'text', 'disabled' => false, ); $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. * * @since 1.8.0 */ function admin_init() { // Register settings sections foreach ( $this->settings_sections as $section ) { if ( $this->is_tab_linked( $section ) ) continue; 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 $section['desc']; }; } else if ( 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'] ) ? $option['class'] : $name, 'label_for' => "{$section}[{$name}]", 'desc' => isset( $option['desc'] ) ? $option['desc'] : '', 'no_desc_p' => isset( $option['no_desc_p'] ) ? $option['no_desc_p'] : false, 'note' => isset( $option['note'] ) ? $option['note'] : '', 'no_note_p' => isset( $option['no_note_p'] ) ? $option['no_note_p'] : false, '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'] : '', 'disabled' => isset( $option['disabled'] ) ? 'disabled' : '', ); 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' ) ); } } /** * Returns the field description markup * * @since 1.8.0 * @param array $args settings field args */ public function get_field_description( $args ) { if ( ! empty( $args['desc'] ) ) { $before = ''; $after = ''; if ( false === $args['no_desc_p'] ) { $before = '
'; $after = '
'; } $desc = $before . $args['desc'] . $after; } else { $desc = ''; } return $desc; } /** * Returns the field notice markup * * @since 1.8.0 */ function get_field_note( $args ) { if ( ! empty( $args['note'] ) ) { $before = ''; $after = ''; if ( false === $args['no_note_p'] ) { $before = ''; $after = '
'; } $note = $before . $args['note'] . $after; } else { $note = ''; } return $note; } /** * Displays a text field for a settings field * * @since 1.8.0 * @param array $args settings field args */ 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'] ) ? '' : ' placeholder="' . $args['placeholder'] . '"'; $html = sprintf( '', $type, $size, $args['section'], $args['id'], $value, $placeholder ); $html .= $this->get_field_description( $args ); $html .= $this->get_field_note( $args ); echo $html; } /** * Displays a url field for a settings field * * @since 1.8.0 * @param array $args settings field args */ function callback_url( $args ) { $this->callback_text( $args ); } /** * Displays a number field for a settings field * * @since 1.8.0 * @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 = empty( $args['min'] ) ? '' : ' min="' . $args['min'] . '"'; $max = empty( $args['max'] ) ? '' : ' max="' . $args['max'] . '"'; $step = empty( $args['max'] ) ? '' : ' step="' . $args['step'] . '"'; $html = sprintf( '', $type, $size, $args['section'], $args['id'], $value, $placeholder, $min, $max, $step ); $html .= $this->get_field_description( $args ); $html .= $this->get_field_note( $args ); echo $html; } /** * Displays a checkbox for a settings field * * @since 1.8.0 * @param array $args settings field args */ function callback_checkbox( $args ) { $value = esc_attr( $this->get_option( $args['id'], $args['section'], $args['std'] ) ); $html = ''; echo $html; } /** * Displays a multicheckbox for a settings field * * @since 1.8.0 * @param array $args settings field args */ function callback_multicheck( $args ) { $value = $this->get_option( $args['id'], $args['section'], $args['std'] ); $html = ''; echo $html; } /** * Displays a radio button for a settings field * * @since 1.8.0 * @param array $args settings field args */ function callback_radio( $args ) { $value = $this->get_option( $args['id'], $args['section'], $args['std'] ); $html = ''; echo $html; } /** * Displays a selectbox for a settings field * * @since 1.8.0 * @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( '' ); $html .= $this->get_field_description( $args ); $html .= $this->get_field_note( $args ); echo $html; } /** * Displays a textarea for a settings field * * @since 1.8.0 * @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 ); $html .= $this->get_field_note( $args ); echo $html; } /** * Displays the html for a settings field * * @since 1.8.0 * @param array $args settings field args * @return string */ function callback_html( $args ) { $html = $this->get_field_description( $args ); $html .= $this->get_field_note( $args ); echo $html; } /** * Displays a rich text textarea for a settings field * * @since 1.8.0 * @param array $args settings field args */ function callback_wysiwyg( $args ) { $value = $this->get_option( $args['id'], $args['section'], $args['std'] ); $size = isset( $args['size'] ) && !is_null( $args['size'] ) ? $args['size'] : '500px'; echo '