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.

Installation Instructions

Install in Package Manager.

See the documentation at Bob's Guides.

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 open_base_dir 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 strip_tags 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 open_basedir check (thanks to Jako)
• Fix protocol for loading fonts and logo (thanks to inreti)
• Add support for local certs for SSL_VERIFY_PEER
• Fix bug with quit function
• Add github_username and github_token properties
• Improve diagnostics

UpgradeMODX 1.4.0-pl

• Log Upgrades to Manager Actions log
• Add snippet property to control cURL SSL_VERIFY_PEER 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 allow_url_fopen 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 (class_exists)

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 set_time_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

Version	Released	Author	Downloads
18 Versions		1 Contributors	59,862 Downloads
2.1.0-pl	Nov, 29 2018	bobray	2,726
2.0.3-pl	Nov, 11 2018	bobray	1,776
2.0.2-pl	Oct, 26 2018	bobray	1,591
1.5.5-pl	Dec, 27 2017	bobray	24,904
1.5.4-pl	Jan, 12 2017	bobray	9,019
1.5.3-pl	Nov, 17 2016	bobray	2,288
1.5.2-pl	Apr, 23 2016	bobray	3,538
1.5.1-pl	Apr, 16 2016	bobray	477
1.5.0-pl	Mar, 10 2016	bobray	978
1.4.0-pl	Nov, 14 2015	bobray	1,820
1.3.0-pl	Oct, 09 2015	bobray	940
1.2.2-pl	Sep, 18 2015	bobray	694
1.2.1-rc	Sep, 03 2015	bobray	518
1.2.0-rc	Aug, 28 2015	bobray	293
1.1.0-rc	Aug, 28 2015	bobray	137
1.0.2-beta1	Aug, 25 2015	bobray	206
1.0.1-beta1	Aug, 25 2015	bobray	163