Quantcast
   
Titan CMS online support, find help and get answers

How to configure the toolbars in the Freeform editor

  • Published: August 04, 2008
  • |
  • Updated: October 13, 2008
  • |
  • Version: 13
 Summary

The Titan CMS Freeform Block is capable of many standard WYSIWYG editor options, some of which have been disabled in the default configuration of the editor. This article describes how to modify the source code that controls the Freeform editor utilities, in order to enable or disable standard functionality.

 Background

WYSIWYG ToolBar Sets

The WYSIWYG editor's toolbar is highly configurable, and has been extended to create customized ToolBar Sets to enable unique functionality for the various Blocks in Titan CMS.  By editing the configuration file and modifing items in the "FCKConfig.ToolbarSets" configuration entry you can add and remove available features to a specific toolbar.

ToolBar Bands

Every ToolBarSet is composed of a series of "toolbar bands" that are grouped in the final toolbar layout. The band items move together on new rows when resizing the editor.

As you can see in the toolbarsets definition, every toolbar band is defined as a separated JavaScript array of strings. Every string corresponds to an available toolbar item defined in the editor code or in a plugin. If the toolbar item doesn't exist, a message is displayed when loading the editor.

You can also include a separator in the toolbar band by including the "-" string on it.

Titan ToolBar Sets

Titan CMS utilizes the WYSIWYG editor in several content blocks. Modifying the appropriate ToolBar Set in the configuration file can affect the functionality available as follows:

Default / DefaultLite
This ToolBar Set defines the functionality enabled for the Freeform Block in the standard and Lite interfaces.

FAQAnswer / FAQAnswerLite
This ToolBar Set defines the functionality enabled for the Answer editor of the FAQ Block in the standard and Lite interfaces.

FAQQuestion / FAQQuestionLite
This ToolBar Set defines the functionality enabled for the Question Editor of the FAQ Block in the standard and Lite interfaces.

Forms / FormsLite
This ToolBar Set defines the functionality enabled for the Form Editor Block in the standard and Lite interfaces.

Minimal / MinimalLite
This ToolBar Set defines the functionality enabled for the Event Description editor on Event content items in the standard and Lite interfaces.

Minimal_NoCmsExtensions / Minimal_NoCmsExtensionsLite
This ToolBar Set defines the functionality enabled for WYSIWYG editors integrated into Structured Data editors or Custom Property fields in the standard and Lite interfaces (e.g. the Event Description editor for Events). The "NoCmsExtensions" qualifier in the name means that features integrated with Titan CMS, like Link Manager, Image Manager, Form Controls, and Commenting Form controls, are not enabled.

Commenting
This ToolBar set defines the functionality enabled for the Commenting and Rating Form builder found in Titan Administration.

 Instructions

Important: Before modifying any source code, make a backup of the affected files so that they can be restored in the event that the changes made affect the proper behavior of the block. This article describes changes that should be made to the following files:

Wkst\ContentMgmt\Blocks\Freeform_FCK\Support\fckconfig.js

Here is a sample of how a toolbar definition is structured. Modify this code to include/exclude the desired functionality.

FCKConfig.ToolbarSets["Default"] = [
['Source','-','NewPage','Templates'],
['Cut','Copy','Paste','PasteText','PasteWord'],
['Undo','Redo','-','SelectAll','RemoveFormat'],
'/',
['Bold','Italic','Underline','StrikeThrough','-','Subscript','Superscript'],
['OrderedList','UnorderedList','-','Outdent','Indent','Blockquote'],
['JustifyLeft','JustifyCenter','JustifyRight','JustifyFull'],
['Titan_Links','Unlink','Titan_Images'],
['Flash','Table','Rule','Smiley','SpecialChar'],
['TextColor','BGColor'], ['FitWindow','ShowBlocks'],
'/',
['Style','FontFormat','FontName','FontSize'] ] ;

Numerous ToolBar Sets have been defined for various uses within Titan CMS, and each one can be configured independently. In the full list of ToolBar Sets below, you will notice that ToolBar Sets have been defined for the Titan CMS Lite interface, providing flexibility in the configuration for novice users. The list of ToolBar Sets is as follows:

  • Default
  • DefaultLite
  • FAQAnswer
  • FAQAnswerLite
  • FAQQuestion
  • FAQQuestionLite
  • Forms
  • FormsLite
  • Minimal
  • MinimalLite
  • Minimal_NoCmsExtensions
  • Minimal_NoCmsExtensionsLite
  • Commenting