Filter hook 'pre_wp_unique_filename_file_list'

Hook Information

Hook Parameters

Usage Examples

<?php
// Hook into pre_wp_unique_filename_file_list
add_filter('pre_wp_unique_filename_file_list', 'my_custom_filter', 10, 3);

function my_custom_filter($files, $dir, $filename) {
    // Your custom filtering logic here
    return $files;
}

Source Code Context

<?php
2668  			 * @param array|null $files    The list of files to use for filename comparisons.
2669  			 *                             Default null (to retrieve the list from the filesystem).
2670  			 * @param string     $dir      The directory for the new file.
2671  			 * @param string     $filename The proposed filename for the new file.
2672  			 */
2673  			$files = apply_filters( 'pre_wp_unique_filename_file_list', null, $dir, $filename );
2674  
2675  			if ( null === $files ) {
2676  				// List of all files and directories contained in $dir.
2677  				$files = @scandir( $dir );
2678  			}

PHP Documentation

<?php
/**
			 * Filters the file list used for calculating a unique filename for a newly added file.
			 *
			 * Returning an array from the filter will effectively short-circuit retrieval
			 * from the filesystem and return the passed value instead.
			 *
			 * @since 5.5.0
			 *
			 * @param array|null $files    The list of files to use for filename comparisons.
			 *                             Default null (to retrieve the list from the filesystem).
			 * @param string     $dir      The directory for the new file.
			 * @param string     $filename The proposed filename for the new file.
			 */