WP Audio Shortcode: функция отображения аудио в WordPress. Как использовать и примеры.

# WP_AUDIO_SHORTCODE() │ WP 3.6.0

Функция для отображения аудио с помощью шорткода.  
Эта функция позволяет добавлять mp3 файлы WordPress в ваши посты.

## Хуки функции

- wp_audio_shortcode_override
- wp_audio_shortcode_library
- wp_audio_shortcode_class
- wp_audio_shortcode

## Возвращаемое значение

Возвращает строку или null. HTML-код для отображения аудио.

## Использование

Функция вызывается так:

```php
wp_audio_shortcode( $attr, $content );

Параметры

• $attr (array) (обязательный) — Атрибуты аудио шорткода.

  • src (string) — URL источника аудио-файла.
    По умолчанию: ''

  • loop (string) — Атрибут 'loop' для элемента <audio>.
    По умолчанию: ''

  • autoplay (string) — Атрибут 'autoplay' для элемента <audio>.
    По умолчанию: ''

  • preload (string) — Атрибут 'preload' для элемента <audio>.
    По умолчанию: 'none'

  • class (string) — Атрибут 'class' для элемента <audio>.
    По умолчанию: 'wp-audio-shortcode'

  • style (string) — Атрибут 'style' для элемента <audio>.
    По умолчанию: 'width: 100%;'

• $content (string) — Содержимое шорткода.
  По умолчанию: ''

Примеры

1. Отображение аудио плеера в любом месте шаблона

Пример кода для отображения аудио плеера:

$args = array(
    'src'      => 'http://example.com/my.mp3',
    'loop'     => false,
    'autoplay' => false,
    'preload'  => 'none'
);

echo wp_audio_shortcode( $args );

Этот код выведет HTML-код аудио плеера на странице:

В браузере вы получите такой плеер, где можно включить и послушать указанный файл.

2. Полное переопределение вывода

Вы можете полностью заменить стандартный вывод шорткода, используя хук wp_audio_shortcode_override. Это аналогично тому, как это делается с шорткодом галереи.

add_filter( 'wp_audio_shortcode_override', 'my_audio_shortcode', 10, 4 );

function my_audio_shortcode( $empty_str, $attr, $content, $instance ){
    // Проверяем атрибуты и задаем новый вывод для плеера
    if( $attr['autoplay'] ){
        // Здесь пишем свой код для вывода плеера для музыки с автозапуском
    } else {
        return '';
    }
}

Изменения

С версии 3.6.0 — новая функция была введена.

Исключительные сообщения

Данный код размещается в файле wp-includes/media.php и позволяет реализовывать шорткод для аудио.

Похожие функции

• shortcode
• gallery_shortcode()
• has_shortcode()
• shortcode_parse_atts()
• wp_playlist_shortcode()
• wp_video_shortcode()

Шорткоды

• add_shortcode()
• apply_shortcodes()
• do_shortcode()
• get_shortcode_regex()
• remove_all_shortcodes()
• remove_shortcode()
• shortcode_atts()
• shortcode_exists()
• strip_shortcodes()