Liferay 7.0-ce-b4

com.liferay.portal.kernel.editor.configuration
Interface EditorConfigContributor

All Known Implementing Classes:
BaseEditorConfigContributor

public interface EditorConfigContributor

Provides an interface for setting the editor's configuration. Editor options can be set using EditorOptionsContributor.

Implementations of this interface are typically specific to a particular editor, since the configuration JSON object updated here can differ from those of other editors.

Implementations of this class must be OSGi components that are registered in the OSGi Registry.

The configuration can be targeted to specific editors, based on three criteria: portlet name, editor config key, and editor name. These criteria can be defined as OSGi properties with the following names:

In case there's more than one configuration, they're prioritized by the following criteria combinations (the lower the criteria's number, the higher it's prioritized):

  1. portlet name, editor config key, editor name
  2. portlet name, editor config key
  3. editor config key, editor name
  4. portlet name, editor name
  5. editor config key
  6. portlet name
  7. editor name
  8. empty

If there are multiple configurations with the same criteria elements, they're prioritized by service rank.


Method Summary
 void populateConfigJSONObject(JSONObject jsonObject, Map<String,Object> inputEditorTaglibAttributes, ThemeDisplay themeDisplay, RequestBackedPortletURLFactory requestBackedPortletURLFactory)
          Updates the original configuration JSON object with some new configuration.
 

Method Detail

populateConfigJSONObject

void populateConfigJSONObject(JSONObject jsonObject,
                              Map<String,Object> inputEditorTaglibAttributes,
                              ThemeDisplay themeDisplay,
                              RequestBackedPortletURLFactory requestBackedPortletURLFactory)
Updates the original configuration JSON object with some new configuration. It can even update or delete the original configuration, or any other configuration introduced by any other EditorConfigContributor.

The configuration object contains the configuration to be directly used by the editor. The configuration JSON object might, therefore, differ from other editors.

Parameters:
jsonObject - the original JSON object composed of the entire configuration set by EditorConfigContributor modules
inputEditorTaglibAttributes - the attributes specified to the input taglib tag that renders the editor
themeDisplay - the theme display

Liferay 7.0-ce-b4