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