Merge pull request wpmetabox#409 from michaelhume/master

Add support for 'Users' Field

inc/fields/user.php

@@ -0,0 +1,140 @@
+<?php
+// Prevent loading this file directly
+defined( 'ABSPATH' ) || exit;
+
+// Make sure "select" field is loaded
+require_once RWMB_FIELDS_DIR . 'select-advanced.php';
+
+if ( !class_exists( 'RWMB_User_Field' ) )
+{
+ class RWMB_User_Field extends RWMB_Field
+ {
+ /**
+ * Enqueue scripts and styles
+ *
+ * @return void
+ */
+ static function admin_enqueue_scripts()
+ {
+ RWMB_Select_Advanced_Field::admin_enqueue_scripts();
+ }
+
+ /**
+ * Get field HTML
+ *
+ * @param mixed $meta
+ * @param array $field
+ *
+ * @return string
+ */
+ static function html( $meta, $field )
+ {
+ $field['options'] = self::get_options( $field );
+ switch ( $field['field_type'] )
+ {
+ case 'select':
+ return RWMB_Select_Field::html( $meta, $field );
+ break;
+ case 'select_advanced':
+ default:
+ return RWMB_Select_Advanced_Field::html( $meta, $field );
+ }
+ }
+
+ /**
+ * Normalize parameters for field
+ *
+ * @param array $field
+ *
+ * @return array
+ */
+ static function normalize_field( $field )
+ {
+
+ $default_post_type = __( 'User', 'rwmb' );
+
+ $field = wp_parse_args( $field, array(
+ 'field_type' => 'select_advanced',
+ 'parent' => false,
+ 'query_args' => array()
+ ) );
+
+ $field['std'] = empty( $field['std'] ) ? sprintf( __( 'Select a %s', 'rwmb' ), $default_post_type ) : $field['std'];
+
+ $field['query_args'] = wp_parse_args( $field['query_args'], array(
+ 'orderby' => 'display_name',
+ 'order' => 'asc',
+ 'role' => '',
+ 'fields' => 'all'
+ ) );
+
+ switch ( $field['field_type'] )
+ {
+ case 'select':
+ return RWMB_Select_Field::normalize_field( $field );
+ break;
+ case 'select_advanced':
+ default:
+ return RWMB_Select_Advanced_Field::normalize_field( $field );
+ }
+ }
+
+ /**
+ * Get meta value
+ * If field is cloneable, value is saved as a single entry in DB
+ * Otherwise value is saved as multiple entries (for backward compatibility)
+ *
+ * @see "save" method for better understanding
+ *
+ * @param $post_id
+ * @param $saved
+ * @param $field
+ *
+ * @return array
+ */
+ static function meta( $post_id, $saved, $field )
+ {
+ if ( isset( $field['parent'] ) && $field['parent'] )
+ {
+ $post = get_post( $post_id );
+ return $post->post_parent;
+ }
+ return RWMB_Select_Field::meta( $post_id, $saved, $field );
+ }
+
+ /**
+ * Save meta value
+ * If field is cloneable, value is saved as a single entry in DB
+ * Otherwise value is saved as multiple entries (for backward compatibility)
+ *
+ * TODO: A good way to ALWAYS save values in single entry in DB, while maintaining backward compatibility
+ *
+ * @param $new
+ * @param $old
+ * @param $post_id
+ * @param $field
+ */
+ static function save( $new, $old, $post_id, $field )
+ {
+ return RWMB_Select_Field::save( $new, $old, $post_id, $field );
+ }
+
+ /**
+ * Get users
+ *
+ * @param array $field
+ *
+ * @return array
+ */
+ static function get_options( $field )
+ {
+ $results = get_users( $field['query_args'] );
+ $options = array();
+ foreach ( $results as $result )
+ {
+ $options[$result->ID] = $result->display_name ;
+ }
+ return $options;
+ }
+ }
+}