soEditor

The soEditor format now supports both the soEditor Lite and soEditor Pro WYSIWYG HTML editors available from SiteObjects. Using this format, you can edit content visually using an online form. You will need to license and download soEditor separately — This format simply integrates it with the TerraForm environment. Please check the soEditor Documentation Center for more detail.

The following special attribute is available for soEditor:

• version
  Optional (defaults to "Lite"). If you are using soEditor Pro, set this to "pro". Ideally, add it as a preset in your settings folder as follows: locate presets.cfm inside your TerraForm settings folder and add the following line between cfscript tags:

  Preset("format_soEditor", "version", "Pro");

The full range of soEditor attributes is available, with some exceptions listed below. Check the soEditor Documentation Center for a list of soEditor attributes.

Since format is already a reserved TerraField attribute, you cannot use the format soEditor attribute. Instead, use soEditor_Format.

You do not need the form, field, scriptpath or attributes as they are generated for you by TerraForm.

Installation

1. soEditor must be downloaded separately from SiteObjects.com.
2. Depending on the version you have downloaded, Copy the \lite\ or \pro\ folder from your soEditor download so that it is visible at the web path: [ResourcePath]/formats/siteobjects/soeditor/lite/ or [ResourcePath]/formats/siteobjects/soeditor/pro/. The value of [ResourcePath] is by default: /terraformresources/.
3. Copy the file soeditor_lite.cfm or soeditor_pro.cfm included in that download to this address: [customtags]/terraform/formats/includes/soeditor/. Notes:
   • You will see a file called soeditor.cfm in [customtags]/terraform/formats/includes/. Leave that file as is!
   • You will also see files called soeditor_lite.cfm and soeditor_pro.cfm in [customtags]/terraform/formats/includes/soeditor/. Copy your downloaded soeditor_lite.cfm or soeditor_pro.cfm over the top of these files!

Examples

<cf_terrafield
  name="MysoEditorField1"
  caption="Body content"
  format="soEditor"
  datatype="sqVarChar (4000)"
  required="true"
  width="500px"
  height="300px"
  InitialFocus="yes"
  BaseBGColor="##eeeeee"
/>