Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

...

The modes currently available to uPortal portlets are those enumerated by the JSR-168 specification. More explicitly, these modes are:

  • VIEW
  • EDIT
  • CONFIG (custom portlet mode)
  • HELP

Using Edit Mode

Edit mode is often used to display a configuration screen to users of your portlet. If you pursue this strategy, you may also wish to use the PortletPreferences API to record the configuration options your users select. To accomplish this, make the configuration form POST to an action URL and modify the preferences during the ActionRequest.

If you wish to render an 'edit' link or button to help your users navigate to the edit mode of your portlet, read the section below.

Using Config Mode

Config mode is a custom uPortal mode used to display an administrative configuration screen appropriate for configuring all instances of a particular portlet definition. For example, the Google Maps portlet distributed with uPortal uses Config mode to allow an administrator to set a Google API key.

Config mode is only accessible via the portlet administration tool; you will never need to write code to explicitly enter config mode. Once configuration is complete, you should set the portlet mode back to View.

Switching between portlet modes

...