Read Me
-------------------------------------------------------
eTests 0.3.1 - readme.txt
-------------------------------------------------------
License EUPL v. 1.1 - 2011
Grégoire Vincke - gregoire.vincke@ataya.be
https://sourceforge.net/projects/etests/
-------------------------------------------------------
0 - Sommaire
============
1 - Introduction
2 - License
3 - Author
4 - Contribute
5 - Libraries and icons
6 - Requirements
7 - Installation
8 - Update
1 - Introduction
================
eTests is a web application to create and provide formative evaluations.
Description of the project and documentation about eTests can be found at :
https://sourceforge.net/projects/etests/
2 - License
===========
Licensed under the EUPL, Version 1.1 only (the "Licence");
You may not use this work except in compliance with the Licence.
You may obtain a copy of the Licence in your language at: http://ec.europa.eu/idabc/eupl5
English version can be founded in licence.eupl.1.1.txt
Unless required by applicable law or agreed to in writing, software distributed under the Licence is
distributed on an "AS IS" basis, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the Licence for the specific language governing permissions and limitations under the Licence.
3 - Author
==========
This software was created, and is actually developped by Grégoire Vincke (gregoire.vincke@ataya.be).
4 - Contribute
==============
If you want to contribute to the development of eTests, please contact gregoire.vincke@ataya.be.
5 - Libraries and icons
=======================
This software uses some libraries and icons, published under several licences.
The libraries where not modified, and where used as is, according to their licenses.
Some of the icons where modified, according to their licenses.
Libraries under GNU Lesser General Public License 2.1 (LGPL) :
See licence.lgpl.2.1.txt or http://www.gnu.org/licenses/lgpl-2.1.html
* Smarty 2.6.18 , © New Digital Group, Inc, http://smarty.php.net/
Files are in libraries/smarty
* FCKEditor 2.5.1, © 2003-2007 Frederico Caldeira Knabben, http://www.fckeditor.net
Files are in libraries/fckeditor
* TinyMCE 3.3.9.3, © 2003-2011 Moxiecode Systems AB, http://tinymce.moxiecode.com/
Files are in libraries/tinymce
* Securimage 2.0 BETA, © Drew Phillips, http://www.phpcaptcha.org
Files are in libraries/securimage
* PclZip 2.8.2, © Vincent Blavet, http://www.phpconcept.net
Files are in libraries/pclzip
* TCPDF 4.9.009, © 2001-2010 Nicola Asuni, http://www.tcpdf.org
Files are in libraries/tcpdf
* UASparser 0.4.2 beta, © 2008 Jaroslav Mallat, http://user-agent-string.info/download/UASparser
Files are in libraries/uasparser
Libraries under MIT-style license (MIT) :
See licence.mit.txt or http://www.opensource.org/licenses/mit-license.php
* Prototype 1.6.0.1, © 2006-2007 Prototype Core Team, http://www.prototypejs.org/
Files are in libraries/scriptaculous
* Scriptaculous 1.8.1, © 2005-2007 Thomas Fuchs, http://script.aculo.us
Files are in libraries/scriptaculous
* ModalBox 1.6.1, © 2006-2007 Andrey Okonetchnikov, http://okonet.ru/projects/modalbox/
Files are in libraries/modalbox
* DOM Popup Kit 1.0.1, © Stuart Rackham, http://www.methods.co.nz/popup/popup.html
Files are in libraries/popup
* Protopass 4dc1431, © 2010 Bermi Ferrer, http://github.com/bermi/protopass
Files are in libraries/protopass
* DatePicker 1.0.0, © 2007-2008 Mathieu Jondet, 2009 Titi Ala'ilima, http://code.google.com/p/prototype-datepicker-widget
Files are in libraries/datepicker
Libraries and icons under Creative Commons Attribution 2.5 License 2.5 (CC-BY) :
See licence.cc.by.2.5.txt or http://creativecommons.org/licenses/by/2.5/legalcode
* Lightbox2 2.04, © Lokesh Dhakar, http://www.huddletogether.com/projects/lightbox2/
Files are in libraries/lightbox
* FAMFAMFAM Silk icon set 1.3, © Mark James, http://www.famfamfam.com/lab/icons/silk/
Files are in themes/templates/default/img/icons
Icons in the Public Domain :
* FAMFAMFAM Flag icons, © Mark James, http://www.famfamfam.com/lab/icons/flags/
Files are in themes/templates/default/img/flags
6 - Requirements
================
* PHP 5.1.0 or higher, with builtin GD library
* MySQL 5.0.x or higher
7 - Installation
================
1. Unzip and copy the files to a directory of your choice where Your httpd sever can access them.
2. Give access permissions (777 or 755) to theses directories : /files , /themes/template_c , /themes/cache , /themes/configs
3. Create a database in your MySQL server, and create a user that have the appropriate permissions to create and edit tables.
4. Create the tables using install/mysql.tables.sql
5. Edit system/config.db.inc.php and set your MySQL server, database and user informations.
6. Edit system/config.inc.php and adapt it to your needs.
7. Create a user by browsing on index.php?go=user/new . For the first user the system-created password will be show.
8. Go in your MySQL database, in the user table, and edit your user and set user_role to 1 (admin user).
9. Enjoy !
8 - Update
==========
1. Backup all files and database before update !!! Update is still manual. Do it at your own risks!
2. Extract archive of new version in root directory.
3. Check system/config.inc.php and system/config.db.inc.php to restore your values.
4. Execute queries listed in install/version1-version2.sql file (exemple for updating from 0.3.0 to 0.3.1 : 0.3.0-0.3.1.sql)
5. Cross fingers ;-)