WEBDEV Concepts

128 Part 4: Advanced concepts 3 Implementing the User Groupware 3.1 Adding the User Groupware to a site To implement the User Groupware in a WEBDEV site: 1. On the "Project" tab, in the "Project" group, click "User Groupware". 2.  In the description window of the current project configuration, in "User Groupware: Disabled", click "Change". 3. The User Groupware settings window allows you to enable the User Groupware and define: • The type and start mode of the User Groupware. • The type of customization. • The type of database and the location of the User Groupware data files (Standard User Groupware). • The user authentication mode (Standard User Groupware). • The use of a specific connection service (Standard User Groupware). • The BaaS mode settings. Type of User Groupware There are various types of groupware: • Standard User Groupware : The User Groupware will be integrated in its "Standard" version: the User Groupware will be associated only to your site, and the rights will be defined from the site. If this option is selected, two specific tabs are displayed: • the "Files" tab, which allows you to specify the type of database and authentication used. • the "OAuth" tab, which allows you to specify the connection services available to users. • BaaS User Groupware : This option allows you to integrate a BaaS (Backend as a Service) User Groupware and manage rights via a server. If this option is selected, two specific tabs are displayed: • the "BaaS" tab, which allows you specify the characteristics of the BaaS server, the user accounts and the URLs of the administration sites. • the "Email" tab, which allows you to customize the messages to be sent to users (registration validation or password reset emails). BaaS User Groupware: Required configuration: Two cases may occur: • If you are using a PCSCloud platform : the required elements are installed by default on your platform. Reminder: PCSCloud is a paid, turnkey solution. For more details, see PCSCloud. • If you are not using a PCSCloud platform : install the following elements: • an HFSQL server, • the reserved server, including the modules for the Mobile User Groupware (WDBaaS). Starting the User Groupware Several start modes are available: • The "Automatic start" option indicates that the User Groupware is started at the same time as the site. The User Groupware login page is started before any other page of the site. The project initialization code is executed once the login page is opened and validated. • The "Manual start (programmatically)" option allows you to define when the User Groupware should be started. The login page will only be opened if gpwOpen (or gpwLogin ) is used. This option can be used to execute the project initialization code before opening the login page. This option is useful for a multilingual project, for example: a page can be displayed to choose the language of the application.