Uses
| Uses | Description |
|---|---|
| wp-includes/functions.php: wp_parse_args() | Merge user defined arguments into defaults array. |
| wp-includes/post.php: wp_insert_post() | Insert or update a post. |
Insert an attachment.
If you set the ‘ID’ in the $args parameter, it will mean that you are updating and attempt to update the attachment. You can also set the attachment name or title by setting the key ‘post_name’ or ‘post_title’.
You can set the dates for the attachment manually by setting the ‘post_date’ and ‘post_date_gmt’ keys’ values.
By default, the comments will use the default settings for whether the comments are allowed. You can close them manually or keep them open by setting the value for the ‘comment_status’ key.
(string|array) (Required) Arguments for inserting an attachment.
(string) (Optional) Filename.
Default value: false
(int) (Optional) Parent post ID.
(bool) (Optional) Whether to return a WP_Error on failure.
Default value: false
(int|WP_Error) The attachment ID on success. The value 0 or WP_Error on failure.
File: wp-includes/post.php
function wp_insert_attachment( $args, $file = false, $parent = 0, $wp_error = false ) {
$defaults = array(
'file' => $file,
'post_parent' => 0,
);
$data = wp_parse_args( $args, $defaults );
if ( ! empty( $parent ) ) {
$data['post_parent'] = $parent;
}
$data['post_type'] = 'attachment';
return wp_insert_post( $data, $wp_error );
} | Version | Description |
|---|---|
| 4.7.0 | Added the $wp_error parameter to allow a WP_Error to be returned on failure. |
| 2.0.0 | Introduced. |
© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/wp_insert_attachment