Protocol

PADmap format

The PADmap format consists of full PAD URLs in plain text mode, one URL per row. No other types of text (comments, empty rows, html tags, javascript blocks etc.) are allowed. All PAD URLs in a PADmap must be from a single host, such as www.yourdomain.com or subdomain.yourdomain.com. This is to ensure that all PAD URLs belong to the same author.

Sample PADmap

The following example shows a PADmap that contains 2 PAD URLs.

http://www.yourdomain.com/pads/software1_pad.xml

http://www.yourdomain.com/pads/software2_pad.xml

Specifying PADmap location

The location of PADmap should be specified inside PAD files from the same host. This will allow PAD-enabled download sites to know it by checking PADs in their databases for the appropriate field value, pick up your PADmap file and check the existing PAD URLs against PAD URLs from PADmap file to add missing ones to their databases.

The following node and its sub-nodes will be added to your PAD XML data under the root <XML_DIZ_INFO> node:

<PADmap>
    <PADmap_FORM>Y</PADmap_FORM>
    <PADmap_DESCRIPTION>
        Link to plain text file containing all your PAD URLs from current host
    </PADmap_DESCRIPTION>
    <PADmap_VERSION>1.0</PADmap_VERSION>
    <PADmap_URL>http://www.padmaps.org/padmap.htm</PADmap_URL>
    <PADmap_SCOPE>Company</PADmap_SCOPE>
    <PADmap_Location>http://www.yourdomain.com/pads/padmap.txt</PADmap_Location>
</PADmap>

Where <PADmap_Location> specifies the URL of a PADmap containing all your PAD URLs in plain text mode (for other fields descriptions please refer to the official PAD extensions specification by ASP-Software.org).

Note: if you store all your PAD files in the single directory on your server and have specified your PADmap as the PAD files’ directory index, you can specify the path to your PADs directory instead of the full path to your PADmap, e.g. http://www.yourdomain.com/pads/

Server configuration

There are no special requirements on PADmap file name and its server placement, however, if you host all your PAD files in the same subdirectory on your server, the best solution would be to place your PADmap right there and to make it the directory index.

If you use a server-side script for PADmap generation (see PADmap Kit in Resources section), you do not have to modify your server settings because index.php is accepted as directory index by default.

Otherwise, if you create your PADmap text file manually, you will have to create/modify .htaccess file in the appropriate subdirectory on Apache based servers by specifying your PADmap file as the directory index file, e.g.:

DirectoryIndex padmap.txt

Now, when someone opens your PAD files containing directory in his browser by removing the filename part of any of your PAD URLs, he will see the list of all your PAD URLs instead of error 403 page.