Some new features have been added to the NGS SAM Integrator plug-in with the release of version 1.1. The new features include 2 new shortcodes and 3 widgets. It should be noted that as I discussed in this post, some users may see a drop in performance when using the widgets. This is completely dependant upon the hardware and internet connection used to host SAM Broadcaster.
The New Shortcodes
[songsearch] … [/songsearch]
The first new shortcode is the [songsearch] shortcode. As the name implies, it allows you to create a hyperlink to your song list, searching for a specified artist, title, or album. For example, if you were writing an article that mentioned AC/DC, you could use [songsearch]AC/DC[/songsearch] and it would create a link to a list of all of your AC/DC tracks.
You can also include an option “search” argument to search for something other than the literal text you are linking. For example, [songsearch search=”Pink Floyd”]my favorite band[/songsearch] would hyperlink the text “my favorite band” and link it to a list of Pink Floyd songs.
This shortcode will work for song titles and albums as well as artists. It does, of course, depend on the tags in your SAM Database being accurate.
The second new shortcode is [toplist]. This shortcode will allow you embed a short list of the most requested songs from your library into other content. By default, it will list the top five, but you can specify the number using an optional “num” parameter. For example, [toplist num=10] would list the top ten requests instead of the top five.
Top Request Widget
The first of the widgets is the Top Requests widget. Like the [toplist] shortcode, it will list the top five songs by default. The widget can be configured to list any number you like. The list is not hyperlinked for requesting.
Upcoming Tracks Widget
This widget will list the next five tracks in your queue. If a song was requested through the web-based request system, it will be marked with a ” ~requested~” tag. Like the Top Request Widget, it can easily be reconfigured to show more (or less) tracks.
Recently Played Widget
This widget displays a list of recently played tracks (including the current track). Like the Upcoming Tracks Widget, it will mark any tracks which were requests and, of course, the number of tracks can easily be reconfigured.