----------------------------------------------
Custom Fields Upgrade Assistant
----------------------------------------------

CustomFields Upgrade Assistant lets you upgrade the Custom Fields data and field structure created and maintained by the older versions of Custom Fields plugin (written by Arvind Satyanarayan of www.movalog.com) to the structure suitable to Movable Type 4.1.

The plugin is intended to overwrite your exisiting Custom Fields plugin.  This plugin includes the directory whose name is "Custom Fields", in the directory there is a plugin defition script whose name is "customfields.pl"; both the directory and the file were *not* mistakenly named.

Please make sure you backup the database and the plugin directories and files before upgrading, so if *something* happens, you can go back to the original state.

Jessee Gardner (with help from Six Apart's David Phillips aka TweezerMan) wrote a great CustomFields migration tutorial at: http://www.movabletweak.com/app/migrating_customfields_movable_type.php. The steps are repeated here

----------------------------------------------
Bug Fix Release
----------------------------------------------
This version which you downloaded from http://code.sixapart.com/svn/mtplugins/branches/CustomFieldsUpgradeAssistant-bugfix/, is a temporary bugfix release of the plugin.  This version contains a fix to the issue Jesse Gardner and David Phillips found and resolved by running two SQL queries.  The fix is going to be included in the next release of Movable Type Professional, therefore this version will be deprecated by the release.

This version is in a "branch", because after the new release of Movable Type Professional, this version should not be needed any longer (thus probably be removed).

----------------------------------------------
Upgrade Process

1. Remove existing CustomFields plugin

    $MTDIR/plugins/CustomFields

2. Install the CustomFieldsUpgradeAssistant plugin. This upgrade plugin has the same name as the original plugin and should be placed in the same location as the original plugin.

3. Fix a bug in Custom Fields - You still have to do this with this version of the plugin.

Open $MTDIR/addons/Commercial.pack/lib/CustomFields/Util.pm

Go to line 322, which looks like this:
    
    my $text = ($entry->text || '') . "\n" . ($entry->text_more || '');
    
And change to:
    
    my $text = ($obj->text || '') . "\n" . ($obj->text_more || '');

Note: This bug has been fixed and it'll be included in the next Commercial release of MT (most-likely MT4.1.5)

4. Access your MT install, and you will be prompted to upgrade. Click "upgrade" and you're done with the upgrade.


----------------------------------------------
Authors and Contributors

Fumiaki Yoshimatsu, Six Apart Japan (SAKK)
Beau Smith, Six Apart

----------------------------------------------
Source

For this bugfix version
SVN Repo: http://code.sixapart.com/svn/mtplugins/branches/CustomFieldsUpgradeAssistant-bugfix/
Trac View: http://code.sixapart.com/trac/mtplugins/log/branches/CustomFieldsUpgradeAssistant-bugfix

For the mainstream release (although contains bugs as of 2008-03-20)
SVN Repo: http://code.sixapart.com/svn/mtplugins/trunk/CustomFieldsUpgradeAssistant/
Trac View: http://code.sixapart.com/trac/mtplugins/log/trunk/CustomFieldsUpgradeAssistant

Plugins: http://plugins.movabletype.org/customfieldsupgradeassistant/

----------------------------------------------
History

1.0b
- included the fixed version of code in the plugin to eliminate dependencies to CustomFields::Upgrade module.
  The module had a bug that fails upgrading when a custom field data is an orphan (i.e. no parent entry or author is in the database).
  The new code checks and ignores orphans thus removed the needs to run two DELETE queries in MySQL database.

1.0
- documented process for upgrading based upon Jesse Gardner's tutorial