Query String Parameters for linking to the Search Results page directly
| Parameter |
Description |
Required |
Accepted Values |
| a |
Artist search Term |
Yes if no p param present |
characters or numbers |
| p |
Product search Term |
Yes if no a param present |
characters or numbers |
| gid |
GroupID |
Yes |
number |
| scol |
Sort by column number |
No |
number |
| sdir |
Sort direction (1 ascending, -1 descending) |
No |
number |
| r |
Rows to return per page of results |
No |
number |
| xsl |
XSL Url |
No |
valid URL to XSL, URL encoded |
| exact |
Exact Match Flag |
No |
1 for "yes" |
To find out which GroupID to use in the gid parameter, see the html source for the Groups drop down menu on the default MLM Search page.
Example 1
Display all mobile links within Group 11 (Verve Music Group) where artist name is like 'hargrove', format the results using the default XSL
http://mlm.aspdotnetstuff.com/v1/Default.aspx?scol=2&a=hargrove&gid=11&sdir=1&r=10
Example 2
Display all mobile links within Group 5 (UMG Nashville) where artist, or product name is like 'yearwood', and format the results using the XSL for http://mlm.aspdotnetstuff.com/v1/xsl/searchResultsUmgn.xsl
http://mlm.aspdotnetstuff.com/v1/Default.aspx?scol=2&a=yearwood&p=yearwood&gid=5
&sdir=1&r=10&xsl=http%3a%2f%2fmlm.umusic.com%2fv1%2fxsl%2fsearchResultsUmgn.xsl
Customizing the XSL template
The query string parameter "xsl" exists to allow the default XSL template to be overridden.
If you wish to build your own XSL template, a suggested starting point would be to download the default template from this address: http://mlm.aspdotnetstuff.com/v1/xsl/searchResultsDefault.xsl
The XSL is commented throughout. Basic presentation properties such as font and colour schemes can be changed by editing just the CSS section of the XSL near the begining of the file.
Many table structures in the XSL are divided into template fragments to make it easier to locate and adjust individual table cell contents such as the Preview and Purchase icons. (Template fragments are also the only way to render table rows with alternating colours after sorting the results)
Much of the XSL template parameters and conditional logic exists for handling sorting and paging and should not require altering.