diff --git a/UPGRADING.html b/UPGRADING.html index 9f17dfbb8..8c575ce84 100644 --- a/UPGRADING.html +++ b/UPGRADING.html @@ -1,86 +1,32 @@ - - - + + + WebCalendar Upgrading Notes - + - +

WebCalendar Upgrading Notes

- - - +
WebCalendar Version: 1.3.0
Document Version: $Revision$
$Date$
+ + + +
WebCalendar Version:1.2.7
-

Important News: A major +

Important News: A major improvement beginning with Version 1.1 is the addition of an automated installation script. This script will guide you through the installation process and help identify any problem areas that might prevent successful installation or operation of WebCalendar.

-
  • Make a backup of your current WebCalendar files on the server. You would typically do this with an FTP client - (like FileZilla). + (like FileZilla).
  • Install the new WebCalendar files in a new directory on your server. @@ -160,51 +107,49 @@

    Upgrading Steps

    files will create a directory with the current WebCalendar version name in it.
  • Optional: - If you prefer to use a simple name (like "webcalendar" rather than "WebCalendar-1.1.6"), + If you prefer to use a simple name (like "webcalendar" rather than "WebCalendar-1.2.7"), then you can rename the directory after you've installed the files. A good way to do this might be to rename your old webcalendar install to something like "webcalendar-oldinstall" and rename the new install to be the same name as your old one. -
    Note: If you are planning on renaming the directory, it is best to do +
    Note: If you are planning on renaming the directory, it is best to do this before you proceed to the automated install.
    • -
  • Change the permissions the permissions of the includes directory. +
  • Change the permissions of the includes directory. If you are doing this from FTP, change directories to the new webcalendar directory - and use the following command:
    -   chmod 777 includes -
  • Change the permissions the permissions of the icons directory. + and use the following command:
    +   chmod 777 includes +
  • Change the permissions of the icons directory. If you are doing this from FTP, change directories to the new webcalendar directory - and use the following command:
    -   chmod 777 icons + and use the following command:
    +   chmod 777 icons -
  • Download a copy of your old includes/settings.php file from the old +
  • Download a copy of your old includes/settings.php file from your current WebCalendar install and have it handy so you can enter the same values in your upgrade process.
    • -
  • Download all files in your old icons directory from your old - WebCalendar and copy the files into the icons directory in +
  • Download all files in your old icons directory from your old + WebCalendar and copy the files into the icons directory in the new install directory.
  • You're now ready to start the install/upgrade wizard. Point your browser to the web server where you have installed the files. You only need to specify - the webcalendar directory to get to the wizard. Because there is no - includes/settings.php file in the new install, you will be redirected + the webcalendar directory to get to the wizard. Since there is no + includes/settings.php file in the new install, you will be redirected to the install/upgrade wizard.
    • - -
  • Once the wizard is complete, it's a good idea to change your includes + +
  • Once the wizard is complete, it's a good idea to change your includes permissions back to what they were originally for better security.
    • -
    +

    Manual Upgrade Instructions

    Below are the steps needed to manually upgrade from a previous version. You can ignore everything below if you use the Automated Installation Script. Select the version of your existing install from the list below. - If you are more than one version behind (i.e. the new version is v1.1.6, - and you're using 0.9.39), click the "next..." link at the end of each - section to move to the next version. - Always follow the versions in sequence.

    + If you are more than one version behind (i.e. the new version is v1.2.7, + and you're using 1.1.1), you'll need to perform each upgrade in sequence from your current version on up. Don't skip any.

    Note: Due to large number of database types that WebCalendar can support, it would be impractical to list all the SQL @@ -214,14 +159,19 @@

    Manual Upgrade Instructions

    database other then MySQL, you may want refer to the appropriate upgrade-xxxxx.sql file in the install/sql folder.

    -

    My previous install was...

    +

    My currently installed version is...

    -
    +

    To upgrade from v0.9

    You need to create the table cal_user_pref in tables.sql. You need to @@ -246,7 +196,7 @@

    To upgrade from v0.9

    "cal_event_user" in the 0.9 release.

    next... -
    +

    To upgrade from v0.9.01

    @@ -263,7 +213,7 @@

    To upgrade from v0.9.01

    WebCalendar tables.

    next... -
    +

    To upgrade from v0.9.07 - v0.9.11

    @@ -273,7 +223,7 @@

    To upgrade from v0.9.07 - v0.9.11

    UPDATE webcal_entry SET cal_time = -1 WHERE cal_time is null;
    next... -
    +

    To upgrade from v0.9.12 or v0.9.13

    @@ -292,7 +242,7 @@

    To upgrade from v0.9.12 or v0.9.13

    next... -
    +

    To upgrade from v0.9.14 - v0.9.21

    @@ -310,7 +260,7 @@

    To upgrade from v0.9.14 - v0.9.21

    next... -
    +

    To upgrade from v0.9.22 - v0.9.26

    @@ -347,7 +297,7 @@

    To upgrade from v0.9.22 - v0.9.26

    ports/look-a-likes of cron for Windows, so look around.

    next... -
    +

    To upgrade from v0.9.27 - v0.9.34

    @@ -397,7 +347,7 @@

    To upgrade from v0.9.27 - v0.9.34

    next... -
    +

    To upgrade from v0.9.35 or v0.9.36

    @@ -414,7 +364,7 @@

    To upgrade from v0.9.35 or v0.9.36

    next... -
    +

    To upgrade from v0.9.37

    @@ -432,7 +382,7 @@

    To upgrade from v0.9.37

    next... -
    +

    To upgrade from v0.9.38

    @@ -445,7 +395,7 @@

    To upgrade from v0.9.38

    next... -
    +

    To upgrade from v0.9.39

    @@ -469,7 +419,7 @@

    To upgrade from v0.9.39

    next... -
    +

    To upgrade from v0.9.40

    @@ -487,7 +437,7 @@

    To upgrade from v0.9.40

    next... -
    +

    To upgrade from v0.9.41

    @@ -527,7 +477,7 @@

    To upgrade from v0.9.41

    next... -
    +

    To upgrade from v0.9.42

    @@ -556,7 +506,7 @@

    To upgrade from v0.9.42

    ); -

    Next, you will need to run the script found in the tools +

    Next, you will need to run the script found in the tools subdirectory. This will convert all your passwords from plain text to md5. You can run this from the command line (if you have a standalone version of PHP compiled):

    @@ -571,18 +521,17 @@

    To upgrade from v0.9.42

    http://yourcalendarurl/tools/convert_passwords.php
    -

    You may safely delete the file /tools/convert_passwords.php +

    You may safely delete the file /tools/convert_passwords.php after successfully performing this step.

    Delete all webcalendar_login browser cookies. Details should be available on your local browser help section.

    - next... -
    + next... +
    +

    To upgrade from v0.9.43 - v1.0RC3

    -

    To upgrade from v0.9.43 - v1.0RC2

    - -

    The webcal_view table was modified. Execute the following SQL +

    The webcal_view table was modified. Execute the following SQL to update your database:

    @@ -600,7 +549,7 @@ 
    To upgrade from v0.9.43 - v1.0RC2
    next... -
    +

    To upgrade from v1.0RC3 - v1.0.0

    @@ -631,10 +580,9 @@

    To upgrade from v1.0RC3 - v1.0.0

    PRIMARY KEY ( cal_login, cal_type ) ); - -
    - -

    To upgrade from v1.1.0-CVS or v1.1.0a-CVS

    + next... +
    +

    To upgrade from 1.1.0-CVS or 1.1.0a-CVS

    A new table is needed to support multiple categories. In addition, several new columns have been added to webcal_entry and one column added to @@ -667,15 +615,469 @@

    To upgrade from v1.1.0-CVS or v1.1.0a-CVS

    cat_owner varchar(25) default NULL ); + next... +
    +

    To upgrade from 1.1.0b-CVS

    +

    We need a new table to handle event attachments and comments. This is the SQL.

    + 
    +CREATE TABLE webcal_blob (
+  cal_blob_id INT NOT NULL,
+  cal_description VARCHAR(128) NULL,
+  cal_id INT NULL,
+  cal_login VARCHAR(25) NULL,
+  cal_mime_type VARCHAR(50) NULL,
+  cal_mod_date INT NOT NULL,
+  cal_mod_time INT NOT NULL,
+  cal_name VARCHAR(30) NULL,
+  cal_size INT NULL,
+  cal_type CHAR(1) NOT NULL,
+  cal_blob LONGBLOB,
+  PRIMARY KEY (cal_blob_id)
+);
+
    + next... +
    +

    upgrading from 1.1.0cCVS

    +

    We're recreating table webcal_access_user to add several fields.

    + 
    +DROP TABLE IF EXISTS webcal_access_user;
+CREATE TABLE webcal_access_user (
+  cal_login VARCHAR(25) NOT NULL,
+  cal_other_user VARCHAR(25) NOT NULL,
+  cal_can_approve INT NOT NULL DEFAULT '0',
+  cal_can_edit INT NOT NULL DEFAULT '0',
+  cal_can_email CHAR(1) DEFAULT 'Y',
+  cal_can_invite CHAR(1) DEFAULT 'Y',
+  cal_can_view INT NOT NULL DEFAULT '0',
+  cal_see_time_only CHAR(1) DEFAULT 'N',
+  PRIMARY KEY (cal_login, cal_other_user)
+);
+
    + next... +
    +

    upgrading from 1.1.0d-CVS

    +

    A new table to track reminders. When are they due? Have they been sent?

    + 
    +CREATE TABLE webcal_reminders (
+  cal_id INT NOT NULL DEFAULT '0',
+  cal_action VARCHAR(12) NOT NULL DEFAULT 'EMAIL',
+  cal_before CHAR(1) NOT NULL DEFAULT 'Y',
+  cal_date INT NOT NULL DEFAULT '0',
+  cal_duration INT NOT NULL DEFAULT '0',
+  cal_last_sent INT NOT NULL DEFAULT '0',
+  cal_offset INT NOT NULL DEFAULT '0',
+  cal_related CHAR(1) NOT NULL DEFAULT 'S',
+  cal_repeats INT NOT NULL DEFAULT '0',
+  cal_times_sent INT NOT NULL DEFAULT '0',
+  PRIMARY KEY (cal_id)
+);
+
    + next... +
    +

    Upgrade from 1.1.0e-CVS

    +

    A new field indicating the URL of a public, or at least a non-user, calendar event.

    + 
    +ALTER TABLE webcal_nonuser_cals ADD cal_url VARCHAR(255) DEFAULT NULL;
+
    + next... +
    +

    Upgrade from 1.1.1

    +

    Add a color for each user category. We are also considering tracking more user data; birthday, phone, etc. As a contact reference as well as an event calendar.

    + 
    +ALTER TABLE webcal_categories ADD cat_color VARCHAR(8) DEFAULT NULL;
+ALTER TABLE webcal_user ADD cal_address VARCHAR(75) DEFAULT NULL;
+ALTER TABLE webcal_user ADD cal_birthday INT NULL;
+ALTER TABLE webcal_user ADD cal_enabled CHAR(1) DEFAULT 'Y';
+ALTER TABLE webcal_user ADD cal_last_login INT NULL;
+ALTER TABLE webcal_user ADD cal_telephone VARCHAR(50) DEFAULT NULL;
+ALTER TABLE webcal_user ADD cal_title VARCHAR(75) DEFAULT NULL;
+
    + next... +
    +

    Upgrade from 1.1.2

    +

    A new table to hold the various timezones of the world. How far from Greenich Mean Time? When does Daylight Savings start / end, if applicable.

    + 
    +CREATE TABLE webcal_timezones (
+  tzid varchar(100) NOT NULL default '',
+  dtstart varchar(25) default NULL,
+  dtend varchar(25) default NULL,
+  vtimezone text,
+  PRIMARY KEY (tzid)
+);
+
    + next... +
    +

    Upgrade from 1.1.3

    +

    // Craig. This LOOKS like an extensive upgrade. However, mostly it's just putting the table / field /*comments*/ from "install/sql/tables-mysql.sql" in the actual database to make maintaining it easier. Also, phpMyAdmin can use the "COMMENT"s to create a replacement for "docs/WebCalendar-Database.html" without the need for "docs/sql2html.pl". Mostly. It isn't quite as clean:

    But, it looks the same otherwise.

    phpMyAdmin "export" puts the "ENGINE" and "CHARSET" in the file, so I included them, too.
    I am also utilizing MySQL / MariaDB field types such as enum, tinyint, etc. to better show what the field is about.

    Converting from MySQL / Maria to all the other dababase types supported by WebCalendar only takes about 50 lines total, mostly preg_replace() with arrays, in a switch construct. We would only need a single "tables.sql" and a single "upgrade.sql" instead of all the variants. (Work in progress.)

    The new table, "webcal_translations" (not yet used) to hold the various language translations. Eventually would eliminate all the various "translations/*.txt" files. "tools/update_translation.pl" could create the sql files to load it, while creating the *.txt files for the translators.

    I'm also looking at consolidating some fields / tables into webcal_user_pref. Only takes about 100 lines of code changes. Not counting the "/*Consolodate some fields*/" section below. What do you think? bb +

    + 
    +ALTER TABLE webcal_access_user ENGINE MyISAM CHARACTER SET utf8 COMMENT 'Specifies which users can access another user''s calendar.';
+ALTER TABLE webcal_access_user MODIFY cal_see_time_only ENUM('N','Y') NOT NULL DEFAULT 'N' COMMENT 'Can current user can only see time of other user?';
+ALTER TABLE webcal_access_user MODIFY cal_can_view smallint UNSIGNED NOT NULL DEFAULT '0' COMMENT 'Can current user view events on the other user''s calendar?' FIRST;
+ALTER TABLE webcal_access_user MODIFY cal_can_invite ENUM('N','Y') NOT NULL DEFAULT 'Y' COMMENT 'Can current user see other user in Participant lists?' FIRST;
+ALTER TABLE webcal_access_user MODIFY cal_can_email ENUM('N','Y') DEFAULT 'Y' COMMENT 'Can current user send emails to other user?' FIRST;
+ALTER TABLE webcal_access_user MODIFY cal_can_edit smallint UNSIGNED NOT NULL DEFAULT '0' COMMENT 'Can current user edit events on the other user''s calendar?' FIRST;
+ALTER TABLE webcal_access_user MODIFY cal_can_approve smallint UNSIGNED NOT NULL DEFAULT '0' COMMENT 'Can current user approve events on the other user''s calendar?' FIRST;
+ALTER TABLE webcal_access_user MODIFY cal_other_user varchar(25) NOT NULL COMMENT 'The login of the other user whose calendar the current user wants to access. Also, from <a href="#webcal_user">webcal_user</a> table.' FIRST;
+ALTER TABLE webcal_access_user MODIFY cal_login varchar(25) NOT NULL COMMENT 'The current user who is attempting to look at another user''s calendar. From <a href="#webcal_user">webcal_user</a> table.' FIRST;
+
+ALTER TABLE webcal_access_function ENGINE MyISAM CHARACTER SET utf8 COMMENT 'Specifies what WebCalendar functions a user can access. Each function has a corresponding numeric value (specified in the file includes/access.php). For example, view event is 0, so the very first character in the cal_permissions column is either a "Y" if this user can view events or a "N" if they cannot.';
+ALTER TABLE webcal_access_function MODIFY cal_login varchar(25) NOT NULL COMMENT 'User login. From <a href="#webcal_user">webcal_user</a> table.' FIRST;
+ALTER TABLE webcal_access_function MODIFY cal_permissions varchar(64) NOT NULL COMMENT 'A string of "Y"s and/or "N"s for the various functions.';
+
+ALTER TABLE webcal_asst ENGINE MyISAM CHARACTER SET utf8 COMMENT 'Define assistant/boss relationship.';
+ALTER TABLE webcal_asst MODIFY cal_assistant varchar(25) NOT NULL COMMENT 'Assistant login. Also from <a href="#webcal_user">webcal_user</a> table.';
+ALTER TABLE webcal_asst MODIFY cal_boss varchar(25) NOT NULL COMMENT 'Boss login. From <a href="#webcal_user">webcal_user</a> table.' FIRST;
+
+ALTER TABLE webcal_blob ENGINE MyISAM CHARACTER SET utf8 COMMENT 'This table stores event attachments and comments.';
+ALTER TABLE webcal_blob MODIFY cal_type ENUM('A','C') NOT NULL DEFAULT 'C' COMMENT 'Type of object: C=Comment, A=Attachment.' FIRST;
+ALTER TABLE webcal_blob MODIFY cal_size int UNSIGNED DEFAULT NULL COMMENT 'Size of object (not used for comments).' FIRST;
+ALTER TABLE webcal_blob MODIFY cal_name varchar(30) DEFAULT NULL COMMENT 'Filename of object (not used for comments).' FIRST;
+ALTER TABLE webcal_blob MODIFY cal_mod_time time NOT NULL COMMENT 'Time added.' FIRST;
+ALTER TABLE webcal_blob ADD cal_mod TIMESTAMP on update CURRENT_TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'When was this added / changed?' FIRST;
+ALTER TABLE webcal_blob MODIFY cal_mod TIMESTAMP on update CURRENT_TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'When was this added / changed?' FIRST;
+ALTER TABLE webcal_blob MODIFY cal_mime_type varchar(50) DEFAULT NULL COMMENT 'MIME type of object (as specified by browser during upload (not used for comment).' FIRST;
+ALTER TABLE webcal_blob MODIFY cal_login varchar(25) DEFAULT NULL COMMENT 'Login of user who created. From <a href="#webcal_user">webcal_user</a> table.' FIRST;
+ALTER TABLE webcal_blob MODIFY cal_id int UNSIGNED DEFAULT NULL COMMENT 'Event id (if applicable). From <a href="#webcal_entry">webcal_entry</a> table.' FIRST;
+ALTER TABLE webcal_blob MODIFY cal_description varchar(128) DEFAULT NULL COMMENT 'Description of what the object is (subject for comment).' FIRST;
+ALTER TABLE webcal_blob MODIFY cal_blob_id int UNSIGNED NOT NULL AUTO_INCREMENT COMMENT 'Unique identifier for this object.' FIRST;
+ALTER TABLE webcal_blob MODIFY cal_blob longblob COMMENT 'Binary data for object.';
+ALTER TABLE webcal_blob ADD UNIQUE KEY wb_cl_cd (cal_login,cal_description);
+
+ALTER TABLE webcal_categories ENGINE MyISAM CHARACTER SET utf8 COMMENT 'Defines user categories. Categories can be specific to a user or global. When a category is global, the cat_owner field will be NULL. (Only an admin user can create a global category.)';
+ALTER TABLE webcal_categories MODIFY cat_name varchar(80) NOT NULL COMMENT 'Category name.' FIRST;
+ALTER TABLE webcal_categories MODIFY cat_color varchar(7) DEFAULT NULL COMMENT 'RGB color for category.' FIRST;
+ALTER TABLE webcal_categories MODIFY cat_id int UNSIGNED NOT NULL AUTO_INCREMENT COMMENT 'Unique category id.' FIRST;
+ALTER TABLE webcal_categories MODIFY cat_owner varchar(25) DEFAULT NULL COMMENT 'User login of category owner. From <a href="#webcal_user">webcal_user</a> table, if applicable. If this is NULL, then it is a global category.';
+
+ALTER TABLE webcal_config ENGINE MyISAM CHARACTER SET utf8 COMMENT 'System settings (set by the admin interface in admin.php).';
+ALTER TABLE webcal_config MODIFY cal_setting varchar(50) NOT NULL COMMENT 'System setting.' FIRST;
+ALTER TABLE webcal_config MODIFY cal_value varchar(100) NULL COMMENT 'System setting value.';
+
+ALTER TABLE webcal_entry ENGINE MyISAM CHARACTER SET utf8 COMMENT 'Defines a calendar event. Each event in the system has one entry in this table unless the event starts before midnight and ends after midnight. In that case a secondary event will be created with cal_ext_for_id set to the cal_id of the original entry. The following tables contain additional information about each event:<ul><li><a href="#webcal_entry_user">webcal_entry_user</a> table - lists participants in the event and specifies the status (accepted, rejected) and category of each participant.</li><li><a href="#webcal_entry_repeats">webcal_entry_repeats</a> table - contains information if the event repeats.</li><li><a href="#webcal_entry_repeats_not">webcal_entry_repeats_not</a> table - specifies which dates the repeating event does not repeat (because they were deleted or modified for just that date by the user.)</li><li><a href="#webcal_entry_log">webcal_entry_log</a> table - provides a history of changes to this event.</li><li><a href="#webcal_site_extras">webcal_site_extras</a> table - stores event data as defined in site_extras.php (such as reminders and other custom event fields).</li></ul>';
+ALTER TABLE webcal_entry MODIFY cal_url varchar(100) DEFAULT NULL COMMENT 'URL of event.';
+ALTER TABLE webcal_entry MODIFY cal_type ENUM('E','M','T') DEFAULT 'E' COMMENT '"E" = Event, "M" = Repeating event, "T" = Task.' FIRST;
+ALTER TABLE webcal_entry MODIFY cal_time time DEFAULT NULL COMMENT 'Event start time.' FIRST;
+ALTER TABLE webcal_entry MODIFY cal_priority tinyint UNSIGNED DEFAULT '5' COMMENT 'Event priority: 1=High, 9=Low.' FIRST;
+ALTER TABLE webcal_entry MODIFY cal_name varchar(80) NOT NULL COMMENT 'Brief description of event.' FIRST;
+ALTER TABLE webcal_entry MODIFY cal_mod_time time DEFAULT NULL COMMENT 'Time the event was last modified.' FIRST;
+ALTER TABLE webcal_entry ADD cal_mod TIMESTAMP on update CURRENT_TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'When was this added / changed?' FIRST;
+ALTER TABLE webcal_entry MODIFY cal_mod TIMESTAMP on update CURRENT_TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'When was this added / changed?' FIRST;
+ALTER TABLE webcal_entry MODIFY cal_location varchar(100) DEFAULT NULL COMMENT 'Location of event.' FIRST;
+ALTER TABLE webcal_entry MODIFY cal_group_id int UNSIGNED DEFAULT NULL COMMENT 'The parent event id if this event is overriding an occurrence of a repeating event. From this table.' FIRST;
+ALTER TABLE webcal_entry MODIFY cal_ext_for_id int UNSIGNED DEFAULT NULL COMMENT 'Used when an event goes past midnight into the next day, in which case an additional entry in this table will use this field to indicate the original event cal_id.' FIRST;
+ALTER TABLE webcal_entry MODIFY cal_duration int UNSIGNED NOT NULL COMMENT 'Duration of event in minutes.' FIRST;
+ALTER TABLE webcal_entry MODIFY cal_due_time time DEFAULT NULL COMMENT 'Task due time.' FIRST;
+ALTER TABLE webcal_entry ADD cal_due datetime DEFAULT NULL COMMENT 'When is this task due?' FIRST;
+ALTER TABLE webcal_entry MODIFY cal_due datetime DEFAULT NULL COMMENT 'When is this task due?' FIRST;
+ALTER TABLE webcal_entry ADD cal_datetime datetime NOT NULL COMMENT 'When is this event scheduled to start?' FIRST;
+ALTER TABLE webcal_entry MODIFY cal_datetime datetime NOT NULL COMMENT 'When is this event scheduled to start?' FIRST;
+ALTER TABLE webcal_entry MODIFY cal_date date NOT NULL COMMENT 'Date of event.' FIRST;
+ALTER TABLE webcal_entry MODIFY cal_create_by varchar(25) NOT NULL COMMENT 'Login of user that created the event. From <a href="#webcal_user">webcal_user</a> table.' FIRST;
+ALTER TABLE webcal_entry MODIFY cal_completed date DEFAULT NULL COMMENT 'Date task completed.' FIRST;
+ALTER TABLE webcal_entry MODIFY cal_access ENUM('C','P','R') DEFAULT 'P' COMMENT '"P" = Public, "R" = Private (others cannot see the event), "C" = Confidential (others can see time allocated but not what it is).' FIRST;
+ALTER TABLE webcal_entry MODIFY cal_id int UNSIGNED NOT NULL AUTO_INCREMENT COMMENT 'Unique integer id for event.' FIRST;
+UPDATE webcal_entry SET cal_datetime = CONCAT(cal_date,cal_time);
+UPDATE webcal_entry SET cal_due = CONCAT(cal_due_date,cal_due_time);
+
+ALTER TABLE webcal_entry_categories ENGINE MyISAM CHARACTER SET utf8 COMMENT 'Contains category foreign keys to enable multiple categories for each event or task.';
+ALTER TABLE webcal_entry_categories MODIFY cat_owner varchar(25) DEFAULT NULL COMMENT 'User that owns this record. Global categories will be NULL. From <a href="#webcal_user">webcal_user</a> table.' FIRST;
+ALTER TABLE webcal_entry_categories MODIFY cat_order int UNSIGNED NOT NULL DEFAULT '0' COMMENT 'Order that user requests their categories appear. Globals are always last.';
+ALTER TABLE webcal_entry_categories MODIFY cat_id int UNSIGNED NOT NULL DEFAULT '0' COMMENT 'Id of category from <a href="webcal_categories">webcal_categories</a> table.' FIRST;
+ALTER TABLE webcal_entry_categories MODIFY cal_id int UNSIGNED NOT NULL DEFAULT '0' COMMENT 'Id of event from <a href="webcal_entry">webcal_entry</a> table.' FIRST;
+
+ALTER TABLE webcal_entry_ext_user ENGINE MyISAM CHARACTER SET utf8 COMMENT 'External user (no login) for an event.';
+ALTER TABLE webcal_entry_ext_user MODIFY cal_fullname varchar(50) NOT NULL COMMENT 'external user full name';
+ALTER TABLE webcal_entry_ext_user MODIFY cal_email varchar(75) NULL COMMENT 'external user email (for sending a reminder)' FIRST;
+ALTER TABLE webcal_entry_ext_user MODIFY cal_id int UNSIGNED NOT NULL DEFAULT '0' COMMENT 'From <a href="webcal_entry">webcal_entry</a> table.' FIRST;
+
+ALTER TABLE webcal_entry_log ENGINE MyISAM CHARACTER SET utf8 COMMENT 'Activity log for an event.';
+ALTER TABLE webcal_entry_log MODIFY cal_user_cal varchar(25) DEFAULT NULL COMMENT 'User of calendar affected. Also from <a href="#webcal_user">webcal_user</a> table.' FIRST;
+ALTER TABLE webcal_entry_log MODIFY cal_type ENUM('A','C','E','M','R','U') NOT NULL DEFAULT 'C' COMMENT 'Log types:<ul><li>C: Created</li><li>A: Approved/Confirmed by user</li><li>R: Rejected by user</li><li>U: Updated by user</li><li>M: Mail Notification sent</li><li>E: Reminder sent</li></ul>' FIRST;
+ALTER TABLE webcal_entry_log MODIFY cal_time time DEFAULT NULL FIRST;
+ALTER TABLE webcal_entry_log MODIFY cal_text text COMMENT 'Optional text.';
+ALTER TABLE webcal_entry_log ADD cal_mod TIMESTAMP on update CURRENT_TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'When was this added / changed?' FIRST;
+ALTER TABLE webcal_entry_log MODIFY cal_login varchar(25) NOT NULL COMMENT 'User who performed this action. From <a href="#webcal_user">webcal_user</a> table.' FIRST;
+ALTER TABLE webcal_entry_log MODIFY cal_entry_id int UNSIGNED NOT NULL COMMENT 'Event id. From <a href="#webcal_entry">webcal_entry</a> table.' FIRST;
+ALTER TABLE webcal_entry_log MODIFY cal_date date NOT NULL FIRST;
+ALTER TABLE webcal_entry_log MODIFY cal_log_id int UNSIGNED NOT NULL AUTO_INCREMENT COMMENT 'Unique id of this log entry.' FIRST;
+
+ALTER TABLE webcal_entry_repeats ENGINE MyISAM CHARACTER SET utf8 COMMENT 'Defines repeating info about an event. The event is defined in <a href="#webcal_entry">webcal_entry</a> table.';
+ALTER TABLE webcal_entry_repeats MODIFY cal_type varchar(20) DEFAULT NULL COMMENT 'Type of repeating:<ul><li>daily - repeats daily</li><li>monthlyByDate - repeats on same day of the month</li><li>monthlyBySetPos - repeats based on position within other ByXXX values</li><li>monthlyByDay - repeats on specified weekday, (2nd Monday, for example)</li><li>weekly - repeats every week</li><li>yearly - repeats on same date every year</li></ul>' FIRST;
+ALTER TABLE webcal_entry_repeats MODIFY cal_frequency int UNSIGNED DEFAULT '1' COMMENT 'Frequency of repeat: 1 = every, 2 = every other, 3 = every 3rd, etc.' FIRST;
+ALTER TABLE webcal_entry_repeats ADD cal_enddt datetime DEFAULT NULL COMMENT 'End date and time for repeating event.' FIRST;
+ALTER TABLE webcal_entry_repeats MODIFY cal_enddt datetime DEFAULT NULL COMMENT 'End date and time for repeating event.' FIRST;
+ALTER TABLE webcal_entry_repeats MODIFY cal_end date DEFAULT NULL COMMENT 'End date for repeating event.' FIRST;
+ALTER TABLE webcal_entry_repeats MODIFY cal_wkst ENUM('MO','TU','WE','TH','FR','SA','SU') DEFAULT 'MO' COMMENT 'Week starts on...';
+ALTER TABLE webcal_entry_repeats MODIFY cal_days ENUM('N','Y') DEFAULT NULL COMMENT 'NO LONGER USED. We''ll leave it in for now.' FIRST;
+ALTER TABLE webcal_entry_repeats MODIFY cal_count int UNSIGNED DEFAULT NULL FIRST;
+ALTER TABLE webcal_entry_repeats MODIFY cal_byyearday varchar(50) DEFAULT NULL FIRST;
+ALTER TABLE webcal_entry_repeats MODIFY cal_byweekno varchar(50) DEFAULT NULL FIRST;
+ALTER TABLE webcal_entry_repeats MODIFY cal_bysetpos varchar(50) DEFAULT NULL FIRST;
+ALTER TABLE webcal_entry_repeats MODIFY cal_bymonthday varchar(100) DEFAULT NULL FIRST;
+ALTER TABLE webcal_entry_repeats MODIFY cal_bymonth varchar(50) DEFAULT NULL FIRST;
+ALTER TABLE webcal_entry_repeats MODIFY cal_byday varchar(100) DEFAULT NULL COMMENT 'The following columns are values as specified in RFC2445.' FIRST;
+ALTER TABLE webcal_entry_repeats MODIFY cal_id int UNSIGNED NOT NULL DEFAULT '0' COMMENT 'Event id. From <a href="#webcal_entry">webcal_entry</a> table.' FIRST;
+UPDATE webcal_entry_repeats SET cal_enddt = CONCAT(cal_end,cal_endtime);
+
+ALTER TABLE webcal_entry_repeats_not ENGINE MyISAM CHARACTER SET utf8 COMMENT 'This table specifies which dates in a repeating event have either been deleted, included, or replaced with another event for that day. When replaced, the cal_group_id (I know... not the best name, but it was not being used) column will be set to the original event. That way the user can delete the original event and (at the same time) delete any exception events.';
+ALTER TABLE webcal_entry_repeats_not MODIFY cal_date DATE NOT NULL COMMENT 'Date event should not repeat.' FIRST;
+ALTER TABLE webcal_entry_repeats_not MODIFY cal_id int UNSIGNED NOT NULL COMMENT 'Event id of repeating event. From <a href="#webcal_entry">webcal_entry</a> table.' FIRST;
+ALTER TABLE webcal_entry_repeats_not MODIFY cal_exdate tinyint UNSIGNED NOT NULL DEFAULT '1' COMMENT 'Indicates whether this record is an exclusion1) or inclusion0).';
+
+ALTER TABLE webcal_entry_user ENGINE MyISAM CHARACTER SET utf8 COMMENT 'This table associates one or more users with an event by the event id. The event can be found in <a href="#webcal_entry">webcal_entry</a> table.';
+ALTER TABLE webcal_entry_user MODIFY cal_status ENUM('A','C','D','P','R','W') DEFAULT 'A' COMMENT 'Status of event for this user:<ul><li>A=Accepted</li><li>C=Completed</li><li>D=Deleted</li><li>P=In-Progress</li><li>R=Rejected/Declined</li><li>W=Waiting</li></ul>';
+ALTER TABLE webcal_entry_user MODIFY cal_percent tinyint UNSIGNED NOT NULL DEFAULT '0' COMMENT 'Task percentage of completion for this user''s task.' FIRST;
+ALTER TABLE webcal_entry_user MODIFY cal_category int UNSIGNED DEFAULT NULL COMMENT 'Category of the event for this user.' FIRST;
+ALTER TABLE webcal_entry_user MODIFY cal_login varchar(25) NOT NULL COMMENT 'Participant in the event. From <a href="#webcal_user">webcal_user</a> table.' FIRST;
+ALTER TABLE webcal_entry_user MODIFY cal_id int UNSIGNED NOT NULL DEFAULT '0' COMMENT 'Event id. From <a href="#webcal_entry">webcal_entry</a> table.' FIRST;
+
+ALTER TABLE webcal_group ENGINE MyISAM CHARACTER SET utf8 COMMENT 'Define a group. Group members can be found in <a href="#webcal_group_user">webcal_group_user</a> table.';
+ALTER TABLE webcal_group MODIFY cal_owner varchar(25) DEFAULT NULL COMMENT 'User login of user that created this group. From <a href="#webcal_user">webcal_user</a> table.';
+ALTER TABLE webcal_group MODIFY cal_name varchar(50) NOT NULL COMMENT 'Name of the group.' FIRST;
+ALTER TABLE webcal_group MODIFY cal_last_update TIMESTAMP on update CURRENT_TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'Date last updated.' FIRST;
+ALTER TABLE webcal_group MODIFY cal_group_id int UNSIGNED NOT NULL AUTO_INCREMENT COMMENT 'Unique group id.' FIRST;
+
+ALTER TABLE webcal_group_user ENGINE MyISAM CHARACTER SET utf8 COMMENT 'Group members.';
+ALTER TABLE webcal_group_user MODIFY cal_login varchar(25) NOT NULL COMMENT 'From <a href="webcal_user">webcal_user</a>';
+ALTER TABLE webcal_group_user MODIFY cal_group_id int UNSIGNED NOT NULL COMMENT 'From <a href="webcal_group">webcal_group</a>' FIRST;
+
+ALTER TABLE webcal_import ENGINE MyISAM CHARACTER SET utf8 COMMENT 'Used to track import data (one row per import).';
+ALTER TABLE webcal_import MODIFY cal_type varchar(10) NOT NULL COMMENT 'Type of import (ical, vcal, palm, outlookcsv).';
+ALTER TABLE webcal_import MODIFY cal_name varchar(50) DEFAULT NULL COMMENT 'Name of import (optional).' FIRST;
+ALTER TABLE webcal_import MODIFY cal_login varchar(25) DEFAULT NULL COMMENT 'User who performed the import.' FIRST;
+ALTER TABLE webcal_import MODIFY cal_date TIMESTAMP on update CURRENT_TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'Datetime of import.' FIRST;
+ALTER TABLE webcal_import MODIFY cal_import_id int UNSIGNED NOT NULL AUTO_INCREMENT COMMENT 'Unique id for import.' FIRST;
+
+ALTER TABLE webcal_import_data ENGINE MyISAM CHARACTER SET utf8 COMMENT 'Used to track import data (one row per event).';
+ALTER TABLE webcal_import_data MODIFY cal_import_type varchar(15) NOT NULL COMMENT 'Type of import: "palm", "vcal", "ical" or "outlookcsv".';
+ALTER TABLE webcal_import_data MODIFY cal_import_id int UNSIGNED NOT NULL COMMENT 'Import id (From <a href="#webcal_import">webcal_import</a> table.' FIRST;
+ALTER TABLE webcal_import_data MODIFY cal_external_id varchar(200) DEFAULT NULL COMMENT 'External id used in external calendar system (for example, UID in iCal).' FIRST;
+ALTER TABLE webcal_import_data MODIFY cal_login varchar(25) NOT NULL COMMENT 'User login. From <a href="#webcal_user">webcal_user</a> table.' FIRST;
+ALTER TABLE webcal_import_data MODIFY cal_id int UNSIGNED NOT NULL COMMENT 'Event id in WebCalendar. From <a href="#webcal_entry">webcal_entry</a> table.' FIRST;
+
+ALTER TABLE webcal_nonuser_cals ENGINE MyISAM CHARACTER SET utf8 COMMENT 'Defines non-user calendars.';
+ALTER TABLE webcal_nonuser_cals MODIFY cal_url varchar(255) DEFAULT NULL COMMENT 'URL of the remote calendar.';
+ALTER TABLE webcal_nonuser_cals MODIFY cal_lastname varchar(25) DEFAULT NULL COMMENT 'Calendar''s last name.' FIRST;
+ALTER TABLE webcal_nonuser_cals MODIFY cal_is_public ENUM('N','Y') NOT NULL DEFAULT 'N' COMMENT 'Can this nonuser calendar be a public calendar (no login required)?' FIRST;
+ALTER TABLE webcal_nonuser_cals MODIFY cal_firstname varchar(25) DEFAULT NULL COMMENT 'Calendar'' first name.' FIRST;
+ALTER TABLE webcal_nonuser_cals ADD cal_displayname varchar(50) DEFAULT NULL COMMENT 'Name to diplay on public or other user''s calendars.' FIRST;
+ALTER TABLE webcal_nonuser_cals MODIFY cal_admin varchar(25) NOT NULL COMMENT 'The calendar administrator. From <a href="#webcal_user">webcal_user</a> table.' FIRST;
+ALTER TABLE webcal_nonuser_cals MODIFY cal_login varchar(25) NOT NULL COMMENT 'Unique id for the calendar.' FIRST;
+UPDATE webcal_nonuser_cals SET cal_displayname = CONCAT_WS(' ',cal_firstname,cal_lastname);
+
+ALTER TABLE webcal_reminders ENGINE MyISAM CHARACTER SET utf8 COMMENT 'Stores information about reminders.';
+ALTER TABLE webcal_reminders MODIFY cal_times_sent int UNSIGNED NOT NULL DEFAULT '0' COMMENT 'Number of times this reminder has been sent.';
+ALTER TABLE webcal_reminders MODIFY cal_repeats int UNSIGNED NOT NULL DEFAULT '0' COMMENT 'Number of times to repeat in addition to original occurrence.' FIRST;
+ALTER TABLE webcal_reminders MODIFY cal_related ENUM('E','S') NOT NULL DEFAULT 'S' COMMENT 'S=Start, E=End. Specifies which edge of entry this reminder applies to.' FIRST;
+ALTER TABLE webcal_reminders MODIFY cal_offset int UNSIGNED NOT NULL DEFAULT '0' COMMENT 'Offset in minutes from the selected edge.' FIRST;
+ALTER TABLE webcal_reminders MODIFY cal_last_sent datetime NOT NULL COMMENT 'Timestamp of last sent reminder.' FIRST;
+ALTER TABLE webcal_reminders MODIFY cal_duration int UNSIGNED NOT NULL DEFAULT '0' COMMENT 'Time in ISO 8601 format that specifies time between repeated reminders.' FIRST;
+ALTER TABLE webcal_reminders MODIFY cal_date datetime NOT NULL COMMENT 'When to send? Use this or cal_offset, but not both.' FIRST;
+ALTER TABLE webcal_reminders MODIFY cal_before ENUM('N','Y') NOT NULL DEFAULT 'Y' COMMENT 'Specifies whether reminder is sent before or after selected edge.' FIRST;
+ALTER TABLE webcal_reminders MODIFY cal_action varchar(12) NOT NULL DEFAULT 'EMAIL' COMMENT 'Action as imported, may be used in the future.' FIRST;
+ALTER TABLE webcal_reminders MODIFY cal_id int UNSIGNED NOT NULL DEFAULT '0' FIRST;
+
+ALTER TABLE webcal_report ENGINE MyISAM CHARACTER SET utf8 COMMENT 'Defines a custom report created by a user.';
+ALTER TABLE webcal_report MODIFY cal_user varchar(25) DEFAULT NULL COMMENT 'User calendar to display (NULL indicates current user).';
+ALTER TABLE webcal_report MODIFY cal_update_date date NOT NULL COMMENT 'Date created or last updated.' FIRST;
+ALTER TABLE webcal_report MODIFY cal_time_range int UNSIGNED NOT NULL COMMENT 'Time range for report:<ul><li>0 = tomorrow</li><li>1 = today</li><li>2 = yesterday</li><li>3 = day before yesterday</li><li>10 = next week</li><li>11 = current week</li><li>12 = last week</li><li>13 = week before last</li><li>20 = next week and week after</li><li>21 = current week and next week</li><li>22 = last week and this week</li><li>23 = last two weeks</li><li>30 = next month</li><li>31 = current month</li><li>32 = last month</li><li>33 = month before last</li><li>40 = next year</li><li>41 = current year</li><li>42 = last year</li><li>43 = year before last</li></ul>' FIRST;
+ALTER TABLE webcal_report MODIFY cal_show_in_trailer ENUM('N','Y') DEFAULT 'N' COMMENT 'Include a link for this report in the "Go to" section of the navigation in the page trailer? ("Y" or "N")' FIRST;
+ALTER TABLE webcal_report MODIFY cal_report_type varchar(20) NOT NULL COMMENT 'Format of report (html, plain or csv).' FIRST;
+ALTER TABLE webcal_report MODIFY cal_report_name varchar(50) NOT NULL COMMENT 'Name of the report.' FIRST;
+ALTER TABLE webcal_report ADD cal_mod TIMESTAMP on update CURRENT_TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'Created or last updated.' FIRST;
+ALTER TABLE webcal_report MODIFY cal_login varchar(25) NOT NULL COMMENT 'Creator of report.' FIRST;
+ALTER TABLE webcal_report MODIFY cal_is_global ENUM('N','Y') NOT NULL DEFAULT 'N' COMMENT 'Is this a global report (can it be accessed by other users - "Y" or "N")' FIRST;
+ALTER TABLE webcal_report MODIFY cal_include_header ENUM('N','Y') NOT NULL DEFAULT 'Y' COMMENT 'If cal_report_type is "html", should the default HTML header and trailer be included? ("Y" or "N")' FIRST;
+ALTER TABLE webcal_report MODIFY cal_include_empty ENUM('N','Y') DEFAULT 'N' COMMENT 'Include empty dates in report ("Y" or "N").' FIRST;
+ALTER TABLE webcal_report MODIFY cal_cat_id int UNSIGNED DEFAULT NULL COMMENT 'Category to filter on (optional).' FIRST;
+ALTER TABLE webcal_report MODIFY cal_allow_nav ENUM('N','Y') DEFAULT 'Y' COMMENT 'Allow user to navigate to different dates with next/previous? ("Y" or "N")' FIRST;
+ALTER TABLE webcal_report MODIFY cal_report_id int UNSIGNED NOT NULL AUTO_INCREMENT COMMENT 'Unique id of this report.' FIRST;
+
+ALTER TABLE webcal_report_template ENGINE MyISAM CHARACTER SET utf8 COMMENT 'Defines one of the templates used for a report. Each report has three templates: <ol><li>Page template - Defines the entire page (except for header and footer). The following variables can be defined:<ul><li>${days}<sup>*</sup> - the HTML of all dates (generated from the Date template)</li></ul></li><li>Date template - Defines events for one day. If the report is for a week or month, then the results of each day will be concatenated and used as the ${days} variable in the Page template. The following variables can be defined:<ul><li>${events}<sup>*</sup> - the HTML of all events for the data (generated from the Event template)</li><li>${date} - the date</li><li>${fulldate} - date (includes weekday)</li></ul></li><li>Event template - Defines a single event. The following variables can be defined: <ul><li>${name}<sup>*</sup> - Brief Description of event</li><li>${description} - Full Description of event</li><li>${date} - Date of event</li><li>${fulldate} - Date of event (includes weekday)</li><li>${time} - Time of event (4:00pm - 4:30pm)</li><li>${starttime} - Start time of event</li><li>${endtime} - End time of event</li><li>${duration} - Duration of event (in minutes)</li><li>${priority} - Priority of event</li><li>${href} - URL to view event details</li></ul></li></ol><sup>*</sup> denotes a required template variable.';
+ALTER TABLE webcal_report_template MODIFY cal_template_type ENUM('D','E','P') NOT NULL DEFAULT "P" COMMENT 'Type of template:<ul><li>"P": page template represents entire document</li><li>"D": date template represents a single day of events</li><li>"E": event template represents a single event</li></ul>' FIRST;
+ALTER TABLE webcal_report_template MODIFY cal_template_text text COMMENT 'Text of template.';
+ALTER TABLE webcal_report_template MODIFY cal_report_id int UNSIGNED NOT NULL COMMENT 'Report id from <a href="webcal_report table">webcal_report</a> table.' FIRST;
+
+ALTER TABLE webcal_site_extras ENGINE MyISAM CHARACTER SET utf8 COMMENT 'This table holds data for site extra fields (customized in site_extra.php).';
+ALTER TABLE webcal_site_extras MODIFY cal_type int UNSIGNED NOT NULL COMMENT 'EXTRA_URL, EXTRA_DATE, etc.' FIRST;
+ALTER TABLE webcal_site_extras MODIFY cal_remind int UNSIGNED DEFAULT '0' COMMENT 'How many minutes before event should a reminder be sent.' FIRST;
+ALTER TABLE webcal_site_extras MODIFY cal_name varchar(25) NOT NULL COMMENT 'The brief name of this type (first field in $site_extra array).' FIRST;
+ALTER TABLE webcal_site_extras MODIFY cal_id int UNSIGNED NOT NULL DEFAULT '0' COMMENT 'Event id from <a href="webcal_entry">webcal_entry</a> table.' FIRST;
+ALTER TABLE webcal_site_extras MODIFY cal_date DATE NULL DEFAULT NULL COMMENT 'Only used for EXTRA_DATE type fields.' FIRST;
+ALTER TABLE webcal_site_extras MODIFY cal_data text COMMENT 'Used to store text data.';
+
+ALTER TABLE webcal_timezones ENGINE MyISAM CHARACTER SET utf8 COMMENT 'This table stores timezones of the world.';
+ALTER TABLE webcal_timezones MODIFY vtimezone text COMMENT 'Complete VTIMEZONE text gleaned from imported ics files.';
+ALTER TABLE webcal_timezones MODIFY tzid varchar(100) NOT NULL DEFAULT '' COMMENT 'Unique name of timezone, try to use Olsen naming conventions.' FIRST;
+ALTER TABLE webcal_timezones MODIFY dtstart varchar(16) DEFAULT NULL COMMENT 'Earliest date this timezone represents in YYYYMMDDTHHMMSSZ format.' FIRST;
+ALTER TABLE webcal_timezones MODIFY dtend varchar(16) DEFAULT NULL COMMENT 'Last date this timezone represents in YYYYMMDDTHHMMSSZ format.' FIRST;
+
+DROP TABLE IF EXISTS webcal_translations;
+CREATE TABLE IF NOT EXISTS webcal_translations (
+ phrase varchar(300) CHARACTER SET latin1 COLLATE latin1_general_cs NOT NULL COMMENT 'The translate / tooltip (phrases) from the code. And the __phrase__ from version 2.0.0. ("latin1" is currently the only choice that is case sensitive.)',
+ on_page varchar(50) NOT NULL COMMENT 'which code page (sorted alphabetically) has the first occurance of the above phrase.',
+ English_US varchar(300) NOT NULL COMMENT 'The full English text.',
+ Afrikaans varchar(300) NOT NULL,
+ Albanian varchar(300) NOT NULL,
+ Arabic varchar(300) NOT NULL,
+ Armenian varchar(300) NOT NULL,
+ Azerbaijan varchar(300) NOT NULL,
+ Basque varchar(300) NOT NULL,
+ Belarusian varchar(300) NOT NULL,
+ Bulgarian varchar(300) NOT NULL,
+ Catalan varchar(300) NOT NULL,
+ Chamorro varchar(300) NOT NULL,
+ Chinese_Big5 varchar(300) NOT NULL,
+ Chinese_GB2312 varchar(300) NOT NULL,
+ Croatian varchar(300) CHARACTER SET utf8 COLLATE utf8_croatian_ci NOT NULL,
+ Czech varchar(300) CHARACTER SET utf8 COLLATE utf8_czech_ci NOT NULL,
+ Danish varchar(300) CHARACTER SET utf8 COLLATE utf8_danish_ci NOT NULL,
+ Dutch varchar(300) NOT NULL,
+ Elven varchar(300) NOT NULL COMMENT 'From JRR Tolkien "Hobbit" and "Lord of the Rings".',
+ Esperanto varchar(300) CHARACTER SET utf8 COLLATE utf8_esperanto_ci NOT NULL,
+ Estonian varchar(300) CHARACTER SET utf8 COLLATE utf8_estonian_ci NOT NULL,
+ Faroese varchar(300) NOT NULL,
+ Farsi varchar(300) NOT NULL,
+ Finnish varchar(300) NOT NULL,
+ French varchar(300) NOT NULL,
+ Galician varchar(300) NOT NULL,
+ Georgian varchar(300) NOT NULL,
+ German varchar(300) CHARACTER SET utf8 COLLATE utf8_german2_ci NOT NULL,
+ Greek varchar(300) NOT NULL,
+ Hebrew varchar(300) NOT NULL,
+ Hungarian varchar(300) CHARACTER SET utf8 COLLATE utf8_hungarian_ci NOT NULL,
+ Icelandic varchar(300) CHARACTER SET utf8 COLLATE utf8_icelandic_ci NOT NULL,
+ Indonesian varchar(300) NOT NULL,
+ Italian varchar(300) NOT NULL,
+ Japanese varchar(300) NOT NULL,
+ Klingon varchar(300) NOT NULL,
+ Korean varchar(300) NOT NULL,
+ Latvian varchar(300) CHARACTER SET utf8 COLLATE utf8_latvian_ci NOT NULL,
+ Lithuanian varchar(300) CHARACTER SET utf8 COLLATE utf8_lithuanian_ci NOT NULL,
+ Malaysian varchar(300) NOT NULL,
+ Myanmar varchar(300) CHARACTER SET utf8 COLLATE utf8_myanmar_ci NOT NULL,
+ Norwegian varchar(300) NOT NULL,
+ Persian varchar(300) CHARACTER SET utf8 COLLATE utf8_persian_ci NOT NULL,
+ Polish varchar(300) CHARACTER SET utf8 COLLATE utf8_polish_ci NOT NULL,
+ Portuguese varchar(300) NOT NULL,
+ Portuguese_BR varchar(300) NOT NULL,
+ Romanian varchar(300) CHARACTER SET utf8 COLLATE utf8_romanian_ci NOT NULL,
+ Russian varchar(300) NOT NULL,
+ Serbian varchar(300) NOT NULL,
+ Sinhala varchar(300) CHARACTER SET utf8 COLLATE utf8_sinhala_ci NOT NULL,
+ Slovakian varchar(300) CHARACTER SET utf8 COLLATE utf8_slovak_ci NOT NULL,
+ Slovenian varchar(300) CHARACTER SET utf8 COLLATE utf8_slovenian_ci NOT NULL,
+ Spanish varchar(300) CHARACTER SET utf8 COLLATE utf8_spanish_ci NOT NULL,
+ Swedish varchar(300) NOT NULL,
+ Taiwanese varchar(300) NOT NULL,
+ Turkish varchar(300) CHARACTER SET utf8 COLLATE utf8_turkish_ci NOT NULL,
+ Ukrainian varchar(300) NOT NULL,
+ Vietnamese varchar(300) CHARACTER SET utf8 COLLATE utf8_vietnamese_ci NOT NULL,
+ Welsh varchar(300) NOT NULL,
+ PRIMARY KEY (phrase),
+ KEY wt_op (on_page)
+) ENGINE MyISAM DEFAULT CHARSET=utf8 ROW_FORMAT=DYNAMIC COMMENT='Various language translations.';
+
+ALTER TABLE webcal_user ENGINE MyISAM CHARACTER SET utf8 COMMENT 'Defines a WebCalendar user.';
+ALTER TABLE webcal_user ADD cal_type ENUM('A','N','S','U') DEFAULT 'U' COMMENT 'Is this an A)dmin, N)on_user, S)ystem, or ordinary U)ser? Will evevtually replace is_admin.';
+ALTER TABLE webcal_user MODIFY cal_passwd varchar(32) DEFAULT NULL COMMENT 'The user''s password (not used for http.)' FIRST;
+ALTER TABLE webcal_user ADD cal_mod TIMESTAMP on update CURRENT_TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'User''s last log in.' FIRST;
+ALTER TABLE webcal_user MODIFY cal_last_login timestamp on update CURRENT_TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'Date user last logged in.' FIRST;
+ALTER TABLE webcal_user MODIFY cal_is_admin ENUM('N','Y') DEFAULT 'N' COMMENT 'Is the user a WebCalendar administrator? (Y or N)' FIRST;
+ALTER TABLE webcal_user MODIFY cal_enabled ENUM('N','Y') DEFAULT 'Y' COMMENT 'Allow admin to disable account? (Y or N)' FIRST;
+ALTER TABLE webcal_user MODIFY cal_login varchar(25) NOT NULL COMMENT 'Unique user login.' FIRST;
+UPDATE webcal_user SET cal_type = 'U' WHERE cal_is_admin = 'N';
+UPDATE webcal_user SET cal_type = 'A' WHERE cal_is_admin = 'Y';
+
+ALTER TABLE webcal_user_layers ENGINE MyISAM CHARACTER SET utf8 COMMENT 'Define layers for a user.';
+ALTER TABLE webcal_user_layers MODIFY cal_layerid int UNSIGNED NOT NULL AUTO_INCREMENT UNIQUE COMMENT 'Unique layer id.' FIRST;
+ALTER TABLE webcal_user_layers MODIFY cal_dups ENUM('N','Y') DEFAULT 'N' COMMENT 'Show duplicates? (Y or N)';
+ALTER TABLE webcal_user_layers MODIFY cal_color varchar(25) DEFAULT NULL COMMENT 'Color (preferably in hex) of this layer.' FIRST;
+ALTER TABLE webcal_user_layers MODIFY cal_layeruser varchar(25) NOT NULL COMMENT 'Login name of user that this layer represents. Also from <a href="webcal_user">webcal_user</a> table.' FIRST;
+ALTER TABLE webcal_user_layers MODIFY cal_login varchar(25) NOT NULL COMMENT 'Login of owner of this layer from <a href="webcal_user">webcal_user</a> table.' FIRST;
+
+/*Consolodate some fields / tables into webcal_user_pref.*/
+DELETE FROM webcal_config WHERE cal_value IS NULL;
+DELETE FROM webcal_user_pref WHERE cal_value IS NULL;
+
+ALTER TABLE webcal_user_pref DROP PRIMARY KEY;
+ALTER TABLE webcal_user_pref ENGINE MyISAM CHARACTER SET utf8 COMMENT 'Specify preferences for a user. Most preferences are set via pref.php. Values in this table are loaded after system settings found in <a href="#webcal_config">webcal_config</a> table.';
+ALTER TABLE webcal_user_pref MODIFY cal_value varchar(100) NOT NULL COMMENT 'Value of setting.';
+ALTER TABLE webcal_user_pref ADD PRIMARY KEY (cal_login,cal_setting,cal_value);
+
+ALTER TABLE webcal_user_pref MODIFY cal_login varchar(25) DEFAULT '__webcal__sys__';
+INSERT INTO webcal_user_pref (cal_setting, cal_value) SELECT cal_setting, cal_value FROM webcal_config;
+
+ALTER TABLE webcal_user_pref MODIFY cal_setting varchar(50) DEFAULT 'ACCESS_FUNCTIONS' FIRST;
+ALTER TABLE webcal_user_pref MODIFY cal_login varchar(25) NOT NULL COMMENT 'User login from <a href="#webcal_user">webcal_user</a> table.' FIRST;
+INSERT INTO webcal_user_pref (cal_login, cal_value) SELECT cal_login, cal_permissions FROM webcal_access_function;
+
+ALTER TABLE webcal_user_pref MODIFY cal_setting varchar(50) DEFAULT 'ASSISTANT';
+INSERT INTO webcal_user_pref (cal_login, cal_value) SELECT cal_boss, cal_assistant FROM webcal_asst;
+
+ALTER TABLE webcal_user_pref MODIFY cal_setting varchar(50) DEFAULT 'GROUP_ID';
+INSERT INTO webcal_user_pref (cal_login, cal_value) SELECT cal_login, cal_group_id FROM webcal_group_user;
+
+ALTER TABLE webcal_user_pref MODIFY cal_setting varchar(50) DEFAULT 'ADDRESS';
+INSERT INTO webcal_user_pref (cal_login, cal_value) SELECT cal_login, cal_address FROM webcal_user WHERE cal_address IS NOT NULL;
+
+ALTER TABLE webcal_user_pref MODIFY cal_setting varchar(50) DEFAULT 'BIRTHDAY';
+INSERT INTO webcal_user_pref (cal_login, cal_value) SELECT cal_login, cal_birthday FROM webcal_user WHERE cal_birthday IS NOT NULL;
+
+ALTER TABLE webcal_user_pref MODIFY cal_setting varchar(50) DEFAULT 'DISPLAY_NAME';
+UPDATE webcal_user_pref SET cal_firstname = '' WHERE cal_firstname IS NULL;
+UPDATE webcal_user_pref SET cal_lastname = '' WHERE cal_lastname IS NULL;
+INSERT INTO webcal_user_pref (cal_login, cal_value) SELECT cal_login, TRIM( CONCAT_WS( ' ',cal_firstname,cal_lastname ) ) FROM webcal_user;
+
+ALTER TABLE webcal_user_pref MODIFY cal_setting varchar(50) DEFAULT 'EMAIL';
+INSERT INTO webcal_user_pref (cal_login, cal_value) SELECT cal_login, cal_email FROM webcal_user WHERE cal_email IS NOT NULL;
+
+ALTER TABLE webcal_user_pref MODIFY cal_setting varchar(50) DEFAULT 'FIRSTNAME';
+INSERT INTO webcal_user_pref (cal_login, cal_value) SELECT cal_login, cal_firstname FROM webcal_user;
+
+ALTER TABLE webcal_user_pref MODIFY cal_setting varchar(50) DEFAULT 'LASTNAME';
+INSERT INTO webcal_user_pref (cal_login, cal_value) SELECT cal_login, cal_lastname FROM webcal_user;
+
+ALTER TABLE webcal_user_pref MODIFY cal_setting varchar(50) DEFAULT 'PHONE';
+INSERT INTO webcal_user_pref (cal_login, cal_value) SELECT cal_login, cal_telephone FROM webcal_user WHERE cal_telephone IS NOT NULL;
+
+ALTER TABLE webcal_user_pref MODIFY cal_setting varchar(50) DEFAULT 'TITLE';
+INSERT INTO webcal_user_pref (cal_login, cal_value) SELECT cal_login, cal_title FROM webcal_user WHERE cal_title IS NOT NULL;
+
+ALTER TABLE webcal_user_pref MODIFY cal_setting varchar(50) DEFAULT 'VIEW_ID';
+INSERT INTO webcal_user_pref (cal_login, cal_value) SELECT cal_login, cal_view_id FROM webcal_view_user;
+
+ALTER TABLE webcal_user_pref MODIFY cal_setting varchar(50) NOT NULL COMMENT 'Setting name.';
+
+/* Once the code gets updated, drop the obsolete fields / tables. */
+/* End consolidating webcal_user_pref */
+
+UPDATE webcal_user_template SET cal_login = '__webcal__sys__' WHERE cal_login = '__system_';
+ALTER TABLE webcal_user_template ENGINE MyISAM CHARACTER SET utf8 COMMENT 'This table stores the custom header/stylesheet/trailer. If configured properly, each user (or nonuser cal) can have their own custom header/trailer.';
+ALTER TABLE webcal_user_template MODIFY cal_type ENUM('H','S','T') NOT NULL COMMENT 'H)eader, S)tylesheet/script, T)railer.' FIRST;
+ALTER TABLE webcal_user_template MODIFY cal_template_text text COMMENT 'Text of template.';
+ALTER TABLE webcal_user_template MODIFY cal_login varchar(25) NOT NULL COMMENT 'User login (or nonuser cal name), the default for all users is stored with the username "__webcal__sys__".' FIRST;
+
+ALTER TABLE webcal_view ENGINE MyISAM CHARACTER SET utf8 COMMENT 'A "view" allows a user to put the calendars of multiple users all on one page. A "view" is valid only for the owner (cal_owner) of the view. Users for the view are in <a href="#webcal_view_user">webcal_view_user</a> table.';
+ALTER TABLE webcal_view MODIFY cal_view_type ENUM('D','M','W') DEFAULT NULL COMMENT '"W" for week view, "D" for day view, "M" for month view.';
+ALTER TABLE webcal_view MODIFY cal_owner varchar(25) NOT NULL COMMENT 'Login name of owner of this view. From <a href="#webcal_user">webcal_user</a> table.' FIRST;
+ALTER TABLE webcal_view MODIFY cal_name varchar(50) NOT NULL COMMENT 'Name of view.' FIRST;
+ALTER TABLE webcal_view MODIFY cal_is_global ENUM('N','Y') NOT NULL DEFAULT 'N' COMMENT 'Is this a global view? (can it be accessed by other users - "Y" or "N")' FIRST;
+ALTER TABLE webcal_view MODIFY cal_view_id int UNSIGNED NOT NULL AUTO_INCREMENT COMMENT 'Unique view id.' FIRST;
+
+ALTER TABLE webcal_view_user ENGINE MyISAM CHARACTER SET utf8 COMMENT 'Specify users in a view.';
+ALTER TABLE webcal_view_user MODIFY cal_login varchar(25) NOT NULL COMMENT 'A user in the view. From <a href="#webcal_user">webcal_user</a> table.';
+ALTER TABLE webcal_view_user MODIFY cal_view_id int UNSIGNED NOT NULL COMMENT 'view id from <a href="#webcal_view">webcal_view</a> table.' FIRST;
+
    -
    +

    After you complete manually updating your database, you will still need to run the installation script to perform - any necessary data changes needed to convert existing data.

    + any necessary data changes needed to convert existing data. Although, I've tried to do that for you in upgrading from 1.1.3, I may have missed something.


    - Valid XHTML 1.0!

    + Valid HTML5!


    diff --git a/docs/Print view - phpMyAdmin 4.7.4.htm b/docs/Print view - phpMyAdmin 4.7.4.htm new file mode 100644 index 000000000..5cad9bd8f --- /dev/null +++ b/docs/Print view - phpMyAdmin 4.7.4.htm @@ -0,0 +1,465 @@ + + +Print view - phpMyAdmin 4.7.4
    +

    webcal_access_function

    +Table comments: Specifies what WebCalendar functions a user can access. +Each function has a corresponding numeric value (specified in the file +includes/access.php). For example, view event is 0, so the very first +character in the cal_permissions column is either a "Y" if this user can + view events or a "N" if they cannot.

    + + +
    ColumnTypeNullDefault Comments
    cal_login (Primary)varchar(25)No User login. From <a href="#webcal_user">webcal_user</a> table.
    cal_permissionsvarchar(64)No A string of "Y"s and/or "N"s for the various functions.

    Indexes

    No index defined!
    KeynameTypeUniquePackedColumnCardinalityCollationNullComment
    PRIMARYBTREEYesNocal_login0ANo
    +

    webcal_access_user

    +Table comments: Specifies which users can access another user's calendar.

    + + + + + + + + +
    ColumnTypeNullDefault Comments
    cal_login (Primary)varchar(25)No The + current user who is attempting to look at another user's calendar. From + <a href="#webcal_user">webcal_user</a> table.
    cal_other_user (Primary)varchar(25)No The + login of the other user whose calendar the current user wants to +access. Also, from <a href="#webcal_user">webcal_user</a> +table.
    cal_can_approvesmallint(5)No0 Can current user approve events on the other user's calendar?
    cal_can_editsmallint(5)No0 Can current user edit events on the other user's calendar?
    cal_can_emailenum('N', 'Y')YesY Can current user send emails to other user?
    cal_can_inviteenum('N', 'Y')NoY Can current user see other user in Participant lists?
    cal_can_viewsmallint(5)No0 Can current user view events on the other user's calendar?
    cal_see_time_onlyenum('N', 'Y')NoN Can current user can only see time of other user?

    Indexes

    No index defined!
    KeynameTypeUniquePackedColumnCardinalityCollationNullComment
    PRIMARYBTREEYesNocal_loginANo
    cal_other_user0ANo
    +

    webcal_asst

    +Table comments: Define assistant/boss relationship.

    + + +
    ColumnTypeNullDefault Comments
    cal_boss (Primary)varchar(25)No Boss login. From <a href="#webcal_user">webcal_user</a> table.
    cal_assistant (Primary)varchar(25)No Assistant login. Also from <a href="#webcal_user">webcal_user</a> table.

    Indexes

    No index defined!
    KeynameTypeUniquePackedColumnCardinalityCollationNullComment
    PRIMARYBTREEYesNocal_bossANo
    cal_assistant0ANo
    +

    webcal_blob

    +Table comments: This table stores event attachments and comments.

    + + + + + + + + + + + + +
    ColumnTypeNullDefault Comments
    cal_blob_id (Primary)int(10)No Unique identifier for this object.
    cal_descriptionvarchar(128)YesNULL Description of what the object is (subject for comment).
    cal_idint(10)YesNULL Event id (if applicable). From <a href="#webcal_entry">webcal_entry</a> table.
    cal_loginvarchar(25)YesNULL Login of user who created. From <a href="#webcal_user">webcal_user</a> table.
    cal_mime_typevarchar(50)YesNULL MIME type of object (as specified by browser during upload (not used for comment).
    cal_modtimestampNocurrent_timestamp() When was this added / changed?
    cal_mod_datedateNo Date added.
    cal_mod_timetimeNo Time added.
    cal_namevarchar(30)YesNULL Filename of object (not used for comments).
    cal_sizeint(10)YesNULL Size of object (not used for comments).
    cal_typeenum('A', 'C')NoC Type of object: C=Comment, A=Attachment.
    cal_bloblongblobYesNULL Binary data for object.

    Indexes

    No index defined!
    KeynameTypeUniquePackedColumnCardinalityCollationNullComment
    PRIMARYBTREEYesNocal_blob_id0ANo
    wb_cl_cdBTREEYesNocal_loginAYes
    cal_descriptionAYes
    +

    webcal_categories

    +Table comments: Defines user categories. Categories can be specific to a + user or global. When a category is global, the cat_owner field will be +NULL. (Only an admin user can create a global category.)

    + + + + +
    ColumnTypeNullDefault Comments
    cat_id (Primary)int(10)No Unique category id.
    cat_colorvarchar(7)YesNULL RGB color for category.
    cat_namevarchar(80)No Category name.
    cat_ownervarchar(25)YesNULL User + login of category owner. From <a +href="#webcal_user">webcal_user</a> table, if applicable. If +this is NULL, then it is a global category.

    Indexes

    No index defined!
    KeynameTypeUniquePackedColumnCardinalityCollationNullComment
    PRIMARYBTREEYesNocat_id0ANo
    +

    webcal_config

    +Table comments: System settings (set by the admin interface in admin.php).

    + + +
    ColumnTypeNullDefault Comments
    cal_setting (Primary)varchar(50)No System setting.
    cal_valuevarchar(100)YesNULL System setting value.

    Indexes

    No index defined!
    KeynameTypeUniquePackedColumnCardinalityCollationNullComment
    PRIMARYBTREEYesNocal_setting0ANo
    +

    webcal_entry

    +Table comments: Defines a calendar event. Each event in the system has +one entry in this table unless the event starts before midnight and ends + after midnight. In that case a secondary event will be created with +cal_ext_for_id set to the cal_id of the original entry. The following +tables contain additional information about each +event:<ul><li><a +href="#webcal_entry_user">webcal_entry_user</a> table - lists +participants in the event and specifies the status (accepted, rejected) +and category of each participant.</li><li><a +href="#webcal_entry_repeats">webcal_entry_repeats</a> table - +contains information if the event repeats.</li><li><a +href="#webcal_entry_repeats_not">webcal_entry_repeats_not</a> +table - specifies which dates the repeating event does not repeat +(because they were deleted or modified for just that date by the +user.)</li><li><a +href="#webcal_entry_log">webcal_entry_log</a> table - provides a + history of changes to this event.</li><li><a +href="#webcal_site_extras">webcal_site_extras</a> table - +stores event data as defined in site_extras.php (such as reminders and +other custom event fields).</li></ul>

    + + + + + + + + + + + + + + + + + + + + + + +
    ColumnTypeNullDefault Comments
    cal_id (Primary)int(10)No Unique integer id for event.
    cal_accessenum('C', 'P', 'R')YesP "P" + = Public, "R" = Private (others cannot see the event), "C" = +Confidential (others can see time allocated but not what it is).
    cal_completeddateYesNULL Date task completed.
    cal_create_byvarchar(25)No Login of user that created the event. From <a href="#webcal_user">webcal_user</a> table.
    cal_datedateNo Date of event (in YYYYMMDD format).
    cal_datetimedatetimeNo When is this event scheduled to start?
    cal_duedatetimeYesNULL When is this task due?
    cal_due_datedateYesNULL Task due date.
    cal_due_timetimeYesNULL Task due time.
    cal_durationint(10)No Duration of event in minutes.
    cal_ext_for_idint(10)YesNULL Used + when an event goes past midnight into the next day, in which case an +additional entry in this table will use this field to indicate the +original event cal_id.
    cal_group_idint(10)YesNULL The parent event id if this event is overriding an occurrence of a repeating event. From this table.
    cal_locationvarchar(100)YesNULL Location of event.
    cal_modtimestampNocurrent_timestamp() When was this added / changed?
    cal_mod_datedateYesNULL Date the event was last modified (in YYYYMMDD format).
    cal_mod_timetimeYesNULL Time the event was last modified (in HHMMSS format).
    cal_namevarchar(80)No Brief description of event.
    cal_prioritytinyint(3)Yes5 Event priority: 1=High, 9=Low.
    cal_timetimeYesNULL Event start time (in HHMMSS format).
    cal_typeenum('E', 'M', 'T')YesE "E" = Event, "M" = Repeating event, "T" = Task.
    cal_urlvarchar(100)YesNULL URL of event.
    cal_descriptiontextYesNULL Full description of event.

    Indexes

    No index defined!
    KeynameTypeUniquePackedColumnCardinalityCollationNullComment
    PRIMARYBTREEYesNocal_id0ANo
    +

    webcal_entry_categories

    +Table comments: Contains category foreign keys to enable multiple categories for each event or task.

    + + + + +
    ColumnTypeNullDefault Comments
    cal_idint(10)No0 Id of event from <a href="webcal_entry">webcal_entry</a> table.
    cat_idint(10)No0 Id of category from <a href="webcal_categories">webcal_categories</a> table.
    cat_ownervarchar(25)YesNULL User that owns this record. Global categories will be NULL. From <a href="#webcal_user">webcal_user</a> table.
    cat_orderint(10)No0 Order that user requests their categories appear. Globals are always last.
    +

    webcal_entry_ext_user

    +Table comments: External user (no login) for an event.

    + + + +
    ColumnTypeNullDefault Comments
    cal_id (Primary)int(10)No0 From <a href="webcal_entry">webcal_entry</a> table.
    cal_emailvarchar(75)YesNULL external user email (for sending a reminder)
    cal_fullname (Primary)varchar(50)No external user full name

    Indexes

    No index defined!
    KeynameTypeUniquePackedColumnCardinalityCollationNullComment
    PRIMARYBTREEYesNocal_idANo
    cal_fullname0ANo
    +

    webcal_entry_log

    +Table comments: Activity log for an event.

    + + + + + + + + + +
    ColumnTypeNullDefault Comments
    cal_log_id (Primary)int(10)No Unique id of this log entry.
    cal_datedateNo Date (in YYYYMMDD format).
    cal_entry_idint(10)No Event id. From <a href="#webcal_entry">webcal_entry</a> table.
    cal_loginvarchar(25)No User who performed this action. From <a href="#webcal_user">webcal_user</a> table.
    cal_modtimestampNocurrent_timestamp() When was this added / changed?
    cal_timetimeYesNULL Time (in HHMMSS format).
    cal_typeenum('A', 'C', 'E', 'M', 'R', 'U')NoC Log + types:<ul><li>C: Created</li><li>A: +Approved/Confirmed by user</li><li>R: Rejected by +user</li><li>U: Updated by user</li><li>M: Mail +Notification sent</li><li>E: Reminder +sent</li></ul>
    cal_user_calvarchar(25)YesNULL User of calendar affected. Also from <a href="#webcal_user">webcal_user</a> table.
    cal_texttextYesNULL Optional text.

    Indexes

    No index defined!
    KeynameTypeUniquePackedColumnCardinalityCollationNullComment
    PRIMARYBTREEYesNocal_log_id0ANo
    +

    webcal_entry_repeats

    +Table comments: Defines repeating info about an event. The event is +defined in <a href="#webcal_entry">webcal_entry</a> table.

    + + + + + + + + + + + + + + + +
    ColumnTypeNullDefault Comments
    cal_id (Primary)int(10)No0 Event id. From <a href="#webcal_entry">webcal_entry</a> table.
    cal_bydayvarchar(100)YesNULL The following columns are values as specified in RFC2445.
    cal_bymonthvarchar(50)YesNULL
    cal_bymonthdayvarchar(100)YesNULL
    cal_bysetposvarchar(50)YesNULL
    cal_byweeknovarchar(50)YesNULL
    cal_byyeardayvarchar(50)YesNULL
    cal_countint(10)YesNULL
    cal_daysenum('N', 'Y')YesNULL NO LONGER USED. We'll leave it in for now.
    cal_enddateYesNULL End date for repeating event.
    cal_enddtdatetimeYesNULL End date and time for repeating event.
    cal_endtimetimeYesNULL End time for repeating event.
    cal_frequencyint(10)Yes1 Frequency of repeat: 1 = every, 2 = every other, 3 = every 3rd, etc.
    cal_typevarchar(20)YesNULL Type + of repeating:<ul><li>daily - repeats +daily</li><li>monthlyByDate - repeats on same day of the +month</li><li>monthlyBySetPos - repeats based on position +within other ByXXX values</li><li>monthlyByDay - repeats on +specified weekday2nd Monday, for example)</li><li>weekly - +repeats every week</li><li>yearly - repeats on same date +every year</li></ul>
    cal_wkstenum('MO', 'TU', 'WE', 'TH', 'FR', 'SA', 'SU')YesMO Week starts on...

    Indexes

    No index defined!
    KeynameTypeUniquePackedColumnCardinalityCollationNullComment
    PRIMARYBTREEYesNocal_id0ANo
    +

    webcal_entry_repeats_not

    +Table comments: This table specifies which dates in a repeating event +have either been deleted, included, or replaced with another event for +that day. When replaced, the cal_group_id (I know... not the best name, +but it was not being used) column will be set to the original event. +That way the user can delete the original event and (at the same time) +delete any exception events.

    + + + +
    ColumnTypeNullDefault Comments
    cal_id (Primary)int(10)No Event id of repeating event. From <a href="#webcal_entry">webcal_entry</a> table.
    cal_date (Primary)dateNo Date event should not repeat.
    cal_exdatetinyint(3)No1 Indicates whether this record is an exclusion1) or inclusion0).

    Indexes

    No index defined!
    KeynameTypeUniquePackedColumnCardinalityCollationNullComment
    PRIMARYBTREEYesNocal_idANo
    cal_date0ANo
    +

    webcal_entry_user

    +Table comments: This table associates one or more users with an event by + the event id. The event can be found in <a +href="#webcal_entry">webcal_entry</a> table.

    + + + + + +
    ColumnTypeNullDefault Comments
    cal_id (Primary)int(10)No0 Event id. From <a href="#webcal_entry">webcal_entry</a> table.
    cal_login (Primary)varchar(25)No Participant in the event. From <a href="#webcal_user">webcal_user</a> table.
    cal_categoryint(10)YesNULL Category of the event for this user.
    cal_percenttinyint(3)No0 Task percentage of completion for this user's task.
    cal_statusenum('A', 'C', 'D', 'P', 'R', 'W')YesA Status + of event for this +user:<ul><li>A=Accepted</li><li>C=Completed</li><li>D=Deleted</li><li>P=In-Progress</li><li>R=Rejected/Declined</li><li>W=Waiting</li></ul>

    Indexes

    No index defined!
    KeynameTypeUniquePackedColumnCardinalityCollationNullComment
    PRIMARYBTREEYesNocal_idANo
    cal_login0ANo
    +

    webcal_group

    +Table comments: Define a group. Group members can be found in <a +href="#webcal_group_user">webcal_group_user</a> table.

    + + + + +
    ColumnTypeNullDefault Comments
    cal_group_id (Primary)int(10)No Unique group id.
    cal_last_updatetimestampNocurrent_timestamp() Date last updated.
    cal_namevarchar(50)No Name of the group.
    cal_ownervarchar(25)YesNULL User login of user that created this group. From <a href="#webcal_user">webcal_user</a> table.

    Indexes

    No index defined!
    KeynameTypeUniquePackedColumnCardinalityCollationNullComment
    PRIMARYBTREEYesNocal_group_id0ANo
    +

    webcal_group_user

    +Table comments: Group members.

    + + +
    ColumnTypeNullDefault Comments
    cal_group_id (Primary)int(10)No From <a href="webcal_group">webcal_group</a>
    cal_login (Primary)varchar(25)No From <a href="webcal_user">webcal_user</a>

    Indexes

    No index defined!
    KeynameTypeUniquePackedColumnCardinalityCollationNullComment
    PRIMARYBTREEYesNocal_group_idANo
    cal_login0ANo
    +

    webcal_import

    +Table comments: Used to track import data (one row per import).

    + + + + + +
    ColumnTypeNullDefault Comments
    cal_import_id (Primary)int(10)No Unique id for import.
    cal_datetimestampNocurrent_timestamp() Datetime of import.
    cal_loginvarchar(25)YesNULL User who performed the import.
    cal_namevarchar(50)YesNULL Name of import (optional).
    cal_typevarchar(10)No Type of import (ical, vcal, palm, outlookcsv).

    Indexes

    No index defined!
    KeynameTypeUniquePackedColumnCardinalityCollationNullComment
    PRIMARYBTREEYesNocal_import_id0ANo
    +

    webcal_import_data

    +Table comments: Used to track import data (one row per event).

    + + + + + +
    ColumnTypeNullDefault Comments
    cal_id (Primary)int(10)No Event id in WebCalendar. From <a href="#webcal_entry">webcal_entry</a> table.
    cal_login (Primary)varchar(25)No User login. From <a href="#webcal_user">webcal_user</a> table.
    cal_external_idvarchar(200)YesNULL External id used in external calendar system (for example, UID in iCal).
    cal_import_idint(10)No Import id (From <a href="#webcal_import">webcal_import</a> table.
    cal_import_typevarchar(15)No Type of import: "palm", "vcal", "ical" or "outlookcsv".

    Indexes

    No index defined!
    KeynameTypeUniquePackedColumnCardinalityCollationNullComment
    PRIMARYBTREEYesNocal_idANo
    cal_login0ANo
    +

    webcal_nonuser_cals

    +Table comments: Defines non-user calendars.

    + + + + + + + +
    ColumnTypeNullDefault Comments
    cal_login (Primary)varchar(25)No Unique id for the calendar.
    cal_adminvarchar(25)No The calendar administrator. From <a href="#webcal_user">webcal_user</a> table.
    cal_displaynamevarchar(50)YesNULL Name to diplay on public or other user's calendars.
    cal_firstnamevarchar(25)YesNULL Calendar' first name.
    cal_is_publicenum('N', 'Y')NoN Can this nonuser calendar be a public calendar (no login required)?
    cal_lastnamevarchar(25)YesNULL Calendar's last name.
    cal_urlvarchar(255)YesNULL URL of the remote calendar.

    Indexes

    No index defined!
    KeynameTypeUniquePackedColumnCardinalityCollationNullComment
    PRIMARYBTREEYesNocal_login0ANo
    +

    webcal_reminders

    +Table comments: Stores information about reminders.

    + + + + + + + + + + +
    ColumnTypeNullDefault Comments
    cal_id (Primary)int(10)No0
    cal_actionvarchar(12)NoEMAIL Action as imported, may be used in the future.
    cal_beforeenum('N', 'Y')NoY Specifies whether reminder is sent before or after selected edge.
    cal_datedatetimeNo When to send? Use this or cal_offset, but not both.
    cal_durationint(10)No0 Time in ISO 8601 format that specifies time between repeated reminders.
    cal_last_sentdatetimeNo Timestamp of last sent reminder.
    cal_offsetint(10)No0 Offset in minutes from the selected edge.
    cal_relatedenum('E', 'S')NoS S=Start, E=End. Specifies which edge of entry this reminder applies to.
    cal_repeatsint(10)No0 Number of times to repeat in addition to original occurrence.
    cal_times_sentint(10)No0 Number of times this reminder has been sent.

    Indexes

    No index defined!
    KeynameTypeUniquePackedColumnCardinalityCollationNullComment
    PRIMARYBTREEYesNocal_id0ANo
    +

    webcal_report

    +Table comments: Defines a custom report created by a user.

    + + + + + + + + + + + + + + +
    ColumnTypeNullDefault Comments
    cal_report_id (Primary)int(10)No Unique id of this report.
    cal_allow_navenum('N', 'Y')YesY Allow user to navigate to different dates with next/previous? ("Y" or "N")
    cal_cat_idint(10)YesNULL Category to filter on (optional).
    cal_include_emptyenum('N', 'Y')YesN Include empty dates in report ("Y" or "N").
    cal_include_headerenum('N', 'Y')NoY If cal_report_type is "html", should the default HTML header and trailer be included? ("Y" or "N")
    cal_is_globalenum('N', 'Y')NoN Is this a global report (can it be accessed by other users - "Y" or "N")
    cal_loginvarchar(25)No Creator of report.
    cal_modtimestampNocurrent_timestamp() Created or last updated.
    cal_report_namevarchar(50)No Name of the report.
    cal_report_typevarchar(20)No Format of report (html, plain or csv).
    cal_show_in_trailerenum('N', 'Y')YesN Include a link for this report in the "Go to" section of the navigation in the page trailer? ("Y" or "N")
    cal_time_rangeint(10)No Time + range for report:<ul><li>0 = tomorrow</li><li>1 + = today</li><li>2 = yesterday</li><li>3 = day +before yesterday</li><li>10 = next +week</li><li>11 = current week</li><li>12 = last + week</li><li>13 = week before last</li><li>20 = + next week and week after</li><li>21 = current week and next + week</li><li>22 = last week and this +week</li><li>23 = last two weeks</li><li>30 = +next month</li><li>31 = current month</li><li>32 + = last month</li><li>33 = month before +last</li><li>40 = next year</li><li>41 = current + year</li><li>42 = last year</li><li>43 = year +before last</li></ul>
    cal_update_datedateNo Date created or last updated (in YYYYMMDD format).
    cal_uservarchar(25)YesNULL User calendar to display (NULL indicates current user).

    Indexes

    No index defined!
    KeynameTypeUniquePackedColumnCardinalityCollationNullComment
    PRIMARYBTREEYesNocal_report_id0ANo
    +

    webcal_report_template

    +Table comments: Defines one of the templates used for a report. Each +report has three templates: <ol><li>Page template - Defines +the entire page (except for header and footer). The following variables +can be defined:<ul><li>${days}<sup>*</sup> - the + HTML of all dates (generated from the Date +template)</li></ul></li><li>Date template - +Defines events for one day. If the report is for a week or month, then +the results of each day will be concatenated and used as the ${days} +variable in the Page template. The following variables can be +defined:<ul><li>${events}<sup>*</sup> - the HTML + of all events for the data (generated from the Event +template)</li><li>${date} - the +date</li><li>${fulldate} - date (includes +weekday)</li></ul></li><li>Event template - +Defines a single event. The following variables can be defined: +<ul><li>${name}<sup>*</sup> - Brief Description +of event</li><li>${description} - Full Description of +event</li><li>${date} - Date of +event</li><li>${fulldate} - Date of event (includes +weekday)</li><li>${time} - Time of event (4:00pm - +4:30pm)</li><li>${starttime} - Start time of +event</li><li>${endtime} - End time of +event</li><li>${duration} - Duration of event (in +minutes)</li><li>${priority} - Priority of +event</li><li>${href} - URL to view event +details</li></ul></li></ol><sup>*</sup> + denotes a required template variable.

    + + + +
    ColumnTypeNullDefault Comments
    cal_report_id (Primary)int(10)No Report id from <a href="webcal_report table">webcal_report</a> table.
    cal_template_type (Primary)enum('D', 'E', 'P')NoP Type + of template:<ul><li>"P": page template represents entire +document</li><li>"D": date template represents a single day +of events</li><li>"E": event template represents a single +event</li></ul>
    cal_template_texttextYesNULL Text of template.

    Indexes

    No index defined!
    KeynameTypeUniquePackedColumnCardinalityCollationNullComment
    PRIMARYBTREEYesNocal_report_idANo
    cal_template_type0ANo
    +

    webcal_site_extras

    +Table comments: This table holds data for site extra fields (customized in site_extra.php).

    + + + + + + +
    ColumnTypeNullDefault Comments
    cal_datedateYesNULL Only used for EXTRA_DATE type fields.
    cal_idint(10)No0 Event id from <a href="webcal_entry">webcal_entry</a> table.
    cal_namevarchar(25)No The brief name of this type (first field in $site_extra array).
    cal_remindint(10)Yes0 How many minutes before event should a reminder be sent.
    cal_typeint(10)No EXTRA_URL, EXTRA_DATE, etc.
    cal_datatextYesNULL Used to store text data.
    +

    webcal_timezones

    +Table comments: This table stores timezones of the world.

    + + + + +
    ColumnTypeNullDefault Comments
    dtendvarchar(16)YesNULL Last date this timezone represents YYYYMMDDTHHMMSSZ format.
    dtstartvarchar(16)YesNULL Earliest date this timezone represents YYYYMMDDTHHMMSSZ format.
    tzid (Primary)varchar(100)No Unique name of timezone, try to use Olsen naming conventions.
    vtimezonetextYesNULL Complete VTIMEZONE text gleaned from imported ics files.

    Indexes

    No index defined!
    KeynameTypeUniquePackedColumnCardinalityCollationNullComment
    PRIMARYBTREEYesNotzid0ANo
    +

    webcal_translations

    +Table comments: Various language translations.

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    ColumnTypeNullDefault Comments
    phrase (Primary)varchar(300)No The + translate / tooltip (phrases) from the code. And the __phrase__ from +version 2.0.0. ("latin1" is currently the only choice that is case +sensitive.)
    on_pagevarchar(50)No which code page (sorted alphabetically) has the first occurance of the above phrase.
    English_USvarchar(300)No The full English text.
    Afrikaansvarchar(300)No
    Albanianvarchar(300)No
    Arabicvarchar(300)No
    Armenianvarchar(300)No
    Azerbaijanvarchar(300)No
    Basquevarchar(300)No
    Belarusianvarchar(300)No
    Bulgarianvarchar(300)No
    Catalanvarchar(300)No
    Chamorrovarchar(300)No
    Chinese_Big5varchar(300)No
    Chinese_GB2312varchar(300)No
    Croatianvarchar(300)No
    Czechvarchar(300)No
    Danishvarchar(300)No
    Dutchvarchar(300)No
    Elvenvarchar(300)No From JRR Tolkien "Hobbit" and "Lord of the Rings".
    Esperantovarchar(300)No
    Estonianvarchar(300)No
    Faroesevarchar(300)No
    Farsivarchar(300)No
    Finnishvarchar(300)No
    Frenchvarchar(300)No
    Galicianvarchar(300)No
    Georgianvarchar(300)No
    Germanvarchar(300)No
    Greekvarchar(300)No
    Hebrewvarchar(300)No
    Hungarianvarchar(300)No
    Icelandicvarchar(300)No
    Indonesianvarchar(300)No
    Italianvarchar(300)No
    Japanesevarchar(300)No
    Klingonvarchar(300)No
    Koreanvarchar(300)No
    Latvianvarchar(300)No
    Lithuanianvarchar(300)No
    Malaysianvarchar(300)No
    Myanmarvarchar(300)No
    Norwegianvarchar(300)No
    Persianvarchar(300)No
    Polishvarchar(300)No
    Portuguesevarchar(300)No
    Portuguese_BRvarchar(300)No
    Romanianvarchar(300)No
    Russianvarchar(300)No
    Serbianvarchar(300)No
    Sinhalavarchar(300)No
    Slovakianvarchar(300)No
    Slovenianvarchar(300)No
    Spanishvarchar(300)No
    Swedishvarchar(300)No
    Taiwanesevarchar(300)No
    Turkishvarchar(300)No
    Ukrainianvarchar(300)No
    Vietnamesevarchar(300)No
    Welshvarchar(300)No

    Indexes

    No index defined!
    KeynameTypeUniquePackedColumnCardinalityCollationNullComment
    PRIMARYBTREEYesNophrase0ANo
    wt_opBTREENoNoon_pageANo
    +

    webcal_user

    +Table comments: Defines a WebCalendar user.

    + + + + + + + + + + + + + + +
    ColumnTypeNullDefault Comments
    cal_login (Primary)varchar(25)No Unique user login.
    cal_enabledenum('N', 'Y')YesY Allow admin to disable account? (Y or N)
    cal_is_adminenum('N', 'Y')YesN Is the user a WebCalendar administrator? (Y or N)
    cal_last_logintimestampNocurrent_timestamp() Date user last logged in.
    cal_modtimestampNocurrent_timestamp() User's last log in.
    cal_passwdvarchar(32)YesNULL The user's password (not used for http.)
    cal_lastnamevarchar(25)YesNULL
    cal_firstnamevarchar(25)YesNULL
    cal_emailvarchar(75)YesNULL
    cal_telephonevarchar(50)YesNULL
    cal_addressvarchar(75)YesNULL
    cal_titlevarchar(75)YesNULL
    cal_birthdayint(11)YesNULL
    cal_typeenum('A', 'N', 'S', 'U')YesU Is this an A)dmin, N)on_user, S)ystem, or ordinary U)ser? Will evevtually replace is_admin.

    Indexes

    No index defined!
    KeynameTypeUniquePackedColumnCardinalityCollationNullComment
    PRIMARYBTREEYesNocal_login1ANo
    +

    webcal_user_layers

    +Table comments: Define layers for a user.

    + + + + + +
    ColumnTypeNullDefault Comments
    cal_login (Primary)varchar(25)No Login of owner of this layer from <a href="webcal_user">webcal_user</a> table.
    cal_layeruser (Primary)varchar(25)No Login name of user that this layer represents. Also from <a href="webcal_user">webcal_user</a> table.
    cal_colorvarchar(25)YesNULL Color (preferably in hex) of this layer.
    cal_layeridint(10)No Unique layer id.
    cal_dupsenum('N', 'Y')YesN Show duplicates? (Y or N)

    Indexes

    No index defined!
    KeynameTypeUniquePackedColumnCardinalityCollationNullComment
    PRIMARYBTREEYesNocal_loginANo
    cal_layeruser0ANo
    cal_layeridBTREEYesNocal_layerid0ANo
    +

    webcal_user_pref

    +Table comments: Specify preferences for a user. Most preferences are set + via pref.php. Values in this table are loaded after system settings +found in <a href="#webcal_config">webcal_config</a> table.

    + + + +
    ColumnTypeNullDefault Comments
    cal_login (Primary)varchar(25)No User login from <a href="#webcal_user">webcal_user</a> table.
    cal_setting (Primary)varchar(50)No Setting name.
    cal_value (Primary)varchar(100)No Value of setting.

    Indexes

    No index defined!
    KeynameTypeUniquePackedColumnCardinalityCollationNullComment
    PRIMARYBTREEYesNocal_loginANo
    cal_settingANo
    cal_value3ANo
    +

    webcal_user_template

    +Table comments: This table stores the custom header/stylesheet/trailer. +If configured properly, each user (or nonuser cal) can have their own +custom header/trailer.

    + + + +
    ColumnTypeNullDefault Comments
    cal_login (Primary)varchar(25)No User login (or nonuser cal name), the default for all users is stored with the username "__webcal__sys__".
    cal_type (Primary)enum('H', 'S', 'T')No H)eader, S)tylesheet/script, T)railer.
    cal_template_texttextYesNULL Text of template.

    Indexes

    No index defined!
    KeynameTypeUniquePackedColumnCardinalityCollationNullComment
    PRIMARYBTREEYesNocal_loginANo
    cal_type0ANo
    +

    webcal_view

    +Table comments: A "view" allows a user to put the calendars of multiple +users all on one page. A "view" is valid only for the owner (cal_owner) +of the view. Users for the view are in <a +href="#webcal_view_user">webcal_view_user</a> table.

    + + + + + +
    ColumnTypeNullDefault Comments
    cal_view_id (Primary)int(10)No Unique view id.
    cal_is_globalenum('N', 'Y')NoN Is this a global view? (can it be accessed by other users - "Y" or "N")
    cal_namevarchar(50)No Name of view.
    cal_ownervarchar(25)No Login name of owner of this view. From <a href="#webcal_user">webcal_user</a> table.
    cal_view_typeenum('D', 'M', 'W')YesNULL "W" for week view, "D" for day view, "M" for month view.

    Indexes

    No index defined!
    KeynameTypeUniquePackedColumnCardinalityCollationNullComment
    PRIMARYBTREEYesNocal_view_id0ANo
    +

    webcal_view_user

    +Table comments: Specify users in a view.

    + + +
    ColumnTypeNullDefault Comments
    cal_view_id (Primary)int(10)No view id from <a href="#webcal_view">webcal_view</a> table.
    cal_login (Primary)varchar(25)No A user in the view. From <a href="#webcal_user">webcal_user</a> table.

    Indexes

    No index defined!
    KeynameTypeUniquePackedColumnCardinalityCollationNullComment
    PRIMARYBTREEYesNocal_view_idANo
    cal_login0ANo

    diff --git a/docs/WebCalendar-DeveloperGuide.html b/docs/WebCalendar-DeveloperGuide.html index fd3ce831b..b8753cbc1 100644 --- a/docs/WebCalendar-DeveloperGuide.html +++ b/docs/WebCalendar-DeveloperGuide.html @@ -1,84 +1,11 @@ - - - - -WebCalendar Developer Guide - + + + + + WebCalendar Developer Guide + - +

    WebCalendar Developer Guide

    Table of Contents

    @@ -93,7 +20,7 @@

    Table of Contents

  • FAQ
  • Resources
    • -
    +

    Introduction

    @@ -103,7 +30,7 @@

    Introduction

    top
    -
    +

    Tools

    @@ -146,7 +73,7 @@

    Tools

    top
    -
    +

    Getting The Code

    @@ -178,7 +105,7 @@

    Naming Conventions

    Classes should be defined in files contained in includes/classes/. Filenames should be of the form ClassName.class. There should only be one - class defined per file.
    + class defined per file.
    If incorporating a class from another project (i.e. phpMailer ), it is acceptable to use the original naming conventions and filenames. This will allow for easy upgrading and help avoid any GNU license issues. @@ -253,7 +180,7 @@

    Coding Standards

    PHP file comments
    Each file should have a file header. -
    +
    See report.php as an example.
    @@ -359,7 +286,7 @@

    Translations and Languages

    seems to suffice for our purposes. Possibly, a better technique would be to use the charset of the original creator of the data, but this is beyond current capabilities. -
    +
    For reference see: http://us3.php.net/manual/en/function.htmlentities.php @@ -406,7 +333,7 @@

    Frequently Asked Questions

    updated file. In that case, you should be able to just replace the old file with the new (assuming the new file and your install are based on the same version of WebCalendar). -

    +

    Others are patch files, which usually have a .diff or .patch file extension. In order to use one of these files, you need the GNU patch @@ -414,13 +341,13 @@

    Frequently Asked Questions

    version for Windows. I use the patch program that comes with Cygwin on windows.) I would recommend testing the patch on your install first using the --dry-run option. -

    +

    For example, if the patch file is called calmods.diff, then you would use: 
    patch --dry-run < calmods.diff
    If the program says it cannot determine which file to patch, try adding -p1: 
    patch --dry-run -p1 < calmods.diff
    -

    +

    If it goes through all the changes successfully, do the same command without the --dry-run option to install the patch. If it says "hunk failed", then the patch cannot be applied without hand-merging files. This @@ -457,13 +384,12 @@

    Resources

    top
    -
    +

    Last Update: $Id: WebCalendar-DeveloperGuide.html,v 1.19 2007/07/12 19:29:10 bbannon Exp $ -
    +
    Valid XHTML 1.0! + src="../images/HTML5_Logo.png" alt="Valid HTML5!">

    diff --git a/docs/WebCalendar-Functions.html b/docs/WebCalendar-Functions.html index eb97be172..349226b4a 100644 --- a/docs/WebCalendar-Functions.html +++ b/docs/WebCalendar-Functions.html @@ -1,83 +1,21 @@ - - - - -WebCalendar Function Documentation - - - -

    WebCalendar Function Documentation

    -
    - -
    - - - - + + + + + WebCalendar Function Documentation + + + +

    WebCalendar Function Documentation

    +
    Home Page:http://webcalendar.sourceforge.net/
    WebCalendar Version:v1.0RC3+CVS (?? ??? 2005)
    + + + + + + + +
    Home Page:https://github.com/craigk5n/webcalendar
    WebCalendar Version:v1.2.7 (22 Feb 2013)
    Last updated:04-Mar-2005

    List of Functions

    @@ -178,1189 +116,1188 @@

    List of Functions

  • weekday_name
  • weekday_short_name
    • -
    -

    +
    +

    activate_urls

    -activate_urls ( $text )

    +activate_urls ( $text )

    Description:
    Look for URLs in the given text, and make them into links.
    -Parameters:
    +Parameters:
    Returns:
    The text altered to have HTML links for any web links (http or https)
    Location:
    functions.php, line 3275
    -

    -

    +

    +

    activity_log

    -activity_log ( $event_id, $user, $user_cal, $type, $text )

    -Description:
    Add something to the activity log for an event. The information will be saved to the webcal_entry_log table.
    -Parameters:
    +activity_log ( $event_id, $user, $user_cal, $type, $text )

    +Description:
    Add something to the activity log for an event. The information will be saved to the webcal_entry_log table.
    +Parameters:
    Returns:
    The value used in the HTML form (or URL)
    Location:
    functions.php, line 771
    -

    -

    +

    +

    background_css

    -background_css ( $color, $height, $percent )

    -Description:
    Creates the CSS for using gradient.php, if the appropriate GD functions are available. A one-pixel wide image will be used for the background image.

    Note The gd library module needs to be available to use gradient images. If it is not available, a single background color will be used instead.
    -Parameters:
    +background_css ( $color, $height, $percent )

    +Description:
    Creates the CSS for using gradient.php, if the appropriate GD functions are available. A one-pixel wide image will be used for the background image.

    Note The gd library module needs to be available to use gradient images. If it is not available, a single background color will be used instead.
    +Parameters:
    Returns:
    The style sheet text to use
    Location:
    functions.php, line 4433
    -

    -

    +

    +

    boss_must_approve_event

    -boss_must_approve_event ( $assistant, $boss )

    +boss_must_approve_event ( $assistant, $boss )

    Description:
    Check the boss user preferences to see if the boss must approve events added to their calendar.
    -Parameters:
    +Parameters:
    Returns:
    true if the boss must approve new events
    Location:
    functions.php, line 3810
    -

    -

    +

    +

    boss_must_be_notified

    -boss_must_be_notified ( $assistant, $boss )

    +boss_must_be_notified ( $assistant, $boss )

    Description:
    Check the boss user preferences to see if the boss wants to be notified via email on changes to their calendar.
    -Parameters:
    +Parameters:
    Returns:
    true if the boss wants email notifications
    Location:
    functions.php, line 3794
    -

    -

    +

    +

    build_entry_popup

    -build_entry_popup ( $popupid, $user, $description, $time, $site_extras )

    +build_entry_popup ( $popupid, $user, $description, $time, $site_extras )

    Description:
    Build the HTML for the event popup (but don't print it yet since we don't want this HTML to go inside the table for the month).
    -Parameters:
    +Parameters:
    Returns:
    The HTML for the event popup
    Location:
    functions.php, line 1084
    -

    -

    +

    +

    calc_time_slot

    -calc_time_slot ( $time, $round_down, $10AM )

    +calc_time_slot ( $time, $round_down, $10AM )

    Description:
    Calculate which row/slot this time represents. This is used in day and week views where hours of the time are separated into different cells in a table.
    -Parameters:
    +Parameters:
    Returns:
    The time slot index
    Location:
    functions.php, line 2655
    -

    -

    +

    +

    check_for_conflicts

    -check_for_conflicts ( $date, $duration, $hour, $minute, $participants, $login, $id )

    -Description:
    Check for conflicts. Find overlaps between an array of dates and the other dates in the database.
    Limits on number of appointments: if enabled in System Settings ($LIMIT_APPTS global variable), too many appointments can also generate a scheduling conflict.

    TODO Update this to handle exceptions to repeating events
    -Parameters:
    -