=== Bg Playlist ===
Contributors: VBog
Donate link: http://bogaiskov.ru/about-me/donate/
Tags: playlist, player, track, music, auduio, disk
Requires at least: 3.0.1
Tested up to: 5.2.2
Requires PHP: 5.3
Stable tag: trunk
License: GPLv2
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Плагин создает плей-лист WP, используя ссылки на аудиофайлы в постах.

== Description ==

Плагин создаёт плейлист, используя ссылки на аудиофайлы **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 ="">`.

Если первый символ текста ссылки `#`, то **текст ссылки** при отображении в плеере игнорируется, а вместо него отображается **название трека** -- **имя исполнителя**.

Чтобы задать **изображение для трека** вставьте его в текст ссылки:

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

 == Screenshots == 
1. Схема элементов аудиоплейера
1. Настройки плагина
1. Настройки внешнего вида проигрывателя
1. Наши пользовательские кнопки в редакторе TinyMCE	
	
== Installation ==
1. Upload the plugin files to the `/wp-content/plugins/bg-playlist` directory, or install the plugin through the WordPress plugins screen directly.
1. Activate the plugin through the \'Plugins\' screen in WordPress.
1. Use the Settings->Plugin Name screen to configure the plugin.

== Frequently Asked Questions ==

Спрашивайте. Ответим.


== Changelog ==

= 1.5.5 =

* Заменены ссылки на скачивание ссылок для копирования в буфер обмена для iOs

= 1.5.4 =

* Исправлена ошибка в всплывающей подсказке

= 1.5.3 =

* Индикатор "Подождите, пожалуйста!" пока аудио загружается

= 1.5.1-2 =

* Улучшения алгоритма
* Исправлены ошибки

= 1.5.0 =

* Добавлены кнопки «Вперед» и «Назад». Вы можете установить шаг перемотки в настройках.
* Добавлен плейлист M3U.

= 1.4.1-2 =

* Исправлены баги.

= 1.4.0 =

* Добавлена летящая кнопка Воспроизвести/Пауза.
* Плагин добавяет атрибут `data-length` при сохранении поста.

= 1.3.1 =

* Внесены некоторые улучшения.

= 1.3.0 =

* Добавлена опция "Получить продолжительность из аудиофайла".
* Название и заголовок трека поменялись меставми в гиперссылке.
* Исправлены ошибки.

= 1.2.1 =

* Исправлены ошибки.

= 1.2.0 =

* Добавлены три кнопки в редактор TinyMCE : «Вставить аудиоссылку», «Вставить аудиодиск» и "Вставить плейлист".

= 1.1.0 =

* Добавлена опция "Отключить циклическое воспроизведение плейлиста".

= 1.0.1 =

* Исправлены мелкие ошибки.

= 1.0 =

* Первый релиз плагина.

== Upgrade Notice ==

* Первый релиз плагина.
