Описание attachment_icon
— Filter
Хук attachment_icon позволяет изменить HTML-код значка вложения, отображаемого в медиабиблиотеке и на страницах редактирования вложений в WordPress. Он срабатывает при формировании значка для вложений и позволяет кастомизировать его внешний вид
Примеры использования
Пример изменения значка для изображений:
add_filter('attachment_icon', function($icon, $id) {
return '<img decoding="async" src="custom-icon.png" alt="Кастомный значок" />';
}, 10, 2);
В этом примере мы заменяем значок вложений на кастомный значок изображения
Пример добавления класса к значку вложения:
add_filter('attachment_icon', function($icon, $id) {
return str_replace('class="', 'class="custom-class ', $icon);
}, 10, 2);
Здесь мы добавляем кастомный класс к существующему значку вложения
Пример изменения значка для PDF файлов:
add_filter('attachment_icon', function($icon, $id) {
$file_type = get_post_mime_type($id);
if ($file_type == 'application/pdf') {
return '<img decoding="async" src="pdf-icon.png" alt="PDF файл" />';
}
return $icon;
}, 10, 2);
В этом примере мы проверяем тип файла и заменяем значок для PDF файлов на кастомный
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо изменить внешний вид значка вложений в медиабиблиотеке или на страницах редактирования
– Производительность
Хук не должен значительно влиять на производительность, так как изменения касаются только вывода HTML
– Предупреждения
Убедитесь, что ваш кастомный значок доступен и загружается без ошибок
Альтернативы
Тип: filter
Этот хук позволяет изменять данные перед загрузкой файла, включая его тип и имя
Используйте его, если нужно изменить поведение загрузки файлов
