4.18.1 Configure Web Extensions
With SwyxIt! A web extension allows you to integrate a website or a web application (e.g. Swyx VisualGroups) into SwyxIt! Display the home page.
 
To be used as a web extension, the web application in question must support inline frame technology.
 
You can preconfigure your web extensions for various purposes. You can find instructions for this at:
In Swyx Control Center, create the Web Extension object with the appropriate configuration settings and assign it to the desired users or groups.
To see which Web Extensions are associated with a specific user, visit 9.23 Edit the user's web extensions.
 
If you are using SwyxIt! via RemoteConnector, you must add an entry in the special configuration file for each Web Extension that is not accessible from the public network, see 4.13.1 Access Web Extensions via RemoteConnector.
 
Ad formats for Web Extensions
For each web extension, you can specify in the "displayTypes" line: how and when it should be displayed in SwyxIt!. In the Web Extension configuration, set the desired parameters:
Parameter
Explanation
static
The web extension is displayed to the assigned user in a static pane on the right. The user cannot hide this window pane in SwyxIt!.
navigation
The Web Extension icon appears in SwyxIt! menu bar.
The user can show or hide the static window pane using the menu.
widget
Users can configure this web extension as a SwyxIt! widget any way they wish.
In the "widgetHeight" line, you specify the default height of the widget. The user can override this value in their widget configuration.
The following example line enables all three display modes:
"displayTypes": ["widget", "navigation", "static"],
 
If "displayType" is not specified, "Widget" is used by default.
 
 
Changes to a Web Extension's configuration take effect only after restarting SwyxIt!
 
How to create a web extension
1 In the menu, select General Settings | Client Settings.
2 Click on Web Extensions.
3 Click on Create.
*The "Create Web Extension" configuration wizard appears.
Label
Explanation
Name
Give the web extension a unique name. This name will be displayed in SwyxIt!
Description
If necessary, enter a brief description of the web extension.
Configuration (JSON)
Enter the Web Extension parameters in JSON format.
See the Configuration Reference section at:
4 Click on Next.
*A list of all Swyx user groups appears.
5 If necessary, filter by group name in the search field.
6 Select the group you want with a single click. If necessary, hold down the Ctrl key to select multiple individual groups.
7 Click on .
*The web extension is assigned to the selected group(s).
8 Click on Next.
*A list of all Swyx users appears.
9 If necessary, filter by username in the search field.
10 Select the desired user with a single click. If necessary, hold down the Ctrl key to select multiple users.
11 Click on .
*The web extension is assigned to the selected user(s).
12 Click on Create.
*The web extension has been created and assigned to the selected groups or users.
 
Click to assign everything in the current list, or to unassign them.
 
To edit a web extension
1 In the menu, select General Settings | Client Settings.
2 Click on Web Extensions.
*A list of the configured Web Extensions appears.
3 Click on the row of the web extension you want to edit at .
*The "Edit Web Extension" configuration wizard appears.
4 See How to create a web extension, starting with step (3).
To delete a web extension
1 In the menu, select General Settings | Client Settings.
2 Click on Web Extensions.
*A list of the configured Web Extensions appears.
3 Click in the row of the web extension you want to delete.
*The web extension will be deleted.
 
If a user is currently using the deleted web extension, it will remain visible until the user restarts SwyxIt!
The message Unknown Web Extension will then appear in the corresponding widget.