To use content modules in your site design you have to do the following:

1. In your HTML-Head section (typically in your outer layout) you have to include the module "htmlhead-includes" from the cm-plugin.
2. Inside the TML that renders your content type add an include of "modules:render" from the cm-plugin.

HTML-Includes

Add the following line to the HTML-Head section of your outer layout:

The included TML module ensures that all CSS and JavaScripts necessary to run the content modules from the cm-plugin are available to your site.

Include the module renderer from cm-modules plugin

Inside the TML that renders your content type add one or more includes of "modules:render" from the cm-modules plugin:

The option o_sections specifies a "content section". You may define more than one content sections and allow different content modules for each section. F. e. you may have a section "content" just below any other content items of the content type and a second section for the teaser elements of the site.

Example:

The names of the sections are up to the designer. They are referred in the definitions of the allowed modules described later.

There is however a default section name of "content". This means if you want to include the module renderer for a section of name "content" the o_section option may be omitted:

Define the allowed content modules for a section

In addition to option "section" the TML module "modules:render" accepts options "modules" and "exclude-modules". Use this options to defined the allowed and disallowed modules for a section:

Option "modules":

This option is a comma separated list of module IDs that are allowed in this section. If you omit this option all available modules are allowed in this section.

Example:

In this example only the modules cm_rtf (Rich text module) and cm_horrizontal_line (horizontal line) are allowed.

Option "exclude-modules":

If you want to allow all modules except some of them you can use this option to define only the module IDs that sould be excluded from the allowed module list.

Example:

In this example the author can use any module except the google maps module.

The option "exclude-modules" is ignored if you have specified a "modules" option.

How to find the IDs of available modules:

The list of all registered modules and its IDs depends on your OpenWGA installation and can be looked up in the OpenWGA Admin Client in section "plugins / content modules".

One of the most used content module is the RTF module.

Typically you want to define RTF options to be used by this module in the same way as you define RTF options in normal RTF items.

This can be done by specifying an option "rtf-editor-styles" in the include of modules:render:

Some CM modules need global configuration before they work. This mostly is the case for modules which retrieve data from a special type of app, like forums, image gallerys etc. In this configuration you configure what apps should be used by those modules.

The global module configuration is done on OpenWGA admin client. Navigate in the menu to "Plugins > Content Modules". Below a list of all installed modules you see the global module configurations, showing all modules which can be configured:

Click a module to bring up the individual configuration:

This example is from the "forums" module. It receives the database keys of forum apps installed on the server. 

When using a "forums" module somewhere in content management  it will retrieve the global configuration as options for the source app selection in its individual config:

If you want to use your own content modules you have to "register" those modules. Each module is defined through a JSON object of the following format:

Here is a complete reference of available properties:

Each JSON module definition JSON needs to be placed into a separate WebTML module of custom location and name. To finally register those modules with OpenWGA you need to call the following method:

Again use the Design References form of your WebTML module names as parameter for this call. You should place this call into the connect script of your design so the module will be immediately available after an app with that design gets connected.

Using items in render TML

If your module uses its own items to put out content you need to "scope" the item names that you use. As multiple modules use the same content document to store their individual items they may not use plain item names. The WebTML scoping functionality puts a generated suffix on each of your items so they do not "collide" with the items of other modules. Just use the "scoped"-function everywhere you refer to your item name:

That way a page may also choose to use the same module multiple times. As every module uses a different scope suffix they have all individual items.

Creating a settings TML

The settings TML is a WebTML module which is used in the module editor in content manager to configure your module. You can fill it with <tml:input> tags which create controls for the configuration. The names of the inputs also need to be scoped:

The fields in the settings of a module are available to the render TML by using the built-in TMLScript methods CMM.setting() or CMM.settingList(). Those methods takes the name of the setting field, this time without the scope: