Upgrading to 2.6

MODX Revolution 2.6.0 (November 2017) is a large stability and manager UX release. Full changelog: core/docs/changelog.txt.

Release overview: A Major New Milestone for MODX Revolution.

Before you upgrade¶

• Prefer 2.5.8 (or later 2.5.x) as the starting point when you can. Older 2.x sites still upgrade, but Extras and custom code need more careful testing.
• Update packages, clear core/cache, flush sessions, then run setup.

Database notes¶

InnoDB on new installs¶

New MySQL installs create tables with the InnoDB engine when the server supports it. Existing MyISAM sites keep their current engines after upgrade. You can convert later if you want InnoDB benefits. See How to change your MyISAM DB to InnoDB using phpMyAdmin.

utf8mb4 indexes¶

Index prefixes on varchar / text columns were shortened so MySQL can use utf8mb4. That mainly matters for new installs and for hosts that already use utf8mb4. If you change collation manually after upgrade, check index lengths against MySQL limits.

Behaviour and security¶

• TV @EVAL binding: set allow_tv_eval to No to disable EVAL bindings (#13224). Turn it off on production if you do not need it.
• Cached vs uncached tags: processing of non-cacheable elements inside cacheable ones was fixed (#13530). Re-check pages that mix ! tags inside cached chunks/snippets.
• failed_login_attempts: the setting is honoured again (#13516). Confirm lockout behaviour matches what you expect.
• PHP 7: session callback and related PHP 7 errors in this line were addressed. On PHP 7 hosts, still confirm manager login and that a front-end session works.
• Package install / uninstall / remove fire new events (#12936). Custom plugins that assume the old event set should be reviewed.

Manager and API additions¶

• Who's Online dashboard widget.
• SVG previews in the Media Browser.
• Custom manager top menus (#12554).
• OnResourceCacheUpdate event for third-party cache layers.
• Option to skip resource duplication when duplicating a context.
• .less, .scss, .sass, and .css.map among default allowed upload types.
• DKIM-related PHPMailer attributes.
• REST: OPTIONS on modRestController, stream upload support for binary files.

After setup¶

Clear the manager browser cache. Check Package Manager, media uploads, login lockout, and any dashboard widgets. On MyISAM hosts, convert to InnoDB only after a full database backup.