meets_requirements() ) { $action_url = network_admin_url( 'settings.php' ); $hidden_fields_cb = array( $network_admin, 'settings_fields' ); } else { $action_url = admin_url( 'options.php' ); $hidden_fields_cb = 'settings_fields'; } echo '
'; call_user_func( $hidden_fields_cb, $option_long_name ); } $this->set_option( $option ); } /** * Set the option used in output for form elements * * @since 2.0 * * @param string $option_name Option key. */ public function set_option( $option_name ) { $this->option_name = $option_name; $this->options = WPSEO_Options::get_option( $option_name ); if ( $this->options === null ) { $this->options = (array) get_option( $option_name, array() ); } $this->option_instance = WPSEO_Options::get_option_instance( $option_name ); if ( ! $this->option_instance ) { $this->option_instance = null; } } /** * Sets a value in the options. * * @since 5.4 * * @param string $key The key of the option to set. * @param mixed $value The value to set the option to. * @param bool $overwrite Whether to overwrite existing options. Default is false. */ public function set_options_value( $key, $value, $overwrite = false ) { if ( $overwrite || ! array_key_exists( $key, $this->options ) ) { $this->options[ $key ] = $value; } } /** * Generates the footer for admin pages * * @since 2.0 * * @param bool $submit Whether or not a submit button and form end tag should be shown. * @param bool $show_sidebar Whether or not to show the banner sidebar - used by premium plugins to disable it. */ public function admin_footer( $submit = true, $show_sidebar = true ) { if ( $submit ) { submit_button( __( 'Save changes', 'wordpress-seo' ) ); echo '
'; } /** * Apply general admin_footer hooks */ do_action( 'wpseo_admin_footer', $this ); /** * Run possibly set actions to add for example an i18n box */ do_action( 'wpseo_admin_promo_footer' ); echo '
'; if ( $show_sidebar ) { $this->admin_sidebar(); } echo '
'; do_action( 'wpseo_admin_below_content', $this ); echo '
'; } /** * Generates the sidebar for admin pages. * * @since 2.0 */ public function admin_sidebar() { // No banners in Premium. if ( class_exists( 'WPSEO_Product_Premium' ) ) { $product_premium = new WPSEO_Product_Premium(); $extension_manager = new WPSEO_Extension_Manager(); if ( $extension_manager->is_activated( $product_premium->get_slug() ) ) { return; } } require_once 'views/sidebar.php'; } /** * Output a label element * * @since 2.0 * * @param string $text Label text string. * @param array $attr HTML attributes set. */ public function label( $text, $attr ) { $defaults = array( 'class' => 'checkbox', 'close' => true, 'for' => '', ); $attr = wp_parse_args( $attr, $defaults ); echo "'; } } /** * Output a legend element. * * @since 3.4 * * @param string $text Legend text string. * @param array $attr HTML attributes set. */ public function legend( $text, $attr ) { $defaults = array( 'id' => '', 'class' => '', ); $attr = wp_parse_args( $attr, $defaults ); $id = ( '' === $attr['id'] ) ? '' : ' id="' . esc_attr( $attr['id'] ) . '"'; echo '' . $text . ''; } /** * Create a Checkbox input field. * * @since 2.0 * * @param string $var The variable within the option to create the checkbox for. * @param string $label The label to show for the variable. * @param bool $label_left Whether the label should be left (true) or right (false). */ public function checkbox( $var, $label, $label_left = false ) { if ( ! isset( $this->options[ $var ] ) ) { $this->options[ $var ] = false; } if ( $this->options[ $var ] === true ) { $this->options[ $var ] = 'on'; } $class = ''; if ( $label_left !== false ) { if ( ! empty( $label_left ) ) { $label_left .= ':'; } $this->label( $label_left, array( 'for' => $var ) ); } else { $class = 'double'; } echo 'options[ $var ], 'on', false ), disabled( $this->is_control_disabled( $var ), true, false ), '/>'; if ( ! empty( $label ) ) { $this->label( $label, array( 'for' => $var ) ); } echo '
'; } /** * Create a light switch input field using a single checkbox. * * @since 3.1 * * @param string $var The variable within the option to create the checkbox for. * @param string $label The label element text for the checkbox. * @param array $buttons Array of two visual labels for the buttons (defaults Disabled/Enabled). * @param boolean $reverse Reverse order of buttons (default true). * @param string $help Inline Help that will be printed out before the visible toggles text. */ public function light_switch( $var, $label, $buttons = array(), $reverse = true, $help = '' ) { if ( ! isset( $this->options[ $var ] ) ) { $this->options[ $var ] = false; } if ( $this->options[ $var ] === true ) { $this->options[ $var ] = 'on'; } $class = 'switch-light switch-candy switch-yoast-seo'; $aria_labelledby = esc_attr( $var ) . '-label'; if ( $reverse ) { $class .= ' switch-yoast-seo-reverse'; } if ( empty( $buttons ) ) { $buttons = array( __( 'Disabled', 'wordpress-seo' ), __( 'Enabled', 'wordpress-seo' ) ); } list( $off_button, $on_button ) = $buttons; $help_class = ''; $screen_reader_text_class = ''; $help_class = ! empty( $help ) ? ' switch-container__has-help' : ''; echo "
", "{$label}" . $help, '
'; } /** * Create a Text input field. * * @since 2.0 * @since 2.1 Introduced the `$attr` parameter. * * @param string $var The variable within the option to create the text input field for. * @param string $label The label to show for the variable. * @param array|string $attr Extra class to add to the input field. */ public function textinput( $var, $label, $attr = array() ) { if ( ! is_array( $attr ) ) { $attr = array( 'class' => $attr, ); } $defaults = array( 'placeholder' => '', 'class' => '', ); $attr = wp_parse_args( $attr, $defaults ); $val = ( isset( $this->options[ $var ] ) ) ? $this->options[ $var ] : ''; $this->label( $label . ':', array( 'for' => $var, 'class' => 'textinput', ) ); echo 'is_control_disabled( $var ), true, false ), '/>', '
'; } /** * Create a textarea. * * @since 2.0 * * @param string $var The variable within the option to create the textarea for. * @param string $label The label to show for the variable. * @param string|array $attr The CSS class or an array of attributes to assign to the textarea. */ public function textarea( $var, $label, $attr = array() ) { if ( ! is_array( $attr ) ) { $attr = array( 'class' => $attr, ); } $defaults = array( 'cols' => '', 'rows' => '', 'class' => '', ); $attr = wp_parse_args( $attr, $defaults ); $val = ( isset( $this->options[ $var ] ) ) ? $this->options[ $var ] : ''; $this->label( $label . ':', array( 'for' => $var, 'class' => 'textinput', ) ); echo '
'; } /** * Create a hidden input field. * * @since 2.0 * * @param string $var The variable within the option to create the hidden input for. * @param string $id The ID of the element. */ public function hidden( $var, $id = '' ) { $val = ( isset( $this->options[ $var ] ) ) ? $this->options[ $var ] : ''; if ( is_bool( $val ) ) { $val = ( $val === true ) ? 'true' : 'false'; } if ( '' === $id ) { $id = 'hidden_' . $var; } echo ''; } /** * Create a Select Box. * * @since 2.0 * * @param string $var The variable within the option to create the select for. * @param string $label The label to show for the variable. * @param array $select_options The select options to choose from. */ public function select( $var, $label, array $select_options ) { if ( empty( $select_options ) ) { return; } $this->label( $label . ':', array( 'for' => $var, 'class' => 'select', ) ); $select_name = esc_attr( $this->option_name ) . '[' . esc_attr( $var ) . ']'; $active_option = ( isset( $this->options[ $var ] ) ) ? $this->options[ $var ] : ''; $select = new Yoast_Input_Select( $var, $select_name, $select_options, $active_option ); $select->add_attribute( 'class', 'select' ); if ( $this->is_control_disabled( $var ) ) { $select->add_attribute( 'disabled', 'disabled' ); } $select->output_html(); echo '
'; } /** * Create a File upload field. * * @since 2.0 * * @param string $var The variable within the option to create the file upload field for. * @param string $label The label to show for the variable. */ public function file_upload( $var, $label ) { $val = ''; if ( isset( $this->options[ $var ] ) && is_array( $this->options[ $var ] ) ) { $val = $this->options[ $var ]['url']; } $var_esc = esc_attr( $var ); $this->label( $label . ':', array( 'for' => $var, 'class' => 'select', ) ); echo 'is_control_disabled( $var ), true, false ), '/>'; // Need to save separate array items in hidden inputs, because empty file inputs type will be deleted by settings API. if ( ! empty( $this->options[ $var ] ) ) { $this->hidden( 'file', $this->option_name . '_file' ); $this->hidden( 'url', $this->option_name . '_url' ); $this->hidden( 'type', $this->option_name . '_type' ); } echo '
'; } /** * Media input * * @since 2.0 * * @param string $var Option name. * @param string $label Label message. */ public function media_input( $var, $label ) { $val = ''; if ( isset( $this->options[ $var ] ) ) { $val = $this->options[ $var ]; } $id_value = ''; if ( isset( $this->options[ $var . '_id' ] ) ) { $id_value = $this->options[ $var . '_id' ]; } $var_esc = esc_attr( $var ); $this->label( $label . ':', array( 'for' => 'wpseo_' . $var, 'class' => 'select', ) ); $id_field_id = 'wpseo_' . $var_esc . '_id'; echo ''; echo ' '; echo 'is_control_disabled( $var ), true, false ), ' /> '; echo 'is_control_disabled( $var ), true, false ), ' />'; echo ''; echo ''; echo '
'; } /** * Create a Radio input field. * * @since 2.0 * * @param string $var The variable within the option to create the radio button for. * @param array $values The radio options to choose from. * @param string $legend Optional. The legend to show for the field set, if any. * @param array $legend_attr Optional. The attributes for the legend, if any. */ public function radio( $var, $values, $legend = '', $legend_attr = array() ) { if ( ! is_array( $values ) || $values === array() ) { return; } if ( ! isset( $this->options[ $var ] ) ) { $this->options[ $var ] = false; } $var_esc = esc_attr( $var ); echo '
'; if ( is_string( $legend ) && '' !== $legend ) { $defaults = array( 'id' => '', 'class' => 'radiogroup', ); $legend_attr = wp_parse_args( $legend_attr, $defaults ); $this->legend( $legend, $legend_attr ); } foreach ( $values as $key => $value ) { $key_esc = esc_attr( $key ); echo 'options[ $var ], $key_esc, false ) . disabled( $this->is_control_disabled( $var ), true, false ) . ' />'; $this->label( $value, array( 'for' => $var_esc . '-' . $key_esc, 'class' => 'radio', ) ); } echo '
'; } /** * Create a toggle switch input field using two radio buttons. * * @since 3.1 * * @param string $var The variable within the option to create the radio buttons for. * @param array $values Associative array of on/off keys and their values to be used as * the label elements text for the radio buttons. Optionally, each * value can be an array of visible label text and screen reader text. * @param string $label The visual label for the radio buttons group, used as the fieldset legend. * @param string $help Inline Help that will be printed out before the visible toggles text. */ public function toggle_switch( $var, $values, $label, $help = '' ) { if ( ! is_array( $values ) || $values === array() ) { return; } if ( ! isset( $this->options[ $var ] ) ) { $this->options[ $var ] = false; } if ( $this->options[ $var ] === true ) { $this->options[ $var ] = 'on'; } if ( $this->options[ $var ] === false ) { $this->options[ $var ] = 'off'; } $help_class = ! empty( $help ) ? ' switch-container__has-help' : ''; $var_esc = esc_attr( $var ); printf( '
', esc_attr( 'switch-container' . $help_class ) ); echo '
', $label, '', $help; echo $this->get_disabled_note( $var ); echo '
'; foreach ( $values as $key => $value ) { $screen_reader_text = ''; $screen_reader_text_html = ''; if ( is_array( $value ) ) { $screen_reader_text = $value['screen_reader_text']; $screen_reader_text_html = ' ' . esc_html( $screen_reader_text ) . ''; $value = $value['text']; } $key_esc = esc_attr( $key ); $for = $var_esc . '-' . $key_esc; echo 'options[ $var ], $key_esc, false ) . disabled( $this->is_control_disabled( $var ), true, false ) . ' />', ''; } echo '
' . "\n\n"; } /** * Creates a toggle switch to define whether an indexable should be indexed or not. * * @param string $var The variable within the option to create the radio buttons for. * @param string $label The visual label for the radio buttons group, used as the fieldset legend. * @param string $help Inline Help that will be printed out before the visible toggles text. * * @return void */ public function index_switch( $var, $label, $help = '' ) { $index_switch_values = array( 'off' => __( 'Yes', 'wordpress-seo' ), 'on' => __( 'No', 'wordpress-seo' ), ); $this->toggle_switch( $var, $index_switch_values, sprintf( /* translators: %s expands to an indexable object's name, like a post type or taxonomy */ esc_html__( 'Show %s in search results?', 'wordpress-seo' ), '' . esc_html( $label ) . '' ), $help ); } /** * Creates a toggle switch to show hide certain options. * * @param string $var The variable within the option to create the radio buttons for. * @param string $label The visual label for the radio buttons group, used as the fieldset legend. * @param bool $inverse_keys Whether or not the option keys need to be inverted to support older functions. * @param string $help Inline Help that will be printed out before the visible toggles text. * * @return void */ public function show_hide_switch( $var, $label, $inverse_keys = false, $help = '' ) { $on_key = ( $inverse_keys ) ? 'off' : 'on'; $off_key = ( $inverse_keys ) ? 'on' : 'off'; $show_hide_switch = array( $on_key => __( 'Show', 'wordpress-seo' ), $off_key => __( 'Hide', 'wordpress-seo' ), ); $this->toggle_switch( $var, $show_hide_switch, $label, $help ); } /** * Checks whether a given control should be disabled. * * @param string $var The variable within the option to check whether its control should be disabled. * * @return bool True if control should be disabled, false otherwise. */ protected function is_control_disabled( $var ) { if ( $this->option_instance === null ) { return false; } return $this->option_instance->is_disabled( $var ); } /** * Gets the explanation note to print if a given control is disabled. * * @param string $var The variable within the option to print a disabled note for. * * @return string Explanation note HTML string, or empty string if no note necessary. */ protected function get_disabled_note( $var ) { if ( ! $this->is_control_disabled( $var ) ) { return ''; } return '

' . esc_html__( 'This feature has been disabled by the network admin.', 'wordpress-seo' ) . '

'; } /* ********************* DEPRECATED METHODS ********************* */ /** * Retrieve options based on whether we're on multisite or not. * * @since 1.2.4 * @since 2.0 Moved to this class. * @deprecated 8.4 * @codeCoverageIgnore * * @return array The option's value. */ public function get_option() { _deprecated_function( __METHOD__, 'WPSEO 8.4' ); if ( is_network_admin() ) { return get_site_option( $this->option_name ); } return get_option( $this->option_name ); } }