Функция wp_get_video_extensions() возвращает массив расширений видеофайлов, которые поддерживаются WordPress по умолчанию. Эти расширения определяют форматы видео, которые можно автоматически встраивать в записи WordPress без использования плагинов или дополнительного кода.
wp_get_video_extensions(): string[]Возвращаемое значение: Возвращает массив строк, где каждая строка — это расширение поддерживаемого формата видео.
По умолчанию, поддерживаются следующие форматы видео:
mp4m4vwebmogvwmvflv
Эти расширения используются для автоматического встраивания видео в постах WordPress. Например, если видеофайл с одним из этих расширений указан на отдельной строке, он автоматически преобразуется в видеоплеер.
Пример возвращаемого массива
Array
(
[0] => mp4
[1] => m4v
[2] => webm
[3] => ogv
[4] => wmv
[5] => flv
)
Пример 1: Получение поддерживаемых форматов видео
В следующем примере мы получаем список всех поддерживаемых WordPress видеоформатов и выводим их на экран.
// Получаем массив поддерживаемых расширений видео
$video_extensions = wp_get_video_extensions();
// Выводим на экран
echo 'Поддерживаемые форматы видео: <br>';
foreach ($video_extensions as $extension) {
echo $extension . '<br>';
}
Вывод:
Поддерживаемые форматы видео:
mp4
m4v
webm
ogv
wmv
flv
Пример 2: Проверка расширения файла перед загрузкой
Перед тем как загружать видео на сайт, можно использовать функцию wp_get_video_extensions() для проверки, поддерживает ли WordPress этот формат.
// Проверяем, поддерживается ли формат видео перед загрузкой
function check_video_format( $file_extension ) {
$supported_extensions = wp_get_video_extensions();
if ( in_array( $file_extension, $supported_extensions ) ) {
echo 'Формат ' . $file_extension . ' поддерживается!';
} else {
echo 'Формат ' . $file_extension . ' не поддерживается.';
}
}
// Пример использования
check_video_format( 'mp4' ); // Формат mp4 поддерживается!
check_video_format( 'avi' ); // Формат avi не поддерживается.
Пример 3: Добавление собственного расширения видео через фильтр
WordPress предоставляет фильтр wp_video_extensions, который можно использовать для добавления дополнительных видеоформатов в список поддерживаемых.
// Добавляем новый формат видео через фильтр
function custom_video_extensions( $extensions ) {
$extensions[] = 'mov'; // Добавляем формат .mov
return $extensions;
}
add_filter( 'wp_video_extensions', 'custom_video_extensions' );
// Проверяем результат
$video_extensions = wp_get_video_extensions();
print_r( $video_extensions );
Теперь функция wp_get_video_extensions() вернет обновленный массив, включающий новый формат .mov:
Array
(
[0] => mp4
[1] => m4v
[2] => webm
[3] => ogv
[4] => wmv
[5] => flv
[6] => mov
)
Примечания
- Фильтр:
wp_video_extensionsпозволяет добавлять или удалять поддерживаемые расширения видео. Это удобно, если на сайте нужно поддерживать нестандартные форматы. - Автовстраивание: В WordPress ссылка на видеофайл с одним из поддерживаемых расширений, размещенная на отдельной строке, автоматически преобразуется в видеоплеер. Например, если вы вставите ссылку на файл
video.mp4в текст записи, WordPress автоматически отобразит встроенный видеоплеер.
Заключение
Функция wp_get_video_extensions() — это простой способ получить список поддерживаемых форматов видео в WordPress. Она особенно полезна при работе с мультимедийным контентом и автоматическим встраиванием видео на сайт. Возможность расширить список поддерживаемых форматов через фильтры делает эту функцию гибкой и подходящей для различных сценариев использования.