Aloha Editor Gentics CMS Plugins

Plugin configuration guide for Aloha Editor >= 0.10 and newer

1 Plugin Names

Plugin names have changed be much more compact, and are now organized in plugin bundles. Therefore you need to change your Aloha Editor configuration if you’re switching from 0.9.3. Please have a look at the common bundle and the extra bundle to learn their new names. Common bundles will be actively maintained and kept up to date with Aloha Editor’s core, whilst the extra bundle might not always be most up to date.

2 Configure list of loaded plugins

With the following setting, the global plugin list can be configured. The example seen below will show you how to extend the default set of enabled plugins:

conf/*.yml

aloha_plugins_global:
  "common/characterpicker": true # add common/characterpicker
  "extra/cite": true # add extra/cite
  "common/format": false # deactivate common/format

Please note, that by overwriting the setting aloha_plugins_global plugins array, future updates of Gentics CMS, that introduce new plugins will not automatically take effect. Therefore it is recommended to extend the array (as shown) rather than overwriting it. If the Gentics CMS integration plugin (gcn/gcn) is not contained in the list, it will automatically be added to the end.

3 Per Node Plugin List

It is also possible to configure the loaded plugins per node, using either the local ID or global ID or the name of the node. Note that this will override the plugin list defined in aloha_plugins_global, and can therefore also be used to disable a certain global plugin for a node by specifying a custom plugin list without the plugin to exclude.

Configuration per local ID, global ID and name cannot be mixed. The CMS will first look for a configuration by global ID, if that is not found, by node name and if that is not found by local ID.

conf/*.yml

# Define the Aloha Editor plugins list for Node with global ID 3D6C.bbcc391e-ae22-11e9-9f0d-00155df0382f
aloha_plugins_node:
  "3D6C.bbcc391e-ae22-11e9-9f0d-00155df0382f":
    - "common/characterpicker"
    - "extra/cite"
    - "common/format"

4 List of default Aloha Editor Plugins

  • common/format
  • common/highlighteditables
  • common/list
  • common/link
  • common/table
  • common/paste
  • common/contenthandler
  • common/commands
  • gcn/gcn-linkbrowser
  • gcn/gcn

You don’t have to specify these in your config.

You need to enable the block plugin when using the new gcn plugin. Please note that this feature might be enabled by default in future releases.

conf/*.yml

aloha_plugins_global:
	"common/block": true