• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

「関数リファレンス/media handle sideload」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Function_Reference/media_handle_sideload 15:06, 31 January 2017 Jdorner 版を流し込み。)
 
(相違点なし)

2017年8月8日 (火) 00:04時点における最新版

このページ「関数リファレンス/media handle sideload」は未翻訳です。和訳や日本語情報を加筆してくださる協力者を求めています

Description

Handles a sideloaded file in the same way as an uploaded file is handled by media_handle_upload().

Parameters

$file_array
array) (必須) Array similar to a $_FILES upload array.
初期値: なし
$post_id
int) (必須) The post ID the media is associated with. Required, but can be set to 0, creating a media item that has no relationship to a post.
初期値: なし
$desc
string) (optional) Description of the sideloaded file.
初期値: null
$post_data
array) (optional) Allows you to overwrite some of the attachment.
初期値: null

Return Value

(int|object)
The ID of the attachment or a WP_Error on failure.

Examples

(from the media_handle_upload() function)

<?php 
	// Need to require these files
	if ( !function_exists('media_handle_upload') ) {
		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.wordpress.org/style/images/wp3-logo.png";
	$tmp = download_url( $url );
	if( is_wp_error( $tmp ) ){
		// download failed, handle error
	}
	$post_id = 1;
	$desc = "The WordPress Logo";
	$file_array = array();

	// Set variables for storage
	// fix file filename for query strings
	preg_match('/[^\?]+\.(jpg|jpe|jpeg|gif|png)/i', $url, $matches);
	$file_array['name'] = basename($matches[0]);
	$file_array['tmp_name'] = $tmp;

	// If error storing temporarily, unlink
	if ( is_wp_error( $tmp ) ) {
		@unlink($file_array['tmp_name']);
		$file_array['tmp_name'] = '';
	}

	// do the validation and storage stuff
	$id = media_handle_sideload( $file_array, $post_id, $desc );

	// If error storing permanently, unlink
	if ( is_wp_error($id) ) {
		@unlink($file_array['tmp_name']);
		return $id;
	}

	$src = wp_get_attachment_url( $id );
?>

Change Log

Since: 2.6.0

Source File

media_handle_sideload() is located in wp-admin/includes/media.php.

Resources

Related

アップロード関数: media_handle_upload() /en, media_handle_sideload() /en, wp_handle_upload(), wp_import_handle_upload() /en, wp_handle_sideload() /en, media_sideload_image() /en


添付ファイル関数: get_children(), get attached media(), the_attachment_link(), get_attachment_link(), wp_get_attachment_link(), wp_get_attachment_image(), wp_get_attachment_image_src(), wp_get_attachment_url(), wp_get_attachment_thumb_file(), wp_get_attachment_thumb_url(), is_attachment(), wp_get_attachment_metadata()



関数リファレンステンプレートタグ目次もご覧ください。


最新英語版: WordPress Codex » Function Reference/media_handle_sideload最新版との差分