Gantry 5.6.3 has been released.

g5, wordpress, joomla
August 25, 2026, 9:46

Gantry 5.6.3 Released

We're pleased to announce Gantry 5.6.3, a compatibility and stability release for WordPress, Joomla, and Grav.

This update prepares Gantry for Twig 3, removes deprecated Joomla 6 APIs, and tightens PHP 8.4 deprecation handling on both Windows and Unix. Bundled Twig 2.16 remains supported, so existing sites can update without jumping to Twig 3 first.

What's New in 5.6.3

WordPress

  • Prepared the Gantry 5 plugin for Twig 3 while keeping compatibility with bundled Twig 2.16
  • Added required return types and updated Twig node / token-parser signatures to match Twig 3 interfaces
  • Replaced deprecated {% spaceless %} with {% apply spaceless %} where whitespace control is required
  • Removed the unused {% spaceless %} wrapper from the Nucleus assets particle
  • Improved the Whoops deprecation guard so Windows and Unix vendor paths are both matched correctly
  • Fixed Twig issues that could appear when Gantry runs next to a newer Twig environment
  • Improved PHP 8.4 deprecation handling for bundled third-party dependencies

Joomla

  • Removed deprecated Joomla APIs and improved Joomla 6 compatibility
  • Replaced Factory::getDbo(), Factory::getConfig(), and Factory::getUser() with DI / modern application APIs
  • Switched cache handling to CacheControllerFactoryInterface
  • Replaced Table::getInstance('extension') with direct Extension table instantiation
  • Updated AbstractObject::getTable() with modern table resolution and a third-party fallback
  • Removed the deprecated CMSObject dependency
  • Replaced deprecated HTMLHelper asset helpers with WebAssetManager
  • Same Twig 3 prep as WordPress, still compatible with bundled Twig 2.16
  • Fixed Twig parser failures when another extension (for example phpBB3 / p8pBB) boots its own Twig 3 environment
  • Fixed setParser() errors when token parsers come back as arrays instead of handler objects
  • Restored the gantry Twig global after phpBB session init so theme rendering does not lose it

Grav

  • Raised tested dependency floors to Grav >= 1.7.48 and Admin >= 1.10.48 (still >=, so older installs are not locked out)
  • Prepared the 17 shared Gantry engine classes for Twig 3 while keeping Twig 2.16 compatibility
  • Updated TokenParserMarkdown with the required Twig\Node\Node import
  • Replaced deprecated {% spaceless %} in affected admin templates; removed the unused Nucleus assets wrapper
  • Added a PHP 8.4 vendor-deprecation guard in SystemFacade.php with normalized Windows \vendor\ and compat/vendor/ paths
  • Fixed Twig compatibility issues against newer Twig environments
  • Improved PHP 8.4 vendor-deprecation matching across supported platforms

MD5 checksums were regenerated for all modified platform packages.

Why This Matters

Sites mixing Gantry with newer Twig stacks (or Joomla 6 / PHP 8.4) were hitting parser errors, lost Twig globals, and noisy vendor deprecations — especially on Windows. 5.6.3 closes those gaps without forcing a Twig 3 cutover.

If you are on Joomla 6, WordPress with a third-party Twig 3 plugin, Grav 1.7.48+, or PHP 8.4, this is the release to run.

Changelog

Gantry 5.6.3 – August 24, 2026

WordPress — Improved

  • Prepared Gantry 5 WordPress plugin for Twig 3 compatibility while maintaining compatibility with the bundled Twig 2.16
  • Added required return types to Gantry Twig extensions, node classes and token parsers for Twig 3 compatibility
  • Updated Twig node and token parser method signatures to match Twig 3 interfaces
  • Updated TokenParserMarkdown with the required Twig\Node\Node import
  • Replaced deprecated Twig {% spaceless %} usage with {% apply spaceless %} in templates where whitespace control is required
  • Removed the unnecessary {% spaceless %} wrapper from the Nucleus assets particle where no HTML output is generated
  • Updated MD5 checksums for all modified WordPress plugin files
  • Improved the Whoops deprecation guard to correctly handle both Windows and Unix vendor paths and identify third-party vendor deprecations

WordPress — Bugfix

  • Fixed Twig compatibility issues that could occur when Gantry is used with newer Twig environments
  • Fixed deprecation handling on Windows by normalizing vendor paths before matching
  • Improved handling of PHP 8.4 deprecation messages from bundled third-party dependencies

Joomla — Improved

  • Updated Gantry 5 Joomla code to remove deprecated Joomla APIs and improve Joomla 6 compatibility
  • Replaced deprecated Factory::getDbo() calls with Joomla's Dependency Injection container and DatabaseInterface
  • Replaced deprecated Factory::getConfig() and Factory::getUser() calls with the modern Joomla application APIs
  • Replaced deprecated cache APIs with CacheControllerFactoryInterface
  • Replaced deprecated Table::getInstance('extension') usage with direct Extension table instantiation
  • Updated AbstractObject::getTable() to use modern Joomla table resolution while retaining a fallback for third-party table classes
  • Removed the deprecated CMSObject dependency from AbstractObject and adopted Joomla's modern object/property handling pattern
  • Replaced deprecated HTMLHelper asset helpers with Joomla's WebAssetManager
  • Prepared Gantry Twig extensions, nodes and token parsers for Twig 3 compatibility while maintaining compatibility with bundled Twig 2.16
  • Removed the deprecated Twig {% spaceless %} tag from the Nucleus assets particle
  • Regenerated MD5 checksums for modified Joomla package files

Joomla — Bugfix

  • Fixed a Twig parser compatibility issue when Gantry 5 is used with extensions that initialize independent Twig 3 environments, such as phpBB3/p8pBB integration
  • Fixed setParser() errors caused by Twig token parsers being returned as arrays instead of Gantry's expected handler object
  • Added defensive handling for both object-based and array-based Twig token parser handlers
  • Fixed Twig rendering errors where the Gantry global was lost after phpBB session initialization
  • Ensured the gantry instance is explicitly restored as a Twig global during theme rendering

Grav — Improved

  • Updated Grav dependency floors to Grav >=1.7.48 and Admin >=1.10.48, while retaining >= constraints to avoid locking out older installations and documenting the tested baseline
  • Prepared the 17 shared Gantry engine classes for Twig 3 compatibility while maintaining compatibility with the bundled Twig 2.16
  • Updated TokenParserMarkdown with the required Twig\Node\Node import for Twig 3 compatibility
  • Replaced deprecated Twig {% spaceless %} usage with {% apply spaceless %} in the affected admin templates
  • Removed the unnecessary {% spaceless %} wrapper from the Nucleus assets particle where no HTML output is generated
  • Added a PHP 8.4 vendor-deprecation guard to SystemFacade.php, with normalized vendor paths to support both Windows \vendor\ paths and compat/vendor/
  • Regenerated MD5 checksums for modified Grav package files

Grav — Bugfix

  • Fixed potential Twig compatibility issues when Gantry is used with newer Twig environments
  • Improved PHP 8.4 deprecation handling for bundled vendor dependencies by correctly normalizing and matching vendor paths across supported platforms

Download & Update

Packages are live now:

You can also update from the CMS administrator where that is available.

Back up the site before updating. Full package-specific changelogs ship with each download.

Previous Post