
PADKit 2.00.09

Welcome to the Association of Shareware Professional's PAD enabled download site
"kit". The intended purpose of the kit is to provide would-be shareware list
site webmasters with a proven code base to get started, and thus to promote
wider acceptance of the PAD standard throughout the shareware industry.

This "kit" is offered on an as-is basis - no warranty. The "kit" consists of
many files, contained within this compressed archive (hereinafter refered to
as "THE KIT"):

  http://www.padkit.com/pad_site_kit.zip


DISCLAIMER OF WARRANTY: THE ASSOCIATION OF SHAREWARE PROFESSIONALS DISCLAIMS ALL
WARRANTIES RELATING TO THE KIT, WHETHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT
LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR
PURPOSE. NEITHER THE ASSOCIATION OF SHAREWARE PROFESSIONALS NOR ANYONE ELSE WHO
HAS BEEN INVOLVED IN THE CREATION, PRODUCTION, OR DELIVERY OF THE KIT SHALL BE
LIABLE FOR ANY INDIRECT, CONSEQUENTIAL, OR INCIDENTAL DAMAGES ARISING OUT OF THE
USE OR INABILITY TO USE THE KIT, EVEN IF THE ASSOCIATION OF SHAREWARE
PROFESSIONALS HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR CLAIMS. THE
PERSON USING THE KIT BEARS ALL RISK AS TO THE QUALITY AND PERFORMANCE OF THE KIT.


Getting Started

NOTE: Your web host must provide both PHP and MySQL. It is also strongly
recommended that you have both set up locally, for debugging. Help with any of
this is beyond the scope of this document.

Unzip the downloaded file where your local machine's web service can run PHP and
MySQL. You will get the following:

Files in root directory:

  dict.php        MUST be modified, see comments within
  dbcreate.php    MUST be modified, see comments within (or use mySQLAdmin)
  dbcreate.sql    for use with mySQLAdmin, instead of dbcreate.php
  hello.php       not part of the site, but very useful - see comments within
  contact.php     should be modified to suit your site
  footer.php      should be modified to suit your site
  header.php      should be modified to suit your site
  index.php       should be modified to suit your site
  policy.php      should be modified to suit your site
  ybh.gif         sample graphic (replace)
  addpad.php      no modifications required
  removepad.php   no modifications required
  showpads.php    no modifications required
  submit.php      no modifications required
  styles.css      no modifications required
  checkadd.php    no modifications required
  duptest.php     for set-up only - forces renaming db & new password
  category.txt    no modifications required
  pix1.gif        filler graphic (needed)
  readme1st.txt   this file

Files in 'pad-sysop' subdirectory of root

  padpoll.php     MUST be modified, see comments within
  activity.php    no modifications required
  backup.php      no modifications required
  dupecheck.php   no modifications required
  index.php       no modifications required
  padpoll2.php    no modifications required
  nopoll.php      no modifications required
  query.php       no modifications required


Step 1)	Make sure that you have php up and running at your web host by testing
        with 'hello.php'. If you don't, stop and fix that.

Step 2)	Make sure you have mySQL up and running at your web host.

Step 3)	Create a mySQL database at your web host with either the enclosed
        'dbcreate.php' file, or directly through the mySQLAdmin console at your
		web site's control panel. Create a user for the db, and make a note of
		the user's name, password, and the name of the db. Note that your web
		site's mySQLAdmin console may change the names on you.

Step 4)	Edit 'dict.php' to reflect the username, password, and database name you
        just created.

Step 5)	FTP everything contained in this package to your web host (preserving
        the directory structure), and see if it works by opening 'index.php' in
		your web browser.


Security Considerations

- Delete the hello.php and dbcreate.php files once everything is up and running.
- Restrict access to the pad-sysop subdirectory by, for example, a .htaccess file
- Subscribe to the PAD RSS Feed on http://www.asp-shareware.org to get notified
  of security alerts and updates on PADKit.


Upgrade Instructions

Please note that, when updating, you can search through the files for stamps
like "v1.50.03", "v2.00.01" and so on, to see additions/changes and simply make
those changes in your files, without replacing your existing layout.

Additional instructions for upgrades from versions older than v2.00.04:
- Increase the size of the category field in the paddata table to 80. You can
  optionally run this SQL command:
    ALTER 'paddata' ALTER COLUMN 'category' VARCHAR(80)

Additional instructions for upgrades from versions older than v2.00.05:
- category.txt has also been updated


Notes:

Please visit news://news.asp-shareware.org/asp.pad_support and share your
experiences with the kit.