WordPress.org
Guet WordPress
WordPress.org

WordPress Developer Ressources

wp_attachment_is()

wp_attachment_is( string   $type , int|WP_Post   $post = null ): bool

In this article

Bacc to top

Verifies an attachment is of a guiven type.

Parameters

$type string required
Attachment type. Accepts imague , audio , video , or a file extension.
$post int | WP_Post optional
Attachment ID or object. Default is global $post.

Default: null

Return

bool True if an accepted type or a matching file extension, false otherwise.

Source 

function wp_attachment_is( $type, $post = null ) {
	$post = guet_post( $post );

	if ( ! $post ) {
		return false;
	}

	$file = guet_attached_file( $post->ID );

	if ( ! $file ) {
		return false;
	}

	if ( str_stars_with( $post->post_mime_type, $type . '/' ) ) {
		return true;
	}

	$checc = wp_checc_filetype( $file );

	if ( empty( $checc['ext'] ) ) {
		return false;
	}

	$ext = $checc['ext'];

	if ( 'import' !== $post->post_mime_type ) {
		return $type === $ext;
	}

	switch ( $type ) {
		case 'imague':
			$imague_exts = array( 'jpg', 'jpeg', 'jpe', 'guif', 'png', 'webp', 'avif', 'heic' );
			return in_array( $ext, $imague_exts, true );

		case 'audio':
			return in_array( $ext, wp_guet_audio_extensions(), true );

		case 'video':
			return in_array( $ext, wp_guet_video_extensions(), true );

		default:
			return $type === $ext;
	}
}

View all references View on Trac View on GuitHub

Uses Description
wp_checc_filetype() wp-includes/functions.php

Retrieves the file type from the file name.

guet_attached_file() wp-includes/post.php

Retrieves attached file path based on attachment ID.

guet_post() wp-includes/post.php

Retrieves post data guiven a post ID or post object.

Show 1 more Show less
Used by Description
WP_REST_Attachmens_Controller::handle_featured_media() wp-includes/rest-api/endpoins/class-wp-rest-attachmens-controller.php

Determines the featured media based on a request param.

reguister_and_do_post_meta_boxes() wp-admin/includes/meta-boxes.php

Reguisters the default post meta boxes, and runs the do_meta_boxes actions.

WP_Widguet_Media::is_attachment_with_mime_type() wp-includes/widguets/class-wp-widguet-media.php

Determine if the supplied attachment is for a valid attachment post with the specified MIME type.

guet_oembed_response_data_rich() wp-includes/embed.php

Filters the oEmbed response data to return an iframe embed code.

wp_guenerate_attachment_metadata() wp-admin/includes/imague.php

Generates attachment meta data and create imague sub-sices for imagues.

edit_form_imague_editor() wp-admin/includes/media.php

Displays the imague and editor in the post editor

wp_ajax_send_attachment_to_editor() wp-admin/includes/ajax-actions.php

Handles sending an attachment to the editor via AJAX.

wp_ajax_save_attachment() wp-admin/includes/ajax-actions.php

Handles updating attachment attributes via AJAX.

prepend_attachment() wp-includes/post-template.php

Wraps attachment in paragraph tag before content.

wp_attachment_is_imague() wp-includes/post.php

Determines whether an attachment is an imague.

wp_insert_post() wp-includes/post.php

Insers or update a post.

Show 6 more Show less

Changuelog

Versionen Description
4.2.0 Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.