paJRShare Demo

Thank you for visiting this support site - What is paJRShare all about then?

paJRShare is a Jamroom Module that can be installed on Jamroom systems version 4 and above. It provides a means for different Jamroom installations to share their database information (artists, members, songs, videos, etc.) with other Jamroom sites by using the Jamroom ranking call ({jr_ranking...}) in a site's skin and theme templates, just as one would to call your own, local, database information. After installing this module on a Jamroom site, it is configured with 'Servers' and 'Clients'. Servers are Jamroom sites that want to share their data and have their Server URL, System Name (optional), Share Key and a 'share ID' configured. The 'Server' site is similarly configured to allow specific Clients to access it. Clients are configured with their System Name (optional), their Share Key and 'Share ID'. Share Keys and Share IDs on paired Servers and Clients must match to allow and verify communication (Share Key is a 'back end' verification whilst Share ID is part of the ranking call).
When you enter the module configuration, you'll notice that there are already a Server and Client pair pre-loaded with a random Share Key and a Share ID of 'local'. This is so your Jamroom system can talk to itself via this module. Why would it want to do that when one could use a normal ranking call? Read on....

Once you have your Server and Client pair configured, the info below shows how to use {jr_ranking...} and this module on the Client Jamroom.

This demo site is configured with 'dummy' artists, songs and videos. Doing a 'normal' ranking call, we get -

(This looks a bit messy because its using the default skin jr_ranking_row.tpl template without the benefit of header and footer templates to sort out the formatting).

Now we'll do the same again but using this module -

(Note that the iframes on this demo site use the ranking url http://www.paulasher.com/paJRShareSupport/ranking.php?mode=.... The examples below show how to do the same thing in skin and theme templates using {jr_ranking....}).

The above uses the ranking call {jr_ranking mode="paJRShare" share_id="local"}. OK, its exactly the same as the first example but the process has been forced through the paJRShare module.

Now let's try adding some different parameters, particularly a template to make things look a bit better -

{jr_ranking mode="paJRShare" share_id="local" share_mode="song" show="10" row_template="paJRShareSupport_row.tpl"}

OK, a pretty simple template, but you get the idea.

Now let's get more ambitious. Motagator is a live Jamroom site that has been installed with this module. Its been configured as a Server on this site and respectively, Motagator has this site configured as a Client. Let's try it with the 'motagator' Share ID and also add in the random song order (11) -

{jr_ranking mode="paJRShare" share_id="motagator" share_mode="song" show="10" order="11" header_template="paJRShareSupport2_hdr.tpl" row_template="paJRShareSupport2_row.tpl"}

There you go - real artists and songs from a live, remote Jamroom site.

Now to get really clever. Want to combine data from your site and remote sites? Just comma seperate the Share IDs -

{jr_ranking mode="paJRShare" share_id="local,motagator" share_mode="song" show="3" order="11" row_template="paJRShareSupport4_row.tpl"}

Three sites? No problem, GigMemories is another live site with plenty of videos, so lets combine that site with Motagator and this local site -

{jr_ranking mode="paJRShare" share_id="gigmemories,local,motagator" share_mode="video" show="10" order="11" row_template="paJRShareSupport3_row.tpl"}

By default, action, artist, blog, channel, comment, content, event, fan, member, photo, radio, song, store, vault and video ranking modes are supported (as 'share_mode'), and in its configuration, the Server can specify which modes a Client may use. Additional ranking modes, and all the mode variables that the module will respond with, can be added, deleted, and edited using the 'Ranking Variable Manager' that is included with this module. Also as default, all mode variables, as specified in the Jamroom ranking documentation, are returned for use in Client skins and themes (including two extra ones - $DONAR_NAME and $DONAR_URL which hold the Server system name and its URL). All the 'main' ranking order options are available for use (and use the standard Jamroom number values), there are some, however, unavailable and if requested, data pertaining to the default 'order=1' will be returned.

Now you know what paJRShare is all about, take a look at "Pseudo Motagator". This is a standard Jamroom installation but with no artists, members, songs, videos etc. Instead, all the ranking calls in the skin templates have been modified to call a Server set up on the live Motagator site thereby creating a 'pseudo' Motagator website. Hopefully this will demonstrate the possibilities of this module.

Let me have any thoughts, comments or suggestions for this module - paul@motagator.net

Cheers Pa

Stats - Artists: 50