| |
| |
Aside from the options you set in the page, or through the Dreamweaver or Visual Studio interfaces, there are some more settings that directly influence the behaviour of the KTML control. These settings are global for all KTML controls in your site and are stored inside the includes/ktm/ktml4.config.xxx file. (replace xxx with the extension corresponding to your particular server technology).
Depending on the server technology, the options are stored in an array, or in an XML structure, with a different syntax. Next you can find the options that can be added to the global configuration for each supported server technology. Some of the properties are not supported in the Lite version, so check each description.
You have to set these properties as elements of a configuration array inside the includes\ktm\ktml4.config.php. The settings you are interested in are near the end of the file, as the $GLOBALS['KTML4_GLOBALS'] array. Possible entries in the array and their default options are:
'allowed_tags_list =>''' - what tags are allowed to be used within the editor.
'denied_tags_list' => 'script,iframe,frame' - the tags that are not allowed in the editor. These two lists are mutually exclusive: you should only have one such list.
'add_new_paragraph_on_enter' => 'true' - this setting controls how the editor acts when the user presses the Enter / Return key. If true, a new <p> tag is added. Otherwise, a <br /> can be used.
'special_chars' => '' - the list of special characters to display in the character picker in the editor.
'fonts' => 'Arial, Helvetica, sans-serif|Times New Roman, Times, serif|Courier New, Courier, mono|Georgia, Times New Roman, Times, serif|Verdana, Arial, Helvetica, sans-serif|Geneva, Arial, Helvetica, sans-serif, - the pipe separated list of fonts that are displayed in the editor drop-down menu.
'editor_inner_dimensions' => 'false' - if set to true, the width and height you set in the page apply only to the actual editing area. If false, these are the sizes of the entire control.
Note: This option is not available for the Lite version.
'stop_parent_scroll_on_focus' => 'true' - this option determines how the control reacts when the user scrolls the mouse. If true, scrolling only affects the editing area. If false, it will scroll the parent window.
Note: This option is not available for the Lite version.
'colors' => ''> -hexadecimal codes for the colors to be displayed in the color picker. If left empty, the default web palette is displayed.
'skip_doctype_check' =>'false' - KTML does not render properly in non XHTML standard mode. By setting this option to true, KTML will no longer check the page DOCTYPE and attempt to render as if it were in standard compliant mode.
Note: This option is not available for the Lite version.
'auto_clean_on_paste'=>'word' - When pasting content into the KTML editor, several filters can be automatically ran. This option selects the filter that is ran by default. Possible values are:
word - cleans all of the tags that are added by Word
formatting - cleans all formatting tags
css - removes all CSS classes from elements
all - removes all HTML tags except the <p> blocks
none - no automatic cleaning is performed. If you want to run any of the aforementioned filters you have to do it manually, from the Clean HTML menu.
Note: This option is not available for the Lite version.
'logical_emphasis' => 'true' - Decide whether to convert <b> to <strong> and <i> to <em> or not. By default it is set to true, which means that the <b> and <i> tags are replaced with their newer equivalents. If you need to keep the old style tags, <b> and <i>, set the value for this option to false.
'online_interakt_spellcheck' => 'true' - This setting decides what spellcheck facility to use: the locally installed ASPELL library or the online spellcheck service provided by InterAKT. If you cannot install spellchecking libraries on your server, set this option to TRUE and KTML will use the web service provided by InterAKT to spellcheck the text. Otherwise, set it to FALSE and use the local ASPELL utility. For more information regarding the InterAKT spellcheck web service, check out the Configure spellchecking topic
Note: This option is not available for the Lite version..
'insertlink_prompt_for_url' => 'true' - If you prefer to add links the old style, without having a prompt where to add the URL, as shown here, set this option to false. Then, when inserting a new link, a blank hyperlink target will be created which you can edit using the property inspector. To keep the pop-up that asks for the hyperlink URL set this option to TRUE.
You have to set these properties as elements of a configuration array inside the includes\ktm\ktml4.config.asp. The settings you are interested in are near the end of the file, as the KTML4_GLOBALS array. Possible entries in the array and their default options are:
KTML4_GLOBALS("allowed_tags_list") = "" - what tags are allowed to be used within the editor.
KTML4_GLOBALS("denied_tags_list") = "script,iframe,frame" - the tags that are not allowed in the editor. These two lists are mutually exclusive: you should only have one such list.
KTML4_GLOBALS("add_new_paragraph_on_enter") = "true" - this setting controls how the editor acts when the user presses the Enter / Return key. If true, a new <p> tag is added. Otherwise, a <br /> can be used.
KTML4_GLOBALS("special_chars") = "" - the list of special characters to display in the character picker in the editor. If empty, the default special character map will be displayed.
KTML4_GLOBALS("fonts") = "Arial, Helvetica, sans-serif|Times New Roman, Times, serif|Courier New, Courier, mono|Georgia, Times New Roman, Times, serif|Verdana, Arial, Helvetica, sans-serif|Geneva, Arial, Helvetica, sans-serif" - the pipe separated list of fonts that are displayed in the editor drop-down menu.
KTML4_GLOBALS("editor_inner_dimensions") = "false" - if set to true, the width and height you set in the page apply only to the actual editing area. If false, these are the sizes of the entire control.
Note: This option is not available for the Lite version.
KTML4_GLOBALS("stop_parent_scroll_on_focus") = "true"- this option determines how the control reacts when the user scrolls the mouse. If true, scrolling only affects the editing area. If false, it will scroll the parent window.
Note: This option is not available for the Lite version.
KTML4_GLOBALS("colors") = "" - hexadecimal codes for the colors to be displayed in the color picker. If left empty, the default web palette is displayed.
KTML4_GLOBALS("skip_doctype_check") = "false" - KTML does not render properly in non XHTML standard mode. By setting this option to true, KTML will no longer check the page DOCTYPE and attempt to render as if it were in standard compliant mode.
Note: This option is not available for the Lite version.
KTML4_GLOBALS("auto_clean_on_paste")="word" - When pasting content into the KTML editor, several filters can be automatically ran. This option selects the filter that is ran by default. Possible values are:
word - cleans all of the tags that are added by Word. This is the default value.
formatting - cleans all formatting tags
css - removes all CSS classes from elements
all - removes all HTML tags except the <p> blocks
none - no automatic cleaning is performed. If you want to run any of the aforementioned filters you have to do it manually, from the Clean HTML menu.
Note: This option is not available for the Lite version.
KTML4_GLOBALS("logical_emphasis") = "true" - Decide whether to convert <b> to <strong> and <i> to <em> or not. By default it is set to true, which means that the <b> and <i> tags are replaced with their newer equivalents. If you need to keep the old style tags, <b> and <i>, set the value for this option to false.
KTML4_GLOBALS("online_interakt_spellcheck") = "true" - This setting decides what spellcheck facility to use: the locally installed ASPELL library or the online spellcheck service provided by InterAKT. If you cannot install spellchecking libraries on your server, set this option to TRUE and KTML will use the web service provided by InterAKT to spellcheck the text. Otherwise, set it to FALSE and use the local ASPELL utility. For more information regarding the InterAKT spellcheck web service, check out the Configure spellchecking topic.
Note: This option is not available for the Lite version.
KTML4_GLOBALS("insertlink_prompt_for_url") = "true" - If you prefer to add links the old style, without having a prompt where to add the URL, as shown here, set this option to false. Then, when inserting a new link, a blank hyperlink target will be created which you can edit using the property inspector. To keep the pop-up that asks for the hyperlink URL set this option to TRUE.
You have to set these properties as elements of a configuration array inside the includes\ktm\ktml4.config.cfm. The settings you are interested in are near the end of the file, as the KTML4_GLOBALS array. Possible entries in the array and their default options are:
<cfset Request.KTML4_GLOBALS["allowed_tags_list"] = ""> - what tags are allowed to be used within the editor.
<cfset Request.KTML4_GLOBALS["denied_tags_list"] = "script,iframe,frame"> - the tags that are not allowed in the editor. These two lists are mutually exclusive: you should only have one such list.
<cfset Request.KTML4_GLOBALS["add_new_paragraph_on_enter"] = "true"> - this setting controls how the editor acts when the user presses the Enter / Return key. If true, a new <p> tag is added. Otherwise, a <br /> can be used.
<cfset Request.KTML4_GLOBALS["special_chars"] = ""> - the list of special characters to display in the character picker in the editor. If empty, the default special character map will be displayed.
<cfset Request.KTML4_GLOBALS["fonts"] = "Arial, Helvetica, sans-serif|Times New Roman, Times, serif|Courier New, Courier, mono|Georgia, Times New Roman, Times, serif|Verdana, Arial, Helvetica, sans-serif|Geneva, Arial, Helvetica, sans-serif"> - the pipe separated list of fonts that are displayed in the editor drop-down menu.
<cfset Request.KTML4_GLOBALS["editor_inner_dimensions"] = "false"> - if set to true, the width and height you set in the page apply only to the actual editing area. If false, these are the sizes of the entire control.
Note: This option is not available for the Lite version.
<cfset Request.KTML4_GLOBALS["stop_parent_scroll_on_focus"] = "true">- this option determines how the control reacts when the user scrolls the mouse. If true, scrolling only affects the editing area. If false, it will scroll the parent window.
Note: This option is not available for the Lite version.
<cfset Request.KTML4_GLOBALS["colors"] = ""> -hexadecimal codes for the colors to be displayed in the color picker. If left empty, the default web palette is displayed.
<cfset Request.KTML4_GLOBALS["skip_doctype_check"]="false"> - KTML does not render properly in non XHTML standard mode. By setting this option to true, KTML will no longer check the page DOCTYPE and attempt to render as if it were in standard compliant mode.
Note: This option is not available for the Lite version.
<cfset Request.KTML4_GLOBALS["auto_clean_on_paste"]="word"> - When pasting content into the KTML editor, several filters can be automatically ran. This option selects the filter that is ran by default. Possible values are:
word - cleans all of the tags that are added by Word. This is the default value.
formatting - cleans all formatting tags
css - removes all CSS classes from elements
all - removes all HTML tags except the <p> blocks
none - no automatic cleaning is performed. If you want to run any of the aforementioned filters you have to do it manually, from the Clean HTML menu.
Note: This option is not available for the Lite version.
<cfset Request.KTML4_GLOBALS["logical_emphasis"] = "true"> - Decide whether to convert <b> to <strong> and <i> to <em> or not. By default it is set to true, which means that the <b> and <i> tags are replaced with their newer equivalents. If you need to keep the old style tags, <b> and <i>, set the value for this option to false.
<cfset Request.KTML4_GLOBALS["online_interakt_spellcheck" = "true"> - This setting decides what spellcheck facility to use: the locally installed ASPELL library or the online spellcheck service provided by InterAKT. If you cannot install spellchecking libraries on your server, set this option to TRUE and KTML will use the web service provided by InterAKT to spellcheck the text. Otherwise, set it to FALSE and use the local ASPELL utility. For more information regarding the InterAKT spellcheck web service, check out the Configure spellchecking topic.
Note: This option is not available for the Lite version.
<cfset Request.KTML4_GLOBALS["insertlink_prompt_for_url" = "true"> - If you prefer to add links the old style, without having a prompt where to add the URL, as shown here, set this option to false. Then, when inserting a new link, a blank hyperlink target will be created which you can edit using the property inspector. To keep the pop-up that asks for the hyperlink URL set this option to TRUE.
You have to set these properties as elements of a configuration array inside the includes\ktm\ktml4.config.xml. The settings you are interested in are near the end of the file, as the <KTML4_GLOBALS> node. Possible entries in the array and their default options are:
<var name="allowed_tags_list"></var> - what tags are allowed to be used within the editor.
<var name="denied_tags_list">script,iframe,frame</var> - the tags that are not allowed in the editor. These two lists are mutually exclusive: you should only have one such list.
<var name="add_new_paragraph_on_enter">true</var> - this setting controls how the editor acts when the user presses the Enter / Return key. If true, a new <p> tag is added. Otherwise, a <br /> can be used.
<var name="special_chars"><![CDATA[]]></var> - the list of special characters to display in the character picker in the editor. If empty, the default special character map will be displayed.
<var name="fonts">Arial, Helvetica, sans-serif;|"Times New Roman", Times, serif;|"Courier New", Courier, mono;|Georgia, "Times New Roman", Times, serif;|Verdana, Arial, Helvetica, sans-serif;|Geneva, Arial, Helvetica, sans-serif;</var> - the pipe separated list of fonts that are displayed in the editor drop-down menu.
<var name="editor_inner_dimensions">"false"</var> - if set to true, the width and height you set in the page apply only to the actual editing area. If false, these are the sizes of the entire control.
Note: This option is not available for the Lite version.
<var name="stop_parent_scroll_on_focus">"true"</var>- this option determines how the control reacts when the user scrolls the mouse. If true, scrolling only affects the editing area. If false, it will scroll the parent window.
Note: This option is not available for the Lite version.
<var name="colors"></var> - hexadecimal codes for the colors to be displayed in the color picker. If left empty, the default web palette is displayed.
<var name="skip_doctype_check">"false"</var> - KTML does not render properly in non XHTML standard mode. By setting this option to true, KTML will no longer check the page DOCTYPE and attempt to render as if it were in standard compliant mode.
Note: This option is not available for the Lite version.
<var name="auto_clean_on_paste">"word"</var> - When pasting content into the KTML editor, several filters can be automatically ran. This option selects the filter that is ran by default. Possible values are:
word - cleans all of the tags that are added by Word. This is the default value.
formatting - cleans all formatting tags
css - removes all CSS classes from elements
all - removes all HTML tags except the <p> blocks
none - no automatic cleaning is performed. If you want to run any of the aforementioned filters you have to do it manually, from the Clean HTML menu.
Note: This option is not available for the Lite version.
<var name="logical_emphasis">true</var> - Decide whether to convert <b> to <strong> and <i> to <em> or not. By default it is set to true, which means that the <b> and <i> tags are replaced with their newer equivalents. If you need to keep the old style tags, <b> and <i>, set the value for this option to false.
<var name="online_interakt_spellcheck">true</var> - This setting decides what spellcheck facility to use: the locally installed ASPELL library or the online spellcheck service provided by InterAKT. If you cannot install spellchecking libraries on your server, set this option to TRUE and KTML will use the web service provided by InterAKT to spellcheck the text. Otherwise, set it to FALSE and use the local ASPELL utility. For more information regarding the InterAKT spellcheck web service, check out the Configure spellchecking topic.
<var name="insertlink_prompt_for_url">true</var> - If you prefer to add links the old style, without having a prompt where to add the URL, as shown here, set this option to false. Then, when inserting a new link, a blank hyperlink target will be created which you can edit using the property inspector. To keep the pop-up that asks for the hyperlink URL set this option to TRUE.
You have to set these properties as elements of a configuration array inside the WEB_INF\ktml4.config.properties. The settings you are interested in are near the end of the file, as the <KTML4_GLOBALS> node. Possible entries in the array and their default options are:
KTML4_GLOBALS_allowed_tags_list = - what tags are allowed to be used within the editor.
KTML4_GLOBALS_denied_tags_list = script,iframe,frame - the tags that are not allowed in the editor. These two lists are mutually exclusive: you should only have one such list.
KTML4_GLOBALS_add_new_paragraph_on_enter = true - this setting controls how the editor acts when the user presses the Enter / Return key. If true, a new <p> tag is added. Otherwise, a <br /> can be used.
KTML4_GLOBALS_special_chars= - the list of special characters to display in the character picker in the editor. If empty, the default special character map will be displayed.
KTML4_GLOBALS_fonts=Arial, Helvetica, sans-serif|Times New Roman, Times, serif|Courier New, Courier, mono|Georgia, Times New Roman, Times, serif|Verdana, Arial, Helvetica, sans-serif|Geneva, Arial, Helvetica, sans-serif - the pipe separated list of fonts that are displayed in the editor drop-down menu.
KTML4_GLOBALS_editor_inner_dimensions=false - if set to true, the width and height you set in the page apply only to the actual editing area. If false, these are the sizes of the entire control.
Note: This option is not available for the Lite version.
KTML4_GLOBALS_stop_parent_scroll_on_focus=true- this option determines how the control reacts when the user scrolls the mouse. If true, scrolling only affects the editing area. If false, it will scroll the parent window.
Note: This option is not available for the Lite version.
KTML4_GLOBALS_colors= - hexadecimal codes for the colors to be displayed in the color picker. If left empty, the default web palette is displayed.
KTML4_GLOBALS_skip_doctype_check=false - KTML does not render properly in non XHTML standard mode. By setting this option to true, KTML will no longer check the page DOCTYPE and attempt to render as if it were in standard compliant mode.
Note: This option is not available for the Lite version.
KTML4_GLOBALS_auto_clean_on_paste=word - When pasting content into the KTML editor, several filters can be automatically ran. This option selects the filter that is ran by default. Possible values are:
word - cleans all of the tags that are added by Word. This is the default value.
formatting - cleans all formatting tags
css - removes all CSS classes from elements
all - removes all HTML tags except the <p> blocks
none - no automatic cleaning is performed. If you want to run any of the aforementioned filters you have to do it manually, from the Clean HTML menu.
Note: This option is not available for the Lite version.
KTML4_GLOBALS_logical_emphasis=true - Decide whether to convert <b> to <strong> and <i> to <em> or not. By default it is set to true, which means that the <b> and <i> tags are replaced with their newer equivalents. If you need to keep the old style tags, <b> and <i>, set the value for this option to false.
Note: This option is not available for the Lite version.
KTML4_GLOBALS_online_interakt_spellcheck=true - This setting decides what spellcheck facility to use: the locally installed ASPELL library or the online spellcheck service provided by InterAKT. If you cannot install spellchecking libraries on your server, set this option to TRUE and KTML will use the web service provided by InterAKT to spellcheck the text. Otherwise, set it to FALSE and use the local ASPELL utility. For more information regarding the InterAKT spellcheck web service, check out the Configure spellchecking topic.
Note: This option is not available for the Lite version.
KTML4_GLOBALS_insertlink_prompt_for_url=true - If you prefer to add links the old style, without having a prompt where to add the URL, as shown here, set this option to false. Then, when inserting a new link, a blank hyperlink target will be created which you can edit using the property inspector. To keep the pop-up that asks for the hyperlink URL set this option to TRUE.
On JSP there is another file that provides configuration options: WEB_INF\web.xml. If you are installing KTML into an existing site and you already have the XML file, you will have to add the following part, in order for KTML to function properly:
<!-- Init parameters for the JSP ktml4_service -->
<servlet>
<servlet-name>ktml4_service</servlet-name>
<jsp-file>/includes/ktm/plugins/service/service.jsp</jsp-file>
<init-param>
<param-name>PARAMETER_ENCODING</param-name>
<param-value>UTF-8</param-value>
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>ktml4_service</servlet-name>
<url-pattern>/includes/ktm/plugins/service/service.jsp</url-pattern>
</servlet-mapping>
The PARAMETER_ENCODING argument defines the encoding used for file names. You should not change this option. The default value is UTF-8.