Release Notes
Installation Instructions - First Time
For first-time installations of the LuxCal Event Calendar, follow the instructions in the installation_guide.html.
Installation Instructions - Upgrade to a new version
To upgrade your LuxCal calendar to a new version follow the Upgrade Instructions below.
LuxCal 4.5.0 - Release date: ??.??.2016
Important Notes for LuxCal 4.5:
- Major Release: This LuxCal version is a major release with many changes, improvements and bug fixes. This version is using a MySQL database for the installed calendar(s). Before upgrading you may want to read the change log, which can be viewed in the release notes on the LuxCal web site in the LuxCal Forum under What's New.
- Database: This version has a number of new capabilities, and therefore the structure of the database has changed. Before going any further be sure to back up your database (via the admin's Database page) and store the backup file in a safe place.
Upgrade Instructions
If you are upgrading from an older version, carefully follow the next steps:
- IMPORTANT: Create a backup copy of your current calendar via the Database page of the Administration drop-down menu in the navigation bar of the calendar and backup your full calendar installation (the calendar root folder and all sub-folders) to a temporary location.
- IMPORTANT: If you have tailored the styles sheet file, the language files or other files of your current calendar installation, make a backup of the file(s) concerned and apply the changes to the new file(s) after successful installation.
- a. When upgrading from a LuxCal version lower than 2.7.2, first upgrade to
LuxCal 2.7.2 (Ask the LuxCal team to send you a LuxCal 2.7.2 zip-file).
b. When upgrading from LuxCal version 2.7.2, make a backup copy of the file lcaldbc.dat located in the calendar root on the server of your hosting provider.
c. When upgrading from LuxCal version 2.7.3 or higher, make a backup copy of the file lcconfig.php located in the calendar root on the server of your hosting provider. - Delete all LuxCal files and folders from the server, EXCEPT THE FILE lcconfig.php (or lcaldbc.dat - see point 1. above) IN THE ROOT folder.
- Download and unzip the latest version of LuxCal (file: luxcalxxx.zip, where 'xxx' is the version number). This file contains the following two compresssed files: luxcalxxx-calendar.zip and luxcalxxx-toolbox.zip. Unzip the file luxcalxxx-calendar.zip and upload all files and folders to the calendar root on the server. Keep the file luxcalxxx-toolbox.zip for possible later use.
- Launch the calendar by browsing to the calendar root on the server. The upgrade script will start automatically and if the upgrade is successful, select Start Calendar.
- If the calendar is displayed successfully, delete the following files from the calendar root: installxxx.php and upgradexxx.php (where 'xxx' is the calendar version number)
- Save a backup copy of the file lcconfig.php, with the LuxCal version number and the calendar database parameters, which is located in the calendar root folder.
Multiple Calendars
This LuxCal version supports multiple calendars sharing the same database. These calendars are fully independent and have their own settings. The advantages are that the software is installed just once - so easy upgrading - and that you only need one database. For details see the installation_guide.html - section 4.
Periodic Functions
Note: If you want to use the calendar's periodic functions, like sending email reminders, exporting events in iCalendar format, etc., you need to set up a cron job which runs daily at approx. 2 AM and starts the lcalcron.php script in the calendar's root folder. Details on how to define a cron job can be found in the header of the file lcalcron.php. Depending on the configuration settings, the lcalcron.php script will execute the following functions:
- sending of email reminders
- sending of emails with calendar changes *)
- exporting events in iCalendar format *)
- checking if events have expired and should be deleted *)
- checking if user accounts have expired and should be deleted *)
*) if activated on the admin's Settings page
Language Files
If you have translated one of the user interface language files into an other language, you should be aware of the following.
Each user-interface language is defined in three language files: ({lang} is the name of the language)
- lang/ug-{lang}.php file: User guide for the calendar users
- lang/ui-{lang}.php file: User interface texts for the calendar pages
- lang/ai-{lang}.php file: User interface texts for the admin pages
For the language files character encoding "utf-8 without BOM" (BOM = Byte Order Mark) is recommended.
All language files included in the LuxCal download are up to date with this LuxCal version. However, for certain languages we could not translate the new and changed texts. These texts were added / changed in English and still need to be translated.
Change Log
The full change log can be viewed on the LuxSoft web site in the release notes in the LuxCal forum under "What's New". A detailed, more technical, list of changes can be found in the Developper's Notes in the file DevNotes-xx.txt in the calendar root folder.