хук-фильтр
since 4.5.0
wp_unique_filename
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
apply_filters( 'wp_unique_filename', string $filename, string $ext, string $dir, callable|null $unique_filename_callback, string[] $alt_filenames, int|string $number )Описание
Фильтрует результат при генерации уникального имени файла.
Фильтруемое значение
Уникальное имя файла.
Параметры
$filename
string
обязательный
Уникальное имя файла.
$ext
string
обязательный
Расширение файла. Пример: ".png".
$dir
string
обязательный
Путь к каталогу.
$unique_filename_callback
callable|null
обязательный
Функция обратного вызова, генерирующая уникальное имя файла.
$alt_filenames
string[]
обязательный
Массив альтернативных имён файлов, проверенных на конфликты.
$number
int|string
обязательный
Наибольшее число, использованное для придания имени файла уникальности, или пустая строка, если оно не использовалось.
Исходный код
wp-includes/functions.php:2809
return apply_filters( 'wp_unique_filename', $filename, $ext, $dir, $unique_filename_callback, $alt_filenames, $number );История изменений
| Версия | Описание |
|---|---|
| 5.8.1 | The $alt_filenames and $number parameters were added. |
| 4.5.0 | Introduced. |
