How to upgrade the TinyMCE code inside the Products.TinyMCE package

by Rob Gietema last modified Sep 28, 2009 08:53 AM
A brief description for the maintainers of the Products.TinyMCE package on how to upgrade the TinyMCE product inside Products.TinyMCE.

Purpose

Products.TinyMCE is a Plone integration of the TinyMCE product. This product is maintained by Moxiecode and needs to be updated inside the Products.TinyMCE product when a new version is released.

Prerequisites

This howto is meant for the maintainers of the Products.TinyMCE product. If you are a site administrator and are looking for upgrading your Products.TinyMCE product check the 'How to install TinyMCE' how-to. This how-to assumes you have a basic understanding of developing for Plone and you are familiar with merging / difference tools like FileMerge.

Step by step

  • Go to the download page of TinyMCE and download the development versions of both the current version of TinyMCE (Which can be found in the CHANGES.txt file) and the new version. The file you are looking for is called tinymce_3_x_x_dev.zip.
  • After unzipping both archives the files are located in jscripts/tiny_mce. The files / folders used are:
    • langs
    • plugins
    • themes
    • utils
    • tiny_mce_src.js
    • tiny_mce_popup.js
  • Note: all the uncompressed Javascript files are used (ending with _src) and the _src is stripped from the name afterwards. This is done so the Javascript can be compressed using the Resource Registry of Plone.
  • Run your favorite merging tool (mine is FileMerge) and compare the old and the new versions of TinyMCE. You can now change / merge the differences into Products.TinyMCE.
  • After you updated the code you can update the language files. Use the following steps:
    • Using a shell go to the 'utils' folder.
    • Run 'python wget-xml.py' to download all the latest xml language files.
    • Run 'python generate-po.py' to create the .po files.
  • Document all the changes you made to CHANGES.txt.
  • Commit your changes to Subversion.