Updating the plugin.xml Configuration File

The standard plugin.xml configuration file delivered with the CentraSite kit contains all of the names of the CentraSite Control extension points, including the extension point for the Welcome page. You must update this file to contain the definition of the customized Welcome page. The configuration file is located in the folder <RuntimeDir>\workspace\webapps\PluggableUI\CentraSiteControl.

There are two elements in the standard plugin.xml file that refer to the Welcome page. The first part defines the name of the extension point to be used for the Welcome page, and looks like this:

The second part defines the Java class that implements the Welcome page, and looks like this:

<extension
point="com.centrasite.control.welcomePage"
id="welcomePage"
class="com.centrasite.control.ext.welcome.standard.WelcomePage">
</extension>

The point attribute of the extension element in the second part must match the name given by the id attribute of the plugin element (usually in the first line in the plugin.xml file) concatenated with a dot and the id attribute of the extension-point element in the first part. For example, if the id attribute of the plugin element is "com.centrasite.control" and the id attribute of the extension-point element is "welcomePage", then the value of point attribute of the extension element must be "com.centrasite.control.welcomePage".

The Java class identified by the class attribute of the extension element must implement the interface IWelcomePage.

To use your customized Welcome page instead of the standard Welcome page, set the class attribute to your customized Java class that implements the interface IWelcomePage.

For general information about plugin.xml, see Installing and Uninstalling Plug-Ins.

The changes that you make in plugin.xml take effect the next time Software AG Runtime is started.

Note:

Instead of overwriting the standard element in plugin.xml, you might want to retain a copy of the original element and comment it out. This means that you can revert easily to the original Welcome page if required, by commenting out your customized element and uncommenting the original element.