MicroCal v1.2

This is a small and simple calendar for embedding in various PHP applications. It does not overload user's browser with javascript code like most javascript calendars do.

Requirements
Installation and usage
Contents of the package
Support
License

Requirements

The script needs only web host with PHP 4 or above.

Installation

The basic installation of this script is very simple and it is done with just uploading all the files to your host.
When you integrate MicroCal in your scripts, you need to include first mc_config.php and then mc_lang.php
There are several ways of integration which are described below and illustrated with 3 sample scripts.

Popup - sample1.php
This integration type allows you to use the calendar as popup. It will show when you click on a link using the special javascript function centerWin, which is containing in sample1.php or just using window.open();
On closing the popup the browser will redirect the main page passing the selected date in the url.
Load sample1.php in your browser to see a sample of this implementation method. Of course you may want to keep some more values, its as easy to modify MicroCal to pass them too.
To use the script as popup, open mc_config.php and set $display='popup' and $main_script to the name of your script (in this case sample1.php)

Standalone - sample2.php
This is a way to use the script as "stand alone" application which usually means you will modify it.
When MicroCal is used as 'stand alone' it will include its own HTML form element and send the data via post or get.
Thus you can use the data somewhere else in your script. Look at sample2.txt to get more sense.
To use the script as popup, open mc_config.php and set $display='standalone' and $main_script to the name of your script (in this case sample2.php)

Included - sample3.php
This way is similar to standalone version, but MicroCal does not contain its own form. Thus it allows you to keep easier some other values you may have collected via your web form. A great way for getting the user birth date or whatsoever together with other user data for storing in database. Look at sample3.php to see what I mean :-)
To use the script as popup, open mc_config.php and set $display='included' and $main_script to the name of your script (in this case sample3.php)

Using mc_lang.php
This file is a simple language pack which allows you to easy translate MicroCal to your language.
Just change the values against the variables and don't forget to change the encoding tag at the bottom if needed.

Changing the design
You can modify mc_template.html with any wysywig or ordinary web editor and change styles.css for the style sheets.

Contents of the package

- manual.html - this manual
- mc_calendar.php - the main script
- mc_config.php - the configuration file
- mc_lang.php - the language pack
- mc_template.html - the design template
- sample1.php, sample2.php and sample3.php - sample scripts
- style.css - the stylesheet

Support

For any problems or questions contact me on admin@pimteam.net

License

This price of this script is as low as 10 minutes salary of any webmaster. For $ 7.95 you are allowed to use this unlimited times script in one domain and all its subdomains.

A Product of P.I.M. Team