name = 'radio_input'; $this->public = false; $this->label = __( 'Radio Button', 'frontend-admin' ); $this->category = 'choice'; $this->defaults = array( 'layout' => 'vertical', 'choices' => array(), 'default_value' => '', 'other_choice' => 0, 'save_other_choice' => 0, 'allow_null' => 0, 'return_format' => 'value', ); } /* * render_field_settings() * * Create extra options for your field. This is rendered when editing a field. * The value of $field['name'] can be used (like bellow) to save extra data to the $field * * @type action * @since 3.6 * @date 23/01/13 * * @param $field - an array holding all the field's data */ function render_field_settings( $field ) { // Encode choices (convert from array). $field['choices'] = acf_encode_choices( $field['choices'] ); acf_render_field_setting( $field, array( 'label' => __( 'Choices', 'frontend-admin' ), 'hint' => __( 'Enter each choice on a new line.', 'frontend-admin' ) . '
' . __( 'For more control, you may specify both a value and label like this:', 'frontend-admin' ) . '
' . __( 'red : Red', 'frontend-admin' ) . '', 'type' => 'textarea', 'name' => 'choices', ) ); acf_render_field_setting( $field, array( 'label' => __( 'Default Value', 'frontend-admin' ), 'hint' => __( 'Appears when creating a new post', 'frontend-admin' ), 'type' => 'text', 'name' => 'default_value', ) ); acf_render_field_setting( $field, array( 'label' => __( 'Return Value', 'frontend-admin' ), 'instructions' => __( 'Specify the returned value on front end', 'frontend-admin' ), 'type' => 'radio', 'name' => 'return_format', 'layout' => 'horizontal', 'choices' => array( 'value' => __( 'Value', 'frontend-admin' ), 'label' => __( 'Label', 'frontend-admin' ), 'array' => __( 'Both (Array)', 'frontend-admin' ), ), ) ); } /** * Renders the field settings used in the "Validation" tab. * * @since 6.0 * * @param array $field The field settings array. * @return void */ function render_field_validation_settings( $field ) { acf_render_field_setting( $field, array( 'label' => __( 'Allow Null?', 'frontend-admin' ), 'instructions' => '', 'name' => 'allow_null', 'type' => 'true_false', 'ui' => 1, ) ); acf_render_field_setting( $field, array( 'label' => __( 'Allow Other Choice', 'frontend-admin' ), 'name' => 'other_choice', 'type' => 'true_false', 'ui' => 1, 'instructions' => __( "Add 'other' choice to allow for custom values", 'frontend-admin' ), ) ); acf_render_field_setting( $field, array( 'label' => __( 'Save Other Choice', 'frontend-admin' ), 'name' => 'save_other_choice', 'type' => 'true_false', 'ui' => 1, 'instructions' => __( "Save 'other' values to the field's choices", 'frontend-admin' ), 'conditions' => array( 'field' => 'other_choice', 'operator' => '==', 'value' => 1, ), ) ); } /** * Renders the field settings used in the "Presentation" tab. * * @since 6.0 * * @param array $field The field settings array. * @return void */ function render_field_presentation_settings( $field ) { acf_render_field_setting( $field, array( 'label' => __( 'Layout', 'frontend-admin' ), 'instructions' => '', 'type' => 'radio', 'name' => 'layout', 'layout' => 'horizontal', 'choices' => array( 'vertical' => __( 'Vertical', 'frontend-admin' ), 'horizontal' => __( 'Horizontal', 'frontend-admin' ), ), ) ); } /* * update_field() * * This filter is appied to the $field before it is saved to the database * * @type filter * @since 3.6 * @date 23/01/13 * * @param $field - the field array holding all the field options * @param $post_id - the field group ID (post_type = acf) * * @return $field - the modified field */ function update_field( $field ) { // decode choices (convert to array) $field['choices'] = feadmin_decode_choices( $field['choices'] ); // return return $field; } /* * update_value() * * This filter is appied to the $value before it is updated in the db * * @type filter * @since 3.6 * @date 23/01/13 * @todo Fix bug where $field was found via json and has no ID * * @param $value - the value which will be saved in the database * @param $post_id - the $post_id of which the value will be saved * @param $field - the field array holding all the field options * * @return $value - the modified value */ function update_value( $value, $post_id, $field ) { // bail early if no value (allow 0 to be saved) if ( ! $value && ! is_numeric( $value ) ) { return $value; } // save_other_choice if ( $field['save_other_choice'] ) { // value isn't in choices yet if ( ! isset( $field['choices'][ $value ] ) ) { // get raw $field (may have been changed via repeater field) // if field is local, it won't have an ID $selector = $field['ID'] ? $field['ID'] : $field['key']; $field = acf_get_field( $selector ); // bail early if no ID (JSON only) if ( ! $field['ID'] ) { return $value; } // unslash (fixes serialize single quote issue) $value = wp_unslash( $value ); // sanitize (remove tags) $value = sanitize_text_field( $value ); // update $field $field['choices'][ $value ] = $value; // save acf_update_field( $field ); } } // return return $value; } /* * load_value() * * This filter is appied to the $value after it is loaded from the db * * @type filter * @since 5.2.9 * @date 23/01/13 * * @param $value - the value found in the database * @param $post_id - the $post_id from which the value was loaded from * @param $field - the field array holding all the field options * * @return $value - the value to be saved in te database */ function load_value( $value, $post_id, $field ) { // must be single value if ( is_array( $value ) ) { $value = array_pop( $value ); } // return return $value; } /* * translate_field * * This function will translate field settings * * @type function * @date 8/03/2016 * @since 5.3.2 * * @param $field (array) * @return $field */ function translate_field( $field ) { return acf_get_field_type( 'select' )->translate_field( $field ); } /* * format_value() * * This filter is appied to the $value after it is loaded from the db and before it is returned to the template * * @type filter * @since 3.6 * @date 23/01/13 * * @param $value (mixed) the value which was loaded from the database * @param $post_id (mixed) the $post_id from which the value was loaded * @param $field (array) the field array holding all the field options * * @return $value (mixed) the modified value */ function format_value( $value, $post_id, $field ) { return acf_get_field_type( 'select' )->format_value( $value, $post_id, $field ); } /** * Return the schema array for the REST API. * * @param array $field * @return array */ function get_rest_schema( array $field ) { $schema = parent::get_rest_schema( $field ); if ( isset( $field['default_value'] ) && '' !== $field['default_value'] ) { $schema['default'] = $field['default_value']; } // If other/custom choices are allowed, nothing else to do here. if ( ! empty( $field['other_choice'] ) ) { return $schema; } /** * If a user has defined keys for the radio options, * we should use the keys for the available options to POST to, * since they are what is displayed in GET requests. */ $radio_keys = array_diff( array_keys( $field['choices'] ), array_values( $field['choices'] ) ); $schema['enum'] = empty( $radio_keys ) ? $field['choices'] : $radio_keys; if ( ! empty( $field['allow_null'] ) ) { $schema['enum'][] = null; } return $schema; } } endif; // class_exists check