acf_field_google_map{}ACF 1.0

Хуки из класса

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

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

Методы

  1. public initialize()
  2. public input_admin_enqueue_scripts()
  3. public load_value( $value, $post_id, $field )
  4. public render_field( $field )
  5. public render_field_settings( $field )
  6. public update_value( $value, $post_id, $field )

Код acf_field_google_map{} ACF 5.10.2

<?php
class acf_field_google_map 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           = 'google_map';
		$this->label          = __( 'Google Map', 'acf' );
		$this->category       = 'jquery';
		$this->defaults       = array(
			'height'     => '',
			'center_lat' => '',
			'center_lng' => '',
			'zoom'       => '',
		);
		$this->default_values = array(
			'height'     => '400',
			'center_lat' => '-37.81411',
			'center_lng' => '144.96328',
			'zoom'       => '14',
		);
	}


	 /*
	*  input_admin_enqueue_scripts
	*
	*  description
	*
	*  @type    function
	*  @date    16/12/2015
	*  @since   5.3.2
	*
	*  @param   $post_id (int)
	*  @return  $post_id (int)
	*/

	function input_admin_enqueue_scripts() {

		// localize
		acf_localize_text(
			array(
				'Sorry, this browser does not support geolocation'  => __( 'Sorry, this browser does not support geolocation', 'acf' ),
			)
		);

		// bail ealry if no enqueue
		if ( ! acf_get_setting( 'enqueue_google_maps' ) ) {
			return;
		}

		// vars
		$api = array(
			'key'       => acf_get_setting( 'google_api_key' ),
			'client'    => acf_get_setting( 'google_api_client' ),
			'libraries' => 'places',
			'ver'       => 3,
			'callback'  => '',
			'language'  => acf_get_locale(),
		);

		// filter
		$api = apply_filters( 'acf/fields/google_map/api', $api );

		// remove empty
		if ( empty( $api['key'] ) ) {
			unset( $api['key'] );
		}
		if ( empty( $api['client'] ) ) {
			unset( $api['client'] );
		}

		// construct url
		$url = add_query_arg( $api, 'https://maps.googleapis.com/maps/api/js' );

		// localize
		acf_localize_data(
			array(
				'google_map_api' => $url,
			)
		);
	}


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

		// Apply defaults.
		foreach ( $this->default_values as $k => $v ) {
			if ( ! $field[ $k ] ) {
				$field[ $k ] = $v;
			}
		}

		// Attrs.
		$attrs = array(
			'id'        => $field['id'],
			'class'     => "acf-google-map {$field['class']}",
			'data-lat'  => $field['center_lat'],
			'data-lng'  => $field['center_lng'],
			'data-zoom' => $field['zoom'],
		);

		$search = '';
		if ( $field['value'] ) {
			$attrs['class'] .= ' -value';
			$search          = $field['value']['address'];
		} else {
			$field['value'] = '';
		}

		?>
<div <?php acf_esc_attr_e( $attrs ); ?>>

		<?php
		acf_hidden_input(
			array(
				'name'  => $field['name'],
				'value' => $field['value'],
			)
		);
		?>

<div class="title">
	
	<div class="acf-actions -hover">
		<a href="#" data-name="search" class="acf-icon -search grey" title="<?php _e( 'Search', 'acf' ); ?>"></a>
		<a href="#" data-name="clear" class="acf-icon -cancel grey" title="<?php _e( 'Clear location', 'acf' ); ?>"></a>
		<a href="#" data-name="locate" class="acf-icon -location grey" title="<?php _e( 'Find current location', 'acf' ); ?>"></a>
	</div>
	
	<input class="search" type="text" placeholder="<?php _e( 'Search for address...', 'acf' ); ?>" value="<?php echo esc_attr( $search ); ?>" />
	<i class="acf-loading"></i>
			
</div>

<div class="canvas" style="<?php echo esc_attr( 'height: ' . $field['height'] . 'px' ); ?>"></div>

</div>
		<?php

	}


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

		// center_lat
		acf_render_field_setting(
			$field,
			array(
				'label'        => __( 'Center', 'acf' ),
				'instructions' => __( 'Center the initial map', 'acf' ),
				'type'         => 'text',
				'name'         => 'center_lat',
				'prepend'      => 'lat',
				'placeholder'  => $this->default_values['center_lat'],
			)
		);

		// center_lng
		acf_render_field_setting(
			$field,
			array(
				'label'        => __( 'Center', 'acf' ),
				'instructions' => __( 'Center the initial map', 'acf' ),
				'type'         => 'text',
				'name'         => 'center_lng',
				'prepend'      => 'lng',
				'placeholder'  => $this->default_values['center_lng'],
				'_append'      => 'center_lat',
			)
		);

		// zoom
		acf_render_field_setting(
			$field,
			array(
				'label'        => __( 'Zoom', 'acf' ),
				'instructions' => __( 'Set the initial zoom level', 'acf' ),
				'type'         => 'text',
				'name'         => 'zoom',
				'placeholder'  => $this->default_values['zoom'],
			)
		);

		// allow_null
		acf_render_field_setting(
			$field,
			array(
				'label'        => __( 'Height', 'acf' ),
				'instructions' => __( 'Customize the map height', 'acf' ),
				'type'         => 'text',
				'name'         => 'height',
				'append'       => 'px',
				'placeholder'  => $this->default_values['height'],
			)
		);

	}

	/**
	 * load_value
	 *
	 * Filters the value loaded from the database.
	 *
	 * @date    16/10/19
	 * @since   5.8.1
	 *
	 * @param   mixed $value The value loaded from the database.
	 * @param   mixed $post_id The post ID where the value is saved.
	 * @param   array $field The field settings array.
	 * @return  (array|false)
	 */
	function load_value( $value, $post_id, $field ) {

		// Ensure value is an array.
		if ( $value ) {
			return wp_parse_args(
				$value,
				array(
					'address' => '',
					'lat'     => 0,
					'lng'     => 0,
				)
			);
		}

		// Return default.
		return false;
	}


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

		// decode JSON string.
		if ( is_string( $value ) ) {
			$value = json_decode( wp_unslash( $value ), true );
		}

		// Ensure value is an array.
		if ( $value ) {
			return (array) $value;
		}

		// Return default.
		return false;
	}
}