WordPress как на ладони
Наставник Трепачёв Д.П., phphtml.net wordpress jino

media_handle_upload() WP 2.5

Загружает переданный в форме файл в папку загрузок WordPress и создает запись о загруженном файле в базе данных (добавляет файл в медиатеку WP).

Работает c глобальной переменной $_FILES, ей нужно указать индекс массива $_FILES, который содержит данные о загружаемом файле и функция сама загрузит файл в папку загрузок WordPress и создаст запись о вложении в таблице wp_posts в базе данных. Во втором параметре нужно указать id записи (поста), к которой загруженный медиафайл должен быть прикреплен.

Работает на основе: wp_handle_upload(), wp_insert_attachment()

Хуков нет.

Возвращает

Число - ID созданного вложения или объект WP_error, если загрузка не удалась.

Использование

media_handle_upload( $file_id, $post_id, $post_data, $overrides );
$file_id(строка) (обязательный)
Индекс элемента массива $_FILES, который содержит данные о принятом файле (название, тип, размер, временное расположение).
$post_id(число) (обязательный)
ID поста, к которому будет прикреплен медиафайл. Если не нужно, чтобы файл был прикреплен к посту, то укажите в параметре 0.
$post_data(массив)
Позволяет перезаписать данные создаваемого вложения. Тут указываются данные которые будут записаны в таблицу wp_posts для создаваемого вложения: post_parent, post_title, post_excerpt и т.д.
По умолчанию: array() (данные по умолчанию)
$overrides(массив)
Позволяет изменить поведение функции wp_handle_upload(), на основе которой работает текущая функция.
По умолчанию: array( 'test_form' => false )

Примеры

#1 Форма загрузки файла и его сохранение

Для начала приведем пример кода формы с полем загрузки файла. Предположительно код установлен в лицевой части сайта:

<form id="featured_upload" method="post" action="#" enctype="multipart/form-data">
	<input type="file" name="my_image_upload" id="my_image_upload"  multiple="false" />
	<input type="hidden" name="post_id" id="post_id" value="55" />
	<?php wp_nonce_field( 'my_image_upload', 'my_image_upload_nonce' ); ?>
	<input id="submit_my_image_upload" name="submit_my_image_upload" type="submit" value="Upload" />
</form>

Теперь, код для сохранения файла вложения:

<?php
// Проверим защиту nonce и что пользователь может редактировать этот пост.
if ( 
	isset( $_POST['my_image_upload_nonce'], $_POST['post_id'] ) 
	&& wp_verify_nonce( $_POST['my_image_upload_nonce'], 'my_image_upload' )
	&& current_user_can( 'edit_post', $_POST['post_id'] )
) {
	// все ок! Продолжаем.
	// Эти файлы должны быть подключены в лицевой части (фронт-энде).
	require_once( ABSPATH . 'wp-admin/includes/image.php' );
	require_once( ABSPATH . 'wp-admin/includes/file.php' );
	require_once( ABSPATH . 'wp-admin/includes/media.php' );

	// Позволим WordPress перехватить загрузку.
	// не забываем указать атрибут name поля input - 'my_image_upload'
	$attachment_id = media_handle_upload( 'my_image_upload', $_POST['post_id'] );

	if ( is_wp_error( $attachment_id ) ) {
		echo "Ошибка загрузки медиафайла.";
	} else {
		echo "Медиафайл был успешно загружен!";
	}

} else {
	echo "Проверка не пройдена. Невозможно загрузить файл.";
}
?>

#2 Создание множественной загрузки файлов в WordPress

WordPress позволяет загружать сразу несколько файлов даже с возможностью drag-and-drop, в Админ-панели. Если вам нужно добавить такую возможность на внешнюю часть сайта, то сделать это не так сложно. Для этого допустим, создадим шаблон страницы (my-upload-page.php) и разместим на нем форму:

<form action="" method="post" enctype="multipart/form-data" name="front_end_upload" >
	<label> Добавьте все файлы здесь: <input type="file" name="kv_multiple_attachments[]" multiple="multiple" > </label>
	<input type="submit" name="Загрузить" >
</form>

Эта форма отправляет данные на свою же страницу (action=""), поэтому в коде этого же файла (my-upload-page.php) шаблона нужно разместить обработчик, см. пример выше.

Код media handle upload: wp-admin/includes/media.php WP 4.8

<?php
function media_handle_upload($file_id, $post_id, $post_data = array(), $overrides = array( 'test_form' => false )) {

	$time = current_time('mysql');
	if ( $post = get_post($post_id) ) {
		if ( substr( $post->post_date, 0, 4 ) > 0 )
			$time = $post->post_date;
	}

	$file = wp_handle_upload($_FILES[$file_id], $overrides, $time);

	if ( isset($file['error']) )
		return new WP_Error( 'upload_error', $file['error'] );

	$name = $_FILES[$file_id]['name'];
	$ext  = pathinfo( $name, PATHINFO_EXTENSION );
	$name = wp_basename( $name, ".$ext" );

	$url = $file['url'];
	$type = $file['type'];
	$file = $file['file'];
	$title = sanitize_text_field( $name );
	$content = '';
	$excerpt = '';

	if ( preg_match( '#^audio#', $type ) ) {
		$meta = wp_read_audio_metadata( $file );

		if ( ! empty( $meta['title'] ) ) {
			$title = $meta['title'];
		}

		if ( ! empty( $title ) ) {

			if ( ! empty( $meta['album'] ) && ! empty( $meta['artist'] ) ) {
				/* translators: 1: audio track title, 2: album title, 3: artist name */
				$content .= sprintf( __( '"%1$s" from %2$s by %3$s.' ), $title, $meta['album'], $meta['artist'] );
			} elseif ( ! empty( $meta['album'] ) ) {
				/* translators: 1: audio track title, 2: album title */
				$content .= sprintf( __( '"%1$s" from %2$s.' ), $title, $meta['album'] );
			} elseif ( ! empty( $meta['artist'] ) ) {
				/* translators: 1: audio track title, 2: artist name */
				$content .= sprintf( __( '"%1$s" by %2$s.' ), $title, $meta['artist'] );
			} else {
				/* translators: 1: audio track title */
				$content .= sprintf( __( '"%s".' ), $title );
			}

		} elseif ( ! empty( $meta['album'] ) ) {

			if ( ! empty( $meta['artist'] ) ) {
				/* translators: 1: audio album title, 2: artist name */
				$content .= sprintf( __( '%1$s by %2$s.' ), $meta['album'], $meta['artist'] );
			} else {
				$content .= $meta['album'] . '.';
			}

		} elseif ( ! empty( $meta['artist'] ) ) {

			$content .= $meta['artist'] . '.';

		}

		if ( ! empty( $meta['year'] ) ) {
			/* translators: Audio file track information. 1: Year of audio track release */
			$content .= ' ' . sprintf( __( 'Released: %d.' ), $meta['year'] );
		}

		if ( ! empty( $meta['track_number'] ) ) {
			$track_number = explode( '/', $meta['track_number'] );
			if ( isset( $track_number[1] ) ) {
				/* translators: Audio file track information. 1: Audio track number, 2: Total audio tracks */
				$content .= ' ' . sprintf( __( 'Track %1$s of %2$s.' ), number_format_i18n( $track_number[0] ), number_format_i18n( $track_number[1] ) );
			} else {
				/* translators: Audio file track information. 1: Audio track number */
				$content .= ' ' . sprintf( __( 'Track %1$s.' ), number_format_i18n( $track_number[0] ) );
			}
		}

		if ( ! empty( $meta['genre'] ) ) {
			/* translators: Audio file genre information. 1: Audio genre name */
			$content .= ' ' . sprintf( __( 'Genre: %s.' ), $meta['genre'] );
		}

	// Use image exif/iptc data for title and caption defaults if possible.
	} elseif ( 0 === strpos( $type, 'image/' ) && $image_meta = @wp_read_image_metadata( $file ) ) {
		if ( trim( $image_meta['title'] ) && ! is_numeric( sanitize_title( $image_meta['title'] ) ) ) {
			$title = $image_meta['title'];
		}

		if ( trim( $image_meta['caption'] ) ) {
			$excerpt = $image_meta['caption'];
		}
	}

	// Construct the attachment array
	$attachment = array_merge( array(
		'post_mime_type' => $type,
		'guid' => $url,
		'post_parent' => $post_id,
		'post_title' => $title,
		'post_content' => $content,
		'post_excerpt' => $excerpt,
	), $post_data );

	// This should never be set as it would then overwrite an existing attachment.
	unset( $attachment['ID'] );

	// Save the data
	$id = wp_insert_attachment($attachment, $file, $post_id);
	if ( !is_wp_error($id) ) {
		wp_update_attachment_metadata( $id, wp_generate_attachment_metadata( $id, $file ) );
	}

	return $id;

}

Cвязанные функции

Из метки: upload (файловая система file загрузка)

Еще из раздела: Загрузка (upload)

media_handle_upload 15 комментариев
Полезные 2 Вопросы 2 Все
  • Виктор

    Здравствуйте! Подскажите пожалуйста с загрузкой картинки на новую запись он же пост.
    Тоесть. У меня на сайте есть форма создания записи-поста гостями (не зарегистрированными пользователями)А вот пытаюсь прикрепить данную функцию к форме выводит ощибку загрузки файла.
    В чем может быть моя ощибка при прикручивании данной функции?

    Ответить2.6 года назад #
    • Kama4457

      Так не скажешь сразу, там нужно разбираться. media_handle_upload() не очень удобная функция, она сама обрабатывает массив $_FILES - это не удобно. Используйте её аналог media_handle_sideload() в неё можно передавать данные, т.е. сначала обработать самостоятельно данные $_FILES, а затем передать их - так понятнее и удобнее.

      Ответить2.6 года назад #
      • Виктор

        Может подскажете на примере?
        Вот два коротеньких файла handler.php (файл обработчик), м сама форма page-add.php
        ОБРАБОТЧИК

        <?php
        /* Define these, So that WP functions work inside this file */
        define('WP_USE_THEMES', false);
        require( $_SERVER['DOCUMENT_ROOT'] .'/wp-blog-header.php');
        ?>
        <?php
        if(isset($_POST['send']) == '1') {
         $post_title = $_POST['title'];
         $post_category = $_POST['cat'];
         $post_content = $_POST['description'];
        
         $new_post = array(
         'ID' => '',
         'post_author' => $user->ID,
         'post_category' => array($post_category),
         'post_content' => $post_content,
         'post_title' => $post_title,
         'post_status' => 'publish'
         );
        
         $post_id = wp_insert_post($new_post);
        
         // This will redirect you to the newly created post
         $post = get_post($post_id);
         wp_redirect($post->guid);
        }
        ?>

        И ФОРМА

        <?php /* Начало формы*/ ?>
        <meta charset="utf-8" />
        
        <form method="post" action="<?php bloginfo('template_url'); ?>/handler.php" class="form-horizontal">
        <fieldset>
        
        <!-- Form Name -->
        <legend>Добавить объявление</legend>
        
        <!-- Text input-->
        <div class="form-group">
         <label class="col-md-4 control-label" for="title">Заголовок</label>
         <div class="text-my">
         <input id="title" name="title" type="text" placeholder="Введите заголовок" class="form-control input-md">
         <span class="help-block"></span>
         </div>
        </div>
        
        <!-- Select Basic -->
        <label class="col-md-4 control-label" for="cat">Категория</label>
        <div class="text-my">
        <?php wp_dropdown_categories('hide_empty=0&title_li=&name=cat&hierarchical=1&exclude=1'); ?>
        </div>
        
        <!-- Textarea -->
        <div class="form-group">
         <label class="col-md-4 control-label" for="description">Введите текст объявления</label>
         <div class="text-my">
         <textarea class="form-control" id="description" placeholder="Введите текст вашего объявления..." name="description"></textarea>
         </div>
        </div>
        
        <!-- Button -->
        <div class="form-group">
         <label class="col-md-4 control-label" for="send"></label>
         <div class="col-md-4">
         <button id="send" name="send" class="btn btn-primary">Отправить</button>
         </div>
        </div>
        
        </fieldset>
        </form>
        <?php /* Конец формы*/ ?>
        Ответить2.6 года назад #
        • Kama4457

          У вас тут вообще нет поля загрузки файла. вот это http://htmlbook.ru/samhtml5/formy/zagruzka-failov в форму добавьте, потом обработайте с помощью вышеупомянутой функции.

          Ответить2.6 года назад #
          • Виктор

            Да, это чистая форма без добавления вышеупомянутой функции.
            Я пытался и так и эдак прикрутить её, на чистой страницу всё работает, все грузит и библиотеку отправляет.
            Не могу только разобраться как прикрутить её к форме так, чтобы картинка шла в new_post....
            Помогите пожалуйста разобраться...

            Ответить2.6 года назад #
            • Kama4457

              Я не понимаю, что нужно и что конкретно у вас не получается, а что получается...

              Ответить2.6 года назад #
              • Виктор

                Мне нужна ваша помощь в "прикрутке функции загрузки картинки -----> к моей форме создания записи с фронтэнда" так что бы при создании поста гостем можно было и картинку загрузить
                Так как форма создания поста с фронэнда уже функционирует, осталось прикрутить загрузку файлов к форме, но у меня не выходит. Поэтому прошу вашей помощи help help help help help help

                Ответить2.6 года назад #
  • Виктор

    Может кому пригодится)
    Форма обработчик.

    <?php
    /* Define these, So that WP functions work inside this file */
    define('WP_USE_THEMES', false);
    require( $_SERVER['DOCUMENT_ROOT'] .'/wp-blog-header.php');
    ?>
    <?php
    if(isset($_POST['send']) == '1') {
     $post_title = $_POST['title'];
     $post_category = $_POST['cat'];
     $post_content = $_POST['description'];
     $post_goroda = $_POST['goroda'];
    
     $new_post = array(
     'ID' => '',
     'post_author' => $user->ID,
     'post_category' => array($post_category),
     'post_content' => $post_content,
     'post_title' => $post_title,
     'tax_input' => array('goroda' => $post_goroda),
     'post_status' => 'publish',
     );
     $post_id = wp_insert_post($new_post);
    
     // This will redirect you to the newly created post
     $post = get_post($post_id);
     wp_redirect($post->guid);
    }
    
    ?>

    goroda - это зарегистрированная таксономия для выбора и городов (например).
    Прежде чем использовать

    'tax_input' => array('goroda' => $post_goroda),

    нужно зарегестрировать эту таксономию)

    Ответить2.6 года назад #
  • Otshelnik-fm176 cайт: across-ocean.otshelnik-fm.ru

    media_sideload_image - не нашел у вас этой функции. Скачивает с произвольного адреса картинку и прикрепляет ее к записи

    Ответить2.5 года назад #
    • Kama4457

      Добавил в очередь. Если вы с ней работаете сейчас, добавьте её плз. как угодно опишите, я потом доделаю. Можно даже просто примеры заполнить, уже хорошо. Спасибо. А вообще записал, что нужно описать...

      Ответить2.5 года назад #
  • Сергей

    нашел отличный пример, не плохо бы добавить
    http://www.kvcodes.com/2013/12/create-front-end-multiple-file-upload-wordpress/

    1
    Ответить2.4 года назад #
    • Kama4457

      Спасибо за ссылку, но что-то там код кривой какой-то. Вы его тестировали? Не решился его публиковать, а тестировать время нет. Дополнил статью частично.

      Ответить2.4 года назад #
      • Сергей

        Да, код сейчас стоит в плагине, притензий нет

        Ответить2.4 года назад #
  • Николай

    Делаю загрузку через javascriop скрипт
    xhr.open("POST","/wp-admin/async-upload.php",true);
    xhr.send(formData);

    Всё нормально работает. Но хотелось бы изменить каталог для загрузки.
    Как это сделать?

    Ответитьгод назад #
  • Изат

    Постоянно пишет Проверка не пройдена. Невозможно загрузить файл. как быть сижу под админом как убрать проверку??

    Ответить4 месяца назад #

Здравствуйте, !

Ваш комментарий