Generic API for all WYSIWYG content editors.

Description

This module provides a generic API that can be used by any WYSIWYG editor that wants to integrate with XWiki. Besides that, it also publishes a section in the Wiki Administration to configure the default WYSIWYG content editor.

Generic API

This module provides the following APIs:

• clean HTML coming from a WYSIWYG editor
• convert between (annotated) HTML and wiki syntax
• round-trip conversion (go from annotated HTML to wiki syntax and back, which is useful if you want to render the wiki syntax rendering macros)
• an HTTP filter to convert automatically the value of specific HTTP request parameters from HTML to wiki syntax
• import content from office attachments
• a script service ($services.wysiwyg) that exposes most of the above, plus adds support for:
  • checking if a specific wiki syntax can be edited by a WYSIWYG editor
  • retrieving the HTML syntax used by the WYSIWYG editor
  • render a specific page template (the WYSIWYG editor content template)

Administration Section

The administration section allows administrators to configure the default WYSIWYG content editor, which is useful in case multiple installed extensions provide WYSIWYG content editing capability.

WYSIWYG Editor Integrations

The following WYSIWYG editor integrations are available:

• CKEditor Integration
• Realtime WYSIWYG Editor (based on CKEditor Integration)
• GWT WYSIWYG Editor (deprecated and unmaintained)

Prerequisites & Installation Instructions

We recommend using the Extension Manager to install this extension (Make sure that the text "Installable with the Extension Manager" is displayed at the top right location on this page to know if this extension can be installed with the Extension Manager).

You can also use the manual method which involves dropping the JAR file and all its dependencies into the WEB-INF/lib folder and restarting XWiki.

Dependencies

Dependencies for this extension (org.xwiki.platform:xwiki-platform-wysiwyg-api 16.10.1):

• org.xwiki.commons:xwiki-commons-xml 16.10.1
• org.xwiki.rendering:xwiki-rendering-syntax-annotatedhtml5 16.10.1
• org.xwiki.platform:xwiki-platform-oldcore 16.10.1
• org.xwiki.platform:xwiki-platform-bridge 16.10.1
• org.xwiki.platform:xwiki-platform-model-api 16.10.1
• org.xwiki.platform:xwiki-platform-container-api 16.10.1