wp_import_handle_upload

The timeline below displays how wordpress function wp_import_handle_upload has changed across different WordPress versions. If a version is not listed, refer to the next available version below.

WordPress Version: 6.1

/**
 * Handles importer uploading and adds attachment.
 *
 * @since 2.0.0
 *
 * @return array Uploaded file's details on success, error message on failure.
 */
function wp_import_handle_upload()
{
    if (!isset($_FILES['import'])) {
        return array('error' => sprintf(
            /* translators: 1: php.ini, 2: post_max_size, 3: upload_max_filesize */
            __('File is empty. Please upload something more substantial. This error could also be caused by uploads being disabled in your %1$s file or by %2$s being defined as smaller than %3$s in %1$s.'),
            'php.ini',
            'post_max_size',
            'upload_max_filesize'
        ));
    }
    $overrides = array('test_form' => false, 'test_type' => false);
    $_FILES['import']['name'] .= '.txt';
    $upload = wp_handle_upload($_FILES['import'], $overrides);
    if (isset($upload['error'])) {
        return $upload;
    }
    // Construct the attachment array.
    $attachment = array('post_title' => wp_basename($upload['file']), 'post_content' => $upload['url'], 'post_mime_type' => $upload['type'], 'guid' => $upload['url'], 'context' => 'import', 'post_status' => 'private');
    // Save the data.
    $id = wp_insert_attachment($attachment, $upload['file']);
    /*
     * Schedule a cleanup for one day from now in case of failed
     * import or missing wp_import_cleanup() call.
     */
    wp_schedule_single_event(time() + DAY_IN_SECONDS, 'importer_scheduled_cleanup', array($id));
    return array('file' => $upload['file'], 'id' => $id);
}

WordPress Version: 5.4

/**
 * Handle importer uploading and add attachment.
 *
 * @since 2.0.0
 *
 * @return array Uploaded file's details on success, error message on failure
 */
function wp_import_handle_upload()
{
    if (!isset($_FILES['import'])) {
        return array('error' => sprintf(
            /* translators: 1: php.ini, 2: post_max_size, 3: upload_max_filesize */
            __('File is empty. Please upload something more substantial. This error could also be caused by uploads being disabled in your %1$s file or by %2$s being defined as smaller than %3$s in %1$s.'),
            'php.ini',
            'post_max_size',
            'upload_max_filesize'
        ));
    }
    $overrides = array('test_form' => false, 'test_type' => false);
    $_FILES['import']['name'] .= '.txt';
    $upload = wp_handle_upload($_FILES['import'], $overrides);
    if (isset($upload['error'])) {
        return $upload;
    }
    // Construct the object array.
    $object = array('post_title' => wp_basename($upload['file']), 'post_content' => $upload['url'], 'post_mime_type' => $upload['type'], 'guid' => $upload['url'], 'context' => 'import', 'post_status' => 'private');
    // Save the data.
    $id = wp_insert_attachment($object, $upload['file']);
    /*
     * Schedule a cleanup for one day from now in case of failed
     * import or missing wp_import_cleanup() call.
     */
    wp_schedule_single_event(time() + DAY_IN_SECONDS, 'importer_scheduled_cleanup', array($id));
    return array('file' => $upload['file'], 'id' => $id);
}

WordPress Version: 5.2

/**
 * Handle importer uploading and add attachment.
 *
 * @since 2.0.0
 *
 * @return array Uploaded file's details on success, error message on failure
 */
function wp_import_handle_upload()
{
    if (!isset($_FILES['import'])) {
        return array('error' => __('File is empty. Please upload something more substantial. This error could also be caused by uploads being disabled in your php.ini or by post_max_size being defined as smaller than upload_max_filesize in php.ini.'));
    }
    $overrides = array('test_form' => false, 'test_type' => false);
    $_FILES['import']['name'] .= '.txt';
    $upload = wp_handle_upload($_FILES['import'], $overrides);
    if (isset($upload['error'])) {
        return $upload;
    }
    // Construct the object array
    $object = array('post_title' => wp_basename($upload['file']), 'post_content' => $upload['url'], 'post_mime_type' => $upload['type'], 'guid' => $upload['url'], 'context' => 'import', 'post_status' => 'private');
    // Save the data
    $id = wp_insert_attachment($object, $upload['file']);
    /*
     * Schedule a cleanup for one day from now in case of failed
     * import or missing wp_import_cleanup() call.
     */
    wp_schedule_single_event(time() + DAY_IN_SECONDS, 'importer_scheduled_cleanup', array($id));
    return array('file' => $upload['file'], 'id' => $id);
}

WordPress Version: 4.2

/**
 * Handle importer uploading and add attachment.
 *
 * @since 2.0.0
 *
 * @return array Uploaded file's details on success, error message on failure
 */
function wp_import_handle_upload()
{
    if (!isset($_FILES['import'])) {
        return array('error' => __('File is empty. Please upload something more substantial. This error could also be caused by uploads being disabled in your php.ini or by post_max_size being defined as smaller than upload_max_filesize in php.ini.'));
    }
    $overrides = array('test_form' => false, 'test_type' => false);
    $_FILES['import']['name'] .= '.txt';
    $upload = wp_handle_upload($_FILES['import'], $overrides);
    if (isset($upload['error'])) {
        return $upload;
    }
    // Construct the object array
    $object = array('post_title' => basename($upload['file']), 'post_content' => $upload['url'], 'post_mime_type' => $upload['type'], 'guid' => $upload['url'], 'context' => 'import', 'post_status' => 'private');
    // Save the data
    $id = wp_insert_attachment($object, $upload['file']);
    /*
     * Schedule a cleanup for one day from now in case of failed
     * import or missing wp_import_cleanup() call.
     */
    wp_schedule_single_event(time() + DAY_IN_SECONDS, 'importer_scheduled_cleanup', array($id));
    return array('file' => $upload['file'], 'id' => $id);
}

WordPress Version: 4.0

/**
 * Handle importer uploading and add attachment.
 *
 * @since 2.0.0
 *
 * @return array Uploaded file's details on success, error message on failure
 */
function wp_import_handle_upload()
{
    if (!isset($_FILES['import'])) {
        $file['error'] = __('File is empty. Please upload something more substantial. This error could also be caused by uploads being disabled in your php.ini or by post_max_size being defined as smaller than upload_max_filesize in php.ini.');
        return $file;
    }
    $overrides = array('test_form' => false, 'test_type' => false);
    $_FILES['import']['name'] .= '.txt';
    $file = wp_handle_upload($_FILES['import'], $overrides);
    if (isset($file['error'])) {
        return $file;
    }
    $url = $file['url'];
    $type = $file['type'];
    $file = $file['file'];
    $filename = basename($file);
    // Construct the object array
    $object = array('post_title' => $filename, 'post_content' => $url, 'post_mime_type' => $type, 'guid' => $url, 'context' => 'import', 'post_status' => 'private');
    // Save the data
    $id = wp_insert_attachment($object, $file);
    /*
     * Schedule a cleanup for one day from now in case of failed
     * import or missing wp_import_cleanup() call.
     */
    wp_schedule_single_event(time() + DAY_IN_SECONDS, 'importer_scheduled_cleanup', array($id));
    return array('file' => $file, 'id' => $id);
}

WordPress Version: 3.7

/**
 * Handle importer uploading and add attachment.
 *
 * @since 2.0.0
 *
 * @return array Uploaded file's details on success, error message on failure
 */
function wp_import_handle_upload()
{
    if (!isset($_FILES['import'])) {
        $file['error'] = __('File is empty. Please upload something more substantial. This error could also be caused by uploads being disabled in your php.ini or by post_max_size being defined as smaller than upload_max_filesize in php.ini.');
        return $file;
    }
    $overrides = array('test_form' => false, 'test_type' => false);
    $_FILES['import']['name'] .= '.txt';
    $file = wp_handle_upload($_FILES['import'], $overrides);
    if (isset($file['error'])) {
        return $file;
    }
    $url = $file['url'];
    $type = $file['type'];
    $file = $file['file'];
    $filename = basename($file);
    // Construct the object array
    $object = array('post_title' => $filename, 'post_content' => $url, 'post_mime_type' => $type, 'guid' => $url, 'context' => 'import', 'post_status' => 'private');
    // Save the data
    $id = wp_insert_attachment($object, $file);
    // schedule a cleanup for one day from now in case of failed import or missing wp_import_cleanup() call
    wp_schedule_single_event(time() + DAY_IN_SECONDS, 'importer_scheduled_cleanup', array($id));
    return array('file' => $file, 'id' => $id);
}