Release Notes - SQLite Version
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.3.0 - Release date: 14.12.2015
Important Notes for LuxCal 4.3:
- Major Release: This LuxCal version is a major release with many changes,
improvements and bug fixes. This version is using an SQLite database for each
installed calendar. 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
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.
- Delete all LuxCal files and folders from the calendar folder on the server,
EXCEPT YOUR SQLite DATABASE FOLDER AND ITS CONTENTS
AND EXCEPT THE FILE lcconfig.php IN THE CALENDAR ROOT FOLDER.
- The LuxCal SQLite zip-file you've downloaded 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.
- IMPORTANT: If you have tailored the styles sheet file, the language files or
other files of your previous calendar installation, apply the changes to the
new file(s).
Multiple Calendars
This LuxCal version supports multiple calendars, each using its own SQLite
calendar database. These calendars are fully independent and have their own
settings. For further details on how to install multiple calendars 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.
- End of Release Notes -