If a setting resides in both the Domino policy and the PLUGIN_CUSTOMIZATION.INI file, the Domino policy value takes precedence. As well, if a setting is changed using the Widgets preferences panel, that setting takes precedence for the duration of the active session.

The following list corresponds to either a policy name from the Widgets desktop policy settings document in the Domino Administrator or a preference from the Widgets preferences panel with an equivalent Eclipse preference in the PLUGIN_CUSTOMIZATION.INI file.

Note The default PLUGIN_CUSTOMIZATION.INI file is provided in the Notes install kit in the deploy subdirectory. The file path of the installed PLUGIN_CUSTOMIZATION.INI file is <install_dir>\framework\rcp\ plugin_customization.ini.

The "Default out-of-box Widgets and Live Text behavior" topic describes how Widgets and Live Text appears to the Notes user when no policy or preference changes are made.

Note If the following four parameters are set in the PLUGIN_CUSTOMIZATION.INI file, the local catalog replica is created from the specified catalog shortly after client application startup.

• Catalog server

  This setting specifies the catalog server from which to provision at client application startup and periodically during replication from the catalog to the user's local replica (24 hours by default).

  com.ibm.rcp.toolbox.admin/toolboxCatalogServer

  Example:

  com.ibm.rcp.toolbox.admin/toolboxCatalogServer=<server_name>.myserver.mycompany.com

  Note Using this setting does not prevent the user from changing the catalog server name in the Widgets preferences panel. This corresponds to the "Widget catalog server" policy and the "Catalog server" preference on the Widgets preferences panel.

  The preference default is blank.

• Catalog name

  This setting specifies the catalog application name, on the catalog server, from which to provision at client application startup and periodically during replication from the catalog to the user's local replica. The catalog is created using the Domino server-supplied Widget Catalog template (TOOLBOX.NTF).

  com.ibm.rcp.toolbox.admin/toolboxCatalogDBName=<name>.nsf

  Example:

  com.ibm.rcp.toolbox.admin/toolboxCatalogDBName=toolbox.nsf

  Using this setting does not prevent the user from changing the catalog name in the Widgets preferences panel. This corresponds to the "Widget catalog application name" policy and the "Catalog name" preference on the Widgets preferences panel.

  The preference default is blank.

• Local catalog replica name

  This setting specifies the local replica catalog name and enables creation of the required local catalog replica on the user's client system. The name specified should match that of the catalog application on the server, for example TOOLBOX.NSF. The Widgets and Live Text functionality requires the local catalog replica.

  com.ibm.rcp.toolbox.admin/toolboxCatalogLocalDBName=<name>.nsf

  Example:

  com.ibm.rcp.toolbox.admin/toolboxCatalogLocalDBName=toolbox.nsf

  Note If you are using a catalog and are not using Domino policy, you must specify a local catalog replica name using the setting.

  Note There is no corresponding setting in the Widgets desktop policy settings document and there is no setting on the Widgets preferences panel that allows the user to control this value.

  The preference default is blank.

• Widget categories to install

  This setting enables you to list the widget categories from which to provision at client application startup and periodically during replication from the catalog to the user's local replica (24 hours by default).

  com.ibm.rcp.toolbox.admin/catalogCategoriesToInstall

  Example:

  com.ibm.rcp.toolbox.admin/catalogCategoriesToInstall=<ABXID>,<Team1>

  Note Using this setting does not prevent the user from adding or removing categories in the Widgets preferences panel. This corresponds to the "Widget catalog categories to install" policy and the "Categories to install" preference on the Widgets preferences panel.

  The preference default is blank, meaning no categories are selected in the Widgets preferences panel.

• Show Widget Toolbar and the My Widgets Sidebar panel

  This setting specifies whether the "Show Widget Toolbar and the My Widgets Sidebar Panel" preference is enabled (checked) by default. The preference default is false, such that the option is not checked on the Widgets preferences panel. If the user enables "Show Widget Toolbar and the My Widgets Sidebar panel" on the Widgets preferences panel, she can see the three Widgets toolbar buttons, the Tools - Widgets menu options, and the My Widgets sidebar panel.

  com.ibm.rcp.toolbox.admin/toolboxvisibleChild

  Options are =true and =false.

  The preference default is true, but you will see that in your installer's plugin_customization.ini file, this preference is already set as below:

  com.ibm.rcp.toolbox.admin/toolboxvisibleChild=false

• Enable the display of Live Text in the Notes document

  This corresponds to the "Enable Live Text" policy setting.

  If this setting is disabled, then the Live Text preference panel is hidden from the user.

  com.ibm.rcp.toolbox.admin/toolboxenableRecognizers

  Options are =true and =false. The preference default is true.

• Enable Default Recognizers

  Specify if the Lotus-supplied, advanced Live Text recognizers such as person (name), place (address), and organization are enabled.

  If this setting is disabled, then the user cannot enable it.

  This corresponds to the "Enable Default Recognizers" policy setting.

  com.ibm.rcp.toolbox.admin/toolboxEnableDefaultRecognizers

  Options are =true and =false. The preference default is true.

• Restrict widget creation and edit to specific types (provider IDs)

  Restrict creation and edit of widgets to certain types (referred to as provider IDs). This corresponds to the "Restrict the addition of widgets to specific types" policy setting.

  The Widgets and Live Text feature includes an extension point for widget providers. The supplied providers are Notes view, Feeds, Web page or service, and Google Gadget™.

  If this setting is disabled, the user can create or edit widgets with no restriction on type.

  If this setting is enabled, the user can only create or edit widgets of a certain type. The administrator can then specify which widget types (provider IDs) are available using the setting below.

  com.ibm.rcp.toolbox.admin/createTool

  Options are =true and =false. The preference default is false.

  If enabled you can then specify which widget types (provider IDs) are available for creation or edit using the setting below, which corresponds to the "Enable provider IDs for widget addition" policy setting.

  com.ibm.rcp.toolbox.admin/createToolProviderIDs

  Specify the widget types available for creation and edit. Use a comma to separate types in the list. The available widget type/Provider ID entries are as below and correlate to the Notes view, Web page or service, Feeds, and Google Gadget widget types.

  com.ibm.notes.toolbox.provider.NotesViewPalleteProvider

  com.ibm.notes.toolbox.provider.NotesFormPalleteProvider

  com.ibm.rcp.toolbox.web.provider.WebServicesPalleteProvider

  com.ibm.rcp.toolbox.feeds.FeedPalleteProvider

  com.ibm.rcp.toolbox.google.provider.internal.GooglePalleteProvider

  com.ibm.rcp.toolbox.prov.provider.ToolboxProvisioning

  com.ibm.rcp.toolbox.search.provider.SearchPalleteProvider

  The default is as below:

  com.ibm.rcp.toolbox.google.provider.internal.GooglePalleteProvider,com.ibm.rcp.toolbox.web.provider.WebServicesPalleteProvider,com.ibm.rcp.toolbox.feeds.FeedPalleteProvider,com.ibm.notes.toolbox.provider.NotesViewPalleteProvider,com.ibm.rcp.toolbox.prov.provider.ToolboxProvisioning,com.ibm.notes.toolbox.provider.NotesFormPalleteProvider,com.ibm.rcp.toolbox.search.provider.SearchPalleteProvider

  For example, if the setting is as below, the user could only create Google Gadget widget types:

  com.ibm.rcp.toolbox.google.provider.internal.GooglePalleteProvider

• Restrict the installation of widgets to specific widget types (provider IDs)

  Restrict installation and update of widgets to specific types (referred to as provider IDs). This corresponds to the Restrict provider IDs for installation/execution policy.

  Options are =true and =false. The preference default is false.

  If enabled, the administrator can then specify the widget types (provider IDs) available for install and update using the setting below, which corresponds to the Enable provider IDs for installation/execution policy. Use a comma to separate types in the list.

  com.ibm.rcp.toolbox.admin/toolboxinstallProviderIDs

  The available widget type/Provider ID entries are as below and correlate to the Notes view, Web page or service, Feeds, and Google Gadget widget types.

  com.ibm.notes.toolbox.provider.NotesViewPalleteProvider

  com.ibm.notes.toolbox.provider.NotesFormPalleteProvider

  com.ibm.rcp.toolbox.web.provider.WebServicesPalleteProvider

  com.ibm.rcp.toolbox.feeds.FeedPalleteProvider

  com.ibm.rcp.toolbox.google.provider.internal.GooglePalleteProvider

  com.ibm.rcp.toolbox.prov.provider.ToolboxProvisioning

  com.ibm.rcp.toolbox.search.provider.SearchPalleteProvider

  The default is as below:

  com.ibm.rcp.toolbox.google.provider.internal.GooglePalleteProvider,com.ibm.rcp.toolbox.web.provider.WebServicesPalleteProvider,com.ibm.rcp.toolbox.feeds.FeedPalleteProvider,com.ibm.notes.toolbox.provider.NotesViewPalleteProvider,com.ibm.rcp.toolbox.prov.provider.ToolboxProvisioning,com.ibm.notes.toolbox.provider.NotesFormPalleteProvider,com.ibm.rcp.toolbox.search.provider.SearchPalleteProvider

  For example, if the setting is as below, the user could only install or provision Google Gadget widget types:

  com.ibm.rcp.toolbox.google.provider.internal.GooglePalleteProvider

  For example, to restrict the user such that they can only install Notes view-type widgets (from a non-catalog source), add the following entries:

  com.ibm.rcp.toolbox.admin/toolboxrestrictProviderIDs

  com.ibm.rcp.toolbox.admin/toolboxinstallProviderIDs

  com.ibm.notes.toolbox.provider.NotesViewPalleteProvider

• Enable create, remove, and edit actions

  Specify whether the user can create, edit, and remove actions while working in the My Widgets sidebar panel and the Widget Management view. This corresponds to the "Create and manage an action" policy setting. If enabled, the user can perform those tasks.

  com.ibm.rcp.toolbox.admin/toolboxcreateAction

  Options are =true and =false. The preference default is true.

• Enable create, remove, or edit recognizers and content types and can use the "Manage Actions, Content, and Recognizers" option

  Specify whether the user can create, edit, and remove recognizers and content types while working in the My Widgets sidebar panel. If enabled, the user can create, remove, or edit recognizers and content types and can use the "Manage Actions, Content, and Recognizers" My Widgets option. This also enables display of the "Recognize All Content" option in the My Widgets menu and the "Display <type> properties" action when right-clicking on a content type in a Notes document. This corresponds to the "Create and manage recognizers and content types" policy setting.

  This also enables display of the "Recognize all Content" in the My Widgets options menu and the "Display <type> properties" action when right-clicking in a Notes document.

  com.ibm.rcp.toolbox.admin/toolboxcreateRecognizer

  Options are =true and =false. The preference default is true.

• Enable the ability to send widgets using e-mail

  Specify whether the user can send widgets to others and output an XML file containing selected widgets from the My Widgets sidebar panel. This corresponds to the "Send widgets using e-mail" policy setting.

  If enabled, the user can send widgets to others as XML extension attachments using the "E-mail to" action and also output an XML extension containing selected widgets in the My Widgets sidebar panel using the "Export" menu option.

  com.ibm.rcp.toolbox.admin/toolboxsendAsEmail

  Options are =true and =false. The preference default is true.

• Enable the ability to install widgets from e-mail or other non-catalog means

  Specify whether a user can install widgets using an XML extension file obtained from e-mail or from the user's file system. If enabled, the user can use drag and drop to install widgets from e-mail (or any Notes document that contains an attached EXTENSION.XML file, not including the configured catalog) or an import action from the user's file system. This corresponds to the "Install widgets from e-mail or other" policy setting.

  If enabled, the user can drag and drop to add widgets from e-mail (or any Notes document that contains an attached EXTENSION.XML file, not including the catalog) or use the "Import" menu option.

  com.ibm.rcp.toolbox.admin/toolboxinstallFromOther

  Options are =true and =false. The preference default is true.

• Enable the ability to install widgets from the catalog and to browse the catalog from the My Widgets sidebar panel

  Specify whether a user can browse the configured catalog and select widgets to install to the My Widgets sidebar panel or sidebar. This corresponds to the "Install widgets from catalog" policy setting.

  If enabled, the user can select a widget from the catalog and drag and drop the widget's XML extension attachment to their My Widgets sidebar panel. They can also select additional categories to be provisioned with (in addition to those listed in the "Widget catalog categories to install" policy) using their Widgets preferences panel.

  com.ibm.rcp.toolbox.admin/toolboxinstallFromCatalog

  Options are =true and =false. The preference default is true.

• Enable ability to publish widgets from the My Widgets sidebar panel to the catalog

  Grant access to the user, typically the power user or application developer user, to publish widgets from their My Widgets sidebar panel to the catalog for use by others. This corresponds to the "Publish to catalog so others can browse" policy setting.

  You must have edit rights to the catalog to publish to it.

  com.ibm.rcp.toolbox.admin/toolboxpublishToCatalog

  Options are =true and =false. The preference default is true.

• Restrict installation to specific extension point types

  Restrict installation of widgets that contain certain extension points. This corresponds to the "Restrict extension point IDs for installation/execution" policy setting.

  com.ibm.rcp.toolbox.admin/toolboxspecifyExtPtIDs

  Options are =true and =false. The preference default is false.

  Note Extension points are an Eclipse feature. They define new function points for the platform that other plug-ins can plug into. Eclipse provides many extension points with the core platform. The Widgets and Live Text feature also provides some extension points. For example:

  
  The Eclipse platform provides the following identifiers, and many others:

  org.eclipse.ui.popupMenus, org.eclipse.ui.viewActions, org.eclipse.ui.views identifiers

  Notes and Expeditor provide the following identifiers, and many others:

  com.ibm.rcp.ui.shelfViews, com.ibm.rcp.textanalyzer2.Dictionaries, com.ibm.rcp.search.engines.searchEngines, com.ibm.rcp.search.ui.searchBarSets, com.ibm.rcp.content.contentTypes, com.ibm.rcp.annotation.regex.regexTypes

  
  If "toolboxspecifyExtPtIDs" is set to true, the administrator can then specify which extension point IDs are allowed using an additional entry in the INI file.

  com.ibm.rcp.toolbox.admin/toolboxdynamicExtPtIDs

  This corresponds to the "Enable extension point IDs for installation/execution" policy setting.

  By default, this setting is disabled.

  The default is as below:

  com.ibm.rcp.toolbox.admin/toolboxdynamicExtPtIDs= org.eclipse.ui.popupMenus,com.ibm.rcp.content.contentTypes,com.ibm.rcp.annotation.regex.regexTypes,com.ibm.rcp.ui.shelfViews,org.eclipse.ui.views,org.eclipse.ui.viewActions,com.ibm.rcp.textanalyzer2.Dictionaries,com.ibm.rcp.search.engines.searchEngines,com.ibm.rcp.search.ui.searchBarSets

  For example, the following settings specify that widgets containing regular expression recognizers cannot be installed or provisioned:

  com.ibm.rcp.toolbox.admin/specifyExtPtIDs=com.ibm.rcp.content.contentTypes,com.ibm.rcp.annotation.regex.regexTypes

Installing the Widgets and Live Text feature
Default out-of-box Widgets and Live Text behavior
Understanding Widgets and Live Text user types
Using a widget to deploy a client plug-in
Deploying client plug-ins with widgets and the widget catalog
Controlling Widgets and Live Text access using Domino policy
Using widgets in Lotus iNotes

Glossary