Uploading and Configuring Plugins
Oxygen XML Web Author includes a user-friendly Administration Page that helps you to manage plugins for the Oxygen XML Web Author.
Uploading a New Plugin
- Go to your Administration Page.
- Select Plugins.
- Click Upload Plugin and choose a plugin archive to
upload.Important: Oxygen XML Web Author does a validation check to make sure the uploaded plugin archive contains the proper extension descriptor file (plugin.xml). The archive should contain exactly one folder. Otherwise you will receive an error that the upload was denied.Note: If the upload would result in a duplicate plugin, Oxygen XML Web Author will load the latest version and report the older versions that were not loaded. You will also have the option to delete the older versions or you can ignore this and then delete the newly uploaded version to revert to an older version.
-
Click OK to upload the file.
Step Result: The plugin should appear in the list on this Plugins page. Uploaded plugins appear with a light green highlight so that you can identify them easily.
- Once you are finished with all of your changes, restart Oxygen XML Web Author.
Enabling or Disabling a Plugin
- Go to your Administration Page.
- Select Plugins.
- Click the Enable/Enabled checkbox on the right side of the particular plugin to toggle it to the desired state.
- Once you are finished with all of your changes, restart Oxygen XML Web Author.
Configuring a Plugin
- For information about configuring the Git plugin (for GitHub, GitLab, or Bitbucket), see Integrating Web Author with Git (GitHub, GitLab, Bitbucket).
- For information about configuring the WebDAV plugin, see Integrating Web Author with Your WebDAV Server.
- For information about configuring the SharePoint plugin, see Integrating Web Author with SharePoint Online.
Deleting a Plugin
- Go to your Administration Page.
- Select Plugins.
- Find the plugin you want to delete and click the Delete the plugin button on the right side of its name.
- Restart Oxygen XML Web Author to apply the changes.
Restoring an Original Built-in Plugin
- Download the All Platforms distribution.
- Unzip the downloaded archive.
- Go to [OXYGEN_WEBAUTHOR_INSTALL_DIR]/tomcat/work/Catalina/localhost/oxygen-xml-web-author/plugins.
- Create a zip archive that contains the folder for the desired plugin (only one).
- Upload it using the Uploading a New Plugin procedure above.
Configuring a License for a Plugin
A developer can specify a license for a plugin that the user will need to agree with when
installing the plugin. The license is either specified in the plugin.xml file using
the <license>
element that contains the path to the license file
relative to the plugin's root folder, or if the license entry is not specified in the
plugin.xml descriptor, the application then looks for a
LICENSE.txt or LICENSE file in the plugin's root folder.
If a license is detected, a View License button will be displayed in the bottom-right corner of the plugin's tile in the Administration Page.