Configuring widgets
Add and configure widgets on the Home, Communities, and Profiles pages.
Before you begin
Before you can add gadgets that are deployed externally, you must configure locked domains. Locking domains isolates semi-trusted gadgets and prevents them from accessing SSO tokens. Similarly, you must prevent DOM access to the parent page of the gadget iFrame because it might be used to forward sensitive data to external sites. For more information about locked domains, see the Enabling locked domains topic.
About this task
Procedure
To add a widget to the widget catalog, complete the following
steps:
- Log in to IBM Connections as an administrator.Note: To add widgets to the Home page, you must be logged in as an administrator. If you do not see an Administration option display under the My Page option in the navigation sidebar on the Home page, this means that you are not configured as an administrator of the Home page app. For more information, see the Configuring the Home page administrator topic.
- Open the Administration view.
- Click Add another widget to display the Add new widget form.
- Specify whether
you are adding a widget that is based on the iWidget specification
or the OpenSocial gadget specification.To enable users to integrate applications such as Facebook, Twitter, and LinkedIn into their IBM® Connections client experience, select OpenSocial gadget. Selecting OpenSocial gadget opens the Gadget settings with Activity stream or Share dialog subform, where you can specify the following options:
- Enter a name for the widget in the Widget Title field.
- Enter a short description of the widget in the Description field.
-
Enter the web address for the XML widget descriptor in the URL Address
field.
This address must be prefixed with HTTPS and must be an absolute web address.
-
Enter the widget location in the Secure URL Address field.
This address must be prefixed with HTTPS and must be an absolute web address.
- Enter the web address for an icon to associate with the widget in the Icon URL field. Icon URL represents the widget when it is docked in the widget palette.
- Enter the location of an icon to display for the widget
in the Icon Secure URL field.This icon is displayed when the widget is docked in the content palette.
- Select Use IBM Connections specific tags to indicate if the widget deployment descriptor uses specific IBM® Connections tags to represent the URLs of the IBM® Connections applications.
- To display the widget in the My Page view,
select Display in the My Page view.You must display the widget in the My Page view or the Updates view, or both.
- To display the widget in the Updates view,
select Display in the Updates view.You must display the widget in the My Page view or the Updates view, or both.
- To display the widget when users open the Home page for
the first time, select Opened by default.
The widget doesn't display for existing users, but it is available from the widget palette so that they can add it whenever they want.
- To enable multiple
instances of the widget to be used, select Multiple widgets.
Each widget instance has its own properties. For example, if you are using a widget that displays bookmarks for a specific tag, you can enable multiple instances of the widget so that you can follow different tags in each widget.Note: This setting is applicable only for iWidgets. Only one instance of an OpenSocial gadget can be loaded at a time.
- If there are specific IBM® Connections applications that
must be included in your deployment for the widget to function correctly,
select the required applications in the Prerequisites area.
Note: When an IBM® Connections application is selected as a prerequisite but that application is not installed, the widget is not displayed on the Home page. For gadgets that declare dependencies this way, they act as though they are disabled for the purposes of whitelisting.
- Click Save.