-------------------------------------------------------------
showlister :: a simple performance calendar management system
-------------------------------------------------------------

CURRENT VERSION
.01b

VERSION HISTORY
.01b    01/19/2003  Initial release

LICENSE
Showlister is distributed via the GNU Public License (GPL).  It's free as in 
freedom and as in free beer.  You're under no obligation to pay for it.  And, 
though I hope you'll find it useful, it is provided as-is, without any warranty 
whatsoever.  For more GPL details, see http://www.gnu.org.  

AUTHOR
wheat@wheatdesign.com
http://www.wheatdesign.com

DESCRIPTION
Showlister is designed for bands and other performers who need to be able to 
easily update their online performance calendar.  It's a simple web application 
that lets most anyone add, edit, and delete shows to a database.  A sample 
'shows' web page is included to demonstrate how to pull current shows from the 
database.  

DISTRIBUTION
http://showlister.sourceforge.net

REQUIREMENTS
Showlister requires a web server running PHP 4 and MySQL

INSTALLATION
1) Upload the showlister directory to your web server.  

2) You'll need to modify the "showlister_settings.inc" file to include the 
database name and database table name along with your MySQL connection 
settings (i.e. host, username, and password).  

3) Create a database (or a new table in an existing database).  Suggested 
names are in the "showlister_settings.inc" file (database name = "showlister"; 
table name = "showlister_shows" but you can use whatever you like (or, depending 
upon your web host, whatever you have to.  On mine, for instance, you have 
to prepend your username and an underscore to all database names).  Here's the 
SQL to create the table you'll need:

create table showlister_shows (
    show_id int(11) not null auto_increment,
    month int(2),
    day int(2),
    year int(4),
    location varchar(100),
    venue varchar(100),
    details varchar(100),
    primary key (show_id)
);

4) Create a directory on in your web document root folder (usually 'public_html') 
called 'admin' (or 'showlister' or something).  Put all of the showlister 
files except the sample page ('sample_shows_page.php') in this folder.  Make 
this a password protected folder (on Apache, you do this by creating 
an .htaccess file in the protected folder and running the htpasswd program to 
generate a password file.  Some hosts have scripts in place to automate this 
process for you.  If you're new to Apache, read up on .htaccess files at 
http://www.apache.org or search for an .htaccess tutorial with
http://www.google.com).  Put the sample page wherever you like, but don't 
leave it inside your showlister admin folder or any other protected folder.  
Put a copy of showlister.css in thethe same folder where you put your 
sample_shows_page (i.e. you'll need a copy in the admin folder and in whatever 
folder you use to store the sample page.

5) Fire up your web browser and load the index.php file to start adding 
your shows.  Then open up sample_shows_page.php in another tab or window.  
Refresh/reload that window to see your shows displayed.  Repeat as necessary

6) Rename the sample_shows_page.php to something reasable (like 'shows.php') 
and hack the showlister.css files to give the shows page and the admin 
interface a look you like.  

CUSTOM INSTALLATION
If you're clueless about servers and setting up databases, I can install 
showlister on your server for you for a small fee.  Contact me for 
details.    

CUSTOMIZATION
All formatting in showlister is handled via CSS.  So, hacking the 
"showlister.css" file should make it fairly easy to customize the look to suit
your tastes.  

TOOLS
Showlister was created with EditPad Pro and tested using Apache 1.3.27, MySQL 
3.23.51, and Mozilla 1.2.1.  

CODA
Hope you enjoy showlister.  Please post any bugs or feature requests to the 
showlister homepage (http://showlister.sourceforge.net).  If you extend it 
in any useful way, I'd appreciate it if you'd submit your changes for 
possible inclusion into future versions.   

-------------------------------------------------------------
showlister :: a simple performance calendar management system
-------------------------------------------------------------