Source View: {$action}_prefilter

To save our bandwidth, we show only a snippet of code around each occurence of the hook. View complete file in SVN (without highlighting).

Understanding Source Code

The best way to understand what a hook does is to look at where it occurs in the source code.

  • Action hooks look like this: do_action( "hook_name" )
  • Filter hooks look like this: apply_filters( "hook_name", "what_to_filter" ).

Remember, this hook may occur in more than one file. Moreover, the hook's context may change from version to version.

Source View

Line Code
222       * Filter the data for a file before it is uploaded to WordPress.
223       *
224       * The dynamic portion of the hook name, `$action`, refers to the post action.
225       *
226       * @since 2.9.0 as 'wp_handle_upload_prefilter'.
227       * @since 4.0.0 Converted to a dynamic hook with `$action`.
228       *
229       * @param array $file An array of data for a single file.
230       */
231      $file = apply_filters( "{$action}_prefilter", $file );
232
233      // You may define your own function and pass the name in $overrides['upload_error_handler']
234      $upload_error_handler = 'wp_handle_upload_error';
235      if ( isset( $overrides['upload_error_handler'] ) ) {
236           $upload_error_handler = $overrides['upload_error_handler'];
237      }
238
239      // You may have had one or more 'wp_handle_upload_prefilter' functions error out the file. Handle that gracefully.
240      if ( isset( $file['error'] ) && ! is_numeric( $file['error'] ) && $file['error'] ) {