Connectors: Add connectors registry for extensibility by gziolo · Pull Request #76364 · WordPress/gutenberg

gziolo · 2026-03-10T14:45:22Z

Summary

Ports the connectors registry from WordPress core (wordpress-develop#11175) to Gutenberg.

Introduces WP_Connector_Registry class (singleton) in lib/compat/wordpress-7.0/ managing connector registration with validation for IDs, required fields, and authentication methods
Polyfills public query functions with function_exists guards: wp_is_connector_registered(), wp_get_connector(), wp_get_connectors()
Polyfills _wp_connectors_resolve_ai_provider_logo_url() to convert plugin file paths to URLs for provider logos
Adds _gutenberg_connectors_init() that creates the registry, registers built-in connectors (merged with AI Client data), and fires wp_connectors_init action for plugin extensibility
Refactors _gutenberg_get_connector_settings() to build on wp_get_connectors() and enrich with logo URLs and plugin status
Core polyfills placed in lib/compat/wordpress-7.0/ following the standard pattern, with class_exists/function_exists guards to avoid double declarations

Test plan

PHP unit tests pass (1376 tests)
Connector E2E tests pass (6 tests)
PHPCS passes clean
Verify built-in connectors (openai, google, anthropic) are registered via the registry
Verify wp_is_connector_registered(), wp_get_connector(), wp_get_connectors() return expected data
Verify the wp_connectors_init action fires and allows plugins to register custom connectors
Verify calling WP_Connector_Registry::set_instance() outside init triggers _doing_it_wrong
Verify the Connectors settings page still works correctly

🤖 Generated with Claude Code

github-actions · 2026-03-10T15:20:43Z

Flaky tests detected in d54af13.
Some tests passed with failed attempts. The failures may not be related to this commit but are still reported for visibility. See the documentation for more information.

🔍 Workflow run URL: https://github.com/WordPress/gutenberg/actions/runs/22946168903
📝 Reported issues:

[Flaky Test] Items list is reachable via TAB #61701 in /test/e2e/specs/site-editor/dataviews-list-layout-keyboard.spec.js
[Flaky Test] User Mention: should allow mention selection via keypress event #48416 in /test/e2e/specs/editor/various/autocomplete-and-mentions.spec.js
[Flaky Test] should insert media, convert to blocks, and undo in one step #36123 in /test/e2e/specs/editor/blocks/classic.spec.js
[Flaky Test] should not highlight more than one format #48529 in /test/e2e/specs/editor/various/rich-text.spec.js
[Flaky Test] should undo bold #48558 in /test/e2e/specs/editor/various/undo.spec.js

Ports the connectors registry from WordPress core (wordpress-develop#11175) to Gutenberg. Introduces WP_Connector_Registry class and wp_connectors_init action hook so plugins can register their own connectors alongside the built-in defaults (Anthropic, Google, OpenAI). Co-Authored-By: Claude Opus 4.6 <[email protected]>

…_get_connectors Uses function_exists guards so plugins can use the wp_* names now and seamlessly switch to core's implementation once WordPress 7.0 ships. Co-Authored-By: Claude Opus 4.6 <[email protected]>

Move WP_Connector_Registry class and wp_* helper functions to lib/compat/wordpress-7.0/ where other core polyfills live. This aligns with the existing PHPCS exclude pattern for the default text domain and keeps core-ported code in the standard location. Co-Authored-By: Claude Opus 4.6 <[email protected]>

Co-Authored-By: Claude Opus 4.6 <[email protected]>

github-actions · 2026-03-11T08:44:10Z

The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the props-bot label.

If you're merging code through a pull request on GitHub, copy and paste the following into the bottom of the merge commit message.

Co-authored-by: gziolo <[email protected]>
Co-authored-by: felixarntz <[email protected]>

To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook.

Extend WP_Connector_Registry to persist logo_url, removing the need for a separate enrichment step. Resolve logo URLs from AI Client metadata alongside name and description in _gutenberg_connectors_init. Co-Authored-By: Claude Opus 4.6 <[email protected]>

… core Move the logo URL resolver to lib/compat/wordpress-7.0/connectors.php as a polyfill for the _wp_connectors_resolve_ai_provider_logo_url function being added to WP core. Remove the Gutenberg-prefixed version and its unit tests, which will be covered by core. Co-Authored-By: Claude Opus 4.6 <[email protected]>

gziolo · 2026-03-11T09:40:35Z

The latest commit polyfills _wp_connectors_resolve_ai_provider_logo_url from WP core instead of using a Gutenberg-prefixed version. Unit tests for this function are dropped since they'll live in core.

felixarntz · 2026-03-11T11:32:48Z

lib/experimental/connectors/default-connectors.php

+
+		$name        = $provider_metadata->getName();
+		$description = $provider_metadata->getDescription();
+		$logo_url    = method_exists( $provider_metadata, 'getLogoPath' ) && $provider_metadata->getLogoPath()


Ideally we should remove the method_exists check soon. At least in Core it should be removed as soon as that new php-ai-client version update has been committed.

Yes. We need to commit PHP AI client update first.

* Connectors: Add connectors registry for extensibility Ports the connectors registry from WordPress core (wordpress-develop#11175) to Gutenberg. Introduces WP_Connector_Registry class and wp_connectors_init action hook so plugins can register their own connectors alongside the built-in defaults (Anthropic, Google, OpenAI). Co-Authored-By: Claude Opus 4.6 <[email protected]> * Connectors: Polyfill wp_is_connector_registered, wp_get_connector, wp_get_connectors Uses function_exists guards so plugins can use the wp_* names now and seamlessly switch to core's implementation once WordPress 7.0 ships. Co-Authored-By: Claude Opus 4.6 <[email protected]> * Connectors: Move core polyfills to lib/compat/wordpress-7.0 Move WP_Connector_Registry class and wp_* helper functions to lib/compat/wordpress-7.0/ where other core polyfills live. This aligns with the existing PHPCS exclude pattern for the default text domain and keeps core-ported code in the standard location. Co-Authored-By: Claude Opus 4.6 <[email protected]> * Connectors: Add backport changelog entry for wordpress-develop#11175 Co-Authored-By: Claude Opus 4.6 <[email protected]> * Connectors: Add logo_url support to registry and resolve during init Extend WP_Connector_Registry to persist logo_url, removing the need for a separate enrichment step. Resolve logo URLs from AI Client metadata alongside name and description in _gutenberg_connectors_init. Co-Authored-By: Claude Opus 4.6 <[email protected]> * Connectors: Polyfill _wp_connectors_resolve_ai_provider_logo_url from core Move the logo URL resolver to lib/compat/wordpress-7.0/connectors.php as a polyfill for the _wp_connectors_resolve_ai_provider_logo_url function being added to WP core. Remove the Gutenberg-prefixed version and its unit tests, which will be covered by core. Co-Authored-By: Claude Opus 4.6 <[email protected]> --------- Co-authored-by: Claude Opus 4.6 <[email protected]> Co-authored-by: gziolo <[email protected]> Co-authored-by: felixarntz <[email protected]>

github-actions · 2026-03-11T15:33:34Z

I just cherry-picked this PR to the wp/7.0 branch to get it included in the next release: 53ebecf

This updates the pinned hash from the `gutenberg` from `9b8144036fa5faf75de43d4502ff9809fcf689ad` to `8c78d87453509661a9f28f978ba2c242d515563b`. The following changes are included: - Navigation Editor: Allow any blocks to be inserted by gating contentOnly insertion rules to section blocks (WordPress/gutenberg#76189) - Add `fetchpriority=low` to `IMG` tags in collapsed Details blocks (WordPress/gutenberg#76269) - Connectors: Add logo URL support for custom AI providers (WordPress/gutenberg#76190) - Cover Block: Add a playlist parameter to loop YouTube background videos. (WordPress/gutenberg#76004) - Connectors: Memoize getConnectors selector (WordPress/gutenberg#76339) - HTML Block: Fix broken layout (WordPress/gutenberg#76278) - Tests: Skip connector logo URL tests when AI Client is unavailable (WordPress/gutenberg#76343) - Navigation Overlay: Explicitly set fetchpriority for images (WordPress/gutenberg#76208) - Connectors: Show API key source for env vars and wp-config constants (WordPress/gutenberg#76355) - Connectors: Move API key validation and masking to REST dispatch level (WordPress/gutenberg#76327) - Connectors: Replace apiFetch with core-data store selectors (WordPress/gutenberg#76333) - Do not sync local attributes (WordPress/gutenberg#76267) - Add `fetchpriority=low` to `IMG` tags in collapsed Accordion Item blocks (WordPress/gutenberg#76336) - Implement disconnection debounce after initial connection (WordPress/gutenberg#76114) - Allow Post Content to be edited when 'Show template' is active and Post content is nested in a Template Part (WordPress/gutenberg#76305) - Fix: Document Bar: Back button flickers (WordPress/gutenberg#76320) - RTC: Move event hooks from editor to core-data (WordPress/gutenberg#76358) - fix(navigation): prevent right-justified submenu overflow in custom overlays (WordPress/gutenberg#76360) - Connectors: Add connectors registry for extensibility (WordPress/gutenberg#76364) - Connectors: Add empty state when no connectors are registered (WordPress/gutenberg#76375) - Temp: Disable RTC in the site editor (WordPress/gutenberg#76223) - Connectors: Add AI Experiments plugin callout with install/activate functionality (WordPress/gutenberg#76379) - Editor: Polish real-time collaboration presence UI and move Avatar to editor package (WordPress/gutenberg#75652) (WordPress/gutenberg#76365) - RTC: Add collaborator selection highlighting in rich text (WordPress/gutenberg#76107) - Sync changes from `wp_enqueue_global_styles()` to Gutenberg override (WordPress/gutenberg#76127) - [RTC] Fix performance regression on post save (WordPress/gutenberg#76370) - Media: Enable AVIF support for client-side uploads (WordPress/gutenberg#76371) - Connectors: Move plugin status computation to script module data (WordPress/gutenberg#76409) - Revisions: Skip rendered fields in REST API responses (WordPress/gutenberg#76347) - E2E Tests: Add connector setup flow tests with test AI provider (WordPress/gutenberg#76433) - RTC: Place sync connection modal in front of popover (WordPress/gutenberg#76431) - Connectors: Sync PHP code with WordPress Core (WordPress/gutenberg#76443) - Editor: Show own presence in collaborative editing sessions (WordPress/gutenberg#76413) (WordPress/gutenberg#76445) A full list of changes can be found on GitHub: https://github.com/WordPress/gutenberg/compare/9b8144036fa5faf75de43d4502ff9809fcf689ad…8c78d87453509661a9f28f978ba2c242d515563b. Log created with: git log --reverse --format="- %s" 9b8144036fa5faf75de43d4502ff9809fcf689ad..8c78d87453509661a9f28f978ba2c242d515563b | sed 's|#\([0-9][0-9]*\)|https://github.com/WordPress/gutenberg/pull/\1|g; /github\.com\/WordPress\/gutenberg\/pull/!d' | pbcopy See #64595. git-svn-id: https://develop.svn.wordpress.org/trunk@61988 602fd350-edb4-49c9-b593-d223f7449a82

This updates the pinned hash from the `gutenberg` from `9b8144036fa5faf75de43d4502ff9809fcf689ad` to `8c78d87453509661a9f28f978ba2c242d515563b`. The following changes are included: - Navigation Editor: Allow any blocks to be inserted by gating contentOnly insertion rules to section blocks (WordPress/gutenberg#76189) - Add `fetchpriority=low` to `IMG` tags in collapsed Details blocks (WordPress/gutenberg#76269) - Connectors: Add logo URL support for custom AI providers (WordPress/gutenberg#76190) - Cover Block: Add a playlist parameter to loop YouTube background videos. (WordPress/gutenberg#76004) - Connectors: Memoize getConnectors selector (WordPress/gutenberg#76339) - HTML Block: Fix broken layout (WordPress/gutenberg#76278) - Tests: Skip connector logo URL tests when AI Client is unavailable (WordPress/gutenberg#76343) - Navigation Overlay: Explicitly set fetchpriority for images (WordPress/gutenberg#76208) - Connectors: Show API key source for env vars and wp-config constants (WordPress/gutenberg#76355) - Connectors: Move API key validation and masking to REST dispatch level (WordPress/gutenberg#76327) - Connectors: Replace apiFetch with core-data store selectors (WordPress/gutenberg#76333) - Do not sync local attributes (WordPress/gutenberg#76267) - Add `fetchpriority=low` to `IMG` tags in collapsed Accordion Item blocks (WordPress/gutenberg#76336) - Implement disconnection debounce after initial connection (WordPress/gutenberg#76114) - Allow Post Content to be edited when 'Show template' is active and Post content is nested in a Template Part (WordPress/gutenberg#76305) - Fix: Document Bar: Back button flickers (WordPress/gutenberg#76320) - RTC: Move event hooks from editor to core-data (WordPress/gutenberg#76358) - fix(navigation): prevent right-justified submenu overflow in custom overlays (WordPress/gutenberg#76360) - Connectors: Add connectors registry for extensibility (WordPress/gutenberg#76364) - Connectors: Add empty state when no connectors are registered (WordPress/gutenberg#76375) - Temp: Disable RTC in the site editor (WordPress/gutenberg#76223) - Connectors: Add AI Experiments plugin callout with install/activate functionality (WordPress/gutenberg#76379) - Editor: Polish real-time collaboration presence UI and move Avatar to editor package (WordPress/gutenberg#75652) (WordPress/gutenberg#76365) - RTC: Add collaborator selection highlighting in rich text (WordPress/gutenberg#76107) - Sync changes from `wp_enqueue_global_styles()` to Gutenberg override (WordPress/gutenberg#76127) - [RTC] Fix performance regression on post save (WordPress/gutenberg#76370) - Media: Enable AVIF support for client-side uploads (WordPress/gutenberg#76371) - Connectors: Move plugin status computation to script module data (WordPress/gutenberg#76409) - Revisions: Skip rendered fields in REST API responses (WordPress/gutenberg#76347) - E2E Tests: Add connector setup flow tests with test AI provider (WordPress/gutenberg#76433) - RTC: Place sync connection modal in front of popover (WordPress/gutenberg#76431) - Connectors: Sync PHP code with WordPress Core (WordPress/gutenberg#76443) - Editor: Show own presence in collaborative editing sessions (WordPress/gutenberg#76413) (WordPress/gutenberg#76445) A full list of changes can be found on GitHub: https://github.com/WordPress/gutenberg/compare/9b8144036fa5faf75de43d4502ff9809fcf689ad…8c78d87453509661a9f28f978ba2c242d515563b. Log created with: git log --reverse --format="- %s" 9b8144036fa5faf75de43d4502ff9809fcf689ad..8c78d87453509661a9f28f978ba2c242d515563b | sed 's|#\([0-9][0-9]*\)|https://github.com/WordPress/gutenberg/pull/\1|g; /github\.com\/WordPress\/gutenberg\/pull/!d' | pbcopy See #64595. Built from https://develop.svn.wordpress.org/trunk@61988 git-svn-id: http://core.svn.wordpress.org/trunk@61270 1a063a9b-81f0-0310-95a4-ce76da25c4cd

gziolo mentioned this pull request Mar 10, 2026

Connectors: Add connectors registry for extensibility WordPress/wordpress-develop#11175

Closed

8 tasks

gziolo and others added 3 commits March 11, 2026 09:39

Connectors: Polyfill wp_is_connector_registered, wp_get_connector, wp…

ef11e2b

…_get_connectors Uses function_exists guards so plugins can use the wp_* names now and seamlessly switch to core's implementation once WordPress 7.0 ships. Co-Authored-By: Claude Opus 4.6 <[email protected]>

gziolo force-pushed the add/connectors-registry branch from 6aa9067 to 462a198 Compare March 11, 2026 08:39

gziolo self-assigned this Mar 11, 2026

Connectors: Add backport changelog entry for wordpress-develop#11175

8143d8a

Co-Authored-By: Claude Opus 4.6 <[email protected]>

gziolo marked this pull request as ready for review March 11, 2026 08:44

gziolo requested a review from spacedmonkey as a code owner March 11, 2026 08:44

gziolo requested review from felixarntz and jorgefilipecosta March 11, 2026 09:03

felixarntz approved these changes Mar 11, 2026

View reviewed changes

gziolo merged commit 4b5606b into trunk Mar 11, 2026
43 of 45 checks passed

gziolo deleted the add/connectors-registry branch March 11, 2026 15:32

github-actions bot mentioned this pull request Mar 11, 2026

PHP backports for WP 7.0 #74043

Open

github-actions bot added this to the Gutenberg 22.8 milestone Mar 11, 2026

github-actions bot removed the Backport to WP 7.0 Beta/RC Pull request that needs to be backported to the WordPress major release that's currently in beta label Mar 11, 2026

github-actions bot added the Backported to WP Core Pull request that has been successfully merged into WP Core label Mar 11, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Connectors: Add connectors registry for extensibility#76364

Connectors: Add connectors registry for extensibility#76364
gziolo merged 6 commits intotrunkfrom
add/connectors-registry

gziolo commented Mar 10, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Mar 10, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Mar 11, 2026 •

edited

Loading

Uh oh!

gziolo commented Mar 11, 2026

Uh oh!

felixarntz Mar 11, 2026

Uh oh!

gziolo Mar 11, 2026

Uh oh!

Uh oh!

github-actions bot commented Mar 11, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

gziolo commented Mar 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Test plan

Uh oh!

github-actions bot commented Mar 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Mar 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

gziolo commented Mar 11, 2026

Uh oh!

felixarntz Mar 11, 2026

Choose a reason for hiding this comment

Uh oh!

gziolo Mar 11, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

github-actions bot commented Mar 11, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

gziolo commented Mar 10, 2026 •

edited

Loading

github-actions bot commented Mar 10, 2026 •

edited

Loading

github-actions bot commented Mar 11, 2026 •

edited

Loading