Location: PHPKode > scripts > eventCreator > eventCreator-2.0/docs/using.txt
ver 1.2

 * The iCal file event HTML form editor *

eventCreator is coded in PHP and Javascript and with opt. using Smarty template engine.
eventCreator can be executed standalone, included or as a popup window.

copyright (c) 2007 Kjell-Inge Gustafsson kigkonsult
updated 20070703

Feedback is welcome; hide@address.com

1. Requirements
2. Optional
3. Setup
4. License

1. Requirements
php 5.x			http://www.php.net (tested with php 5.1.6)
iCalcreator-2.2		http://www.kigkonsult.se/downloads/index.php (*)
                        php iCal class
prototype.js 1.5.1      www.prototypejs.org  (*)
                        the javascript
(*) not bundled within package

2. Optional
Smarty (2.6.14/16)      http://www.smarty.net/ (*)
                        template engine
rsscalCreator-0.8.5	http://www.kigkonsult.se/downloads/index.php (*)
                        php rssCal class
(*) not bundled within package

3. Setup
For complete file list se filelist.txt.

3.1 Upload/select mode
For use of eventCreator in upload/select mode (php-include as in the attached
index.php) to allow update and/or select of any ical calendar file:
Save eventCreatorSetup.php.updsel as eventCreator.config.php and update.
eventCreator.php can be included in other php-scripts or standalone (req. config).
Upload/select directories and removal timeout configurable.

3.2 Popup mode
For use of eventCreator in popup mode (example in indexpopup.php) for editing
single file and/or event:
Save eventCreatorSetup.php.single as eventCreator.config.php and update, standalone
configuration required.
Calling parameters:
d   directory (req)
f   filename  (req)
u   calendar component unique id; UID (opt)
o   calendar component event order number (1st=1.. .) (opt)

3.3 Setup
General required configuration:
ECURL                   URL to script location
ECDIR                   path to script directory
ECCACHE			default file storage repository
ECTIMEOUT		how long time (seconds) before old iCal/xCal/rss file removal

Upload/select mode req. config

Popup mode req. config

General optional configuration
ECUNIQUEID              site domain or other site specific id
ECLANG                  default language,  english, spanish and swedish available
ECLANGCHANGE            allows change of language 'on-demand'
ECSETTIMEZONE           set timezone for created iCal files
ECHEADERTEXT            show header text
ECLOWERMENU             show lower menu

ECEVENTUPDATE           default TRUE, allows existent event update (or only event viewing)
ECEVENTCREATE           default TRUE, allows new event creation (req. ECEVENTUPDATE)
ECEVENTDELETE           default TRUE, allows existent event delete (req. ECEVENTUPDATE)

Upload/select mode opt. config
ECFILECREATE            allows creation of new iCal files
ECFILEDELETE            allows delete of existent iCal file

Popup mode opt. config
ECSINGLEEVENT           allows only single event update,
                        event uid/ordno must be within calling parameters or first is selected

form creation options
ECPHPHTMLDIR            create form with php+HTML
ECSMARTYDIR             use smarty template engine

Read comments in eventCreator.config.php about other config settings!

4. License
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
Return current item: eventCreator