WP_Connector_Registry

48final class WP_Connector_Registry {49	/**50	 * The singleton instance of the registry.51	 *52	 * @since 7.0.053	 */54	private static ?WP_Connector_Registry $instance = null;55 56	/**57	 * Holds the registered connectors.58	 *59	 * Each connector is stored as an associative array with keys:60	 * name, description, type, authentication, and optionally plugin.61	 *62	 * @since 7.0.063	 * @var array<string, array>64	 * @phpstan-var array<string, Connector>65	 */66	private array $registered_connectors = array();67 68	/**69	 * Registers a new connector.70	 *71	 * Validates the provided arguments and stores the connector in the registry.72	 * For connectors with `api_key` or `application_password` authentication, a73	 * `setting_name` can be provided explicitly. When omitted, setting names are74	 * automatically generated using the pattern `connectors_{$type}_{$id}_{$method}`,75	 * with hyphens in the type and ID normalized to underscores. These setting76	 * names are used for Settings API registration and REST API exposure.77	 *78	 * Registering a connector with an ID that is already registered will trigger a79	 * `_doing_it_wrong()` notice and return `null`. To override an existing connector,80	 * call `unregister()` first.81	 *82	 * @since 7.0.083	 *84	 * @see WP_Connector_Registry::unregister()85	 *86	 * @param string $id   The unique connector identifier. Must match the pattern87	 *                     `/^[a-z0-9_-]+$/` (lowercase alphanumeric, hyphens, and underscores only).88	 * @param array  $args {89	 *     An associative array of arguments for the connector.90	 *91	 *     @type string $name           Required. The connector's display name.92	 *     @type string $description    Optional. The connector's description. Default empty string.93	 *     @type string $logo_url       Optional. URL to the connector's logo image.94	 *     @type string $type           Required. The connector type, e.g. 'ai_provider'.95	 *     @type array  $authentication {96	 *         Required. Authentication configuration.97	 *98	 *         @type string $method          Required. The authentication method: 'api_key',99	 *                                       'application_password', or 'none'.100	 *         @type string $credentials_url Optional. URL where users can obtain API credentials.101	 *         @type string $setting_name    Optional. The setting name for the API key102	 *                                       or application-password credentials. When103	 *                                       omitted, auto-generated as104	 *                                       `connectors_{$type}_{$id}_api_key` for API105	 *                                       keys and `connectors_{$type}_{$id}_application_password`106	 *                                       for application passwords.107	 *                                       Must be a non-empty string when provided.108	 *         @type string $constant_name   Optional. PHP constant name for the API key109	 *                                       (e.g. 'ANTHROPIC_API_KEY') or for application-password110	 *                                       credentials in `username:password` format. Only checked111	 *                                       when provided.112	 *         @type string $env_var_name    Optional. Environment variable name for the API key113	 *                                       (e.g. 'ANTHROPIC_API_KEY') or for application-password114	 *                                       credentials in `username:password` format. Only checked115	 *                                       when provided.116	 *     }117	 *     @type array  $plugin         {118	 *         Optional. Plugin data for install/activate UI.119	 *120	 *         @type string   $file      Optional. The plugin's main file path relative to the121	 *                                   plugins directory (e.g. 'my-plugin/my-plugin.php' or122	 *                                   'hello.php').123	 *         @type callable $is_active Optional callback to determine whether the plugin124	 *                                   is active. Receives no arguments and must return bool.125	 *                                   Defaults to `__return_true`.126	 *     }127	 * }