registry = $registry;
}
/**
* Renders the widget content.
*
* Determines whether to show the getting-started checklist or
* the full status view based on setup completion.
*
* @since 0.8.0
*/
public function render(): void {
$has_credentials = has_ai_credentials();
$global_enabled = (bool) get_option( Settings_Registration::GLOBAL_OPTION, false );
$feature_setting_enabled = $this->has_any_enabled_feature_setting();
if ( $has_credentials && $global_enabled && $feature_setting_enabled ) {
$this->render_status();
} else {
$this->render_getting_started( $has_credentials, $global_enabled, $feature_setting_enabled );
}
}
/**
* Renders the getting-started checklist.
*
* @since 0.8.0
*
* @param bool $has_credentials Whether any AI provider credentials are configured.
* @param bool $global_enabled Whether the global features toggle is on.
* @param bool $feature_setting_enabled Whether at least one feature setting is enabled.
*/
private function render_getting_started( bool $has_credentials, bool $global_enabled, bool $feature_setting_enabled ): void {
$steps = array(
array(
'done' => $has_credentials,
'label' => __( 'Configure an AI provider', 'ai' ),
'url' => admin_url( 'options-connectors.php' ),
),
array(
'done' => $global_enabled,
'label' => __( 'Globally enable AI Features', 'ai' ),
'url' => admin_url( 'options-general.php?page=ai-wp-admin' ),
),
array(
'done' => $feature_setting_enabled,
'label' => __( 'Enable a feature or experiment', 'ai' ),
'url' => admin_url( 'options-general.php?page=ai-wp-admin' ),
),
);
?>
get_ai_connectors();
$stable_features = $this->registry->get_features_by_stability( 'stable' );
$experimental_features = $this->registry->get_features_by_stability( 'experimental' );
?>
-
is_enabled() ) : ?>
get_label() ); ?>
-
is_enabled() ) : ?>
get_label() ); ?>
Connector info.
*/
private function get_ai_connectors(): array {
$connectors = array();
foreach ( get_ai_connectors() as $slug => $connector_data ) {
$auth = $connector_data['authentication'];
$configured = 'api_key' === $auth['method']
&& is_connector_configured( $slug );
/**
* Filters whether an AI connector is configured.
*
* Allows third-party plugins to declare credential availability for
* connectors that do not rely on API key settings.
*
* The dynamic portion of the hook name, `$slug`, refers to the connector slug.
* For example, if the connector slug is 'openai', the hook name
* will be 'wpai_is_openai_connector_configured'.
*
* @since 0.9.0
*
* @param bool $configured Whether the connector is configured.
* @param array $connector_data The connector data.
*/
$configured = (bool) apply_filters( "wpai_is_{$slug}_connector_configured", $configured, $connector_data );
$connectors[] = array(
'name' => $connector_data['name'] ?? $slug,
'configured' => $configured,
);
}
return $connectors;
}
/**
* Checks whether any registered feature has its individual setting enabled.
*
* @since 0.8.0
*
* @return bool True if at least one feature setting is enabled.
*/
private function has_any_enabled_feature_setting(): bool {
foreach ( $this->registry->get_all_features() as $feature ) {
if ( $feature->is_individually_enabled() ) {
return true;
}
}
return false;
}
}