ACF { Data Selector Field
PHP JavaScript CSS
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
assets
lang
.gitignore
README.md
acf-data-selector-field-v4.php
acf-data-selector-field-v5.php
acf-data-selector.php
readme.txt
screenshot-1.png
screenshot-2.png
screenshot-3.png

README.md

ACF { Data Selector Field

Adds a 'Data Selector' field type for the Advanced Custom Fields WordPress plugin.


Overview

This add-on adds a Data Selector field type to the Advanced Custom Fields plugin for version 4 and up. This field allows you to select data from customisable data sources using the relationship format.

Data sources can be registered using one of the following formats:

add_action('acf_data_selector/data', function($data) {

	// basic array
	$data['countries'] = array(
		'label' => 'Countries',
		'data' => array(
			'US' => 'United States',
			'UK' => 'United Kingdom'
		)
	);

	// complex array
	$data['rooms'] = array(
		'label' => 'Rooms',
		'data' => array(
			'101' => array(
				'label' => 'Meeting Room',
				'room_number' => '101',
				'floor' => '1'
			),
			'102' => array(
				'label' => 'Stock Room',
				'room_number' => '102',
				'floor' => '1'
			),
			'202' => array(
				'label' => 'Manager Room 1',
				'room_number' => '202',
				'floor' => '2'
			),
		)
	);

	// json array
	$data['regions'] = array(
		'label' => 'Regions',
		'data' => json_decode(file_get_contents('/data/regions.json'), TRUE)
	);

	return $data;

});

When using the basic array format the array value is used as the field label. However when using the complex array format be sure to set a label item.

When using the complex array format, calling get_field() will return the entire array for any given key, this means that any additional data we add into the array (room_number and floor in the example above) will be returned.

Compatibility

This add-on will work with:

  • Versions 4 and 5

Installation

This add-on can be treated as both a WP plugin and a theme include.

Install as Plugin

  1. Copy the 'acf-data-selector' folder into your plugins folder
  2. Activate the plugin via the Plugins admin page

Include within theme

  1. Copy the 'acf-data-selector' folder into your theme folder (can use sub folders). You can place the folder anywhere inside the 'wp-content' directory
  2. Edit your functions.php file and add the code below (Make sure the path is correct to include the acf-data-selector.php file)
include_once('acf-data-selector/acf-data-selector.php');