=== Soundy Background Music ===
Contributors: bducouedic
Tags: audio, sound, music, background, soundtrack, background sound, background audio, background music, posts, pages
Requires at least: 3.6
Tested up to: 4.9
Stable tag: 3.9
License: GPL2
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Donate link: https://webartisan.ch/en/products/soundy-background-music/free-wordpress-plugin/#wa_donate

This plugin allows any page or post to play a soundtrack while it is displayed.

== Description ==
= Description =  

**Soundy Background Music** allows any page or post to play a background music while it is displayed.
 
Having a home page or any other page playing a background music greatly improves your website visitor's experience. By choosing a music in adequacy with your content, Soundy will help making your visitors immersed in your pages. Pages with a slideshow are excellent candidates for Soundy. But a lot of other page types too.

A Play/Pause button can be displayed anywhere in the pages and posts. Do you need a Play/Pause button that perfectly fits your website design ? Consider [**Soundy Background Music PRO**](https://webartisan.ch/en/products/soundy-background-music/pro-wordpress-plugin/).
  
Each page or post can have its own soundtrack. The soundtrack is embedded in the page by means of the HTML 5 audio tag. This way, the plugin is compatible with all modern user devices (smartphones, tablets, laptops and desktops of all vendors).
 
A background music can be associated with all pages and posts or with individual pages or posts.

If you want your pages and posts to play more than one soundtrack, consider [**Soundy Audio Playlist Plugin**](https://wordpress.org/plugins/soundy-audio-playlist/).
   
Defaults can be set by the administrator in the settings page of the plugin. Specific post and page plugin settings can be configured by the authors in the Edit Page and Edit Post pages. In the plugin settings page, an audio track can be set per default.

The audio track can be anywhere on the web as it is specified with its URL. It can also be uploaded in the media library of the WP site.
  
A play and pause button image can be uploaded by the administrator to replace the default one and can be positioned anywhere. The Play/Pause button can be positioned in any of the four corners of the HTML document or in any of the four corners of the browser window. It can also be positioned with a template tag typically in the document header or with a shortcode in the content.

= Soundy Free Version Features =

* A soundtrack can be specified by the site administrator per default for all pages and posts.
* The default soundtrack can be overriden by page and post authors with a custom one for any page or post.
* Default Play/Pause button images can be overriden by the site administrator. He can upload these images or just specify their URLs.
* Full Control for the site administrator over Play/Pause button positioning.
* Play/Pause Button Preview in the context of any page or post.
* Play/Pause Button size and positioning can be made responsive in the Play/Pause Responsiveness tab of the plugin settings page.
* Audio Volume Control for site administrator as well as page/post authors.
* Auto Play Option.
* Audio Loop Option.

= Soundy PRO Version Features =

* Same features as the free version.
* [**HTML5 Play/Pause Button Designer**](https://www.webartisan.ch/en/products/soundy-background-music/pro-wordpress-plugin/) allowing control over:
* &nbsp;&nbsp;&nbsp;&nbsp;Button colors
* &nbsp;&nbsp;&nbsp;&nbsp;Button size
* &nbsp;&nbsp;&nbsp;&nbsp;Button outline
* &nbsp;&nbsp;&nbsp;&nbsp;Button rounding
* &nbsp;&nbsp;&nbsp;&nbsp;Button transparency
* Seamlessly integrated button designer allows the Play/Pause button to precisely and exactly fit any website design.

Here are examples of Soundy Background Music implementations:

* Ivy & Mario's website: [www.hanstylewedding.com](https://www.hanstylewedding.com/)
* Swiss pianist, Magali Bourquin's website: [www.magalibourquin.com](https://www.magalibourquin.com/)

In Magali Bourquin's Soundy Background Music implementation, the background sound is enabled for all pages but only the homepage has the Autoplay option set. As for the Play/Pause button, custom images have been uploaded to replace the default ones and the button is statically positioned with a call to the soundy_button() function from the header.php file.

= Docs & Support =

You can find [Tutorial](https://webartisan.ch/en/products/soundy-background-music/free-wordpress-plugin/#wa_tutorial), [FAQ](https://webartisan.ch/en/products/soundy-background-music/free-wordpress-plugin/#wa_FAQ), [Examples](https://webartisan.ch/en/products/soundy-background-music/free-wordpress-plugin/#wa_examples) and more detailed information about **Soundy** plugin on [WebArtisan.ch](https://webartisan.ch/en/products/soundy-background-music/free-wordpress-plugin/). If you were unable to find the answer to your question on the FAQ or in any of the documentation, you should check [Soundy's Support Forum](https://wordpress.org/support/plugin/soundy-background-music) on WordPress.org. If you can't locate any topics that pertain to your particular issue, post a new topic for it.
**Soundy Background Music** Plugin Home Page: [webartisan.ch/en/products/soundy-background-music/free-wordpress-plugin](https://webartisan.ch/en/products/soundy-background-music/free-wordpress-plugin/)

== Installation ==

= Installation =

* In the Admin area (the back-end) of your WordPress Web Site, go to Plugins > Add New.
* Enter **Soundy** in the search field.
* **Soundy Background Music** appears.
* Click on "Install Now".
* Click on "Activate Plugin".
* To let a page or post play a soundtrack:

1. Go into the *Edit Page* or *Edit Post* tool of this page in the Admin area.
1. Set the option *Enable Background Sound* to *Yes* in the Soundy meta box and update the page.
1. The page will then play the default soundtrack when displayed.

* To set up plugin defaults, go to Settings > **Soundy** in the admin area and fill out the input fields.
* For help, here is a [tutorial](https://webartisan.ch/en/products/soundy-background-music/free-wordpress-plugin/#wa_tutorial).
* Happy Soundy Music !

= Updates =

* After an update of Soundy you must clear the cache of your browser for the Settings > Soundy page, the Edit Post and Edit Page pages as well as all front pages using the plugin. This is because cached Javascript and CSS files are modified at each Soundy update.

== Frequently Asked Questions ==

= General Questions =

1. **Why is Soundy Background Music a Must on my WordPress Website ?**  
Having a home page or any other page playing a background music greatly improves your website visitor's experience. By choosing a music in adequacy with your content, Soundy will help making your visitors immersed in your pages. Pages with a slideshow are excellent candidates for Soundy. But a lot of other page types too.

1. **Is it possible to have different soundtracks for different posts and pages ?**  
Yes, a soundtrack can be set up by authors on a per post or per page basis.

1. **Can a page or post play more than one soundtrack ?**
Not with Soundy Background Music's plugin. However this functionality is available with [**Soundy Audio Playlist Plugin**](https://wordpress.org/plugins/soundy-audio-playlist/).

1. **What kind of audio files can be used with Soundy Plugin ?**  
The audio files must be in the MP3, OGG or WAV format. The file extension must be .mp3, .mpg, .mpeg, .ogg .wav or .wave.

1. **Is Soundy Plugin compatible with iphone, ipad and smartphones in general ?**  
Yes it is, as the plugin uses the HTML5 audio tag. There is just one issue with ipod, iphone and ipad (IOS Operating System): Autoplay option is deactivated by Apple on this operating system.

1. **Is it possible to position the Play/Pause button anywhere in the page or post header ?**  
Yes, this can be done with the soundy_button() template tag.

1. **Is it possible to position the Play/Pause button anywhere in the content of a page or post ?**  
Yes, this can be done with the [soundy button] shortcode.

1. **Is it possible to modify the Play/Pause button look & feel ?**  
Yes, you can upload and set up your own button images.

1. **Can I really put my audio files anywhere on the web ?**  
Yes, you can put your audio files anywhere on any cloud or website, except one place: you should not put your audio files in the soundy-background-music plugin directory (or below). If you do, you will loose your files the next time you will install a new version of Soundy. The update process deletes this folder and replaces it with a new one. If you want to store the audio files on your WordPress site, the best place to do so is the media library (/wp-content/uploads/...).

1. **Does Soundy allow having a continuous uninterrupted audio stream playing while navigating on my site ?**  
Because most of the WP themes create and download a new HTML document in your browser each time you navigate to another WP post or page, the answer is NO for such themes.  
However there could be themes which don't download a new HTML document when you switch to another WP post or page. They would rather use Ajax to download the WP post/page in the content area of the downloaded unique main site HTML document.
If such themes exist, then, YES, by using such a theme you could have a continuous uninterrupted audio stream playing while navigating on your site.  
A Soundy's user is using the [Premium Crea WP theme](https://themeforest.net/item/crea-wp/424783) on his site: https://www.hanstylewedding.com/  
While navigating in the bottom menu of this site, the audio stream is not interrupted and remain continuous as the theme doesn't download any new HTML document while navigating in this menu.  
Having a continuous uninterrupted audio stream playing while navigating on a WP site with Soundy plugin might be possible with some themes but on most themes, it is impossible.  
Here, at [WebArtisan.ch](https://webartisan.ch/), we are considering developing a theme which will allow this valuable feature. This will be the Soundy Theme.
If you know of other themes like the Crea WP theme which don't download new HTML documents while navigating on the site, please, let us know !

= Support Questions =

1. **How should I proceed to enable Soundy Background Music only for a few pages or posts ?**  
Go into Soundy's settings page (Settings > Soundy) and uncheck the checkbox “Enable Background Sound”. It actually is unchecked per default. This way Soundy won’t be enabled per default on your site. Then for each page or post in which you want to enable Soundy, go into the Edit Page admin tool and set the “Enable Background Sound” option to “Yes” by checking the corresponding radio button.

1. **After an update of Soundy, my soundtracks are not played anymore and my custom Play/Pause button images are broken. What happened ?**  
As mentioned in the previous paragraph, the reason might be that you had uploaded your audio files and button images under the soundy-background-music plugin directory. This directory is erased and replaced at each update. Do not add any file in it. Again, the prefered location for such files is the WordPress media library.

1. **I've changed the default soundtrack in the Soundy administration (Settings > Soundy) with a new sountrack but a page carries on playing the old soundtrack. What's happening ?**  
While the old soundtrack was active an author did change the Soundtrack option to *Custom* in the Edit Page Soundy meta box.  
To correct the problem, reset the Soundtrack option of the Soundy meta box back to *Default* and update the page.
In *Custom* mode a page retains the soundtrack defined when the *Custom* option was selected. In *Default* mode, the page uses the default soundtrack currently defined in the Soundy settings.

1. **Is it advised to put my audio files on a separate storage cloud ?**  
Yes it is, especially if you have a lot of traffic on your website. Putting your audio files on a separate storage cloud will release the load on your website and improve page load response time in your visitor's browsers. There is a lot of Cloud Storage Providers out there. Here is a list of such providers: [Audio Hostings - free audio hosting sites](https://www.audiohostings.com/). Your hosting provider might also offer cloud storage.

1. **On WP front-end, Soundy's Play/Pause button does not respond correctly. What's the problem ?**  
Soundy needs jQuery 1.10.2 which is the default jQuery library of the last versions of WordPress. However some themes load their own jQuery library. If this library is not up-to-date, Soundy's Play/Pause button gets into troubles.  
Using WordPress Default jQuery library is actually what Soundy does and this is what your theme also should do instead of loading its own old jQuery version. In Soundy Version 2.0 and later, you can now set the variable $use_own_jquery_lib_on_front_end to true in the main Soundy PHP file: soundy.php. To make this modification, go to the plugins page, click on the Edit link of the Soundy plugin, look for the variable and set it to true. This should fix the problem.

1. **I get a PHP parser error. What's the problem ?**
The error message starts with: "Parse error: syntax error, unexpected T_FUNCTION".
This happens when the PHP parser version is too old. Soundy needs PHP 5.3 or higher (PHP 5.3.0 has been released in June 2009).

== Screenshots ==

= Screenshots =

1. **Default Audio Track Settings**
1. **Play/Pause Button Settings**
1. **Play/Pause Button Corner Settings**
1. **Play/Pause Button Static Settings**
1. **Page or Post Soundy Metabox**

== Changelog ==

= Changelog =

= 3.9 &nbsp;&nbsp; - &nbsp;&nbsp; January 14th, 2017  =
* Fixed error messages sent to error log when posts or pages were added.

= 3.8 &nbsp;&nbsp; - &nbsp;&nbsp; November 11th, 2016  =
* Made plugin compatible with SSL.

= 3.7 &nbsp;&nbsp; - &nbsp;&nbsp; October 7th, 2016  =
* Fixed bug that prevented plugin metabox to appear in admin edit pages when website had a path to html root directory.

= 3.6 &nbsp;&nbsp; - &nbsp;&nbsp; August 17th, 2016  =
* Corrected PHP bug related to choice of Play/Pause Button Corner.

= 3.5 &nbsp;&nbsp; - &nbsp;&nbsp; August 8th, 2016  =
* Corrected bug related to strpos PHP function.
* Corrected bug that prevented Media Library buttons to work.

= 3.4 &nbsp;&nbsp; - &nbsp;&nbsp; Juli 7th, 2016  =
* Play/Pause button images dimensions are now displayed in the Play/Pause Button tab of the plugin settings.
* Default values are now displayed as comment in the plugin metabox in posts and pages.

= 3.3 &nbsp;&nbsp; - &nbsp;&nbsp; June 10th, 2016  =
* Load performance increased by removing link prefetch statement on audio file.

= 3.2 &nbsp;&nbsp; - &nbsp;&nbsp; March 10th, 2016  =
* Security exploit fixed.

= 3.1 &nbsp;&nbsp; - &nbsp;&nbsp; March 3rd, 2015  =
* Media Library button calls now new WordPress File Uploader.

= 3.0 &nbsp;&nbsp; - &nbsp;&nbsp; January 3rd, 2015  =
* Play/Pause button size and corner positioning can now be made responsive in "Button Responsiveness" tab of plugin settings page.

= 2.7 &nbsp;&nbsp; - &nbsp;&nbsp; December 20th, 2014  =
* Fixed bug on the front-end appearing in themes using Ajax to reload only the content part of the pages when the visitor navigates on the website.

= 2.6 &nbsp;&nbsp; - &nbsp;&nbsp; September 12th, 2014  =
* Set z-index CSS property to 99999 on play/pause button, so that it always appears on top of any other HTML elements.

= 2.5 &nbsp;&nbsp; - &nbsp;&nbsp; July 28th, 2014  =
* Fixed bug introduced in 2.4: Soundy's metabox in Edit Page/Post did merge with other metaboxes.

= 2.4 &nbsp;&nbsp; - &nbsp;&nbsp; July 23rd, 2014  =
* Input fields of Soundy Background Music Metabox are now distributed in tabs in Edit Page and Edit Post pages.
* If Audio URL does not end with audio file extension, administrators and authors can now specify the audio type.
* Insertion of multiple Play/Pause buttons is now supported.
* Play/Pause button in corner can now be disabled in the Soundy Background Music Settings (Play/Pause Button Corner Position tab) as well as in the Soundy Background Music metabox in the Edit Page and Edit Post pages.

= 2.3 &nbsp;&nbsp; - &nbsp;&nbsp; May 11th, 2014 =
* Made admin user interface a little bit more attractive. No functionality change.

= 2.2 &nbsp;&nbsp; - &nbsp;&nbsp; May 4th, 2014 =
* Fixed bug introduced in 2.0: in the admin plugins page, all plugins had a Settings link pointing to Soundy's settings because of a bug in soundy.php.

= 2.1 &nbsp;&nbsp; - &nbsp;&nbsp; April 26th, 2014 =
* Corrected major bug introduced in 2.0: when Soundy was installed for the first time: the default audio file URL and the default four play/pause button image URLs were undefined.

= 2.0 &nbsp;&nbsp; - &nbsp;&nbsp; April 23rd, 2014 =
* Object Oriented Redesign of the whole plugin.
* Added Play/Pause Button Preview in Context of any Page or Post in Settings > Soundy > Play/Pause Button Tab.
* Added Play/Pause Button Preview in Context of any Page or Post in Settings > Soundy > Play/Pause Corner Position Tab.
* Added Swap Button in Settings > Soundy > Play/Pause Button Tab to swap the URLs of the normal and hover images.
* Fixed minor bug in New Page and New Post Soundy metabox.
* [**Soundy Background Music PRO**](https://webartisan.ch/en/products/soundy-background-music/pro-wordpress-plugin/) and its HTML5 **Play/Pause Button Designer** application is now available.

= 1.2 &nbsp;&nbsp; - &nbsp;&nbsp; March 17th, 2014 =
* Added Audio Volume Control for administrators in Settings > Soundy.
* Added Audio Volume Control for authors in Edit Page and Edit Post Soundy meta box.
* Made Admin User Interface more responsive and user friendlier.

= 1.1 &nbsp;&nbsp; - &nbsp;&nbsp; March 12th, 2014 =
* Corrected a few minor bugs
* Made Soundy forms of the back-end admin section more responsive
* Added possibility to disable Soundy for mobile devices. Set variable **$disable_soundy_for_mobile** to **true** in soundy.php file to disable Soundy for mobile devices.

= 1.0 &nbsp;&nbsp; - &nbsp;&nbsp; March 4th, 2014 =
* First Release

== Upgrade Notice ==

= 3.0 =
* After having upgraded Soundy to 3.0, please clear the cache of Soundy's admin pages in your browser. The reason is that a few CSS and Javascript files have been modified and these files are typically cached by browsers.

= 2.4 =
* **IMPORTANT**: After having upgraded Soundy Background Music to 2.4, please clear the cache of Soundy's admin pages in your browser as well as the cache of all front pages using the plugin. The reason is that a few CSS and Javascript files have been modified and these files are typically cached by browsers.
* [**Soundy Audio Playlist Plugin**](https://wordpress.org/plugins/soundy-audio-playlist/) is now available.

= 2.3 =
* After having upgraded Soundy to 2.3, please clear the cache of Soundy's admin pages in your browser. The reason is that a few CSS and Javascript files have been modified and these files are typically cached by browsers.

= 2.0 =
* **IMPORTANT**: After having upgraded Soundy to 2.0, please clear your browser's cache. The reason is that a few CSS and Javascript files have been modified or deleted and these files are typically cached by browsers.
* [**Soundy Background Music PRO**](https://webartisan.ch/en/products/soundy-background-music/pro-wordpress-plugin/) and its HTML5 **Play/Pause Button Designer** application is now available.

= 1.2 =
* After having upgraded Soundy to 1.2, please clear the cache of Soundy's admin pages in your browser. The reason is that a few CSS and Javascript files have been modified and these files are typically cached by browsers.

= 1.1 =
* After having upgraded Soundy to 1.1, please clear the cache of Soundy's admin pages in your browser. The reason is that a few CSS and Javascript files have been modified and these files are typically cached by browsers.