Useful hints before upgrading from earlier version to 1.1+
From WebCalendar Wiki
Contents |
[edit] Summary
If you want to upgrade from a version of WebCalendar older than 1.1+, it could be useful to do some modifications in default_config.php before running the installation-wizard. The reason is that the integrated installation-wizard will not offer the following adjustments during the process.
This file is located in the install directory of WebCalendar 1.1+.
[edit] Site Extras
Custom event fields are handled added in the includes/site_extras.php file. The EXTRA_XXX fields are no longer variables in 1.1.X/1.2.X. Additionally, there is a new 6th array item that indicates where the custom event field should be displayed. So an example like:
array ( "Directions", // unique name of this extra field (used in db) "Driving Directions", // how this field will be described to users $EXTRA_MULTILINETEXT, // type of field 50, // width of text entry 8 // height of text entry )
... should be replaced with an entry like
array ( "Directions", // unique name of this extra field (used in db) "Driving Directions", // how this field will be described to users EXTRA_MULTILINETEXT, // type of field 50, // width of text entry 8, // height of text entry EXTRA_DISPLAY_ALL //Display in all places )
Additionally, the reminder functionality is now a standard part of all events (since it is a core part of iCalendar via the VALARM property). Therefore, the $EXTRA_REMINDER type has been removed. It should be removed from your includes/site_extras.php file.
When you add new variables to Site Extras, they will blink or flash in WebCalendar 1.1+.
[edit] Timezone
The timezone cannot be adjusted during the different steps of the installation wizard.
'SERVER_TIMEZONE' => 'America/New_York',
Change this to the timezone where your server is located. (This can also be done after using the installation-wizard at the system-settings.) This should be going away soon, as we switch over to all GMT times in the database.
'TIMEZONE' => 'America/New_York',
This timezone adjustment is the default for all NEW users... I guess it's useful if you are using an intranet or a company where all have the same timezone (e.g.'Europe/Vienna'). Any existing users who have changed their preferences will not be affected.
[edit] Starting day of the week
In some countries, the week starts on 'Monday' instead of 'Sunday' .... e.g. Germany, Austria, etc.
'WEEK_START' => '0',
'0' = Sunday
'1' = Monday
We're working on making this selectable for any day of the week.
[edit] Crossday events
This feature is new to 1.1+ .... and looks very inconvenient to the participants at the beginning. So, if you want to have the same behavior (appearance) as 1.0.5 or before, change this value to 'Y'
'DISABLE_CROSSDAY_EVENTS' => 'N',
[edit] Top-Menu
This feature is also new to 1.1+ .... If you want to have the same behavior (appearance) as at 1.0.5 or before change this value to 'N'.
'MENU_ENABLED' => 'Y',
However, the old menu, at the bottom of the page, is being phased out. So, this option is going away soon.
[edit] Date Selectors position
if the most of participants using Screen resultion of 800x600 with enabled 'Top-Menue' it may be possible that the entries at the Top-Menu will be overlapped. This can be prevented by setting the value to 'N'.
'MENU_DATE_TOP' => 'Y',
[edit] Reminder Offset
if using this function in older version than 1.1.x the reminder offset will be adjusted at the site_extras.php.
$site_extras = array (
array (
"Reminder", // unique name of this extra field (used in db)
"Send Reminder", // how this field will be described to users
$EXTRA_REMINDER, // type of field
240, // arg 1: how many minutes before event should
// reminder be sent (however, this option is just
// the default when used with the
// EXTRA_REMINDER_WITH_OFFSET option) since the user
// can override this.
$EXTRA_REMINDER_WITH_OFFSET
// arg 2: specifies reminder options bit-or
)
);
in the new version of 1.1.x this entry has been adjusted at the default_config.php.
'REMINDER_OFFSET' => '240',
pay attention that the value contained minutes.
[edit] Background Image
using a background image at older versions than v1.1.x this was set at the styles.php.
body {
background-image:url(image-file.jpg); // which is in the root directory of the webcalendar
}
using this background image at the latest version you have to upload this image to the webcalendar directory too and set the proper path at the default_config.php.
'BGIMAGE' => ' ',
like
'BGIMAGE' => 'image-file.jpg',
the enterd path can be relativ or absolut.
