Hiding preference pages

Preference pages can be hidden from all users, or only from users with specified roles. It is accomplished with Eclipse activities, which are groupings of Eclipse plugin contributions that can be enabled or disabled in plugin manifests, or by programming.

About this task

If the activity is disabled, any extensions whose id matches the pattern will be suppressed.

Hiding preference pages from a role involves one of these actions:

If one or more activitySets are to be entirely hidden, redefining the role to include fewer activitySets
If an activity is to be disabled for all roles, redefining an existing activitySet to contain fewer activities
If an activity is to be disabled for one role, defining a new activitySet and redefining the role to include the new activitySet instead of the old one

You provide new activitySet and role definitions in the plugin.xml of a custom plugin you supply. You redefine a role or activitySet by using the Sales Center configurator service to replace an old definition with a new one.

For example, all Sales Center preference pages can be hidden from all users except Site Administrators by redefining the activitySet com.ibm.commerce.telesales.activitySet.basePreferencePages to be empty, and the activitySet com.ibm.commerce.telesales.activitySet.adminPreferencePages to contain all preference pages.


<extension point="com.ibm.commerce.telesales.configurator">
    <configurator path="."/>
</extension>
<extension point="com.ibm.commerce.telesales.activitySets">
    <activitySet id="MyPlugin.basePreferencePages" label="Empty
base set">
    </activitySet>
    <activitySet id="MyPlugin.adminPreferencePages" label="Admin
set">
      <activity
activityId="com.ibm.commerce.telesales.telesalesPreferencePageActivity"/>
      <activity
activityId="com.ibm.commerce.telesales.customerPreferencePageActivity"/>
      <activity
activityId="com.ibm.commerce.telesales.ordersPreferencePageActivity"/>
      <activity
activityId="com.ibm.commerce.telesales.storesPreferencePageActivity"/>
      <activity
activityId="com.ibm.commerce.telesales.autologonPreferencePageActivity"/>
      <activity 
            
activityId="com.ibm.commerce.telesales.communicationPreferencePageActivity"/>
      <activity 
    
activityId="com.ibm.commerce.telesales.productImagesPreferencePageActivity"/>
      <activity
activityId="com.ibm.commerce.telesales.osgiAgentPreferencePageActivity"/>
      <activity 
            
activityId="com.ibm.commerce.telesales.installUpdatePreferencePageActivity"/>
    </activitySet>
</extension>