FCKeditor 2.x/Developers Guide/Installation/Upgrading - Revision history

Fredck at 13:22, 21 October 2008

2008-10-21T13:22:26Z

Fredck at 23:21, 27 March 2008

2008-03-27T23:21:13Z

Fredck at 23:21, 27 March 2008

2008-03-27T23:21:02Z

W.olchawa at 11:16, 2 January 2008

2008-01-02T11:16:11Z

W.olchawa at 11:04, 2 January 2008

2008-01-02T11:04:40Z

W.olchawa: New page: This page presents some information regarding the upgrade process. You may find references to the SVN version (which will become a future version). For more information about the SVN, see ...

2008-01-02T10:55:00Z

New page: This page presents some information regarding the upgrade process. You may find references to the SVN version (which will become a future version). For more information about the SVN, see ...

New page

This page presents some information regarding the upgrade process. You may find references to the SVN version (which will become a future version). For more information about the SVN, see [[FCKeditor 2.x/Developers Guide/SVN|Subversion (SVN) Access]].

The advices listed in this page are cumulative, so if you are upgrading from an older version to a newer one, please take note of all advices between both versions.

If you don't find any advice for your current version here, you will much probably have no problems with the upgrade. '

'''Note:''' this page contains information starting from version 2.3.1. For older versions, please take a look in the "_whatsnew.html" file, which can be found in the editor distribution package.

== From 2.x to 2.y ==

=== General Guidelines ===

Usually, upgrading from version 2.x to version 2.y is simple as overwriting the old editor installation directory with the new one. Just remember that any configuration or customization made in the previous installation must be backup-ed, saved and remembered.

For configurations, we highly recommend to place a custom configurations file outside the editor installation directory, and then use the "CustomConfigurationsPath" setting to point to that file (see [[FCKeditor 2.x/Developers Guide/Configuration|Configuration]]). We recommend having the same approach with custom skins, plugins, smileys, XML files, etc...

=== From 2.5 to SVN ===

* No important recommendations.

=== From 2.4.3 to 2.5 ===

* API: The '''GetHTML''' function has been deprecated in favor of '''GetData'''.
* API: The '''SetHTML''' function has been deprecated in favor of '''SetData'''.
* All the connectors have been moved from '''filemanager/default/connectors''' and '''f ilemanager/upload''' to '''/filemanager/connectors''', so their paths in '''fckconfig.js''' must be adjusted accordingly.
* Now a single file will control both the filebrowser and quick upload for each server language.
* The default connector has been changed from PHP to ASP.
* The configuration file for the connectors (currently ASP and PHP) has been extended so it's possible to adjust the name of the subfolders for each file type.
* The '''ForceStrongEm''' configuration setting has been removed. You can use now the CoreStyles to control the output.

=== From 2.4.2 to 2.4.3 ===

* API: The '''CreateLink''' function now returns an array of <a> nodes, instead of a single <a> node.

=== From 2.4 to 2.4.1 ===

* The default keystroke combination for "Save" has been changed from <Ctrl>+<Alt>+<s>to <Ctrl>+<Shift>+<S> (see ticket #138).</s><s></s>
* <s></s><s>The new FCKpackager is now used to generate the compressed scripts of FCKeditor. FCKeditor.Packager has been discontinued.</s>

=== <s>From 2.3.3 to 2.4</s> ===

* <s>The new <Enter> key handler system is being introduced.</s>
* <s>The UseBROnCarriageReturn configuration is no longer valid. The EnterMode setting can now be used to precisely set the enter key behavior.</s>
* <s>The default folder used in the distribution package is now named "fckeditor" (in lowercase), instead of "FCKeditor". All integration files are pointing to the lowercase folder. This change may impact installations on case sensitive OSs, like Linux.</s>
* <s>All connectors are now pointing by default to the "/userfiles/" folder instead of "/UserFiles/" (case change). Also, the inner folder for each type (file, image, flash and media) are all lowercased too.</s>
* <s>All JavaScript Core extension function have been renamed to "PascalCase" (some were in "camelCase"), to standardize the editor code, and make our customizations easily visible. This may have impact on plugins that use any of those functions.</s>
* <s>The extensions "html", "htm" and "asis" have been added to the list of denied extensions on upload.</s>

=== <s>From 2.3.2 to 2.3.3</s> ===

* <s>The Universal Keyboard has been removed from the package. If the toolbar contains the 'UniversalKey' command the editor will warn that the command isn't known: you'll need to remove the command from your toolbar or create a plugin based on the code existing in the previous version.</s>

=== <s>From 2.3.1 to 2.3.2</s> ===

* <s>The Template dialog window has now a new checkbox which makes it possible to tell the editor to paste the template in the cursor position. This operation may not be wanted, so use the "TemplateReplaceCheckbox" configuration option to remove the checkbox.</s>
* <s>The File Browser now may display scrollbars. If you have a custom File Browser and it is showing up any undesirable scrollbar, just set: <body style="overflow: hidden;">.</s>

== <s>From 1.x to 2.x</s> ==

<s>The editor has been completely rewritten for version 2.0. Hundreds of new features have been added and the editor is now compatible with more browsers.</s>

<s>The integration code for the 1.x is not compatible with the 2.x, so you must make a clean installation of version 2.x and review all your code that uses the editor.</s>

@@ Line 23: / Line 23: @@
 * A new dialog system has been introduced, which brought some changes to the skin CSSs. Any custom skin must be reviewed.<br>
-=== From 2.4.3 to 2.5 ===
+=== From 2.4.3 to 2.5  ===
-* API: The '''GetHTML''' function has been deprecated in favor of '''GetData'''.
+*API: The '''GetHTML''' function has been deprecated in favor of '''GetData'''.
-* API: The '''SetHTML''' function has been deprecated in favor of '''SetData'''.
+*API: The '''SetHTML''' function has been deprecated in favor of '''SetData'''.
-* All the connectors have been moved from '''filemanager/default/connectors''' and '''f<span id="1199270961929E">&nbsp;</span>ilemanager/upload''' to '''/filemanager/connectors''', so their paths in '''fckconfig.js''' must be adjusted accordingly.
+*All the connectors have been moved from '''filemanager/default/connectors''' and '''f<span id="1199270961929E">&nbsp;</span>ilemanager/upload''' to '''/filemanager/connectors''', so their paths in '''fckconfig.js''' must be adjusted accordingly.
-* Now a single file will control both the filebrowser and quick upload for each server language.
+*Now a single file will control both the filebrowser and quick upload for each server language.
-* The default connector has been changed from PHP to ASP.
+*The default connector has been changed from ASP to PHP.
-* The configuration file for the connectors (currently ASP and PHP) has been extended so it's possible to adjust the name of the subfolders for each file type.
+*The configuration file for the connectors (currently ASP and PHP) has been extended so it's possible to adjust the name of the subfolders for each file type.
-* The '''ForceStrongEm''' configuration setting has been removed. You can use now the CoreStyles to control the output.
+*The '''ForceStrongEm''' configuration setting has been removed. You can use now the CoreStyles to control the output.
 === From 2.4.2 to 2.4.3 ===

← Older revision		Revision as of 23:21, 27 March 2008
Line 18:		Line 18:

	* No important recommendations.		* No important recommendations.
−
−

	=== From 2.5 to 2.6<br> ===		=== From 2.5 to 2.6<br> ===

@@ Line 23: / Line 23: @@
 * API: The '''GetHTML''' function has been deprecated in favor of '''GetData'''.
 * API: The '''SetHTML''' function has been deprecated in favor of '''SetData'''.
-* All the connectors have been moved from '''filemanager/default/connectors''' and '''f<span id="1199270961929E" style="">&nbsp;</span>ilemanager/upload''' to '''/filemanager/connectors''', so their paths in '''fckconfig.js''' must be adjusted accordingly.
+* All the connectors have been moved from '''filemanager/default/connectors''' and '''f<span id="1199270961929E">&nbsp;</span>ilemanager/upload''' to '''/filemanager/connectors''', so their paths in '''fckconfig.js''' must be adjusted accordingly.
 * Now a single file will control both the filebrowser and quick upload for each server language.
 * The default connector has been changed from PHP to ASP.
@@ Line 35: / Line 35: @@
 === From 2.4 to 2.4.1 ===
-* The default keystroke combination for "Save" has been changed from &lt;Ctrl&gt;+&lt;Alt&gt;+<s>to &lt;Ctrl&gt;+&lt;Shift&gt;+&lt;S&gt; (see ticket #138).</s><s></s>
+* The default keystroke combination for "Save" has been changed from &lt;Ctrl&gt;+&lt;Alt&gt;+to &lt;Ctrl&gt;+&lt;Shift&gt;+&lt;S&gt; (see ticket [http://dev.fckeditor.net/ticket/138: #138]).
-* <s></s><s>The new FCKpackager is now used to generate the compressed scripts of FCKeditor. FCKeditor.Packager has been discontinued.</s>
+* The new FCKpackager is now used to generate the compressed scripts of FCKeditor. FCKeditor.Packager has been discontinued.
-=== <s>From 2.3.3 to 2.4</s> ===
+=== From 2.3.3 to 2.4 ===
-* <s></s><strike><s>The new &lt;Enter&gt; key handler system is being introduced.</s></strike>
+* The new &lt;Enter&gt; key handler system is being introduced.
-* <s>The UseBROnCarriageReturn configuration is no longer valid. The EnterMode setting can now be used to precisely set the enter key behavior.</s>
+* The UseBROnCarriageReturn configuration is no longer valid. The EnterMode setting can now be used to precisely set the enter key behavior.
-* <s>The default folder used in the distribution package is now named "fckeditor" (in lowercase), instead of "FCKeditor". All integration files are pointing to the lowercase folder. This change may impact installations on case sensitive OSs, like Linux.</s>
+* The default folder used in the distribution package is now named "fckeditor" (in lowercase), instead of "FCKeditor". All integration files are pointing to the lowercase folder. This change may impact installations on case sensitive OSs, like Linux.
-* <u><s>All connectors are now pointing by default to the "/userfiles/" folder instead of "/UserFiles/" (case change). Also, the inner folder for each type (file, image, flash and media) are all lowercased too.</s></u>
+* All connectors are now pointing by default to the "/userfiles/" folder instead of "/UserFiles/" (case change). Also, the inner folder for each type (file, image, flash and media) are all lowercased too.
-* <u><s>All JavaScript Core extension function have been renamed to "PascalCase" (some were in "camelCase"), to standardize the editor code, and make our customizations easily visible. This may have impact on plugins that use any of those functions.</s></u>
+* All JavaScript Core extension function have been renamed to "PascalCase" (some were in "camelCase"), to standardize the editor code, and make our customizations easily visible. This may have impact on plugins that use any of those functions.
-* <u><s>The extensions "html", "htm" and "asis" have been added to the list of denied extensions on upload.</s></u>
+* The extensions "html", "htm" and "asis" have been added to the list of denied extensions on upload.
-=== <u><s>From 2.3.2 to 2.3.3</s></u> ===
+=== From 2.3.2 to 2.3.3 ===
-* <u><s>The Universal Keyboard has been removed from the package. If the toolbar contains the 'UniversalKey' command the editor will warn that the command isn't known: you'll need to remove the command from your toolbar or create a plugin based on the code existing in the previous version.</s></u>
+* The Universal Keyboard has been removed from the package. If the toolbar contains the 'UniversalKey' command the editor will warn that the command isn't known: you'll need to remove the command from your toolbar or create a plugin based on the code existing in the previous version.
-=== <u><s>From 2.3.1 to 2.3.2</s></u> ===
+=== From 2.3.1 to 2.3.2 ===
-* <s>The Template dialog window has now a new checkbox which makes it possible to tell the editor to paste the template in the cursor position. This operation may not be wanted, so use the "TemplateReplaceCheckbox" configuration option to remove the checkbox.</s>
+* The Template dialog window has now a new checkbox which makes it possible to tell the editor to paste the template in the cursor position. This operation may not be wanted, so use the "TemplateReplaceCheckbox" configuration option to remove the checkbox.
-* <s>The File Browser now may display scrollbars. If you have a custom File Browser and it is showing up any undesirable scrollbar, just set: &lt;body style="overflow: hidden;"&gt;.</s>
+* The File Browser now may display scrollbars. If you have a custom File Browser and it is showing up any undesirable scrollbar, just set: <pre>&lt;body style="overflow: hidden;"&gt;</pre>
-== <s>From 1.x to 2.x</s> ==
+== From 1.x to 2.x ==
-<s>The editor has been completely rewritten for version 2.0. Hundreds of new features have been added and the editor is now compatible with more browsers.</s>
+The editor has been completely rewritten for version 2.0. Hundreds of new features have been added and the editor is now compatible with more browsers.
-<s>The integration code for the 1.x is not compatible with the 2.x, so you must make a clean installation of version 2.x and review all your code that uses the editor.</s>
+The integration code for the 1.x is not compatible with the 2.x, so you must make a clean installation of version 2.x and review all your code that uses the editor.

@@ Line 23: / Line 23: @@
 * API: The '''GetHTML''' function has been deprecated in favor of '''GetData'''.
 * API: The '''SetHTML''' function has been deprecated in favor of '''SetData'''.
-* All the connectors have been moved from '''filemanager/default/connectors''' and '''f<span id="1199270961929E" style="display: none;">&nbsp;</span>ilemanager/upload''' to '''/filemanager/connectors''', so their paths in '''fckconfig.js''' must be adjusted accordingly.
+* All the connectors have been moved from '''filemanager/default/connectors''' and '''f<span id="1199270961929E" style="">&nbsp;</span>ilemanager/upload''' to '''/filemanager/connectors''', so their paths in '''fckconfig.js''' must be adjusted accordingly.
 * Now a single file will control both the filebrowser and quick upload for each server language.
 * The default connector has been changed from PHP to ASP.
@@ Line 40: / Line 40: @@
 === <s>From 2.3.3 to 2.4</s> ===
-* <s>The new &lt;Enter&gt; key handler system is being introduced.</s>
+* <s></s><strike><s>The new &lt;Enter&gt; key handler system is being introduced.</s></strike>
 * <s>The UseBROnCarriageReturn configuration is no longer valid. The EnterMode setting can now be used to precisely set the enter key behavior.</s>
-* <u><s>The default folder used in the distribution package is now named "fckeditor" (in lowercase), instead of "FCKeditor". All integration files are pointing to the lowercase folder. This change may impact installations on case sensitive OSs, like Linux.</s></u>
+* <s>The default folder used in the distribution package is now named "fckeditor" (in lowercase), instead of "FCKeditor". All integration files are pointing to the lowercase folder. This change may impact installations on case sensitive OSs, like Linux.</s>
 * <u><s>All connectors are now pointing by default to the "/userfiles/" folder instead of "/UserFiles/" (case change). Also, the inner folder for each type (file, image, flash and media) are all lowercased too.</s></u>
 * <u><s>All JavaScript Core extension function have been renamed to "PascalCase" (some were in "camelCase"), to standardize the editor code, and make our customizations easily visible. This may have impact on plugins that use any of those functions.</s></u>

@@ Line 15: / Line 15: @@
 For configurations, we highly recommend to place a custom configurations file outside the editor installation directory, and then use the "CustomConfigurationsPath" setting to point to that file (see [[FCKeditor 2.x/Developers Guide/Configuration|Configuration]]). We recommend having the same approach with custom skins, plugins, smileys, XML files, etc...
-=== From 2.5 to SVN ===
+=== From 2.6 to SVN ===
 * No important recommendations.
 === From 2.4.3 to 2.5 ===