W3cubDocs

/WordPress

Custom_Background::ajax_background_add()

Handles Ajax request for adding custom background context to an attachment.

Description

Triggers when the user adds a new background image from the Media Manager.

Source

public function ajax_background_add() {
	check_ajax_referer( 'background-add', 'nonce' );

	if ( ! current_user_can( 'edit_theme_options' ) ) {
		wp_send_json_error();
	}

	$attachment_id = absint( $_POST['attachment_id'] );
	if ( $attachment_id < 1 ) {
		wp_send_json_error();
	}

	update_post_meta( $attachment_id, '_wp_attachment_is_custom_background', get_stylesheet() );

	wp_send_json_success();
}

Changelog

Version Description
4.1.0 Introduced.

© 2003–2024 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/custom_background/ajax_background_add