Extended Domain Settings

The "Extended Domain Settings" plugin is an advanced tool for multi-domain management of the e-learning platform. It allows you to configure and manage multiple platform instances under different domains, each with their own customized settings.

The plugin extends the standard domain settings with most of the options you have for the global platform configuration, this way each domain will behave as an independent platform. For each of your client you will be able to setup different registration modes, home-page settings, SSO token, and much more

Plugin Configuration

Access to Configuration

The plugin is accessible through the administration panel:

1. Access the administrative panel

2. Navigate to the "System Configuration" section

3. Select "Domain Settings"

By default domains will inherit the global platform settings, and any configuration change made to a specific domain will override the default ones

Domain Profile Management

Creating New Domain Profile

To create a new domain profile:

1. Click on the "Insert" button (green)

2. Fill in the required fields: 

• Title: Profile identifier 
• Domain: Complete domain URL 
• Template: Select the appropriate template for this domain
• Organizational node: Associate a specific orgchart node for the users that will self-register to this domain
• Mail Profile: Configure specific email settings for this domain

To add a new domain to your Forma Cloud check our Email & DNS settings documentation

Edit an Existing Domain Profile

To modify an existing profile:

1. Locate the profile in the list

2. Click on the "Edit" button (blue)

3. Update the necessary fields

4. Click "Save changes" to confirm

Profile Deletion

To delete a profile:

1. Locate the profile in the list

2. Click on the "Delete" button (red)

3. Confirm the operation

Advanced Configuration

Domain Settings

Title and Branding

• Title: Platform name customization 
• Domain: Main URL configuration 
• Template: Graphic layout selection 
• Organizational node: Associated hierarchical structure 
• Mail Profile: Specific email configuration

Main Options

Language and Localization

• Default language: Main language selection (e.g., Italian) 
• Page title: Browser title customization 
• Site properties: Copyright and property information

User Management

Access Configuration

• Required checkboxes: Definition of mandatory fields for the profile 
• Profile edit URL: Configuration path for profile modifications 
• Profile edit options: 
• Allow complete modification 
• Allow only password modification 
• Disable profile modifications 
• Redirect to external page

Password Management

• Password composition: Letters and numbers requirements 
• Password history: Number of previous passwords to store 
• Minimum length: Required minimum characters 
• Password expiration: Days of validity (0 = no expiration) 
• Mandatory password change: Force change at first login

User Registration

• Registration code: Code usage mode 
• Required fields: Name and Surname mandatory 
• Advanced mode: Use of advanced registration form 
• Time limit: Available hours to confirm registration 
• Registration type: Access control (Administrators only/Everyone) 
• Privacy policy: Mandatory acceptance 
• Registration code: Code activation for specific users

E-Learning

Course Configuration

• Course sorting: Display criteria in "My courses" area 
  • By Name 
  • By Company 
  • By Status 
• Home page: Initial page selection (Dashboard / Course Catalog / MyCourses) 
• Course list: Display a "Catalog" button on login page 
• Send user to catalogue if not enrolled in any course: Redirect users from "MhyCourses" to "Catalog" if not enrolled in courses

E-Commerce

• Purchase notifications: Username or ID configuration for notifications 
• Currency symbol: Monetary symbol setting (e.g., €) 
• PayPal environment: Sandbox mode for testing or real environment 
• PayPal account: Account configuration for payments 
• PayPal currency: Currency setting (e.g., EUR)

Advanced Configurations

Google Integration

• Google Analytics: Statistics tracking activation 
• Google Code: Tracking code insertion

Security Configurations

• Simultaneous access: Disabling multiple access for same username 
• IP control: IP consistency activation during session 
• Maintenance password: Password setting for maintenance mode 
• Site under maintenance: Maintenance mode activation 
• Administration session: Public session sharing with administration

API and Authentication

SSO Configuration

IMPORTANT NOTICE: Unlike Forma's standard global configurations, in multidomain, users will be authenticated based on the email field, not the username. This allows the same person to be registered on the platform with different user accounts.

You will be able to create different SSO configurations for each domain:

• SSO Password Key: Keyword for calculating the hash used in SSO
• Enable SSO with other applications through token: Checkbox to enable SSO functionality with external applications

Allowing SSO only for domain users

The plugin adds a new additional field, "Assigned Domain", to associate users to a domain. Note that:

• The dropdown list is automatically populated with the list of domains available on the platform.
• The SSO feature verifies that the user belongs to the corresponding domain, otherwise it prevents access.

Forma.LMS API

You will be able to create different configurations for API access for each domain

IMPORTANT NOTICE: Providing API access to different companies in multi-client platforms is strongly discouraged: the system is not able to filter data by domain with potential privacy risks

Authentication Method

The system supports three authentication methods:

1. Single Access Code
   • Uses a single code for all API access
   • Simple but less secure option
2. Token Generation on Each Connection (Default)
   • Generates a new token for each API session
   • More secure as tokens have limited lifespan
   • Recommended for production environments
3. Secret Key Authentication
   • Uses a permanent secret key for authentication
   • Balance between security and simplicity

API Configuration Options

• Token Lifetime (minutes): Set the duration for which tokens remain valid (default: 60 minutes)
• Single Access Code: Define a unique code for API access when using single code method
• Reset token lifetime on each connection: Checkbox to refresh token expiration time with each API call
• Secret API Code: Configuration field for secret key authentication
• API Key: Configuration field for API key authentication
• Enable API functionality: Master checkbox to activate all API features for the domain

Best Practices

Naming Convention

• Use descriptive names for profiles (e.g., "PROFILE-1") 
• Maintain consistency in nomenclature 
• Include client or project references

Template Management

• Use dedicated templates for each client 
• Test templates before activation 
• Maintain backups of custom templates

Security

• Set complex passwords for maintenance 
• Configure IP controls when necessary 
• Use sandbox environment for e-commerce testing

Troubleshooting

Domain Not Reachable

• Verify DNS configuration
• Check URL correctness in domain field 
• Verify server accessibility

Template Not Displayed

• Check template existence in system 
• Verify template file permissions 
• Verify correct template-domain association

Email Problems

• Verify mail profile configuration 
• Check SMTP parameters 
• Test email sending from configured profile