acf_field_message{}ACF 1.0

Хуков нет.

Использование

$acf_field_message = new acf_field_message();
// use class methods

Методы

  1. public initialize()
  2. public load_field( $field )
  3. public render_field( $field )
  4. public render_field_settings( $field )
  5. public translate_field( $field )

Код acf_field_message{} ACF 5.10.2

class acf_field_message 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     = 'message';
		$this->label    = __( 'Message', 'acf' );
		$this->category = 'layout';
		$this->defaults = array(
			'message'   => '',
			'esc_html'  => 0,
			'new_lines' => 'wpautop',
		);

	}


	/*
	*  render_field()
	*
	*  Create the HTML interface for your field
	*
	*  @param   $field - an array holding all the field's data
	*
	*  @type    action
	*  @since   3.6
	*  @date    23/01/13
	*/

	function render_field( $field ) {

		// vars
		$m = $field['message'];

		// wptexturize (improves "quotes")
		$m = wptexturize( $m );

		// esc_html
		if ( $field['esc_html'] ) {

			$m = esc_html( $m );

		}

		// new lines
		if ( $field['new_lines'] == 'wpautop' ) {

			$m = wpautop( $m );

		} elseif ( $field['new_lines'] == 'br' ) {

			$m = nl2br( $m );

		}

		// return
		echo acf_esc_html( $m );

	}


	/*
	*  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
	*
	*  @param   $field  - an array holding all the field's data
	*
	*  @type    action
	*  @since   3.6
	*  @date    23/01/13
	*/

	function render_field_settings( $field ) {

		// default_value
		acf_render_field_setting(
			$field,
			array(
				'label'        => __( 'Message', 'acf' ),
				'instructions' => '',
				'type'         => 'textarea',
				'name'         => 'message',
			)
		);

		// formatting
		acf_render_field_setting(
			$field,
			array(
				'label'        => __( 'New Lines', 'acf' ),
				'instructions' => __( 'Controls how new lines are rendered', 'acf' ),
				'type'         => 'select',
				'name'         => 'new_lines',
				'choices'      => array(
					'wpautop' => __( 'Automatically add paragraphs', 'acf' ),
					'br'      => __( 'Automatically add <br>', 'acf' ),
					''        => __( 'No Formatting', 'acf' ),
				),
			)
		);

		// HTML
		acf_render_field_setting(
			$field,
			array(
				'label'        => __( 'Escape HTML', 'acf' ),
				'instructions' => __( 'Allow HTML markup to display as visible text instead of rendering', 'acf' ),
				'name'         => 'esc_html',
				'type'         => 'true_false',
				'ui'           => 1,
			)
		);

	}


	/*
	*  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 ) {

		// translate
		$field['message'] = acf_translate( $field['message'] );

		// return
		return $field;

	}


	/*
	*  load_field()
	*
	*  This filter is appied to the $field after it is loaded from the database
	*
	*  @type    filter
	*  @since   3.6
	*  @date    23/01/13
	*
	*  @param   $field - the field array holding all the field options
	*
	*  @return  $field - the field array holding all the field options
	*/
	function load_field( $field ) {

		// remove name to avoid caching issue
		$field['name'] = '';

		// remove instructions
		$field['instructions'] = '';

		// remove required to avoid JS issues
		$field['required'] = 0;

		// set value other than 'null' to avoid ACF loading / caching issue
		$field['value'] = false;

		// return
		return $field;
	}

}