WordPress at a glance
function is not described

Custom_Image_Header::insert_attachment() WP 3.9.0

Insert an attachment and its metadata.

This is a method of the class: Custom_Image_Header

Hooks from the method
Return

Int. Attachment ID.

Usage

$Custom_Image_Header = new Custom_Image_Header();
$var = $Custom_Image_Header->insert_attachment( $object, $cropped );
$object(array) (required)
Attachment object.
$cropped(string) (required)
Cropped image URL.

Changelog

Since 3.9.0 Introduced.

Code of Custom Image Header::insert attachment: wp-admin/includes/class-custom-image-header.php WP 5.3.2

<?php
final public function insert_attachment( $object, $cropped ) {
	$parent_id = isset( $object['post_parent'] ) ? $object['post_parent'] : null;
	unset( $object['post_parent'] );

	$attachment_id = wp_insert_attachment( $object, $cropped );
	$metadata      = wp_generate_attachment_metadata( $attachment_id, $cropped );

	// If this is a crop, save the original attachment ID as metadata.
	if ( $parent_id ) {
		$metadata['attachment_parent'] = $parent_id;
	}

	/**
	 * Filters the header image attachment metadata.
	 *
	 * @since 3.9.0
	 *
	 * @see wp_generate_attachment_metadata()
	 *
	 * @param array $metadata Attachment metadata.
	 */
	$metadata = apply_filters( 'wp_header_image_attachment_metadata', $metadata );

	wp_update_attachment_metadata( $attachment_id, $metadata );

	return $attachment_id;
}