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
255       * Filters the data for a file before it is uploaded to WordPress.
256       *
257       * The dynamic portion of the hook name, `$action`, refers to the post action.
258       *
259       * @since 2.9.0 as 'wp_handle_upload_prefilter'.
260       * @since 4.0.0 Converted to a dynamic hook with `$action`.
261       *
262       * @param array $file An array of data for a single file.
263       */
264      $file = apply_filters( "{$action}_prefilter", $file );
265
266      // You may define your own function and pass the name in $overrides['upload_error_handler']
267      $upload_error_handler = 'wp_handle_upload_error';
268      if ( isset( $overrides['upload_error_handler'] ) ) {
269           $upload_error_handler = $overrides['upload_error_handler'];
270      }
271
272      // You may have had one or more 'wp_handle_upload_prefilter' functions error out the file. Handle that gracefully.
273      if ( isset( $file['error'] ) && ! is_numeric( $file['error'] ) && $file['error'] ) {