=== A/B Audio Sync ===
Contributors: jcornutt
Donate link: https://joscor.com/wordpress-ab-audio-sync
Tags: audio, ab testing, sync, jquery, wav, mp3, music, songs, tracks, flac, aac, wordpress, html5, synchronization, synchronized audio, music player, a/b testing, a/b comparison
Requires at least: 3.2
Tested up to: 4.6.1
Stable tag: 4.6.1
License: GPLv2
License URI: http://www.gnu.org/licenses/gpl-2.0.html

WordPress plugin that provides A/B audio comparison and synchronization.


== Description ==

**[Click here for a live demo](https://joscor.com/wordpress-ab-audio-sync/)**

The A/B Audio Sync plugin for WordPress allows developers to queue two songs (WAV,
MP3, any format the web browser can handle) and play one at a time, with a toggle
switch between them.  This gives users the ability to switch tracks quickly, without
losing the track time, to hear differences in audio tracks.

This is great for demonstrating audio enhancement technology or production/post-production
mixes or even the differences between audio format quality.


== Installation ==

1. Download the plugin and unzip to your wp-content/plugins directory
2. Alternatively, just upload the zip file via the WordPress plugins UI
3. Activate plugin via Wordpress admin
4. Include the following elements on your page or post

`
<div class="audio-sync-group">
    <audio class="audio-sync-a" src="PATH_TO_AUDIO_A" preload="preload" controls="controls"></audio>
    <audio class="audio-sync-b" src="PATH_TO_AUDIO_B" preload="preload" controls="controls"></audio>
    <button class="audio-btn-sync-play">Play</button>
    <button class="audio-btn-sync-a">Audio A</button>
    <button class="audio-btn-sync-b">Audio B</button>
</div>
`

Replace *PATH_TO_AUDIO_A* and *PATH_TO_AUDIO_B*, of course with your own files. File type will be dependent on browser support.
This has been tested with MP3 and WAV audio files with no issues on Google Chrome.

The plugin looks for HTML objects with the class of *audio-sync-group* as its starting point.
From there, it will look for exactly two audio elements that have the class *audio-sync-a* or *audio-sync-b*.  There
can be only one of each within an audio group.  There must also be *audio-btn-sync-play*,
*audio-btn-sync-a*, and *audio-btn-sync-b* buttons to control play and audio toggle.

There can be multiple audio groups on the same page and they will all act independently from eachother. This is
ideal for a "showcase" type of page with many A/B comparisons happening in one view.

**New in 3.3** The *audio-btn-sync-play* button also supports the *data-stop* attribute to change
the button's behavior from pausing audio (default) or to stopping audio. The
*data-stop* attribute does not need a value, it only needs to be declared to take effect. To
have a stop button, the button should look like this - `<button class="audio-btn-sync-play" data-stop="">Play</button>`

**New in 3.4** The "audio-btn-sync-[a/b]" buttons now support the "data-show-menu" attribute to
allow users to right-click on the audio tracks to see the context menu. This context menu
is now disabled by default on all tracks.

== Changelog ==

= 0.3.4 =
* Enhancement: Added "disable right-click menu" using "data-show-menu" HTML5 attribute
* Improvement: User-selected volume now persists between play/pause cycles
* Fix: Incorrect resume state after pause

= 0.3.3 =
* Enhancement: Added "stop" button support using "data-stop" HTML5 attribute

= 0.3.2 =
* Improvement: Removed dependency that buttons be direct children of the group
* Improvement: Pause / Play button now re-synchronizes timing
* Fix: Race condition between "readyState" and "canplay"

= 0.3.1 =
* Enhancement: Added support for multiple A/B audio groups
* Improvement: Removed dependency on HTML IDs
* Fix: Audio synchronization timing


== Screenshots ==

1. Screenshot of the resulting side-by-side comparison.  This includes the `controls="controls"` parameter.