Custom Configuration Scripts

Custom configuration scripts are javascript files that are used specifically to modify the contributor's editing area for each individual element. A configuration script can be associated with different elements, but each element must individually call the script.

The customizations affect the FCKeditor and Ephox-based elements, which are WYSIWYG, text only, and image only. Custom configuration scripts can be used to add or replace commands, toolbar buttons, and context menu items. Any part of the editor can be customized to fulfill a specific requirement.

Site Studio ships with several sample custom configuration scripts. These samples are checked into the content server with the xWebsiteObjectType metadata value of "Custom Configuration Script" when the Site Studio component is installed on the content server.

The following scripts are the included samples:

FCKeditor-Compatible Sample Scripts

• ss_fck_simple_command.js - This sample script is an example of a simple FCKeditor command. This particular example implements an FCKeditor command, toolbar button, and menu item.

• ss_fck_image_command.js - This sample script is an example of an FCKeditor command that overrides the existing "ssImage" and "Image" commands. In this example, the commands are redefined and the existing Image toolbar button and context menu items are re-used.

• ss_fck_load_multiple_commands.js - This sample script shows how to load multiple Custom Configuration Scripts.

• ss_fck_template_command.js - This sample script enables users to insert pre-defined HTML.

Ephox-Compatible Sample Scripts

• ss_ephox_sample_command.js -This sample script is an example of a simple Ephox command. This particular example implements an Ephox toolbar button.

• ss_ephox_template_command.js - This sample script enables users to insert pre-defined HTML.

For more information on the Custom Configuration Scripts in the Site Assets pane, see Custom Configuration Scripts.