===[ ABOUT ]=========================================================

Donate!Live 2.0
Second Life + MySQL based donation tracking system
Created by Shiny Iceberg in 2009
Shared under GNU General Public License


===[ CONTACT ]=======================================================

Second Life: IM to Shiny Iceberg
E-mail: shiny.iceberg@virtualmagazine.cz
WWW: http://donatelive.virtualmagazine.cz/


===[ PREREQUISITIES ]================================================

What you need to run Donate!Live
 * Rezzed donation box in Second Life with MODIFY permissions
 * Webserver with PHP and MySQL support


===[ HOW TO INSTALL ]================================================

Installation of server-side part
--------------------------------

  1. Copy a content of 'server-side' folder to your server to any folder, e.g. to http://www.myserver.com/donate/
     This represents the following files:
       * config.php
       * add.php
       * install.php
       * index.php
       * styles.css

  2. Edit config.php and edit the following lines according to your server settings:
       * $hostname ... most typically 'localhost' or other server where your database is located
       * $user ... username which you use to connect the database
       * $pass ... your password for database access
       * $dbase ... a name of your database on the server

  3. Run install.php by opening its URL, e.g. http://www.myserver.com/donate/install.php
     This step will create a new table in the database. If everything go well, you will be informed about successful completion.
     
  4. (OPTIONAL) Modify index.php and styles.css to fit your theme and web design.
     
Installation of Second Life part
--------------------------------

  1. Copy a content of script.lsl into clipboard
  
  2. Create a new empty script in Second Life in your donation box and paste the clipboard there
  
  3. Modify the following lines:
       * key rightOwner ... put there an UUID of avatar who will own the donation box and who will receive donated money
       * string myURL ... put there the URL of a server folder where are copied files, e.g. http://www.myserver.com/donate/

  4. Save the script and your donation box is ready to use
  

===[ ADDITIONAL INFORMATION ]========================================

The script in Second Life will cause the donation box to disappear if defined UUID in the script will not match actual owner.
This is a kind of protection from misuse of the donation box.


Good luck!
Your Shiny Iceberg