User Contributed Notes

1. Skip to note 7 content

   
   tgiokdi
   
   
   9 years ago
   

   You must log in to vote on the helpfulness of this noteVote results for this note: 5You must log in to vote on the helpfulness of this note

   A word of caution, the “description” that’s the third value for this function is actually the attachment’s “TITLE” and not it’s “DESCRIPTION”.

   There is no support for adding the actual description with media_sideload_image.

2. Skip to note 8 content

   
   Codex
   
   
   11 years ago
   

   You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

   Default Usage

   $url     = "<a href="https://wordpress.org/about/images/logos/wordpress-logo-stacked-rgb.png&quot" rel="nofollow ugc">https://wordpress.org/about/images/logos/wordpress-logo-stacked-rgb.png"</a>;;
   $post_id = 1;
   $desc    = "The WordPress Logo";
   
   $image = media_sideload_image( $url, $post_id, $desc );

3. Skip to note 9 content

   
   andreas83b
   
   
   4 years ago
   

   You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

   First i was very happy about this function, since it fits exactly my use case.

   After looking a bit deeper, i noticed that the allowed extension check will block my remote resource.
   In my case b-4bd4-b383-f9021e0ba3d2.jpg1

   since remote images often don’t have a extension at all i don’t see any value in this extension check, while checking mime types are a better approach in my opinion.

4. Skip to note 10 content

   
   Mark Parnell
   
   
   3 years ago
   

   You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

   Despite its name, this function can be used to load any type of file to the media library as long as you override the accepted extensions first. For example you can import audio files by adding mp3 to the list of extensions:

   add_filter( 'image_sideload_extensions', function ( $accepted_extensions ) {
   	$accepted_extensions[] = 'mp3';
   	return $accepted_extensions;
   } );

   Note however that you’ll probably want to set the $return_type parameter to either url or id, as an image tag pointing to something other than an image won’t be very useful.

5. Skip to note 11 content

   
   Koen Reus
   
   
   2 years ago
   

   You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

   media_sideload_image() checks the file extension as a basic security measure, but in a lot of cases external image URLs coming from APIs for example do not actually have one, while still serving a perfectly valid image.

   If you trust the source of the images, you can bypass the check by appending #.jpg to the url like so:

   $wp_media_id = media_sideload_image( $url . '#.jpg', 0, null, 'id' );

6. Skip to note 12 content

   
   MakeWebBetter
   
   
   6 years ago
   

   You must log in to vote on the helpfulness of this noteVote results for this note: -3You must log in to vote on the helpfulness of this note

   Find ID of attachment from src by using this function

   function wpdocs_fetch_attachment_post_id_from_srcs( $image_src ) {
     global $wpdb;
     $query = "SELECT ID FROM {$wpdb->posts} WHERE guid=%s";
     $id = $wpdb->prepare( $query, $image_src );
     return $id;
   }
   
   // By passing fourth parameter 'src' you will get URL
   $src = media_sideload_image( $url, $item_id, $desc, 'src' );
   
   wpdocs_fetch_attachment_post_id_from_srcs( $src );

   • From WP 4.8 it’s possible to have directly the ‘id’ (4th param): $id = media_sideload_image( $url, $item_id, $desc, 'id' );

     eventualo 6 years ago