eFront FAQs

Normally, if you upload a SCORM 1.2 zip file when creating a unit, it will be automatically imported.

However, there are cases that this will not happen, and the file will simply appear as available to download. Common reasons for this are:

The content is not a SCORM 1.2 version (but SCORM 2004 not compatible with SCORM 1.2 or some other standard)

The file is not packaged according to the SCORM 1.2 specification (very common case: The zip file contains a folder with all the files, rather than the files directly, as imposed by the standard). You can fix your file following these instructions

As an administrator, go to "Home > System Settings" and, from the "Defaults"(1) tab, click on the "Default SCORM mode" fieldto open the drop-down menu(2).

The drop-down menu has two options:

"iFrame"(3)means SCORM content is loaded inside an iFrame in the same window.

"Popup"(4)means SCORM content is loaded in a pop-up window.

Choose yourpreferred option and click on "Save"(5).

Note:You may have set a default SCORM mode, but you can always change your settings for each SCORM unit you add or upload to a course.

To import SCORM or TinCan content into your portal, log in either as an administrator or an instructor, and navigate to the course dashboard to add a new unit.

Then you can follow the steps described in this article for creating a unit using a file. The system will recognize the type of the file and create a SCORM/TinCan unit.

Once uploaded, the SCORM or TinCan content will be inserted into your unit's content. Notice that when it comes to SCORM content, new options are going to be available.

These are settings on how to embed your content (1), you may choose among iFrame or Pop up and this defines how this content is going to appear to learners, as well as the dimensions in width and height of your content (2).

Finally, there is an option that you can enable if you want to retain the failed status (3). In case that a user failed the first time, the took the SCORM content. This status won't change even if the user retakes it and pass it.

If you choose to embed your content as pop up, the content of your unit will be replaced with a "Click to start" button which will be used to start your content and open it in a pop-up window.

Note:We fully support SCORM 1.2 and xAPI content. You can import content in SCORM 2004 format, as long as it is compatible with SCORM 1.2. In order to do so, you have to enable the option 'Enable partial support for SCORM 2004 content' (4) in the section Home > System Settings > Defaults:

New features:

Added course category public id.

Added search with branch domain URL

Added 'Show welcome tour tips to everyone' option in the branch (system) settings

Added line numbers at CSS, JS and Embed code sections of Themes.

Added new API call '/Course/:Id/Content' - get all content of a given course id

Improvements:

Removed course code from course name in Custom Reports

Bug Fixes:

Fixed search box suggested results for groups when typing random letters

Fixed issue in question answers containing quotes

Fixed issue about showing progress data in reports when progress is disabled in user type settings

Fixed a bug for extended list type fields for the User CSV Import functionality

Fixed issue about user certificate date fields in Change certificate data page

Fixed adding a bogus entry in the mail queue, when clicking on "Check settings" in SMTP settings, and the

Fixed branch context when a user of a branch logged in from the main URL

Fixed displaying of math equations in skill gap tests

Fixed Auto Sync initial execution

Fixed listing of certificate images to correct branch admins

Fixed issue about saving as CSV sorted tables when a column contained a hash in title

Fixed issue about popup error (shown when leaving units) in Chrome (version 73.0.3683.103)

Before importing or creating questions using the GIFT/AIKEN formats you first need to activate an ad hoc Plugin that we have created, called GiftAiken.

To install and activate the GiftAiken Plugin, log in as an Administrator and, from the Homepage click on the Plugins icon. Find the Gift/Aiken Plugin (1) and activate it by clicking on the switch (2) (the switch becomes green and the text black).

Once the Plugin is active, whenever you click on "Add content"(3)in a Course's page, you will seea "Gift/Aiken format" option on the dropdown list(4).

In the "Gift/Aiken format" page, pick your preferred format (Gift or Aiken) from the "Format type" drop-down menu (5). Continue to the "Import to unit" drop-down menu(6)to choose if your question(s) will be imported directly to a unit and, if yes, which unit it is. Type or paste your questions into the "Data" area.

Note: You can import more than one questions at the same time. To do so, just leave a blank line after each question.

To confirm that your input is correct and see a preview version of your question(s), click on the "Preview"(7)button. If you're done, click "Import"(8) to complete the operation.

You can delete, edit and reassign a question to a different unit anytime.

For more on how your text should be formatted for each question format, see the two appendices below.

Appendix 1- AIKEN

AIKEN is a simple format that supports multiple choice questions with a single correct answer. The inputted text for each question must occupy a single line. Each answer must be preceded by a single letter, followed by a period or a bracket. The correct-answer line, in the end, must begin with "ANSWER: " followed by the correct answer's starting letter.

Here are some examples:

Pick the odd one outa. Europeb. Asiac. Greenlandd. AustraliaANSWER: cWhich number completes the series 1, 5, 21, 85, ...?A. 149B. 253C. 341D. 405ANSWER: C

Appendix 2- GIFT

GIFT (General Import Format Technology)is a more advanced format that supports an array of question types. Many eFront question types can be imported using GIFT. Please note thateFront may not accept allGIFTfeatures. Also, not alleFront question types and features can be imported using GIFT. Here is a list of question types that can be imported to eFront using the GIFT format.

Multiple-choice

Each option must be preceded by a "tilde" character (~). The correct answer(s) must be preceded by an "equals" character (=).

Here is an example:

Pick the odd one out {~Europe~Asia=Greenland~Australia}

Note:You can have more than one correct answers.

For simple true-or-falsequestions, you have to type the question followed by "{TRUE}" (if the statement is true) or "{FALSE}" (if the statement is false). You can also use the shorter versions "{T}" and "{F}".

Here is an example:

Grant is buried in Grant's tomb.{FALSE}

The sun rises in the east.{TRUE}

Fill-the-gap

For fill-the-gap questions, you have to type the full sentence (question) with the missing words (answers) enclosed inside curly brackets ({}), preceded by an "equals" character (=).

Here is an example:

The {=quick} brown {=fox} jumps {=over} the lazy {=dog}

Drag-and-drop

For drag-and-drop questions, you have to type the question and then enclose the correct answers inside curly brackets ({}). Each option must occupy a single line. It must be preceded by an "equals" sign (=) and followed by its matching option with a "hyphen" (-) and a "greater-than" (>) character between them.

Here is an example:

Match the capitals {

=England -> London

=Germany -> Berlin

=Greece -> Athens

}

Free-text

For free-text questions, you have to type the question followed by empty curly brackets ({}).

Here is an example:

Write about the Spanish civil war {}

Note:No options for accumulated points are supported on imported free-text questions. These can be added later by editing the imported question ineFront.

Audiences allow you to divide your users into logical groups based on certain conditions (Rules), such as the Branch they belong to, their Job Position, their User Type, or custom criteria (values of custom Extended Fields you might have defined for them).

To add an audience you can click on the New Audience button. Over there you will be able to see three options:

1. Audience name: This is a name to identify this audience

2. Description: A short description of this audience

3. Active: Check or leave unchecked if you want this audience to be active or not

Once you created a new audience, you can define its conditions, meaning the rules that apply for this audience in order to include or exclude users from it.

NOTE: When an audience is created in a branch by a Branch Administrator, then only the users of that specific and its sub-branches can be added. Even if this audience is edited and modified by Main Administrators afterwards, still users will be filtered according to the branch where the audience was created.

You can define rules such as:

1. Branch: Select branches so that their users will be members of this audience

2. Job positions: Select job positions so that users with either of these job positions will be members of this audience

3. User type: Select members of this audience based on their user type in the system

4. Language: Select members of this audience based on their language

5. Extended field: Broaden your criteria based on the extended profile fields you have already predefined. Select the extended field and what value it should have in order to set users with this value as members of this audience.

6. Users: Select specific users one by one to add them as members of this audience

Note: The 'Rule' tab section works in a way that, between same criteria items, you have an OR rule active, while, among different criteria, the AND rule is applied.E.g.: if the 'branch' field containsBranchX, BranchY, and BranchZ, while the 'Job position' field containsJob1 and Job2, this means that the audience will have users belonging toeither BranchX, BranchY, or BranchZ, and having as Job position Job1 or Job2.

Once you have set up the conditions for an audience you can assign courses to this audience:

1. You have the option to assign courses to this audience. Once you have done so, the courses you are assigned will be visible to the catalog of the audience members, where they can enroll if they choose to.

2. Moreover, you can assign all members of this audience to the courses you already assigned to the audience on the spot.

Note: the 'Enroll Members to Courses' button will enrol to the courses all active users present in the audiences, and this action will have no effect on inactive users.

Finally, you can assign training sessions to an audience. When you assign a training session, all members of the audience are able to view this training session in their catalog.

There are no limitations on the type of hardware used to host an eFront installation. However, as your needs grow, so will the need for additional resources. This is what we suggest:

Disk: You need 500 MB free disk space, which should be allocated according to usage. Most installations do not require more than 100 GB of disk. However, this should be easily resizable as your needs grow. Using SSD disks will considerably boost the overall performance, especially for the database server.

Memory: 128 MB of free system memory. A minimum of 512 MB of free memory available to PHP is recommended (eFront requires PHP 7.2).

Small Installation

100 users / 5 simultaneous*- 1 GB RAM

200 users / 10 simultaneous* - 2 GB RAM

400 users / 20 simultaneous* - 4 GB RAM

Medium Installation

1000 users / 50 simultaneous* - 4 Virtual CPUs and 4 GB RAM

2000 users / 100 simultaneous* - 8 GB RAM

Big Installation

For usages equal to or higher than 10000 users / 400 simultaneous*, it is suggested to separate the Web Server and Database Server.

10000 users / 400 simultaneous* - 2 Web servers 8 GB RAM each, 2 Database servers 16 GB each**

20000 users / 800 simultaneous* - 2 Web servers 8 GB RAM each, 2 Database servers 16 GB each**

For larger solutions, please contact our Support team to assist you with designing an appropriate plan.

Note: For large installations, connection speed should be at least 10 Gbps.

*By simultaneous, we mean the number of users that are logged in eFront at the same time.

** 4 out of 8 GB of RAM should be allocated to PHP and FPM.

eFront requires an environment running:

PHP version 7.2

MySQL Server 5+

Web server (Apache 2+ recommended for Linux systems, IIS for Windows Server)

eFront may be installed either on a Windows or Linux environment

Recommended caching backend is Memcached

Apache's mod_rewrite should be available and enabled

Apache's mod_expires should be available and enabled

.htaccess overrides should be enabled for the virtual host. Alternatively, copy the rewrite rules. You can find these under www/.htaccess in your server's config file. This should also be the case if you are using a web server other than Apache (consult your web server's documentation on how to implement these rewrite rules. For IIS, see this article ).

modern web browser with HTML5 capabilities. Internet Explorer 11 and above is supported.

Note: This article concerns solely private cloud-hosted eFront portals. The guidelines below do not apply to on-premise deployed installations. To learn how to set up domains at a branch level check this article.

If you have recently subscribed to eFront and you want to use a domain name of your choice (e.g., training.example.com), heres how to do it.

Your eFront installation comes with a name under the efrontlearning.com domain, provided to you upon initializing your subscription. In our example, we will use the nameexample.efrontlearning.com.

To use a domain name of your choice (e.g., training.example.com) with your current eFront installation:

Visit your DNS provider's website

Go to the DNS settings

In your DNS settings, add the following CNAME record: CNAMEtraining.example.com -> example.efrontlearning.com

To create Branch URLs (e.g., branch1.training.example.com, branch2.training.example.com, etc.), also add the following record: CNAME*.training.example.com ->example.efrontlearning.com

NOTE:in case you want to use your own domain for your eFront portal, and if it is hosted by our servers, we offer a free of charge SSL certificate (so that your portal will securely operate under HTTPS). To request it, or toreceive further guidelines on the SSL certificates, please contact directlyour support team.

Enabling the mailing service

To enable the mailing service for your eFront installation, you have to create the following TXT record in your DNS settings.

Visit your DNS provider's website

Go to the DNS settings

Create a new TXT record (our support team will provide you with the actual values you need to enter)

Hostname:Enter the host name for the TXT record. For example, type@to map the record directly to your domain name, or enter the subdomain of your host namesuch aswwwormail.

TXT Value- Enter the value you want to assign to the record.

For example:

(these are just example values, use the values provided to you by our support team)

Hostname:example.domain.com

Value:v=DKIM1; k=rsa; h=sha256; p=WUXy9MuMkv7vvvzS[...]

Configuring DNS to use with Branch URLs

To have your Branch URLs follow a format like 'branch.training.example.com', you need to refer to 'step 4' in the previous section and add the CNAME record: *.training.example.com. Then, you have to explicitly define the 'Domain name for branch' in the respective field.

Let's say we want to create a Branch at 'operations.training.example.com':

In your eFront portal, go to 'Home -> 'Branches' -> 'Add Branch'

Fill in a name for your Branch

Fill in the Branchs complete URL, in our case: operations.training.example.com

link

A domain other than '*.training.example.com' as Branch URL (e.g. foo.com)

To create a ranch at a new domain, different than your eFront domain:

In your eFront portal, go to 'Home' -> 'Branches' -> 'Add Branch'

Fill in a name for your Branch

Fill in the Branchs domain name, in our case: foo.com

Go to the domains (foo.com) DNS settings

Add a CNAME record pointing to your eFront installations default domain name: CNAMEfoo.com -> example.efrontlearning.com

To use this as a parent Branch for other Branch URLs (e.g., branch1.foo.com, branch2.foo.com, etc.), also add the following record: CNAME *.foo.com -> example.efrontlearning.com

Note: As you did for the main domain, you have to explicitly define the subdomain name in the 'Domain name for branch' field for each sub-Branch.

For more general information on Branches, instead, follow this.

Bug Fixes:

Fixed 'Status in course' report filter

Fixed PHP7 specific code in v. 5.2.14

New features:

Added Concurrent Users report section

Added Thai language support

Improvements:

You can now drag and drop images in TinyMCE editor

The data-table in Access Requests now filters by status as well

The "TrainingNotCompleted" notification no longer lists incomplete curricula

Changed Groups & Skills description type to the editor type

Removed a misleading exception message when clicking on search results that are not accessible

Updated Lithuanian language

Restored the proper date-time formatting of extended time-date fields in custom reports

Bug Fixes:

Fixed the total number of notifications in the Queue table for branches

Fixed an issue with training events when the course was imported and the training event didn't have a date

Fixed issue with Course description when there was only 1 active language

Fixed an issue about alerts not being visible upon self-registering

Fixed issues with TLMS Plugin concerning special characters

Fixed discrepancies in Users table when a filter is used

Fixed the total number of courses in Users' course table when a filter is used

Fixed an issue with buttons 'Download' and 'Print' being visible in PDF when the window was minimized

Fixed an issue with ambiguous columns in SQL query

Fixed an issue with LDAP users syncing their info when no name, surname was sent from the LDAP server

Fixed a content accessibility issue related to cloned assignments

Fixed a Mysqldump issue in Windows when the name of the folder in document root had an empty space

Fixed ordering of extended fields in reports

Fixed issue in FullTextSearch batch execute and enabled automatic indexAllUnits

Fixed issue about importing course with some shared files

Fixed calculation of max upload size allowed

Fixed branch administrators having visibility over submitted tests of people in higher branches

Fixed problem with the "incomplete training notification" causing it to not being sent out when updated

Fixed rare "duplicate entry" error momentarily appearing when trying to repeat a failed test

Fixed online users not being disconnected when a custom report takes too long to be produced

Fixed a specific tooltip glitch in a couple of edge cases

Fixed the archive permissions. They are now limited to the archive page only

All data that is already created and present in your TalentLMS portal can now be quickly imported into eFront, thanks to the TalentLMS Data Import plugin.

To transfer data from TalentLMS to eFront:

1. Plugin activation

First, you have to enable the TalentLMS Data Import plugin.

The plugin is preinstalled. To activate it:

Sign in to your eFront portal as Administrator and click on the plugin icon.

Click the Toggle related to the TalentLMS Data Import plugin until it becomes green (1).

here

If you can't find it, use the search box on the bottom left of the screen and type TalentLMS.

2. Export from TalentLMS

Log in to your TalentLMS account as an Administrator.

Go to Import-Export (2).

Go to the Export tab (3).

From the drop-down list, choose CSV (4).

Click Export (5). You will now be presented with all your TalentLMS data in CSV format.

Select and copy all the data to the Export Result text box (6).

3. Import to eFront

Back on your eFront portal, logged in an Administrator, youll see a new icon in the Home page.

Click on it and youll be presented with a CSV text box (7).

Paste there the data you copied from TalentLMS.

Select whether you want to Merge or Replace duplicates (they are ignored by default). You can find out more about these options .

Click Save (8) to confirm the import.

Wait for the data import to complete. You should be seeing the following screen:

Once the process is complete, you will notice that your eFront platform has been populated with your TalentLMS data, e.g., see the newly imported users below:

Note: Not all data entities can be migrated from TalentLMS to eFront. Here is a list of all the data entities that can be migrated from TalentLMS to eFront:

Users

Courses

Users in Courses

Groups

Users in Groups

Courses in Groups

Categories

Branches

Users in Branches

Courses in Branches

Custom User Fields

Custom Course Fields

Sometimes users might be interested in attending an instructor-ledtraining event, but none of the available sessions suit their timetable. In that case, they might want to request for an extra session, scheduled on a more convenient time or in a different location.

To enable users to ask for new sessions to be added to a training event as a course owner, go to the blended course's "Advanced settings" and check the "Show request session button"(1) option.

Now users, visiting the blended course in their Catalog, can click on"Select Sessions"(3)and then on the "Can't find a convenient session to attend? Click here request another!" link(2) to ask foranew session.

Then, they can add their preferences in the "Comments" field and click on "Submit" to confirm and send their request.

NOTE: This option is only available to users that havenot yet enrolled in the particular blended course, when they go to the course's page from the "Course catalog" and click on "Select Sessions"(3).

After the request is submitted, an alert (4)and an email notification (if the respective option is enabled) are sent to you, the course's owner (whether a course creator, administrator or instructor).

To see the user's submitted preferences for the requested session, simply click on the alert's title (5).

Then, click on the "View event's sessions"(6) button to be redirected to the training event's page. There, if attainable, you can add a new session according to thelearner's request.

There are two different ways to add images to a course unit.

By uploading the file in the related course:

Go to the course in which you want to add the image.

Click Add Content (1).

On the drop-down list that appears, click Go to files (2).

Click Add file or drag and drop to add the image.

Go back to the course dashboard.

If you want to create a new unit, click Add Content, and then click Add Unit on the drop-down list that appears.

If you want to edit an existing unit, click Edit.

In the unit content/text box, place your insertion bar (3) in the place where you want to add the image, and click on the folder icon (4).

You'll see a list with all the available, previously uploaded files. Select the file you want and click on Insert (5).

Click Save to update your changes.

With a drag-and-drop action:

Go to the course in which you want to add the image.

Go to the unit in which you want to add the image, and click Edit.

In the unit content/text box, place your insertion bar in the place where you want to add the image.

Drag the image from your computer files to the content/text box.

Click Save to update your changes.

Note: In both cases, you can adjust the size of the image just by left-clicking on the image borders.

2-factor authentication is the process where an additional piece of information is requested along with your username and password, and it is required in order to sign into your account.

eFront supports two methods of 2-factor authentication: Google Authenticator and SMS-based. These are not mutually exclusive. They can run side by side and, if both services are activated by the administrator, the end user will be able to select their preferred one.

Setting up 2-factor Authentication using Google Authenticator

To use Google Authenticator, download the app to your smartphone or tablet.

To set up Google Authenticator:

Sign in to your platform as an administrator.

Go to System settings -> Security (1).

Go to the 2-factor Authentication (2) tab and tick Enable 2-factor authentication (3).

From the Using a QR code service (4) drop-down, select Google Authenticator.

Click Save.

this Twilio's support article

Once enabled, users can visit their profile page to activate 2-factor authentication. To do this, they should:

Go to My account (5).

Go to the Profile (6) tab.

Click the Enable 2-factor authentication link next to the password field.

The screen that appears displays a QR code. The user should now open the Google Authenticator app on their mobile device, and use the account setup option to scan the QR code.

Once scanned, the app will display a 6-digit code that the user must put in the respective field (7) and click Activate.

Now, the next time the user tries to sign in, they will be presented with an additional field to input the 6-digit code displayed on their mobile device.

Setting up 2-factor Authentication using the Twilio SMS Service

Twilio is a subscription-based SMS service that allows for easy 2-factor authentication. In order to set it up, you should first set up a Twilio account.

Visit https://www.twilio.com/ and create a user account.

Click Phone numbers in your console and click Get your first Twilio phone number.

From the list of available numbers, select your preferred one and click buy to confirm.

Note: You have to buy a new number with the capability to send SMS messages. If the SMS capability is not available in a user's country, then you can choose any country offering a number with SMS instead. For information on this, please have a look at .

As soon as you're done, click on the Show API credentials link. This will pull down the API credentials for your number. Copy the 'ACCOUNT SID' and 'AUTH TOKEN' values.

Go back to eFront and sign in as an admin.

Go to System settings > Security.

Go to the 2-factor authentication tab.

Tick the Enable 2-factor authentication option.

On the Using an SMS (1) drop-down, select Twilio and fill in the required information (2).

In the Service SID input box, enter the value of the 'ACCOUNT SID' you copied from your Twilio page.

Similarly, use the value of 'AUTH TOKEN' in the Service Key input box.

Use the phone number you purchased, without any spaces or dashes (for example, +1234567890).

Click Save.

Once enabled, users can visit their profile page to activate 2-factor authentication. To do this, they should:

Go to My account (3).

Go to the Profile (4) tab.

Click the Enable 2-factor authentication link next to the password field.

Fill the phone number (including the country code) and click Send verification code.

Enter the verification number you received.

Now, the next time the user tries to sign in, they will be presented with an additional field to input the 6-digit code displayed on their mobile device.

To import a course in eFrontlog in as an administrator and from your Administration dashboard visit the Courses page. Here you have a tabular list of all your courses.

Click on the downward icon next to the 'Add course' button will open the Import Course (1) drop down option where you can use to upload and import an already exported course.

After clicking on the 'Import Course' option a pop up will appear asking you to upload the .zip file of the Course you want to import.

To export a course you can use the corresponding export option (2) from the Operations column. Click to export a course will output a .zip file (the Course ZIP archive) and you will be prompted to download it.

Note: whenexporting a Blended course, the export will not include training sessions created in the course. The exported course will include, Lessons, Events, Units, and contents but no sessions.

To add a new course, click on the Add Course (1) button in the Courses section.

Extend Profile section

Another way to add a new course is to import an already exported one. You can do this clicking the caret next to the add course button (2).

For more information about importing/exporting a course check out this article.

Note: whenimporting a Blended, already exported course, the import will not include training sessions. The exported course does not include training sessions, it includes Lessons, Events, Units, and contents but no sessions.

Once you click to add a new course you will be redirected to the add a new course page.

To add a new course fill in all the information and details for the new course, defining its properties one by one. Some properties are required, while others are not mandatory. The required fields are the Name (3) and the Category (4) of the course.

The default course type is set to eLearning (5), for a typical eLearning course based on asynchronous (i.e. at the students discretion) access to the course material. If you want to create an instructor-led classroom-based course, change this option to Blended Learning.

Theres also the option to add a short description of the course (6).

If youre OK with the settings, you can create the course by clicking the 'Submit' button. There are also several advanced options that you can see and set by clicking on the 'Show Advanced Settings'(7) link.

The advanced settings include: a course code (a short alphanumeric code for easy reference, e.g. 'CS101'), language (to inform the users of the course's language), a base price (for selling the course), a number of properties such as the status of the course (active or inactive), its visibility on the main catalog etc, availability (Available for which means how many days an enrolled user has access to the course).

Available from/untilwhich indicates from when until when this course is available to enrolled users), CEUs (how many continuing education units the course corresponds to), Depends on (if this course depends on any other courses in the system) and, finally, the certification awarded for completing the course.

Note:you can also have custom fields when you add a Course, which you can create in the.

When done, clickAdd.

To post an announcement which will be visible to all users in your system, log in as an administrator and you will see the corresponding menu shortcut, on the top of your screen, located on the right of the navbar(1). Click on the'Announcements' (2).

This will send you to the Announcements page, which contains a tabular list of all announcements that you have already posted in your system.

To add a new announcement click on the 'Add Announcement' button (3), which will open a pop-up window with details about your announcement.

Fill in the title (mandatory), select the Color(4) of the announcement and body fields. You can set the announcement to appear before, after, or before and after users sign in, by changing the Display (5) and then click add to create it. If you wish for this announcement to only be available for just a few branches and not system-wide, click to set the branch ownership of the announcement.

As soon as you post your announcement, it will be available for your users on their dashboard.

Improvements:

Categories are now searchable in the global search

Added option to display announcements before and/or after sign in

Added the "Assigned & Completed Courses" column in the System Reports

Added the ability to export Custom reports as CSV

Added the "Curriculum completion" Notification

Added the option to include user extended fields in notification templates

Added LDAP users' info synchronization

Added ability to change maximum cron jobs lock times

Raised the limit for maximum options in Match type questions from 20 to 40

Added the 'Course Code' and 'Course Type' as optional custom report columns

Bug Fixes:

Extended profile fields of type 'Checkbox' and 'List' now work properly

Fixed wrong options being displayed in course rules

Fixed revoke icon in Users -> Certificates operations

Fixed a bug that would return search results to branch admins without having permission to see it

Fixed an issue with password notifications not sent when two users have the same email and one is archived

Fixed an issue with HTML5 videos not playing on iOS devices

Fixed an issue with foxy data feed using Foxy Cart payment gateway

Fixed an issue when deleting an event in a Blended course would cause all units in that course to be deleted

Fixed a data discrepancy issue in graphs

Fixed the natural language text when selecting custom rules using the 'have status in course' rule

Fixed a user-types' permission issue assigning jobs in Users -> Job tab

Fixed the total number of questions in Tests when a question was deleted

Empty values will now clear and overwrite any previous values in extended fields on edit

Fixed an issue where using HTTP POST/PUT to create/update user extended data was failing

Fixed total number of questions in Tests when a question was deleted

Empty values will now clear and overwrite any previous values in extended fields

Fixed the session request link

Fixed alignment in grade element in Certificates

Fixed displaying correct answers in matrix-type questions

Fixed available 'Archive' option in Reports -> Mass Actions when Admin didn't have Course/User 'Edit' permission

Fixed course code in the multilingual context

Fixed an issue with cover images in Edge and IE

Fixed an issue when cloning a unit by pressing the 'Clone and clone another' button

Fixed CourseUserStatus API endpoint status validation

Fixed an issue with custom reports when status and specific courses were selected

Fixed error appearing when submitting security branch settings page as a supervisor

Fixed translation issue in 'showing questions' section in tests/surveys

Fixed issue about filtering in skills list page as a supervisor

Fixed an issue in reports when used with the period filter

Fixed Cloned, linked units can be disabled by "Toggle status" without affecting the original unit (#5406)ar_AE language updates

Fixed an issue where notifications from sub-branches were sent using global SMTP settings.

Fixed an issue with broken images when using custom content blocks in the login screen (MS IE & Edge).

Fixed problem with multiple "training not completed" notifications, as defined per branch

Fixed very rare inconsistency when showing status in a content tree for tests with multiple attemptsSecurity updates

Fixed problem when viewing matching questions and the test's settings are "one by one" and "immediate feedback"

Fixed issue about running custom reports created by inactive users

Fixed duplicate emails being sent out when the Email server takes too long to process queue

Fixed issue about recalculating audiences due to an AutoSync Task

This guide will walk you step by step through the process of integrating FoxyCart with eFront.

Starting with the integration, log in as administrator to your eFront system, and navigate to 'System Settings' -> 'e-Commerce' -> 'Gateway'(1).

Once you are there, select the option Foxy (2).

https://admin.foxycart.com

You will see a few options over there, such as Company Name or Contact name (3). Leave them be, for the time being. Next, click the link 'To use Foxy payment gateway, you must first signup for a foxycart account.'(4). If you do not have already an account, create one now, it is really simple.

Clicking on that link will take you to the FoxyCart website then go to their signup page to create a new account.

Once you have created and verified your account with FoxyCart, you 'll need to obtain your API key (5). You will find this here, under the Store submenu on the item Advanced.

Do not forget to check out the values of other fields in your FoxyCart account, from your profile.

Once you have found your FoxyCart API key, go back to eFront and paste this into the settings of the FoxyCart Payment Gateway.

Fill in the rest of the information required with the appropriate values and click Save. Then the option of the FoxyCart gateway will change and a new link will appear, which is called Authorize (6).

Click that link to authorize eFront to communicate with FoxyCart. It will prompt you to log in again and then it will take you to a screen where you can actually perform the authorization.

Once you have authorized eFront to connect with FoxyCart, you will be redirected back to the eFront System Settings. You are almost done!

You need to set up a few settings in your FoxyCart configurations. Those are:

Store Settings

Store URL: Fill in your store URL with the following <efront_base_url>/catalog/cart/1

Receipt Continue URL: Fill in your receipt continue URL with the following <efront_base_url>

Do not forget to fill with the preferred values all the information regarding Shipping Location, Locale, Timezone & Settings.

Because of the payment changes (PSD2 & SCA) you will need to select Foxy cart store version: 2.0.

Advanced Settings

Would you like to enable your store data feed: Find this option and check it.

Datafeed URL: Fill in your datafeed url with the following <efront_base_url>/catalog/cart/foxy-data-feed

Payment

Setup any payment provider that you want to be available on checkout/cart page.

All the above options are located on top of the screen. We have now covered the most important settings in order to set up successfully the Foxy payment gateway. Look around to discover more available options in order to unveil the multiple options that FoxyCart provides.

In the TEMPLATES section, you can write your own checkout/cart template (limited only by your imagination as stated by Foxy team), but this requires some programming knowledge (JS, CSS, and twig templating engine).

Note (Tech): Foxy uses webhooks. A customer may successfully complete a payment but they will not have access to the course(s) that have been purchased until the Foxy webhook inform eFront regarding that particular transaction.

eFronts hosting provider is Amazon, one of the leading companies in hosting services worldwide.

Among many others, the hosting provider offers the following audit reports and certifications:

SSAE16 SOC 1 audit and certification: Yes SSAE16 SOC 2 audit and certification: Yes ISO 27001 certification: YesISO 27002 Security Best Practices: Applied, as explained in https://aws.amazon.com/compliance/data-center/data-centers/ and https://aws.amazon.com/compliance/.

All certificates and reports are available upon request.

In this short guide, we will describe the process of setting up eFront on a Windows 2012 R2 server, using IIS 8.5. For the sake of the guide, we will start off with a brand new Windows 2012 R2 Datacenter installation on the Azure Cloud.

Note! If you will be using Internet Explorer, then the first thing to do is to turn off IEs Enhanced Security Configuration, from the server manager local server.

GitHub Releases page

Launch the Server Manager and click on Add Roles and Features to start the wizard.

Click on next, accepting defaults, until you reach the Select server roles page.

Select Web server (IIS) from the list of check-boxes. A popup will prompt you to add additional features. Click on Add Features and then Next.

Click on Next accepting defaults for the rest of the pages, until you reach the Confirm installation selections page. Click on Install and wait for the installation to complete, then click Close.

From the Tools section of the server manager, launch the IIS Manager.

Click on the small arrow next to the server name to expand it. You will be prompted to get started with Microsoft Web Platform (WebPl). Click Yes and a new web page will launch.Alternatively, you can launch this at any time by clicking on the Get new Web Platform Components link at the right.

Click on Free download and accept to Run the file.

The platform installer will launch and present a list of items. Search for PHP (in the search bar on the top-right corner) and select PHP 5.6.24 (or the latest version) and Windows Cache Extension 1.3 for PHP 5.6. Click on "Install" and I Accept on the terms popup that will appear.

After the installation is complete, a results page will appear. Disregard the PHP Manager was not installed message - wewon'tbe needing it. Click on Finish and Exit the WebPI.

For PHP 5.6, Download and install the x86 version of Visual C++ Redistributable for Visual Studio 2012 Update 4, from https://www.microsoft.com/en-us/download/details.aspx?id=30679. Click on Next button, ignore potential warning about the file and accept to run it.

Close the IIS Manager and open it again. This is important so that newly installed options may appear (such as the URL Rewrite).

Expand the server name in the left pane and right click on the Default web site. Select Remove.

Download and extract eFront inside the folder c:\inetpub\efront. We need to give proper write permissions, so right click on the eFront folder and click on Properties and then on the Security tab.

Click on Edit then Add and type IUSR in the field Enter the object names to select. Click on Check names to verify that this user actually exists. Then click on OK.

Click on the Modify option in the Allow column and click on Apply. The system will apply the selected permissions across all eFront files and folders.Warning: These are generic permissions that are suitable for a development/staging environment. For production environments, write access should be granted only on the folders described in the installation guide.

On the IIS manager, right click on the Sites entry and select Add Website.

On the websites properties, enter efront for the name and C:\inetpub\efront\www as the physical path and click on "OK".

Back to the IIS properties, select the eFront site and double click on URL Rewrite.

On the right pane, there is an option to Import rules. Click on it to bring up the Import mod_rewrite rules option.

Under the Configuration file, click on the dots to navigate to the file: C:\inetpub\efront\www\.htaccess and then click on Import. The Rewrite rules and Converted Rules areas will be filled.

On the Converted rules area, scroll to the bottom. Youll notice that one rule generates an error - its because its not compatible with IIS, so we can safely remove it from the Rewrite rules page.Remove also subdomains part because it may cause installation issues.# Subdomain-specific rules:RewriteCond %{REQUEST_FILENAME} !-fRewriteCond %{REQUEST_FILENAME} !-dRewriteCond %{HTTP_HOST} ^(?!www\.)([^.]+)\. [NC]RewriteRule !^subdomains/ subdomains/%1/www%{REQUEST_URI} [QSA,L]To continue, please make sure that under 'Rewrite rules:' window you have the following: RewriteEngine On# Normal setup:RewriteCond %{REQUEST_URI} !=/server-statusRewriteCond %{REQUEST_FILENAME} !-fRewriteRule ^ index.php [QSA,L]Note: If you want to enable the rest API feature you must also import the .htaccess file that is located in the /www/API directory. From the IIS Manager you must specifically select the API folder on the left and then add the rewrite rules.We remove the following lines from the .htaccess for it to work properly.

RewriteRule ^ Index.php [QSA,L]# HTTP Basic Auth (f-cgi workaround):RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization},L]The final .htaccess should look like this:

RewriteEngine On

# API:RewriteCond %{REQUEST_URI} !(v[1-9]mobile)RewriteCond %{REQUEST_FILENAME} !-f

RewriteCond %{REQUEST_URI} (v[1-9]mobile)RewriteRule ^ ../index.php [QSA,L]

As soon as the Rewrite rules are correct, you will notice that the Apply option, on the top-right, is enabled. Click on it to apply the rules and proceed.

Next, we need to install the database server. You can do so from the MySQL website here: https://dev.mysql.com/downloads/windows/installer/5.7.html and download the Mysql 5.7 installer package (the small one should do).

Click on no thanks, just take me to the download page if youdon'twant to signup or login, and click on run for the downloaded package.

Once the installer runs, accept the license agreement and perform a Custom installation.

Expand the Mysql Servers option until you reach the MysqlServer X64 option, and add it to the features to be installed list.

Execute the installation and wait for it to finish.

Once its completed, click next to reach the configuration options. Select Server Machine for the Config Type.

Enter a root password.

Accept defaults in the following pages and click on Execute.

Installation is now completed, click on Finish to close the installer. You can verify that everything is setup properly by locating the Mysql Command line tool program available in the Installed programs.

This will launch the command-line interface for MySQL, which you can access by using your root password.

Note: if you download and install MySQL 8, it by default uses `auth_soket` as an authentication system and not `password`. In this case, you will need to change the authentication as follows:

1. Open Command Prompt (CMD) and access MySQL root `mysql -u root -pabc123`

2. Run query: ` ALTER USER 'root'@'localhost' IDENTIFIED WITH mysl_native_password BY 'password';`, where 'password' is the password set in step 29.

Open your browser and visit http://localhost. You should see eFront installation starting page.

Click on Next and fill in the required information.

Installation is successful! You are now signed in as administrator. You should fill in your license key.

You can now start using the system. Click on the Maintenance section and then on Information to verify that all required and recommended components are in place (such as caching).

In order IIS to work as expected with non English characters(umlaut etc) you have to run the following from command line (and restart IIS afterward): reg add HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\w3svc\Parameters /v FastCGIUtf8ServerVariables /t REG_MULTI_SZ /d REQUEST_URI\0PATH_INFO

Installing WinCache on IIS

To drastically improve the performance of any high-traffic PHP website running under IIS you can consider installing one of the free caching PHP extension tools available: in this post well cover the Microsoft one, namely WinCache, which is included in all the base PHP installation packages for Windows since version5.2.

InstallingWinCacheis fairly easy. The first thing you need to do is tocheck whetherthe php_wincache.dll file is included in your PHP installation or not. This file islocated in the /ext/subfolder of your PHP installationfolder. If its not there, you can download it manually from the WinCache official website (just be sure to pick the file matching your PHP version), unpack it and copy the .dll fileto the aforementioned folder.

Then you need to enable the WinCache extension to your PHP installation by adding the following two lines to yourphp.ini file, which is usually located in your PHP installation folderOR in the Windows root folder:

reg[PHP_WINCACHE] extension=php_wincache.dll

Note:Before you do that you might want to check if the extension is already enabled by doing a quick text search for php_wincache.dll inside the file.

If youre using PHP Manager for IIS (which you really should) you could also install the WinCache extension directly from the PHP Manager GUI.

If youre NOT using PHP Manager for IIS and/or you have no idea of where yourphp.inifile actually is, you can easily track it by executing thephpinfo() command on your server(if youdon'tknow how, just click here to download a sample script, put it on your server and execute it): as soon asyou did that you can reviewyour whole PHP configuration, which contains the full path of the currentlyLoaded Configuration File:

That samephpinfo()command can be also used to check whethertheWinCacheextension has been properly installed or not. If thats the case you will be able to see something like that by scrolling down a little:

In most cases, like the screenshot above, the system will tell you that all the caches are currently disabled: this is perfectly normal, since we didnt activate any of them yet.

In order to do so, we need to add some additional configuration settings to ourphp.inifile:

[WinCache] ; Full reference: http://php.net/manual/en/wincache.configuration.php wincache.fcenabled = 1 wincache.ocenabled = 1 wincache.ucenabled = 0 wincache.fcachesize = 64 wincache.fcndetect = 1 wincache.maxfilesize = 256 wincache.chkinterval = 10 wincache.enablecli = 1 wincache.ucachesize = 8 wincache.scachesize = 8

These settings are generally OK for most production environments. You can fine-tune them by taking a look to the WinCache reference guide, where you will find a detailed description of any possible configuration setting to adapt WinCache to your needs.

When you think youre done, save the php.ini file and restart IIS: youll be able to check the results of your hard workby executing thephpinfo()command again:

After completing setting up WinCache, you may access the WinCache panel from your eFront system, when logged in as administrator, visit Maintenance > Information > Cache.

Edit web.config file for increasing limits

In case you face any issues that seems to be related with time or request limits although corresponding options for php are already set, you may have to set them for IIS too. Follow steps below:

1) Open <wwwrootDir>/<Web Service>/web.config

2) Add line for maxRequestLength and executionTimeout

<configuration>

<system.web>

<httpRuntime maxRequestLength="524288" executionTimeout="600" />

</system.web>

</configuration>

For IIS7 and above, you also need to add the lines below:

<system.webServer>

<security>

<requestFiltering>

<requestLimits maxAllowedContentLength="524288000" />

</requestFiltering>

</security>

</system.webServer>

3) Restart IIS

Note:Regular API and mobile API might have issues working with the default configurations. You might need to re-arrange the orders of change the IIS rules. The attached web.config has the appropriate rules and rules order.

Installing an SSL certificate on IIS from Let's encrypt

Let's encrypt is a service that offers free SSL certificates. Below we describe the process of installing a certificate from Let's encrypt using a command line utility.

This utility tool runs from the command line and has a few very easy to understand options. Basically you pick a site from the list of active Web sites using host headers on your server and the utility goes out and creates a certificate for you, creates an https binding and attaches the certificate. If there's already a certificate there the certificate is replaced with the new one.

You can install the latest version from theirand simply unzip the zip file into a folder.

To run it, simply run the executable letsencrypt.exe.

Once you run letsencrypt.exe you will be presented with the following screen:

Press 'N' to create or update your SSL certificate

In the next screen, in the prompt "Which kind of certificate would you like to create?", input the number '4' (Manually input host names).

Once you have selected the above, enter your app host name (localhost, actual-domain.com etc) (do not prepend the hostname/s with http or https).

If everything is correct, the LetsEncrypt script will detect your app/site installation referred by the hostnames you entered .

Enter the number of the site/app you wish to generate the SSL certificate for.

The SSL certificate has now been installed.

To verify the certificate has been installed, open your IIS manager and head over to "Server Certificates".

You should see your certificate listed:

Azure Active Directory (Azure AD) is a cloud-based user authentication service, used by Office 365, to manage identities and authentication. eFront lets you integrate your portal with Azure Active Directory to synchronize passwords and set up Single Sign-On (using its SAML configuration).

To do this:

Step 1:Enable SAML support in your portal.

1. Sign in to your eFront account as the mainAdministrator.

2. SelectHome>System settings >Single Sign On >SAML.

3. Check option Enable SAML support(1).

Step 2: create eFront application in Azure AD.

1. Open the Microsoft Azure portal (https://portal.azure.com/) and select Azure Active Directory (1).

2. In theManage listselectEnterprise applications (2).On the panel that appears, clickNew application (3).

3. Select Non-gallery application (1),set a name (2), clickAdd (3)and wait for it to be created.

Step 3: Allow users to access eFront application.

1. You can find the eFront application in Azure Active Directory >Enterprise applications > eFront.

2. In the Manage list, select Users and groups (1).On the panel that appears, clickAdd user (2).

3. Add the users/groups you want from the list, or by searching for them and by clicking Select.

4. When all the users/groups have been selected click Assign.

Step 4: Add the Azure AD Single sign-on configuration date to eFront SAML settings.

1. Open the eFront application,you can find it in Azure Active Directory >Enterprise applications > eFront.

2. In the Manage list, select Single sign-on (1). On the panel that appears, click SAML (2).

3.Azure AD SAML configuration has 5 different sections, which you will need to edit.

Proceed with editing the first section.

Click on the editing icon (Basic SAML Configuration, top-right corner). You will need to add the respective URL from eFront SAML settings to Azure AD. To do that, access your eFront portal as System Administrator and go to Home > System settings > Single Sign-On > SAML. Enter the URLs in Azure AD - Basic SAML Configuration:

Identifier

your eFront URL address

Reply URL

Assertion Consumer Service URL

Logout URL

Single Logout Service URL

Note: In the following image you will see matching numbers. You will need to transfer the URL from eFront SAML settings (right) to Azure AD settings (left). Use the numbers to match the respective information.

Note:azure-saml.dev.efrontlearning.com (1) is used in this guide as an example, in your case it should be your own eFront URL.

4. When you are done select Saveand proceed with editing the second section in Azure,User Attributes and Claims.This section is about the information Azure will send to eFront, so you will be doing the reverse process.

The URLs on the left called claimswill need to be copied to eFront's relevant SAML fields. Copy and paste the Azure value to the corresponding eFront SAML field. Here is a table for your convenience.

Azure Value

eFront SAML field

user.mail

TargetedID, Email

user.givenname

First name

user.surname

Last name

Note: In the following image you will see matching numbers. You will need to transfer the URL from Azure AD settings (left) to eFront SAML settings (right). Use the numbers to match the respective information.

Note: Theclaimsvalue can be customized to containanyvalue. We are using the Azure user's email for both Email and TargetedID, which means that on eFront the user's email will also be his/her username. We recommend this option to reduce compatibility issues.

5. Copy the Thumbprint (1) and paste it into the Certificate Fingerprint on eFront SAML settings.

6. You will need to enter the provided URLs in the fourth section into eFront SAML as follows.

Azure

eFront

Login URL

Remote Sign-in URL

Azure AD Identifier

Identity Provider

Logout URL

Remote Sign-out URL

Note: In the following image you will see matching numbers. You will need to transfer the URL from Azure AD settings (left) to eFront SAML settings (right). Use the numbers to match the respective information.

7. After entering the above data in their respective entry field, click on SAVEin eFront portal.

You are now ready to use Azure AD with SAML on eFront.

When you add/edit a course in your portal and move to the /Advanced settings'(1)you can see two options:

Show on catalog (2) and

Show on main catalog (3)

These two options are meaningful when you have assigned your course to a branch so you can then decide if you want it to be visible only to the branch course catalog or both to the branch and the main catalog.

Note: If your course is not assigned to any branch, then each of these options will make the course visible to the main course catalog.

If you select the first option (Show on catalog) then the course will be visible only to the users that are members of the specific branch.

If you select the second option as well, the course will be visible to the users that don't belong to any branch.

In essence, the main catalog refers to the catalog that is visible to the users that are not members of any branch, while the catalog refers to the branch course catalog, in case that the course is assigned to a branch.

Note: When a course is assigned to a first level branch and has also the option 'Show on catalog' selected (in the course advanced properties) the course is then available to all sub-branches below this branch and shown as available in all learners catalogues in the branch-tree.

New features:

Adding date/time fields in extended profile fields

New plugin hook: onFilePermissionCheck, allows for overriding filesystem permissions

Improvements:

Courses will now lazy-load on the unit cloning screen

Changed behaviour: VirtualKeyboard & Captcha cannot be activated at the same time

Bug Fixes:

Restored: courses listed under a user's dashboard page

Fixed block 'course catalogue' not showing branch courses in custom pages

Fixed display of names and surnames with apostrophes

Fixed permission access problems when administrators try to edit other administrators

Fixed issue when importing LDAP users via CSV

Fixed error when searching for courses under course reports

Fixed issue with translations in English, in the plural form

Fixed custom reports UserCourseStatus rules

Fixed course counters in branch administrator dashboard discrepancy

Fixed: VirtualKeyboard & Captcha cannot be both activated

Fixed: courses list appearing in user's page for administrators

Fixed: when the last question in a test with "immediate feedback", questions shown one-by-one, and the last question type 'matrix', the answer is not registered

New features:

New plugin created to override system-default REST calls or implement new ones following the same call pattern

Enhancements:

Custom reports' output may now include course custom profile fields, course public id, and user public id

Fixes:

Fixed display of Location 'extended field' to correct users

Fixed right padding for 'Empty Spaces' select questions in Test

Fixed administrator dashboard stats not reflecting branch values

Fixed translation issue for training session labels 'Started' and 'Ended'

Passwords tab in System settings -> Security should not be displayed in Branch settings since it is not implemented per branch

Fixed error for instructors on Blended Learning Courses and sessions that they were not assigned

Fixed issue about filtering (in)active users in Test reports

Fixed issue about displaying submissions from all course tests instead of the current test in specific pages

Fixed Scheduled reports not being sent due to a db_session issue

Fixed missing completion timestamp from user reports

Performance updates for branch administrators' reports

Fixed issue about not showing knowledge parity assessments in the course dashboard when course contains only one lesson

Fixed users' custom profile fields not showing up in exported user reports

Fixed editor translation issue on discussion messages and unit comments

Fixed password change flag when importing users

Fixed scheduled custom reports issue (deleted extended field as report rule)

Since all Google Analytics codes contain <script> and </script> tags, you can add them to your portal in the Embed Code section of each Theme.

As with all Theme's customizations, add it to the Theme in use in the branch where you want to have the Google Analytics service active. Follow these steps:

1.Sign in to your eFront account as Administrator and go to Home > Themes.

2.Go to the Change theme tab and click the theme you want to edit.

3. In the Embed Codesection, paste your Google Analytics code (1).

4. ClickUpdateto save your changes.

have a Theme active and customized for a branch

Check these articles to see how to create a new theme and how to .

The Training not completed notification helps you inform users thatthey'reenrolled in a course but they havent yet completed it.

You can activate, deactivate, or edit the content of this notification as an Administrator.

To make sure that the notification is active on your portal and branch, go to Notifications (1) and find the Training not completed (2) notification among the listed. Make sure the switch is on (3) and green.

this article

Note: See also in case you are logged in as a branch administrator.

This specific reminder is not triggered by an event. It is sent out periodically.

As a general rule, it is sent every 7 days that have passed after one or more courses have not been completed. All courses that are not yet completed are listed in the weekly reminder.

Note: This notification is not sent if a user has already received another Training not completed notification in the past 7 days. This means that learners will never receive a Training not completed notification more than once a week.

New features:

Added the logging of the events when a user enters wrong username/password or an account gets locked

Added the "Training not completed" notification

Added line numbers on 'Code View' of default editor ('summernote')

Enhancements:

Improved performance in graphs (dashboard, user profile, system reports)

Improvements across the user reports page

Fixes:

Fixed issue about course progress settings when the unit completion method is 'automatic'

Fixed math equations not shown correctly in some sections and previews

Fixed creating a custom report when no user email is set

Fixed the display size of empty spaces question

Fixed truncated tests & surveys names

Fixed user import without email address when an email address is required in System Settings

Fixed the "Training Not Completed" notification not respecting branch URLs

Fixed issue about ignoring branch context in audiences

Fixed issue about showing the correct answer in test analysis for Multiple choices - Single-answer questions

Fixed error when searching for training sessions

Fixed LDAP settings disregarding global context for existing branch users when trying to sign in

Fixed issue about assigning a skill to question while adding the question to skill gap test

Fixed filtering of questions shown in the skill gap test for supervisors

Single sign-on is an authentication process that allows for the same pair of credentials (i.e., username - password) to be used across multiple systems. Single Sign-on can also be used for allowing users to sign in to a network of "connected" systems through a single log-in.

eFront provides many options for implementing both scenarios:

By using SAML 2.0

By using LDAP (or Active Directory)

By using the REST API

By using a cookie

By using a plugin

Note: In case you are setting up SAML only for a specific branch, then this branch needs to have its own branch URL (see also this article ). If instead, you want branches to inherit the main branch SAML settings, this happens by default. In this last case, and if the branches have their own sub-domain, then make sure each branch URL is included in the URLs allowed by your SAML provider.

A. SAML 2.0

eFront supports Single Sign-On (SSO), a process that allows users to authenticate themselves against an external Identity Provider (IdP) rather than obtaining and using a separate username and password handled by eFront.

To let you provide single-sign-on (SSO) services for your domain, eFront works as a Service Provider (SP) through the SAML (Secure Assertion Markup Language) standard.

What you need is a SAML Identity Provider (IdP) to handle the sign-in process and provide your users' authentication credentials to eFront. When eFront users authenticate themselves through your SAML IdP, their account details are handled by the IdP. Any changes made to those details (i.e., first name, last name, email) are synced back to eFront.

To set up SAML SSO on your eFront domain, go to theSAML tab on theSystem Settings >Integrations >SingleSign On page and fill in the following values:

Identity provider (IdP): Your Identity Provider's (IdP) URL.

Certificate fingerprint: The SHA-1 SAML certificate fingerprint provided by your IdP.

Remote sign-in URL: The remote sign-in URL of your IdP where eFront redirects users to sign in.

Remote sign-out URL: The remote sign-out URL of your IdP where eFront redirects users to sign out.

TargetedID: The variable that holds the user's username (log-in).

First name: The variable that holds the user's first name.

Last name: The variable that holds the user's last name.

Email: The variable that holds the user's email.

If you want to sync any additional info from SAML to eFront (e.g., department, hire date), you can use the Custom fieldsoption in the eFront SAML setup page:

First, go toHome >Extend profileand create new columns for Users (for a step-by-step guide, see this article ).

For each new column, type the corresponding SAML variable in theNamefield.

Finally, go to the SAML settings page, and type the column names as a comma-separated list in theCustom fields field.

The image below illustrates an example of a SAML setup where simplesaml is used as an IdP server.

here

B. SAML 2.0 with ADFS 3.0 (Windows server 2012 R2) as IdP

To have a Microsoft Active Directory Federation Services 3.0 (ADFS 3.0) service act as the Identity Provider (IdP), follow these simple steps:

Note: Forusing earlier versions of ADFS (i.e., 2.0 or 2.1), the process is nearly identical.

In the following example, we assume that our ADFS IdP uses the domain name adfs2.efrontlearning.com and our eFront installation uses the domain name saml.pro.efrontlearning.com.

Step 1: Configure ADFS 3.0

Click to Start the Server Manager. From the tools option, chooseAD FS Management to launch the AD FS management console.

Right-click Serviceand, from the context menu, click Edit Federation Service Properties

The General tab contains the Federation Service Identifierwhich is necessary for the SSO setup. In our example, it's http://adfs2.efrontlearning.com/adfs/services/trust.

eFront requires a PEM format certificate, so you have to convert your certificate from DER to PEM format.To do that, you can use any available tool or an online application like sslshopper.

Note: eFront works with RSA certificates. DSA certificates are not supported.

Step 2: ADFS 3.0 Relying Party Trust Configuration

Now you have to define the eFront endpoints in your ADFS, either manually or by importing the metadata XML provided by eFront. We recommend using the XML file because it's easier.

To get the metadata XML file, sign in to eFront and go to theSAML tab on theHome >System settings >Single Sign On page. In the SP Metadata XML section, there's a URL that looks like this:http://saml.pro.efrontlearning.com/saml/module.php/saml/sp/metadata.php/efront-sp.Copy the URLand paste it into your browser to download the "eFront-sp" file that contains the following XML code:

<?xml version="1.0"?>

<md:EntityDescriptor xmlns:md="urn:oasis:names:tc:SAML:2.0:metadata" entityID="saml.pro.efrontlearning.com">

<md:SPSSODescriptor protocolSupportEnumeration="urn:oasis:names:tc:SAML:1.1:protocol urn:oasis:names:tc:SAML:2.0:protocol">

<md:SingleLogoutService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect" Location="http://saml.pro.efrontlearning.com/saml/module.php/saml/sp/saml2-logout.php/efront-sp"/>

<md:SingleLogoutService Binding="urn:oasis:names:tc:SAML:2.0:bindings:SOAP" Location="http://saml.pro.efrontlearning.com/saml/module.php/saml/sp/saml2-logout.php/efront-sp"/>

<md:AssertionConsumerService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST" Location="http://saml.pro.efrontlearning.com/saml/module.php/saml/sp/saml2-acs.php/efront-sp" index="0"/>

<md:AssertionConsumerService Binding="urn:oasis:names:tc:SAML:1.0:profiles:browser-post" Location="http://saml.pro.efrontlearning.com/saml/module.php/saml/sp/saml1-acs.php/efront-sp" index="1"/>

<md:AssertionConsumerService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Artifact" Location="http://saml.pro.efrontlearning.com/saml/module.php/saml/sp/saml2-acs.php/efront-sp" index="2"/>

<md:AssertionConsumerService Binding="urn:oasis:names:tc:SAML:1.0:profiles:artifact-01" Location="http://saml.pro.efrontlearning.com/saml/module.php/saml/sp/saml1-acs.php/efront-sp/artifact" index="3"/>

</md:SPSSODescriptor>

<md:ContactPerson contactType="technical">

<md:GivenName>Periklis</md:GivenName>

<md:SurName>Venakis</md:SurName>

<md:EmailAddress>[email protected]</md:EmailAddress>

</md:ContactPerson>

</md:EntityDescriptor>

Then, return to the AD FS management console, right-click Trust Relationships> Relying Party Trusts and, from the context menu, choose Add Relying Party Trust

C. SAML 2.0 with OneLogin as IdP

OneLogin is a service that provides single sign-on and identity management applications. You can use OneLogin as the IdP server in your SAML 2.0 setup.

Sign in to your OneLogin account and go to Apps > Find Applications. In the search field, typeSAML Test Connector (IdP w/attr) and press Enter. From the search results, select SAML Test Connector (IdP w/attr) and click Add.

Go to the SSO tab to get the necessary values for your integration with eFront, as illustrated in the following screenshot. To get theCertificate fingerprint, clickView Details, right below theX.509 Certificate field.

Go to theConfiguration tab and, assuming that your valid eFront URL is"pro.localhost", fill in the following values:

Audience:pro.localhost

Recipient: https://pro.localhost/saml/module.php/saml/sp/saml2-acs.php/efront-sp

ACS (Consumer) URL Validator:^https:\/\/pro\.localhost\/saml\/module\.php\/saml\/sp\/saml2-acs.php\/efront-sp$

ACS (Consumer) URL: https://pro.localhost/saml/module.php/saml/sp/saml2-acs.php/efront-sp

After configuring your OneLogin account, sign in to eFront, go to theSAML tab on theHome >System settings >Single Sign On page and configure yourIdP settings exactly as illustrated:

After your SAML setup is complete, a link toSign in with Samlmust appear on your eFront index page.

Note:If most of your users log in via SAML, you can checkBypass the default sign in screen and send users directly to the IDP's SAML signin page to redirect users from the eFront log-in page to the SAML log-in page. Users can still access the eFront log-in page at http://[yourefront domain]/start/op/login.

Note:eFront allows you to configure a different SAML SSO setup for each branch. To do that, go to a branch page fromHome >Branches, click Settings and, from the drop-down list, chooseSAML. After you finish the SSO setup, branch members can log in through the branch SAML IdP instead of the branch log-in URL.

D. AD synchronization via ADFS with LDAP API or SAML

There are two ways to perform AD synchronization via ADFS in eFront: either by using the SAML 2.0 standard or by interfacing directly with AD through the LDAP API.Note: In any case, eFront does not initiate a full-scale synchronization of data. Instead, it pulls information on each user that tries to sign in for the first time and limits this information to the absolutely necessary fields. Also, know that eFront does not store user passwords, but performs authentication against the AD itself (in the case of SAML, it doesnt even transmit credentials).In the LDAP API case, the data is configured in the connection settings screen; there is also a possibility for someone to use the connection credentials stored in the system to perform additional queries on the LDAP server. This can be controlled by limiting the permissions of the user that's used to perform the queries. For example, if you create a user that has access to a specific part of the LDAP tree, and to specific fields of the entries found in this subtree, then you can guard your data against any misuse.In the case of SAML 2.0, instead, the data set is limited by the protocol, as SAML is used to perform the authentication and grant access to eFront.

E. LDAP

For a step-by-step guide to the LDAP SSO setup, see this article.

F. NTLM-like

A user can sign in to the system by using the REMOTE_USERserver configuration variable. When the system detects the presence of aREMOTE_USER in web-server variables, it attempts to sign the user in automatically.

G. REST API

You can use the REST API to retrieve a one-time log-in URL for a specific user by using the following call:

GET /Autologin/:loginName

The above API call returns a URL that can be used on a single instance to sign a user inwithout a username and password.

Note:A complete guide to using the eFront REST API canbe found here.

H. Cookie-based

Another option for signing a user inwithout a username and password is to use a specially crafted cookie named "ef_user." The cookie must include a serialized array where the key is a user id, and the value is a string that matches a corresponding value stored in the user's profile.

I. Plugin-based

If signing in a user automatically requires some process not covered by the system, the required functionality can be implemented with a custom plugin that calls theUser::loginfunction to do the sign-in.

Note:A comprehensive guide to creating custom plugins can be found .

When assigning courses to an audience, you are building the catalog of this audience at the same time.

Note:When an audience is created in a branch by a Branch Administrator, then only the users of that specific and its sub-branches can be added. Even if this audience is edited and modified by a Main Administrators afterwards, still users will be filtered according to the branch where the audience was created.

You can choose to assign courses to some audience by the Courses tab (1) when editing the details of the audience:

Once you setup the courses for that audience, only the users that belong to that audience will be able to browse their catalog andview those courses in order to enrol to them.

Note: If a course is assigned to some audience it will not appear either in the main catalog or in some branch catalog if it is also assigned to some branch.

eFront lets you set up different notifications for your branches according to each subportals specific needs and requirements.

To learn how, follow these simple steps:

1. Sign in to a branch as Branch administrator and go to Home > Notifications.

The first time you go to the Notifications page as Branch admin, youll see that the activate/deactivate switch (1) next to each notification is not clickable. Its because these notifications are set by the main Administrator for your main eFront portal.

2. Click a notification or the edit symbol (2) next to the activate/deactivate switch.

3. Make at least one change to the notification page (e.g., type a new subject).

4. Click Update (3).

After you have edited a notification, its immediately assigned to the branch (4), and youre now able to activate, deactivate (the switch is now clickable (5)) or delete it.

Note: The main portal administrator has no access to notifications that are assigned to a specific branch and managed by the Branch admin.

As mentioned in the article How toWork with Branches, you can divide your e-learning offering into different logical units.

Note:For more on mapping domains to your eFront portal, follow this link.

You can define a different URL for each branch and allow users access their corresponding branch directly.

In order to set up a branch URL, the following steps are needed.

Ensure firstly that in System settings page Identity tab the value in Main URL is correct. It must be the same with your main URL of installation.

Then in edit page of a branch specify your preferred domain URL for the branch. By default, this value is filled in based on branch name

You have also to define in your DNS server that all sub-domain URLs are served your server. Use *.main.example.com where main.example.com is your main URL.

Lastly, in httpd.conf file (or httpd-vhosts.conf depending on your settings) and also a ServerAlias like this ServerAlias *.main.example.com

To create a custom report, log in as an administrator and from your Administration dashboard, visit Reports. Here, select the tab Custom (1).

You shall see a tabular list of all available custom reports, or if you do not have any custom reports set up yet the following screen.

Clicking to set up a new custom report will get to you the Custom Report Create page.

Initially, you need to provide a title for this report (2). This field is mandatory. The next mandatory field that you need to provide is the Output information (3). This field contains information that you might want to report on. Select the information to be produced for each user. Information related to progress will produce as many entries as the assignments of the courses per user.

This field contains information that you might want to report on. Select the information to be produced for each user. Information related to progress will produce as many entries as the course's assignments per user.

Next, you can add rules (4) to better narrow down your report. Select the rules that will define what data is going to be included in your report. After selecting a ruleyou can specify it further (5).

You can add more than one rule, which you can later removeif you do not need it anymore, and while adding new rules you can define the relation this new rule has to the previous one (6) (meaning a logic relation of AND or OR).

Finally, you can select whether you want this report to be executed periodically or not and set up a schedule for it.

Setting up a schedule for the report will need to you first enable the Scheduled report option (7) and then define when the report is going to run and what is the interval for your schedule. At last, you can specify a list of custom recipients for the scheduled report by email.

When you are done, click save and you will be presented with the list of users that comply with the rules you have set up and export them to excel.

You can use the Disconnect Idle Users option to automatically sign a user out after theyve been inactive for a specific number of minutes.

To do that:

Log in as an administrator.

From the administration dashboard, go to System settings.

On the left-hand list choose Security (1) and remain in the default GENERAL tab (2).

Click Yes (3) on the Disconnect Idle Users field. A new field, Disconnect after (4), will appear.

Insert the number of minutes after which the user will be disconnected. Click SAVE to confirm this change.

Note: Valid values are 0 (which means the feature will be disabled) to 1439 (23 hours 59 minutes). If a disconnection time is not set, the system will disconnect users on its own after approximately 5 days of inactivity, but if and only if the cronjob scheduler is running.

A user will be considered "not actively present" when a session is not updated (e.g., any explicit user action, like a page visit, or implicit, like a background AJAX process and a test autosave).

Display countdown timer

Optionally, a countdown timer can be displayed on the top, counting minutes and seconds left until the session expires. When you click Yes on the Disconnect Idle Users field, the option Display countdown timer (5) will appear. Tick the option to enable it.

The user will be logged out when the timer reaches zero. The system will save any pending progress.

The countdown timer is displayed when the time left is less than 1 hour. When the time left is 10% of the total expiration time, the system will also pop up a message asking the user what to do. The user can reset the countdown by clicking the recycle (6) icon of the counter.

Note:This setting is global only and cannot be overridden per branch.

To add images to your Certificate template (e.g., a logo, a background or a signature), go to Home > Certificates (1).

Go to the Images tab(2). Here, you can see all the images(3) currently used on all your Certificates. You can upload new images by dragging and dropping them into this area. The suggested dimensions for signatures are 200x40 and for background images are 840x600.

Note: Certificate images uploaded are connected to a branch, so if you will upload an icon as abranch-administrator this will be not shown to other branch-trees. As a branch-administrator, you can see and have available all images uploaded in your branch and in its sub-branches.

After uploading your images you should follow these steps to add them to your certificate templates:

Go to the Templates(4) tab. To edit a specific Certificate template, click the name of the template or the respective edit symbol(5).

On the code block in the XML content editor, find the <images> tags. Wrapped inside, are the images used by the template you've selected:

<images><image file="heavy.png" w="300px" h="210px" x="0" y="0"></image><image file="custom_signature.gif" x="18" y="176"></image></images>

To replace an image, just change the filename in thefile attribute (e.g.,file="NewLogo2018.png"). To add a new image, just add a new line of code, as shown in the examples above (e.g.,<image file="NewLogo2018.png" x="18" y="176"></image>).

Note:Thex andyattributes are the coordinates of your image on the space your template covers. You can edit them to place the imageanywhere on your certificate. For example, a "0" value for both attributes (x="0" y="0") places the image at the top-left corner. For background images, you also have to specify the 'w' and 'h' attributes (width and height) according to the size of your certificate.

ClickUpdate to save your changes.

Topreview your certificate, click the respective view symbol(6).

Note: In the 'Advanced settings' of each template, there is also an Image ratio field for background pages. If an image is not displayed, make sure first that this value (7) was not accidentally set to 0 (zero).

It is important to have a well designed and appealing certificate. In this section, we will discoverout how to draw lines, display pictures, set a background image and insert fields within the certificate.

The example XML schema below specifies where elements of the certificate will appear.

Next, we will look at each of the elements and explain their properties.

<?xml version="1.0" encoding="utf-8" ?>

<certificates>

<certificate>

<organization text="eFront" font="Freeserif" weight="bold" size="60" color="#005b7f" x="120" y="13"></organization>

<student font="Freeserif" weight="" size="35" color="#000000" x="5" y="95" align="center"></student>

<course font="Freeserif" weight="" size="28" color="#000000" x="5" y="133" align="center"></course>

<grade font="Freeserif" weight="bold" size="28" color="#000000" x="160" y="150" align="center"></grade>

<date font="Freeserif" weight="" size="15" color="#575757" x="225" y="182"></date>

<serial font="Freeserif" weight="" size="14" color="#575757" x="107" y="182"></serial>

<logo file="default" x="14" y="14"></logo>

<background file="medium.png"></background>

<orientation name="landscape"></orientation>

<creator name="eFront"></creator>

<author name="eFront"></author>

<subject name="Certificate for "></subject>

<keywords name="This is a list of keywords"></keywords>

<labels>

<label text="NOT JUST ANOTHER ELEARNING COMPANY" font="Freeserif" size="20" color="#000000" x="80" y="41"></label>

<label text="We Make e-Learning Special" font="Freeserif" weight="" size="18" color="#000000" x="110" y="51"></label>

<label text="Certificate of Achievement" font="Freeserif" weight="" size="35" color="#000000" x="80" y="67"></label>

<label text="This Certificate is Awarded to:" font="Freeserif" weight="" size="24" color="#000000" x="97" y="82"></label>

<label text="For the successful completion of:" font="Freeserif" weight="" size="22" color="#000000" x="95" y="120"></label>

<label text="With grade:" font="Freeserif" weight="" size="22" color="#000000" x="120" y="152"></label>

<label text="Instructor" font="Freeserif" weight="" size="10" color="#000000" x="20" y="192"></label>

<label text="Serial Number" font="Freeserif" weight="" size="10" color="#000000" x="110" y="192"></label>

<label text="Date" font="Freeserif" weight="" size="10" color="#000000" x="200" y="192"></label>

</labels>

<lines>

<line x1="5" y1="5" x2="292" y2="5" color="#005b7f" thickness="2" note="Top Thick"></line>

<line x1="292" y1="5" x2="292" y2="204" color="#005b7f" thickness="2" note="Right Thick"></line>

<line x1="5" y1="204" x2="292" y2="204" color="#005b7f" thickness="2" note="Bottom Thick"></line>

<line x1="5" y1="5" x2="5" y2="204" color="#005b7f" thickness="2" note="Left Thick"></line>

<line x1="7" y1="7" x2="290" y2="7" color="#005b7f" thickness=".25" note="Top Thin Border"></line>

<line x1="290" y1="7" x2="290" y2="202" color="#005b7f" thickness=".25" note="Right Thin Border"></line>

<line x1="7" y1="202" x2="290" y2="202" color="#005b7f" thickness=".25" note="Bottom Thin Border"></line>

<line x1="7" y1="7" x2="7" y2="202" color="#005b7f" thickness=".25" note="Left Thin"></line>

<line x1="17" y1="190" x2="97" y2="190" color="#000000" thickness=".25" note="Signature Line"></line>

<line x1="107" y1="190" x2="187" y2="190" color="#000000" thickness=".25" note="Serial Line"></line>

<line x1="197" y1="190" x2="277" y2="190" color="#000000" thickness=".25" note="Date Line"></line>

</lines>

<images>

<image file="certificate.gif" x="238" y="14"></image>

<image file="signature.gif" x="18" y="176"></image>

</images>

</certificate>

</certificates>

creator: to populate with the creator of the PDF document header (it does not appear on the document)

author: to populate with the author of the PDF document header (it does not appear on the document)

subject: to populate the subject for the PDF document header (it does not appear on the document)

keywords: to populate the list of keywords for the PDF document header (they do not appear on the document)

organization: to display the organization name on the certificate

student: to display the full name of the student on the certificate

user_login: to show the student's username

course: to display the name of the course on the certificate (for long course titles you can add an attribute 'truncated' to the <course> tag so to show only a part of the course title - in case you use this option you'll need to add a numeric value; for example, to have the title truncated and to keep just 55 characters of it:

<course font="Freeserif" weight="" size="28" truncated="55" color="#000000" x="5" y="133" align="center"></course>

grade: to display the overall grade of the course on the certificate

date: to display the date the certificate was issued

course_start_date: to display the course start date

course_end_date: to display the course end date

training_session_start_date: to display the date when the student began the first session event in a blended course

training_session_end_date: to display the date when the student finished the last session event in a blended course

description: to display the description of the course on the certificate

ceus: to display the CEUs of the course on the certificate

trainer: to display the trainer(s) of the course on the certificate

trainer_name: to display the course's trainer(s) names

date: to display theissue date

completion_date: for the course completion date (when different than the issue date)

expire: to display the expiration date of the certificate on the certificate

print_date: to display the date the certificate is printed on the certificate

serial: to display the serial number of the certificate

branch: to show the name of r the learner's branch

logo: to display the logo image on the certificate. You can either display the default logo of your eFront installation or an external image, by supplying itsURL

background: to display a background image on the certificate. The medium.png file corresponds to the background image of the Medium Decoration template (the heavy.png file corresponds to the background image of the Heavy Decoration template; apart from these background images, you can display an external image, by supplying its URL-image width should be equal to 840 pixels)

orientation: to define the page orientation

label: a label is a line of text that will appear on the certificate. A label element must appear within the labels section. You can add any number of labels as needed

line: a line is a graphical line that is drawn on the certificate. A line element must appear within the lines section. You can add any number of lines as needed

image: an image is a graphic that will appear on the certificate. An image must appear within the images section. You can add any number of images as needed

Properties for student, course, grade, date, serial and organization elements

Property

font

Name of the font to use.

weight

The font weight. Possible values: bold, italic, bold|italic. For the normal font, leave the value empty.

size

Size of the font to use.

color

Hex value for text color (i.e: #000000 is black).

x

X coordinate.

y

Y coordinate.

align

The text alignment. Possible values: centre, left, right.

text

Text to appear on the certificate. It applies only to the organization element.

Properties for the creator, author, subject and keywords elements

Property

name

The value that will appear in the PDF document header.

Properties for image, logo and background elements

Property

file

Name of the image to use or the URL of an external image.

x

X coordinate. It applies only on the image and logo elements.

y

Y coordinate. It applies only on the image and logo elements.

Properties for orientation element

Property

name

The page orientation. Possible values: landscape, portrait.

Properties for label elements

Property

text

Text to appear on the certificate.

font

Name of the font to use.

size

Size of the font to use.

weight

The font weight. Possible values: bold, italic, bold|italic. For the normal font, leave the value empty.

color

Hex value for text color (i.e: #000000 is black).

x

X coordinate.

y

Y coordinate.

Properties for line elements

Property

color

Hex value for line color (i.e: #000000 is black).

note

A note for user reference. It does not appear on the document.

thickness

The line thickness (i.e: Thin: .25, Thick: 2).

x1

Starting X coordinate.

x2

Ending X coordinate.

y1

Starting Y coordinate.

y2

Ending Y coordinate.

Templates with two or more pages

If you need a certificate with more than one page, you should include each page within a <certificate> tag. You should include all the properties for the creator, author, subject and keywords within your first <certificate> tag and you do not need to repeat them again in your second (or thirdetc) <certificate> tag. For example

<?xml version="1.0" encoding="utf-8" ?>

<certificates>

<certificate>

content of page 1

</certificate>

<certificate>

content of page 2

</certificate>

</certificates>

Adding custom images to certificate templates

To add new background images to your certificate template you should upload your image files into the following folder:

<efront-installation-folder>/www/assets/images/certificate_logos/<your_image_file>

later, in your certificate template, you can type

<images>

<image file="<your_image_file>" x="238" y="14"></image>

</images>

Adding custom fonts to certificate templates

eFront uses TCPDF, a FLOSS PHP class for generating PDF documents, to create certificates.

To add new fonts for your certificate template you should first add them to the TCPDF engine. In order to do this you can do it in two ways:

The first way is to use TCPDF's addTTFfont method and send as a parameter a TTF (possibly another type too):

$font = $this->addTTFfont("filename.ttf");

then you can use the font name when you need it like this:

$this->SetFont($font,'',10);

The second way is to install the new fonts in the TCPDF engine manually. In order to do so, you can use the tcpdf_addfont.php script which is included in the TCPDF tools.

Go to

<efront-installation-folder>/libraries/external/tcpdf6/tools/

in order to install a custom font use the tcpdf_addfont.php script as in the following example:

php tcpdf_addfont.php -i /home/prountzos/Downloads/FranklinGothicBookRegular.ttf

if everything works ok you would see in your results something like the following:

>>> Converting fonts for TCPDF:

*** Output dir set to /var/www/efront/libraries/external/tcpdf6/fonts/

+++ OK : /home/prountzos/Downloads/FranklinGothicBookRegular.ttf added as franklingothicbook

>>> Process successfully completed!

later you can use your newly installed fonts in your certificate as in the following example:

<student font="franklingothicbook" weight="" size="35" color="#000000" x="5" y="95" align="center"></student>

Branches allow you to divide your e-learning offering into different logical units (or 'departments'), each with its own courses, users, professors and branding (sub-domain, theme, logo, etc.).

Branches can be a flat list or form a nested hierarchy.

To create a new branch, you would click on the Add Branch button.

Provide the desired name (1) for the branch, an optional parent branch (2) - if this new branch you are creating would be a child branch of some other branch. Finally, you can provide the desired URL for the branch (3).

The panel for editing an existing branch is similar to the add branch panel but also contains tabs to see the branches Users, Courses, Curriculums and extra Settings.

The Users, Courses and Curriculum tabs are simple tabular listings of the Users, Courses, and Curriculums assigned to the branch respectively, and allow you to download this information in Excel-compatible CSV format (1).

In the Settings tab, you would be able to view Options, LDAP and SAML. Regarding LDAP and SAML (2) check out the corresponding articles in our Knowledge Base. You can set up the way users login to this branch.

Regarding the Options, these are the settings that concern only this branch. You can set up the following:

Site name: The site name for this specific branch

Site motto: The site motto for this specific branch

Language: The default language for this specific branch

Theme: The theme for this specific branch

Registered users limit: use this to set the total number of users allowed to be registered in this branch and its sub-branches. Leave blank for unlimited

Concurrent users limit: use this to set the total number of users allowed to be logged in to the branch and its sub-branches at the same time. Leave blank for unlimited

Max online branch users notification goes to: use this to decide which email address is used to inform that the allowed users limit in the branch has been reached

New users require approval: Check this if the system administrator should approve any new users that are created by the branch admin

Course assignments deduct balance: Check this if you require the branch administrators to pay for the courses assigned to their users, using their balance

When creating a report, you can filter your data in order to better manage your result.Visit the reports section and over there you will be able to view the filter button (1).

Clicking on that filter will open a pop-up window which will show all available filters for this report.

In the Users section of Reports, you can find some extra options that will help you filter users also by status (Active or Inactive) and activity on the portal:

Note:You can inverse all filter for your report. Meaning that this will add a NOT operation to your filters. For example, assume that you want to get a report for all users that do not belong in the group 'Senior students'. Select the group filter with your group's name and the invert the filter from the corresponding option.

Fixes:

Fixed an issue for SAML users log in on mobile app

Fixed a compatibility issue with Internet Explorer 11

eFront offers a mobile app for Android and iOS users. The app is free to download through the Play store and the App store. The app is designed for learners only and it supports the following types of content:

Simple text

HTML text

Vimeo/YouTube (not available for offline use)

PDF

Video

PPT

Images

Units containing iframes with an external source (not available for offline use)

MS Office files (for Android users it is partially supported by Google docs viewer and only for online use)

Scorm (html5 based only)

Slideshare(not available for offline use)

The content types that arenotcurrently supported are:

Tincan content

Tests with a non-supported type of questions

ILT units

Units containing an object or embedded elements

Units containing an iframe with an external source

H5P content

The mobile app supports tests which includeonlythe following question types:

"Drag and Drop"

"Empty Spaces" (only with the option "Display alternatives in select box" selected)

"Multiple choices with a Single answer"

"Multiple choices with Many answers"

"True/False"

"Free-text with keywords"

Tests that arenotcurrently supported are:

Randomized tests

With enabled option "require a password to start the test"

Offline functionality

Some of the content types can also be available when the users are Offline, meaning that they don't have access to the Internet. When they are back online, any progress made while being offline will be synched.

Tests and surveys are available while the users are offline. This means that in case a user does not have access to mobile data (3G, 4G, etc) or Wi-Fi, they will be able to complete a test or survey. Furthermore, they can access any uploaded video files but they cannot view videos from YouTube/Vimeo since this action requires an active internet connection. They can also access any uploaded audio, PDF files, HTML and simple text units.

For Androidusers, in order to see the offline content, the user should:

Press the sync button on a course, and download the content.

Download a single unit, just by clicking on it.

For iOS users there is no sync button; just swipe down with one finger on the screen and, if there is an update on content, you'll see one or more wheel/network activity symbol turning.

Note 1: You are able to delete all or specific downloaded courses through the setting options.Note 2: Non-compatible units (units that can not be viewed offline or the app does not support yet) will properly show on the unit list but the learner will not be able to open them. eFront will display the following message: "The unit is not available".

Note 3: All SCORM content not explicitly designed to operate via a 3rd party server and not containing content hosted on 3rd party servers (e.g. YouTube / Vimeo) is also available offline".

New Features:

Added 'Branch' column in Reports -> Certificates

Added attribute truncated to tag in Certificates

Added support for SAML login on mobile apps

Added support for MySql version 8

Improvements:

Integration with the video transcoding service has now been improved

Removed warning message shown to logged in users after trying to access a page and were forced to login via SAML

Small improvements in the AIKEN import format

Changed id type in users_to_audiences database table to int

Fixes:

Fixed an issue that would include archived courses in custom reports counters

Fixed truncated course title in Certificates when course title exceeds 70 characters

Fixed intermittent problems when submitting large tests under slow network connections

Fixed a bug that would cause rejected emails to still be sent

Fixed issue about selecting recipients in personal messages when the search is disabled in user type

Fixed issue about returning courses not related to branch on Courses REST API call from a branch

Fixed issue about ajax calls in IE while running under IIS server and custom HTTP port

Fixed issue about SQL error after deleting an administrator that was the creator of other users

Fixed issues about displaying discussions in branches that should not be shownEnhancements:

Fixed issue regarding AutoSync export functionality

The Certification process enables your users to download a Certificate of Completion after completing a course.

The first step when working with certificates is to review the look and feel of each certificate currently available in order to decide which one to use for any given course youre creating.

When creating a course, the administrator can select a single certificate template from a list to assign to that course.

To review the certificates available, do the following: Login as an Administrator andclick on the Certificates section (1).

How to offer Compliance Training

In the Certificates section, you will be able to view two tabs. The first tab contains a tabular list of all your certificate templates (2),

while the second tab, 'Users' (3), shows, again in a tabular list, all the users in your system that have been awarded a certification along with the status of this certification and other details about the certification, such as when was awarded, when it expires, etc...

Adding/Editing a Certificate Template

To add or edit a certificate template, click on the Add Template (1) button or on the edit icon (2) in the operations column of the certificate templates.

When adding (the same goes for editing) a new certificate, the first thing you need to do is to provide a name for this certificate template (3). Then you may choose the language for which this template will be valid (4). This way you may have the same certificate a different template for each language.

Next, you can actually format the certificate template using the XML content area (5). Check out our guide on how to customize a certificate for more information. You will note that in your certificate template you may use a list of available tags (6) regarding courses, trainers, grade in courses etc. Moreover, if you have any custom fields defined you will be displayed the corresponding xml tags, that you may use for your certificate template.

Note:In case the course titles are long and you want to show always the same characters for all courses using this certificate, you can add an attribute 'truncated' to the <course> tag. Add truncated="XX"and a numeric value between the quotes. For example, to have the title of the courses truncated so that the certificate will show only 40 characters of it:

<course font="Freeserif" weight="" size="28" truncated="40" color="#000000" x="5" y="133" align="center"></course>

Finally, there are some advanced settings you can access by clicking on the "Advanced settings" link (7).

The first setting is the Image ratio, for any images you might be using in your certificate template, while the second one is the branch ownership of the certificate template.

Assigning a certificate template to a course

After you have successfully set up your certificate template you may use it to format the certificates your courses award. Just visit a course's settings, click on advanced settings a find the certification option.

Check out more information in the following article: .

Certificate Notifications

eFront default notifications contain three notifications that concern certificates. Those are:

Certificate issued

Certificate revoked

Certificate expires

There is a notification that can be sent automatically every time a user acquires a certificate as well as when or before a certificate expires or gets revoked. You may edit the templates or details of those notifications as well.

To add content to an empty course, visit the course and then go to the course's dashboard(1).

this article

Note: When adding or editing the course image, in the 'Properties' tab, please consider that the ideal size of it is 440x280 pixels.

Initially, you shall see that there is no content added to the course. To start adding new content you can use the shortcuts that appear in the course dashboard when a course is empty (2). You will be prompted to drag and drop files into the content area directly. You can also use the Add unit option. Alternatively, you can use the Add content button (3) and select the type of content you want to add.

Clicking on the Add content button will open a drop-down menu with all available options (4) for adding a new content to the course. These are:

Add unit - to add a new unit to the course

Add test - to add a new test to the course

Add survey - to add a new survey to the course

Add assignment - to add a new project assignment to the course

More option or ways to add content to the course are the Clone unit option, where you can clone a unit to that course from another course.

To add extra material to the course, such as pdf files, video or audio files, presentations etc you can use the option 'Go to files'. This will get you to a tabular list of all the files available to the course. You can either use the upload button to upload a new file or drag n drop files directly to the page.

Finally, you can add lessons to the new course. Lessons are an abstract collection of units (course content) that help you better organize and structure your course material. Visit the 'Go to lessons' library option (from the drop-down menu that is available from the Add content button), as described in this article.

Initially, you shall notice that there is already a lesson created (the same name as your course) and already assigned to your course. In case you want to create new lessons please follow the instructions provided in .

We will now describe the process of setting up Windows 2012 for SAML, LDAP, IIS and eFront. This guide is a series of steps along with their corresponding screenshots (when applicable). Start with logging into your IIS server.

1. Click on "Add roles and features"

sslshopper

2. Click on next and then on Role-based or feature-based installation

3. Select a server from the server pool

4. Select server roles, accepting any prompts:

Active Directory Certificate Services

Active Directory Domain Services

Active Directory Federation Services

DNS Server

Web Server (IIS)

5. Dont install anything for Select features in the next screen

6. Move next until the end

7. Click to Restart automatically, and then click on Install. The process will start.

8. Go to Start->Administrator tools->IIS

9. Expand the Service and click No when prompted to get started with Microsoft Web Platform

10. Click on Server Certificates

11. Click on Create Certificate Request and fill in the appropriate information. Then click next, specify 2048 for the key length and finally specify a path and filename

12. Go to Comodo or StartSSL to issue free SSL. Use the CSR generated in the previous step.

13. Click on Complete certificate request

14. After that, it should look like this: (an error might crop up while importing, ignore it)

15. Go back to the Server Managers Dashboard and click on AD DS

16. Youll see a notice Configuration required click on more

17. Click to Promote this server to a domain controller

18. Click to Add a new Forest and type the servers domain name, e.g adfs2.efrontlearning.com

19.Type a DSRM password and click next

20. Ignore the A delegation for this DNS server [...] message

21. Move on from the NetBIOS screen and confirm the paths

22. Click next on Review your selections

Note:On Windows Servers, IIS is not configured to work with the PUT command by default.The eFront API uses the PUT command. To enable IIS PUT:

Open your IIS Manager and select your eFront

Open 'Handler Mappings'

Find and select PHP_via_FastCGI

On the 'Edit Module Mapping' window, please select 'Request Restrictions'

Go to the 'Verbs' tab and make sure you input the 'PUT' command

Click OK twice to confirm (in case there is a pop up disallowing you to continue, please enter the double quote symbols in the executable path)

Finally, select 'No' at the FastCGI creation selection pop up window

23. If all prerequisites pass, click install (Unless you see the next step)

24. If you see an error above like Certificate Server is installed, go to "Server Manager", "Manage", "Remove Roles and Features", remove the check mark in "Active Directory Certificate Services", and walk through the removal. Then retry the prerequisites check

25. After restarting, create a new user from Tools->Active Directory Users and Computers

26. Navigate to the Users section and right click to create a new User

27. Enter the users information and then create a password

28. Find this user in the Users List at the right and click to View properties

29. Add a valid email address for the user

30. Go back to the server managers home page and click on the AD FS panel

31. Youll see a note that configuration is pending for ADFS. Click on More...

32. Click on Configure the federation service

33. Select Create the first federation server in a federation server farm and click Next

34. Leave the selected account for the next screen

35. Click on the drop-down list to select the installed certificate. Enter a name for the Display Name and click Next

36. Youll get a note that Group Managed Service Accounts are not available [...]. Click on Show more to see the command that has to be ran using PowerShell

37. Run the command. You may have to click on Previous and then Next again to get past the screen

38. Create a new account

39. Select to create a database

40. Review options and click next

41. If all the prerequisite checks pass, click configure

42. Time to setup SAML 2.0. Go to the server manager dashboard and click on Tools->AD FS Management

43. Click to Select the Services and right click and select Edit Federation Service Properties

44. The General tab reveals the Federation Service Identifier which is what we need for SAML in eFront

45. Click on the Certificates Entryfrom the left tree-view, right-click on Token-Signingcertificate and then click on View Certificate.

46. In the Details Tab click on Copy to Fileand the Certificate Export Wizardlaunches. Click on Next, select DER encoded binary X.509 (.cer) format, and then click Next. Choose where you want to save the certificate and click on Finish.

47. eFront requires a PEM format certificate. So you will need to convert the certificate to PEM format using any appropriate tool or even online tools such as . Convert the certificate from DER to PEM format. You will need it during configuration later on. Keep in mind that eFront will work with RSA certificates. DSA certificates are not supported.

48. We need the SAML metadata XML now from eFront. Sign in as admin and go to system settings Integrations SAML

49. We need whats next to the label SP Metadata XML

50. From the AD FS Manager, go to Trust Relationships Relying Party Trusts and right click to bring up the context menu. Select Add Relying Party Trust.... to launch the Wizard

51. Click on startto kick off the wizard and then click on the option Import data about the relying party published online. Paste the URL found in eFront SAML settings above. It is imperative that you use HTTPS for this. In our example. Its https://saml.pro.efrontlearning.com/saml/module.php/saml/sp/metadata.php/efront-sp

52. Click on Next and ignore the warning message

53. Enter a descriptive name for the Service Provider, e.g. eFront

54. Skip the multi-factor authentication

55. Permit all users to access this relying party

56. Continue until Finish

57. You should now see the eFront entry under Relying Party Trusts.

58. Double click on it to bring up its properties modal. Go to the Advanced tab and select SHA-1 as the Secure hash algorithm

59. ADFS 2.0 Claim Rules Configuration: Click on Edit claim rules

60. On the first tab, Issuance Transform Rules, click on Add rule

61. Select Send LDAP Attribute as Claims and click on Next

62. Define the Claim rule name (eg. Get LDAP Attributes) and select Active Directory in Attribute Store. In the Mapping of LDAP attributes to outgoing claim type select the following:

LDAP Attribute: E-Mail-Addresses, Outgoing Claim Type: E-mail Address

LDAP Attribute: Given-Name, Outgoing Claim Type: Given Name

LDAP Attribute: Surname, Outgoing Claim Type: Surname

LDAP Attribute: User-Principal-Name, Outgoing Claim Type: UPN

63. Click on Finish to create the rule

64. Click on Add Rule again to create a new rule. From the Claim Rule Template drop down, select Transform an Incoming Claim

65. Define the Claim rule name (eg. Email to Name ID) and set Incoming claim Type as E-Mail Address (the same one from the previous rule), Outgoing claim type as Name ID and Outgoing name ID format as Email. Then click on Finish. Have in mind that the email should be defined in all users to achieve proper communication between your ADFS and eFront.

66. Open the AD FS Manager, go to Relying Party Trusts, right-click on eFront and click on Edit claim rules

67. Select Get LDAP Attributes and click on Edit. Then click on View Rule Language

68. Copy the information found there. You will need it in order to find out the Attribute matches for TargetedID, First name, Last name, and Email.

69. Sign into eFront and go to admin System settings Integrations SAML.

70. Paste the information like as per the example below. The values for TargetedID, First name, Last name and Email can be found from the Claim rule language we copied earlier. The certificate fingerprint can be found by executing an OpenSSL command (openssl x509 -in adfs2.crt -sha1 -noout -fingerprint), or by simply clicking on the or paste your SAML certificate (PEM format) and pasting your certificate.

Identity provider

https://adfs2.efrontlearning.com/adfs/services/trust

Certificate fingerprint

2e47fb8f201f016825a...

Remote Sign-in URL

https://adfs2.efrontlearning.com/adfs/ls/

Remote Sign-out URL

https://adfs2.efrontlearning.com/adfs/ls/?wa=wsignout1.0

TargetedID

http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn

First name

http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname

Last name

http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname

Email

http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress

71. Now try signing into eFront by clicking on the Sign in with SAML link

72. You will be redirected to your ADFS portal and prompted to sign in with your username and password

73. Thats it! An account has been automatically created for you in eFront, and youre signed in

74. You can click on the log out button to sign out of the Service

75. Debugging the service: If anything doesnt work, you can consult the AD FS log files, found under Server Manager AD FS

76. Now, setup LDAP SSO (Efront only): First, make sure that port 389 is open in the servers firewall

77. Create a user account that will be used to search the AD tree.

78. Lets call it, for example, ad_searcher

79.Go to eFronts LDAP settings. We need the following information: - LDAP Server: The IP or domain name of the Active Directory - LDAP Server Port: This is 389 for standard LDAP or 636 for secure LDAP (ldaps) - LDAP Bind DN: The Bind DN of a user that has search rights across the whole AD tree. In our example, its CN=AD Searcher,CN=Users,DC=adfs2,DC=efrontlearning,DC=com, but you can also use the User login name (pre-Windows 2000) as shown in the step above, which for our example is ADFS2\ad_searcher - LDAP Bind Password: The password for the user above - LDAP Base DN: The Base DN under which the user ad_search will perform searches in the tree. Users outside this base DN will not be retrievable, so the will not be able to sign in - LDAP Protocol Version: Always 3 for Active Directory - Login name attribute: The user attribute that will be used as the username. Typically this is samaccountname but older versions of Active Directory required sAMAccountName - Full name attribute: Where eFront will read the users name from, typically cn - Email attribute: Where eFront will read the users name from, typically mail Note: If youcan'tfind the Bind DN or Base DN, you can use the following technique:

Bring up the PowerShell

Run the following command: dsquery user

Or, if you want to search for our searcher user (which is more convenient): dsquery user -name ad* That will display the Bind DNs for all users. So, for our example, we locate the user ad_searcher, whose Bind DN is CN=AD Searcher,CN=Users,DC=adfs2,DC=efrontlearning,DC=com. Removing the first part which is user specific, leaves the Base DN, which is CN=Users,DC=adfs2,DC=efrontlearning,DC=com

Below we can see the data entered:

LDAP server

adfs2.efrontlearning.com

LDAP server port

389

LDAP Bind DN

CN=AD Searcher,CN=Users,DC=adfs2,DC=efrontlearning,DC=com

LDAP Bind password

The password for user ad_searcher

LDAP Base DN

CN=Users,DC=adfs2,DC=efrontlearning,DC=com

LDAP Protocol Version

3

Login name attribute

samaccountname

Full name attribute

cn

Email attribute

mail

80. You can click on Check settings to verify that the information entered is correct.

81. Thats it! Now users can sign in to eFront using their AD username and password

To extend a user profile to ensure that profiles contain more information that you might need for your users, login as an administrator and from your Administration dashboard, visit Extended Profile section.

Here, you will be able to view a tabular list of all the custom defined extended profile fields.

Click on the Add Field (1) button to create a new profile field.

Fill in the required information, which is a name for this profile field (the best practice is to give a name in lower case and without any whitespaces or symbols) and the label for that field.

Then for the 'Create for' option (2), select 'Users'. This means that the extended profile field you are going to make concerns users. That's it.

This field will now appear in your users' profile (3).

New users signing up in your system will have to fill in data for this field if you choose it to be mandatory using the 'is mandatory' field:

Note: When adding a new Extend field this will not change the existing items retroactively. For example, if you create a new custom field for Users, only the users created afterwards will have the option to choose among the values (and the already existing users will have assigned the default value, if a default value is set, or they will have to add a value only when edited/updated). Also, keep in mind that, if you update an already set default value with a new one, instead, this will apply only to the new users created after this change, while the already existing users will keep the value they have.

If you have chosen this field to be visible in reports, data from this field will also appear in your Reports.

New Features:

Added status_localized field in API User's response

Made course titles clickable links, if they belong to a curriculum

Added completion time column in Recently submitted tests page

Added link to courses pages in Curricula Catalog page when a user is already enrolled

Fixes:

Fixed Webex API for conferences since the siteID field was deprecated

Fixed a bug where the "view more" button would not appear in the course description if it contained media elements

Fixed empty prefix cache issue causing problems in shared servers

Announcements now appear in all internal pages and can be specified without a body for a more compact view

Fixed problem when submitting a multiple choice question with immediate feedback turned on

Fixed displaying answers that scored 100% as "not correct" when the "immediate feedback" option is enabled in tests, under specific circumstances

Fixed issue about certificate expiration date in specific notifications

Fixed MySQL error when viewing skill courses list as supervisor

Fixed error when trying to export lessons containing folders with dots in their name

Fixed issue about adding extra empty tags in question explanation when using TinyMCE editor

Fixed issue about displaying content in RTL languages

Fixed issue about applying extended profile field's default value for existing users

Fixed REST API response for "users" where status was returned translated. Added both status and status_localized return values

Fixed broken lines in API/web.config file needed in IIS for using REST API

Fixed issue in navbar layout occurred occasionally when external pages were created

Fixed "Security policy has expired" error appeared when 2FA was enabled

Fixed issue about Reports/Timeline shown also for Instructors

Fixed issue about truncated skills descriptions

Fixed issue about printing HTML tags in course certificates

eFront only stores files in the www/content folder. As such, if you need to back up your eFront installation, the minimum that is required is this folder and the database.

This means that you can get a backup of your files and data by executing the following commands:

[root]# mysqldump -u efront_user -p'efront_password' efront_database > /path/to/backups/dump.sql

[root]# tar zcvf /path/to/backups/files.tar.gz /path/to/efront

Note: In case the backup can't be completed as expected and as explained in this article, please check the values set in your PHP.ini for "max_execution_time", "memory_limit", "post_max_size", "max_input_time", and in your SQL configuration file for the "max_allowed_packet", and increase their values until you can successfully create a backup.

You can take a backup of your system at any time and store it inside platform in case you need it in the future (for example if you accidentally delete anything that you want to be restored).

Go to the Maintenance section through the admin panel and then to the Backup & Restore option (1).

Click the button "Create Backup" (2) in order to take a backup of your current system. The backup will show up in the list. If you already have a backup file and you want to upload it to your portal you can click on the relevant button (3) and it will be added to the list.

In this way, you can import the entire data from another eFront installation. Under the operations column (4) you will find the available options that you have for your backup files:

Download: allows you to download the backup to save it to your computer or to import it to another eFront installation

Restore: allows you to restore your data and take your system back to a previous status or to restore your data from another installation

Delete: allows to delete a backup if you no longer need it.

Note: In case the backup can't be completed as expected and as explained in this article, please check the values set in your PHP.ini for "max_execution_time", "memory_limit", "post_max_size", "max_input_time", and in your SQL configuration file for the "max_allowed_packet", and increase their values until you can successfully create a backup.

Curriculums are a way of grouping your courses for better organization, to perform mass actions on all of them and to sell them online as a single entity. Groups are for Users, Curriculums are for Courses.

The Curriculums section allows you to see all existing curricula in a tabular listing that also shows the number of students enrolled in each one and buttons to edit or delete a specific curriculum.

The section also features a search box for quickly finding the curriculum you want to view or edit. The curriculum list can be downloaded as an Excel-compatible CSV file.

Adding a Curriculum

To add a new curriculum, click on the 'Add Curriculum'(1) button in the Curriculum section. This will open the page to add a new curriculum.

On the form that appears you need to fill in the name of the curriculum and select the category (e.g. History, Math, etc) that your curriculum belongs to. You can also add an optional Short Description.

There are several advanced options that you can set when you click on the advanced settings link. Those are:

Active: Check this option if you want your curriculum to be active and available to your users or not

Automatically assign to new users: Check this option if you require the addition of new users into the system (or into the branch that the curriculum is assigned to) to be enrolled in the curriculum automatically

Show on catalog: Check this option if you prefer the curriculum to appear in the course catalog and to enable the self-enroll option

Show in the main catalog: Check this option if you prefer the curriculum to appear in the main course catalog

Base price: The price of this curriculum

Certification: Select the certification that this curriculum awards

When you are finished completing the form, click 'Add' to create the new curriculum.

Editing a Curriculum

When editing a curriculum you can edit all the settings we have described above. You may also choose the courses that are going to be part of this curriculum, along with the option for each to set it as mandatory or not for the curriculum.

Moreover, you can manually manage the use of this curriculum by adding or removing users from the user's list:

Finally, you can assign this curriculum to some branch or not:

NOTE:In the learner list-view, you can now recognize which courses were given to learners by assigning that curriculum, and other courses that were already available to learners before the course assignments: in case the user was enrolled to one or more courses with the curriculum, there is a bullet point (1) just before the course title; if thereisn'tany bullet (2), instead, the learner was already enrolled to that course prior to the curriculum assignment.