Group Cover Image

Schema

The schema defines all the fields that exist for a group’s cover image object.

image

string,
uri
Full size of the image file.
Read only
Context: viewedit

Top ↑

Retrieve the Cover Image of a Group

Top ↑

Arguments

NameTypeDescription
group_idintegerA unique numeric ID for the Group.

Top ↑

Definition

GET /buddypress/v1/groups/<group_id>/cover

Top ↑

Example of use

Alert: To use the bp.apiRequest function, you need to enqueue the bp-api-request JavaScript or use it as a dependency of your script. Refer to this page to know more about loading JavaScript files in WordPress.
bp.apiRequest( {
  path: 'buddypress/v1/groups/46/cover',
  type: 'GET'
} ).done( function( data ) {
  return data;
} ).fail( function( error ) {
  return error;
} );

Top ↑

Attach a Cover Image to a Group

Top ↑

Arguments

NameTypeDescription
group_idintegerA unique numeric ID for the Group.

Alert: The file input name to use to upload the file must be file and the form action must be bp_cover_image_upload.

Top ↑

Definition

POST /buddypress/v1/groups/<group_id>/cover

Top ↑

Example of use

Alert: To use the bp.apiRequest function, you need to enqueue the bp-api-request JavaScript or use it as a dependency of your script. Refer to this page to know more about loading JavaScript files in WordPress.

( function( $ ){
	// Listen to the injected File Input's change.
	$( '#main article .entry-content' ).on( 'change', 'input[type="file"]', function( event ) {
		var formData = new FormData();

		if ( ! event.currentTarget.files || ! event.currentTarget.files[0] ) {
			return;
		}

		// The `action` is required and must be `bp_cover_image_upload`.
		formData.append( 'action', 'bp_cover_image_upload' );

		// The `file` is required and must be an image.
		formData.append( 'file', event.currentTarget.files[0] );

		bp.apiRequest( {
			path: 'buddypress/v1/groups/46/cover',
			type: 'POST',
			data: formData,
			contentType: false,
			processData: false,
		} ).done( function( data ) {
			console.log( data );
		} ).fail( function( error ) {
			console.log( error );
		} );
	} );
	
	/**
	 * Inject a File input
	 *
	 * PS: Active WordPress Theme for the test is Twenty Nineteen.
	 */
	$( document ).ready( function() {
		$( '#main article .entry-content' ).append(
			$( '<input></input>' ).prop( {
				type: 'file',
				accept: 'image/jpg'
			} )
		);
	} );
}( jQuery ) );

Top ↑

Delete the Cover Image of a Group

Top ↑

Arguments

NameTypeDescription
group_idintegerA unique numeric ID for the Group.

Top ↑

Definition

DELETE /buddypress/v1/groups/<group_id>/cover

Top ↑

Example of use

Alert: To use the bp.apiRequest function, you need to enqueue the bp-api-request JavaScript or use it as a dependency of your script. Refer to this page to know more about loading JavaScript files in WordPress.

bp.apiRequest( {
  path: 'buddypress/v1/groups/46/cover',
  type: 'DELETE'
} ).done( function( data ) {
  return data;
} ).fail( function( error ) {
  return error;
} );