Dev side
Introduction
Provider information file
List file
Search file
Submit link
Example code
Introduction
Ultra Store Links go to a XML file, called the Provider file. This file give all informations the sofware need to install the provider. This contains at least a name, a code (identifier), URL of the website, URL of this file (for updates), URL of the List file, ...
Then the List file (also in XML) give the list of songs available. The search file (optional) is built with the same structure.
So for this you'll need a web hoster. If it supports PHP/MySQL or equivalent, it will allow you to make dynamic generation of list (obligatory for search). There will just be few files, so a simple and free hoster may be sufficient. You'll probably host covers too, but it's not a really big deal. If you also host ZIP song files then you'll need a big bandwidth, but as the software allow mediafire.com and megaupload.com links, you can avoid the use of this amount of bandwidth.
Provider file
Here is the example of the XML Provider file of this site (usdxfreefr.xml) :
<?xml version="1.0" encoding="UTF-8" ?>
<provider version="1">
<title>Usdx.free.fr</title>
<code>usdxfreefr</code>
<link>http://usdx.free.fr/songs/</link>
<update>http://usdx.free.fr/ultrastore/usdxfreefr.xml</update>
<data>
<list>http://usdx.free.fr/ultrastore/list.php</list>
<search method="POST" varname="s">http://usdx.free.fr/ultrastore/search.php</search>
<ads>http://usdx.free.fr/ultrastore/ad.php</ads>
<password method="POST" varlogin="login" varpassword="password" register="http://usdx.free.fr/ultrastore/register.php" />
</data>
</provider>
First line is standard XML information, just copy it. Next is the root element, let version parameter to "1".
Title :
This is the name of your site. It will be displayed on top of the list of covers. You can use chars you want (except those who will make problems with XML like & or é)
Code :
This is the identifier of your link. It must be the same as the filename. Use only chars and numbers, no space ! Try to make something unique as two links with same code will overwrite.
Link :
The URL of your website. It's displayed under the list of covers.
Update :
The URL of this file.
Data/List :
The URL of the list file. It can be a static file or a dynamic one. You can use a HTTP-redirected link. It must return a XML file as described in the next section.
Data/search : (optional)
The URL of the search file. It must be a dynamic file. You can use a HTTP-redirected link. It must return a XML file as described in the next section. You can use GET or POST method to search the string searched. The varname parameter is the name of the variable containing this string ; it's send in post data (POST method) with format <varname>=<search string> or in the URL (GET method) with format <search URL>?<varname>=<search string>
Data/Ads : (optional)
The URL of a HTML file. You can use a HTTP-redirected link. It will be displayed at the top of the download page. If you don't wan't to put ads, you can make an information page instead or leave this field blank
Here is an example of the file :
<html><head></head><body bgcolor="224E7F" style="margin: 2px;">
<!-- your ad code, max format : 728x90 -->
</body></html>
Data/password : (optional)
If you want to password-protect your link, add this tag to data tag. You can use GET or POST method to get the login/password. Varname work the same way as search varname. The register param contain the URL to the register page (or any information page). User will ave a link to this when the login form is prompted.
List file
<?xml version="1.0" encoding="UTF-8" ?>
<list version="1">
<song id="1" lastupdate="03/07/08" video="yes">
<title>Title</title>
<artist>Artist</artist>
<link>http://localhost/USdx/ultrastore/red.php</link>
<cover>http://localhost/USdx/songs/covers/en/c-c.jpg</cover>
<author>Author</author>
<clicks>2</clicks>
</song>
<song id="2" lastupdate="03/07/08">
<title>Title2</title>
<artist>Artist2</artist>
<link>http://www.megaupload.com/?d=GDENB2M9</link>
<cover>http://localhost/USdx/songs/covers/fr/vp-di.jpg</cover>
<author>Author</author>
<clicks>5</clicks>
</song>
</list>
First line is standard XML information, just copy it. Next is the root element, let version parameter to "1".
Song :
You have a song tag for each song. In this example there is just 2 songs but you will have more. As it's always the same pattern, a dynamic generation is easy to use.
id parameter must be unique. It can be number or letters (no space).
lastupdate is the date the file have been added or updated.
If you don't store this information, just write a static date (don't use now() or songs will always be marked as updated !).
Date must be at dd/mm/yy format (include 0 if there is only one figure).
video indicates if the videoclip is embedded on the zip file; value : "yes" or "no" (if not mentionned, assumed to "no").
Note : If you use a password system, and no login/wrong login is given, reply with an empty list
Title :
The title of the song. You can use chars you want (except those who will make problems with XML like & or é)
Artist :
The artist of the song. You can use chars you want (except those who will make problems with XML like & or é)
Link :
The URL of the zip file. It can be a direct link, of a mediafire.com/megaupload.com link, or a HTTP-redirection to one of this kind of link (for instance you can link to a PHP page that add a click count to the database and then redirects to the file)
Cover :
The URL of the cover picture. It will be read only once, as it's stored in cache.
Author :
The name of the author. If you don't have it you can let it blank.
Clicks :
The number of times this file had been downloaded (for Sort by Popularity function). If you don't specify it, 0 is assumed.
You can take a look at Example code.
Search file
It return the same file as the list file, but restricted to song that match the search string.
You can take a look at Example code.
Submit link
You can Contact me to add you list on the Ultra Store Links list page. But remember you can publish link without me.
Example code
All this examples are for a PHP/MySQL based website, but you can easily translate it to another language.
list.php
<?php echo '<'.'?xml version="1.0" encoding="UTF-8" ?'.'>'; ?>
<list version="1">
<?php
require("db.php");
$res = db_getsonglist();
function remove_special_char($str){
$str=str_replace('&', 'and', $str);
$str=str_replace('é', 'e', $str);
$str=str_replace('è', 'e', $str);
$str=str_replace('ê', 'e', $str);
$str=str_replace('à', 'a', $str);
return $str;
}
//if (($_POST['login']=='thelogin') && ($_POST['password']=='thepassword')){
while ($occ = mysql_fetch_array($res))
{
echo '<song id="'.$occ['ID'].'" lastupdate="'.$occ['DATEFORMAT'].'" video="yes">';
echo '<title>'.remove_special_char($occ['TITLE']).'</title>';
echo '<artist>'.remove_special_char($occ['ARTIST']).'</artist>';
echo '<link>'.$occ['URL'].'</link>';
echo '<cover>http://usdx.free.fr/songs/covers/'.$occ['COVER'].'.jpg</cover>';
echo '<author>'.$occ['AUTHOR'].'</author>';
echo '<clicks>'.$occ['CLICKS'].'</clicks>';
echo '</song>';
}
//}
?></list>
List SQL query (you may need to adapt to your table, but the DATE tool may be useful for you)
SELECT `ID`,`URL`,`TITLE`,`ARTIST`,`COVER`,`CAT`,DATE_FORMAT(`ADDED`,'%d/%m/%y') AS DATEFORMAT,`CLICKS`
FROM SONGS
ORDER BY ADDED DESC
Search SQL query (you may need to adapt to your table)
$sql = "SELECT `ID`,`URL`,`TITLE`,`ARTIST`,`COVER`,`CAT`,DATE_FORMAT(`ADDED`,'%d/%m/%y') AS DATEFORMAT,`CLICKS` ";
$sql .= "FROM SONGS WHERE TITLE LIKE '%".$s."%' OR ARTIST LIKE '%".$s."%' ; ";
search.php (extract)
$s = $_POST['s'];
$res = db_liste_songs_search($s);
redirect.php
<?php
$songid = $_GET['id'];
require("db.php");
db_addclick($songid);
$res = db_get_song($songid);
header("Status: 301 Moved Permanently", false, 301);
header("Location: ".$res['URL']);
?>
(remember headers must be set before any HTML tag, in a redirect page you may not have to write HTML though)
If you still need help, contact me.
