Upgrading from ClassExtender versions prior to 2.0

If you use this extra and like it, please consider donating. The suggested donation for this extra is $10.00, but any amount you want to give is fine (really). For a one-time donation of $50.00 you can use all of my non-premium extras with a clear conscience.

Important Upgrade Information for ClassExtender 2.0

This information is for ClassExtender users upgrading from versions older then ClassExtender 2.0.

ClassExtender 2.0 has been refactored so that it will not conflict with other extras that extend the modUser or modResource objects (e.g., ActiveDirectory). Searches should be faster and there should be no more spurious error messages in the Error Log.

Please read this carefully if you are upgrading from a version older than 2.0. If you have already installed version 2.0 or greater, or are doing a new install, you can ignore this section.

The difference from earlier versions is that ClassExtender will no longer modify the class_key fields of the objects. In fact, when you install ClassExtender 2.0, it will revert its extUser and extResource class_key fields back to modUser and modDocument. It will not touch objects with other class keys, such as Article.

Important! If you uninstall the earlier version, you will lose any custom user or resource data currently stored in the database.

So that the upgrade will not overwrite your schema and extra fields chunks, the upgrade code will copy them to four new files with the prefix 'My':

  • ExtraUserFields will be copied to MyExtraUserFields
  • ExtUserSchema will be copied to MyExtUserSchema
  • ExtraResourceFields will be copied to MyExtraResourceFields
  • ExtResourceSchema will be copied to MyExtResourceSchema

ClassExtender will attempt to modify the MyExtUserSchema file with the new aggregate alias for the user profile. Check the aliases against those in the ExtUserSchema chunk to make sure it succeeded.

The snippets and plugins in the new versions will use the 'My' chunks, and those chunks will not be altered in future upgrades.

After Upgrading

  1. View and Submit the ExtendModUser and/or ExtendModResource Resources.
  2. If your snippet tags contain a &where property, they will need to be modified (see below).
  3. Custom snippets you have written may also need to be modified (see below).

Future upgrades will go much more smoothly. My apologies for the inconvenience.

My book, MODX: The Official Guide - Digital Edition is now available here. The paper version of the book may still be available from Amazon.

If you have the book and would like to download the code, you can find it here.

If you have the book and would like to see the updates and corrections page, you can find it here.

MODX: The Official Guide is 772 pages long and goes far beyond this web site in explaining beginning and advanced MODX techniques. It includes detailed information on:

  • Installing MODX
  • How MODX Works
  • Working with MODX resources and Elements
  • Using Git with MODX
  • Using common MODX add-on components like SPForm, Login, getResources, and FormIt
  • MODX security Permissions
  • Customizing the MODX Manager
  • Using Form Customization
  • Creating Transport Packages
  • MODX and xPDO object methods
  • MODX System Events
  • Using PHP with MODX

Go here for more information about the book.

Thank you for visiting BobsGuides.com

  —  Bob Ray