# pH7Builder 20.0.0 — Release Notes (Unreleased)

> Draft notes for the upcoming PHP 8.3+ release. No 20.0.0 tag or package is published yet.

- Canonical page: [https://ph7builder.com/release-notes-20-0-0/](https://ph7builder.com/release-notes-20-0-0/)
- Author: [Pierre-Henry Soria](https://github.com/pH-7)
- Published: 2026-11-20
- Section: Release notes

These are draft notes for the upcoming release. The v20.0.0 tag and release
package are not available yet.

## Breaking changes

- Requires PHP 8.3 or newer. pH7Builder 19.4.0 is the final release that
  supports PHP 8.2.
- Removes the deprecated Braintree Drop-in checkout. Operators using Braintree
  must migrate to a supported payment integration before upgrading.

## Installer and dependency updates

- Upgrades the installation wizard to Smarty 5.8.5. This is an internal
  installer dependency; pH7Builder site themes continue to use PH7Tpl.
- Keeps FakerPHP and all 29 existing profile-generator locales. Invalid locale
  submissions are rejected server-side instead of falling back implicitly.
- Keeps Clickatell SMS support while replacing its unmaintained GPL wrapper
  with the existing MIT-licensed HTTP client and Clickatell's current API.

## Database and upgrade notes

The SQL schema advances to `1.6.7`. Existing installations must apply
`_repository/upgrade/19.4.0-20.0.0/data/sql/MySQL/upgrade.sql` so the profile
generator and milestone celebration modules can be controlled from the module
manager. It widens the module folder identifier to store the milestone module's
full name. The migration is idempotent and preserves both modules' existing
enabled behavior.

Before deploying 20.0.0, upgrade the server runtime to PHP 8.3 or newer and
confirm that the locked dependencies support it. Sites that must remain on PHP
8.2 should stay on 19.4.0.

For source deployments, install the locked production dependencies with
`composer install`. For existing sites, preserve configuration and user data,
remove or block the installer, and clear application, template, and
browser/CDN caches after deployment.

## Continue

- [Current pH7Builder changelog](https://ph7builder.com/changelog/)
- [Install the latest published release](https://ph7builder.com/get-started/)
- [Source repository](https://github.com/pH7Software/pH7-Social-Dating-CMS)
