Featured Audio

WordPress поддерживает избранные изображения из коробки, позволяя изображениям представлять сообщения различными способами, определенными темой. Этот плагин добавляет аналогичную поддержку аудио, позволяя музыкантам, подкастерам и всем, кто публикует аудио с помощью WordPress, размещать аудиофайлы в сообщениях и на страницах в структурированном виде. Каждый пост и страница получают избранный аудио-метабокс, куда можно загрузить или выбрать аудиофайл из медиатеки. По умолчанию избранный звук отображается вверху сообщений и страниц (внутри the_content). Разработчики могут изменить это, добавив поддержку тем для избранного аудио с помощью нескольких функций API, перечисленных ниже. Зачем использовать избранный звук вместо встраивания звука непосредственно в сообщения? Рекомендуемый звук упорядочивает контент структурированным образом, предоставляя безграничные возможности для настройки того, как пользователи воспринимают аудиоконтент на вашем сайте. Плагин поставляется с одним из примеров этого - виджетом избранного аудио-плейлиста. Добавьте этот виджет на свою боковую панель, и он автоматически отобразит список воспроизведения всех аудиофайлов, представленных в сообщениях, отображаемых в текущем представлении, в представлениях с более чем одним сообщением, таких как главная страница блога или страница категории. Плагин также поддерживает виджет недавних аудио-плейлистов, который ведет себя аналогично виджету последних сообщений. Для более полного способа управления музыкой с помощью WordPress, особенно если вам нужно включить ноты вместе со звуком, см. Плагин Sheet Music Library. Функции API разработчика Добавить поддержку темы add_theme_support ('Feature-audio') Добавление поддержки темы для избранного звука указывает плагину не добавлять избранный звук в контент автоматически. Вместо этого вы можете добавить избранный звук именно туда, где хотите, с помощью the_featured_content () (подробности см. Ниже). Изменение поддерживаемых типов сообщений По умолчанию поддерживаются типы сообщений и страниц. Вы можете использовать фильтр Feature_audio_post_types, чтобы изменить этот список. Например: add_filter ('Feature_audio_post_types', 'prefix_featured_audio_post_types'); function prefix_featured_audio_post_types ($ post_types) {// Добавляем поддержку для типа сообщения sheet_music. $ post_types [] = 'лист_музыка'; // Перезаписываем весь список, чтобы удалить поддержку на страницах. $ post_types = массив ('сообщение'); вернуть $ post_types; } the_featured_audio ($ args) Отображает избранный звук, если он существует. Параметры: массив $ args Параметры отображения. $ args ['id'] int Идентификатор сообщения (необязательно). По умолчанию используется текущий идентификатор сообщения. $ args ['album_art'] логическое Показывать ли обложку альбома для избранного аудио цикла. По умолчанию: false. $ args ['album_art_size'] строка Размер, используемый для обложки альбома. По умолчанию: эскиз. $ args ['title'] boolean Отображать ли заголовок аудио-вложения. По умолчанию: false. get_the_featured_audio ($ args) Получить избранный звук, если он существует, в виде строки. Имеет те же аргументы, что и the_featured_audio (). get_featured_audio_src ($ id) Возвращает URL-адрес указанного аудиофайла, если он существует. Параметр: $ id int Идентификатор публикации (необязательно). По умолчанию используется текущий идентификатор сообщения. get_featured_audio_attachment_id ($ id) Возвращает идентификатор указанного аудио-вложения, если он существует. Параметр: $ id int Идентификатор публикации (необязательно). По умолчанию используется текущий идентификатор сообщения. get_the_featured_audio_playlist () Получить список воспроизведения избранного аудио, если в текущем запросе есть несколько сообщений с избранным аудио. Используется виджетом избранного аудио-плейлиста. the_featured_audio_playlist () Отображает (отображает) get_the_featured_audio_playlist ().

Автор: Nick Halsey

Версия: 1.2

Последнее обновление: 2020-03-30 3:29am GMT