{"id":25803,"date":"2013-10-23T01:24:43","date_gmt":"2013-10-23T01:24:43","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/ngs-sam-integrator\/"},"modified":"2015-06-16T11:18:03","modified_gmt":"2015-06-16T11:18:03","slug":"ngs-sam-integrator","status":"closed","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/ngs-sam-integrator\/","author":12336098,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.3.9","stable_tag":"1.3.9","tested":"4.2.39","requires":"3.5.0","requires_php":"","requires_plugins":"","header_name":"NGS SAM Integrator","header_author":"Steve Williams","header_description":"","assets_banners_color":"050505","last_updated":"2015-06-16 11:18:03","external_support_url":"","external_repository_url":"","donate_link":"http:\/\/www.netguysteve.com\/sam-integrator","header_plugin_uri":"http:\/\/www.netguysteve.com\/sam-integrator\/","header_author_uri":"http:\/\/www.netguysteve.com\/","rating":3.2,"author_block_rating":0,"active_installs":10,"downloads":5038,"num_ratings":0,"support_threads":1,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":{"1.3.9":"<p>Added setting for art folder, linkable icons for popular players, and &#039;Playing Now&#039; text color option.<\/p>","1.3.8":"<p>Added &quot;Playing Now&quot; Widget and options to fulfill request. Further edits planned for the future\nto add more features and funcitonality such as stream link buttons and icons.<\/p>","1.3.7":"<p>Enable\/Disable feature added for song information widgets<\/p>","1.3.6":"<p>Album Art feature added<\/p>","1.3.0":"<p>NEW FEATURE: Request Throttle for Unregistered Users\n Improved Error Handling<\/p>","1.2.1":"<p>Reorganized Settings Page into Tabs\nFixed Minor Bug in Custom Status Messages<\/p>","1.2.0":"<p>Added Customizable Status Messages<\/p>","1.1.1":"<p>Fixed an error in the error trapping of SAM errors<\/p>","1.1.0":"<p>3 New Widgets and 2 New Shortcodes Introduced<\/p>","1.0.2":"<p>NON-CRITICAL : Removal of Blank Widget<\/p>","1.0.1":"<p>Initial Stable Release<\/p>"},"ratings":{"1":"2","2":0,"3":0,"4":"1","5":"2"},"assets_icons":[],"assets_banners":{"banner-772x250.png":{"filename":"banner-772x250.png","revision":"792224","resolution":"772x250","location":"assets"}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.1","1.0.2","1.1.0","1.1.1","1.2.0","1.2.1","1.3.0","1.3.4","1.3.5","1.3.6","1.3.7","1.3.8","1.3.9"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":"793754","resolution":"1","location":"assets"},"screenshot-2.png":{"filename":"screenshot-2.png","revision":"793754","resolution":"2","location":"assets"},"screenshot-3.png":{"filename":"screenshot-3.png","revision":"793754","resolution":"3","location":"assets"}},"screenshots":{"1":"The Top Requests Widget (Available in Version 1.1.0 and Higher)","2":"The Recently Played Tracks Widget (Available in Version 1.1.0 and Higher)","3":"The Upcoming Tracks Widget (Available in Version 1.1.0 and Higher)"}},"plugin_section":[],"plugin_tags":[12823,45959,45958,582],"plugin_category":[],"plugin_contributors":[88214,88213],"plugin_business_model":[],"class_list":["post-25803","plugin","type-plugin","status-closed","hentry","plugin_tags-broadcasting","plugin_tags-internet-radio","plugin_tags-sam-broadcaster","plugin_tags-streaming","plugin_contributors-arcain6","plugin_contributors-netguysteve","plugin_committers-arcain6","plugin_committers-netguysteve"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/ngs-sam-integrator_050505.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/ngs-sam-integrator\/assets\/screenshot-1.png?rev=793754","caption":"The Top Requests Widget (Available in Version 1.1.0 and Higher)"},{"src":"https:\/\/ps.w.org\/ngs-sam-integrator\/assets\/screenshot-2.png?rev=793754","caption":"The Recently Played Tracks Widget (Available in Version 1.1.0 and Higher)"},{"src":"https:\/\/ps.w.org\/ngs-sam-integrator\/assets\/screenshot-3.png?rev=793754","caption":"The Upcoming Tracks Widget (Available in Version 1.1.0 and Higher)"}],"raw_content":"<!--section=description-->\n<p>The NGS SAM Integrator is a WordPress Plug-In designed for users of Spacial Audio\u2019s \nSAM Broadcaster software.   It allows you to set up a section on your WordPress \nsite which integrates directly with your SAM Broadcaster Pro software, allowing \nyour visitors to make requests whether you are DJing live or not.<\/p>\n\n<p>It has been tested with and confirmed to work with SAM Broadcaster installations\nusing the MySQL database system.  Other database systems have not been tested,\nnor can this plug-in be verified to support them.  If you find the plug-in\nworks as-is with other the other database systems which SAM supports, please\nlet me know.<\/p>\n\n<p>Detailed documentation and information about upcoming features available at <a href=\"http:\/\/www.netguysteve.com\" title=\"Net Guy Steve\">the \ndevelopment site<\/a>.<\/p>\n\n<!--section=installation-->\n<h4>BEFORE YOU INSTALL THE PLUG-IN<\/h4>\n\n<p>Before you install the WordPress plug-in, you will need to configure both SAM \nBroadcaster and your mySQL database to allow your webserver to access them.<br \/>\nIt is highly recommended that you set up a mySQL user specifically for use by \nthe plug-in.  This user only requires SELECT access on the songlist, requestlist, \nand queuelist tables of your SAM database.  It does not require any global access \nprivileges, nor does it need to be able to modify any data in your database.<\/p>\n\n<p>For security reasons, the plug-in will NOT allow you to use the \u201croot\u201d user, even \nif you have configured it to be allowed external access.  For instructions on how \nto add a new mySQL user, please see http:\/\/dev.mysql.com\/doc\/refman\/5.1\/en\/adding-users.html.<\/p>\n\n<p>It is also recommended that you take steps to secure your installation of mySQL \nbefore allowing external access by this, or any other application or user.   For \ninformation on how to secure your mySQL installation, please see \nhttp:\/\/www.mysql.com\/why-mysql\/white-papers\/a-guide-to-securing-mysql-on-windows\/.<\/p>\n\n<p>There are lot of different options you configure in SAM Broadcaster related to how \nit handles incoming requests.  Most of these are fairly self explanatory and can \n(and should) be adjusted over time to best suit your own needs as well as those \nof your visitors.   I will only cover those settings which are necessary to allow \nthe plug-in to function.<\/p>\n\n<ol>\n<li>In SAM Broadcaster, click <strong>File &gt; Config<\/strong> and select <strong>Request Policy<\/strong>.<\/li>\n<li>Make sure that <strong>Enable Requests<\/strong> is checked.<\/li>\n<li>You will see a list entitled <strong>Only accept requests from these IP addresses<\/strong>.<br \/>\nThe default IP addresses in that list are mostly associated with Audiorealm, \nwhich is the site that Spacial Audio uses to process requests if you choose not \nto process them yourself.  This plug-in processes all request internally so you \nwill need to add your webserver\u2019s IP address to this list.  It is recommended, \nwhen possible, that you use the IP address rather than the domain name here.   <\/li>\n<\/ol>\n\n<p>For information on the additional Request Policy settings in SAM Broadcaster, \nplease see your SAM Broadcaster documentation or integrated help files.<\/p>\n\n<p>You will also need to ensure that your firewall and\/or router are configured to \nallow incoming connections on the proper ports for MySQL and SAM Broadcaster.  By \ndefault, these ports are 1221 for SAM Broadcaster and 3306 for MySQL.<\/p>\n\n<p>Once this is done, the hard part is out of the way.  Installation and configuration \nof the plug-in itself is very easy and straight forward.<\/p>\n\n<h4>Album Art<\/h4>\n\n<ol>\n<li>Add folder to root directory of your wordpress called \"sam\"<\/li>\n<li>chmod 777 sam folder<\/li>\n<li>setup sam broadcaster to upload album art images to this folder.<\/li>\n<\/ol>\n\n<h4>Manual Installation Instructions<\/h4>\n\n<ol>\n<li>Upload the NGS SAM Integrator Plug-In to your Wordpress Site and Activate it<\/li>\n<li>Open the NGS SAM Integrator Settings<\/li>\n<li>Enter Your SAM Broadcaster details including the host address and port \nwhere the SAM Broadcaster client is running.<\/li>\n<li><p>Enter the Connection Details for your SAM Broadcaster Database.<\/p>\n\n<p>For security reasons, the \"root\" user should never be used for this or any \nother web based application.  For this reason, the plug-in will not allow\nto use \"root\" as the database user name.<\/p>\n\n<p>It is recommended that you configure a new database user specifically for\nuse by the plug-in and only give it SELECT access on your SAM Database.<br \/>\nThe plug-in does not need, nor would it make use of, any other privileges.<\/p><\/li>\n<li>The option for \"Show Queue Time\" will display a message to inform one of\nseven different messages to give your visitors a general idea of how long\nthe queue is, but not a specific queue time.  (Default is YES)<\/li>\n<li>You may manually specify the post ID's of pages you have already set up to\nhold your play list and top requests list.  If these are left blank (or if\nthe specified posts do not exist), new posts will automatically be created\ncontaining the proper shortcodes when you save your options.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt>Will I need to make CSS modifications in order for the plug-in to work with my Theme?<\/dt>\n<dd><p>The plug-in minimizes the use of internal formatting, allowing your theme to \ndetermine as much about the appearance as possible.  This should allow the plug-in\nto look nicely integrated with your site, regardless of the theme used, providing\nthe theme conforms with the standards for Wordpress themes, and makes proper use\nof hooks.<\/p>\n\n<p>All NGS SAM Integrator pages which appear on the front-end of your site are\ncontained with a div wrapper with the class \"ngssamintegrator\".  You can modify\nthe included CSS file to your liking to format these pages, if you desire.<\/p><\/dd>\n<dt>Does the plug-in support saving configurations for more than one DJ?<\/dt>\n<dd><p>While this is planned for a future version, the current version only supports\nsaving the details for a single SAM Broadcaster client.<\/p><\/dd>\n<dt>I am getting the message \"Authorization failed. IP not in allowed list.\"<\/dt>\n<dd><p>Believe it or not, this message is a good thing.  It means the plug-in is \nproperly configured and working.  This message is generated by the SAM \nBroadcaster client, so if you're seeing it, it means that your webserver and \nSAM Broadcaster client are successfully talking to one another.<\/p>\n\n<p>For security reasons, SAM Broadcaster will only accept incoming connections from \nIP addresses you permit.  You need to add the IP address of your webserver \n(which will be included in the error message) to SAM Broadcaster's allowed IP \nlist.  You can find this under \"File-&gt;Config-&gt;Request Policy\" in your SAM \nBroadcaster client.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.3.9<\/h4>\n\n<ul>\n<li>Added \"Album Art Directory\" setting to album art settings page\n\n<ul>\n<li>Use the setting to tell the plugin where your album art folder is located.<\/li>\n<\/ul><\/li>\n<li>Moved settings for \"Playing Now\" widget to it's own tab<\/li>\n<li>Added link settings and icons for popular players of streaming music\n\n<ul>\n<li>Now you can embed links to playfiles for your stream in the \"Playing Now\"\nwidget. Common filetypes are:\nPLS -&gt; For Winamp and VLC\nASX -&gt; For Windows Media Player\nQTL -&gt; For QuickTime and RealPlayer\nRAM -&gt; For iTunes<\/li>\n<\/ul><\/li>\n<li>Added color setting for \"Playing Now\" text.\n-when Linked Icons for players is disabled the \"Playing Now\" text becomes \nvisible, this setting will allow you to change that color to suit your theme.\n    - will accept default CSS color names, such as white, blue, red, etc...\n    - will accept full HTML color color palette (eg. #FFFFFF == white)<\/li>\n<\/ul>\n\n<h4>1.3.8<\/h4>\n\n<ul>\n<li>Added \"Playing Now\" Widget and options.\n\n<ul>\n<li>With the new widget, you can use it to display the track currently playing.<\/li>\n<\/ul><\/li>\n<\/ul>\n\n<h4>1.3.7<\/h4>\n\n<ul>\n<li>Enable\/Disable feature added for song information widgets\n\n<ul>\n<li>You can now enable and disable song information within the widgets<\/li>\n<\/ul><\/li>\n<\/ul>\n\n<h4>1.3.6<\/h4>\n\n<ul>\n<li>NEW FEATURE: Album Art\n\n<ul>\n<li>Now you can upload your album covers to the site, and decide if you want\nto show them in the widgets and request pages<\/li>\n<\/ul><\/li>\n<\/ul>\n\n<h4>1.3.0<\/h4>\n\n<ul>\n<li>NEW FEATURE: Request Throttle for Unregistered Users\n\n<ul>\n<li>Settings mimic SAM Broadcaster Pro configuration but only affect\nunregistered users<\/li>\n<li>Some request data is now stored directly in the Wordpress database so that\nthrottling can be handled completely by the web server without touching the\nSAM client or database.<\/li>\n<li>Requests are now associated with users.  This will be used later to implement\nadditional features like personal request histories.<\/li>\n<li>Requests for unregistered users can be completely disabled by setting the\ndaily limit to zero (0).<\/li>\n<\/ul><\/li>\n<li>Improved Error Handling<\/li>\n<\/ul>\n\n<h4>1.2.1<\/h4>\n\n<ul>\n<li>Reorganized the Settings Page into Tabs.  There are now three separate\ntabs.\n\n<ul>\n<li>Connections - SAM Client and SQL Database Settings<\/li>\n<li>Pages - Page IDs and other page display options<\/li>\n<li>Status Messages - Custom Status Messages when a request is rejected.<\/li>\n<\/ul><\/li>\n<li>BugFix : The Custom Status messages for Song and Artist were reversed.<\/li>\n<li>Compatibility: Changed the implementation used to initialize the widgets in\n order to ensure better compatibility with outdated themes and PHP versions.<\/li>\n<\/ul>\n\n<h4>1.2.0<\/h4>\n\n<ul>\n<li>Added Customizable Status Messages (Feature Request from JTMVK )<\/li>\n<\/ul>\n\n<h4>1.1.1<\/h4>\n\n<p>BUGFIX: Fixed a bug in the error trapping logic.<\/p>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Added songsearch shortcode.<\/li>\n<li>Added toplist shortcode.<\/li>\n<li>Added Top Requests Widget<\/li>\n<li>Added Upcoming Tracks Widget<\/li>\n<li>Added Recently Played Tracks Widget (Includes currently playing track)<\/li>\n<\/ul>\n\n<h4>1.0.2<\/h4>\n\n<p>Removed some preliminary test code that was inadvertently included in the initial\nrelease.  The code in question generated a blank widget.  Widgets are still being\nworked for a later release (Likely the 1.1 release).<\/p>\n\n<h4>1.0.1<\/h4>\n\n<p>Initial Public Release<\/p>","raw_excerpt":"Plug-in to integrate SAM Broadcaster with your Wordpress site","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/25803","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=25803"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/netguysteve"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=25803"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=25803"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=25803"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=25803"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=25803"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=25803"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}