Changeset 49845 for trunk/src/wp-admin/includes/file.php

Timestamp:

12/20/2020 04:13:23 PM (3 years ago)

Author:

johnbillion

Message:

Upload: Introduce the {$action}_overrides filter that allows the overrides parameter for file uploads and file sideloads to be filtered.

The dynamic portion of the hook name, $action, refers to the post action.

Props iandunn, jakub.tyrcha, nacin, wonderboymusic, Mte90, johnbillion

Fixes #16849

File:

• trunk/src/wp-admin/includes/file.php (modified) (2 diffs)

trunk/src/wp-admin/includes/file.php

@@ -726 +726 @@
  * @param string[]       $file      Reference to a single element of `$_FILES`.
  *                                  Call the function once for each uploaded file.
- * @param string[]|false $overrides An associative array of names => values
- *                                  to override default variables. Default false.
+ * @param array|false    $overrides {
+ *     An array of override parameters for this file, or boolean false if none are provided.
+ *
+ *     @type callable $upload_error_handler     Function to call when there is an error during the upload process.
+ *                                              @see wp_handle_upload_error().
+ *     @type callable $unique_filename_callback Function to call when determining a unique file name for the file.
+ *                                              @see wp_unique_filename().
+ *     @type string[] $upload_error_strings     The strings that describe the error indicated in
+ *                                              `$_FILES[{form field}]['error']`.
+ *     @type bool     $test_form                Whether to test that the `$_POST['action]` parameter is as expected.
+ *     @type bool     $test_size                Whether to test that the file size is greater than zero bytes.
+ *     @type bool     $test_type                Whether to test that the mime type of the file is as expected.
+ *     @type string[] $mimes                    Array of allowed mime types keyed by their file extension regex.
+ * }
  * @param string         $time      Time formatted in 'yyyy/mm'.
  * @param string         $action    Expected value for `$_POST['action']`.
@@ -746 +758 @@
      *
      * The dynamic portion of the hook name, `$action`, refers to the post action.
+     * Possible filter names include:
+     *
+     *  - `wp_handle_sideload_prefilter`
+     *  - `wp_handle_upload_prefilter`
      *
      * @since 2.9.0 as 'wp_handle_upload_prefilter'.
      * @since 4.0.0 Converted to a dynamic hook with `$action`.
      *
-     * @param string[] $file An array of data for a single file.
+     * @param string[] $file An array of data for the file. Reference to a single element of `$_FILES`.
      */
     $file = apply_filters( "{$action}_prefilter", $file );
+
+    /**
+     * Filters the override parameters for a file before it is uploaded to WordPress.
+     *
+     * The dynamic portion of the hook name, `$action`, refers to the post action.
+     * Possible filter names include:
+     *
+     *  - `wp_handle_sideload_overrides`
+     *  - `wp_handle_upload_overrides`
+     *
+     * @since 5.7.0
+     *
+     * @param array|false $overrides An array of override parameters for this file. Boolean false if none are
+     *                               provided. @see _wp_handle_upload().
+     * @param string[]    $file      An array of data for the file. Reference to a single element of `$_FILES`.
+     */
+    $overrides = apply_filters( "{$action}_overrides", $overrides, $file );
 
     // You may define your own function and pass the name in $overrides['upload_error_handler'].