By Bob Ray (bobray)

Important: Always back up your site before upgrading.

UpgradeMODX installs a dashboard widget that alerts you when there is an upgrade to MODX available -- and installs it for you!.

When there is an upgrade available, UpgradeMODX will show an "Upgrade MODX" button and a form containing MODX versions. The recommended version to upgrade to should be selected automatically.

 After selecting a version and clicking on the submit button. UpgradeMODX will put all the new files in place and launch setup.

When Setup is finished, you'll be back in the Manager using a new version.

UpgradeMODX should work on any installation of MODX except the SDK version. That includes versions with renamed and/or moved directories.

The minimum version listed below is a guess, but for very old versions or MODX that do not support widgets, UpgradeMODX will install an UpgradeMODX resource which you can view to run UpgradeMODX. Once you reach a version that supports widgets, you can reinstall UpgradeMODX and use its Dashboard widget to upgrade.

Bob Ray

New in UpgradeMODX 2.1.2

UpgradeMODX 2.1.2-pl

  • Fix bug causing inactive submit button
  • Fix bug with getting latestVersion value
  • Only update versionlist when necessary
  • Eliminate unnecessary trip to GitHub
  • Provide workaround for versionlist issues
  • Add many unit tests
  • Get true cache path from CacheManager
  • Catch potential uncaught exception in copyFiles processor
  • Cache versionlist for better performance
  • Fix path bug in resolver
  • Better error reporting from GitHub
  • Add ugm_verbose setting for more detailed exception messages
  • Update Swedish translation

UpgradeMODX 2.1.0-pl

  • Fix bug causing inactive submit button
  • Add option to cache .zip file for use with multiple sites

UpgradeMODX 2.0.3-pl

  • Fix bug with possible 500 error in PHP 5
  • Fix bug with test for copying processors files
  • Update Unit Tests

UpgradeMODX 2.0.2-pl

  • Tell Setup where the core is, so it doesn't ask
  • Automatically select appropriate upgrade version
  • Automatically extend version list to include current version
  • Indicate current version in version list
  • Report progress during upgrade process
  • 3D animation for progress (except on f@$@|#% IE < Edge)
  • Use processors for each step to avoid timeouts
  • Operate entirely in the Manager until setup is launched
  • Add lexicon strings for all text
  • Restyle for Mobile
  • Change Ajax method to get to conform with the HTML 2.0 spec
  • Fix bug with missing versionlist error
  • Make sure downloaded file is closed
  • Get MODX files directly from AWS
  • Update credits
  • Other bug fixes and improvements

UpgradeMODX 1.5.5-pl

  • Fix issue with MODX logo (thanks to DigitalPenguin)
  • Make background image local

UpgradeMODX 1.5.4-pl

  • Fix openbasedir redirect issue (thanks to Jako)
  • Add Italian translation (thanks to FerX)
  • Update Swedish translation (thanks to Kristoffer Karlström)
  • Fix lexicon->load issue (thanks to sebastian-marinescu)
  • Hide inactive MODX version 2.5.3
  • Change name of temp directory to ugmtemp
  • Delete any created files if there is an error
  • Minor bug fixes and improvements

UpgradeMODX 1.5.3

  • Fix bug with striptags and failure to get version list from GitHub
  • Add error message on failure to get version list from GitHub
  • Code cleanup

UpgradeMODX 1.5.2-pl
  • Correct issue with malformed URL (thanks to Jako)
  • Mods for MODX cloud and similar platforms
UpgradeMODX 1.5.1-pl
  • Correct snippet tag in resource
  • Add Swedish translation (thanks to kristk)
  • Fix issue with openbasedir check (thanks to Jako)
  • Fix protocol for loading fonts and logo (thanks to inreti)
  • Add support for local certs for SSLVERIFYPEER
  • Fix bug with quit function
  • Add githubusername and githubtoken properties
  • Improve diagnostics
UpgradeMODX 1.4.0-pl
  • Log Upgrades to Manager Actions log
  • Add snippet property to control cURL SSLVERIFYPEER option
UpgradeMODX 1.4.0-pl
  • Add forceFopen, githubTimeout, modxTimeout properties
  • Add attempts, and versionListPath properties
  • Improve error handling and diagnostics
  • Unit tests for all methods
  • Refactor for better dependency injection and reliability
  • Fix bug with missing version list
UpgradeMODX 1.3.0-pl
  • Fix bug with blank screen when both cURL and allowurlfopen are disabled
  • Fix bug in test for cURL
  • Refactor unZip code
  • Add forcePclZip property
  • Improve error handling

UpgradeMODX 1.2.2-pl

  • Public Launch

UpgradeMODX 1.2.1.rc

  • Fix issue with version list
  • wrap class in if (classexists)

UpgradeMODX 1.2.0-rc

  • Use PclZip if ZipArchive is not available
  • Improve reliability of ZipArchive extraction
  • Fix bug with sorting when plOnly is false
  • Fix bug with missing setup directory
  • Add settime_limit(0) in loop
  • Fix spurious error in resolver
  • Form and doc updates

UpgradeMODX 1.0.2-beta1

  • Fixed bug with earlier versions of PHP

UpgradeMODX 1.0.0-beta1

  • Initial Version



December 16, 2018
Supported Versions
2 – Current

Previous Versions

November 29, 2018
2.0 – Current
November 11, 2018
2.0 – Current
October 26, 2018
2.0 – Current
December 27, 2017
2.0 – Current
January 12, 2017
2.0 – Current
November 16, 2016
2.0 – Current
April 22, 2016
2.0 – Current
April 15, 2016
2.0 – Current
March 10, 2016
2.0 – Current
November 13, 2015
2.0 – Current
October 9, 2015
2.0 – Current
September 18, 2015
2.0 – Current
September 3, 2015
2.0 – Current
August 28, 2015
2.0 – Current
August 28, 2015
2.0 – Current
August 25, 2015
2.0 – Current
August 24, 2015
2.0 – Current

More from Bob Ray


Captcha plugin for MODX Revolution


Create meta tags from TV, Resource description or content field


Reports resources with empty aliases


Email a resource to users