Функция wp_get_audio_extensions() возвращает список поддерживаемых WordPress аудиоформатов. Это удобный инструмент для разработчиков, которые работают с медиа-контентом и хотят узнать, какие типы аудиофайлов можно использовать на сайте. WordPress использует эти расширения для автоматического встраивания аудиофайлов в записи и страницы, когда они указаны как ссылки.
wp_get_audio_extensions(): string[]Возвращаемое значение: Массив строк, содержащих расширения поддерживаемых аудиофайлов.
По умолчанию, WordPress поддерживает следующие аудиоформаты:
mp3oggwmam4awav
Эти форматы обеспечивают широкую совместимость с различными браузерами и устройствами, что позволяет пользователям воспроизводить аудио непосредственно через встроенный медиаплеер WordPress.
Пример возвращаемого массива
Array
(
[0] => mp3
[1] => ogg
[2] => wma
[3] => m4a
[4] => wav
)
Пример 1: Получение списка всех поддерживаемых аудио расширений
Этот пример демонстрирует, как получить список всех поддерживаемых расширений аудио файлов в WordPress и вывести их на экран.
// Получаем поддерживаемые аудиоформаты
$audio_extensions = wp_get_audio_extensions();
// Выводим список расширений аудио файлов
echo 'Поддерживаемые аудиоформаты: ' . implode(', ', $audio_extensions);
Вывод:
Поддерживаемые аудиоформаты: mp3, ogg, wma, m4a, wav
Пример 2: Проверка, поддерживается ли аудио формат
Если вы хотите проверить, поддерживается ли определенный формат аудиофайла перед его загрузкой или встраиванием, можно использовать следующий код:
// Функция для проверки поддержки расширения файла
function is_audio_supported( $file_extension ) {
$audio_extensions = wp_get_audio_extensions();
return in_array( $file_extension, $audio_extensions );
}
// Пример использования
$file_extension = 'mp3';
if ( is_audio_supported( $file_extension ) ) {
echo 'Формат ' . $file_extension . ' поддерживается.';
} else {
echo 'Формат ' . $file_extension . ' не поддерживается.';
}
Вывод:
Формат mp3 поддерживается.
Пример 3: Встраивание аудиофайла с проверкой расширения
Этот пример демонстрирует, как встраивать аудиофайлы на сайт WordPress с проверкой их расширения перед выводом.
// УРЛ аудиофайла
$audio_url = 'https://example.com/wp-content/uploads/2024/02/sample-audio.mp3';
// Извлекаем расширение файла
$file_extension = pathinfo( $audio_url, PATHINFO_EXTENSION );
// Проверяем, поддерживается ли формат
if ( is_audio_supported( $file_extension ) ) {
echo '<audio controls>
<source src="' . esc_url( $audio_url ) . '" type="audio/' . esc_attr( $file_extension ) . '">
Ваш браузер не поддерживает аудио элемент.
</audio>';
} else {
echo 'Формат аудио не поддерживается на этом сайте.';
}
Если аудиофайл имеет поддерживаемое расширение, то он будет автоматически встроен в медиаплеер WordPress. В противном случае выводится сообщение о том, что формат не поддерживается.
Пример 4: Добавление нового аудио расширения через фильтр
Если вам необходимо добавить поддержку нового аудиоформата, вы можете использовать фильтр wp_audio_extensions. В следующем примере мы добавляем поддержку расширения .aac.
// Добавляем новое аудио расширение через фильтр
function add_custom_audio_extension( $extensions ) {
$extensions[] = 'aac'; // Добавляем новое расширение aac
return $extensions;
}
add_filter( 'wp_audio_extensions', 'add_custom_audio_extension' );
// Проверим результат
$audio_extensions = wp_get_audio_extensions();
print_r( $audio_extensions );
Теперь WordPress будет поддерживать формат .aac, и его можно будет использовать в качестве аудио источника.
Примечания
- Фильтр: Функция поддерживает фильтр
wp_audio_extensions, который позволяет разработчикам добавлять или изменять список поддерживаемых аудиоформатов. Это особенно полезно для сайтов, которые работают с нестандартными форматами аудиофайлов. - Практическое применение:
wp_get_audio_extensions()может использоваться в проектах, где важно проверять аудиофайлы перед загрузкой или встраиванием, а также для расширения функциональности WordPress при необходимости поддержки дополнительных аудиоформатов.
Заключение
Функция wp_get_audio_extensions() является простым и эффективным способом получения списка всех поддерживаемых аудиоформатов в WordPress. Она позволяет разработчикам легко управлять аудиофайлами на сайте, обеспечивая автоматическую проверку форматов перед их использованием. Возможность расширения через фильтр делает её гибкой и удобной для настройки под любые требования проекта.