BP_REST_XProfile_Field_Groups_Endpoint
XProfile Field Groups Endpoints.
Description
Use /xprofile/groups Use /xprofile/groups/{id}
Source
File: bp-xprofile/classes/class-bp-rest-xprofile-field-groups-endpoint.php
class BP_REST_XProfile_Field_Groups_Endpoint extends WP_REST_Controller {
/**
* XProfile Fields Class.
*
* @since 0.1.0
*
* @var BP_REST_XProfile_Fields_Endpoint
*/
protected $fields_endpoint;
/**
* Constructor.
*
* @since 0.1.0
*/
public function __construct() {
$this->namespace = bp_rest_namespace() . '/' . bp_rest_version();
$this->rest_base = buddypress()->profile->id . '/groups';
$this->fields_endpoint = new BP_REST_XProfile_Fields_Endpoint();
}
/**
* Register the component routes.
*
* @since 0.1.0
*/
public function register_routes() {
register_rest_route(
$this->namespace,
'/' . $this->rest_base,
array(
array(
'methods' => WP_REST_Server::READABLE,
'callback' => array( $this, 'get_items' ),
'permission_callback' => array( $this, 'get_items_permissions_check' ),
'args' => $this->get_collection_params(),
),
array(
'methods' => WP_REST_Server::CREATABLE,
'callback' => array( $this, 'create_item' ),
'permission_callback' => array( $this, 'create_item_permissions_check' ),
'args' => $this->get_endpoint_args_for_item_schema( WP_REST_Server::CREATABLE ),
),
'schema' => array( $this, 'get_item_schema' ),
)
);
register_rest_route(
$this->namespace,
'/' . $this->rest_base . '/(?P<id>[\d]+)',
array(
'args' => array(
'id' => array(
'description' => __( 'A unique numeric ID for the group of profile fields.', 'buddyboss' ),
'type' => 'integer',
),
),
array(
'methods' => WP_REST_Server::READABLE,
'callback' => array( $this, 'get_item' ),
'permission_callback' => array( $this, 'get_item_permissions_check' ),
),
array(
'methods' => WP_REST_Server::EDITABLE,
'callback' => array( $this, 'update_item' ),
'permission_callback' => array( $this, 'update_item_permissions_check' ),
'args' => $this->get_endpoint_args_for_item_schema( WP_REST_Server::EDITABLE ),
),
array(
'methods' => WP_REST_Server::DELETABLE,
'callback' => array( $this, 'delete_item' ),
'permission_callback' => array( $this, 'delete_item_permissions_check' ),
),
'schema' => array( $this, 'get_item_schema' ),
)
);
}
/**
* Edit some properties for the CREATABLE & EDITABLE methods.
*
* @param string $method Optional. HTTP method of the request.
*
* @return array Endpoint arguments.
* @since 0.1.0
*/
public function get_endpoint_args_for_item_schema( $method = WP_REST_Server::CREATABLE ) {
$args = WP_REST_Controller::get_endpoint_args_for_item_schema( $method );
$key = 'get_item';
if ( WP_REST_Server::CREATABLE === $method || WP_REST_Server::EDITABLE === $method ) {
$key = 'update_item';
$args['description']['type'] = 'string';
unset( $args['description']['properties'] );
if ( WP_REST_Server::CREATABLE === $method ) {
$key = 'create_item';
unset( $args['group_order'] );
}
} elseif ( WP_REST_Server::DELETABLE === $method ) {
$key = 'delete_item';
}
/**
* Filters the method query arguments.
*
* @param array $args Query arguments.
* @param string $method HTTP method of the request.
*
* @since 0.1.0
*/
return apply_filters( "bp_rest_xprofile_field_groups_{$key}_query_arguments", $args, $method );
}
/**
* Retrieve XProfile groups.
*
* @param WP_REST_Request $request Full data about the request.
*
* @return WP_REST_Response
* @since 0.1.0
*
* @api {GET} /wp-json/buddyboss/v1/xprofile/groups Get xProfile Groups
* @apiName GetBBxProfileGroups
* @apiGroup Profile Fields
* @apiDescription Retrieve xProfile Groups
* @apiVersion 1.0.0
* @apiPermission LoggedInUser if the site is in Private Network.
* @apiParam {Number} [profile_group_id] ID of the field group that have fields.
* @apiParam {Boolean} [hide_empty_groups=false] Whether to hide profile groups of fields that do not have any profile fields or not.
* @apiParam {Number} [user_id=1] Required if you want to load a specific user's data.
* @apiParam {string} [member_type] Limit fields by those restricted to a given member type, or array of member types.
* @apiParam {Boolean} [hide_empty_fields=false] Whether to hide profile groups of fields that do not have any profile fields or not.
* @apiParam {Boolean} [fetch_fields=false] Whether to fetch the fields for each group.
* @apiParam {Boolean} [fetch_field_data=false] Whether to fetch data for each field. Requires a $user_id.
* @apiParam {Boolean} [fetch_visibility_level=false] Whether to fetch the visibility level for each field.
* @apiParam {Array} [exclude_groups] Ensure result set excludes specific profile field groups.
* @apiParam {Array} [exclude_fields] Ensure result set excludes specific profile fields.
* @apiParam {Boolean} [update_meta_cache=true] Whether to pre-fetch xprofilemeta for all retrieved groups, fields, and data.
*/
public function get_items( $request ) {
$args = array(
'profile_group_id' => $request['profile_group_id'],
'user_id' => $request['user_id'],
'member_type' => $request['member_type'],
'hide_empty_groups' => $request['hide_empty_groups'],
'hide_empty_fields' => $request['hide_empty_fields'],
'fetch_fields' => $request['fetch_fields'],
'fetch_field_data' => $request['fetch_field_data'],
'fetch_visibility_level' => $request['fetch_visibility_level'],
'exclude_groups' => $request['exclude_groups'],
'exclude_fields' => $request['exclude_fields'],
'update_meta_cache' => $request['update_meta_cache'],
);
if ( empty( $request['member_type'] ) ) {
$args['member_type'] = null;
}
if ( empty( $request['exclude_fields'] ) ) {
$args['exclude_fields'] = false;
}
if ( empty( $request['exclude_groups'] ) ) {
$args['exclude_groups'] = false;
}
/**
* Filter the query arguments for the request.
*
* @param array $args Key value array of query var to query value.
* @param WP_REST_Request $request The request sent to the API.
*
* @since 0.1.0
*/
$args = apply_filters( 'bp_rest_xprofile_field_groups_get_items_query_args', $args, $request );
// Actually, query it.
$field_groups = bp_xprofile_get_groups( $args );
$retval = array();
foreach ( (array) $field_groups as $item ) {
$retval[] = $this->prepare_response_for_collection(
$this->prepare_item_for_response( $item, $request )
);
}
$response = rest_ensure_response( $retval );
/**
* Fires after a list of field groups are fetched via the REST API.
*
* @param array $field_groups Fetched field groups.
* @param WP_REST_Response $response The response data.
* @param WP_REST_Request $request The request sent to the API.
*
* @since 0.1.0
*/
do_action( 'bp_rest_xprofile_field_groups_get_items', $field_groups, $response, $request );
return $response;
}
/**
* Check if a given request has access to XProfile field groups items.
*
* @param WP_REST_Request $request Full data about the request.
*
* @return bool
* @since 0.1.0
*/
public function get_items_permissions_check( $request ) {
$retval = true;
if ( function_exists( 'bp_enable_private_network' ) && true !== bp_enable_private_network() && ! is_user_logged_in() ) {
$retval = new WP_Error(
'bp_rest_authorization_required',
__( 'Sorry, Restrict access to only logged-in members.', 'buddyboss' ),
array(
'status' => rest_authorization_required_code(),
)
);
}
/**
* Filter the XProfile fields groups `get_items` permissions check.
*
* @param bool $retval Returned value.
* @param WP_REST_Request $request The request sent to the API.
*
* @since 0.1.0
*/
return apply_filters( 'bp_rest_xprofile_field_groups_get_items_permissions_check', $retval, $request );
}
/**
* Retrieve single XProfile field group.
*
* @param WP_REST_Request $request Full data about the request.
*
* @return WP_REST_Response|WP_Error
* @since 0.1.0
*
* @api {GET} /wp-json/buddyboss/v1/xprofile/groups/:id Get xProfile Group
* @apiName GetBBxProfilGroup
* @apiGroup Profile Fields
* @apiDescription Retrieve Single xProfile Group
* @apiVersion 1.0.0
* @apiPermission LoggedInUser if the site is in Private Network.
* @apiParam {Number} id A unique numeric ID for the group of profile fields.
* @apiParam {Number} [user_id=1] Required if you want to load a specific user's data.
* @apiParam {string} [member_type] Limit fields by those restricted to a given member type, or array of member types.
* @apiParam {Boolean} [hide_empty_fields=false] Whether to hide profile groups of fields that do not have any profile fields or not.
* @apiParam {Boolean} [fetch_fields=false] Whether to fetch the fields for each group.
* @apiParam {Boolean} [fetch_field_data=false] Whether to fetch data for each field. Requires a $user_id.
* @apiParam {Boolean} [fetch_visibility_level=false] Whether to fetch the visibility level for each field.
* @apiParam {Array} [exclude_fields] Ensure result set excludes specific profile fields.
* @apiParam {Boolean} [update_meta_cache=true] Whether to pre-fetch xprofilemeta for all retrieved groups, fields, and data.
*/
public function get_item( $request ) {
$field_group = $this->get_xprofile_field_group_object( $request );
if ( empty( $field_group->id ) ) {
return new WP_Error(
'bp_rest_invalid_id',
__( 'Invalid field group ID.', 'buddyboss' ),
array(
'status' => 404,
)
);
}
$retval = $this->prepare_response_for_collection(
$this->prepare_item_for_response( $field_group, $request )
);
$response = rest_ensure_response( $retval );
/**
* Fires after a field group is fetched via the REST API.
*
* @param BP_XProfile_Group $field_group Fetched field group.
* @param WP_REST_Response $response The response data.
* @param WP_REST_Request $request The request sent to the API.
*
* @since 0.1.0
*/
do_action( 'bp_rest_xprofile_field_groups_get_item', $field_group, $response, $request );
return $response;
}
/**
* Check if a given request has access to get information about a specific field group.
*
* @param WP_REST_Request $request Full data about the request.
*
* @return bool|WP_Error
* @since 0.1.0
*/
public function get_item_permissions_check( $request ) {
$retval = $this->get_items_permissions_check( $request );
/**
* Filter the XProfile fields groups `get_item` permissions check.
*
* @param bool|WP_Error $retval Returned value.
* @param WP_REST_Request $request The request sent to the API.
*
* @since 0.1.0
*/
return apply_filters( 'bp_rest_xprofile_field_groups_get_item_permissions_check', $retval, $request );
}
/**
* Create a XProfile field group.
*
* @param WP_REST_Request $request Full data about the request.
*
* @return WP_REST_Response|WP_Error
* @since 0.1.0
*
* @api {POST} /wp-json/buddyboss/v1/xprofile/groups Create xProfile Group
* @apiName CreateBBxProfileGroup
* @apiGroup Profile Fields
* @apiDescription Create a Group
* @apiVersion 1.0.0
* @apiPermission LoggedInUser
* @apiParam {String} name The name of group of profile fields.
* @apiParam {String} [description] The description of the group of profile fields.
* @apiParam {Boolean} [can_delete=true] Whether the group of profile fields can be deleted or not.
* @apiParam {Boolean} [repeater_enabled=false] The description of the profile field.
*/
public function create_item( $request ) {
// Setting context.
$request->set_param( 'context', 'edit' );
$args = array(
'name' => $request['name'],
'description' => $request['description'],
'can_delete' => $request['can_delete'],
);
/**
* Filter the query arguments for the request.
*
* @param array $args Key value array of query var to query value.
* @param WP_REST_Request $request The request sent to the API.
*
* @since 0.1.0
*/
$args = apply_filters( 'bp_rest_xprofile_field_groups_create_item_query_args', $args, $request );
if ( empty( $args['name'] ) ) {
return new WP_Error(
'bp_rest_required_param_missing',
__( 'Required param missing.', 'buddyboss' ),
array(
'status' => 400,
)
);
}
$group_id = xprofile_insert_field_group( $args );
if ( ! $group_id ) {
return new WP_Error(
'bp_rest_user_cannot_create_xprofile_field_group',
__( 'Cannot create new XProfile field group.', 'buddyboss' ),
array(
'status' => 500,
)
);
}
$field_group = $this->get_xprofile_field_group_object( $group_id );
// Create Additional fields.
$fields_update = $this->update_additional_fields_for_object( $field_group, $request );
if ( is_wp_error( $fields_update ) ) {
return $fields_update;
}
$retval = $this->prepare_response_for_collection(
$this->prepare_item_for_response( $field_group, $request )
);
$response = rest_ensure_response( $retval );
/**
* Fires after a XProfile field group is created via the REST API.
*
* @param BP_XProfile_Group $field_group Created field group object.
* @param WP_REST_Response $response The response data.
* @param WP_REST_Request $request The request sent to the API.
*
* @since 0.1.0
*/
do_action( 'bp_rest_xprofile_field_groups_create_item', $field_group, $response, $request );
return $response;
}
/**
* Check if a given request has access to create a XProfile field group.
*
* @param WP_REST_Request $request Full data about the request.
*
* @return WP_Error|bool
* @since 0.1.0
*/
public function create_item_permissions_check( $request ) {
$retval = true;
if ( ! ( is_user_logged_in() && bp_current_user_can( 'bp_moderate' ) ) ) {
$retval = new WP_Error(
'bp_rest_authorization_required',
__( 'Sorry, you are not allowed to view this XProfile field group.', 'buddyboss' ),
array(
'status' => rest_authorization_required_code(),
)
);
}
/**
* Filter the XProfile fields groups `create_item` permissions check.
*
* @param bool|WP_Error $retval Returned value.
* @param WP_REST_Request $request The request sent to the API.
*
* @since 0.1.0
*/
return apply_filters( 'bp_rest_xprofile_field_groups_create_item_permissions_check', $retval, $request );
}
/**
* Update a XProfile field group.
*
* @param WP_REST_Request $request Full data about the request.
*
* @return WP_REST_Response|WP_Error
* @since 0.1.0
*
* @api {PATCH} /wp-json/buddyboss/v1/xprofile/groups/:id Update xProfile Group
* @apiName UpdateBBxProfileGroup
* @apiGroup Profile Fields
* @apiDescription Update a Group
* @apiVersion 1.0.0
* @apiPermission LoggedInUser
* @apiParam {Number} id A unique numeric ID for the group of profile fields.
* @apiParam {String} [name] The name of group of profile fields.
* @apiParam {String} [description] The description of the group of profile fields.
* @apiParam {Number} [group_order] The order of the group of profile fields.
* @apiParam {Boolean} [can_delete] Whether the group of profile fields can be deleted or not.
* @apiParam {Boolean} [repeater_enabled] The description of the profile field.
*/
public function update_item( $request ) {
// Setting context.
$request->set_param( 'context', 'edit' );
$field_group = $this->get_xprofile_field_group_object( $request );
if ( empty( $field_group->id ) ) {
return new WP_Error(
'bp_rest_invalid_id',
__( 'Invalid field group ID.', 'buddyboss' ),
array(
'status' => 404,
)
);
}
$args = array(
'field_group_id' => $field_group->id,
'name' => is_null( $request['name'] ) ? $field_group->name : $request['name'],
'description' => is_null( $request['description'] ) ? $field_group->description : $request['description'],
'can_delete' => is_null( $request['can_delete'] ) ? (bool) $field_group->can_delete : $request['can_delete'],
);
$group_id = xprofile_insert_field_group( $args );
if ( ! $group_id ) {
return new WP_Error(
'bp_rest_user_cannot_update_xprofile_field_group',
__( 'Cannot update XProfile field group.', 'buddyboss' ),
array(
'status' => 500,
)
);
}
// Update the position if the group_order exists.
if ( is_numeric( $request['group_order'] ) ) {
xprofile_update_field_group_position( $group_id, $request['group_order'] );
}
// Update the group meta for repeater set.
if ( isset( $request['repeater_enabled'] ) ) {
if ( true === $request['repeater_enabled'] ) {
bp_xprofile_update_meta( $group_id, 'group', 'is_repeater_enabled', 'on' );
} else {
bp_xprofile_update_meta( $group_id, 'group', 'is_repeater_enabled', 'off' );
}
} else {
$repeater_enabled = bp_xprofile_get_meta( $group_id, 'group', 'is_repeater_enabled', true );
if ( ! empty( $repeater_enabled ) && 'on' === $repeater_enabled ) {
bp_xprofile_update_meta( $group_id, 'group', 'is_repeater_enabled', 'on' );
} else {
bp_xprofile_update_meta( $group_id, 'group', 'is_repeater_enabled', 'off' );
}
}
$field_group = $this->get_xprofile_field_group_object( $group_id );
// Update Additional fields.
$fields_update = $this->update_additional_fields_for_object( $field_group, $request );
if ( is_wp_error( $fields_update ) ) {
return $fields_update;
}
$retval = $this->prepare_response_for_collection(
$this->prepare_item_for_response( $field_group, $request )
);
$response = rest_ensure_response( $retval );
/**
* Fires after a XProfile field group is updated via the REST API.
*
* @param BP_XProfile_Group $field_group Updated field group object.
* @param WP_REST_Response $response The response data.
* @param WP_REST_Request $request The request sent to the API.
*
* @since 0.1.0
*/
do_action( 'bp_rest_xprofile_field_groups_update_item', $field_group, $response, $request );
return $response;
}
/**
* Check if a given request has access to create a XProfile field group.
*
* @param WP_REST_Request $request Full data about the request.
*
* @return WP_Error|bool
* @since 0.1.0
*/
public function update_item_permissions_check( $request ) {
$retval = $this->create_item_permissions_check( $request );
/**
* Filter the XProfile fields groups `create_item` permissions check.
*
* @param bool|WP_Error $retval Returned value.
* @param WP_REST_Request $request The request sent to the API.
*
* @since 0.1.0
*/
return apply_filters( 'bp_rest_xprofile_field_groups_update_item_permissions_check', $retval, $request );
}
/**
* Delete a XProfile field group.
*
* @param WP_REST_Request $request Full data about the request.
*
* @return WP_REST_Response|WP_Error
* @since 0.1.0
*
* @api {DELETE} /wp-json/buddyboss/v1/xprofile/groups/:id Delete xProfile Group
* @apiName DeleteBBxProfileGroup
* @apiGroup Profile Fields
* @apiDescription Delete xProfile Group.
* @apiVersion 1.0.0
* @apiPermission LoggedInUser
* @apiParam {Number} id A unique numeric ID for the group of profile fields.
*/
public function delete_item( $request ) {
// Setting context.
$request->set_param( 'context', 'edit' );
// Get the field group before it's deleted.
$field_group = $this->get_xprofile_field_group_object( $request );
if ( empty( $field_group->id ) ) {
return new WP_Error(
'bp_rest_invalid_id',
__( 'Invalid field group ID.', 'buddyboss' ),
array(
'status' => 404,
)
);
}
if ( ! xprofile_delete_field_group( $field_group->id ) ) {
return new WP_Error(
'bp_rest_xprofile_field_group_cannot_delete',
__( 'Could not delete XProfile field group.', 'buddyboss' ),
array(
'status' => 500,
)
);
}
// Build the response.
$previous = $this->prepare_item_for_response( $field_group, $request );
$response = new WP_REST_Response();
$response->set_data(
array(
'deleted' => true,
'previous' => $previous->get_data(),
)
);
/**
* Fires after a field group is deleted via the REST API.
*
* @param BP_XProfile_Group $field_group Deleted field group.
* @param WP_REST_Response $response The response data.
* @param WP_REST_Request $request The request sent to the API.
*
* @since 0.1.0
*/
do_action( 'bp_rest_xprofile_field_groups_delete_item', $field_group, $response, $request );
return $response;
}
/**
* Check if a given request has access to delete a field group.
*
* @param WP_REST_Request $request Full data about the request.
*
* @return WP_Error|bool
* @since 0.1.0
*/
public function delete_item_permissions_check( $request ) {
$retval = $this->create_item_permissions_check( $request );
/**
* Filter the XProfile fields groups `delete_item` permissions check.
*
* @param bool|WP_Error $retval Returned value.
* @param WP_REST_Request $request The request sent to the API.
*
* @since 0.1.0
*/
return apply_filters( 'bp_rest_xprofile_field_groups_delete_item_permissions_check', $retval, $request );
}
/**
* Prepares single XProfile field group data for return as an object.
*
* @param BP_XProfile_Group $group XProfile field group data.
* @param WP_REST_Request $request Full data about the request.
*
* @return WP_REST_Response
* @since 0.1.0
*/
public function prepare_item_for_response( $group, $request ) {
$data = array(
'id' => (int) $group->id,
'name' => $group->name,
'description' => array(
'raw' => $group->description,
'rendered' => apply_filters( 'bp_get_the_profile_field_description', $group->description ),
),
'group_order' => (int) $group->group_order,
'can_delete' => (bool) $group->can_delete,
'repeater_enabled' => false,
);
// Check for repeater set is enable of not.
$repeater_enabled = bp_xprofile_get_meta( $group->id, 'group', 'is_repeater_enabled', true );
if ( ! empty( $repeater_enabled ) && 'on' === $repeater_enabled ) {
$data['repeater_enabled'] = true;
}
// If the fields have been requested, we populate them.
if ( $request['fetch_fields'] ) {
$data['fields'] = array();
foreach ( $group->fields as $field ) {
/**
* Added support for display name format support from platform.
*/
// Get the current display settings from BuddyBoss > Settings > Profiles > Display Name Format.
$current_value = bp_get_option( 'bp-display-name-format' );
// If First Name selected then do not add last name field.
if ( 'first_name' === $current_value && function_exists( 'bp_xprofile_lastname_field_id' ) && bp_xprofile_lastname_field_id() === $field->id ) {
if ( function_exists( 'bp_hide_last_name' ) && false === bp_hide_last_name() ) {
continue;
}
// If Nick Name selected then do not add first & last name field.
} elseif ( 'nickname' === $current_value && function_exists( 'bp_xprofile_lastname_field_id' ) && bp_xprofile_lastname_field_id() === $field->id ) {
if ( function_exists( 'bp_hide_nickname_last_name' ) && false === bp_hide_nickname_last_name() ) {
continue;
}
} elseif ( 'nickname' === $current_value && function_exists( 'bp_xprofile_firstname_field_id' ) && bp_xprofile_firstname_field_id() === $field->id ) {
if ( function_exists( 'bp_hide_nickname_first_name' ) && false === bp_hide_nickname_first_name() ) {
continue;
}
}
if ( function_exists( 'bp_member_type_enable_disable' ) && false === bp_member_type_enable_disable() ) {
if ( function_exists( 'bp_get_xprofile_member_type_field_id' ) && bp_get_xprofile_member_type_field_id() === $field->id ) {
continue;
}
}
/**
* --Added support for display name format support from platform.
*/
$data['fields'][] = $this->fields_endpoint->assemble_response_data( $field, $request );
}
}
$context = ! empty( $request['context'] ) ? $request['context'] : 'view';
$data = $this->add_additional_fields_to_object( $data, $request );
$data = $this->filter_response_by_context( $data, $context );
$response = rest_ensure_response( $data );
$response->add_links( $this->prepare_links( $group ) );
/**
* Filter the XProfile field group returned from the API.
*
* @param WP_REST_Response $response The response data.
* @param WP_REST_Request $request Request used to generate the response.
* @param BP_XProfile_Group $group XProfile field group.
*
* @since 0.1.0
*/
return apply_filters( 'bp_rest_xprofile_field_groups_prepare_value', $response, $request, $group );
}
/**
* Prepare links for the request.
*
* @param BP_XProfile_Group $group XProfile field group.
*
* @return array
* @since 0.1.0
*/
protected function prepare_links( $group ) {
$base = sprintf( '/%s/%s/', $this->namespace, $this->rest_base );
// Entity meta.
$links = array(
'self' => array(
'href' => rest_url( $base . $group->id ),
),
'collection' => array(
'href' => rest_url( $base ),
),
);
/**
* Filter links prepared for the REST response.
*
* @param array $links The prepared links of the REST response.
* @param BP_XProfile_Group $group XProfile field group object.
*
* @since 0.1.0
*/
return apply_filters( 'bp_rest_xprofile_field_groups_prepare_links', $links, $group );
}
/**
* Get XProfile field group object.
*
* @param WP_REST_Request $request Full details about the request.
*
* @return BP_XProfile_Group|string XProfile field group object.
* @since 0.1.0
*/
public function get_xprofile_field_group_object( $request ) {
$profile_group_id = is_numeric( $request ) ? $request : (int) $request['id'];
$args = array(
'profile_group_id' => $profile_group_id,
'user_id' => $request['user_id'],
'member_type' => $request['member_type'],
'hide_empty_fields' => $request['hide_empty_fields'],
'fetch_fields' => $request['fetch_fields'],
'fetch_field_data' => $request['fetch_field_data'],
'fetch_visibility_level' => $request['fetch_visibility_level'],
'exclude_fields' => $request['exclude_fields'],
'update_meta_cache' => $request['update_meta_cache'],
);
if ( empty( $request['member_type'] ) ) {
$args['member_type'] = null;
}
if ( empty( $request['exclude_fields'] ) ) {
$args['exclude_fields'] = false;
}
$field_group = current( bp_xprofile_get_groups( $args ) );
if ( empty( $field_group->id ) ) {
return '';
}
return $field_group;
}
/**
* Get the XProfile field group schema, conforming to JSON Schema.
*
* @return array
* @since 0.1.0
*/
public function get_item_schema() {
$schema = array(
'$schema' => 'http://json-schema.org/draft-04/schema#',
'title' => 'bp_xprofile_group',
'type' => 'object',
'properties' => array(
'id' => array(
'context' => array( 'embed', 'view', 'edit' ),
'description' => __( 'A unique numeric ID for the group of profile fields.', 'buddyboss' ),
'readonly' => true,
'type' => 'integer',
),
'name' => array(
'context' => array( 'embed', 'view', 'edit' ),
'description' => __( 'The name of group of profile fields.', 'buddyboss' ),
'type' => 'string',
'arg_options' => array(
'sanitize_callback' => 'sanitize_text_field',
),
),
'description' => array(
'context' => array( 'embed', 'view', 'edit' ),
'description' => __( 'The description of the group of profile fields.', 'buddyboss' ),
'type' => 'object',
'arg_options' => array(
'sanitize_callback' => null,
// Note: sanitization implemented in self::prepare_item_for_database().
'validate_callback' => null,
// Note: validation implemented in self::prepare_item_for_database().
),
'properties' => array(
'raw' => array(
'description' => __( 'Content for the group of profile fields, as it exists in the database.', 'buddyboss' ),
'type' => 'string',
'context' => array( 'edit' ),
),
'rendered' => array(
'description' => __( 'HTML content for the group of profile fields, transformed for display.', 'buddyboss' ),
'type' => 'string',
'context' => array( 'embed', 'view', 'edit' ),
'readonly' => true,
),
),
),
'group_order' => array(
'context' => array( 'embed', 'view', 'edit' ),
'description' => __( 'The order of the group of profile fields.', 'buddyboss' ),
'type' => 'integer',
),
'can_delete' => array(
'context' => array( 'embed', 'view', 'edit' ),
'description' => __( 'Whether the group of profile fields can be deleted or not.', 'buddyboss' ),
'type' => 'boolean',
),
'repeater_enabled' => array(
'context' => array( 'embed', 'view', 'edit' ),
'description' => __( 'Whether the group of profile fields can be repeated or not.', 'buddyboss' ),
'type' => 'boolean',
),
'fields' => array(
'context' => array( 'embed', 'view', 'edit' ),
'description' => __( 'The fields associated with this group of profile fields.', 'buddyboss' ),
'type' => 'array',
'readonly' => true,
),
),
);
/**
* Filters the xprofile field group schema.
*
* @param array $schema The endpoint schema.
*/
return apply_filters( 'bp_rest_xprofile_field_group_schema', $this->add_additional_fields_schema( $schema ) );
}
/**
* Get the query params for XProfile field groups.
*
* @return array
* @since 0.1.0
*/
public function get_collection_params() {
$params = parent::get_collection_params();
$params['context']['default'] = 'view';
$params['profile_group_id'] = array(
'description' => __( 'ID of the field group that have fields.', 'buddyboss' ),
'default' => 0,
'type' => 'integer',
'sanitize_callback' => 'absint',
'validate_callback' => 'rest_validate_request_arg',
);
$params['hide_empty_groups'] = array(
'description' => __( 'Whether to hide profile groups of fields that do not have any profile fields or not.', 'buddyboss' ),
'default' => false,
'type' => 'boolean',
'sanitize_callback' => 'rest_sanitize_boolean',
'validate_callback' => 'rest_validate_request_arg',
);
$params['user_id'] = array(
'description' => __( 'Required if you want to load a specific user\'s data.', 'buddyboss' ),
'default' => bp_loggedin_user_id(),
'type' => 'integer',
'sanitize_callback' => 'absint',
'validate_callback' => 'rest_validate_request_arg',
);
$params['member_type'] = array(
'description' => __( 'Limit fields by those restricted to a given member type, or array of member types. If `$user_id` is provided, the value of `$member_type` will be overridden by the member types of the provided user. The special value of \'any\' will return only those fields that are unrestricted by member type - i.e., those applicable to any type.', 'buddyboss' ),
'default' => array(),
'type' => 'array',
'items' => array( 'type' => 'string' ),
'sanitize_callback' => 'bp_rest_sanitize_member_types',
'validate_callback' => 'bp_rest_validate_member_types',
);
$params['hide_empty_fields'] = array(
'description' => __( 'Whether to hide profile groups of fields that do not have any profile fields or not.', 'buddyboss' ),
'default' => false,
'type' => 'boolean',
'sanitize_callback' => 'rest_sanitize_boolean',
'validate_callback' => 'rest_validate_request_arg',
);
$params['fetch_fields'] = array(
'description' => __( 'Whether to fetch the fields for each group.', 'buddyboss' ),
'default' => false,
'type' => 'boolean',
'sanitize_callback' => 'rest_sanitize_boolean',
'validate_callback' => 'rest_validate_request_arg',
);
$params['fetch_field_data'] = array(
'description' => __( 'Whether to fetch data for each field. Requires a $user_id.', 'buddyboss' ),
'default' => false,
'type' => 'boolean',
'sanitize_callback' => 'rest_sanitize_boolean',
'validate_callback' => 'rest_validate_request_arg',
);
$params['fetch_visibility_level'] = array(
'description' => __( 'Whether to fetch the visibility level for each field.', 'buddyboss' ),
'default' => false,
'type' => 'boolean',
'sanitize_callback' => 'rest_sanitize_boolean',
'validate_callback' => 'rest_validate_request_arg',
);
$params['exclude_groups'] = array(
'description' => __( 'Ensure result set excludes specific profile field groups.', 'buddyboss' ),
'default' => array(),
'type' => 'array',
'items' => array( 'type' => 'integer' ),
'sanitize_callback' => 'bp_rest_sanitize_string_list',
'validate_callback' => 'rest_validate_request_arg',
);
$params['exclude_fields'] = array(
'description' => __( 'Ensure result set excludes specific profile fields.', 'buddyboss' ),
'default' => array(),
'type' => 'array',
'items' => array( 'type' => 'string' ),
'sanitize_callback' => 'bp_rest_sanitize_string_list',
'validate_callback' => 'rest_validate_request_arg',
);
$params['update_meta_cache'] = array(
'description' => __( 'Whether to pre-fetch xprofilemeta for all retrieved groups, fields, and data.', 'buddyboss' ),
'default' => true,
'type' => 'boolean',
'sanitize_callback' => 'rest_sanitize_boolean',
'validate_callback' => 'rest_validate_request_arg',
);
/**
* Filters the collection query params.
*
* @param array $params Query params.
*/
return apply_filters( 'bp_rest_xprofile_field_groups_collection_params', $params );
}
}
Changelog
| Version | Description |
|---|---|
| 0.1.0 | Introduced. |
Methods
- __construct — Constructor.
- create_item — Create a XProfile field group.
- create_item_permissions_check — Check if a given request has access to create a XProfile field group.
- delete_item — Delete a XProfile field group.
- delete_item_permissions_check — Check if a given request has access to delete a field group.
- get_collection_params — Get the query params for XProfile field groups.
- get_endpoint_args_for_item_schema — Edit some properties for the CREATABLE & EDITABLE methods.
- get_item — Retrieve single XProfile field group.
- get_item_permissions_check — Check if a given request has access to get information about a specific field group.
- get_item_schema — Get the XProfile field group schema, conforming to JSON Schema.
- get_items — Retrieve XProfile groups.
- get_items_permissions_check — Check if a given request has access to XProfile field groups items.
- get_xprofile_field_group_object — Get XProfile field group object.
- prepare_item_for_response — Prepares single XProfile field group data for return as an object.
- prepare_links — Prepare links for the request.
- register_routes — Register the component routes.
- update_item — Update a XProfile field group.
- update_item_permissions_check — Check if a given request has access to create a XProfile field group.
Questions?
We're always happy to help with code or other questions you might have! Search our developer docs, contact support, or connect with our sales team.