wp_unique_filename filter-hook . WP 4.5.0

Filters the result when generating a unique file name.

Usage

add_filter( 'wp_unique_filename', 'filter_function_name_3707', 10, 6 );
function filter_function_name_3707( $filename, $ext, $dir, $unique_filename_callback, $alt_filenames, $number ){
	// filter...

	return $filename;
}

$filename(string)

Unique file name.

$ext(string)

File extension, eg. ".png".

$dir(string)

Directory path.

$unique_filename_callback(callable|null)

Callback function that generates the unique file name.

$alt_filenames(string[])

Array of alternate file names that were checked for collisions.

$number(int|string)

The highest number that was used to make the file name unique or an empty string if unused.

Changelog

Where the hook is called

return apply_filters( 'wp_unique_filename', $filename, $ext, $dir, $unique_filename_callback, $alt_filenames, $number );

Where in WP core the hook is used WordPress