Custom_Background::ajax_background_add()

Ajax handler for adding custom background context to an attachment.

Description

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

Source

File: wp-admin/custom-background.php 

	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();
	}

Expand Source Code View on GitHub

Related

Uses

Uses
Uses Description
wp-includes/pluggable.php: check_ajax_referer()

Verifies the Ajax request to prevent processing requests external of the blog.
wp-includes/capabilities.php: current_user_can()

Whether the current user has a specific capability.
wp-includes/theme.php: get_stylesheet()

Retrieve name of the current stylesheet.
wp-includes/post.php: update_post_meta()

Update post meta field based on post ID.
wp-includes/functions.php: absint()

Convert a value to non-negative integer.
wp-includes/functions.php: wp_send_json_error()

Send a JSON response back to an Ajax request, indicating failure.
wp-includes/functions.php: wp_send_json_success()

Send a JSON response back to an Ajax request, indicating success.
Show 2 more uses Hide more uses

Changelog

Changelog
Version Description
WP-4.1.0 Introduced.