Technote Details :: Upgrading your application to KTML 4

We are releasing KTML 4, a new and improved version of the online HTML editor.  If you already have KTML 3 and upgraded to KTML 4, this technote explains how to:

1. Install and use both versions.
2. Use both versions in the same website.
3. Upgrade a page from KTML 3 to KTML 4.

Scenario 1: Install and use both KTML 3 and KTML 4

KTML 4 can be installed at the same time with KTML 3, using the same Configuration folder. You must follow the next steps to ensure a smooth install:

1. First install the latest KTML 3.
2. Download the KTML 4 extension from the InterAKT website. Start the instalation by double-clicking on the downloaded *.mxp file.
3. • Warning: Please note that the installation of KTML 3 might take between 5 and 30 minutes to complete, depending on your current computer configuration. The Macromedia Extension Manager window might appear frozen. Please be patient while Macromedia Extension Manager copies all required files.  Do not kill the installation process or restart your computer.
4. After installing both extensions, you should be able to see both of them in the Extension Manager:
   
   
   
5. The first time you start Dreamweaver after having installed the two extension, an alert will be displayed announcing that the previous version has been updated in order to allow an upgrade to KTML4. You have to restart Dreamweaver for the changes to take effect.
   
   
   

When you open Macromedia Dreamweaver, you should see the server behaviors corresponding to both versions of KTML in the Server Behaviors tab:

Scenario 2: Can I use KTML 3 and KTML 4 in the same site?

Yes, and you do not need to perform any extra actions. KTML 4 uses a different folder inside the <site_root>\includes\ folder for its files, so it will not intermix with the KTML 3 functionality. Once applied, each version will generate its own folder to keep the essential files, as you can see in the sample below:

Scenario 3: I'm using KTML 3 on some pages. Can I replace it with KTML 4 without recreating the pages?

Yes, with one condition: you must have both KTML 3 and 4 installed when you decide to make the upgrade. If you do not have both extensions installed, you cannot upgrade a previous KTML 3 control to the latest KTML 4.

The steps you must take are as follows:

1. Open a page that has the KTML 3 server behavior applied. The corresponding server behavior should be recognized in the Server Behaviors tab:
   
   
   
2. Double-click the server behavior to edit it. An alert will be displayed asking whether to upgrade the control to the latest version or not:
   
   
   
3. Click OK to upgrade, or Cancel to use the KTML 3 control further. After clicking OK, the KTML 3 server behavior will be replaced with the new KTML 4 server behavior.
4. You need to edit the new server behavior to configure the new options. An alert message will require you to do that:
   
   
   
5. In the Server Behaviors tab, the old entry has been replaced with the KTML 4 server behavior:
   
   
   
6. Edit the server behavior and configure its options as needed. The original settings that still apply will be set as default.
   Note: For more details on how to configure the user interface, check out the user manual.