README

Custom field for CMB2 to attach posts to each others.

Same approach than CMB2 Attached Posts Field with Ajax request, multiple/single option, and different UI.

Installation

You can install this field type as you would a WordPress plugin:

Download the plugin
Place the plugin folder in your /wp-content/plugins/ directory
Activate the plugin in the Plugin dashboard

Composer Intallation:

composer require alexis-magina/cmb2-field-post-search-ajax:dev-master

Usage - Admin

Follow the example in example-field-setup.php for a demonstration.

Options :

limit (int, default = 1 : single selection) : limit the number of posts that can be selected
sortable (bool, default = false) : Allow selected posts to be sort
query_args (array) : setup the ajax search query : pass a wp_query args array.

Filter : (since 1.1.2) Ajax results can be filtered to customize returned text and posts values. Use filter "mag_cmb_post_search_ajax_result", for example :

function example_callback( $arr ) {
	// $arr['data'] : contains post_id
	// $arr['guid'] : contains admin edit post url
	// $arr['value'] : contains post title
	$arr['value'] = 'Custom string '.$arr['value'];
    return $arr;
}
add_filter( 'mag_cmb_post_search_ajax_result', 'example_callback' );

Usage - FrontEnd

You can retrieve the meta data using get_post_meta( get_the_ID(), 'your_field_id', true );

If field limit > 1, this will return an array of attached post IDs. If field limit == 1, this will return only the single attached post ID.

Screenshot

Changelog

1.0.0

Initial commit

1.1.0-sebask

Added a function which enables usage of CMB2 Field Post Search Ajax from a location other then the Wordpress Plugins folder.

1.1.1-sebask

Fixed a minor bug which caused the use of an undefined constant.

1.1.2

Fixed issue #2 : no way to delete value for fields with limit = 1
Added a class exists check (issue #3)
Added a filter "mag_cmb_post_search_ajax_result" to allow customize ajax results
Fixed a minor bug of encoding chars in autocomplete results

1.1.3

Add Support for user queries
Fixed issue #11 : sorting problem
Fixed conflict with ui-autocomplete

1.1.4-sebask

Fixed issue #14: safe mode for jquery-ui-autocomplete and devbridge/jQuery-Autocomplete compatibility.

1.1.5

Fixed issue #17 : Undefined index if the field is empty

alexis-magina / cmb2-field-post-search-ajax

Maintainers

Details