Release 6.0.0-beta.0

[kishore7snehil]

⚠️ This is a beta release. It moves the plugin onto auth0-php v9, which rewrites the Management API. The Authentication flow is unchanged. Please consult the 5.x to 6.x Upgrade Guide before upgrading.

🚀 What's New

This release makes the Auth0 WordPress plugin compatible with auth0-php v9. The plugin's login flow uses the Authentication API, which is unchanged in v9, so authentication requires no changes. The migration is confined to the Management API surface used by background user sync.

✨ Highlights

• 🔑 New getManagement() accessor - Plugin::getManagement() returns a v9 ManagementClient built from your existing plugin configuration (Domain, Client ID, Client Secret), with automatic client credentials token management and caching. It is also available as $this->getManagement() from action and filter classes
• 🏗️ auth0-php v9 Management API - Strongly-typed requests and responses, sub-clients accessed as properties ($management->users->list()), and built-in Pager<T> pagination
• 🔁 More resilient user sync - Background sync now retries transient Management API failures (429, 5xx) on the next cron pass instead of dropping the queued event
• 🛡️ Authentication unchanged - Login, logout, the callback handler, and session handling behave exactly as in 5.x

🔄 What's Changed

The Authentication surface is completely unchanged. Login, logout, callback, and session handling work exactly as before.

The Management API entry point has changed for any custom code that calls it:

Area	5.x	6.x
Entry point	wpAuth0()->getSdk()->management()	wpAuth0()->getManagement()
Sub-client access	->users()->getAll()	->users->list()
Request params	Associative arrays	Typed classes (ListUsersRequestParameters)
Responses	ResponseInterface + HttpResponse::decodeContent()	Typed objects ($user->getEmail())
Pagination	HttpResponsePaginator	foreach ($pager as $user)

getSdk()->management() is non-functional with auth0-php v9 and throws a TypeError. Use getManagement() instead.

📦 Installation

This beta is distributed as a signed zip on the GitHub release, not through the WordPress.org plugin directory. Download Auth0_WordPress_6.0.0-beta.0.zip from the release assets and upload it via Plugins → Add New → Upload Plugin in wp-admin. It is also resolvable through Composer:

composer require auth0/wordpress:6.0.0-beta.0

⚠️ Breaking Changes

• Bumped the auth0/auth0-php dependency from ^8.19 to ^9.0
• Raised the minimum PHP version from 8.1 to 8.2
• getSdk()->management() is non-functional with auth0-php v9. Use the new getManagement() accessor instead

📚 Resources

• 5.x to 6.x Upgrade Guide
• auth0-php v9 Migration Guide
• auth0-php v9 API Reference

🙏 Feedback

This is a beta release - we would love your feedback! Please open an issue if you encounter any problems or have suggestions.