Current File : /home/getxxhzo/tinyrnd.com/wp-content/plugins/flyweb-common/meta-box/inc/fields/user.php |
<?php
/**
* The user select field.
*
* @package Meta Box
*/
/**
* User field class.
*/
class RWMB_User_Field extends RWMB_Object_Choice_Field {
/**
* Add actions.
*/
public static function add_actions() {
add_action( 'wp_ajax_rwmb_get_users', array( __CLASS__, 'ajax_get_users' ) );
add_action( 'wp_ajax_nopriv_rwmb_get_users', array( __CLASS__, 'ajax_get_users' ) );
add_action( 'clean_user_cache', array( __CLASS__, 'update_cache' ) );
}
/**
* Query users via ajax.
*/
public static function ajax_get_users() {
check_ajax_referer( 'query' );
$request = rwmb_request();
$field = $request->filter_post( 'field', FILTER_DEFAULT, FILTER_FORCE_ARRAY );
// Required for 'choice_label' filter. See self::filter().
$field['clone'] = false;
$field['_original_id'] = $field['id'];
// Search.
$term = $request->filter_post( 'term', FILTER_SANITIZE_STRING );
if ( $term ) {
$field['query_args']['search'] = "*{$term}*";
}
// Pagination.
$limit = isset( $field['query_args']['number'] ) ? (int) $field['query_args']['number'] : 0;
if ( $limit && 'query:append' === $request->filter_post( '_type', FILTER_SANITIZE_STRING ) ) {
$field['query_args']['paged'] = $request->filter_post( 'page', FILTER_SANITIZE_NUMBER_INT );
}
// Query the database.
$items = self::query( null, $field );
$items = array_values( $items );
$data = array( 'items' => $items );
// More items for pagination.
if ( $limit && count( $items ) === $limit ) {
$data['more'] = true;
}
wp_send_json_success( $data );
}
/**
* Update object cache to make sure query method below always get the fresh list of users.
* Unlike posts and terms, WordPress doesn't set 'last_changed' for users.
* So we have to do it ourselves.
*
* @see clean_post_cache()
*/
public static function update_cache() {
wp_cache_set( 'last_changed', microtime(), 'users' );
}
/**
* Normalize parameters for field.
*
* @param array $field Field parameters.
*
* @return array
*/
public static function normalize( $field ) {
// Set default field args.
$field = wp_parse_args(
$field,
array(
'placeholder' => __( 'Select an user', 'meta-box' ),
'query_args' => array(),
'display_field' => 'display_name',
)
);
$field = parent::normalize( $field );
// Set default query args.
$limit = $field['ajax'] ? 10 : 0;
$field['query_args'] = wp_parse_args(
$field['query_args'],
array(
'number' => $limit,
)
);
parent::set_ajax_params( $field );
if ( $field['ajax'] ) {
$field['js_options']['ajax_data']['field']['display_field'] = $field['display_field'];
}
return $field;
}
/**
* Query users for field options.
*
* @param array $meta Saved meta value.
* @param array $field Field settings.
* @return array Field options array.
*/
public static function query( $meta, $field ) {
$display_field = $field['display_field'];
$args = wp_parse_args(
$field['query_args'],
array(
'orderby' => $display_field,
'order' => 'asc',
)
);
// Query only selected items.
if ( ! empty( $field['ajax'] ) && ! empty( $meta ) ) {
$args['include'] = $meta;
}
// Get from cache to prevent same queries.
$last_changed = wp_cache_get_last_changed( 'users' );
$key = md5( serialize( $args ) );
$cache_key = "$key:$last_changed";
$options = wp_cache_get( $cache_key, 'meta-box-user-field' );
if ( false !== $options ) {
return $options;
}
$users = get_users( $args );
$options = array();
foreach ( $users as $user ) {
$options[ $user->ID ] = array(
'value' => $user->ID,
'label' => self::filter( 'choice_label', $user->$display_field, $field, $user ),
);
}
// Cache the query.
wp_cache_set( $cache_key, $options, 'meta-box-user-field' );
return $options;
}
/**
* Format a single value for the helper functions. Sub-fields should overwrite this method if necessary.
*
* @param array $field Field parameters.
* @param string $value The value.
* @param array $args Additional arguments. Rarely used. See specific fields for details.
* @param int|null $post_id Post ID. null for current post. Optional.
*
* @return string
*/
public static function format_single_value( $field, $value, $args, $post_id ) {
$display_field = $field['display_field'];
$user = get_userdata( $value );
return '<a href="' . esc_url( get_author_posts_url( $value ) ) . '">' . esc_html( $user->$display_field ) . '</a>';
}
}