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
709       * Filters the data for a file before it is uploaded to WordPress.
710       *
711       * The dynamic portion of the hook name, `$action`, refers to the post action.
712       *
713       * @since 2.9.0 as 'wp_handle_upload_prefilter'.
714       * @since 4.0.0 Converted to a dynamic hook with `$action`.
715       *
716       * @param array $file An array of data for a single file.
717       */
718      $file = apply_filters( "{$action}_prefilter", $file );
719
720      // You may define your own function and pass the name in $overrides['upload_error_handler']
721      $upload_error_handler = 'wp_handle_upload_error';
722      if ( isset( $overrides['upload_error_handler'] ) ) {
723           $upload_error_handler = $overrides['upload_error_handler'];
724      }
725
726      // You may have had one or more 'wp_handle_upload_prefilter' functions error out the file. Handle that gracefully.
727      if ( isset( $file['error'] ) && ! is_numeric( $file['error'] ) && $file['error'] ) {