wp_attachment_is_image()

💡 云策文档标注

概述

wp_attachment_is_image() 函数用于判断一个附件是否为图像。它是 wp_attachment_is() 的包装函数，简化了图像类型检查。

$id = 37;
if ( wp_attachment_is_image( $id ) ) {
    printf( 'Post %d is an image!', $id );
} else {
    printf( 'Post %d is not an image.', $id );
}

📄 原文内容

Determines whether an attachment is an image.

For more information on this and similar theme functions, check out the Conditional Tags article in the Theme Developer Handbook.

$postint|WP_Postoptional: Attachment ID or object. Default is global $post.

Default:null

bool Whether the attachment is an image.

function wp_attachment_is_image( $post = null ) {
	return wp_attachment_is( 'image', $post );
}

Uses	Description
wp_attachment_is()`wp-includes/post.php`	Verifies an attachment is of a given type.

Used by	Description
wp_get_original_image_path()`wp-includes/post.php`	Retrieves the path to an uploaded image file.
wp_get_original_image_url()`wp-includes/post.php`	Retrieves the URL to an original attachment image.
wp_get_missing_image_subsizes()`wp-admin/includes/image.php`	Compare the existing image sub-sizes (as saved in the attachment meta) to the currently registered image sub-sizes, and return the difference.
wp_ajax_media_create_image_subsizes()`wp-admin/includes/ajax-actions.php`	Handles creating missing image sub-sizes for just uploaded images via AJAX.
WP_REST_Attachments_Controller::prepare_item_for_response()`wp-includes/rest-api/endpoints/class-wp-rest-attachments-controller.php`	Prepares a single attachment output for response.
has_custom_logo()`wp-includes/general-template.php`	Determines whether the site has a custom logo.
get_oembed_response_data_rich()`wp-includes/embed.php`	Filters the oEmbed response data to return an iframe embed code.
edit_form_image_editor()`wp-admin/includes/media.php`	Displays the image and editor in the post editor
get_media_item()`wp-admin/includes/media.php`	Retrieves HTML form for modifying the image attachment.
get_attachment_icon_src()`wp-includes/deprecated.php`	Retrieve icon URL and Path.
image_downsize()`wp-includes/media.php`	Scales an image to fit a particular size (such as ‘thumb’ or ‘medium’).

Version	Description
4.2.0	Modified into wrapper for wp_attachment_is() and allowed WP_Post object to be passed.
2.1.0	Introduced.