# # PHPCalendar 1.0 # Copyright 2003 Louise. All rights reserved. # Released September 15th 2003 # # PHPCalendar 1.0 is linkware and can be used or modified as long as this note remains # intact and unaltered and you provide a link back to http://codegrrl.com/ in return. You # are forbidden to sell or distribute the code of PHPCalendar 1.0, in whole or part, # without the written consent of Louise. # # By using PHPCalendar 1.0 you agree to indemnify Louise from any liability. # # Please see http://codegrrl.com/ for further information. # -----> SUMMARY PHPCalendar is a PHP/MySQL script designed especially to help webmasters to mantain a calendar, with all birthdays and the events coming up. If you ever tried to mantain a online calendar, I'm sure you know how time consuming it is to write the HTML, then upload the file through FTP everytime something comes up. With PHPCalendar you can do it in seconds. All you have to do is login to your Admin Panel and easily add, edit and delete dates and events. You have the option to display your calendar in a tradicional way, or as a list (consisting of only the dates you have events on -- very much like a "to do" list). You can see a month overview, you can see your whole year, and you can see only the birthdays! PHPCalendar was made to be easily integrated with already existing sites, only by placing a simple PHP include where you want the calendar to show. PHPCalendar is written in PHP 3 and has a MySQL database backend. Features include: - clean and simple interface - unlimited dates - 100% customizable - simple admin panel - two ways of displaying your data - month overview - year overview - show only birthdays -----> REQUIREMENTS - PHP 3 or higher - MySQL database -----> FILES & FOLDERS IN THIS DOWNLOAD admin.php = the admin panel you use to add/edit/update your dates and events calc.php = part of the script used to show the events on a calendar style (thank you to http://www.phpinsider.com/php/code/Date_Calc/) calendar.php = the file that shows your month's events on a tradicional calendar style calendar_bday.php = the file that shows all birthdays on a tradicional calendar style calendar_year.php = the file that shows your year's events on a tradicional calendar style config.php = the file that contains all the configuration info list.php = the file that shows your month's events on a list list_bday.php = the file that shows all birthdays on a list list_year.php = the file that shows your year's events on a list invalidlogin.php = part of the password protection system login.php = part of the password protection system README.txt = the file you're reading :) protection.php = the script that password protects your admin panel -----> HOW TO INSTALL THE SCRIPT NOTE: Please read through this entire .txt file carefully before you do anything. The Additional Notes at the bottom contain handy tips and tricks that might be of use to you. NOTE 2: If you already have a database ready for use, skip to step 2. And if you want to use this script for more than one site, please read the Additional Notes first. 1. Log into your domain's control panel and create a new database called calendar (or whatever you like, really). Then, either create a new user, or give an existing user access to the database. You will need the SELECT, INSERT, UPDATE, DELETE and CREATE privileges. 2. Extract the zip file to your desktop 3. Open config.php in a text editor such as Notepad or CuteHTML and edit all of the variables. 4. Create a folder for your calendar files. 5. Upload all the files to this folder you have just created. 6. Load the uploaded create.php file in your browser. You should get a 'Success! Tables created.' message but if not, please re-check all of the information in config.php. It means your database details are incorrect. 7. Delete create.php from your server to avoid security risks. 8. Load the uploaded admin.php file in your browser and log in with the password chosen in config.php. 9. You may now add events and dates to your database. :) 10. To show the calendar on your website, simply open the file where you want the calendar to show, and add a simple php include, pointing to your calendar files. If you want to show the events as a list, use something like this: If you want to show the events as a traditional calendar, use something like this: The same goes for the year and birthdays calendars. -----> ADDITIONAL NOTES - You can use this script for more than one site. The only thing you need to change for that, is the name of the table this script will use. Open up config.php in a text editor, and change the table name from "calendar" to whatever you want to. That's all! :) - To add birthdays, fill out only the day, month, and event fields, leaving year blank. This way, the brithday will be shown every year, without you having to re-add it over and over again. - You can rename the lists and calendars files to whatever you want, just make sure you keep them in the same folder as the config.php file. -----> CREDITS Script created by Louise from http://unfloopy.net/ This script uses the calc.php function, courtesy of http://www.phpinsider.com/php/code/Date_Calc/. If you have any problems with this script, please email me at louise@unfloopy.net and I will try to help you where I can.