Bg Playlist
VBog By VBog

January 16, 2023

Bg Playlist Plugin

The plugin creates the WP playlist using links to audio files in the posts.

Plugin creates playlist, using links to audio files mp3 | m4a | ogg | wav in the posts of your site. The following tag attributes are used: <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" – class name of the link to the audio file. By default: wpaudio. Can be changed in plugin settings.
  • href="https://sitename.com/path/filename.mp3" – audio file URL. Relative path is allowed (by default relative to the site root).
  • title="Track title" – the track title – displayed in the player header. If is empty, the link text is accepted. If link text is also empty, then track title and track caption is filename filename.mp3.
  • alt="Track discription" – track discription.
  • data-artist="Artist name" – artist name.
  • data-album="Album title" – album title. If the album title is not set in this tag, then the album title is the post title.
  • data-length="123" – track length in seconds.
  • Track caption - link text – track caption. If link text is not specified, then the titleartist name is displayed instead.

In the link text is allowed to use the html-tags: <em>, <strong>, <i>, <b>, <s>, <del>, <sup>, <sub>, <small>, <span class="" style ="">.

If the first character of the link text is #, then link text is ignored in player, and the titleartist name is displayed instead.

To set track image paste it into the link text:

<a class="wpaudio" ...><img src="https://sitename.com/path/image.png" width="48" height="64" />Track title</a> 

In automatic mode (default is off), the plug-in parse the post contents and instead of the text that located between the first and last audio links, inserts the standard WP player with playlist that included of the found audio links.

If for a post to create an custom field single_audio with any value other than an empty string, then each link will be treated as a separate playlist with a single track.

Enclosing shortcode[audiodisk] ... [/audiodisk] allows you to reduce the range of search for links on the page to text located inside the shortcode tags. This gives you more flexibility to edit posts, allows you to create multiple playlists on single page.

Self-closing shortcode[audiodisk src ="https://sitename.com/path/playlist.m3u" /] allows you to insert a player with a pre-configured playlist,

there is src – link to the playlist file in the formats m3u or pls. You can set relative path to the file.

The plugin adds “Downoad” button for each track in the standard WP player.

You can disable playlist looping with same named option.

In TinyMCE Editor added three buttons: “Insert audiolink”, “Insert audiodisk” and “Insert playlist”.

“Insert audiolink” allows insert tag <a> with all attributes.

“Insert audiodisk” inserts enclosing shortcode [audiodisk] ... [/audiodisk] around selected text.
The same button “Аudiodisk” available in editor text mode too.

“Insert playlist” inserts self-closing shortcode [audiodisk src ="https://sitename.com/path/playlist.m3u" /].

Plugin will added automaticly attribute data-length in link while post saving. It’s works if audiofile placed on the same site only.

Installation

  1. Upload the plugin files to the /wp-content/plugins/bg-playlist directory, or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the \’Plugins\’ screen in WordPress.
  3. Use the Settings->Plugin Name screen to configure the plugin.

Screenshots

  1. Scheme of audioplayer elements

    Scheme of audioplayer elements

  2. General settings

    General settings

  3. Player appearance settings

    Player appearance settings

  4. Our custom buttons in TinyMCE editor

    Our custom buttons in TinyMCE editor

FAQ

Ask me. I’ll respond.

Sorry for my English.

Changelog

1.5.6

  • Support PHP 8.0

1.5.5

  • Replaced download links to links copy to clipboard for iOs

1.5.4

  • Fixed bug in popup tooltip

1.5.3

  • Indicator “Wait, pls!” when audio is loading

1.5.1-2

  • Algorithm improvements
  • Fixed bugs

1.5.0

  • Added buttons “Forward” and “Back”. You can set rewind step in the Settings.
  • Added M3U playlist for download.

1.4.1-2

  • Fixed bugs.

1.4.0

  • Added flying Play/Pause button.
  • Plugin will added attribute data-length while post saving.

1.3.1

  • Inserted some improvements.

1.3.0

  • Added option “Get duration from audiofile”.
  • Track title and track caption change places in the hyperlink.
  • Fixed bugs.

1.2.1

  • Fixed bugs.

1.2.0

  • Added three buttons in TinyMCE Editor: “Insert audiolink”, “Insert audiodisk” and “Insert playlist”.

1.1.0

  • Added option “Disable playlist looping”.

1.0.1

  • Fixed small bugs.

1.0

  • Starting release.

Details

  • Version: 1.5.6
  • Active installations: 90
  • WordPress Version: 3.0.1
  • Tested up to: 6.1.7
  • PHP Version: 7.4

Ratings


5 Stars
4 Stars
3 Stars
2 Stars
1 Stars