22

✏️ Editing: class-acf-field-radio.php

<?php

if( ! class_exists('acf_field_radio') ) :

class acf_field_radio extends acf_field {
	
	
	/*
	*  __construct
	*
	*  This function will setup the field type data
	*
	*  @type	function
	*  @date	5/03/2014
	*  @since	5.0.0
	*
	*  @param	n/a
	*  @return	n/a
	*/
	
	function initialize() {
		
		// vars
		$this->name = 'radio';
		$this->label = __("Radio Button",'acf');
		$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()
	*
	*  Create the HTML interface for your field
	*
	*  @param	$field (array) the $field being rendered
	*
	*  @type	action
	*  @since	3.6
	*  @date	23/01/13
	*
	*  @param	$field (array) the $field being edited
	*  @return	n/a
	*/
	
	function render_field( $field ) {

// vars
		$e = '';
		$ul = array( 
			'class'				=> 'acf-radio-list',
			'data-allow_null'	=> $field['allow_null'],
			'data-other_choice'	=> $field['other_choice']
		);
		
		
		// append to class
		$ul['class'] .= ' ' . ($field['layout'] == 'horizontal' ? 'acf-hl' : 'acf-bl');
		$ul['class'] .= ' ' . $field['class'];
		
		
		// Determine selected value.
		$value = (string) $field['value'];
		
		// 1. Selected choice.
		if( isset( $field['choices'][ $value ] ) ) {
			$checked = (string) $value;
			
		// 2. Custom choice.
		} elseif( $field['other_choice'] && $value !== '' ) {
			$checked = 'other';
			
		// 3. Empty choice. 
		} elseif( $field['allow_null'] ) {
			$checked = '';
			
		// 4. Default to first choice.
		} else {
			$checked = (string) key( $field['choices'] );
		}
				
		// other choice
		$other_input = false;
		if( $field['other_choice'] ) {
			
			// Define other input attrs.
			$other_input = array(
				'type'		=> 'text',
				'name'		=> $field['name'],
				'value'		=> '',
				'disabled'	=> 'disabled',
				'class'		=> 'acf-disabled'
			);
			
			// Select other choice if value is not a valid choice.
			if( $checked === 'other' ) {
				unset( $other_input['disabled'] );
				$other_input['value'] = $field['value'];
			}
			
			// Ensure an 'other' choice is defined.
			if( !isset( $field['choices']['other'] ) ) {
				$field['choices']['other'] = '';
			}
		}
		
		// Bail early if no choices.
		if( empty( $field['choices'] ) ) {
			return;
		}
		
		// Hiden input.
		$e .= acf_get_hidden_input( array('name' => $field['name']) );
		
		// Open <ul>.
		$e .= '<ul ' . acf_esc_attr($ul) . '>';
		
		// Loop through choices.
		foreach( $field['choices'] as $value => $label ) {
			$is_selected = false;
			
			// Ensure value is a string.
			$value = (string) $value;
			
			// Define input attrs.
			$attrs = array(
				'type'	=> 'radio',
				'id'	=> sanitize_title( $field['id'] . '-' . $value ), 
				'name'	=> $field['name'],
				'value'	=> $value
			);
			
			// Check if selected.
			if( esc_attr($value) === esc_attr($checked) ) {
				$attrs['checked'] = 'checked';
				$is_selected = true;
			}
			
			// Check if is disabled.
			if( isset($field['disabled']) && acf_in_array($value, $field['disabled']) ) {
				$attrs['disabled'] = 'disabled';
			}
			
			// Additional HTML (the "Other" input).
			$additional_html = '';
			if( $value === 'other' && $other_input ) {
				$additional_html = ' ' . acf_get_text_input( $other_input );
			}
			
			// append
			$e .= '<li><label' . ( $is_selected ? ' class="selected"' : '' ) . '><input ' . acf_esc_attr( $attrs ) . '/>' . acf_esc_html( $label ) . '</label>' . $additional_html . '</li>';
		}
		
		// Close <ul>.
		$e .= '</ul>';
		
		// Output HTML.
		echo $e;
	}
	
	
	/*
	*  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']);
		
		
		// choices
		acf_render_field_setting( $field, array(
			'label'			=> __('Choices','acf'),
			'instructions'	=> __('Enter each choice on a new line.','acf') . '<br /><br />' . __('For more control, you may specify both a value and label like this:','acf'). '<br /><br />' . __('red : Red','acf'),
			'type'			=> 'textarea',
			'name'			=> 'choices',
		));
		
		
		// allow_null
		acf_render_field_setting( $field, array(
			'label'			=> __('Allow Null?','acf'),
			'instructions'	=> '',
			'name'			=> 'allow_null',
			'type'			=> 'true_false',
			'ui'			=> 1,
		));
		
		
		// other_choice
		acf_render_field_setting( $field, array(
			'label'			=> __('Other','acf'),
			'instructions'	=> '',
			'name'			=> 'other_choice',
			'type'			=> 'true_false',
			'ui'			=> 1,
			'message'		=> __("Add 'other' choice to allow for custom values", 'acf'),
		));
		
		
		// save_other_choice
		acf_render_field_setting( $field, array(
			'label'			=> __('Save Other','acf'),
			'instructions'	=> '',
			'name'			=> 'save_other_choice',
			'type'			=> 'true_false',
			'ui'			=> 1,
			'message'		=> __("Save 'other' values to the field's choices", 'acf'),
			'conditions'	=> array(
				'field'		=> 'other_choice',
				'operator'	=> '==',
				'value'		=> 1
			)
		));
		
		
		// default_value
		acf_render_field_setting( $field, array(
			'label'			=> __('Default Value','acf'),
			'instructions'	=> __('Appears when creating a new post','acf'),
			'type'			=> 'text',
			'name'			=> 'default_value',
		));
		
		
		// layout
		acf_render_field_setting( $field, array(
			'label'			=> __('Layout','acf'),
			'instructions'	=> '',
			'type'			=> 'radio',
			'name'			=> 'layout',
			'layout'		=> 'horizontal', 
			'choices'		=> array(
				'vertical'		=> __("Vertical",'acf'), 
				'horizontal'	=> __("Horizontal",'acf')
			)
		));
		
		
		// return_format
		acf_render_field_setting( $field, array(
			'label'			=> __('Return Value','acf'),
			'instructions'	=> __('Specify the returned value on front end','acf'),
			'type'			=> 'radio',
			'name'			=> 'return_format',
			'layout'		=> 'horizontal',
			'choices'		=> array(
				'value'			=> __('Value','acf'),
				'label'			=> __('Label','acf'),
				'array'			=> __('Both (Array)','acf')
			)
		));
		
	}
	
	
	/*
	*  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
	*/

// initialize
acf_register_field_type( 'acf_field_radio' );

endif; // class_exists check

MR SKB