Location: PHPKode > scripts > LuxCal Web Based Event Calendar > release_notes_luxcal_3.1.2.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>LuxCal Release Notes and Upgrade Instructions</title>
<meta name="description" content="LuxCal web calendar - a LuxSoft product">
<meta name="keywords" content="LuxSoft, LuxCal, LuxCal web calendar">
<meta name="author" content="Roel Buining">
<meta name="robots" content="nofollow">
<link rel="shortcut icon" href="lcal.ico">
<style type="text/css">
* { padding:0; margin:0; }
body {
	font:12px arial, helvetica, sans-serif;
	background:#E0E0E0;
	color:#2B3856;
}
a {text-decoration:none; cursor:pointer;}
h1 {font-size:18pt; text-shadow:grey 0.2em 0.3em 0.2em;}
h3 {margin:20px 0 10px 0; font-size:14pt;}
h4 {margin:10px 0 0 0; font-size:12pt;}
h5 {margin:10px 0 0 0; font-size:11pt;}
h6 {margin:10px 0; font-size:10pt;}
ul, ol {margin:0 20px;}
li {margin:10px 0;}
.top {background:#F2F2F2;	padding:10px;}
.floatR {float:right;}
.center {text-align:center;}
.marginLR {margin:0 40px;}
.flag {color:#FF3300;}
.redFlag {color:#DD3300; font-weight:bold;}
.footLB {font:italic bold 1.1em arial,sans-serif; color:#0033FF;}
.footLR {font:italic bold 1.1em arial,sans-serif; color:#AA0066;}
.navBar {
	width:100%;
	background:#AAAAFF;
	padding:2px 10px;
	border-top:1px solid #808080;
	border-bottom:1px solid #808080;
	line-height:20px;
	vertical-align:middle;
}
.endBar {
	clear:left;
	background:#AAAAFF;
	padding:0px 10px;
	text-align:right;
	border-top:1px solid #808080;
	border-bottom:1px solid #808080;
	font-size:0.8em;
}
.content {padding:10px;}
</style>
</head>

<body>
<div class="top">
<h4 class="floatR">a LuxSoft product</h4>
<h1>LuxCal Event calendar</h1>
</div>
<div class="navBar">&nbsp;</div>
<div class="content marginLR">

<h3 class="center">Release Notes</h3>
<!--
<br>
<center><h4 class="redFlag">THIS IS NOT THE LATEST VERSION OF LUXCAL</h4></center>
<center><h4 class="redFlag">FOR THE LATEST VERSION GO TO <a href="http://www.luxsoft.eu">LUXSOFT</a></h4></center>
<br>
-->
<br><h4>Installation Instructions - First Time</h4>
<p>For first-time installations of the LuxCal Event Calendar, follow the 
instructions in the <kbd>installation_guide.html</kbd>.</p>
<br>
<h4>Installation Instructions - Upgrade to a new version</h4>
<p>To upgrade your LuxCal calendar to a new version follow the Upgrade 
Instructions below.</p>
<br>
<h4>LuxCal 3.1.2 - Release date: 22.06.2013</h4>
<h5 class="redFlag">Important Notes for LuxCal 3.1:</h5>
<ol class="redFlag">
<li>Major Release: This LuxCal version is a major release with many changes, improvements 
and bug fixes. Before upgrading, please read the notes hereafter and read the change 
log, which can be viewed in the release notes on the LuxCal web site: 
<a href="http://www.luxsoft.eu/forum/index.php?a=vforum&amp;f=3"><b><i> 
Forum	- What's New</i></b></a>.</li>
<li>Database: Upgrading to this LuxCal version will change the structure of the MySQL 
database. Before going any further be sure to back up your database (via the 
admin's Database page) and copy the backup file from the <kbd>files/</kbd> 
folder to a safe place.</li>
<li>Sidebar: In this LuxCal version the style names of the sidebar in the file 
<kbd>css/css_sbar.php</kbd> have changed. If you are using the v2.7.3 stand-alone 
sidebar, then backup your <kbd>css/css_sbar.php</kbd> file and re-apply your styles 
to the new <kbd>css/css_sbar.php</kbd> file.</li>
<li>Event check boxes: In LuxCal v2.7.3 via the event categories you can activate one 
or two check boxes, which are displayed just in front of the event title in the various 
views. In v3.1.X only one check box can be activated. The second check box has been 
replaced by a propose / approve mechanism. For details see the admin_guide.html.</li>
</ol>

<h5>Upgrade Instructions</h5>
<p>If you are upgrading from an older version, carefully follow the next steps:</p>
<ol>
<li>a. When upgrading from LuxCal version 2.5.3 or lower, first upgrade to LuxCal 
		2.7.2 (Ask the LuxCal team to send you a LuxCal 2.7.2 zip-file).<br>
		b. When upgrading from LuxCal version 2.6.0 - 2.7.2, make a backup copy of 
		the file <kbd>lcaldbc.dat</kbd> located in the calendar root on the server of 
		your hosting provider.<br>
		c. When upgrading from LuxCal version 2.7.3 or higher, make a backup copy of 
		the file <kbd>lcconfig.php</kbd> located in the calendar root on the server of 
		your hosting provider.</li>
<li>IMPORTANT: If you have tailored the style 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.</li>
<li>Delete all LuxCal files and folders from the server, <span class="redFlag">
		EXCEPT THE FILE <kbd>lcconfig.php</kbd> (or <kbd>lcaldbc.dat</kbd> - see 
		point 1. above) IN THE ROOT folder</span>.</li>
<li>Download and unzip the latest version of LuxCal (file: <kbd>luxcalxxx.zip</kbd>, 
		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 later 
		use.</li>
<li>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.</li>
<li>If the calendar is displayed successfully, delete the following files from 
		the calendar root: <kbd>installxxx.php</kbd> and <kbd>upgradexxx.php</kbd> 
		(where 'xxx' is the calendar version number)</li>
<li>The file <kbd>lcconfig.php</kbd>, with the LuxCal version number and the 
		MySQL database credentials, in the calendar root on the server has been 
		created/changed. <span class="redFlag">Save a backup copy</span>.</li>
</ol>
			
<h5>Multiple Calendars</h5>
<p>This new 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 <kbd>installation_guide.html</kbd> - 
section 4.</p>

<h5>Periodic Functions</h5>
<p>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 <kbd>lcalcron.php</kbd> script 
in the calendar's root folder. Details on how to define a cron job can be found 
in the header of the file <kbd>lcalcron.php</kbd>.
Depending on the configuration settings, the <kbd>lcalcron.php</kbd> script will 
execute the following functions:</p>
<ul>
<li>sending of email reminders</li>
<li>sending of emails with calendar changes *)</li>
<li>exporting events in iCalendar format *)</li>
<li>checking if events have expired and should be deleted *)</li>
<li>checking if user accounts have expired and should be deleted *)</li>
</ul>
<p>*) if activated on the admin's Settings page</p>

<h5>Language Files</h5>
<p>If you have translated one of the user interface language files into an other 
language, you should be aware of the following.</p>
<p>Each user-interface language is defined in three language files: ({lang} is 
the name of the language)</p>
<ul>
<li>lang/ug-{lang}.php file: User guide for the calendar users</li>
<li>lang/ui-{lang}.php file: User interface texts for the calendar pages</li>
<li>lang/ai-{lang}.php file: User interface texts for the admin pages</li>
</ul>
<p><b>For the language files character encoding "utf-8 without BOM" (BOM = Byte 
Order Mark) is recommended.</b></p>
<p>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.</p>

<h5>Change Log</h5>
<p>The full change log can be viewed in the release notes on the LuxCal web site: 
 <a href="http://www.luxsoft.eu/forum/index.php?a=vforum&amp;f=3"><b><i> Forum
	- What's New</i></b></a>.</p>
</div>
<br><br>
<div class="endBar">
	design 2013 - powered by <a href="http://www.luxsoft.eu"><span class="footLB">Lux</span><span class="footLR">Soft</span></a>
</div>
<br>&nbsp;
</body>
</html>

Return current item: LuxCal Web Based Event Calendar