PHPackages                             ed-itsolutions/cmb2-field-ajax-search - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. ed-itsolutions/cmb2-field-ajax-search

ActiveLibrary[Utility & Helpers](/categories/utility)

ed-itsolutions/cmb2-field-ajax-search
=====================================

CMB2

v2.0.0(6y ago)15.0k↑193.3%2GPL-2.0-or-laterPHPPHP ^5.3.3 || ^7.0

Since Jul 1Pushed 6y agoCompare

[ Source](https://github.com/Ed-ITSolutions/cmb2-field-ajax-search)[ Packagist](https://packagist.org/packages/ed-itsolutions/cmb2-field-ajax-search)[ RSS](/packages/ed-itsolutions-cmb2-field-ajax-search/feed)WikiDiscussions master Synced 2w ago

READMEChangelog (1)DependenciesVersions (2)Used By (0)

CMB2 Field Type: Ajax Search
============================

[](#cmb2-field-type-ajax-search)

Custom fields for [CMB2](https://github.com/WebDevStudios/CMB2) to attach posts, users or terms to each others.

Formed from .

This fork removes the need to use this as a plugin and instead lets you require it using composer.

[![example](example.gif)](example.gif)

Once activated, this plugin adds three new field types `post_ajax_search`, `user_ajax_search` and `term_ajax_search`.

This plugin is an update of [CMB2 Field Type: Post Search Ajax](https://github.com/alexis-magina/cmb2-field-post-search-ajax) by [Magina](http://magina.fr/) with support to attach posts, users or terms.

Installation
------------

[](#installation)

Install from composer

```
composer require ed-itsolutions/cmb2-field-ajax-search

```

Make sure that your `functions.php` loads composer

```
require_once('vendor/autoload.php');
```

If the assets don't load you can use the filter `cmb2_field_ajax_search_url` to set it.

```
add_filter('cmb2_field_ajax_search_url', function(){
	return (get_template_directory_uri() . '/cmb2-ajax-search/');
});
```

Parameters
----------

[](#parameters)

Options :

- `multiple` (bool, default = false) : Turn field into a multiple attached objects
- `limit` (int, default = -1 : single selection) : Limit the number of posts that can be selected (-1 for unlimited)
- `sortable` (bool, default = false) : Allow selected items to be sort (only if multiple = true)
- `query_args` (array) : Query arguments to pass on each request

Query args:

- query\_args accepts same parameters as [WP\_Query](https://codex.wordpress.org/Class_Reference/WP_Query) for `post_ajax_search`
- query\_args accepts same parameters as [WP\_User\_Query](https://codex.wordpress.org/Class_Reference/WP_User_Query) for `user_ajax_search`
- query\_args accepts same parameters as [WP\_Term\_Query](https://developer.wordpress.org/reference/classes/wp_term_query/) for `term_ajax_search`

Examples
--------

[](#examples)

```
add_action('cmb2_admin_init', 'cmb2_ajax_search_metabox');

function cmb2_ajax_search_metabox(){
	$prefix = 'your_prefix_demo_';
	$cmb_demo = new_cmb2_box(array(
		'id'            => $prefix . 'metabox',
		'title'         => __( 'Attached posts Metabox', 'cmb2' ),
		'object_types'  => array( 'page', 'post' ), // Post type
	) );

	// Single post
	$cmb_demo->add_field( array(
		'name'          => __( 'Attached post', 'cmb2' ),
		'desc'          => __( 'Field description (optional)', 'cmb2' ),
		'id'            => $prefix . 'post',
		'type'          => 'post_ajax_search',
		'query_args'	=> array(
			'post_type'			=> array( 'post' ),
			'posts_per_page'	=> -1
		)
	) );

	// Multiple posts
	$cmb_demo->add_field( array(
		'name'          => __( 'Multiple posts', 'cmb2' ),
		'desc'          => __( 'Field description (optional)', 'cmb2' ),
		'id'            => $prefix . 'posts',
		'type'          => 'post_ajax_search',
		'multiple-items' => true,
		'limit'      	=> 10,
		'query_args'	=> array(
			'post_type'			=> array( 'post', 'page' ),
			'post_status'		=> array( 'publish', 'pending' )
		)
	) );

	// Single user
	$cmb_demo->add_field( array(
		'name'          => __( 'Attached user', 'cmb2' ),
		'desc'          => __( 'Field description (optional)', 'cmb2' ),
		'id'            => $prefix . 'user',
		'type'          => 'user_ajax_search',
		'query_args'	=> array(
			'role'				=> array( 'Subscriber' ),
			'search_columns' 	=> array( 'user_login', 'user_email' )
		)
	) );

	// Multiple users
	$cmb_demo->add_field( array(
		'name'          => __( 'Multiple users', 'cmb2' ),
		'desc'          => __( 'Field description (optional)', 'cmb2' ),
		'id'            => $prefix . 'users',
		'type'          => 'user_ajax_search',
		'multiple-items' => true,
		'limit'      	=> 5,
		'query_args'	=> array(
			'role__not_in'		=> array( 'Administrator', 'Editor' ),
		)
	) );

	// Single term
	$cmb_demo->add_field( array(
		'name'          => __( 'Attached term', 'cmb2' ),
		'desc'          => __( 'Field description (optional)', 'cmb2' ),
		'id'            => $prefix . 'term',
		'type'          => 'term_ajax_search',
		'query_args'	=> array(
			'taxonomy'			=> 'category',
			'childless'			=> true
		)
	) );

	// Multiple terms
	$cmb_demo->add_field( array(
		'name'          => __( 'Multiple terms', 'cmb2' ),
		'desc'          => __( 'Field description (optional)', 'cmb2' ),
		'id'            => $prefix . 'terms',
		'type'          => 'term_ajax_search',
		'multiple-items'=> true,
		'limit'      	=> -1,
		'query_args'	=> array(
			'taxonomy'			=> 'post_tag',
			'hide_empty'		=> false
		)
	) );

}
```

Customize results output
------------------------

[](#customize-results-output)

You can use `cmb_{$field_id}_ajax_search_result_text` to customize the text returned from ajax searches and `cmb_{$field_id}_ajax_search_result_link` to customize the link, check next example:

```
add_filter( 'cmb_your_prefix_demo_posts_ajax_search_result_text', 'cmb2_ajax_search_custom_field_text', 10, 3 );
function cmb2_ajax_search_custom_field_text( $text, $object_id, $object_type ) {
	$text = sprintf( '#%s - %s', $object_id, $text ); // #123 - Post title

	return $text;
}

add_filter( 'cmb_your_prefix_demo_posts_ajax_search_result_link', 'cmb2_ajax_search_custom_field_link', 10, 3 );
function cmb2_ajax_search_custom_field_link( $link, $object_id, $object_type ) {
	if( $object_id == 123 ) {
		$link = '#';
	}

	return $link;
}
```

Retrieve the field value
------------------------

[](#retrieve-the-field-value)

If multiple == false will return the ID of attached object: `get_post_meta( get_the_ID(), 'your_field_id', true );`

If multiple == true will return an array of IDs of attached object: `get_post_meta( get_the_ID(), 'your_field_id', false );`

Changelog
---------

[](#changelog)

### 2.0.0

[](#200)

*Ed-IT Solutions Fork Begins here*

- Installable from composer (this breaks the plugin style code).
- Implements [rubengc#14](https://github.com/rubengc/cmb2-field-ajax-search/pull/14)

### 1.0.2

[](#102)

- Updated devbridgeAutocomplete lib

### 1.0.1

[](#101)

- Group fields support
- Widget area support
- Use of devbridgeAutocomplete() instead of autocomplete() to avoid errors

### 1.0.0

[](#100)

- Initial commit

###  Health Score

30

—

LowBetter than 61% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity27

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 66.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

2240d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/930b97839168b9f3710451fa89ba02c5f5642d9c33efc77f4d9f5b621a9941be?d=identicon)[Arcath](/maintainers/Arcath)

---

Top Contributors

[![rubengc](https://avatars.githubusercontent.com/u/5462480?v=4)](https://github.com/rubengc "rubengc (10 commits)")[![Arcath](https://avatars.githubusercontent.com/u/19609?v=4)](https://github.com/Arcath "Arcath (4 commits)")[![ko31](https://avatars.githubusercontent.com/u/84167?v=4)](https://github.com/ko31 "ko31 (1 commits)")

### Embed Badge

![Health badge](/badges/ed-itsolutions-cmb2-field-ajax-search/health.svg)

```
[![Health](https://phpackages.com/badges/ed-itsolutions-cmb2-field-ajax-search/health.svg)](https://phpackages.com/packages/ed-itsolutions-cmb2-field-ajax-search)
```

###  Alternatives

[leafo/scssphp-compass

Compass for scssphp

64168.5k11](/packages/leafo-scssphp-compass)[sskaje/mqtt

sskaje's MQTT Class

8770.4k1](/packages/sskaje-mqtt)[copyleaks/php-plagiarism-checker

Copyleaks detects online plagiarism and checks content distribution. Use Copyleaks to find out if textual content is original and where it has been used before. This package shows how to integrate with the Copyleaks cloud to search for copyright infringement.

5174.0k](/packages/copyleaks-php-plagiarism-checker)[base62/base62

base62 encoder and decoder also for big numbers with Laravel integration

1610.5k](/packages/base62-base62)[sitewards/import_image_memory_leak_fix

Fix a memory leak issue with the product image import process.

186.7k](/packages/sitewards-import-image-memory-leak-fix)[sfolador/measures-for-laravel

A collection of unit conversions utils for Laravel

106.4k](/packages/sfolador-measures-for-laravel)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)