media_handle_sideload() │ WP 2.6.0

Этот пример показывает как работать с функцией. Этот код загрузит картинку из внешнего источника, добавить её в медиатеку WordPress и прикрепит её к указанному посту:

// во фронтэнде нужны эти файлы
//require_once ABSPATH . 'wp-admin/includes/image.php';
//require_once ABSPATH . 'wp-admin/includes/file.php';
//require_once ABSPATH . 'wp-admin/includes/media.php';

$url     = 'http://s.w.org/style/images/wp-header-logo.png';
$post_id = 3061;
$desc    = "Логотип WordPress";

// Загрузим файл
$tmp = download_url( $url );

// Установим данные файла
$file_array = [
	'name'     => basename( $url ), // ex: wp-header-logo.png
	'tmp_name' => $tmp,
	'error'    => 0,
	'size'     => filesize($tmp),
];

// загружаем файл
$id = media_handle_sideload( $file_array, $post_id, $desc );

// если ошибка
if( is_wp_error( $id ) ) {
	@unlink($file_array['tmp_name']);
	return $id->get_error_messages();
}

// удалим временный файл
@unlink( $tmp );

// все, файл загружен и должен появится в админке в медиафайлах

// во фронтэнде нужны эти файлы
//require_once ABSPATH . 'wp-admin/includes/image.php';
//require_once ABSPATH . 'wp-admin/includes/file.php';
//require_once ABSPATH . 'wp-admin/includes/media.php';

$url = "http://s.w.org/style/images/wp-header-logo.png";
$desc = "Логотип WordPress";

// загрузим файл
$tmp = download_url( $url );

// корректируем умя файла в строках запроса.
$file_array = [
	'name'     => basename( $url ),
	'tmp_name' => $tmp
];

media_handle_sideload( $file_array, 0 );

// удалим временный файл
@unlink( $tmp );

Функция, которая будет загружать внешнюю картинку с указанного УРЛ, сохранять картинку в директорию uploads и прикреплять её к записи как миниатюру:

// инициализация функции
$post_id = 3061;
$file = 'http://s.w.org/style/images/wp-header-logo.png?1';
if( is_single( $post_id ) )
	my_sideload_image( $post_id, $file, $desc = 'Описание картинки' );

// код функции
function my_sideload_image( $post_id, $file, $desc = null ){
	global $debug; // определяется за пределами функции как true

	if( ! function_exists('media_handle_sideload') ) {
		require_once ABSPATH . 'wp-admin/includes/image.php';
		require_once ABSPATH . 'wp-admin/includes/file.php';
		require_once ABSPATH . 'wp-admin/includes/media.php';
	}

	// Загружаем файл во временную директорию
	$tmp = download_url( $file );

	// Устанавливаем переменные для размещения
	$file_array = [
		'name'     => basename( $file ),
		'tmp_name' => $tmp
	];

	// Удаляем временный файл, при ошибке
	if ( is_wp_error( $tmp ) ) {
		$file_array['tmp_name'] = '';
		if( $debug ) echo 'Ошибка нет временного файла! <br />';
	}

	// проверки при дебаге
	if( $debug ){
		echo 'File array: <br />';
		var_dump( $file_array );
		echo '<br /> Post id: ' . $post_id . '<br />';
	}

	$id = media_handle_sideload( $file_array, $post_id, $desc );

	// Проверяем работу функции
	if ( is_wp_error( $id ) ) {
		var_dump( $id->get_error_messages() );
	} else {
		update_post_meta( $post_id, '_thumbnail_id', $id );
	}

	// удалим временный файл
	@unlink( $tmp );
}