Upgrading to 2.4

MODX Revolution 2.4.0 (August 2015) adds package dependencies, namespace permissions, database indexes, and manager improvements. Full changelog: core/docs/changelog.txt.

Release overviews:

• Revolution 2.4 — Package Dependencies & More
• Deep Dive Into MODX Revolution 2.4

Before you upgrade¶

• Upgrade to the latest 2.4 patch release, rather than stopping at 2.4.0. The 2.4 line includes the security fix from 2.3.6.
• Update Extras on the current version, clear core/cache, flush sessions, and back up the database and files.
• Check custom integrations with modTransportProvider. MODX 2.4.1 restored compatibility for Extras that used its previous behaviour.

Changes to review¶

User profile country values¶

modUserProfile.country stores ISO country codes instead of translated country names. Check imports, exports, profile forms, and reports that compare this field with a full country name.

Resource URI generation¶

The use_frozen_parent_uris setting lets child URI generation respect frozen parent URIs. Review generated aliases if your site freezes resource URIs or builds paths in custom code.

Access control and namespaces¶

2.4 adds namespace permissions and combines the user-group tree with a user grid in the ACL page. Re-test custom access policies and manager users after setup.

Package dependencies¶

Transport packages can declare dependencies on other Extras. Package Manager resolves those dependencies and may show setup options during installation. Test packages with custom resolvers or setup-option windows.

Other notable additions¶

• New database indexes for common queries.
• System Events management page.
• Real-time resource alias generation.
• Regular-expression validation for text TVs.
• Date TVs can hide the time input.
• Custom icons for media sources and contexts.
• New saveObject and removeObject methods in object processors.
• JSONP support in modConnectorResponse.
• contentType=string support in modRestCurlClient.

Patch-level caution¶

2.4.3 introduced a regression in output filters on undefined placeholders. MODX 2.4.4 fixed it. Install the latest 2.4.x patch and test pages that apply output modifiers to missing values.

After setup¶

Check manager login, ACLs, Package Manager dependency resolution, user profile country values, and friendly URLs. Clear the manager browser cache before testing.