Forma LMS Basics

Technical information for system setup and maintenance

Requirements

Server Specifications

Database

WARNING - MySQL Strict Mode
Until version 2.4.2 Forma LMS requires MySql strict mode set to OFF.
Please make sure your hosting provider allows this configuration
This restriction has been removed since version 2.4.3

WARNING - MySQL 5.7 Settings
Using MySQL version 5.7 requires some specific configuration. Check this thread for details

Installation and Upgrade

INSTALL PROCEDURE

  1. Create the database on your dbserver:
    • If the db user has permissions, the installer can create the database for you
    • You can use any db admin tool, such as phpmyadmin
      If you use a prepackaged webserver on your PC, the default db admin link is http://localhost/mysql/ or http://localhost/phpmyadmin
    • Be sure you have your database parameters available (host, user, password, dbname)
    • The database must be defined with UTF-8 encoding
  2. Upload all the files in your root directory or subfolder. 
    • If you want use at runtime FTP upload features, be sure you have your ftp parameters (host, user, password)
    • 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 these files are also uploaded
  3. Launch http://www.yoursite.com/install/ (of course you should type your domain, not “yoursite.com”)
  4. Follow installation instructions. Note: during installation, a config file is created in the application root directory. In case your root is missing writing permissions, you can download it from the link provided on the last installation step, and upload it manually.
  5. To secure your installation, at the end of install, remove or rename the install and upgrade folders

Note:
During the 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

UPGRADE PROCEDURE

  1. Make a full backup of db and files, and make sure that you have a full backup that you can trust and recover if needed
  2. Export the language files (if you did any customization), to import them again after the upgrade
  3. Delete all files and directories excluding
    • the/files folder and all its subfolders and files
    • the customscripts folder
    • your own templates in templates/<yourowntemplate> (if you have any)
    • the config.php file in root folder
  4. Upload the new files
    • The upgrade procedure needs resources under install folder, so make sure to also upload 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
  5. Launch http://www.yourwebsite.com/upgrade (of course you should type your domain, not “yourwebsite.com”)
  6. Follow upgrade instructions.
  7. As a final step of the upgrade, the procedure imports and updates all languages previously defined with the standard translations.
  8. At the end of the upgrade, go to the “Administration panel/Language” to import your own language files
  9. To secure your installation, at the end of upgrade, remove or rename the install and upgrade folders.

The procedure may change the config.php file for you, or it may ask you to download it and upload to the web root folder, if not writable.

Upgrade from version 2.xx

During upgrade from forma.lms 2.x to forma.lms 2.2 and later, pay attention to
a) Template
Template 2.0 and 2.1 are not compatible with 2.2
During the upgrade, the site template is updated to “standard”.
Minimum template version required (see release notes)

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 the above release notes before upgrading

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 changes the config.php for you and writes it (if writable), or requires 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.

General architecture and definitions

Login and Registration

fe_login_explained.png

fe_registration.png

Main Layout Elements 

  1. Language Selector
    Change language for the login and registration page. This automatically detects the user browser language. Upon login, language will be set to the user profile language.

  2. Course Catalog
    Opens the catalog of courses. Feature must be enabled from System Configuration elearning settings.

  3. Login and social login
    Standard login form. Social login features can be activated from the plugin manager.

  4. Privacy Policy
    Default privacy policy text can be edited in admin settings

LMS Frontend & User Panel

The frontend of the application hosts all the learning related features for both students and teachers.

fe_lms_layout_explained.png

fe_userpanel_explained.png

Main Layout elements

1. Main Menu: this is the main navigation menu, for all the general sections of the platform

2. MyCourses Tabs: access different areas of the MyCourses section, if enabled

3. Filters panel: here a user can filter and search among the courses he is subscribed to:

User Panel

This panel displays personal info and features for the user:

1. Profile: if allowed by configuration, user can edit his own profile

2. User features:

3. Career: some basic stats about user activities

4. Language selector

Backend Administration

This is the area of the application where most of the administrative operations happen, such as user management and course creation.

be_admin_dashboard.png

Terms and Definitions

USER LEVEL
it's the main permission level that determines which part of the application a user can access, and his level of permissions. In Forma LMS users might be registered as one of the following levels:
1. User
can only access the frontend
2. Administrator
can access the backend with limited functionalities and permissions over users and courses
3. SuperAdmin
is a "GodAdmin" that can access both the frontend and the backend with full permissions

User ROLE
users of any level can be subscribed to courses with different roles, determining what they can do and see within a course based on course menu configuration and their level
Admin Profile
the admin profile defines which features an admin can access in the backend menu, and what he can do. The admin profile works together with admin permissions that can be set over specific courses, catalogs, user groups, user nodes, etc.

Registration
user is registered to the platform with a specific level
Subscription
user is enrolled to a course with a specific role