Плагин создаёт плейлист, используя ссылки на аудиофайлы mp3 | m4a | ogg | wav в постах вашего сайта. Используются следующие атрибуты тега <a>:
<a class="wpaudio" href="https://sitename.com/path/filename.mp3" title="Track title" alt="Track discription" data-artist="Artist name" data-album="Album title" data-length="123">Track caption</a>
class="wpaudio"-имя класса ссылки на аудиофайл. По умолчанию: wpaudio. Может быть изменен в настройках плагина.href="https://sitename.com/path/filename.mp3"-URL аудиофайла. Допускается указывать относительный путь (по умолчанию относительно корня сайта).title="Track title"— название трека — отображается в шапке плеера. Если пусто, то отображается текст ссылки. Если текст ссылки тоже пусто, то название и заголовок трека — имя файла filename.mp3.alt="Track discription"— описание трека.data-artist="Artist name"— имя исполнителя.data-album="Album title"— название альбома. Если альбом не задан в этом теге, то в качестве названия альбома принимается название поста.data-length="123"— длительность трека в секундах.Track caption - текст ссылки— название трека. Если текст ссылки не задан, вместо него отображается название трека — имя исполнителя.
В тексте ссылки допускается использовать следующие html-теги: <em>, <strong>, <i>, <b>, <s>, <del>, <sup>, <sub>, <small>, <span class="" style ="">.
Если первый символ текста ссылки #, то link text при отображении в плеере игнорируется, а вместо него отображается title — artist name.
Чтобы задать изображение для трека вставьте его в текст ссылки:
<a class="wpaudio" ...><img src="https://sitename.com/path/image.png" width="48" height="64" />Track title</a>
В автоматическом режиме (по умолчанию выкл.) плагин сканирует содержимое поста и вместо текста, расположенного между первой и последней ссылками на аудиофайлы вставляет стандартный WP плеер с плейлистом, содержащим найденные аудиоссылки.
Если для поста создать произвольное поле single_audio с любым значением отличным от пустой строки, то то каждая ссылка будет восприниматься как отдельный плейлист с единственным треком.
Ограждающий шорт-код [audiodisk] ... [/audiodisk] позволяет сузить диапазон поиска ссылок на странице до текста, расположенного внутри тегов шорткода. Это дает вам больше гибкости в редактировании постов, позволяет создавать несколько плейлистов на одной странице.
Самозакрывающийся шорт-код [audiodisk src ="https://sitename.com/path/playlist.m3u" /] позволяет вставлять плеер с заранее сформированным плейлистом,
где src — ссылка на файл плейлиста в форматах m3u или pls. Допускается указывать относительный путь к файлу.
Плагин добавляет к стандартному плейеру WP кнопку «Загрузить» для каждого трека.
Вы можете отключить циклическое воспроизведение плейлиста воспользовавшись опцией с тем же названием.
В редактор TinyMCE добавлены три кнопки: «Вставить аудиоссылку», «Вставить аудиодиск» и «Вставить плейлист».
«Вставить аудиоссылку» позволяет вставить тег <a> со всеми атрибутами.
«Вставить аудиодиск» вставляет ограждающий шорт-код [audiodisk] ... [/audiodisk] вокруг выделенного текста. Такая же кнопка «Аудиодиск» доступна также в текстовом редакторе.
«Вставить плейлист» вставляет самозакрывающийся шорт-код [audiodisk src ="https://sitename.com/path/playlist.m3u" /].
Плагин автоматически добавит атрибут data-length в ссылку во время сохранения поста. Это работает, если аудиофайл размещен только на том же сайте.