Calendar Pro Manual

User Guide
Version 1.33, September 24, 2009
Flash CalendarPro V1.3

#1 internet-based event scheduling and publishing tool for personal use,
corporate needs and social projects
Table of Contents
Table of Contents .................................................................. 2

1 Introduction ...................................................................... 5
2 Product Overview ............................................................... 7
CalendarPro Usage ...............................................................................8
Flash CalendarPro Features ....................................................................9
How it Works .................................................................................... 11
3 Installation ...................................................................... 12
Software Requirements ....................................................................... 12
End User Requirements ...................................................................... 12
Admin Mode Requirements .................................................................. 12
MXP Package Requirements ................................................................. 12
SWF Package Installation ..................................................................... 13
Testdrive the Calendar Locally ............................................................. 13
Step 1. Upload Calendar Files Online...................................................... 15
Step 2. Add Flash CalendarPro to Your Webpage ....................................... 15
Step 3. Setup the Administrative Mode ................................................... 16
MXP Package Installation ..................................................................... 18
Testdrive the Calendar ...................................................................... 18
Step 1. Upload Calendar Files Online...................................................... 21
Step 2. Add CalendarPro to Your Flash Movie ............................................ 21
Step 3. Configure Server-Side Backend for the Administrative Mode ................ 22
4 Event Management ............................................................ 23
Manage Events in Administrative Mode ..................................................... 24
Add New Events ............................................................................... 24
Modify Existing Events ....................................................................... 27
5 User Interface Options........................................................ 28
Change Color Gamma ......................................................................... 29
Set Default View ............................................................................... 30
Handle Mouse Behaviour ...................................................................... 32
Change Interface Options ..................................................................... 34
Modify Time and Date Properties............................................................ 37
Export to iCal ................................................................................... 41
Change Interface Captions ................................................................... 42
Choose Fonts & Text Styles ................................................................... 43
5 Advanced Management ....................................................... 44
XML Files Management ........................................................................ 44
Events.XML Configuration ................................................................... 45
Time Zone Attributes ........................................................................ 47
Changing URL of Events.XML ................................................................ 48
Change URL of Settings XML ................................................................ 49
Database Integration .......................................................................... 50
Static Method .................................................................................. 50
Dynamic Method .............................................................................. 51
Read-Write Integration ...................................................................... 53
6 Language Localizations....................................................... 55
On Demand Multilingual Language Pack .................................................... 55
Editing Localization Settings ................................................................. 58
7 Appendixes ..................................................................... 59
Appendix A: Troubleshooting ................................................................ 59
Appendix B: Supported HTML tags .......................................................... 61
8 Additional Services............................................................ 64
Upgrades......................................................................................... 64
Bug Fixes ........................................................................................ 64
Installation and Configuration ............................................................... 64
Support .......................................................................................... 64
Product Customization ........................................................................ 65
Partnership and Custom Project Development ............................................ 65
Import events from CSV Plug-In ............................................................. 66
Import Events from Microsoft Excel File Plug-In .......................................... 67
Database Connector Plug-in .................................................................. 68
Event Submission Approval Plug-In .......................................................... 69
9 Document Preview ............................................................ 71
Change Record.................................................................................. 71
Document Properties .......................................................................... 72
Flash CalendarPro Manual Introduction – 3

Flash CalendarPro V1.3
Alexander Rybalko, Yaroslav Kuntsevych, Andrey Yarmolenko, Inna Shmun, Sergey
Gorchakov, Alexey Kuzmuk, Pasha Pastushenko, Alexey Zavgorodniy, Yuriy Roshchenko,
Myroslava Syvolap, Alexander Mazurenko, Ivan Azarov, Yuriy Kulchytsky, Oleksiy Nechay,
Natalya Lytovchenko.
All Rights Reserved

No part of this publication may be reproduced, reformatted or transmitted in any form or
by any means, electronic or mechanical, including photocopying, recording or through any
information storage and retrieval system, currently available or developed in the future,
without prior written approval by USFlashMap.com. This document is protected by the
copyright law and international treaties.
Trademarks
All FutureVision and USFlashMap.com logos in this document are trademarks of
FutureVision Web Solutions.
1 Introduction
Thank you for choosing Flash CalendarPro, the most innovative flash calendar available
on the web!
We encourage you to read this guide carefully in order to get the full benefit of all the
features and uses of our product.
Our team hopes you will enjoy the product and will recommend it to others. Please send
your suggestions for product improvements or cooperation at
http://www.usflashmap.com/contact/
Alex Rybalko Yaroslav Kuntsevych Andrew Yarmolenko

Lead Developer Brand Manager Managing Partner
This instruction manual will provide an overview of product features and will navigate you
through the installation and customization processes. The document is organized as
follows:
• Chapter 2, «Product Overview», introduces the Software, describes key features

and the GUI in general.
• Chapter 3, «Installation», lists Software requirements and provides guidelines on
the installation process.
• Chapter 4, «Event Management», explains how the calendar administrative mode
works.
• Chapter 5, “User Interface Options” specifies all GUI elements and their
modification.
• Chapter 6, “Advanced Management” provides the explanation of product
integration with external data source.
Flash CalendarPro Manual Introduction – 5

• Chapter 7, «Language Localizations», provides an overview of available
localization packages.
• Chapter 8, «Appendixes», includes troubleshooting hints and the list of supported
HTML tags. 7
• Chapter 9, «Additional_Services», provides the information on product upgrades,
bug reports, product customization and other services offered by USFlashMap.
• Chapter 10, «Document Preview», provides a short description of the document,
change history and document properties.
2 Product Overview
Flash CalendarPro is the new fully interactive flash calendar software for your website,
corporate intranet, web-based applications and flash movies. It was designed as a
complete web scheduling and event publishing solution for personal use, community
websites and integration with other web-based applications.
Personal and Corporate collaboration and event scheduling software like Microsoft
Outlook/SharePoint or Apple iCal do not provide appropriate web solutions and support for
communities and social networks. At the same time, companies that do take advantage of
today’s interactive web technologies, such as Web 2.0, Ajax or Flex, concentrate mostly on
custom projects and do not produce any powerful calendar software, concentrating mostly
on simple solutions. And this is where we see our niche.
Our challenge is to become #1 calendar software provider for web users (as a service)
and software developers (as a framework and box product) for three major needs:
share time-related rich media content online;
improve team collaboration in corporate intranets and other multi-user web
environments;
obtain an advanced calendar instrument for Flash and Flex projects.
Flash CalendarPro Manual Product Overview– 7

CalendarPro Usage
Online calendars are just some of the most commonly used applications used in our
business and personal lives today. They play an important part in team collaboration,
project management, scheduling services, leaving alone the necessity to display company
or personal events etc.
Flash CalendarPro can fulfill most of the planing tasks and used for various purposes. Here
are just basic ideas how you can benefit from the calendar:
• Personal Calendar. Use CalendarPro on your blog, personal website to imprint the
most memorable events in your life: trips, birthdays, anniversaries, etc. Use the
repeat feature to record them for the next 10 years.
• Business Calendar. Use Calendar Pro as an informing tool to publish your schedule
and timetables (meetings, gym sessions, concerts, studies at university, etc)
• Corporate Calendar. You can use CalendarPro on your intranet as a planning tool
to manage projects, set deadlines and show milestones, etc. Every company
member can have their own login to the administrative mode and modify events,
or have only resticted access to events management.
• Scheduling Calendar. You can intgrate the calendar with your scheduling services
and allow calendar viewers choose the most appropriate timeline for an
appointment and save the appointment summary directly on the website.
Flash CalendarPro Features
Flash CalendarPro is a feature-rich online calendar that offers a wide range of possibilities. It
provides many standard calendar features, as well as advanced ones that help you manage
your events and collaborate with others. Following is a summary table with most important
Flash CalendarPro features.
Integrate
Flash CalendarPro is a web-based calendar that can be added to any web page, blog, CRM, CMS, etc.
Moreover, a wide range of data listings (XML, Database, JS API, Flash API) allows almost any kind of
integration.
* JS API and Flash API coming soon
Customize
Flash CalendarPro has a highly customizable user interface that allows to:
modify color scheme of all graphic elements;
adjust calendar size with no image quality loss;
create custom event categories and locations;
fill in fields for custom event details;
choose among numerous calendar views (Day, Week, Month, Year. List, Search)
etc.

Add Rich Media Content
Currently you can add images of any size or format to event details. We also plan to include audio files
support, such as MP3 player on top of standard event descriptions in the next version. CalendarPro
should become more integrated with other rich media content sources. Soundtrack support and sound
schemes are going to be a part of the application in the next releases.
Collaborate
Flash CalendarPro may be left "public" to allow access by anyone or "private" to limit access to yourself
for editing events. Moreover, Calendar Pro is multi-user compliant. It may be available to registered or
unregistered users.
Flash CalendarPro Manual Product Overview- 9

Search
CalendarPro application has a built-in search module to help users find events they are looking for
faster. Search engine is combined with List View, and allows adding additional filters based on the
time range (all events, upcoming events only, today, this week and this month).
Sync
Your website users can add events from Flash CalendarPro application to their desktop time
management applications, such as Microsoft® Office Outlook, Mac iCal and other, that support iCal
format.
Local events can include time zones, which are also passed together with event details. The choice
between the local time zone and the original time zone of the events is up to every particular user.
Navigate
Once all events are loaded into the calendar, all actions are performed on the same HTML page or
flash movie stage. You may change active time period, navigate months, click tabs - and everything
still changes in runtime. Calendar layout changes immediately. There is no need to reload the page,
simply wait for the new content being generated on the server and loaded for preview on the webpage.
Besides, it does not require excessive server CPU load as well.
Thus, it is one of the advantages over other HTML calendars or scheduling solutions for websites or
intranet systems with ASP or PHP server-side backend.
Print
Flash CalendarPro print option offers true vector quality when committing online calendar to hard
copy.
Print View is available in the following formats: Year, Month, Week, Day and Custom Date Range.
Each view includes the time grid and the list of upcoming events /events in this time period. Print
layout is not designed to one size and changes dynamically based on the paper format you select for
your printer: A4, Letter or Legal.
How it Works
We’ve done our best to make a useful Flash Calendar that would be simple to use both by
end users and calendar administrators. Thus, Flash CalendarPro can run on most
operation systems in most browsers with Flash Player 8 and higher, enabling the widest
audience possible. Administrators, on the other hand, will be surprised at how easy they
can manage such a powerful application on their website.
CalendarPro application consists of three constituents:
• Public CalendarPro;
• Configuration and data files (or dynamic data source: DB Connector, API);
• Administrative Mode to manage events.
The scheme above demonstrates two major files of data source (for calendar settings and
events): one in XML format and another one either in XML or some other data storage
format. Configuring Flash CalendarPro and updating events from the DB (or manually)
requires understanding the structure and parameters of these content sources. Further
chapters of this manual will provide you with an overview of all possible configuration
options and explain how to redefine URL of configuration and data files.
Flash CalendarPro Manual Product Overview- 11

3 Installation
Software Requirements
End User Requirements
You can run Flash CalendarPro on any PC compatible or Apple computer that has a Flash
player installed in your web browser:
Web Browser
Internet Explorer 6 or higher
Firefox 2 or higher
Google Chrome
Opera 8 or higher
Safari 3 or higher
Flash Player Plug-In
Adobe Flash Player version 8 or higher
Admin Mode Requirements

Administrative Mode requires ASP, PHP or JSP supported on your website. Every SWF, MXP
or OEM package comes with these options to choose from, depending on your website
hosting plan.
Web Hosting Server Options

PHP 5 or higher
IIS, Net 2.0 framework
Tomcat 5.5 (or higher), J2SDK 5.0 – on demand
MXP Package Requirements

You can use Flash CalendarPro as an MXP component in your Flash movie that is written in
Action Script 2.0.
Scripting Language
Action Script 2.0
Flash Platform
Adobe Flash Player version 8 or higher
SWF Package Installation
Flash Calendar installation doesn’t require any specific skills and knowledge. All you need
to know is how to upload calendar files to your server and to be aware of some basics in
HTML.
Testdrive the Calendar Locally
Prior to installing the calendar to your website we suggest that you testdrive it locally.
Download Your Product Package

After you purchase Flash CalendarPro, you will receive the email with download
instructions and access information to product downloads.
Product Download Area
You must log-in prior to downloading Flash CalendarPro installation package at

http://www.usflashmap.com/users/
You can evaluate the 14-Day Free Trial version before purchasing the product.
Unzip Calendar Files

Flash CalendarPro is supplied in a zip archive. You have to extract all the files on your
hard drive before you start using the product. Use WinZip or any other archive extract
utility to open the package. Windows XP has the built-in support of zip archives.
Flash CalendarPro Manual Installation – 13

Use the “including subfolders” option to extract the archive properly.
Product Deliverables
The following table provides a brief description of Flash CalendarPro folders and files:
CalendarPro SWF package

Product folder with all files and subfolders.
admin Server side scripts to provide secure access and enable

saving changes in the Administrative Mode.
bin
documentation Product documentation including installation and usage
instructions
Images Folder with event images
calendarPro.swf Main SWF file with all calendar functionality
events.xml Configuration file: Default XML file with calendar events
index.html Sample HTML page with Flash CalendarPro installed
license.txt End-user license agreement
settings.xml Configuration file: An xml file for customizing the calendar

layout, fonts, backgrounds, tooltips and more
Testdrive the Calendar
Calendar package includes a sample HTML webpage with Flash CalendarPro installed. You
can test the sample calendar with default settings at index.html. If you see the
webpage with the calendar functioning properly, you may continue the installation.
If the calendar doesn’t show up, make sure your system corresponds to product
requirements and refer to the Troubleshooting Section of this manual.
Step 1. Upload Calendar Files Online

Installation procedure consists of 3 basic steps:
First of all you need to upload the calendar folder online to your web server. You can use
any FTP client if you are working on a static website. If you are using some CMS (such as
WordPress, Drupal, Webblogs, etc) use their uploading system.
Prior to installing the calendar using some CMS, make sure the files will be
saved in one rigid location.
Since CalendarPro folder includes admin mode setup files, we suggest that you
put the folder in a location where it would be comfortable for you to edit events
leaving the website structure intact.
Once you finish uploading, open the same index.html webpage with the sample
calendar in your Internet browser
www.yourwebsite.com/calendarPro_swf/index.html
If you receive the same calendar page in your browser, everything is OK. In case you are
getting some errors, please refer to the Troubleshooting Section of this manual.
Step 2. Add Flash CalendarPro to Your Webpage

Above we have shown how to place the calendar to your website. But naturally, you would
want to place the calendar to some other (rather than sample index.html) webpage. In
this case you need to:

o copy HTML content with <object> tag from calendar index.html to another
page;
o Specify the absolute URL for calendar SWF file. Your html code will look similar
to this one (please make sure you make changes in two places for different
browsers):
You can also put a relative path to calendar SWF file. In thi case make sure
you specify the correct “base” parameter.
<table width="100%" height="100%" border=0 cellpadding=0 cellspacing=0><tr><td>

<object classid="clsid:d27cdb6e-ae6d-11cf-96b8-444553540000"
codebase="http://fpdownload.macromedia.com/pub/shockwave/cabs/flas/swflash.cab#version=8,0,0,
0" width="100%" height="100%">
<param name="base" value="." />
<param name="FlashVars"
value="settingsUrl=http://www.yourdomain.com/calendarPro/settings.xml&eventsUrl=http://www.y
ourdomain.com/calendarPro/events.xml" />
<param name="allowScriptAccess" value="always" />
<param name="movie" value="calendarPro.swf" />
<param name="quality" value="high" />
<param name="scale" value="noscale" />
<param name="bgcolor" value="#D1FFA3" />
<embed base="." FlashVars="settingsUrl= http://www.yourdomain.com/calendarPro/settings.xml
& http://www.yourdomain.com/calendarPro/events.xml" allowScriptAccess="always"
src="calendarPro.swf" quality="high" scale="noscale" bgcolor="#D1FFA3" width="100%"
height="100%" type="application/x-shockwave-flash"
pluginspage="http://www.macromedia.com/go/getflashplayer" />
</object>
</td></tr></table>
Step 3. Setup the Administrative Mode
Administrative Mode enables editing events. However, the flash application cannot save the changes
directly, and requires server-side scripts to save the file.
Due to the usage of server side scripts , administrative mode works only online.
3.1. Set/Check Permissions for events XML file and temporary folders.
All files you uploaded on the website have default permissions (attributes), which allow
the admin mode to start working immediatelly. However, on some websites the files are
read-only by default. In this case, in order to allow the server-side script to update your
events, you need to change permissions for the following objects:
• for events.xml file to 777 (or “write for all”).
• for admin/backups folder to 777 (including content inside)
for admin/logs folder to 777 (including content inside)
3.2. Run Administrative Mode page

Depending on what server side scripts you will be using, you should open the appropriate
page in your browser to test the Administrative Mode:
www.yourwebsite.com/calendarPro_business/admin/index.aspx or
www.yourwebsite.com/calendarPro_business/admin/index.php
Note: Product package includes ASP and PHP scripts to enable saving changes when
editing in admin mode (.JSP and .CFM versions are available on demand). Before using
the Administrative Mode, you need to find out what scripting language is supported for
your website. Usually this information is available in website hosting plan description.
3.3. Password Protection
For your safety, CalendarPro Administrative Mode

is password protected.
Use default user/password information below to run
the Administrative Mode:
• Username: admin
• Password: password
Once you install and configure the Administrative
Mode, make sure you change your password so that
only you or people authorized by you will be able to
manage your calendar events!
3.4. Changing Your Password

Your password is stored online in the page code. You can change it any time you wish.
A) For ASPX version

Edit admin/index.aspx file in any text editor, change login/password, and update this
file on your web server.
login.UserName != "admin") ||(login.Password != "password")) return;
B) For PHP version

Edit admin/include_protect.php file in any text editor, change login/password, and
update this file on your web server.
$login = 'admin';
$password = 'password';

MXP Package Installation
Testdrive the Calendar
Download Your Product Package

After you purchase Flash CalendarPro, you will receive the email with download
instructions and access information to product downloads.
Product Download Area
You must log-in prior to downloading Flash CalendarPro installation package at

http://www.usflashmap.com/users/
You can evaluate the 14-Day Free Trial version before purchasing the product.
Unzip Calendar Files

Flash CalendarPro is supplied in a zip archive. You have to extract all the files on your
hard drive before you start using the product. Use WinZip or any other archive extract
utility to open the package. Windows XP has the built-in support of zip archives.
Use the “including subfolders” option to extract the archive properly.

Product Deliverables
The following table provides a brief description of Flash CalendarPro folders and files:
CalendarPro MXP package

Product folder with all files and subfolders
admin Server side scripts to provide secure access and enable

saving changes in the Administrative Mode.
bin
documentation Product documentation including installation and usage
instructions
Images Folder with event images
sampleFiles The folder with sample configuration files
calendarPro.fla FLA file with CalendarPro MXP inserted
calendarPro.mxp CalendarPro MXP component
events.xml Configuration file: Default XML file with calendar events
license.txt End-user license agreement
settings.xml Configuration file: An xml file for customizing the calendar

layout, fonts, backgrounds, tooltips and more

Test the Sample Calendar
Calendar package includes a sample Flash file with Flash CalendarPro installed. To test
the sample calendar used as MXP:
a) open calendarPro.fla with Macromedia Flash 8 or higher;
b) compile the movie (Ctrl + Enter)
Now you can see a newly created calendarPro.swf in your folder
If you receive a similar calendar page in your player, everything is OK. In case you are
getting some errors, please refer to the Troubleshooting Section of this manual.
Step 1. Upload Calendar Files Online
First of all you need to upload the calendar folder online to your web server. You can use
any FTP client.
Since CalendarPro folder includes admin mode setup files, we suggest that you
put the folder in a location where it would be comfortable for you to edit events
leaving the website structure intact.
Step 2. Add CalendarPro to Your Flash Movie
We suggest that you insert Calendar Pro MXP into your Flash Movie using “attach”
method.
To insert the calendar into your Flash movie, follow these steps:
1. Open your existing ActionScript 2.0 file or create a new one.

2. Copy all Library items from calendarPro.fla to your Flash Movie library
3. Insert ActionsScript code to a place where you need the calendar to appear and
specify the paths to Flash CalendarPro configuration files:

Stage.scaleMode = "Scale";
Stage.align = "TL";
_root.initCalendar = function (settingsUrl, eventsUrl, updateUrl, adminMode){
_root.calendarInstance = _root.attachMovie("CalendarPro", "c", 0, {settingsUrl: settingsUrl,
eventsUrl: eventsUrl, updateUrl: updateUrl, adminMode: adminMode});
_root.resizeLst.onResize();
}
_root.initCalendar("sampleFiles/settings.xml", "sampleFiles/events.xml", "admin/update.php", false);
_root.calendarInstance.setBounds(0, 0, 600, 400);
Step 3. Configure Server-Side Backend for the Administrative Mode

If you want to use the administrative mode, you need to provide the calendar with the
files for backend.
1) Upload Data files and script to your website (XML files, ‘admin’ and ‘bin’ folders)
directly into the folder with your project .fla file.
Make sure the paths to the files are correct.
2) Set appropriate permissions (details provided in Set/Check Permissions for events XML
file and temporary folders section of this manual).
3) Specify the path to update script and set “true” for the usage of the admin mode:
_root.initCalendar("sampleFiles/settings.xml", "sampleFiles/events.xml", "admin/update.php", true);
4 Event Management
There are several options to manage calendar events:

Using the Administrative Mode.
Editing XML files with events manually
Integrating with events database (other third party data source) or via API**
** Flash API will be available in further calendar builds
Flash CalendarPro Manual Event Management– 23

Manage Events in Administrative Mode
Flash Calendar Pro has an administrative mode that allows managing events directly on
your website and saves the changes in events.xml file for further reference. You make
all the changes directly in the calendar.
After you setup Administrative Mode, you can make the changes in your calendar
http://www.yourwebsite.com/calendarPro_business/admin/index.php
Everything is manipulated with your cursor:
Click an empty space to create a new

event
Click the existing event to change its

details;
Click & drag the existing event to change
its time or date
Add New Events

You can create new events on the
following views: Month, Week and Day
Views. After you click an empty space,
a pop-up window with event details
appears.
Here you can provide all event details:

Title, Date, Description, Time
parameters, as well as upload an
image and give a link to a website or
some other resource for further
reference.
To save the changes, simply click Ok

button. Now the event is visible in
your public calendar.
Title and Date parameters are compulsory.
Modify the Location of the Event
Admin mode provides an opportunity

of choosing one of the existing
locations to an event as well as
creating new locations that you might
be using in the future. After you click
edit button a pop-up window appears.
It offers to specify the location name
(ID), hint, and time zone.
Modify the Category of the Event
Event categorization is a useful

feature if you want to differentiate
events by their type, make search
easier to the viewers, as well as
smarten up your calendar.
In the admin mode you can both
create new categories and assign
already existing categories to your
event.
The pop-up with category
specifications allows you to change
the following: name of the
location, the hint of the location on
mouse-over and its colour, with
which the events belonging to this
category are represented.
Make sure that category editing is enabled in settings.xml file:

<editCategoryEnabled>1</editCategoryEnabled>

Write Event Description
Event Description is the informative part of the Event Details window. It might be short
and extremely long. When you have a big piece of information, it is important to be able
to highlight the most important points. That’s why you might use the editor which has the
basic tags for formatting (text type, alignment, etc)
Additionally, you can use the HTML editing mode. The list of the supported HTML tags is
supplied in this document.
Upload Images
Images help to visualize an event and provide a more professional look to your calendar.
Flash CalendarPro uses the standard way of uploading images:
1. You choose the image on your hard-drive
2. The calendar uploads the image to Images folder on your server
Size restrictions to images are 2880x2880 px
Make sure that in settings.xml this function is enabled.

<browseForImageEnabled>1</browseForImageEnabled>
Modify Existing Events
You can also modify the existing events. Once you open the dialog box with event details,
you can modify all the event parameters. Additionally, you can erase the event by clicking
“Delete” button in the left bottom corner of the dialog box.
To delete all default events in the calendar which are supplied in the purchased
package, delete all the data between the tags <data><events></events></data> in
events.xml on your server
If you need to change the day of the existing event or shift it to some other time, you
might find it useful to drag an event from one day to another on Month View and from one
time range to another on Day View.
Moreover, you can extend or reduce the time range of the event. Simply click on the border of it
and drag.

5 User Interface Options
All major parameters, such as color gamma, fonts, text labels and behavior options can be
adjusted to match the environment look and feel (website, flash movie or corporate
intranet area) in a single file. Settings.XML file includes all configurable graphic
interface parameters and behavior options. Content of the styles XML file fits the industry
XML standard.
User interface options include:

1. Calendar color gamma
2. Default calendar view (Year, Month, Week, Day, List)
3. Time mode: AM/PM to 24h
4. Show-hide categories or locations from the side panel
5. Show-hide event start time on the time grid
Change Color Gamma
This chapter provides an overview of graphic user interface settings for Flash
CalendarPro and helps you configure software outlook and performance for an end user.
Below is the list of possible modifications to the color gamma of the calendar:
Attribute Description
<defaultEventColors>0x0066CC, These are default event colors which are used when you
0x7AC903,0xF99D17,0xB021EF,0 first create an event
x3AD6D5</defaultEventColors>
<pageBackgroundColor> Specifies page background color
Usage:
<pageBackgroundColor>0xD1FFA3</pageBackgroundColor>
<headingBackgroundColor> Specifies heading background color
Usage:
<headingBackgroundColor>0xD1FFA3</headingBackgroundC
olor>
<backgroundColor> Specifies background color for the calendar controls: Year,
Month, Week, Day, Search control elements and the small
calendar, categories and legend components.
Usage:
<backgroundColor>0xff0000</backgroundColor>
<backgroundColor2> Specifies background color for the calendar body
background and a couple of other elements (non-working
time and days on the month controls).
Usage:
<backgroundColor2>0x000000</backgroundColor2>
<shadowColor> Specifies RGB color for shadow effects.
Usage:
<shadowColor>0x000000</shadowColor>
<darkShadowColor> Specifies RGB color for bevel effects (used in the scroller
components, tabs, etc).
Usage:
<darkShadowColor>0x000000</darkShadowColor>
<shadowAlpha> Specifies transparency for alpha and alpha 2 elements.
<shadowAlpha2> Valid range [0-100]. 100 = fully transparent.
Usage:
<shadowAlpha>60</shadowAlpha>
<shadowAlpha2>16</shadowAlpha2>
<activeColor> Specifies color of active elements.
<activeColor2>
Usage:
<activeColor>0x6ec2ff</activeColor>
<activeColor2>0x9b9b9b</activeColor2>
Flash CalendarPro Manual User Interface Options– 29

<borderColor> Sets the color of the borders.
<borderColor2>
Usage:
<borderColor>0xCACBC6</borderColor>
<borderColor2>0x7F7F7E</borderColor2>
<hintColor> Specifies the color for mouse over hint.
Usage:
<hintColor>0xFCFFCB</hintColor>
<controlBackgroundColor> Set sthe background color for the element controls.
Usage:
<controlBackgroundColor>0xB5E593</controlBackgroundCol
or>
<controlForegroundColor> Set the foreground color for the element controls
Usage:
<controlForegroundColor>0x2b2f26</controlForegroundCol
or>
<highlightColor> Sets the color for highlight element (semi-transparent
layer over buttons and other pseudo 3D elements).
Usage:
<highlightColor>0x0000ff</highlightColor>
<inactiveTextColor> Sets the color of particular text markers.
<defaultTextColor>
Usage:
<mandatoryTextColor> <mandatoryColor>0xFF0000</mandatoryColor>
<eventTitleColor>0xFFFFFF</eve
ntTitleColor>
Set Default View

<initialView> Specifies default calendar view. Valid values are:
0 – month view;
1 - year view;
2 - month view
3 - week view (default view)
4 - day view
5 - list view
Usage:
<initialView>3</initialView>
<initialDate> Specifies active calendar date in MM/DD/YYYY format. This attribute
is often used together with <initialView> attribute. Default value =
today.
If the initial view mode is set to ‘Month’ or ‘Year’, the user will jump
to the month or year of the initial date correspondingly. The example
below illustrates how to set April 2008 as a default month:
Usage:
<initialView>3</initialView>
<initialDate>04/01/2008</initialDate>
<showEventDetails> Allows opening event details on calendar load. Valid value = existing
event id.
Usage:
<showEventDetails>322544624</showEventDetails>
<highlightEvent> Specifies event ID to highlight on calendar load. Date of this event is
used as an initial date.
Usage:
<highlightEvent>3452345234</highlightEvent>

Handle Mouse Behaviour
<toolTipMode> Set the tooltip format for events with the help of
<toolTipSizeX /> <toolTipMode> tag. Valid values are:
<toolTipSizeY /> 1 – title;
2 – image;
3 – do not show tooltip;
4 – title + description (by default).
Note, when the tooltip mode is set as ‘image’, the maximum
image size can be set with the help of <toolTipSizeX> and
<toolTipSizeY> tags. By default, the image is displayed in its
full size.
Usage:
<toolTipMode>2</toolTipMode>
<legendToolTipMode> Specifies the tooltip mode for the legend:
0 – disabled (by default);
1 – enabled.
Note: The tooltip content is defined from <alt> tag in the
Category/Locations item. If the <alt> tag is missing, the tooltip
content is defined from the <title> tag.
Usage:
<legendDesignType>2</legendDesignType>
<dayViewEventOverAction> Specifies whether to display the tooltips in Day View when the
user points to the specific event with the help of
<dayViewEventOverAction> tag. Valid values are:
0 – display the tooltip (default);
1 – do not display the tooltip.
Usage:
<dayViewEventOverAction >1</dayViewEventOverAction>
<dayViewEventReleaseAction> Select the object the user jumps to when clicking the event in
Day. View with the help of <dayViewEventReleaseAction> tag.
Valid values are:
0 – detailed popup window is displayed (default);
1 – a user jumps to the URL that is specified in events.XML
file.
<weekViewEventOverAction> Specifies whether to display the tooltips in Week View when

the user points to the specific event with the help of
<dayViewEventOverAction> tag. Valid values are:
0 – display the tooltip (default);
1 – do not display the tooltip.
Usage:
<weekViewEventOverAction >1</weekViewEventOverAction>
<weekViewEventReleaseAction>2 Select the object the user jumps to when clicking the event in
</weekViewEventReleaseAction> Day. View with the help of <weekViewEventReleaseAction> tag.
Valid values are:
0 – no action is performed
1 – detailed popup window is displayed (default);
<monthViewEventReleaseAction> Specify whether to display the tooltips in Month View when the

<monthViewEventOverAction> tag.
Valid values are:

0 – show tooltip (default);
1 – do not show tooltip.
<monthViewEventOverAction> Specify whether to display the tooltips in Month View when the
Valid values are:

<searchViewEventOverAction> Specify whether to display the tooltips in Month View when the
Valid values are:

<searchViewEventReleaseAction> Specify whether to display the tooltips in Search View when the
user points to the specific event.
Valid values are:

<commonTarget> Default target for opening link URL(s)
<popupAnimationEnabled>0</pop Specify the behaviour of the infobox with events. Valid values
upAnimationEnabled> are:
1 – the window appears smoothly from transperent to 100%
transperancy
0 – the window appears at once.
Usage:
<popupAnimationEnabled>0</popupAnimationEnabled>

Change Interface Options
<searchEnabled> Enable/Disable the search input field
Valid values are:
0 – disable search;
1 – enable search (by default).
Usage:
<searchEnabled>1<searchEnabled>
<showOneDayEventBackgroundOn Show/hide the background of one day event on Month View.
MonthView>0</showOneDayEven Valid values are:
tBackgroundOnMonthView> 0 – don’t show (by default);
1 – show
Usage:
<showOneDayEventBackgroundOnMonthView>0</showOneDayEve
ntBackgroundOnMonthView>
<browseForImageEnabled>1</bro Enable/Disable image upload for an event in the admin mode.
wseForImageEnabled> Valid values are:
0 – disable image upload;
1 – enable image upload (by default).
Usage:
<browseForImageEnabled>1</browseForImageEnabled>
<editCategoryEnabled>1</editCa Enable/disabl category editting in the admin mode.
tegoryEnabled> 0 – disable category editting;
1 – enable category editting (by default).
Usage:
<editCategoryEnabled>1</editCategoryEnabled>
<viewEnabled>1,1,1,1,1</viewEn Show/hide view tabs in the calendar: Year, Month, Week, Day,
abled> List.
Valid values are:

0 – don’t show;
1 – show .
Usage:
<viewEnabled>1,1,1,1,1</viewEnabled>
<viewEnabled>1,1,1,1,0</viewEnabled> (List View disabled)
<eventBodyRadius>6</eventBody Change the shape of events background on Month, Week and Day
Radius> Views. Valid values are:
From 0 – sharp ends
to 6 – rounded corners
Side Panel Options
<sortCategories> Specify the sorting order for the legend component accordingly.
<sortLocations> Valid values are:
<sortListOptions> 0 – no sort (default behavior), the order remains the same as
indicated in the Legend.XML file;
1 – sorted in the ascending order;
2 – sorted in the descending order.
Usage:
<sortCategories>1</sortCategories>
<sortLocations>1</sortLocations>
<sortListOptions>0</sortListOptions>
<hideEmptyCategories> Defines if the categories and locations with no events are visible
in the legend component
Usage:
<hideEmptyCategories>true</hideEmptyCategories>
<leftPanelDesignType> Specify which components needs to be displayed in the left

panel of the calendar. Valid values are:
0 – show all components (by default);
1 – hide the small calendar;
2 – hide the locations component;
3 – hide the small calendar and locations component;
Calendar Component:
Categories Component Locations Component
Note: Locations also disappears from the event details pop-up

window when you hide locations in the left panel.

<showCalendarCategories>1</sho Show hide Categories component. Valid values are:
wCalendarCategories> 0 – don’t show categories;
1 – show categories (by default).
Usage:
<showCalendarCategories>1</showCalendarCategories>
<legendDesignType> Specify the type of colorizing items in the categories/locations
panel.
Parameters include:
0 – each category/location color matches its own background
color, which is specified in legend.XML file (by default);
1 – the color of the categories/locations matches the
background of the checkboxes next to them;
2 – the color of the categories/locations matches the foreground
of the checkboxes next to them.
Usage:
<legendDesignType>2</legendDesignType>
Modify Time and Date Properties
<leadSundayStyle> Set the order of weekdays (start week from
Monday or Sunday)
Valid values are:
true – weeks in the calendar start from Sunday;
false – weeks in the calendar start from
Monday.
<dayViewHours> Defines working schedule visualization
<dayStart>
<workingDayStart>
<workingDayEnd>
<dayEnd>
<weekendShowWorkHours>
</dayViewHours>
<dayStart> Specifies the day start time. Use integer values
in 0-24 range. By default the value 0 is set.
Usage:
<dayStart>9</dayStart>
This means the day grid will start from

9:00AM. Events that start earlier are cropped.
<workingDayStart> Specifies working day start time. Use integer

values in 0-24 range. By default the value 9 is
set.
Usage:
<workingDayStart>10</workingDayStart>
(working time is highlighted from 10:00AM)
<workingDayEnd> Specifies working day end time. By default the

value 18 is set.
Usage:
<workingDayEnd>18</workingDayEnd>
This example makes the working day finish at

6:00PM and the working time is highlighted till
6:00PM on the day grid.
<dayEnd> Set the day end time. Use integer values in 0-

24 range. By default the value 24 is set.
Usage:
<dayEnd>22</dayEnd>
(means day grid is limited to 10:00PM. Events
that finish later that 10:00PM are cropped on
the day grid).
Flash Calendar Pro Manual User Interface Options – 37

<weekendShowWorkHours> Specifies whether to display working hours on
weekends. Valid values are:
true – show working hours on weekends;
false – do not show working hours on
weekends.
Usage:
<weekendShowWorkHours>
true</weekendShowWorkHours>
<timeFormat> Defines time format
<halfDaySuffixes>AM,PM</half
DaySuffixes>
<time>hh:MM HD</time>
<date>ww, mon dd, yyyy</date>
<dateTime>ww, mon dd, yyyy -
hh:MM HD</dateTime>
……………………………………..
……………………………………..
……………………………………..
<dateYearHeader>yyyy</dateYearHeader>
</timeFormat>
<halfDaySuffixes> Defines text captions for AM/PM labels.
Usage:
<halfDaySuffixes>am,pm</halfDaySuffixes>
<time> Specify the time template (used for event).
Usage:
<time>hh:MMHD </time>
You can use the following variables in your
format expression:
"hh" – 12 hours format with leading zero (i.e.
01, 02);
"h" – 12 hours format without leading zero (i.e.
1, 2);
"HD" – suffix AM/PM and switch to AM/PM
mode;
"HH" – 24 hours format with leading zero (i.e.
01, 02)
"H" – 24 hours format without leading zero (i.e.
1, 2);
"MM" – minutes with leading zero (i.e. 01-59);
"M" – minutes without leading zero (i.e. 1-59);
"SS" – seconds with leading zero (i.e. 01-59);
"S" – seconds without leading zero (i.e. 1-59).
Note: If HD (half day) is not specified, the time

is displayed in 24-hour notation (also known as
military format)
<date> Specifies date template that can be used by
calendar components.
Usage:
<date>ww, mon dd, yyyy</date>
You can use the following variables in your

format expression:
"GMT" – sets the time in GMT format;
"ww" – the names of the days from
daysOfWeek3 parameter;
"w" – the names of the days from daysOfWeek
parameter;
"dd" – the days with leading zero (i.e. 01, 02,
03);
"d" – the days without leading zero (i.e. 1, 2,
3);
"month"– full names of the months;
"mon" – short names of the months;
"mm" – the months with leading zero (i.e. 01,
02, 03);
"m" – the months without leading zero (i.e. 1,
2, 3);
"yyyy" – the year of the 4-digit format (i.e.
2007);
"yy" – the year of the 2 -digit format(i.e. 07);
<dateShort> Specifies date template that can be used by

calendar components.
Usage:
<dateShort>mon dd, yyyy</dateShort>
<dateTime> Specifies date template that can be used by

calendar components (in List View).
Usage:
<dateTime>ww, mon dd, yyyy, hh:MMHD
</dateTime>
<dateDig>mm/dd/yyyy</dateDig> Event date format in the edit form of the
admin mode

HH and hh variables in the time templates. It is possible to switch between 24h and AM/PM
modes by changing variables in time templates
(24h and AM/PM time mode) that are used by different components:
“HH” (24 mode)“hh” (12 hour mode) and

“HD” (am/pm text).
Example:
24h mode AM/PM Mode
<time>HH:MM </time> <time>hh:MM
<dateTime>ww, mon dd, HD</time>
yyyy - HH:MM <dateTime>ww, mon
</dateTime> dd, yyyy - hh:MM
<dateTimeShort>mon dd, HD</dateTime>
yyyy - <dateTimeShort>mon
HH:MM</dateTimeShort> dd, yyyy - hh:MM
HD</dateTimeShort>
<showEventTime>0</showEventTime> Define event display mode in Month/Day View.

Valid values are:
0 – show only title
1 – show the title and event start time;
2 – show the title, event start and finish time.
Day View Example
Month View Example

Export to iCal
Export to iCal function allows adding an event to a user desktop calendar or organizer
application such as MS Outlook or Apple iCal.
* Ical export requires timezones specificed for all event categories.
Option Description
<iCalExportEnabled> Enable iCal export by using the <iCalExportEnabled> tag in
settings.XML file.
Example:
<iCalExportEnabled>1</iCalExportEnabled>
Disable iCal export by using the <iCalExportEnable> tag.
Example:
<iCalExportEnabled>0</iCalExportEnabled>

Change Interface Captions
All text labels for the public calendar and admin mode can be found inside <localization>
tag of settings.XML file.
Option Description
<viewMenuLabels> Specifies view labels.
Usage:
<viewMenuLabels>Year,Month,Week,Day,List</
viewMenuLabels>
<createEventTooltipText> Specifies text to create new event in Admin Mode
Usage:
<createEventTooltipText>Click to create new
event</createEventTooltipText>
<monthOfYearFull> Specifies text captions for full and short month names.
<monthOfYear>
<daysOfWeek3> Usage:
<daysOfWeek> <monthOfYearFull>January,February,March,April,May,Jun
e,July,August,September,October,November,December</
monthOfYearFull>
<monthOfYear>Jan,Feb,Mar,Apr,May,Jun,Jul,Aug,Sep,Oct,
Nov,Dec</monthOfYear>
<daysOfWeek3>Sunday,Monday,Tuesday,Wednesday,Thurs
day,Friday,Saturday</daysOfWeek3>
<daysOfWeek>S,M,T,W,T,F,S</daysOfWeek>
Choose Fonts & Text Styles
You can change the types of fonts used in different calendar parts and tags. There are 6
font types you can modify:
1. default text
2. headings
3. large text fonts
4. xLarge text fonts
5. small text fonts
6. small text fonts used by default
Following is the description of the tags that specify these text formats:
Tag Description
<size> The font size of the element. The recommended values
for the input vary from 10 to 16 in order to fit the
calendar interface.
 The font that will be used to draw the text. The calendar
supports basic fonts (including Arial, Tahoma, Verdana,
Courier, etc.). If you want to add your own fonts, they
must be embedded into flash while the component is
compiled. This ability requires the calendar installation
package with source files or MXP component.
<bold> Specifies whether the text is bold or not. The supported
options are:
true – the text is bold;
false – the text is not bold.
This tag is optional. By default, the text is not bold.

<align> The alignment of the text inside its element. The
supported options are:
left – the text is left-aligned by the left side;
center – the text is center-aligned by center;
right – the text is right-aligned.
This is an optional tag. By default, the text is left -

aligned

5 Advanced Management
XML Files Management
Flash CalendarPro is an XML-driven flash application. There are 2 main sources of data:
settings.XML and Events.XML. Configuring Flash CalendarPro and updating events
from the DB (or manually) requires understanding the structure and parameters of these
content sources. Further chapters of this manual will provide you with an overview of all
possible configuration options and explain how to redefine URL of configuration and data
files.
Events.XML Configuration
Events.XML contains a list of events in XML format. It can be a static file or the script
output. Content of the file fits the industry XML standard and consists of the following
components:
Configuration file component Description

<events> Within <event> tag all events are specified
<categories defaultID="Cinema"> Here all categories you create are saved.
This is a compulsory tag. Don’t delete it.
<locations defaultID="None"> Within <locations> tag all locations are

saved. This is a compulsory tag. Don’t
delete it.
<timezones defaultID="(GMT-0000) Here all avaliable timezones in iCal format
Greenwich Mean Time : Dublin / are preserved. You can add your own
Edinburgh / Lisbon / London"> timezones in iCal format. This is a
compulsory tag. Don’t delete it.
Categories, Locations and TimeZones have a defaultID parameter. Make sure

you don’t delete them.
All events are specified within <events> tag. Every event is determined by a set of tags.
Below is their description:
Tag Description Type
<title> The title of the event. Mandatory
Usage:
<title>Single Test Event</title>
<date> Specifies the date, to which the event is assigned in Mandatory
MM/DD/YYYY format. Default event duration is one day.
Usage:
<date>01/01/2009</date>
<date_to> Specifies the end date for the event with duration more than Optional
one day.
Usage:
<date>01/01/2009</date>
<date_to>01/10/2007</date_to>
<time> Specifies event start time in 24h format. An event is Optional
considered all day long <time> attribute is not specified.
Usage:
<time>18:30</time>
<time_to> Specifies the end time for the specific event. Default event Optional
Flash CalendarPro Manual Advanced Management– 45

duration if <time_to> is undefined is 30 minutes.
Usage:
<time_to>21:30</time_to>
<event_id> The unique identifier of the event. Optional
If several events have the same id, the events will not be
displayed.
If event identifier is missing, it will be generated and stored
automatically next time the user edits events in
Administrative Mode.
Usage:
<event_id>4239076023249</event_id>
<category> Category nameThe identifier of the category the event is Optional
linked to.
<location> The name of the location the event is linked to. Optional
<recursive freq= /> Specifies whether the event repeats on the regular basis or Optional
not. The supported options are:
yearly – the event is repeated each year;
<recursive freq=”yearly” />
monthly – the event is repeated each month;
<recursive freq=”monthly” />
weekly – the event is repeated each week.
<recursive freq=”weekly” />
<recursive_to> Specifies the finish date for the recursive event. By default, Optional
the recursive event is not limited in time.
Usage:
<event>
<title>Lunch with Peter</title>
<time>13:00</time>
<date>01/01/2008</date>
<recursive freq=”weekly” />
<recursive_to>07/01/2010</recursive_to>
</event>
If you want to repeat the event that lasts

several days, specify the event duration with
the help of <date_to> tag and then use the
recursive tag.
<description> The event description, which is displayed on the detailed view Optional
that appears after the user clicks the event in the calendar.
You can use HTML tags in the description to add text
formatting, images and other standard elements.
Usage:
<title>Martin Luther King Day</title>
<description><![CDATA[The third Monday in January, observed
in the United States in commemoration of the birthday of
Martin Luther King, Jr.Find out more on
answers.com]]></description>
Notice CDATA embedding HTML description in XML content to

keep proper rendering of HTML formatted content with Flash
Player.
<image> Specifies event image that is shown in event details window Optional
and on mouse over event (must also specify proper tooltip
mode). Image URL can be absolute or relative (from the
product folder on website)
Usage:
<image>img/some.jpg</image>
<image>http://www.yoursite/img/some.jpg</image>
To decrease the image loading time, it is

recommended the image size to be no greater
than 500x500 pixels and less than 200 kb.
Supported image formats are: jpg, jpeg, bmp,
gif, swf.
<url> Specifies event URL in event details (visible and clickable; can Optional
be attached to an event when a user clicks event on the time
grid as well. Event behavior is specified in Styles.XML file.
Usage:
<url>http://www.answers.com/topic/independence-
day</url>
<target> Specifies where to open the target URL: Optional
_self - the target URL will open in the same frame as it was
clicked. This is a default attribute;
_blank - the target URL will open in a new window;
“xxx”, where xxx is the name of your frameset - the target
URL will open in the specified frame as it was clicked.
Time Zone Attributes
Though Flash CalendarPro does not have the 2nd time zone and works with local time on
every PC, it is possible to carry event timezone when exporting event to iCal file and then
importing to your desktop organizer.
Time zone is set to event via location attribute (green), if it is linked to a timezone
(yellow).
Sample Events XML file:

<events>
<event>
<event_id>35</event_id>
<title>Lunch with wife</title>
<date>08/11/2009</date>
<time>13:00</time>
<category>Needs preparation</category>
<location>Caracas</location>
<recursive freq="monthly" /></event>
...
</events>

Sample Legend XML file content:
<locations>
<locations defaultID="None">
<categoryItem><id>Washington</id>
<tzid>(GMT-0500) Eastern Time (US / Canada)</tzid>
<alt>Washington</alt></categoryItem>
<categoryItem><id>Virginia Beach</id><tzid>(GMT-0500) Eastern Time (US /
Canada)</tzid><alt>Virginia Beach</alt></categoryItem>
………………………….
</locations>
<timezones><timezone><id>(GMT-1100) Midway Island / Samoa</id><ical>BEGIN:VTIMEZONE

TZID:(GMT-1100) Midway Island / Samoa
BEGIN:STANDARD
DTSTART:16010101T000000
TZOFFSETFROM:-1000
TZOFFSETTO:-1100
END:STANDARD
END:VTIMEZONE</ical></timezone>
...
</timezones>
List of 55 global Time Zones is already included in Events.XML file for your
convenience. It is compliant with MS Office and Mac iCal organizers and includes
standard and daylight saving time offsets (time offset and switch timestamp).
If you edit Time Zones, make sure TZID tag is compliant with Microsoft Outlook
time zone list.
Changing URL of Events.XML

By default, CalendarPro reads parameters from events.XML file. However, it is possible
to redirect the calendar to a different filename or server-side script URL.
To define a new URL of the Styles XML file you should modify HTML code, where Flash
CalendarPro is added to your page (via FlashVars variable).

0" width="100%" height="100%">
value="settingsUrl=http://www.yourdomain.com/calendarPro/settings.xml&eventsUrl=http://www.y
ourdomain.com/users/john_events.xml" />
<embed base="." FlashVars="settingsUrl= http://www.yourdomain.com/calendarPro/settings.xml &
http://www.yourdomain.com/users/john_events.xml" allowScriptAccess="always"
</object>
</td></tr></table>
FlashVars must be specified twice in <param> and <embed> tags for different web
browser types.
Use URL encoding to set variables via FlashVars (‘%20’ for SPACE, ‘%26’ for ‘&’
and so on).
Change URL of Settings XML

By default, CalendarPro reads the parameters from settings.xml file. However, it is
possible to redirect the calendar to a different filename or server-side script URL.
To define a new URL of settings.XML file you should modify HTML code, where Flash
CalendarPro is added to your page (via FlashVars variable).
Sample HTML code:

0" width="100%" height="100%">
value="settingsUrl=http://www.yourdomain.com/users/john_settings.xml&eventsUrl=http://www.you
rdomain.com/users/john_events.xml" />
<embed base="." FlashVars="settingsUrl= http://www.yourdomain.com/users/john_settings.xml &
http://www.yourdomain.com/users/john_events.xml" allowScriptAccess="always"
</object>
</td></tr></table>
FlashVars must be specified twice in <param> and <embed> tags for different web
browsers.
Use URL encoding to set variables via FlashVars (‘%20’ for SPACE, ‘%26’ for ‘&’
and so on).

Database Integration
Flash CalendarPro can be integrated in two modes: to read events from your data source
and server as the publisher for website users (Read-Only Integration) or both read and
update events to your database (Read-Write Integration).
Flash CalendarPro cannot read events from your database directly. Usually
there is a middle layer, a script that is used to retrieve events from the database
and possibly push the updated events back.
Databases and platforms are always different. USFlashMap does not provide
ready-made solutions to export events from your database. Instead, we provide all
necessary descriptions for your webmasters or developers to implement the
integration.
You may also contact USFlashMap.com team, provide information about your
system and request integration services.
Static Method
Read-only integration (or Asynchronous Integration) is a one-way integration, when events
from your database or another data source are exported to the calendar XML file and
published on the website / extranet. Flash Calendar Application can be configured to read
from the script directly, instead of retrieving the XML file.
Static method is used to export events and update (overwrite) events.XML files. Update
can be scheduled or take place on demand, depending on your needs.
Scheme 1 (Read-Only Integration. Static Method)

1) Server-side script retrieves events from the data source, formats into events XML format
and updates events.xml file;
2) CalendarPro reads events.xml file as usually;
3) CalendarPro visualizes events to users.
You can change URL to events.xml in MXP (component parameters) or in HTML via
FlashVars. This gives you a possibility to specify which calendar should be used on the
page, or create several pages for different calendars.
Sample HTML code illustrates how eventsUrl is pushed via FlashVars parameter:
codebase="http://fpdownload.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=8,0,0
,0" width="787" height="512" align="middle">
<param name="FlashVars" value="eventsUrl=john.xml" /><param name="allowScriptAccess"
value="always"/><param name="movie"
value="http://www.yourdomain.com/calendarPro_business/calendarPro.swf" /><param
name="quality" value="high" /><param name="scale" value="noscale" /><param
name="bgcolor" value="#D1FFA3" /><param name="base" value="." /><embed
FlashVars="eventsUrl=john.xml" allowScriptAccess="always"
src="http://www.yourdomain.com/calendarPro_business/calendarPro.swf" quality="high" base="."
scale="noscale" bgcolor="#D1FFA3" width="787" height="512" align="middle"
type="application/x-shockwave-flash" pluginspage="http://www.macromedia.com/go/getflashplayer"
/>
</object>
FlashVars must be specified twice in <object><param> and <embed> tags for

different web browser types.
Dynamic Method
Instead of reading events from static XML file(s), Flash CalendarPro can be configured to
read events from the server-side script directly. This feature enables retrieving data for a
specific user or event, adding parameter to your script (userID, sessionID, etc.)
*Note: Dynamic method requires knowledge of server-side scripting, XML, and DB (if it is
the data source).
Scheme 2 (Read-Only Integration. Dynamic Method)

1) Calendar calls a server-side script URL with parameters;
2) Server-side script retrieves events from the data source and returns formatted events
XML content back to CalendarPro;
3) CalendarPro visualizes events to users.
Similar to the static Method, script URL is defined via FlashVars in HTML code. HTML page
can be generated dynamically, and the parameter eventsURL is mapped for any user.
Sample index.html code:

codebase="http://fpdownload.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=8,0,0
,0" width="787" height="512" align="middle">
value="eventsUrl=http://www.yourdomain.com/scripts/events.php?userId=john%26calendar=publi
c" /><param name="allowScriptAccess" value="always"/><param name="movie"
value="http://www.yourdomain.com/calendarPro_business/calendarPro.swf" /><param
name="quality" value="high" /><param name="scale" value="noscale" /><param
name="bgcolor" value="#D1FFA3" /><param name="base" value="." /><embed
FlashVars="eventsUrl=http://www.yourdomain.com/scripts/events.php?userId=john%26calendar=
public" allowScriptAccess="always"
src="http://www.yourdomain.com/calendarPro_business/calendarPro.swf" quality="high" base="."
scale="noscale" bgcolor="#D1FFA3" width="787" height="512" align="middle"
type="application/x-shockwave-flash" pluginspage="http://www.macromedia.com/go/getflashplayer"
/>
</object>
Use URL encoding to pass ‘&’ and other characters in eventsURL parameter
Read-Write Integration
Read-Write (or Full Integration) uses the same approach for reading events as in Read-Only
Mode (Dynamical Method) plus you need to configure server-side scripts to save events
back to the database.
It is a combination of reading events and saving events with two different scripts (or one
script but read-and-write modes). This type of integration is often required to show events
from the database filtered by user. In this case you need to create a script that would grab
events form the DB by user, and then format them in XML for the calendar. On top of that,
it is possible to pass new updated events back to the saver script and push back to the
database.
*Note: Read-Write integration requires knowledge of server-side scripting and XML.
Scheme 3 (Read-Write Integration)
1) Calendar calls the server-side script URL with the parameters to read events;
2) The server-side script retrieves events from the data source and returns formatted
events XML content back to CalendarPro;
3) When making changes, CalendarPro calls a saver script URL with parameters, and
simultaneously submits events via POST method;
4) The server-side script saves changes to the database or other source.
Submitting Events XML from CalendarPro to a Server-Side Script

After a user makes changes to the events, CalendarPro submits new events.XML content
to a server script that saves them.
CalendarPro uses POST method to submit data to the script URL;
Events.XML content is already well formatted. Script does not require making
any transitions, only save events file or push events to the database.
<Events> tag also includes two attributes (updatedEventID= and command=)
with information about the last modified event and the type of modification.
Product packages include several saving scripts (ASP, PHP, etc). These may serve
as samples to see how to receive events.xml content from the CalendarPro
application.

Change server-side script URL to save events (updateURL)
Depending of the Administrative Mode version (PHP or ASP), URL to the update script is
specified in admin/index.aspx or admin/index.php file as ‘updateUrl’ parameter.
………
value="adminMode=1&settingsUrl=settings.xml&eventsURL=events.xml &updateUrl=admin/update.php" />

………
……..
<embed base=".”
FlashVars="adminMode=1&settingsUrl=settings.xml&eventsURL=events.xml &updateUrl=admin/update.php"
allowScriptAccess="always" src="../calendarPro.swf" quality="high" scale="noscale"
bgcolor="#D1FFA3" width="100%" height="100%" type="application/x-shockwave-flash"
………..
Provide Additional Parameters for Server-Side Script

If your updated script requires additional parameters, such as userID, calendarID,
sessionID etc., you must specify this in updateUrl parameter individually for every user.
………….
value="adminMode=1&settingsUrl=settings.xml&eventsURL=events.xml&updateUrl=admin/update.php&use
Id=123" />
……………….
………………
<embed base="."
FlashVars="adminMode=1&settingsUrl=settings.xml&eventsURL=events.xml&updateUrl
=admin/update.php&userId=123" allowScriptAccess="always" src="../calendarPro.swf" quality="high"
scale="noscale" bgcolor="#D1FFA3" width="100%" height="100%" type="application/x-shockwave-flash"
…………
6 Language Localizations
Flash CalendarPro provides multi-language support to all language families: Indo-
European, Sino-Tibetan, Afro-Asiatic, Niger-Congo, American Indian, and Altaic. Flash
CalendarPro users can enjoy the software in Germanic, Roman, Slavonic, Baltic, Chinese,
Burmese-Tibetian, Tai-Kadai, Arabic and other groups of languages.
On Demand Multilingual Language Pack

Localization packages are available on demand and include the following:
text labels of end-user interface and dialog box messages (warning messages, error
codes, buttons, status messages);
regular and short time units (months, days of a week) and their abbreviations;
support for local language in all input fields including the search form and
add/edit event form (available in the Administrative mode).
List of languages included in the multi-lingual localization package:
Language Spoken in country
English
United States Ireland
United Kingdom
South Africa
Canada
New Zealand
Australia
Singapore
Français (French) Burundi
France
Benin
Democratic Republic of the
Congo
Switzerland
Canada
Togo
Madagascar
Central African Republic
Côte d'Ivoire
Lebanon
Cameroon
Republic of the Congo
Burkina Faso
Gabon
Niger
Comoros
Senegal
Equatorial Guinea
Mali
Djibouti
Belgium Luxembourg
Chad Vanuatu
Seychelles
Guinea
Rwanda Monaco
Haiti
Flash CalendarPro Manual Language Localizations– 55

Deutsch (German) Germany
Nederlands (Dutch)
Aruba Netherlands Antilles
Belgium Suriname
Netherlands
Italiano (Italian)
Italy Sovereign Military Order of
Malta
Switzerland Croatia (Istria)
San Marino Slovenia
The Vatican City

Português (Portuguese) East Timor
Brazil
Mozambique Equatorial Guinea

Cape Verde
Angola
São Tomé and Príncipe
Portugal
Guinea-Bissau
Español (Spanish)
Mexico Dominican Republic
Colombia Honduras
Spain Bolivia
Argentina El Salvador
Venezuela Nicaragua
Paraguay
Peru
Costa Rica
Chile
Uruguay
Ecuador
Panama
Guatemala
Cuba Equatorial Guinea
Українська (Ukrainian)
Ukraine
Русский (Russian) Abkhazia (Georgia)
Russia
Belarus South Ossetia (Georgia)
Kazakhstan
Moldova
Kyrgyzstan
Gagauzia
Polski (Polish)
Poland
中文 (Chinese) People's Republic of China Malaysia (Minority language)
Republic of China Thailand (Minority language)

Philippines (Minority
Singapore language)
Dansk (Danish)
Denmark Faroe Islands
Greenland
Svenska (Swedish)
Sweden (de facto) Estonia (only in Noarootsi)
Finland
Česky (Czech)
Czech Republic
(Japanese)
Japan
日本語
한국어 (韓國語); 조선말 (朝鮮語) North Korea Yanbian(People's Republic of

(Korean) China)
South Korea
Български (Bulgarian) Bulgaria
‫( ا‬Arabic) Algeria Morocco

Bahrain Oman
Qatar
Comoros
Saudi Arabia
Chad
Djibouti Somalia
Sudan
Egypt
Syria
Eritrea
Tunisia
Iraq
United Arab Emirates (UAE)
Israel
Yemen
Jordan
(Palestinian National
Kuwait Authority)
Lebanon Western Sahara
Libya African Union(AU)
Mauritania Arab League
Lietuvių kalba (Lithuanian) Lithuania
Latviešu valoda (Latvian) Latvia

Tiếng Viết (Vietnamese)
Vietnam
Ελληνικά (Greek)
Greece Italy (minority language)
Cyprus Turkey (minority language)
Albania (minority language)
Türkçe (Turkish)
Turkey (minority language)
‫( עברית‬Hebrew) Israel
Íslenska (Icelandic)
Iceland
Flash CalendarPro Manual Language Localizations– 57

Editing Localization Settings
Localization parameters, block titles and error messages can be additionally re-configured
by editing Settings.XML file to meet your project requirements.
When editing settings.xml file, make sure you save the file and keep UTF-8
encoding. To make sure UTF-8 encoding remains when you save the file, try “Save
As” option and see the suggested encoding.
7 Appendixes
Appendix A: Troubleshooting
CalendarPro works fine on my PC, but not when I upload it to my web server.
1. Check whether all product files are uploaded to the server (SWF, XML, etc.).
2. Check HTML code of the page. Path to SWF file might be set up incorrectly (if you
made some changes locally)
I get “Loading styles” message and nothing happens.

CalenadrPro cannot find the events.xml file (usually in the same folder with
index.html).
1. Upload the missing XML file(s).
2. You did not specify the absolute path to SWF files when inserted calendar to
different page. Check How to add Flash CalendarPro to another page on your
website section.
My CalendarPro works fine on my website online, but it returns error when trying to
create new or modify existing event in Administrative Mode.
1. Make sure you followed necessary steps to Configure Server-Side Backend for the
Administrative Mode
2. Your website hosting provider does not allow unexpected POST data
Why doesn’t CalendarPro recognize the latest changes I made to events file?
Your browser is likely to be using a previously cached version of calendar files instead of
reading the latest version. This often happens to flash content.
1. Clear the cache in your web browser. If you’re using a Meta tag in your html page to
control caching, you might have to delete it.
2. Try with / without www in the URL (browser often refers as to a different domain).
3. Try to run the calendar in a different browser and on a different PC
Administrative mode does not apply changes. It does not save changes.
Administrative area is not correctly configured. Possible reasons:
1. Server script URL to save the changes is not specified in styles.xml file.
2. Required permissions for events.xml file are not set. Follow the steps described
in the Configure Server-side Backend for the Administrative Mode section.
3. Server configuration does not allow server-side script to receive events via POST
method and save the file.
Flash CalendarPro Manual Appendixes – 59

The event is marked as undefined. What is the reason?
When the <title> tag is missing, but the <event_id> tag exists, the event will be marked
as undefined…
I receive an error notice when installing the MXP file

Make sure you have installed the latest version of Adobe Extension. The latest version can
be downloaded from: http://www.adobe.com/exchange/em_download/
When using the calendar as MXP in my Flash movie, I get a black background.
There are other third party components that override CalendarPro variables or other
elements. Macromedia components on the scene (such as list or grid) may also cause such
troubles.
1. Try using alternative components.
2. This problem does not take place when you compile CalendarPro package with the
source codes (OEM license).
Non-English characters are not showing in the captions. Why?

To allow non-English characters to show, save your XML document with ‘UTF-8’ encoding
(in Windows Notepad you can set this is the ‘Save As’ dialog). Check the documentation for
your text editor.
How can I add HTML formatting to my captions?

Caption text can include a limited set of HTML formatting, including hyperlinks, line
breaks, font tags, bold, underline and italics by wrapping HTML formatted text inside a
CDATA tag.
Supported HTML tags can be found in the Supported HTML tags section of this manual.
Appendix B: Supported HTML tags
This section lists the built-in HTML tags supported by Flash Player Pro.
Tag Description
Anchor tag (<a>) The <a> tag creates a hyperlink and supports the following
attributes:
href - Specifies the URL of the page to load in the browser. The
URL can absolute or relative to the location of the SWF file that is
loading the page.
target - Specifies the name of the target window to load the page
into.
For example, the following HTML snippet creates the link “Go
home,” which opens www.macromedia.com in a new browser
window.
<a href=”../home.htm” target=”_blank”>Go home</a>
You can also define a:link, a:hover, and a:active styles for
anchor tags by using style sheets.
Bold tag () The tag renders text as bold. A bold typeface must be
available for the font used to display the text.
This is bold text.
Break tag ( ) The tag creates a line break in the text field, as shown in this
example:
One line of text Another line of text 
Font tag () The tag specifies a font or list of fonts to display the text.
The font tag supports the following attributes:
color - Only hexadecimal color (#FFFFFF) values are supported.
For example, the following HTML code creates red text.
This is red text
face - Specifies the name of the font to use. Alternate fonts can
be specified in a comma delimted list following the primary font. If
the primary font is not installed on the playback system, or isn’t
embedded in the SWF file, then Flash Player will work through the
list until it finds a supported font.
Example:
This is either Times or
Times New Roman..
size - Specifies the size of the font, in pixels. You can also use
relative point sizes (+2 or -4).
This is green, 24-point
text
Image tag (<img>) The <img> tag lets you embed external JPEG files, SWF files, and
movie clips inside text fields. Text automatically flows around
images you embed in text fields. This tag is supported only in
dynamic and input text fields that are multiline and wrap their
text.
In the Flash authoring environment, select a text field on the Stage
and then, in the Property inspector, select Multiline from the Text
Type pop-up menu.

The <img> tag has one required attribute, src, which specifies the
path to a JPEG file, a SWF file, or the linkage identifier of a movie
clip symbol. All other attributes are optional.
The <img> tags support the following attributes:
src - Specifies the URL to a JPEG or SWF file, or the linkage
identifier for a movie clip symbol in the library. This attribute is
required; all other attributes are optional. External files (JPEG and
SWF files) are not displayed until they have downloaded
completely.
Note: Flash Player does not support progressive JPEG files.
id - Specifies the name for the movie clip instance (created by
Flash Player) that contains the embedded JPEG file, SWF file, or
movie clip. This is useful if you want to control the embedded
content with ActionScript.
width - The width of the image, SWF file, or movie clip, in pixels.
height - The height of the image, SWF file, or movie clip being
inserted, in pixels.
align - Specifies the horizontal alignment of the embedded image
within the text field. Valid values are left and right. The
default value is left.
hspace - Specifies the horizontal space that surrounds the image
where no text will appear. The default value is 8.
vspace - Specifies the vertical space that surrounds the image
where no text will appear. The default value is 8.
Italic tag () The tag displays the tagged text in italics. An italic typeface
must be available for the font used.
That is very interesting.
The above code would render as follows:
That is very interesting.
List item tag The <li> tag places a bullet in front of the text that it encloses.
(<li>) Grocery list:
<li>Apples</li>
<li>Oranges</li>
<li>Lemons</li>
Grocery list:
Apples
Oranges
Lemons
Paragraph tag The tag creates a new paragraph. It supports the following
() attributes:
align - Specifies alignment of text within the paragraph; valid
values are left, right, and center.
The following example uses the align attribute to align text on
the right side of a text field.
textField.htmlText = “This text is aligned on the
right side of the text field”;
The following example uses the class attribute to assign a text
style class to a tag.
var myStyleSheet = new TextField.StyleSheet();
myStyleSheet.secreateTextField(“test”, 10, 0,0, 300,100);
createTextField(“test”, 10, 0,0, 300,100);
test.styleSheet = myStyleSheet;
test.htmlText = “This is some body-styled
text..”;
Span tag () The tag is available only for use with CSS text styles. It
supports the following attribute:
class - Specifies a CSS style class
Underline tag The tag underlines the tagged text.

() This text is underlined.
This text is underlined.

8 Additional Services
Upgrades
• Dot and Dot Dot updates are free of charge. You can always download the latest ZIP file
from your user are at USFlashMap.com. Version upgrades usually come with 50%
discount.
• We provide discount prices for package upgrades from Standard to Business and
Business to OEM package. Upgrade prices and discounts for satellite products are
available for existing customers in USFlashMap user area.
• Licenses for additional website domains and next projects (OEM license) are also
available from user area. For volume discounts – contact us directly via website
contact form.
Bug Fixes
If you find a bug, please send us a report from your support version. It will be added to the
known bug list and will be fixed within the next product build. Usually new product build is
available 1-2 times a month. Thanks for your assistance!
Installation and Configuration

It is possible to insert Flash CalendarPro into eventually any HTML page or ActionScript
2.0 movie. Instructions provided in this manual will help you upload calendar to the web
site, setup and run there. Sample code provided in this manual will help you insert
CalendarPro to another pages of your website or scenes in the flash movie.
We differentiate two types of installation packages:
1. Simple installation
Usually required when you are using some third party content management system or
other type of website builder and need extra assistance to build in CalendarPro into
your website. If you are a customer, you may submit request for Installation and
Configuration. It is required to attach temporary access information / FTP and our
support stuff will log in and estimate amount of time required and installation cost.
2. Database Connector or Import Script
If there is a database, web service, excel spreadsheets, or other external source of
events, special DB connector is required in order to integrate Flash CalendarPro with
your data. Usually such requests are implemented by developing server-side scripts
that serve transitional layer between the data source and XML format for CalendarPro
events. You may request USFlashMap assistance with DB connector or hire other team
of developers.
Support
Flash CalendarPro comes with a short readme and user manual that describes most of the
problematic issues that may take place. Prior to contact support, please make sure your PC
and Website hosting meets product requirements and you follow all the steps from
installation guidelines.
Every product comes with 2 hours of support via CRM ticketing system or chat. If you are
still unable to find a solution for technical problem or did not find an answer to your
question – feel free to submit Support Ticket.
If you have any problems with the server-side scripts (admin mode) – please make sure you
attach the following to your ticket:
1. URL to the website page with the case, so we can check online immediately;
2. Description of your software (OS, Browser version, Flash player version) so we are
able to reproduce the case;
3. Provide temporary access information to your website hosting so our technical
support can log-in to the server and study the environment.
Please also note the time difference. Support department is located in Europe, +2GMT. We
also have holidays and day off ☺
Will you need more support or communication via email / video chat – we provide
advanced support packages with faster turnaround time and communication channels at
additional cost.
Product Customization
If you require additional features developed or modification to the existing functionality of
the software, feel free to contact us regarding product customization.
How it works:
• Customer contacts us with customization request
• USFlashMap engineers make preliminary estimate to determine the following:
o if requested feature is possible to implement
o time/cost it may take. Cost of work performed is based on the actual
company hourly rate ($30/hour).
• Customer purchases product license. If required feature changes core product
functionality and cannot be implemented as a branch, customer must to obtain
OEM license to keep the source codes with modification for future needs.
Upon obtaining product license, USFlashMap customer care manager provides a more
accurate estimate, scope of work, contract and invoice* (required for budgets over
$1,000).
*Usually USFlashMap requires upfront payment for customization requests less than one
week of time or $1,000 equivalent.
Partnership and Custom Project Development

USFlashMap team has extensive experience in the field of ActionScript 2.0, 3.0 and Flex
development, especially in the following areas:
• Interactive Maps and GIS solutions
• Calendar / Scheduling services
• Custom Flash / Flex component development
• Set-up dedicated small and mid-size development centers (5-20 people) for
outsourcing IT needs
Feel free to contact us regarding partnership and custom project development.
Flash CalendarPro Manual Additional Services– 65

Import events from CSV Plug-In
Most ERP and CRM applications provide an opportunity to export data into tabular CSV
format (Coma Separated Values Format). For these purposes we have developed a special
package that is installed on your website and provides the functionality to update calendar
events from CSV file.
Package includes the following:
• Password protected access
• File upload function
Upload CSV file onto your web server
• Versions Backup
Provide versions history list and restore option
• Installation Script
Detects hosting server technology (PHP or ASP) and verifies file permissions
• Adjustable Configuration Parameters
Need to specify alternative column titles for tabulated data (if different from
suggested) and adjust field parameters:
o Time (am/pm or 24h);
o Date template (yyyy/mm/dd format);
o Character used for separating data (“,”, “ “, “;”,”TAB” etc);
o Output file location (Events XML file by default).
Plug-in Delivery
• Plug-in is available in two versions for different hosting platform options
o PHP 5.0
o ASP.Net 2.0 framework
• Delivery time: 3-5 business days
• Plug-in cost: $500
Import Events from Microsoft Excel File Plug-In
Alternatively to CSV files, in many cases MS Excel file with events could be used to import
events into Flash CalendarPro application. MS Excel file import package includes the
following:
• Password protected access
• File upload function
Upload .XML file onto your web server.
• Versions Backup
Provide versions history list and restore option
• Installation Script
Detects hosting server technology (PHP or ASP) and verifies file permissions
• Adjustable Configuration Parameters
Need to specify alternative column titles for tabulated data (if different from
suggested) and adjust field parameters:
o Time (am/pm or 24h);
o Date template (yyyy/mm/dd format);
o Output file location (Events XML file by default).
File Format Support

• Microsoft Excel 2003
• Microsoft Excel 1997-2003
Plug-in Delivery
o PHP 5.0
o ASP.Net 2.0 framework
• Delivery time: 3-5 business days
• Plug-in cost: $500

Database Connector Plug-in
USFlashMap provides bi-directional database connector for MySQL database. This is a
complete self-sufficient web application that can be used as for simulating multi-user
calendars on your website or adjusted to connect to your event database.
Database Plug-in includes the following:
1. Installation Script
Verify file permissions and imports database dump;
2. MySQL or MS SQL Database Dump (includes test user accounts to make
sure the Database Plug-in works fine);
3. Database Administrative Panel
Create/Delete existing users, change profile.
4. Public Read-only Page
CalendarPro pulls all events from the database via connector;
5. Public Admin Page
CalendarPro pulls all events from the database via connector and is
executed in the Administrative mode. All changes are stored to the
database.
6. User Read-only Page
CalendarPro pulls all events from the database for specific user;
7. User Admin Page
CalendarPro is executed in the Administrative Mode, pulls all events from
the database and filters for specific user. All changes are stored to the
database.
*If you already have an event database and want to set-up connected to it, make sure that
the format of the corresponding fields in the sample database and your database matches.
If it is different you need to adjust the server side connector script.
Plug-in Delivery
o MySQL 4.1+, PHP 5.0
o MS SQL, .Net 2.0 framework
• Delivery time: 7 business days
• Plug-in cost: $750.00
* Installation: Typically, Installation and integration are handled by USFLashMap

support team and are already included in the package cost.
* Price may vary based on your existing DB. Please contact USFlashMap in advance
so our technical support team could check your DB / hosting server for the amount
of integration efforts required.
Event Submission Approval Plug-In
Approval of the new events plug-in enables publicity or authorized personnel to add events
that require approval prior to be added to the public calendar.
Plug-in consists of two components: Submission page(s) and Email sender.
Submission Page(s)
1. Guest User Submission Page
a. Guest submission page is open for public; no login/password is required.
b. Guest user can see all available events and add new for further approval. Until
approval such events are not visible in the public calendar.
c. Guest users can not edit already submitted events.
2. Registered User Submission Page
a. Password protected with user ID/password
b. Registered users see all public events and can add new events. User becomes
an author of this event and may edit it in the future.
c. Registered user enters email to receive notification when event status is
changed.
d. Editing personal approved event requires approval as well. Approved event with
modified details becomes pending again and is temporary removed from the
public calendar until approved.
3. Administrator Page is executed by CalendarPro in Administrative Mode.
a. Administrator can see all events, including events with status “pending”
(waiting for approval).
b. Pending events include specific icon or color mark to distinguish from already
approved events.
c. Administrator can change event status in Event Details window (Pending,
Approved, Disapproved). Based on calendar configuration, disapproved events
can be deleted at all, to avoid enormous number of events stored in the
database or events XML file.
Email Sender
Email is sent to recipients in the following cases:
• New event added for approval (to administrator);
• Approved event details changed or event deleted by author (to administrator);
• Event approved status changed (to author);
• Event details changed or event deleted by administrator (to author).
Configuration Settings
• user_editApprovedEvent (1/0)
Enables author change event details or remove events after approval;
• emailSenderURL
Turns email sender On/Off and specifies script URL;
• admin_dragPendingEvent (1/0)
Enables Administrator drag pending events (change time settings without opening
event details window);

• admin_deleteDisapprovedEvent (1/0)
Enables CalendarPro delete disapproved events automatically;
• eventCreatedTemplate
Email template for new event creation;
• eventModifiedTemplate
Email template for changing details of pending event;
• eventDeletedTemplate
Email template for deleted pending event.
Plug-in Delivery
• Available for PHP 5.0 and ASP.NET hosting servers.
• Delivery time: 7 business days
• Plug-in cost: $750.00
• Using third party content management system for your website can make adding
registered user page impossible because Login/Password authorization may not be
available). Guest submission does not have any authorization requirements and will
work everywhere.
9 Document Preview
The information in this document has been carefully checked and is believed to be
accurate. However, USFlashMap.com assumes no responsibility for any technical
inaccuracies or typographical errors that may be contained herein. In no event will be
USFlashMap.com held responsible for direct, indirect, special, incidental, consequential or
any other loss or damage caused by errors, omissions, misprints or misinterpretation of the
information found in this publication, even if advised of the possibility of such damages.
USFlashMap.com expressly disclaims any and all liability to any person, in respect of
anything done or omitted, and the consequences if anything done or omitted, by any such
person in reliance on the contents of this publication.
Change Record
Date Author Version Change Reference
4.05.2008 Yaroslav Kuntsevych 1.1 Document created form v1.1 functional
specification
12.06.2008 Yaroslav Kuntsevych 1.11 Updated company info, overview, product

screenshots and feature descriptions (liquid
layout).
21.08.2008 Yaroslav Kuntsevych 1.2 Updated after v1.2 pre-release
26.09.2008 Yaroslav Kuntsevych 1.21 Styles and events XML modifications
06.10.2008 Yaroslav Kuntsevych 1.22 Additional Services added
10.10.2008 Inna Shmun 1.23 Proof Read
13.10.2008 Alexander Rybalko 1.24 Proof Read
17.10.2008 Yaroslav Kuntsevych 1.24 <Active> tag for categories
14.11.2008 Yaroslav Kuntsevych 1.25 Installing as MXP

Configuring backend for the Administrative
Mode (SWF version)
Read-Write Integration
updateType
30.08.2009 Inna Shmun 1.30 Manual Update with regard to product upgrade
13.09.2009 Yaroslav Kuntsevych 1.31 Visuals for Installation and other sections
20.09.2009 Alexander Rybalko 1.32 Proofread of product description
24.09.2009 Inna Shmun 1.33 Application of the final version with regard to
the comments
Flash CalendarPro Manual Document Preview– 71

Document Properties
Item Details
Document Title User Guide
Author Yaroslav Kuntsevych
Creation Date 4.05.2008
Last Modification Date 24.09.2009
Last Update Inna Shmun

Calendar Pro Manual

Caricato da

Informazioni sul documento

Descrizione originale:

Copyright

Formati disponibili

Condividi questo documento

Condividi o incorpora il documento

Opzioni di condivisione

Hai trovato utile questo documento?

Questo contenuto è inappropriato?

Copyright:

Formati disponibili

Calendar Pro Manual

Caricato da

Copyright:

Formati disponibili

User Guide

Version 1.33, September 24, 2009

Flash CalendarPro V1.3

Table of Contents .................................................................. 2

Flash CalendarPro Manual Introduction – 3

All Rights Reserved

Alex Rybalko Yaroslav Kuntsevych Andrew Yarmolenko

• Chapter 2, «Product Overview», introduces the Software, describes key features

Flash CalendarPro Manual Introduction – 5

Flash CalendarPro Manual Product Overview– 7

Add Rich Media Content

Flash CalendarPro Manual Product Overview- 9

Flash CalendarPro Manual Product Overview- 11

Admin Mode Requirements

Web Hosting Server Options

MXP Package Requirements

Testdrive the Calendar Locally

Download Your Product Package

Product Download Area

You must log-in prior to downloading Flash CalendarPro installation package at

Unzip Calendar Files

Flash CalendarPro Manual Installation – 13

CalendarPro SWF package

admin Server side scripts to provide secure access and enable

Images Folder with event images

calendarPro.swf Main SWF file with all calendar functionality

events.xml Configuration file: Default XML file with calendar events

index.html Sample HTML page with Flash CalendarPro installed

license.txt End-user license agreement

settings.xml Configuration file: An xml file for customizing the calendar

Step 1. Upload Calendar Files Online

Step 2. Add Flash CalendarPro to Your Webpage

Flash CalendarPro Manual Installation – 15

<table width="100%" height="100%" border=0 cellpadding=0 cellspacing=0><tr><td>

Step 3. Setup the Administrative Mode

3.2. Run Administrative Mode page

3.3. Password Protection

For your safety, CalendarPro Administrative Mode

3.4. Changing Your Password

A) For ASPX version

login.UserName != "admin") ||(login.Password != "password")) return;

B) For PHP version

Flash CalendarPro Manual Installation – 17

Download Your Product Package

Product Download Area

You must log-in prior to downloading Flash CalendarPro installation package at

Unzip Calendar Files

Use the “including subfolders” option to extract the archive properly.

CalendarPro MXP package

admin Server side scripts to provide secure access and enable

Images Folder with event images

sampleFiles The folder with sample configuration files

calendarPro.fla FLA file with CalendarPro MXP inserted

calendarPro.mxp CalendarPro MXP component

events.xml Configuration file: Default XML file with calendar events

license.txt End-user license agreement

settings.xml Configuration file: An xml file for customizing the calendar

Flash CalendarPro Manual Installation – 19

Now you can see a newly created calendarPro.swf in your folder

Step 2. Add CalendarPro to Your Flash Movie

1. Open your existing ActionScript 2.0 file or create a new one.

Flash CalendarPro Manual Installation – 21

Step 3. Configure Server-Side Backend for the Administrative Mode