/* ======================================================================== \ | forma.lms- The E-Learning Suite | | | | Copyright (c) 2013 (forma.lms) | | http://www.formalms.org | | License http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt | | | \ ======================================================================== */ ----------------------------------------------------------------------------- forma.lms 2.1 Release date: 2018 august 28 ----------------------------------------------------------------------------- Index ----- 0. Release Notes 1. Licence 2. Requirements 3. Installation procedure 4. Upgrade procedure 4.1 Upgrade from version 1.xx 4.2 Upgrade from docebo ce 3.x and 4.x 5. Loading a new language 6. Other ------------------------------------------------------------------------------ 0 RELEASE NOTES (2.1) For all bugfix and new features included in this release, please read changelog.txt Here are some notes from base release 0.1 RELEASE NOTES (2.0) Release date: 2018 june 19 This is a new major release with new features, redesign of the UI , many improvements For a list of all the new features included in this release, please read changelog.txt Here are some important notes: a) PHP support Full support for PHP from 5.4.x to 7.0.x Known issues for PHP 7.1.x and 7.2.x will be addressed in next releases Dropped support for PHP < 5.4 improved wrapper for mysqli - switch automatically to mysqli driver if mysql is missing b) Template System Refactored front-end (users) UI with native responsive system based on bootstrap, Enhanced administrator templates . forma.lms 1.x.x templates are NOT supported During upgrade and running a 2.x version forma.lms will check the defined template and - if not supported - will switch to the standard template. A template labeled "standard" must always exist. A compliant 2.0 template must have a manifest file declaring the supported version (for now 2.0) As a suggestion, never change the standard template, if you need customisation, copy it into a new one and change it c) Privacy and GDPR compliance forma.lms is released with a compliant set of privacy features. The default settings meet GDPR requirements. You can change these settings as per your requirements. Acceptance of privacy policy registers who, when and wich privacy policy has been acknowledged. Go to the privacy section of the administration section to set privacy messages. By default, forma.lms uses the privacy messages taken from the language translation. Any modification must be made in the privacy settings section. Note that privacy language translation defaults might be dropped in future releases. Each orgchart node can have its own privacy policy. A node without a specific policy will use the policy marked as "default" After the upgrade from the 1.xx release all users must re-accept the privacy policy upon the first login. d) Public admin removed The "public admin" feature has been dropped. The "admin" feature remains and has been enhanced with new permissions During the upgrade from 1.xx, users with the "public admin" permissions will be reverted to standard users. However, the courses and orgchart node assigned to such users are retained. After the upgrade, you must update the interested users to the admin role and assign them an administration profile (create a new one if needed). e) direct SSO link. The SSO direct link from an external site to forma.lms has changed . v1.xx url: http://yourformalms.domain.com/appLms/index.php v2.xx url: http://yourformalms.domain.com/index.php All other parameters (token included) have not changed f) Assessment Feature dropped g) Plugin system The plugin system has been enhanced in the administration section and its use has been extended into the system. Each plugin must have a manifest file to describe its version, forma.lms version and dependencies. Many components has been converted to plugins, and distributed with the core system: -- all the login module -- the base video conferencing systems -- some reports With next releases, other components will be converted. h) Back-end administration menu DB tables and contents used by "admin menu components" have changed. During the upgrade any customization of these will be lost ------------------------------------------------------------------------------ 1. LICENCE This software is released with GPL v2.0 license, please refer to the provided file license.txt for details. The hardcoded "Powered by forma.lms CE" credit must NOT be removed, in respect to the work of the project and community. You are welcome to add your credits to the page footer using the provided configuration option. 2. REQUIREMENTS Server specs: Linux, Windows, MacOs, Unix, Sun with - Apache 2.2.x or above (on Windows also IIS can be used) - PHP 5.4.x 5.5.x 5.6.x 7.0.x - Mysql 5.0 or higher, mariadb 5.5 or higher db server engine must have transaction support (innodb recommended) - Doesn't matter if safe mode or register global are on or off If you need to test on your personal computer we suggest a prepackaged web server environment as easyphp, wamp/mamp or xampp. 3. INSTALL PROCEDURE - Be sure you have your database parameters (host, user, password, dbname) available - If you want use at runtime FTP upload features, be sure you have your ftp parameters (host, user, password), - Before install, create the database on your dbserver. You can use any db admin tool as phpmyadmin If you use a prepackaged webserver on your PC , the default db admin link is http://localhost/mysql/ or http://localhost/phpmyadmin/ If the db user have permissions, the installer can create database for you The database must be defined with UTF8 encoding - Upload all the files in your root directory or subfolder - forma.lms web is protected with apache .htaccess files from unauthorized use. Often dot-files are hidden from view. Check your environment and be sure that also these files are uploaded - Launch http://www.yoursite.com/install/ - Follow installation instructions - To secure you installation, at the end of install, remove or rename the folders install and upgrade Note: At the end step of install procedure, the system will load XML file languages. Depending on number of language chosen, this operation can take some time in order to complete 4. UPGRADE PROCEDURE - Make a full backup of db and files - Make sure that you have a full backup that you can trust and recover if needed - Export the language files (if you did any customization), to import them again after the upgrade - Delete all files and directories excluding * the folder files/ and all subfolders and files * the folder customscripts/ * your own templates in templates/ (if you have any) * the config.php file in root folder - Upload the new files - The upgrade procedure needs resources under install folder, so make sure to upload also this one - forma.lms web is protected with apache .htaccess files from unauthorized use. Often dot-files are hidden from view. Check your environment and be sure that also these files are uploaded - Launch http://www.yourwebsite.com/upgrade - Follow upgrade instructions. - As final step of the upgrade, the procedure imports and updates all languages previously defined with the standard translations. - At the end of upgrade, go to the "Administration panel/Language" to import your own language files - To secure you installation, at the end of upgrade, remove or rename the folders install and upgrade. The procedure may change for you the config.php file (if writable, or require you to download it and upload to the web root folder, if not) 4.2 Upgrade from version 1.xx During upgrade from forma.lms 1.x to forma.lms 2.xx, pay attention to a) Database after upgrade the DB are not full compatible with forma.lms 1.xx, and there is no path to go back. Made a backup before upgrade b) Template Template 1.xx are not compatible with 2.xx During the upgrade the site template is updated to "standard" c) Dropped feature d) Customscripts All customization made through customscripts/ must be reviewed and ported to the 2.0 current version. forma.lms does not check base version file with your customized version in customscripts folder. There is no version check support for customscripts files e) The update detects the use of the mysql / mysqli driver and changes the configuration appropriately At the end of the upgrade process, check all the system configuration settings to validate your needs. The update procedure tries to keep the settings, but new options have been added and others have been removed Please, double check above release notes before upgrading 4.2 Upgrade from docebo ce 3.x, docebo ce 4.x You can directly upgrade your old docebo (either series 3.6.x and 4.x) installations to forma.lms 2.x The config.php file is completely changed from D36 and with more config options since D4.x The upgrade procedure change for you the config.php and write (if writable), or require you to download it and upload to the web root folder. Coming from D36 review the config.php and add your own settings, if needed 5. LOADING A NEW LANGUAGE - Make sure that you have the required xml file on your PC (get it from installation tarball) - Go in the administration area - Go in language import/export - Select the xml file - Choose if you want to overwrite previous translation or not - Click Import 6. OTHER