Documentation for AudioIgniter

Installation

To install the plugin simply navigate to Plugins Add New in your WordPress dashboard and search for Audioigniter

Next click the Install Now button and wait for the plugin to be installed. Once the plugin is installed you can click the Activate button. That’s it. The plugin is installed and activated.

Creating a playlist

To create a playlist navigate to Playlists Add New Playlist and start by:

In the image above you can see the Tracks metabox. Below we take a step by step approach on adding a track.

  1. Add a playlist for your title
  2. Click the Add Track button, rinse and repeat to add the rest tracks of your playlist.
  3. Clear the playlist
  4. We start by adding a cover. Click the placeholder image and WordPress’ media manager will pop-up to allow you to upload a new cover or select a preexisting image.
  5. Fill in the track’s title
  6. Fill in the artist’s name
  7. You can also fill in a URL where your listeners can download your track, this will display a download button next to the track in the track listing. Please note that while AudioIgniter will try its best to make the link you provide downloadable it might not work everywhere or in all browsers (due to security reasons mostly). In case this happens you can host your downloadable files in a third party service that robustly supports downloads, e.g. Dropbox (with the ?dl=1 flag in the url).
  8. Click the Upload button to get a media manager pop-up which allows you either to upload a new mp3 file or select a preexisting one from your media library. Alternatively if you have a radio stream URL you can paste it in the box. 
  9. If the track is available for purchase you can paste the URL of the marketplace where your visitors can purchase it. This will display a cart button next to the track in the playlist.
  10. Publish the playlist!

Removing tracks

To remove a track simply click the Remove Track button.

Notice: You need to have at least two tracks for the remove track button to appear.

Player settings

In both free and pro version you have multiple player types you can select from depending on your case each time.

Full Width Player

There are a lot of settings available to help you get the most out of your playlists, let’s have a closer look at them.

  1. Select your player type to be: Full Player
  2. Show tracklisting: this option allows you to toggle the appearance of the tracklisting. Leaving the box unchecked will start the playlist hidden. See players 1 & 2 here
  3. Show or hide the playlist toggle button
  4. Show numbers in reverse order: reverses the number order to allow you to create a “countdown” playlist.
  5. Set your starting volume when someone hits the play button
  6. Limit the tracklisting height
  7. Set your tracklisting height in pixels. This will apply only if you choose to limit track height
  8. Set the player width in pixels or leave it blank to cover the width of the container
  9. Allow skipping the position of the track
  10. Enable or disable the playback control

Once you figure out all the settings you are done with the list creation. Click the Publish button to finalize it.

Simple player

Simple player will display a minimal set of features with the playlist hidden. You can

  1. Select your player type to be: Simple Player
  2. Reverse your track order. Last will appear on top
  3. Set the starting music volume
  4. Select a minimum player width in pixels, or leave empty to cover all container width
  5. Enable or disable the playback control

[PRO] Sticky Player

This player will appear on the bottom of your website everywhere. This means you can only have one Global Player. This can be useful for themes using ajax technology to render content since the audio track will seamlessly play when navigation through pages.

  1. Select your player type to be: Global Footer Player
  2. Show or hide the track playlist
  3. Add a toggle button to hide or show the track playlist
  4. Reverse your track order. Last will appear on top
  5. Set a limit for your list height
  6. Add height in pixels
  7. Start playing from a certain position, in second
  8. Enable or disable playback control

Track Settings

All players have their own set of track settings. All of them and their functionality is shown below

  1. Show track numbers in tracklist: this option toggles the appearance of tracklist numbering.
  2. Show track covers in tracklist: select whether you want to display track covers in the tracklist.
  3. Show active track’s cover: this option allows you to hide the current track’s cover from the player. See players 1 & 4 here
  4. Show artist names: toggles the appearance of artist names on the player.
  5. Show buy link: toggles the appearance of the buy link on the player.
  6. Open buy links in new window, so the end-user will not leave your main site.
  7. Repeat track is enabled by default for all playlist
  8. Show or hide the toggle track button
  9. Allow repeat for each track
  10. Show “Powered by AudioIgniter” link: This allows you to display a powered by link below the playlist. Please consider enabling it if you like the plugin, it will help us a lot :).

Displaying the list

To display the list you need to grab its shortcode.

Scroll to the shortcode meta box and copy the shortcode text

Paste the shortcode in any post or page and save, that’s it, you can now see your playlist in action.

TIP: if you want to use the player in a sidebar you can paste the shortcode in a standard textwidget. If you don’t see the player after saving the widget you will need to enable shortcodes in textwidgets. Have a look at this article on how to do this.

AudioIgniter Pro

Installation

To get the plugin’s installable zip file navigate to our downloads section here and search for Audioigniter

Click the green download button and save the zip file when prompted.

Next, navigate to Plugins Add New in your WordPress dashboard and click the Upload Plugin button.

Next click the Choose File button, search for the zip file you downloaded a moment ago, select it and then click the Install Now button.

Finally click the Activate Plugin link and you are done.

Pro Features

Once you install and activate AudioIgniter Pro you get all its additional features, let’s have a closer look at them.

Creating a playlist in the Pro version

To create a playlist navigate to Playlists Add New Playlist and start by:

  1. You can add a title to your playlist
  2. You can add a track
  3. [PRO] Batch Upload Tracks
  4. Clear the playlist
  5. You can use this toggle to reorder via drag and drop your tracks
  6. Upload your track image or select from an existing one
  7. Add a title for your track
  8. Add an artist for your track
  9. Set a buy/shop link. You can use WooCommerce to create an online shop with virtual products.
  10. Select your audio track or radio Stream
  11. Set a Download URL. Some hosts might have this option disabled though.
  12. [PRO] Add Lyrics for your track
  13. [PRO] Add a category for this playlist
  14. Publish the playlist and use it as a shortcode, widget or through Elements Plus!

Custom widget

No need to hack your way through with text widgets. You now have a custom widget available to use on any sidebar. Navigate to Appearance Widgets or Customize Widgets place the AudioIgniter – Playlist widget in any sidebar, give it a title, select a playlist from the drop-down and save. Done!

SoundCloud Integration

Allow users to listen to songs from your SoundCloud, directly on your site with the awesome look of AudioIgniter’s playlists. Just paste the SoundCloud URL in the box. But wait, there is more. Not only you can play tracks from SoundCloud, but you can also pull the track’s info, like name and cover, from SoundCloud so you don’t have to add them manually.

To do that you will need a SoundCloud Client ID.

Currently, the API is discontinued by SoundCloud. SoundCloud integration will work only if you have a key.
  • Login to SoundCloud’s developer portal here using your SoundCloud credentials.
  • Click on Register new app
    sc_new_app
  • Once you click the Register new app link you will see this
    sc_reg_1

    Go through the form filling process step by step.
  • The first page is just general info.
    sc_reg_2
  • Then we have app info. Business usage and monetization are per-case and you should decide what to fill in.sc_reg_3
  • If you have another app on SoundCloud provide the app’s info here.
    sc_reg_4
  • Finally submit the request and wait to hear from SoundCloud. Once the app is approved they will provide you with the necessary Client ID you need for AudioIgniter integration with SoundCloud.
    sc_reg5

Now that you have the Client ID you need to navigate to Customize AudioIgniter SoundCloud in your WordPress dashboard and paste the client ID in the box. Click the Save & Publish button and you are set.

Once this is set up you can go back to your playlist. Clicking the Sync SoundCloud button next to the SoundCloud track’s URL will pull the info automatically.

Batch Uploads

In the PRO version you can upload all your mp3 files at once and have them set up to be a track each on your playlist. Click the Batch Upload button and in the media manager pop-up upload and select all your tracks. Once done click the Select buttonThat’s it.

If the ID tags on your mp3 files are properly set, track info like artist and title will be automatically set!

Rearrange-able tracks

Need to change the order of your playlist? No problem! Just click on the track’s title bar and drag, easy.

ai_pro_rearrange

Once you are done rearranging your tracks don’t forget to click the Update button to save the change.

Styling options

The pro version allows you to apply custom styling to your playlists via the WordPress customizer. Visit Customize AudioIgniter Appearance to do so.

Here you can change the background of the playlists with a solid color or image of your choice. Additionally, you can modify the text color of various playlist items.

Internal taxonomy

With AudioIgniter Pro you can separate your playlist in categories that can help with organization and later retrieval. Please notice this is an internal taxonomy, which means that you can’t use it to display all playlists of a certain category in a listing page on your site, like you would do for example with a post category. The taxonomy is here mainly for archiving purposes.

Playing from third-party services

Dropbox

When fetching your sharing link from DropBox, it will add the following parameter at the end ?dl=1 of the file for example:

 dropboxfolder/mytrack.mp3?dl=1

All you have to do is remove the ?dl=1 parameter and replace it with ?raw=1 which instructs dropbox to serve the raw file.

RadioJar Support

AudioIgniter supports fully RadioJar Streaming service. All you need to do is add your RadioJar URL in your audio stream field like shown bellow:

If you don’t know RadioJar yet, check their awesome service.

Setting up SSL for your Shoutcast server

Chrome will convert all plain HTTP requests to HTTPS. This means that if you have SSL installed and working in your WordPress installation but you don’t in your Shoutcast server your stream will fail to play. You can easily setup SSL for Shoutcast using this method if you are a premium member.

Premium Support

Along with these great extra features, AudioIgniter PRO comes with premium support via our dedicated support forum. Have any questions? Click here and we will help you right away!

LIMITED OFFER! Use the coupon code WORDPRESS and save 30% OFF on any purchase!