EXTCALENDAR (ExtCal2) COMPONENT

May 22 2005 :: Version 0.9

IMPORTANT INSTRUCTIONS

Do not use to kill or injure.

Despite working very well most of the time (and for many people all of the time) this is beta software and there are going to be bugs. If you have problems with it, first scroll down to "Known Issues." Then read all the Release Notes, Docs, and Forums. If these don't answer your question, please post in the Forums and lodge a Bug Report.

If you wish to allow image uploading in connection with events, but it's not working, you may need to find some way to change the permissions of the "com_extcalendar/upload" directory to 777. (FTP clients and shell access don't usually work since a PHP file created the directory and "owns" it.) It should work already. This installation script attempts to chmod the designated folder as 777, so with any luck it should already work fine out of the box--at least on Linux web servers!

To make this component fit the look and feel of your site, you will have to go into the "themes/default/style.css" file and perhaps into "themes/default/template.html" and do some editing BEFORE installing the component. The default color scheme is a silvery blue, like this thumbnail, but you might have to rig the styles and maybe even the HTML to make it fit your own look.

Also, be sure to set your time zone and other options using the ExtCal Settings menu option under the Components menu.

ExtCal has a brilliant "mini-calendar" which is NOT a part of this component. It is a SEPARATE installation, as it is a Mambo Module that you should be able to get from the same place you got the main component. You don't have to have the minical module installed to run the main component, but you DO have to have the component installed to run the module. The same is true for the "Latest Events" module.

USAGE NOTES

When you create or edit an event category in the Mambo Administration (under Components > ExtCal Calendar > Manage Event Categories), you have the option to "Auto approve admin submissions" and "Auto approve user submissions". If you check the latter checkbox, then any site visitor can add events instantly to your calendar. If it's unchecked, then the event will be marked as not approved, and won't actually show up on the calendar until an Admin approves it.

How do you approve user submitted events? By logging into your own FRONTEND as a Mambo administrator. When you are logged in as administrator, then a new button will appear on the calendar allowing you to approve, edit, and delete events. Note that this is NOT done from the back-end Administration area, it is done right there in the actual frontend calendar. But you do have to log in to the frontend as a Mambo admin.

Each category can have its own settings for whether events need to be approved.

HISTORY

This component was cobbled together out of the Version 2, Beta 1 release (and CVS files as of Feb. 23, 2005) of the excellent ExtCalendar 2 app, by Mohamed Moujami (SimoAmi), at http://extcal.sourceforge.net.

It is based on a STOCK installation of the calendar, with obvious modifications to elements like login and session management and database calls in order to use Mambo's existing structure for this. So you may be able to look at future ExtCal versions and upgrade this Mambo component by doing careful comparisons.

This version has language files for:

However, with the exception of Danish, German, and Swedish, which were done by experts, I cannot guarantee the accuracy of the non-English language files; they should be checked and not taken for granted; they were done by other people and may be incomplete or inaccurate. All the basic language elements for the public interface seem to be there, however, as far as I've checked. Ones with obvious language gaps I removed.

Also, there are some pieces of text in the Administration area of the component which are ONLY in English. You can manually change the "admin.config.inc.php" file to translate the text on the Edit Settings screen if you want; I deliberately avoided adding new entries to the language files, which would have meant creating new translations in every language and losing language-file compatibility with the standalone ExtCal script.

If you like this component, visit my page at www.whatismoving.com and buy a copy of my kick-ass independent film!

KNOWN ISSUES