Bg Playlist

Описание

Плагин создаёт плейлист, используя ссылки на аудиофайлы 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 в ссылку во время сохранения поста. Это работает, если аудиофайл размещен только на том же сайте.