Technote Details :: KTML loads in safe mode

When I access a page that has the KTML control, it only loads in safe mode, missing some of the features.This happens for both local and remote pages.

This can happen due to several reasons:

1. You are running a firewall whose privacy settings by default do not allow remote scripts to identify the current browser.
2. The page DOCTYPE declaration is wrong, forcing the page to load in quirks mode.
3. You have some content before the page DOCTYPE. The control loads in Safe Mode in Internet Explorer only.
4. You are using a browser that is not officially supported by KTML.

Scenario 1: You are using a firewall that blocks KTML

The privacy settings from the firewall are meant to keep the user secure, by not allowing remote scripts to detect the browser type. Because KTML executes browser specific code, in order to work the same on all browsers it will load in safe more.

In order to use the KTML control with all of its intended features you must disable the Privacy settings from your firewall. Consult the firewall user manual for help on performing this action

Scenario 2: The DOCTYPE definition is wrong

Due to style sheet issues, KTML renders correctly only when the page is in XHTML strict or transitional mode. For the older, quirks mode - HTML4 compliant, the control will load in safe mode. To solve this you can:

• Edit the page containing the control and set the correct DOCTYPE. A correct DOCTYPE and HTML tag definition is as follows:
• Force KTML to skip the DOCTYPE check. To do so, open the includes/ktm/ktml4.config.xxx file and, in the KTML4_GLOBALS section at the bottom add a new option: 'skip_doctype_check'. For its value set "true" - with the quotes. For more details on the configuration options in the ktml4.config file read this online manual topic.
  Warning: Forcing KTML to skip the doctype check may result in an erroneous display and/or behavior and it is not recommended.

Scenario 3: Additional META tags exist before the page DOCTYPE

Some non-commercial servers or even hosting services may add some content on top of the file identifying itself. One such example is the ColdFusion MX Developer Edition which adds a <meta>tag. Internet Explorer does not recognize the DOCTYPE declaration any more, and KTML loads in safe mode. To solve this issue you can:

• Remove the content from the page, or force it to be added after the <DOCTYPE> tag.
• Force KTML to skip the DOCTYPE check. For details on how to do so, see step 2 in Scenario 2 above.

Scenario 4: You are using an unsupported browser

KTML does not support all browsers. For a list of supported browsers check the Browser Compatibility section here.