Skloogs Reverb

This wordpress plugin allows the display of the various ReverbNation widgets on your blog’s posts,
pages or sidebars, simply and efficiently, by the use of the [reverb] markup.

IMPORTANT:
This plugin has been handled over to the ReverbNation team. Please use the new version
here

About label, artist, venue fan and store IDs

For the moment, you have to find these IDs as explained hereafter. I’ll soon update the plugin so that you can
enter directly your URL or shortname, but in the meantime you have to enter the corresponding IDs.

To find one ID, just visit your artist, label, fan, or venue page and check any of the red title
links (Bio, New Releases, Artist Roster, About…). The link should end with a 5 or 6 digits number: that is your ID.

By default, your artist ID will be used in the widgets, and if it’s missing the label ID will be,
or your venue ID, or your fan ID, in this order.

In the next version of this plugin, you will have the ability to fill all available IDs and
still be able to decide which corresponding widget to display (artist, venue, label…)

Regarding the store ID, the procedure is a bit trickier, unfortunately. You will have to go to your
ReverbNation account, look for the Store Widget (in the Widgets section), click on “Get Widget” and
inspect the “Embed code” display: at the third visible line you will see something like userId=
followed by a 5 digits number and an ampersand (&) sign. The store ID is that 5 digits number.

I know this is a little inconvenient, but be patient: I’ll ease things as soon as possible.

Syntax and currently supported options

The plugin syntax is quite basic. Use [reverb <widgets>] at the right place
you want to see the widget.

The <widgets> parameter is a comma separated list of RN widgets and their
and possible options. The options are separated from the widget name by an = character and from one another by the |
character. Additionally, an option can take an argument after the : character.

The widgets are:

• tunes
• shows
• largeshows
• blogshows
• showsmap
• player
• miniplayer
• microplayer
• blogplayer
• videos
• fans
• blogfans
• streetteam
• store
• grabbox
• press
• fanexclusive
• playerpro
• videospro
• showspro
• presspro
• fanspro
• charts

The options are as follows:

• a -> autoplay [true|false]
• s -> shuffle [true|false] (e.g: s:true)
• b -> blog/buzz [blog|buzz] (e.g: b:blog)
• d -> display mode [list|details|smart] (e.g: d:smart)
• w -> widget width (e.g.: w:300)
• h -> widget height (e.g.: w:150)
• sz -> widget size (overrides w and h parameters) [standard|blog|mini|micro|custom]
• bg -> widget background color, as an hex value (6 hex digits) (e.g.: bd:e8b332)
• tx -> widget text color, same syntax as bg
• bd -> widget border color, same syntax as bg
• sm -> showmap [true|false] (e.g: sm:true)
• st -> streetteam [true|false] (e.g: st:true)
• sk -> skin [classic|seamless|tiny|strong|electrogreen|sketched|bigbutton|bigbuttonlight] (e.g: sk:tiny)
• wm -> widget mode [opaque|transparent] (e.g: wm:opaque)
• P -> playlist [playlist_ID]
• S -> song [song_ID]
• A -> artist [artist_ID]
• L -> label/manager [label_ID]
• F -> fan [fan_ID]
• V -> venue [venue_ID]

Now some examples:

• If I’d like a TuneWidget with autoplay and shuffle active and showing my buzz first,
  this would be the syntax: [reverb tunes=a:true|s:true|b:buzz]

• Now if I’d like a ShowsWidget with a bordeaux background, yellow text and a smart display,
  I’ll use: [reverb shows=bg:840a0a|tx:fffe25|d:smart]

Be careful not to mistakenly switch between options (|) and shares (,) separators!!
The comma is used to separate different widgets. Note that having several widgets displayed
within the same tag can lead to their unexpected display (side-by-side, or one below the other…)
according to the stylesheet your blog is using.
For more clarity, you can also use a space instead of or in addition to the comma.
e.g.: [reverb blogshows=bg:e0e0e0|tx:000000, videos, tunes=s:false|a:true]

If you get a frame with just the plugin’s copyright, you probably did it wrong…

As a final note, please remember that only the tag is written to the WordPress DB,
the presentation being made at the time the page is displayed to the users (or saved into the
cache). So you’ll always be able to re-edit your page/post to change the options.

Support

To get support on the installation and/or use of this plugin, please comment on the
plugin page. Do not send
an email, because your problem can be someone else’s problem too, and I cannot afford
answering each one personally, except in the comments section of the plugin page. Thanks!

Alternatively, and maybe preferably, you can become fan of this facebook page
ReverbNation
WordPress Plugin that I’m currently maintaining.

About the author

Philippe Hilger is a french engineer, IT consultant and developer, living in Rio de Janeiro, Brazil.
He’s been playing keyboards since the early 80’s as an independent musician and founded the PeerGum
band at the end of 2009.

He’s already developed 3 plugins for WordPress: Trader, MegaSena and now ReverbNation.

Philippe also maintains several blogs: one dedicated to technology and communication and another one
dedicated to Macs; he also builds, designs and hosts various other blogs on a WordPress MU site he
maintains at http://www.skloogs.com. Did you know you could have your own blog there, too?

Versions Notes

Version 1.0.4

• Inform your RN URL in the setup page, for the fan exclusive & grab box widgets to
  redirect properly to your RN page