wp_ajax_send_attachment_to_editor()

Description

Hooks fired · 1

One hook fires while wp_ajax_send_attachment_to_editor() runs, in this order:

1. 1
   apply_filters( media_send_to_editor )filterline 3407 (+60 into the body)

   Filters the HTML markup for a media item sent to the editor.

Uses · 16

• check_ajax_referer()Verifies the Ajax request to prevent processing requests external of the blog.
• wp_unslash()Removes slashes from a string or recursively removes slashes from strings within an array.
• get_post()Retrieves post data given a post ID or post object.
• wp_send_json_error()Sends a JSON response back to an Ajax request, indicating failure.
• current_user_can()Returns whether the current user has the specified capability.
• wp_update_post()Updates a post with new post data.
• str_contains()Polyfill for `str_contains()` function added in PHP 8.0.
• get_attachment_link()Retrieves the permalink for an attachment.
• remove_filter()Removes a callback function from a filter hook.
• str_starts_with()Polyfill for `str_starts_with()` function added in PHP 8.0.
• get_image_send_to_editor()Retrieves the image HTML to send to the editor.
• wp_attachment_is()Verifies an attachment is of a given type.

Source

View on Trac ↗View on GitHub ↗

3347function wp_ajax_send_attachment_to_editor() {3348	check_ajax_referer( 'media-send-to-editor', 'nonce' );3349 3350	$attachment = wp_unslash( $_POST['attachment'] );3351 3352	$id = (int) $attachment['id'];3353 3354	$post = get_post( $id );3355	if ( ! $post ) {3356		wp_send_json_error();3357	}3358 3359	if ( 'attachment' !== $post->post_type ) {3360		wp_send_json_error();3361	}3362 3363	if ( current_user_can( 'edit_post', $id ) ) {3364		// If this attachment is unattached, attach it. Primarily a back compat thing.3365		$insert_into_post_id = (int) $_POST['post_id'];3366 3367		if ( 0 === $post->post_parent && $insert_into_post_id ) {3368			wp_update_post(3369				array(3370					'ID'          => $id,3371					'post_parent' => $insert_into_post_id,3372				)3373			);3374		}3375	}3376 3377	$url = empty( $attachment['url'] ) ? '' : $attachment['url'];3378	$rel = ( str_contains( $url, 'attachment_id' ) || get_attachment_link( $id ) === $url );3379 3380	remove_filter( 'media_send_to_editor', 'image_media_send_to_editor' );3381 3382	if ( str_starts_with( $post->post_mime_type, 'image' ) ) {3383		$align = $attachment['align'] ?? 'none';3384		$size  = $attachment['image-size'] ?? 'medium';3385		$alt   = $attachment['image_alt'] ?? '';3386 3387		// No whitespace-only captions.3388		$caption = $attachment['post_excerpt'] ?? '';3389		if ( '' === trim( $caption ) ) {3390			$caption = '';3391		}3392 3393		$title = ''; // We no longer insert title tags into <img> tags, as they are redundant.3394		$html  = get_image_send_to_editor( $id, $caption, $title, $align, $url, $rel, $size, $alt );3395	} elseif ( wp_attachment_is( 'video', $post ) || wp_attachment_is( 'audio', $post ) ) {3396		$html = stripslashes_deep( $_POST['html'] );3397	} else {3398		$html = $attachment['post_title'] ?? '';3399		$rel  = $rel ? ' rel="attachment wp-att-' . $id . '"' : ''; // Hard-coded string, $id is already sanitized.3400 3401		if ( ! empty( $url ) ) {3402			$html = '<a href="' . esc_url( $url ) . '"' . $rel . '>' . $html . '</a>';3403		}3404	}3405 3406	/** This filter is documented in wp-admin/includes/media.php */3407	$html = apply_filters( 'media_send_to_editor', $html, $id, $attachment );3408 3409	wp_send_json_success( $html );3410}

History

Introduced in 3.5.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.1.0 tag, from src/wp-admin/includes/ajax-actions.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.