wp_handle_upload_prefilter хук-фильтрWP 2.9.0

Filters the data for a file before it is uploaded to WordPress.

Это один из вариантов динамического хука (action)_prefilter

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

add_filter( 'wp_handle_upload_prefilter', 'wp_kama_handle_upload_prefilter' );

/**
 * Function for `wp_handle_upload_prefilter` filter-hook.
 * 
 * @param array $file Reference to a single element from `$_FILES`.
 *
 * @return array
 */
function wp_kama_handle_upload_prefilter( $file ){

	// filter...
	return $file;
}
$file(массив)

Reference to a single element from $_FILES.

  • name(строка)
    The original name of the file on the client machine.

  • type(строка)
    The mime type of the file, if the browser provided this information.

  • tmp_name(строка)
    The temporary filename of the file in which the uploaded file was stored on the server.

  • size(int)
    The size, in bytes, of the uploaded file.

  • error(int)
    The error code associated with this file upload.

Список изменений

С версии 2.9.0 Введена.
С версии 2.9.0 as wp_handle_upload_prefilter.
С версии 4.0.0 Converted to a dynamic hook with $action.

Где вызывается хук

_wp_handle_upload()
wp_handle_upload_prefilter
wp-admin/includes/file.php 833
$file = apply_filters( "{$action}_prefilter", $file );

Где используется хук в WordPress

wp-admin/includes/ms-admin-filters.php 11
add_filter( 'wp_handle_upload_prefilter', 'check_upload_size' );