Описание pre_wp_unique_filename_file_list
— Filter
Хук pre_wp_unique_filename_file_list позволяет изменить имена файлов перед их загрузкой в WordPress. Он срабатывает во время проверки уникальности имени файла для предотвращения перезаписи существующих файлов. Это позволяет разработчикам модифицировать имена загружаемых файлов и управлять конфликтами имен
Примеры использования
Пример добавления префикса к именам файлов перед загрузкой:
add_filter('pre_wp_unique_filename_file_list', function($file_list) {
foreach ($file_list as &$file) {
$file = 'prefix_' . $file;
}
return $file_list;
});
В этом примере к каждому имени файла добавляется префикс ‘prefix_’
Пример добавления временной метки к имени файла:
add_filter('pre_wp_unique_filename_file_list', function($file_list) {
foreach ($file_list as &$file) {
$info = pathinfo($file);
$file = $info['filename'] . '_' . time() . '.' . $info['extension'];
}
return $file_list;
});
Здесь к имени файла добавляется временная метка, что делает его уникальным
Пример замены пробелов в имени файла на символы подчеркивания:
add_filter('pre_wp_unique_filename_file_list', function($file_list) {
foreach ($file_list as &$file) {
$file = str_replace(' ', '_', $file);
}
return $file_list;
});
В этом примере пробелы в именах файлов заменяются на символы подчеркивания
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо изменить имена загружаемых файлов для предотвращения конфликтов
– Производительность
Хук не должен значительно влиять на производительность, так как изменения касаются только обработки имен файлов
– Предупреждения
Убедитесь, что изменения не приводят к конфликтам с существующими файлами на сервере
Альтернативы
Тип: filter
Этот хук позволяет изменять имя файла непосредственно перед его сохранением, обеспечивая уникальность
Используйте его, если необходимо изменить имя файла после применения всех других изменений
