Plugin Directory

Test out the new Plugin Directory and let us know what you think.

NGS SAM Integrator

Plug-in to integrate SAM Broadcaster with your WordPress site


Before you install the WordPress plug-in, you will need to configure both SAM Broadcaster and your mySQL database to allow your webserver to access them.
It is highly recommended that you set up a mySQL user specifically for use by the plug-in. This user only requires SELECT access on the songlist, requestlist, and queuelist tables of your SAM database. It does not require any global access privileges, nor does it need to be able to modify any data in your database.

For security reasons, the plug-in will NOT allow you to use the “root” user, even if you have configured it to be allowed external access. For instructions on how to add a new mySQL user, please see http://dev.mysql.com/doc/refman/5.1/en/adding-users.html.

It is also recommended that you take steps to secure your installation of mySQL before allowing external access by this, or any other application or user. For information on how to secure your mySQL installation, please see http://www.mysql.com/why-mysql/white-papers/a-guide-to-securing-mysql-on-windows/.

There are lot of different options you configure in SAM Broadcaster related to how it handles incoming requests. Most of these are fairly self explanatory and can (and should) be adjusted over time to best suit your own needs as well as those of your visitors. I will only cover those settings which are necessary to allow the plug-in to function.

  1. In SAM Broadcaster, click File > Config and select Request Policy.
  2. Make sure that Enable Requests is checked.
  3. You will see a list entitled Only accept requests from these IP addresses.
    The default IP addresses in that list are mostly associated with Audiorealm, which is the site that Spacial Audio uses to process requests if you choose not to process them yourself. This plug-in processes all request internally so you will need to add your webserver’s IP address to this list. It is recommended, when possible, that you use the IP address rather than the domain name here.

For information on the additional Request Policy settings in SAM Broadcaster, please see your SAM Broadcaster documentation or integrated help files.

You will also need to ensure that your firewall and/or router are configured to allow incoming connections on the proper ports for MySQL and SAM Broadcaster. By default, these ports are 1221 for SAM Broadcaster and 3306 for MySQL.

Once this is done, the hard part is out of the way. Installation and configuration of the plug-in itself is very easy and straight forward.

Album Art

  1. Add folder to root directory of your wordpress called "sam"
  2. chmod 777 sam folder
  3. setup sam broadcaster to upload album art images to this folder.

Manual Installation Instructions

  1. Upload the NGS SAM Integrator Plug-In to your WordPress Site and Activate it
  2. Open the NGS SAM Integrator Settings
  3. Enter Your SAM Broadcaster details including the host address and port where the SAM Broadcaster client is running.
  4. Enter the Connection Details for your SAM Broadcaster Database.

    For security reasons, the "root" user should never be used for this or any other web based application. For this reason, the plug-in will not allow to use "root" as the database user name.

    It is recommended that you configure a new database user specifically for use by the plug-in and only give it SELECT access on your SAM Database.
    The plug-in does not need, nor would it make use of, any other privileges.

  5. The option for "Show Queue Time" will display a message to inform one of seven different messages to give your visitors a general idea of how long the queue is, but not a specific queue time. (Default is YES)
  6. You may manually specify the post ID's of pages you have already set up to hold your play list and top requests list. If these are left blank (or if the specified posts do not exist), new posts will automatically be created containing the proper shortcodes when you save your options.

Requires: 3.5.0 or higher
Compatible up to: 4.2.12
Last Updated: 2 years ago
Active Installs: 200+


3.2 out of 5 stars


Got something to say? Need help?


Not enough data

0 people say it works.
0 people say it's broken.

100,1,1 100,1,1 100,1,1
100,1,1 100,1,1
100,1,1 100,1,1 100,1,1
100,2,2 100,1,1 50,2,1 100,1,1 100,1,1
100,1,1 100,1,1 100,1,1