',
esc_html__( 'The edited image was saved as a new item in the Media Library. The original is unchanged.', 'ai-chat-for-amazon-bedrock' ),
esc_url( (string) get_edit_post_link( (int) $outcome['attachment'] ) ),
esc_html__( 'Open it', 'ai-chat-for-amazon-bedrock' )
);
return;
}
printf(
'
%s
',
esc_html( isset( $outcome['error'] ) ? (string) $outcome['error'] : __( 'The image could not be edited.', 'ai-chat-for-amazon-bedrock' ) )
);
}
/**
* Index one batch of posts for semantic search.
*/
public function ajax_index_embeddings() {
if ( ! current_user_can( 'manage_options' ) ) {
wp_send_json_error( array( 'message' => __( 'Permission denied.', 'ai-chat-for-amazon-bedrock' ) ), 403 );
}
check_ajax_referer( 'ai_chat_bedrock_admin', 'nonce' );
if ( ! AI_Chat_Bedrock_Embeddings::enabled() ) {
wp_send_json_error( array( 'message' => __( 'Choose an embedding model first.', 'ai-chat-for-amazon-bedrock' ) ), 400 );
}
wp_send_json_success( AI_Chat_Bedrock_Embeddings::index_batch() );
}
/**
* Delete every stored vector.
*/
public function handle_clear_embeddings() {
if ( ! current_user_can( 'manage_options' ) ) {
wp_die( esc_html__( 'Permission denied.', 'ai-chat-for-amazon-bedrock' ), '', array( 'response' => 403 ) );
}
check_admin_referer( 'ai_chat_bedrock_clear_embeddings' );
$cleared = AI_Chat_Bedrock_Embeddings::clear();
$target = admin_url( 'admin.php?page=' . $this->plugin_name . '-settings&tab=knowledge' );
if ( is_wp_error( $cleared ) ) {
// Nothing local was reset, so the index and the records of it still agree.
wp_safe_redirect(
add_query_arg(
array(
'aicfab-transfer' => 'error',
'aicfab-message' => rawurlencode( $cleared->get_error_message() ),
),
$target
)
);
exit;
}
wp_safe_redirect( add_query_arg( 'aicfab-cleared', (int) $cleared, $target ) );
exit;
}
/**
* Check or create the configured S3 Vectors index.
*/
public function ajax_s3_vectors() {
if ( ! current_user_can( 'manage_options' ) || ! check_ajax_referer( 'ai_chat_bedrock_s3_vectors', 'nonce', false ) ) {
wp_send_json_error( array( 'message' => __( 'Security check failed.', 'ai-chat-for-amazon-bedrock' ) ), 403 );
}
$options = get_option( 'ai_chat_bedrock_settings', array() );
$options = is_array( $options ) ? $options : array();
$model = isset( $options['embedding_model_id'] ) ? (string) $options['embedding_model_id'] : '';
if ( '' === $model || ! AI_Chat_Bedrock_S3_Vectors::enabled( $options ) ) {
wp_send_json_error( array( 'message' => __( 'Choose an embedding model, Amazon S3 Vectors, a bucket and an index, and save first.', 'ai-chat-for-amazon-bedrock' ) ), 400 );
}
$operation = isset( $_POST['op'] ) ? sanitize_key( wp_unslash( $_POST['op'] ) ) : 'check';
if ( 'create' === $operation ) {
$created = AI_Chat_Bedrock_S3_Vectors::create_index( $model, $options );
if ( is_wp_error( $created ) && 'aicfab_s3v_ConflictException' !== $created->get_error_code() ) {
wp_send_json_error( array( 'message' => $created->get_error_message() ), 400 );
}
}
$index = AI_Chat_Bedrock_S3_Vectors::describe_index( $model, $options );
if ( is_wp_error( $index ) ) {
$message = 'aicfab_s3v_NotFoundException' === $index->get_error_code()
? __( 'The index does not exist yet. Create it here, or in the Amazon S3 console with the cosine metric and text and title as non-filterable metadata.', 'ai-chat-for-amazon-bedrock' )
: $index->get_error_message();
wp_send_json_error( array( 'message' => $message ), 400 );
}
if ( ! empty( $index['problems'] ) ) {
wp_send_json_error( array( 'message' => AI_Chat_Bedrock_Translation::sentences( ...$index['problems'] ) ), 400 );
}
wp_send_json_success(
array(
'message' => sprintf(
/* translators: %d: vector dimension. */
__( 'The index is ready: %d dimensions, cosine metric.', 'ai-chat-for-amazon-bedrock' ),
(int) $index['dimension']
),
)
);
}
/**
* Send the conversation log as a CSV download.
*/
public function handle_export_conversations() {
if ( ! current_user_can( 'manage_options' ) ) {
wp_die( esc_html__( 'Permission denied.', 'ai-chat-for-amazon-bedrock' ), '', array( 'response' => 403 ) );
}
check_admin_referer( 'ai_chat_bedrock_export_conversations' );
$rows = AI_Chat_Bedrock_Conversations::export_rows();
$filename = 'ai-chat-bedrock-conversations-' . gmdate( 'Ymd-His' ) . '.csv';
nocache_headers();
header( 'Content-Type: text/csv; charset=utf-8' );
header( 'Content-Disposition: attachment; filename="' . $filename . '"' );
/*
* A download is streamed straight to the client, so WP_Filesystem does not apply:
* there is no file on disk, only the response body.
*/
$handle = fopen( 'php://output', 'w' ); // phpcs:ignore WordPress.WP.AlternativeFunctions.file_system_operations_fopen
if ( false === $handle ) {
wp_die( esc_html__( 'The export could not be created.', 'ai-chat-for-amazon-bedrock' ) );
}
foreach ( $rows as $row ) {
// Neutralize values a spreadsheet would treat as a formula.
$row = array_map(
static function ( $value ) {
$value = (string) $value;
return ( '' !== $value && in_array( $value[0], array( '=', '+', '-', '@' ), true ) ) ? "'" . $value : $value;
},
$row
);
// No escape character, as in RFC 4180. Leaving it out is deprecated since PHP 8.4, and the
// notice would be written into the download where errors are displayed.
fputcsv( $handle, $row, ',', '"', '' ); // phpcs:ignore WordPress.WP.AlternativeFunctions.file_system_operations_fputcsv
}
fclose( $handle ); // phpcs:ignore WordPress.WP.AlternativeFunctions.file_system_operations_fclose
exit;
}
/**
* Download the same content gaps shown in the editorial panel, for the period it shows.
*/
public function handle_export_gaps() {
if ( ! current_user_can( 'manage_options' ) ) {
wp_die( esc_html__( 'Permission denied.', 'ai-chat-for-amazon-bedrock' ), '', array( 'response' => 403 ) );
}
check_admin_referer( 'ai_chat_bedrock_export_gaps' );
// Read only once the capability and nonce are checked. A missing or unrecognised period exports 30 days.
$raw_days = isset( $_POST['aicfab_gap_days'] ) && is_scalar( $_POST['aicfab_gap_days'] ) ? wp_unslash( $_POST['aicfab_gap_days'] ) : null; // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- only 7, 30 or 90 pass gap_window().
$days = AI_Chat_Bedrock_Insights::gap_window( $raw_days );
$rows = AI_Chat_Bedrock_Insights::export_rows( array( 'days' => $days ) );
$filename = AI_Chat_Bedrock_Insights::export_filename( $days, time() );
nocache_headers();
header( 'Content-Type: text/csv; charset=utf-8' );
header( 'Content-Disposition: attachment; filename="' . $filename . '"' );
// This is a response stream, not a file on disk; WP_Filesystem does not apply.
$handle = fopen( 'php://output', 'w' ); // phpcs:ignore WordPress.WP.AlternativeFunctions.file_system_operations_fopen
if ( false === $handle ) {
wp_die( esc_html__( 'The export could not be created.', 'ai-chat-for-amazon-bedrock' ) );
}
foreach ( $rows as $row ) {
$row = array_map(
static function ( $value ) {
$value = (string) $value;
// Also cover whitespace before a spreadsheet formula.
return preg_match( '/^[\x00-\x20]*[=+\-@]/', $value ) ? "'" . $value : $value;
},
$row
);
// An empty escape character preserves literal backslashes and RFC 4180 quoting.
fputcsv( $handle, $row, ',', '"', '' ); // phpcs:ignore WordPress.WP.AlternativeFunctions.file_system_operations_fputcsv
}
fclose( $handle ); // phpcs:ignore WordPress.WP.AlternativeFunctions.file_system_operations_fclose
exit;
}
/**
* The query fields of the Business insights form, read from a request.
*
* Values are only passed on: AI_Chat_Bedrock_Metrics::normalize() checks each one
* against its fixed list.
*
* @param array $source $_GET or $_POST, unslashed.
* @return array
*/
public static function metrics_query_args( $source ) {
$args = array();
foreach ( array( 'metric', 'period', 'after', 'before', 'compare', 'interval', 'dimension', 'limit' ) as $key ) {
if ( isset( $source[ $key ] ) && is_scalar( $source[ $key ] ) ) {
$args[ $key ] = sanitize_text_field( (string) $source[ $key ] );
}
}
return $args;
}
/**
* Turn a question in words into a query, and show its figure on the Business insights screen.
*
* The question is not put in the address; only the query it became, or an error code.
*/
public function handle_metrics_ask() {
if ( ! current_user_can( AI_Chat_Bedrock_Metrics::CAPABILITY ) ) {
wp_die( esc_html__( 'Permission denied.', 'ai-chat-for-amazon-bedrock' ), '', array( 'response' => 403 ) );
}
check_admin_referer( 'ai_chat_bedrock_metrics_ask' );
$question = isset( $_POST['aicfab_question'] ) && is_scalar( $_POST['aicfab_question'] ) ? sanitize_textarea_field( wp_unslash( $_POST['aicfab_question'] ) ) : '';
$plan = AI_Chat_Bedrock_Metrics::plan( $question );
$url = admin_url( 'admin.php?page=' . $this->plugin_name . '-metrics' );
if ( is_wp_error( $plan ) ) {
$url = add_query_arg( 'aicfab_ask_error', rawurlencode( sanitize_key( $plan->get_error_code() ) ), $url );
} else {
unset( $plan['notes'] );
$url = add_query_arg( array_map( 'rawurlencode', array_map( 'strval', $plan ) ) + array( 'aicfab_asked' => '1' ), $url );
}
wp_safe_redirect( $url );
exit;
}
/**
* Download the figure shown on the Business insights screen as CSV.
*/
public function handle_export_metrics() {
if ( ! current_user_can( AI_Chat_Bedrock_Metrics::CAPABILITY ) ) {
wp_die( esc_html__( 'Permission denied.', 'ai-chat-for-amazon-bedrock' ), '', array( 'response' => 403 ) );
}
check_admin_referer( 'ai_chat_bedrock_export_metrics' );
$result = AI_Chat_Bedrock_Metrics::query( self::metrics_query_args( wp_unslash( $_POST ) ), 'analytics' );
if ( is_wp_error( $result ) ) {
wp_die( esc_html( $result->get_error_message() ), '', array( 'response' => 400 ) );
}
$this->send_csv( AI_Chat_Bedrock_Metrics::export_rows( $result ), AI_Chat_Bedrock_Metrics::export_filename( $result ) );
}
/**
* Stream rows as a CSV download and stop.
*
* @param array $rows Rows, the header first.
* @param string $filename File name.
*/
private function send_csv( $rows, $filename ) {
nocache_headers();
header( 'Content-Type: text/csv; charset=utf-8' );
header( 'Content-Disposition: attachment; filename="' . $filename . '"' );
// This is a response stream, not a file on disk; WP_Filesystem does not apply.
$handle = fopen( 'php://output', 'w' ); // phpcs:ignore WordPress.WP.AlternativeFunctions.file_system_operations_fopen
if ( false === $handle ) {
wp_die( esc_html__( 'The export could not be created.', 'ai-chat-for-amazon-bedrock' ) );
}
foreach ( $rows as $row ) {
$row = array_map(
static function ( $value ) {
$value = (string) $value;
// A plain number, such as net sales after refunds, stays a number.
if ( preg_match( '/\A-?[0-9]+(?:\.[0-9]+)?\z/', $value ) ) {
return $value;
}
// Also cover whitespace before a spreadsheet formula.
return preg_match( '/^[\x00-\x20]*[=+\-@]/', $value ) ? "'" . $value : $value;
},
$row
);
// An empty escape character preserves literal backslashes and RFC 4180 quoting.
fputcsv( $handle, $row, ',', '"', '' ); // phpcs:ignore WordPress.WP.AlternativeFunctions.file_system_operations_fputcsv
}
fclose( $handle ); // phpcs:ignore WordPress.WP.AlternativeFunctions.file_system_operations_fclose
exit;
}
/**
* Offer alt text generation as a media library bulk action.
*
* @param array $actions Existing bulk actions.
* @return array
*/
public function add_media_bulk_action( $actions ) {
if ( ! AI_Chat_Bedrock_Media_Assistant::enabled() || ! current_user_can( 'upload_files' ) ) {
return $actions;
}
$actions['ai_chat_bedrock_alt_text'] = __( 'Generate alt text', 'ai-chat-for-amazon-bedrock' );
return $actions;
}
/**
* Run alt text generation for the selected attachments.
*
* Capped per request because every image is a paid model call, and images that
* already have alt text are skipped rather than overwritten.
*
* @param string $redirect Redirect URL.
* @param string $action Requested action.
* @param array $ids Selected attachment IDs.
* @return string
*/
public function handle_media_bulk_action( $redirect, $action, $ids ) {
if ( 'ai_chat_bedrock_alt_text' !== $action ) {
return $redirect;
}
if ( ! AI_Chat_Bedrock_Media_Assistant::enabled() ) {
return $redirect;
}
$ids = array_slice( array_map( 'absint', (array) $ids ), 0, AI_Chat_Bedrock_Media_Assistant::MAX_BULK );
$media = new AI_Chat_Bedrock_Media_Assistant();
$done = 0;
$skipped = 0;
$failed = 0;
foreach ( $ids as $id ) {
if ( ! current_user_can( 'edit_post', $id ) ) {
++$failed;
continue;
}
$result = $media->generate_alt_text( $id, false );
if ( is_wp_error( $result ) ) {
++$failed;
} elseif ( ! empty( $result['skipped'] ) ) {
++$skipped;
} else {
++$done;
}
}
return add_query_arg(
array(
'aicfab-alt-done' => $done,
'aicfab-alt-skipped' => $skipped,
'aicfab-alt-failed' => $failed,
),
$redirect
);
}
/**
* Report the outcome of alt text generation and image edits on the media screen.
*/
public function render_media_notice() {
$screen = function_exists( 'get_current_screen' ) ? get_current_screen() : null;
if ( ! $screen || 'upload' !== $screen->id ) {
return;
}
$this->render_image_edit_notice();
$single = isset( $_GET['aicfab-alt'] ) ? sanitize_key( wp_unslash( $_GET['aicfab-alt'] ) ) : ''; // phpcs:ignore WordPress.Security.NonceVerification.Recommended
if ( '' !== $single ) {
if ( 'saved' === $single ) {
$message = __( 'Alt text generated and saved.', 'ai-chat-for-amazon-bedrock' );
$class = 'notice-success';
} elseif ( 'skipped' === $single ) {
$message = __( 'That image already has alt text, so it was left unchanged.', 'ai-chat-for-amazon-bedrock' );
$class = 'notice-info';
} else {
$message = __( 'Alt text could not be generated for that image.', 'ai-chat-for-amazon-bedrock' );
$class = 'notice-error';
}
printf( '
',
esc_html__( 'AI Chatbot, Agents & MCP for Amazon Bedrock:', 'ai-chat-for-amazon-bedrock' ),
esc_html__( 'no usable AWS credentials were found, so the chat cannot answer yet. An Amazon Bedrock API key is the quickest way to connect.', 'ai-chat-for-amazon-bedrock' ),
esc_url( admin_url( 'admin.php?page=' . $this->plugin_name . '-settings' ) ),
esc_html__( 'Finish setup', 'ai-chat-for-amazon-bedrock' )
);
// The notice is shown on every admin screen, where the plugin's own script is not
// loaded. Core's common.js adds the dismiss button; this remembers the click, which
// the check above has always read but nothing ever wrote.
wp_add_inline_script(
'common',
sprintf(
'jQuery( document ).on( "click", ".aicfab-setup-notice .notice-dismiss", function () { jQuery.post( ajaxurl, { action: "ai_chat_bedrock_dismiss_setup_notice", _ajax_nonce: %s } ); } );',
wp_json_encode( wp_create_nonce( 'ai_chat_bedrock_dismiss_setup_notice' ) )
)
);
}
/**
* Say on the plugin's own screens that the chat is answering in demo mode.
*
* The Live Preview turns demo mode on, and whoever tries it there should know that the
* replies quote the site's pages rather than come from a model. It goes away by itself
* once credentials are found, so there is nothing to dismiss.
*/
public function render_demo_notice() {
if ( ! current_user_can( 'manage_options' ) || ! AI_Chat_Bedrock_Demo::active() ) {
return;
}
$screen = function_exists( 'get_current_screen' ) ? get_current_screen() : null;
if ( ! $screen || false === strpos( (string) $screen->id, $this->plugin_name ) ) {
return;
}
printf(
'
',
esc_html__( 'Demo mode: the chat replies with the passage of this site\'s pages that best matches each question, and no AI model is called. Connect Amazon Bedrock to get written answers, which ends demo mode.', 'ai-chat-for-amazon-bedrock' ),
esc_url( admin_url( 'admin.php?page=' . $this->plugin_name . '-settings' ) ),
esc_html__( 'Connect Amazon Bedrock', 'ai-chat-for-amazon-bedrock' )
);
}
/**
* Ask once for a review, on the plugin's own screens, after the chat has proved itself.
*/
public function render_review_prompt() {
AI_Chat_Bedrock_Review_Prompt::render( $this->plugin_name );
}
/**
* Stop showing the setup notice to the current user.
*/
public function ajax_dismiss_setup_notice() {
if ( ! current_user_can( 'manage_options' ) || ! check_ajax_referer( 'ai_chat_bedrock_dismiss_setup_notice', false, false ) ) {
wp_send_json_error( array( 'message' => __( 'Security check failed.', 'ai-chat-for-amazon-bedrock' ) ), 403 );
}
update_user_meta( get_current_user_id(), 'aicfab_dismissed_setup_notice', 1 );
wp_send_json_success();
}
/**
* Generate a draft post from a topic.
*/
public function handle_generate_content() {
if ( ! current_user_can( 'edit_posts' ) ) {
wp_die( esc_html__( 'Permission denied.', 'ai-chat-for-amazon-bedrock' ), '', array( 'response' => 403 ) );
}
check_admin_referer( 'ai_chat_bedrock_generate_content' );
$generator = new AI_Chat_Bedrock_Content_Generator();
$result = $generator->generate(
array(
'topic' => isset( $_POST['topic'] ) ? wp_unslash( $_POST['topic'] ) : '', // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
'notes' => isset( $_POST['notes'] ) ? wp_unslash( $_POST['notes'] ) : '', // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
'tone' => isset( $_POST['tone'] ) ? wp_unslash( $_POST['tone'] ) : '', // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
'length' => isset( $_POST['length'] ) ? wp_unslash( $_POST['length'] ) : '', // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
'language' => isset( $_POST['language'] ) ? wp_unslash( $_POST['language'] ) : '', // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
)
);
$base = admin_url( 'admin.php?page=ai-chat-for-amazon-bedrock-generator' );
if ( is_wp_error( $result ) ) {
wp_safe_redirect( add_query_arg( 'aicfab-generated', $result->get_error_code(), $base ) );
exit;
}
wp_safe_redirect(
add_query_arg(
array(
'aicfab-generated' => 'draft',
'post_id' => (int) $result['id'],
),
$base
)
);
exit;
}
/**
* Save a chat profile.
*/
public function handle_save_profile() {
if ( ! current_user_can( 'manage_options' ) ) {
wp_die( esc_html__( 'Permission denied.', 'ai-chat-for-amazon-bedrock' ), '', array( 'response' => 403 ) );
}
check_admin_referer( 'ai_chat_bedrock_save_profile' );
$fields = array();
foreach ( array( 'key', 'label', 'model_id', 'system_prompt', 'chat_title', 'welcome_message', 'suggested_questions', 'max_tokens', 'temperature', 'rate_limit_per_minute', 'context_results', 'allow_public_chat', 'enable_site_context' ) as $field ) {
$fields[ $field ] = isset( $_POST[ $field ] ) ? wp_unslash( $_POST[ $field ] ) : ''; // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
}
$saved = AI_Chat_Bedrock_Profiles::save( $fields['key'], $fields );
$state = is_wp_error( $saved ) ? $saved->get_error_code() : 'saved';
wp_safe_redirect( add_query_arg( 'aicfab-profile', $state, admin_url( 'admin.php?page=ai-chat-for-amazon-bedrock-profiles' ) ) );
exit;
}
/**
* Delete a chat profile.
*/
public function handle_delete_profile() {
if ( ! current_user_can( 'manage_options' ) ) {
wp_die( esc_html__( 'Permission denied.', 'ai-chat-for-amazon-bedrock' ), '', array( 'response' => 403 ) );
}
check_admin_referer( 'ai_chat_bedrock_delete_profile' );
$key = isset( $_POST['key'] ) ? sanitize_key( wp_unslash( $_POST['key'] ) ) : '';
AI_Chat_Bedrock_Profiles::delete( $key );
wp_safe_redirect( add_query_arg( 'aicfab-profile', 'deleted', admin_url( 'admin.php?page=ai-chat-for-amazon-bedrock-profiles' ) ) );
exit;
}
/**
* Send the configuration as a downloadable file.
*/
public function handle_export_settings() {
if ( ! current_user_can( 'manage_options' ) ) {
wp_die( esc_html__( 'Permission denied.', 'ai-chat-for-amazon-bedrock' ), '', array( 'response' => 403 ) );
}
check_admin_referer( 'ai_chat_bedrock_export_settings' );
$payload = AI_Chat_Bedrock_Transfer::export();
$body = wp_json_encode( $payload, defined( 'JSON_PRETTY_PRINT' ) ? JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES : 0 );
$name = 'ai-chat-bedrock-settings-' . gmdate( 'Ymd-His' ) . '.json';
nocache_headers();
header( 'Content-Type: application/json; charset=utf-8' );
header( 'Content-Disposition: attachment; filename="' . $name . '"' );
header( 'Content-Length: ' . strlen( (string) $body ) );
echo $body; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- JSON body, not markup.
exit;
}
/**
* Apply a configuration file.
*/
public function handle_import_settings() {
if ( ! current_user_can( 'manage_options' ) ) {
wp_die( esc_html__( 'Permission denied.', 'ai-chat-for-amazon-bedrock' ), '', array( 'response' => 403 ) );
}
check_admin_referer( 'ai_chat_bedrock_import_settings' );
$json = '';
if ( ! empty( $_FILES['aicfab_import_file']['tmp_name'] ) && is_uploaded_file( $_FILES['aicfab_import_file']['tmp_name'] ) ) { // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- path checked by is_uploaded_file.
$size = isset( $_FILES['aicfab_import_file']['size'] ) ? (int) $_FILES['aicfab_import_file']['size'] : 0;
if ( $size > 0 && $size <= 512000 ) {
$json = (string) file_get_contents( $_FILES['aicfab_import_file']['tmp_name'] ); // phpcs:ignore WordPress.WP.AlternativeFunctions.file_get_contents_file_get_contents, WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
}
}
if ( '' === $json && isset( $_POST['aicfab_import_json'] ) ) {
$json = (string) wp_unslash( $_POST['aicfab_import_json'] ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- parsed as JSON below, never echoed.
}
$result = AI_Chat_Bedrock_Transfer::import( $json );
$state = is_wp_error( $result ) ? 'error' : 'imported';
$args = array( 'aicfab-transfer' => $state );
if ( is_wp_error( $result ) ) {
$args['aicfab-message'] = rawurlencode( $result->get_error_message() );
} else {
$args['aicfab-applied'] = count( $result['applied'] );
$args['aicfab-skipped'] = count( $result['skipped'] );
}
wp_safe_redirect( add_query_arg( $args, admin_url( 'admin.php?page=ai-chat-for-amazon-bedrock-settings&tab=transfer' ) ) );
exit;
}
/**
* Delete all stored conversations.
*/
public function handle_clear_conversations() {
if ( ! current_user_can( 'manage_options' ) ) {
wp_die( esc_html__( 'Permission denied.', 'ai-chat-for-amazon-bedrock' ), '', array( 'response' => 403 ) );
}
check_admin_referer( 'ai_chat_bedrock_clear_conversations' );
AI_Chat_Bedrock_Conversations::clear();
wp_safe_redirect( add_query_arg( 'aicfab-log', 'cleared', admin_url( 'admin.php?page=ai-chat-for-amazon-bedrock-conversations' ) ) );
exit;
}
/**
* Refresh the Bedrock model catalog for the configured region.
*/
public function ajax_refresh_models() {
if ( ! current_user_can( 'manage_options' ) || ! check_ajax_referer( 'ai_chat_bedrock_admin', 'nonce', false ) ) {
wp_send_json_error( array( 'message' => __( 'Security check failed.', 'ai-chat-for-amazon-bedrock' ) ), 403 );
}
if ( ! AI_Chat_Bedrock_Security::check_rate_limit( 'admin_refresh_models', 10, 60 ) ) {
wp_send_json_error( array( 'message' => __( 'Too many requests. Please wait a moment.', 'ai-chat-for-amazon-bedrock' ) ), 429 );
}
$models = AI_Chat_Bedrock_Models::refresh();
if ( is_wp_error( $models ) ) {
wp_send_json_error( array( 'message' => $models->get_error_message() ), 400 );
}
// The model menus are refilled in place from this list, instead of asking for a reload
// that would also throw away unsaved changes on the screen. A list, so the order holds.
$choices = array();
foreach ( $models as $value => $label ) {
$choices[] = array(
'value' => (string) $value,
'label' => (string) $label,
);
}
wp_send_json_success(
array(
/* translators: %d: number of models discovered. */
'message' => sprintf( _n( '%d model available. The model menus are up to date.', '%d models available. The model menus are up to date.', count( $models ), 'ai-chat-for-amazon-bedrock' ), count( $models ) ),
'count' => count( $models ),
'models' => $choices,
)
);
}
/**
* Run diagnostics, including a live Bedrock invocation.
*/
public function ajax_run_diagnostics() {
if ( ! current_user_can( 'manage_options' ) || ! check_ajax_referer( 'ai_chat_bedrock_admin', 'nonce', false ) ) {
wp_send_json_error( array( 'message' => __( 'Security check failed.', 'ai-chat-for-amazon-bedrock' ) ), 403 );
}
if ( ! AI_Chat_Bedrock_Security::check_rate_limit( 'admin_diagnostics', 6, 60 ) ) {
wp_send_json_error( array( 'message' => __( 'Too many requests. Please wait a moment.', 'ai-chat-for-amazon-bedrock' ) ), 429 );
}
$diagnostics = new AI_Chat_Bedrock_Diagnostics();
wp_send_json_success( array( 'checks' => $diagnostics->run( true ) ) );
}
public function register_settings() {
register_setting(
'ai_chat_bedrock_settings',
'ai_chat_bedrock_settings',
array(
'type' => 'array',
'sanitize_callback' => array( $this, 'validate_settings' ),
'default' => array(),
)
);
add_settings_section( 'aicfab_aws', __( 'AWS authentication', 'ai-chat-for-amazon-bedrock' ), array( $this, 'aws_settings_section_callback' ), 'aicfab_tab_aws' );
$this->field( 'aws_region', __( 'AWS Region', 'ai-chat-for-amazon-bedrock' ), 'aws_region_render', 'aicfab_aws' );
$this->field( 'bedrock_api_key', __( 'Amazon Bedrock API key', 'ai-chat-for-amazon-bedrock' ), 'bedrock_api_key_render', 'aicfab_aws' );
$this->field( 'aws_access_key', __( 'AWS Access Key ID', 'ai-chat-for-amazon-bedrock' ), 'aws_access_key_render', 'aicfab_aws' );
$this->field( 'aws_secret_key', __( 'AWS Secret Access Key', 'ai-chat-for-amazon-bedrock' ), 'aws_secret_key_render', 'aicfab_aws' );
$this->field( 'aws_session_token', __( 'AWS Session Token', 'ai-chat-for-amazon-bedrock' ), 'aws_session_token_render', 'aicfab_aws' );
$this->field( 'aws_use_role_credentials', __( 'IAM role credentials', 'ai-chat-for-amazon-bedrock' ), 'aws_use_role_credentials_render', 'aicfab_aws' );
add_settings_section( 'aicfab_model', __( 'Model', 'ai-chat-for-amazon-bedrock' ), '__return_false', 'aicfab_tab_model' );
$this->field( 'model_id', __( 'Model', 'ai-chat-for-amazon-bedrock' ), 'model_id_render', 'aicfab_model' );
$this->field( 'fallback_model_id', __( 'Fallback model', 'ai-chat-for-amazon-bedrock' ), 'fallback_model_render', 'aicfab_model' );
$this->field( 'max_tokens', __( 'Maximum output tokens', 'ai-chat-for-amazon-bedrock' ), 'max_tokens_render', 'aicfab_model' );
$this->field( 'temperature', __( 'Temperature', 'ai-chat-for-amazon-bedrock' ), 'temperature_render', 'aicfab_model' );
$this->field( 'image_model_id', __( 'Image model', 'ai-chat-for-amazon-bedrock' ), 'image_model_render', 'aicfab_model' );
add_settings_section( 'aicfab_knowledge', __( 'Answer grounding', 'ai-chat-for-amazon-bedrock' ), array( $this, 'knowledge_section_callback' ), 'aicfab_tab_knowledge' );
$this->field( 'enable_site_context', __( 'Use site content', 'ai-chat-for-amazon-bedrock' ), 'enable_site_context_render', 'aicfab_knowledge' );
$this->field( 'context_results', __( 'Passages per answer', 'ai-chat-for-amazon-bedrock' ), 'context_results_render', 'aicfab_knowledge' );
$this->field( 'show_sources', __( 'Show sources', 'ai-chat-for-amazon-bedrock' ), 'show_sources_render', 'aicfab_knowledge' );
$this->field( 'include_noindex', __( 'Pages hidden from search', 'ai-chat-for-amazon-bedrock' ), 'include_noindex_render', 'aicfab_knowledge' );
$this->field( 'embedding_model_id', __( 'Semantic search', 'ai-chat-for-amazon-bedrock' ), 'embedding_model_render', 'aicfab_knowledge' );
$this->field( 'vector_store', __( 'Vector store', 'ai-chat-for-amazon-bedrock' ), 'vector_store_render', 'aicfab_knowledge' );
$this->field( 'knowledge_base_id', __( 'Bedrock knowledge base ID', 'ai-chat-for-amazon-bedrock' ), 'knowledge_base_id_render', 'aicfab_knowledge' );
$this->field( 'rerank_model_id', __( 'Reranking', 'ai-chat-for-amazon-bedrock' ), 'rerank_model_render', 'aicfab_knowledge' );
add_settings_section( 'aicfab_chat', __( 'What visitors see', 'ai-chat-for-amazon-bedrock' ), '__return_false', 'aicfab_tab_chat' );
$this->field( 'system_prompt', __( 'System prompt', 'ai-chat-for-amazon-bedrock' ), 'system_prompt_render', 'aicfab_chat' );
$this->field( 'prompt_id', __( 'Managed prompt', 'ai-chat-for-amazon-bedrock' ), 'managed_prompt_render', 'aicfab_chat' );
$this->field( 'chat_title', __( 'Chat title', 'ai-chat-for-amazon-bedrock' ), 'chat_title_render', 'aicfab_chat' );
$this->field( 'welcome_message', __( 'Welcome message', 'ai-chat-for-amazon-bedrock' ), 'welcome_message_render', 'aicfab_chat' );
$this->field( 'suggested_questions', __( 'Suggested questions', 'ai-chat-for-amazon-bedrock' ), 'suggested_questions_render', 'aicfab_chat' );
$this->field( 'enable_streaming', __( 'Streaming responses', 'ai-chat-for-amazon-bedrock' ), 'enable_streaming_render', 'aicfab_chat' );
$this->field( 'chat_memory', __( 'Conversation memory', 'ai-chat-for-amazon-bedrock' ), 'chat_memory_render', 'aicfab_chat' );
$this->field( 'speech_replies', __( 'Read aloud', 'ai-chat-for-amazon-bedrock' ), 'speech_render', 'aicfab_chat' );
$this->field( 'leads_enabled', __( 'Contact requests', 'ai-chat-for-amazon-bedrock' ), 'leads_render', 'aicfab_chat' );
$this->field( 'analytics_events', __( 'Analytics events', 'ai-chat-for-amazon-bedrock' ), 'analytics_events_render', 'aicfab_chat' );
$this->field( 'popup_site_wide', __( 'Floating chat', 'ai-chat-for-amazon-bedrock' ), 'popup_site_wide_render', 'aicfab_chat' );
$this->field( 'chat_color_scheme', __( 'Color scheme', 'ai-chat-for-amazon-bedrock' ), 'chat_color_scheme_render', 'aicfab_chat' );
$this->field( 'chat_accent_color', __( 'Accent color', 'ai-chat-for-amazon-bedrock' ), 'chat_accent_color_render', 'aicfab_chat' );
// Tools the chat and editors use, beyond answering from the site's pages.
add_settings_section( 'aicfab_agents', __( 'Agents and tools', 'ai-chat-for-amazon-bedrock' ), '__return_false', 'aicfab_tab_agents' );
$this->field( 'abilities_tools', __( 'WordPress abilities as tools', 'ai-chat-for-amazon-bedrock' ), 'abilities_tools_render', 'aicfab_agents' );
$this->field( 'site_abilities', __( 'Site content abilities', 'ai-chat-for-amazon-bedrock' ), 'site_abilities_render', 'aicfab_agents' );
$this->field( 'site_ontology', __( 'Site description', 'ai-chat-for-amazon-bedrock' ), 'site_ontology_render', 'aicfab_agents' );
$this->field( 'llms_txt', __( 'llms.txt', 'ai-chat-for-amazon-bedrock' ), 'llms_txt_render', 'aicfab_agents' );
$this->field( 'business_metrics', __( 'Business insights', 'ai-chat-for-amazon-bedrock' ), 'business_metrics_render', 'aicfab_agents' );
$this->field( 'editor_assistant', __( 'Editor assistant', 'ai-chat-for-amazon-bedrock' ), 'editor_assistant_render', 'aicfab_agents' );
$this->field( 'media_assistant', __( 'Media helpers', 'ai-chat-for-amazon-bedrock' ), 'media_assistant_render', 'aicfab_agents' );
// The WeChat Official Account and mini game are separate accounts, set up side by side.
// Channels has a page for each kind of account, so no one scrolls past the others: an
// Official Account and a mini game are separate WeChat accounts with their own settings.
add_settings_section( 'aicfab_wechat', __( 'WeChat Official Account', 'ai-chat-for-amazon-bedrock' ), '__return_false', 'aicfab_tab_wechat' );
$this->field( 'wechat_enabled', __( 'Answers to followers', 'ai-chat-for-amazon-bedrock' ), 'wechat_render', 'aicfab_wechat' );
$this->field( 'wechat_drafts_enabled', __( 'Drafts', 'ai-chat-for-amazon-bedrock' ), 'wechat_drafts_render', 'aicfab_wechat' );
add_settings_section( 'aicfab_wxgame', __( 'WeChat mini game', 'ai-chat-for-amazon-bedrock' ), '__return_false', 'aicfab_tab_wxgame' );
$this->field( 'wxgame_enabled', __( 'Customer service', 'ai-chat-for-amazon-bedrock' ), 'wxgame_render', 'aicfab_wxgame' );
add_settings_section( 'aicfab_publishing', __( 'Video and social platforms', 'ai-chat-for-amazon-bedrock' ), '__return_false', 'aicfab_tab_publishing' );
$this->field( 'distribution_enabled', __( 'Publishing record', 'ai-chat-for-amazon-bedrock' ), 'distribution_render', 'aicfab_publishing' );
$this->field( 'bilibili_embeds', __( 'Bilibili videos', 'ai-chat-for-amazon-bedrock' ), 'bilibili_embeds_render', 'aicfab_publishing' );
$this->field( 'youtube_client_id', __( 'YouTube uploads', 'ai-chat-for-amazon-bedrock' ), 'youtube_render', 'aicfab_publishing' );
$this->field( 'publish_kit', __( 'Publishing kits', 'ai-chat-for-amazon-bedrock' ), 'publish_kit_render', 'aicfab_publishing' );
add_settings_section( 'aicfab_governance', __( 'Safety and spend controls', 'ai-chat-for-amazon-bedrock' ), array( $this, 'governance_section_callback' ), 'aicfab_tab_governance' );
$this->field( 'allow_public_chat', __( 'Guest access', 'ai-chat-for-amazon-bedrock' ), 'allow_public_chat_render', 'aicfab_governance' );
$this->field( 'rate_limit_per_minute', __( 'Requests per visitor per minute', 'ai-chat-for-amazon-bedrock' ), 'rate_limit_render', 'aicfab_governance' );
$this->field( 'role_limits', __( 'Per-role limits', 'ai-chat-for-amazon-bedrock' ), 'role_limits_render', 'aicfab_governance' );
$this->field( 'daily_request_limit', __( 'Daily request limit', 'ai-chat-for-amazon-bedrock' ), 'daily_request_limit_render', 'aicfab_governance' );
$this->field( 'guardrail_id', __( 'Guardrail identifier', 'ai-chat-for-amazon-bedrock' ), 'guardrail_id_render', 'aicfab_governance' );
$this->field( 'guardrail_version', __( 'Guardrail version', 'ai-chat-for-amazon-bedrock' ), 'guardrail_version_render', 'aicfab_governance' );
$this->field( 'log_conversations', __( 'Conversation log', 'ai-chat-for-amazon-bedrock' ), 'log_conversations_render', 'aicfab_governance' );
$this->field( 'debug_mode', __( 'Debug logging', 'ai-chat-for-amazon-bedrock' ), 'debug_mode_render', 'aicfab_governance' );
add_settings_section( 'aicfab_integrations', __( 'Fixes for other plugins', 'ai-chat-for-amazon-bedrock' ), array( $this, 'integrations_section_callback' ), 'aicfab_tab_integrations' );
$this->field( 'github_read_scope', __( 'GitHub sign-in scope', 'ai-chat-for-amazon-bedrock' ), 'github_read_scope_render', 'aicfab_integrations' );
$this->field( 'social_only_registration', __( 'Registration', 'ai-chat-for-amazon-bedrock' ), 'social_only_registration_render', 'aicfab_integrations' );
$this->field( 'hreflang_x_default', __( 'Default language for search engines', 'ai-chat-for-amazon-bedrock' ), 'hreflang_x_default_render', 'aicfab_integrations' );
$this->field( 'organization_author', __( 'Article author', 'ai-chat-for-amazon-bedrock' ), 'organization_author_render', 'aicfab_integrations' );
if ( AI_Chat_Bedrock_WooCommerce::active() ) {
add_settings_section( 'aicfab_woocommerce', __( 'WooCommerce', 'ai-chat-for-amazon-bedrock' ), array( $this, 'woocommerce_section_callback' ), 'aicfab_tab_woocommerce' );
$this->field( 'woo_catalog', __( 'Product answers', 'ai-chat-for-amazon-bedrock' ), 'woo_catalog_render', 'aicfab_woocommerce' );
$this->field( 'woo_catalog_limit', __( 'Products per answer', 'ai-chat-for-amazon-bedrock' ), 'woo_catalog_limit_render', 'aicfab_woocommerce' );
$this->field( 'woo_orders', __( 'Order questions', 'ai-chat-for-amazon-bedrock' ), 'woo_orders_render', 'aicfab_woocommerce' );
$this->field( 'woo_product_assistant', __( 'Product assistant', 'ai-chat-for-amazon-bedrock' ), 'woo_product_assistant_render', 'aicfab_woocommerce' );
}
}
public function display_plugin_admin_page() {
include plugin_dir_path( __FILE__ ) . 'partials/ai-chat-bedrock-admin-display.php';
}
public function display_plugin_admin_settings_page() {
include plugin_dir_path( __FILE__ ) . 'partials/ai-chat-bedrock-admin-settings.php';
}
public function display_plugin_admin_test_page() {
include plugin_dir_path( __FILE__ ) . 'partials/ai-chat-bedrock-admin-test.php';
}
public function display_plugin_admin_mcp_page() {
include plugin_dir_path( __FILE__ ) . 'partials/ai-chat-bedrock-admin-mcp-tab.php';
}
public function aws_settings_section_callback() {
echo '
' . esc_html__( 'Prefer wp-config.php constants or an IAM role. Database credentials are encrypted with WordPress salts and are never displayed after saving.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
}
public function aws_region_render() {
$this->select( 'aws_region', AI_Chat_Bedrock_Models::regions(), 'us-east-1' );
}
public function bedrock_api_key_render() {
$this->credential_input( 'bedrock_api_key', true );
echo '
' . esc_html__( 'The quickest way to connect: create a long-term API key in the Amazon Bedrock console under API keys, choose the same Region as above, and paste it here. It is used for chat, the model list and embeddings. Knowledge Bases, Prompt Management and AgentCore still need access keys or an IAM role.', 'ai-chat-for-amazon-bedrock' ) . '
';
if ( AI_Chat_Bedrock_Core_AI::connectors_available() ) {
echo '
' . wp_kses_post(
sprintf(
/* translators: %s: link to the Settings > Connectors screen. */
__( 'A key can also be entered under %s, where it is checked with Amazon Bedrock before it is kept. A key here takes precedence.', 'ai-chat-for-amazon-bedrock' ),
'' . esc_html__( 'Settings > Connectors', 'ai-chat-for-amazon-bedrock' ) . ''
)
) . '
';
}
if ( '' !== $this->option( 'bedrock_api_key', '' ) ) {
echo '';
}
}
public function aws_access_key_render() {
$this->credential_input( 'aws_access_key', false );
}
public function aws_secret_key_render() {
$this->credential_input( 'aws_secret_key', true );
}
public function aws_session_token_render() {
$this->credential_input( 'aws_session_token', true );
echo '
' . esc_html__( 'Required only for temporary AWS credentials.', 'ai-chat-for-amazon-bedrock' ) . '
' . esc_html__( 'Supports environment variables, ECS or EKS task roles, and EC2 instance roles, so no long-lived AWS keys are stored in WordPress.', 'ai-chat-for-amazon-bedrock' ) . '
' . esc_html__( 'Streaming uses one authenticated POST request per message and falls back to a buffered response automatically.', 'ai-chat-for-amazon-bedrock' ) . '
';
} else {
echo '
' . esc_html__( 'This server cannot stream because the PHP cURL extension is unavailable. Buffered responses will be used.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
}
public function governance_section_callback() {
echo '
' . esc_html__( 'Who may chat and how often, a daily cap, an Amazon Bedrock guardrail, and what is logged. Counters store request and token totals only.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
public function guardrail_id_render() {
$this->text_input( 'guardrail_id', '', 200 );
echo '
' . esc_html__( 'Optional. Applies an existing Amazon Bedrock guardrail to every request.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
public function guardrail_version_render() {
$this->text_input( 'guardrail_version', 'DRAFT', 20 );
echo '
' . esc_html__( 'Use DRAFT or a published numeric version.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
public function daily_request_limit_render() {
$value = absint( $this->option( 'daily_request_limit', 0 ) );
echo '';
echo '
' . esc_html__( 'Maximum Bedrock requests per day for the whole site. Use 0 for no plugin-side limit. With a limit, each visitor may ask a tenth of it a day, and at least 20 questions, so one account cannot use up the day for everyone; administrators are not limited. Embeddings for search and indexing are not counted. This is not a billing guarantee; configure AWS Budgets as well.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
public function knowledge_section_callback() {
echo '
' . esc_html__( 'Ground answers in your own content. Retrieved passages are passed to the model as reference data, never as instructions, and only published content is used.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
public function enable_site_context_render() {
$checked = ! empty( $this->option( 'enable_site_context', false ) );
echo '';
echo '
' . esc_html__( 'Uses the built-in WordPress search. Password-protected, private and draft content is excluded.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
public function context_results_render() {
$value = absint( $this->option( 'context_results', 3 ) );
echo '';
echo '
' . esc_html__( 'More passages improve grounding but increase input tokens and cost.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
public function include_noindex_render() {
$checked = ! empty( $this->option( 'include_noindex', false ) );
echo '';
echo '
' . esc_html__( 'Off by default. A page kept out of search engines, such as a thank-you page with a download or a campaign landing page, is usually kept out for a reason, so the chat and agents leave it out too. The noindex settings of Yoast SEO, Rank Math and SEOPress are read for each page and post type; All in One SEO for each page. Reading a post aloud is not affected.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
public function show_sources_render() {
$checked = ! empty( $this->option( 'show_sources', false ) );
echo '';
echo '
' . esc_html__( 'Up to three links under each answer, to published pages and knowledge base documents with a web address. Pages that only share a single word with the question are not listed.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
public function knowledge_base_id_render() {
$this->text_input( 'knowledge_base_id', '', 64 );
echo '
' . esc_html__( 'Optional. Queries an existing Amazon Bedrock knowledge base with the Retrieve API. Requires bedrock:Retrieve permission for that knowledge base.', 'ai-chat-for-amazon-bedrock' ) . '
' . esc_html__( 'Optional. Gathers more passages from site content and the knowledge base, then has a reranking model keep the ones that best answer the question. It adds one rerank request per question, billed per query, and the passages are used in their original order if it fails. Requires bedrock:Rerank, and bedrock:InvokeModel on the reranking model, in the chat region.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
public function abilities_tools_render() {
$checked = ! empty( $this->option( 'abilities_tools', false ) );
$available = AI_Chat_Bedrock_Abilities::available();
echo '';
if ( $available ) {
echo '
' . esc_html__( 'Abilities follow the same tool policy: a capability is required, permission callbacks are honored, and abilities that change data need explicit approval.', 'ai-chat-for-amazon-bedrock' ) . '
' . sprintf(
/* translators: 1: names of plugins, 2: link to the tool policy. */
esc_html__( 'Found on this site: %1$s. Choose plugins and abilities under %2$s.', 'ai-chat-for-amazon-bedrock' ),
esc_html( AI_Chat_Bedrock_Translation::items( $sources ) ),
$policy // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- built from escaped parts above.
) . '
' . esc_html__( 'Tools in chat are switched off on the MCP screen, so no ability is offered until they are switched on there.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
} else {
echo '
' . esc_html__( 'The WordPress Abilities API is not available on this site, so this option is inactive.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
}
public function site_abilities_render() {
$checked = ! empty( $this->option( 'site_abilities', false ) );
$available = AI_Chat_Bedrock_Abilities::available();
echo '';
if ( $available ) {
echo '
' . esc_html__( 'Registers search, read, SEO suggestion and WooCommerce product lookup as read-only abilities, plus one write ability that creates drafts. Nothing is published, updated or deleted, and orders and customers are never exposed.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
}
public function site_ontology_render() {
$checked = ! empty( $this->option( 'site_ontology', false ) );
echo '';
echo '
' . esc_html__( 'Adds a read-only describe-site ability and MCP tool. It lists what the site holds as schema.org types, with counts per language, how they relate and which data an AI may see, using the same IDs as Yoast SEO and WooCommerce. Passages given to the model also say whether they come from a post, page or product, and in which language. Only published, public content is described.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
public function llms_txt_render() {
$checked = ! empty( $this->option( 'llms_txt', false ) );
echo '';
echo '
' . esc_html__( 'Lists the site\'s public posts, pages and products by type, in every language, at the address below. It follows the same rules as the site description: no members-only content, drafts or pages hidden from search engines. A real llms.txt file, a page at that address and a plugin that answers before this one go first; a plugin that answers later can claim the address with a filter.', 'ai-chat-for-amazon-bedrock' ) . '
';
if ( class_exists( 'AI_Chat_Bedrock_Llms_Txt' ) ) {
if ( AI_Chat_Bedrock_Llms_Txt::file_exists() ) {
echo '
' . esc_html__( 'An llms.txt file is already at the site root, so the web server serves that file instead.', 'ai-chat-for-amazon-bedrock' ) . '
' . esc_html__( 'Adds a Business insights screen with periods, comparisons, charts, a CSV download and questions in words, and a read-only query-metrics ability and MCP tool. Figures are read from data the site already keeps, including WooCommerce Analytics. Figures from fewer than five questions or orders are withheld, question figures stay on the screen, and no figure is sent to Amazon Bedrock.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
public function editor_assistant_render() {
$checked = ! empty( $this->option( 'editor_assistant', false ) );
echo '';
echo '
' . esc_html__( 'Improve, shorten, expand, summarize, suggest titles or translate. Suggestions are never saved automatically and require the edit_posts capability.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
public function log_conversations_render() {
$checked = AI_Chat_Bedrock_Conversations::enabled();
$retention = AI_Chat_Bedrock_Conversations::retention_days();
echo '';
echo '
' . esc_html__( 'Disabled by default. When enabled, chat content is stored in the database, capped at 200 recent entries, and visible to administrators. Disclose this to your visitors.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
public function chat_memory_render() {
$current = AI_Chat_Bedrock_Chat_History::mode( get_option( 'ai_chat_bedrock_settings', array() ) );
$days = AI_Chat_Bedrock_Chat_History::retention_days();
$choices = array(
'' => __( 'Off (default): each page starts a new conversation', 'ai-chat-for-amazon-bedrock' ),
'tab' => __( 'Keep it while the visitor browses, in their browser tab', 'ai-chat-for-amazon-bedrock' ),
'account' => __( 'Also save it for signed-in visitors, across visits and devices', 'ai-chat-for-amazon-bedrock' ),
);
echo '';
echo '
' . esc_html__( 'Kept in the browser tab, the conversation is stored only in the visitor\'s browser and is gone when the tab is closed. Saved for signed-in visitors, it is also stored on this site with their account, included in personal data exports and erasures, and deleted after the days above. Clear in the chat deletes it, and switching saving off deletes every saved conversation. Disclose this to your visitors.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
public function speech_render() {
$options = get_option( 'ai_chat_bedrock_settings', array() );
$engine = AI_Chat_Bedrock_Speech::engine( $options );
$engines = array(
'neural' => __( 'Neural (default)', 'ai-chat-for-amazon-bedrock' ),
'generative' => __( 'Generative: more natural, about twice the price, not every voice or Region', 'ai-chat-for-amazon-bedrock' ),
);
echo '';
echo '
' . esc_html__( 'Off by default. Amazon Polly reads the text aloud, in a voice for its language, and is billed per character; 0 removes the daily limit.', 'ai-chat-for-amazon-bedrock' ) . '
' . esc_html__( 'Only answers this chat gave can be read, by the visitor they were given to. A post is read as a signed-out visitor sees it, so members-only content is never sent; its audio is saved in the uploads folder and made again when the post changes. The AWS identity needs polly:SynthesizeSpeech.', 'ai-chat-for-amazon-bedrock' ) . '
' . esc_html(
$visitor > 0
/* translators: %s: number of characters. */
? sprintf( __( 'Saved audio plays for everyone at no cost. Making new audio is limited to %s characters per visitor a day, so one visitor or script cannot use up the day for the rest, and crawlers and scripts cannot have posts read at all. Administrators are not limited.', 'ai-chat-for-amazon-bedrock' ), number_format_i18n( $visitor ) )
: __( 'Saved audio plays for everyone at no cost. Crawlers and scripts cannot have posts read. Without a daily limit for the site, visitors have none either.', 'ai-chat-for-amazon-bedrock' )
) . '
';
}
public function analytics_events_render() {
echo '';
echo '
' . esc_html__( 'Off by default. The chat tells the site\'s analytics tag when it is opened, a question is asked or answered, a source or product in an answer is followed, an answer is rated and a contact request is sent, with no message text or contact details.', 'ai-chat-for-amazon-bedrock' ) . '
' . esc_html__( 'Google Analytics (through Site Kit, MonsterInsights or a gtag snippet), Google Tag Manager, Matomo and Plausible receive the events; mark ai_chat_contact as a key event to count contact requests as conversions. With a consent plugin that uses the WP Consent API, events wait until the visitor allows statistics.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
}
public function leads_render() {
$options = get_option( 'ai_chat_bedrock_settings', array() );
$options = is_array( $options ) ? $options : array();
$link = isset( $options['leads_link'] ) ? AI_Chat_Bedrock_Leads::clean_link( $options['leads_link'] ) : '';
$joinchat = AI_Chat_Bedrock_Leads::joinchat_url();
echo '';
$found = array();
if ( class_exists( 'Flamingo_Inbound_Message' ) ) {
$found[] = __( 'Flamingo is active, so each request is also filed in its inbox.', 'ai-chat-for-amazon-bedrock' );
}
if ( AI_Chat_Bedrock_Leads::uses_akismet() ) {
$found[] = __( 'Akismet is set up, so each request is checked for spam, as a contact form is.', 'ai-chat-for-amazon-bedrock' );
}
if ( '' !== $joinchat ) {
$found[] = __( 'Joinchat is active: while the link is empty, its WhatsApp number is offered.', 'ai-chat-for-amazon-bedrock' );
}
echo '
' . esc_html__( 'Off by default. A Contact a person button appears below the chat, and the assistant points to it when it cannot help.', 'ai-chat-for-amazon-bedrock' ) . '
' . esc_html__( 'Visitors give an email address or phone number and must agree before anything is stored. Requests are kept on this site and listed under Contact requests, where they can be exported. The link can be a web, mailto: or tel: address.', 'ai-chat-for-amazon-bedrock' ) . '
';
echo '
' . esc_html__( 'Disclose this in your privacy policy.', 'ai-chat-for-amazon-bedrock' ) . '
';
foreach ( $found as $line ) {
echo '
' . esc_html( $line ) . '
';
}
}
public function suggested_questions_render() {
$value = (string) $this->option( 'suggested_questions', '' );
echo '';
echo '
' . esc_html__( 'One question per line, up to four. They appear as buttons above the input so visitors know what to ask, and disappear once the conversation starts.', 'ai-chat-for-amazon-bedrock' ) . '
' . esc_html__( 'Optional. Leave a row empty to use the site-wide limit above. A visitor with several roles gets the most permissive of them, and requests are still counted per profile.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
public function managed_prompt_render() {
echo '';
echo '
' . esc_html__( 'Optional. Point at a prompt in Amazon Bedrock Prompt Management and its text replaces the system prompt above, so one prompt can be reviewed in AWS and reused by every site. The prompt must live in the same region as the chat. Leave the version empty to follow the draft.', 'ai-chat-for-amazon-bedrock' ) . '
';
printf(
/* translators: %s: comma separated list of variable names. */
esc_html__( 'These variables are sent literally because this plugin cannot resolve them: %s', 'ai-chat-for-amazon-bedrock' ),
esc_html( AI_Chat_Bedrock_Translation::items( $unresolved ) )
);
echo '
';
}
}
public function embedding_model_render() {
$choices = array( '' => __( 'Off, use keyword search only', 'ai-chat-for-amazon-bedrock' ) ) + AI_Chat_Bedrock_Embeddings::models();
$this->select( 'embedding_model_id', $choices, '' );
echo '
' . esc_html__( 'Finds content by meaning instead of shared words. It adds one embedding request per question, plus one per passage while indexing. Keyword search still runs when nothing relevant is found. Only what a signed-out visitor can read is indexed.', 'ai-chat-for-amazon-bedrock' ) . '
';
// Always printed: a checkbox that is missing from the form is saved as unchecked.
$background = ! empty( $this->option( 'embedding_background', false ) );
echo '';
if ( ! AI_Chat_Bedrock_Embeddings::enabled() ) {
return;
}
$status = AI_Chat_Bedrock_Embeddings::status();
echo '
';
echo esc_html(
AI_Chat_Bedrock_Translation::sentences(
sprintf(
/* translators: 1: indexed item count, 2: total published item count. */
_n( 'Indexed %1$s of %2$s published item.', 'Indexed %1$s of %2$s published items.', (int) $status['total'], 'ai-chat-for-amazon-bedrock' ),
number_format_i18n( (int) $status['indexed'] ),
number_format_i18n( (int) $status['total'] )
),
empty( $status['delete_pending'] ) ? '' : sprintf(
/* translators: %s: number of vectors waiting to be deleted. */
_n( '%s removed passage is still waiting to be deleted from S3 Vectors.', '%s removed passages are still waiting to be deleted from S3 Vectors.', (int) $status['delete_pending'], 'ai-chat-for-amazon-bedrock' ),
number_format_i18n( (int) $status['delete_pending'] )
)
)
);
echo '
' . esc_html(
sprintf(
/* translators: %s: number of items compared per question. */
__( 'With vectors stored in the WordPress database, each question is compared with the %s most recent items only. Choose Amazon S3 Vectors below to search everything.', 'ai-chat-for-amazon-bedrock' ),
number_format_i18n( (int) $status['searchable'] )
)
) . '
';
}
// The delete handler was there, but nothing on any screen submitted to it. This field
// sits inside the settings form, so its button belongs to a form printed after that one.
echo '
';
if ( $next ) {
printf(
/* translators: %s: human readable time until the next scheduled run. */
esc_html__( 'Next background batch in %s. On a large site, run wp ai-chat-bedrock index once to finish faster.', 'ai-chat-for-amazon-bedrock' ),
esc_html( human_time_diff( time(), (int) $next ) )
);
} else {
esc_html_e( 'The background run will be scheduled on the next page load.', 'ai-chat-for-amazon-bedrock' );
}
echo '
';
}
echo '
' . esc_html__( 'Indexing runs in small batches. Editing a post marks it for re-indexing on the next run.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
public function vector_store_render() {
$store = AI_Chat_Bedrock_Embeddings::store( get_option( 'ai_chat_bedrock_settings', array() ) );
echo '';
echo '
' . esc_html__( 'Create the vector bucket in the Amazon S3 console, then check or create the index here. Several sites can share one index: each only reads and deletes its own vectors. Needs s3vectors:PutVectors, QueryVectors, GetVectors, DeleteVectors, ListVectors and GetIndex, plus CreateIndex to create it from here.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
}
public function integrations_section_callback() {
echo '
' . esc_html__( 'Optional adjustments to plugins this site runs. Each is off until you turn it on, and does nothing while the plugin it adjusts is inactive.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
public function github_read_scope_render() {
$this->integration_checkbox(
'github_read_scope',
'fluentauth',
__( 'Ask GitHub for read-only access when visitors sign in with GitHub', 'ai-chat-for-amazon-bedrock' ),
__( 'FluentAuth requests the "user" scope, which also lets the site change the visitor\'s GitHub profile. Signing in only needs read:user and user:email.', 'ai-chat-for-amazon-bedrock' ),
__( 'Requires FluentAuth.', 'ai-chat-for-amazon-bedrock' )
);
}
public function social_only_registration_render() {
$this->integration_checkbox(
'social_only_registration',
'fluentauth',
__( 'Sign up through social login only', 'ai-chat-for-amazon-bedrock' ),
__( 'Social sign-up needs "Anyone can register", which also opens the WordPress registration form. That form emails a password link and attracts spam accounts. This sends it to the login page, where the social buttons are, and hides the Register link.', 'ai-chat-for-amazon-bedrock' ),
__( 'Requires FluentAuth.', 'ai-chat-for-amazon-bedrock' )
);
}
public function hreflang_x_default_render() {
$detected = AI_Chat_Bedrock_Integrations::detected();
$languages = AI_Chat_Bedrock_Integrations::languages();
$current = (string) $this->option( 'hreflang_x_default', '' );
if ( '' !== $current && ! isset( $languages[ $current ] ) ) {
$languages[ $current ] = $current;
}
echo '';
if ( ! $detected['polylang'] && '' !== $current ) {
echo '';
}
echo '
' . esc_html( $detected['polylang'] ? __( 'Polylang lists each translation of a page for search engines but no x-default, so they guess which one to show a reader whose language the site does not have. The edition chosen here is named as the default.', 'ai-chat-for-amazon-bedrock' ) : __( 'Requires Polylang.', 'ai-chat-for-amazon-bedrock' ) ) . '
';
}
public function organization_author_render() {
$this->integration_checkbox(
'organization_author',
'yoast',
__( 'Credit articles to the organization', 'ai-chat-for-amazon-bedrock' ),
__( 'Yoast SEO names the account that published a post as its author. When Yoast is set to represent an organization, this names the organization instead, in structured data, the author meta tag and Slack previews.', 'ai-chat-for-amazon-bedrock' ),
__( 'Requires Yoast SEO.', 'ai-chat-for-amazon-bedrock' )
);
}
public function woocommerce_section_callback() {
echo '
' . esc_html__( 'Answers about products and orders from the store itself, and help writing product pages. Each is off until you turn it on.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
public function woo_catalog_render() {
$checked = ! empty( $this->option( 'woo_catalog', false ) );
echo '';
echo '
' . esc_html__( 'Matching products are looked up for each question, by name, description, SKU or category, and their current price, stock, rating and attributes are given to the model, so it does not quote an old price. The products are shown as cards under the answer, with a link to add simple products to the cart. On a product page, that product comes first. Products that are not published, are hidden from the shop or search, or are out of stock on a store that hides those, are never used.', 'ai-chat-for-amazon-bedrock' ) . '
' . esc_html__( 'More products give the model more to compare but increase input tokens and cost.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
public function woo_orders_render() {
$checked = ! empty( $this->option( 'woo_orders', false ) );
echo '';
echo '
' . esc_html__( 'Only when a question is about orders, shipping or returns, the customer\'s five latest orders are given to the model: number, dates, status, items, total, shipping method and tracking number. Addresses, email, phone and payment details are never sent, and nobody can see another customer\'s orders. This sends customer data to Amazon Bedrock, so add the suggested text under Settings, Privacy, Policy Guide to your privacy policy first.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
public function woo_product_assistant_render() {
$checked = ! empty( $this->option( 'woo_product_assistant', false ) );
echo '';
echo '
' . esc_html__( 'Adds a box to the product edit screen that writes the short and the full description from the product\'s own attributes, categories and text, without inventing specifications, and sums up what reviews praise and criticize, without reviewer names. Drafts go into the editor for you to review and are saved only when you update the product.', 'ai-chat-for-amazon-bedrock' ) . '
';
if ( ! $active && $checked ) {
// A disabled checkbox is not submitted, so keep the choice until the plugin is back.
echo '';
}
}
public function media_assistant_render() {
$checked = ! empty( $this->option( 'media_assistant', false ) );
echo '';
echo '
' . esc_html__( 'Adds a Generate alt text action to the media library and an excerpt helper for posts. Alt text needs a model that accepts images, such as Claude. Existing alt text is never replaced unless you ask.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
public function model_id_render() {
$options = AI_Chat_Bedrock_Models::options();
$this->select( 'model_id', $options, AI_Chat_Bedrock_Models::DEFAULT_MODEL );
echo '
' . esc_html__( 'The list is discovered from your AWS account and region. Many current models require a cross-region inference profile ID.', 'ai-chat-for-amazon-bedrock' ) . '
' . esc_html__( 'Used only when the main model cannot answer because access was denied, the request was throttled, or Amazon Bedrock was unreachable. The reply states which model answered. Requests rejected for other reasons are never retried.', 'ai-chat-for-amazon-bedrock' ) . '
' . esc_html__( 'Lets plugins that use the WordPress AI Client generate images with Stability AI, and adds Remove background and Upscale to images in the Media Library when the media helpers are on. Results are saved as new images; originals are never changed. Each image is one paid request and counts toward the daily limit.', 'ai-chat-for-amazon-bedrock' ) . '
';
echo '
' . esc_html(
sprintf(
/* translators: %s: AWS region code, such as us-west-2. */
__( 'The Stability models run in %s, whatever region the chat uses, so prompts and images are processed there. The guardrail, if set, checks each prompt first in your own region.', 'ai-chat-for-amazon-bedrock' ),
AI_Chat_Bedrock_Images::region()
)
) . '
';
}
public function max_tokens_render() {
$value = $this->option( 'max_tokens', 1000 );
echo '';
}
public function temperature_render() {
$value = $this->option( 'temperature', 0.7 );
echo '';
echo '
' . esc_html__( 'Not sent to Claude Opus 4.7, Sonnet 5, Opus 5 and newer Claude models, because Amazon Bedrock rejects it for them.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
public function system_prompt_render() {
echo '';
}
public function chat_title_render() {
$this->text_input( 'chat_title', 'Chat with AI', 120 );
}
public function welcome_message_render() {
$this->text_input( 'welcome_message', 'Hello! How can I help you today?', 500, 'large-text' );
}
public function allow_public_chat_render() {
$checked = ! empty( $this->option( 'allow_public_chat', false ) );
echo '';
echo '
' . esc_html__( 'Disabled by default. Enabling this can incur AWS charges even with rate limiting.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
public function rate_limit_render() {
$value = $this->option( 'rate_limit_per_minute', 5 );
echo '';
}
public function popup_site_wide_render() {
$checked = ! empty( $this->option( 'popup_site_wide', false ) );
echo '';
echo '
' . esc_html__( 'Pages that already contain the chat block or shortcode are left unchanged. Use a profile with guest access if visitors should be able to chat.', 'ai-chat-for-amazon-bedrock' ) . '
' . esc_html__( 'Choose what matches your theme. Following the device turns the chat dark for visitors in dark mode, even on a light theme.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
public function chat_accent_color_render() {
echo '';
echo '
' . esc_html__( 'The colour of the chat button, your own messages and Send, such as your theme\'s main colour. Leave it empty for the default blue. Text on it is white or black, whichever is easier to read.', 'ai-chat-for-amazon-bedrock' ) . '
';
}
public function debug_mode_render() {
$checked = 'on' === $this->option( 'debug_mode', 'off' );
echo '';
}
/**
* Register a settings notice when the environment can show one.
*
* WordPress only defines add_settings_error() inside wp-admin. The validator is also run
* by the
* configuration import, so calling it directly made the validator admin-only.
*
* @param string $code Notice code.
* @param string $message Notice text.
* @param string $type Notice type.
*/
private function notice( $code, $message, $type = 'error' ) {
if ( function_exists( 'add_settings_error' ) ) {
add_settings_error( 'ai_chat_bedrock_settings', $code, $message, $type );
}
}
public function validate_settings( $input ) {
$input = is_array( $input ) ? $input : array();
$current = get_option( 'ai_chat_bedrock_settings', array() );
$current = is_array( $current ) ? $current : array();
$output = array();
// A tab only submits its own fields, so remember which keys it owns.
$submitted = isset( $input['_aicfab_fields'] ) ? (array) $input['_aicfab_fields'] : array();
$submitted = array_filter( array_map( 'sanitize_key', $submitted ) );
unset( $input['_aicfab_fields'] );
$regions = AI_Chat_Bedrock_Models::regions();
$region = isset( $input['aws_region'] ) ? sanitize_key( $input['aws_region'] ) : 'us-east-1';
$model = isset( $input['model_id'] ) ? sanitize_text_field( $input['model_id'] ) : AI_Chat_Bedrock_Models::DEFAULT_MODEL;
$output['aws_region'] = isset( $regions[ $region ] ) ? $region : 'us-east-1';
$output['model_id'] = AI_Chat_Bedrock_Models::is_valid_id( $model ) ? $model : AI_Chat_Bedrock_Models::DEFAULT_MODEL;
$fallback = isset( $input['fallback_model_id'] ) ? sanitize_text_field( $input['fallback_model_id'] ) : '';
if ( '' !== $fallback && ( ! AI_Chat_Bedrock_Models::is_valid_id( $fallback ) || $fallback === $output['model_id'] ) ) {
$this->notice( 'fallback_model_id', __( 'The fallback model must be a valid model that differs from the main model; it was cleared.', 'ai-chat-for-amazon-bedrock' ) );
$fallback = '';
}
$output['fallback_model_id'] = $fallback;
$image = isset( $input['image_model_id'] ) ? sanitize_text_field( $input['image_model_id'] ) : '';
if ( '' !== $image && ! isset( AI_Chat_Bedrock_Images::models()[ $image ] ) ) {
$this->notice( 'image_model_id', __( 'That image model is not supported; image generation was left off.', 'ai-chat-for-amazon-bedrock' ) );
$image = '';
}
$output['image_model_id'] = $image;
if ( ! AI_Chat_Bedrock_Models::is_valid_id( $model ) ) {
$this->notice( 'model_id', __( 'The submitted model ID was not valid; the default model was kept.', 'ai-chat-for-amazon-bedrock' ) );
}
if ( isset( $current['aws_region'] ) && $current['aws_region'] !== $output['aws_region'] ) {
AI_Chat_Bedrock_Models::flush_cache();
}
foreach ( array( 'aws_access_key', 'aws_secret_key', 'aws_session_token' ) as $key ) {
$new_value = isset( $input[ $key ] ) ? trim( sanitize_text_field( $input[ $key ] ) ) : '';
if ( '' === $new_value ) {
$output[ $key ] = isset( $current[ $key ] ) ? $current[ $key ] : '';
continue;
}
$encrypted = AI_Chat_Bedrock_Security::encrypt_secret( $new_value );
if ( '' === $encrypted ) {
$this->notice( 'credential_encryption', __( 'The credential could not be encrypted; the existing value was preserved.', 'ai-chat-for-amazon-bedrock' ) );
$output[ $key ] = isset( $current[ $key ] ) ? $current[ $key ] : '';
} else {
$output[ $key ] = $encrypted;
}
}
// An API key is a bearer token, so a malformed paste is refused rather than stored.
$raw_api_key = isset( $input['bedrock_api_key'] ) && is_string( $input['bedrock_api_key'] ) ? trim( $input['bedrock_api_key'] ) : '';
$new_api_key = AI_Chat_Bedrock_AWS_Credentials::clean_api_key( $raw_api_key );
if ( ! empty( $input['bedrock_api_key_clear'] ) ) {
$output['bedrock_api_key'] = '';
} elseif ( '' !== $new_api_key ) {
$encrypted = AI_Chat_Bedrock_Security::encrypt_secret( $new_api_key );
if ( '' === $encrypted ) {
$this->notice( 'credential_encryption', __( 'The credential could not be encrypted; the existing value was preserved.', 'ai-chat-for-amazon-bedrock' ) );
$output['bedrock_api_key'] = isset( $current['bedrock_api_key'] ) ? $current['bedrock_api_key'] : '';
} else {
$output['bedrock_api_key'] = $encrypted;
}
} else {
if ( '' !== $raw_api_key ) {
$this->notice( 'bedrock_api_key', __( 'That does not look like an Amazon Bedrock API key, so it was not saved.', 'ai-chat-for-amazon-bedrock' ) );
}
$output['bedrock_api_key'] = isset( $current['bedrock_api_key'] ) ? $current['bedrock_api_key'] : '';
}
unset( $output['bedrock_api_key_clear'] );
$output['max_tokens'] = max( 100, min( 4000, isset( $input['max_tokens'] ) ? absint( $input['max_tokens'] ) : 1000 ) );
$output['temperature'] = max( 0, min( 1, isset( $input['temperature'] ) ? (float) $input['temperature'] : 0.7 ) );
$output['system_prompt'] = isset( $input['system_prompt'] ) ? AI_Chat_Bedrock_Security::string_substr( sanitize_textarea_field( $input['system_prompt'] ), 0, 8000 ) : '';
$output['chat_title'] = isset( $input['chat_title'] ) ? sanitize_text_field( $input['chat_title'] ) : 'Chat with AI';
$output['welcome_message'] = isset( $input['welcome_message'] ) ? sanitize_text_field( $input['welcome_message'] ) : 'Hello! How can I help you today?';
$output['suggested_questions'] = isset( $input['suggested_questions'] ) ? AI_Chat_Bedrock_Chat_Request::sanitize_suggestions( $input['suggested_questions'] ) : '';
$output['allow_public_chat'] = ! empty( $input['allow_public_chat'] );
$output['rate_limit_per_minute'] = max( 1, min( 60, isset( $input['rate_limit_per_minute'] ) ? absint( $input['rate_limit_per_minute'] ) : 5 ) );
if ( in_array( 'role_limits', $submitted, true ) || isset( $input['role_limits'] ) ) {
// Stored separately from the settings blob so role changes cannot bloat it.
AI_Chat_Bedrock_Rate_Limits::save( isset( $input['role_limits'] ) ? (array) $input['role_limits'] : array() );
}
unset( $output['role_limits'] );
$output['aws_use_role_credentials'] = ! empty( $input['aws_use_role_credentials'] );
$output['enable_streaming'] = empty( $input['enable_streaming'] ) ? 'off' : 'on';
$output['debug_mode'] = ! empty( $input['debug_mode'] ) ? 'on' : 'off';
$output['popup_site_wide'] = ! empty( $input['popup_site_wide'] );
$output['popup_profile'] = isset( $input['popup_profile'] ) ? AI_Chat_Bedrock_Profiles::sanitize_key( $input['popup_profile'] ) : '';
$output['chat_color_scheme'] = AI_Chat_Bedrock_Chat_Request::color_scheme( isset( $input['chat_color_scheme'] ) ? $input['chat_color_scheme'] : '' );
$output['chat_accent_color'] = AI_Chat_Bedrock_Chat_Request::accent_color( isset( $input['chat_accent_color'] ) ? $input['chat_accent_color'] : '' );
$guardrail_id = isset( $input['guardrail_id'] ) ? trim( sanitize_text_field( $input['guardrail_id'] ) ) : '';
$output['guardrail_id'] = preg_match( '#^[A-Za-z0-9._:/-]{0,200}$#', $guardrail_id ) ? $guardrail_id : '';
if ( '' !== $guardrail_id && '' === $output['guardrail_id'] ) {
$this->notice( 'guardrail_id', __( 'The guardrail identifier contained unsupported characters and was cleared.', 'ai-chat-for-amazon-bedrock' ) );
}
$guardrail_version = isset( $input['guardrail_version'] ) ? strtoupper( trim( sanitize_text_field( $input['guardrail_version'] ) ) ) : 'DRAFT';
$output['guardrail_version'] = preg_match( '/^(?:DRAFT|[0-9]{1,10})$/', $guardrail_version ) ? $guardrail_version : 'DRAFT';
$output['daily_request_limit'] = min( 100000, isset( $input['daily_request_limit'] ) ? absint( $input['daily_request_limit'] ) : 0 );
$output['enable_site_context'] = ! empty( $input['enable_site_context'] );
$output['context_results'] = max( 1, min( 8, isset( $input['context_results'] ) ? absint( $input['context_results'] ) : 3 ) );
$output['show_sources'] = ! empty( $input['show_sources'] );
$output['include_noindex'] = ! empty( $input['include_noindex'] );
$output['abilities_tools'] = ! empty( $input['abilities_tools'] );
$output['site_abilities'] = ! empty( $input['site_abilities'] );
$output['site_ontology'] = ! empty( $input['site_ontology'] );
$output['llms_txt'] = ! empty( $input['llms_txt'] );
$output['business_metrics'] = ! empty( $input['business_metrics'] );
$output['editor_assistant'] = ! empty( $input['editor_assistant'] );
$output['log_conversations'] = ! empty( $input['log_conversations'] );
$output['media_assistant'] = ! empty( $input['media_assistant'] );
$embedding = isset( $input['embedding_model_id'] ) ? sanitize_text_field( $input['embedding_model_id'] ) : '';
$known = AI_Chat_Bedrock_Embeddings::models();
if ( '' !== $embedding && ! isset( $known[ $embedding ] ) ) {
$this->notice( 'embedding_model_id', __( 'That embedding model is not supported; semantic search was left off.', 'ai-chat-for-amazon-bedrock' ) );
$embedding = '';
}
$output['embedding_model_id'] = $embedding;
$output['embedding_background'] = ! empty( $input['embedding_background'] );
$store = isset( $input['vector_store'] ) ? sanitize_key( $input['vector_store'] ) : 'post_meta';
$output['vector_store'] = 's3_vectors' === $store ? 's3_vectors' : 'post_meta';
foreach ( array( 's3_vectors_bucket', 's3_vectors_index' ) as $key ) {
$name = isset( $input[ $key ] ) ? strtolower( trim( sanitize_text_field( $input[ $key ] ) ) ) : '';
$output[ $key ] = '' === $name || AI_Chat_Bedrock_S3_Vectors::valid_name( $name ) ? $name : '';
if ( '' !== $name && '' === $output[ $key ] ) {
$this->notice( $key, __( 'S3 Vectors bucket and index names are 3 to 63 lowercase letters, digits, hyphens or dots; the value was cleared.', 'ai-chat-for-amazon-bedrock' ) );
}
}
$vector_region = isset( $input['s3_vectors_region'] ) ? sanitize_key( $input['s3_vectors_region'] ) : '';
$output['s3_vectors_region'] = isset( $regions[ $vector_region ] ) ? $vector_region : '';
if ( 's3_vectors' === $output['vector_store'] && ( '' === $output['s3_vectors_bucket'] || '' === $output['s3_vectors_index'] ) ) {
$this->notice( 'vector_store', __( 'Amazon S3 Vectors needs a bucket and an index name. Until both are set, semantic search is off.', 'ai-chat-for-amazon-bedrock' ), 'warning' );
}
$output['github_read_scope'] = ! empty( $input['github_read_scope'] );
$output['social_only_registration'] = ! empty( $input['social_only_registration'] );
$output['organization_author'] = ! empty( $input['organization_author'] );
$output = $this->validate_publishing( $input, $output, $current );
$output['woo_catalog'] = ! empty( $input['woo_catalog'] );
$output['woo_catalog_limit'] = AI_Chat_Bedrock_WooCommerce::limit( $input );
$output['woo_orders'] = ! empty( $input['woo_orders'] );
$output['woo_product_assistant'] = ! empty( $input['woo_product_assistant'] );
$x_default = isset( $input['hreflang_x_default'] ) ? sanitize_key( $input['hreflang_x_default'] ) : '';
$languages = AI_Chat_Bedrock_Integrations::languages();
$output['hreflang_x_default'] = '' === $x_default || empty( $languages ) || isset( $languages[ $x_default ] ) ? $x_default : '';
$prompt_id = isset( $input['prompt_id'] ) ? trim( sanitize_text_field( $input['prompt_id'] ) ) : '';
if ( '' !== $prompt_id && ! preg_match( '#^[A-Za-z0-9:._/-]{1,2048}$#', $prompt_id ) ) {
$this->notice( 'prompt_id', __( 'The managed prompt identifier contained unsupported characters and was cleared.', 'ai-chat-for-amazon-bedrock' ) );
$prompt_id = '';
}
$output['prompt_id'] = $prompt_id;
$prompt_version = isset( $input['prompt_version'] ) ? strtoupper( trim( sanitize_text_field( $input['prompt_version'] ) ) ) : '';
$output['prompt_version'] = preg_match( '/^(?:DRAFT|[0-9]{1,10})$/', $prompt_version ) ? $prompt_version : '';
if ( class_exists( 'AI_Chat_Bedrock_Prompts' ) ) {
// The cache key includes the identifier and version, so clear both the old and new entries.
AI_Chat_Bedrock_Prompts::flush( $current );
AI_Chat_Bedrock_Prompts::flush( $output );
}
$retention_days = isset( $input['log_retention_days'] ) ? absint( $input['log_retention_days'] ) : AI_Chat_Bedrock_Conversations::DEFAULT_DAYS;
$output['log_retention_days'] = max( 1, min( AI_Chat_Bedrock_Conversations::MAX_DAYS, $retention_days ) );
$output['chat_memory'] = AI_Chat_Bedrock_Chat_History::mode( $input );
$output['chat_memory_days'] = AI_Chat_Bedrock_Chat_History::retention_days( $input );
$output['speech_replies'] = ! empty( $input['speech_replies'] );
$output['speech_posts'] = ! empty( $input['speech_posts'] );
$output['speech_posts_signed_in'] = ! empty( $input['speech_posts_signed_in'] );
$output['speech_engine'] = AI_Chat_Bedrock_Speech::engine( $input );
$output['speech_daily_chars'] = AI_Chat_Bedrock_Speech::daily_characters( $input );
$output['analytics_events'] = ! empty( $input['analytics_events'] );
$output = $this->validate_wechat( $input, $output, $current );
$output['leads_enabled'] = ! empty( $input['leads_enabled'] );
$output['leads_notify'] = ! empty( $input['leads_notify'] );
$output['leads_days'] = AI_Chat_Bedrock_Leads::retention_days( array( 'leads_days' => isset( $input['leads_days'] ) ? $input['leads_days'] : 0 ) );
$output['leads_link'] = isset( $input['leads_link'] ) ? AI_Chat_Bedrock_Leads::clean_link( $input['leads_link'] ) : '';
if ( isset( $input['leads_link'] ) && is_scalar( $input['leads_link'] ) && '' !== trim( (string) $input['leads_link'] ) && '' === $output['leads_link'] ) {
$this->notice( 'leads_link', __( 'The contact link must be a web, mailto: or tel: address; it was cleared.', 'ai-chat-for-amazon-bedrock' ) );
}
$knowledge_base = isset( $input['knowledge_base_id'] ) ? trim( sanitize_text_field( $input['knowledge_base_id'] ) ) : '';
if ( '' === $knowledge_base || preg_match( '/^[A-Za-z0-9]{1,64}$/', $knowledge_base ) ) {
$output['knowledge_base_id'] = $knowledge_base;
} else {
$output['knowledge_base_id'] = '';
$this->notice( 'knowledge_base_id', __( 'The knowledge base ID must be alphanumeric; the value was cleared.', 'ai-chat-for-amazon-bedrock' ) );
}
$rerank = isset( $input['rerank_model_id'] ) ? sanitize_text_field( $input['rerank_model_id'] ) : '';
if ( '' !== $rerank && ! isset( AI_Chat_Bedrock_Retrieval::rerank_models()[ $rerank ] ) ) {
$this->notice( 'rerank_model_id', __( 'That reranking model is not supported; reranking was left off.', 'ai-chat-for-amazon-bedrock' ) );
$rerank = '';
}
$output['rerank_model_id'] = $rerank;
// A saved model, Region or credential change may be what fixes a refused rerank request.
delete_transient( AI_Chat_Bedrock_Retrieval::RERANK_PAUSED );
if ( class_exists( 'AI_Chat_Bedrock_AWS_Credentials' ) ) {
AI_Chat_Bedrock_AWS_Credentials::flush_cache();
}
/*
* Preserve settings owned by tabs that were not part of this submission.
*
* If the field list is missing, for example because a cached form was submitted,
* fall back to the keys that were actually posted. Losing unrelated settings is
* worse than ignoring a cleared checkbox in that rare case.
*/
if ( empty( $submitted ) && ! empty( $current ) ) {
$submitted = array_filter( array_map( 'sanitize_key', array_keys( $input ) ) );
}
if ( ! empty( $submitted ) ) {
$merged = $current;
foreach ( $submitted as $key ) {
if ( array_key_exists( $key, $output ) ) {
$merged[ $key ] = $output[ $key ];
}
}
// Keys a field renders next to its own control, which the field list does not name.
foreach ( self::COMPANION_FIELDS as $owner => $companions ) {
if ( ! in_array( $owner, $submitted, true ) ) {
continue;
}
foreach ( $companions as $companion ) {
if ( array_key_exists( $companion, $output ) ) {
$merged[ $companion ] = $output[ $companion ];
}
}
}
$output = $merged;
}
/*
* Some settings are also kept in options of their own, which other code reads without
* loading the settings array. They are written from the merged result, so saving one
* tab no longer switched off the conversation log and site abilities set on another.
*/
update_option( AI_Chat_Bedrock_Conversations::OPTION_ENABLED, ! empty( $output['log_conversations'] ), false );
update_option( AI_Chat_Bedrock_Conversations::OPTION_RETENTION, isset( $output['log_retention_days'] ) ? (int) $output['log_retention_days'] : AI_Chat_Bedrock_Conversations::DEFAULT_DAYS, false );
update_option( 'ai_chat_bedrock_site_abilities', ! empty( $output['site_abilities'] ), false );
// WordPress registers its own "Settings saved" against the 'general' slug, which a
// settings_errors() call filtered to this plugin's slug never shows. Without this the
// page came back silently and there was no way to tell whether the save worked.
$this->notice( 'aicfab_settings_saved', __( 'Settings saved.', 'ai-chat-for-amazon-bedrock' ), 'success' );
return $output;
}
/**
* The one-off notice flags the plugin's redirects add. WordPress takes them out of the
* address bar once the page has loaded, as it does its own, so reloading or bookmarking
* the page does not show the notice again.
*
* @param array $args Query arguments WordPress removes.
* @return array
*/
public function removable_query_args( $args ) {
$args = is_array( $args ) ? $args : array();
return array_merge( $args, array( 'aicfab-alt', 'aicfab-alt-done', 'aicfab-alt-skipped', 'aicfab-alt-failed', 'aicfab-applied', 'aicfab-cleared', 'aicfab-generated', 'aicfab-image', 'aicfab-log', 'aicfab-mcp', 'aicfab-message', 'aicfab-profile', 'aicfab-skipped', 'aicfab-transfer' ) );
}
/**
* The handle of the admin script and stylesheet. The chat's own assets use the bare plugin name,
* and the Test Chat screen needs both: sharing the handle made WordPress keep whichever was
* registered first, the admin one, so the chat there had neither its script nor its styles.
*/
private function admin_handle() {
return $this->plugin_name . '-admin';
}
private function is_plugin_screen( $hook_suffix ) {
return false !== strpos( (string) $hook_suffix, $this->plugin_name );
}
/**
* Settings rendered inside another field's row, saved whenever that field's tab is.
*/
const COMPANION_FIELDS = array(
'log_conversations' => array( 'log_retention_days' ),
'chat_memory' => array( 'chat_memory_days' ),
'speech_replies' => array( 'speech_posts', 'speech_posts_signed_in', 'speech_engine', 'speech_daily_chars' ),
'leads_enabled' => array( 'leads_notify', 'leads_days', 'leads_link' ),
'wechat_enabled' => array( 'wechat_token', 'wechat_aes_key', 'wechat_app_id', 'wechat_model_id', 'wechat_hourly', 'wechat_menu' ),
'wechat_drafts_enabled' => array( 'wechat_app_secret', 'wechat_drafts_category', 'wechat_drafts_schedule', 'wechat_drafts_count', 'wechat_drafts_author', 'wechat_drafts_notify', 'wechat_drafts_sync' ),
'wxgame_enabled' => array( 'wxgame_app_id', 'wxgame_token', 'wxgame_aes_key', 'wxgame_app_secret', 'wxgame_welcome', 'wxgame_answers', 'wxgame_fallback' ),
'distribution_enabled' => array( 'distribution_links' ),
'youtube_client_id' => array( 'youtube_client_secret', 'youtube_daily_uploads' ),
'popup_site_wide' => array( 'popup_profile' ),
'prompt_id' => array( 'prompt_version' ),
'embedding_model_id' => array( 'embedding_background' ),
'vector_store' => array( 's3_vectors_bucket', 's3_vectors_index', 's3_vectors_region' ),
);
const CHECKBOX_FIELDS = array(
'embedding_background',
'abilities_tools',
'allow_public_chat',
'aws_use_role_credentials',
'debug_mode',
'editor_assistant',
'enable_site_context',
'enable_streaming',
'log_conversations',
'media_assistant',
'popup_site_wide',
'site_abilities',
'site_ontology',
'llms_txt',
'business_metrics',
'show_sources',
'include_noindex',
'speech_replies',
'speech_posts',
'leads_enabled',
'leads_notify',
'analytics_events',
'wechat_enabled',
'wxgame_enabled',
'wechat_drafts_enabled',
'wechat_drafts_notify',
'publish_kit',
'wechat_drafts_sync',
'github_read_scope',
'social_only_registration',
'organization_author',
'distribution_enabled',
'bilibili_embeds',
'woo_catalog',
'woo_orders',
'woo_product_assistant',
);
/**
* DOM id used to tie a settings row title to its control.
*
* @param string $key Setting key.
* @return string
*/
public static function control_id( $key ) {
return 'aicfab_field_' . sanitize_key( (string) $key );
}
private function field( $id, $title, $callback, $section ) {
$pages = array(
'aicfab_aws' => 'aicfab_tab_aws',
'aicfab_model' => 'aicfab_tab_model',
'aicfab_governance' => 'aicfab_tab_governance',
'aicfab_knowledge' => 'aicfab_tab_knowledge',
'aicfab_chat' => 'aicfab_tab_chat',
'aicfab_integrations' => 'aicfab_tab_integrations',
'aicfab_publishing' => 'aicfab_tab_publishing',
'aicfab_wechat' => 'aicfab_tab_wechat',
'aicfab_wxgame' => 'aicfab_tab_wxgame',
'aicfab_agents' => 'aicfab_tab_agents',
'aicfab_woocommerce' => 'aicfab_tab_woocommerce',
);
$page = isset( $pages[ $section ] ) ? $pages[ $section ] : 'aicfab_tab_chat';
/*
* Associate the row title with the control so screen readers announce a name.
* Checkbox fields already carry their own inline label and would be read twice.
*/
$args = in_array( $id, self::CHECKBOX_FIELDS, true ) ? array() : array( 'label_for' => self::control_id( $id ) );
add_settings_field( $id, $title, array( $this, $callback ), $page, $section, $args );
self::$tab_fields[ $page ][] = $id;
}
/**
* Settings tabs and the fields each one owns.
*
* @return array
*/
public static function tabs() {
// In the order a site is set up: connect, choose the model, ground and shape the chat,
// add tools and channels, then limit what it may spend.
return array(
'aws' => array(
'page' => 'aicfab_tab_aws',
'label' => __( 'AWS', 'ai-chat-for-amazon-bedrock' ),
),
'model' => array(
'page' => 'aicfab_tab_model',
'label' => __( 'Model', 'ai-chat-for-amazon-bedrock' ),
),
'knowledge' => array(
'page' => 'aicfab_tab_knowledge',
'label' => __( 'Grounding', 'ai-chat-for-amazon-bedrock' ),
),
'chat' => array(
'page' => 'aicfab_tab_chat',
'label' => __( 'Chat', 'ai-chat-for-amazon-bedrock' ),
),
'agents' => array(
'page' => 'aicfab_tab_agents',
'label' => __( 'Agents and tools', 'ai-chat-for-amazon-bedrock' ),
),
// The slug stays publishing, so links to it keep working. Its first section is the
// page a plain link to the tab opens.
'publishing' => array(
'page' => 'aicfab_tab_wechat',
'label' => __( 'Channels', 'ai-chat-for-amazon-bedrock' ),
'sections' => array(
'wechat' => array(
'page' => 'aicfab_tab_wechat',
'label' => __( 'WeChat Official Account', 'ai-chat-for-amazon-bedrock' ),
),
'wxgame' => array(
'page' => 'aicfab_tab_wxgame',
'label' => __( 'WeChat mini game', 'ai-chat-for-amazon-bedrock' ),
),
'video' => array(
'page' => 'aicfab_tab_publishing',
'label' => __( 'Video and social platforms', 'ai-chat-for-amazon-bedrock' ),
),
),
),
'governance' => array(
'page' => 'aicfab_tab_governance',
'label' => __( 'Safety and spend', 'ai-chat-for-amazon-bedrock' ),
),
'integrations' => array(
'page' => 'aicfab_tab_integrations',
'label' => __( 'Integrations', 'ai-chat-for-amazon-bedrock' ),
),
) + ( class_exists( 'AI_Chat_Bedrock_WooCommerce' ) && AI_Chat_Bedrock_WooCommerce::active()
? array(
'woocommerce' => array(
'page' => 'aicfab_tab_woocommerce',
'label' => __( 'WooCommerce', 'ai-chat-for-amazon-bedrock' ),
),
)
: array() );
}
/**
* Field identifiers registered for one tab page.
*
* @param string $page Tab page slug.
* @return array
*/
public static function fields_for_page( $page ) {
return isset( self::$tab_fields[ $page ] ) ? self::$tab_fields[ $page ] : array();
}
private function option( $key, $fallback = '' ) {
$options = get_option( 'ai_chat_bedrock_settings', array() );
return isset( $options[ $key ] ) ? $options[ $key ] : $fallback;
}
private function text_input( $key, $fallback, $maxlength, $css_class = 'regular-text' ) {
echo '';
}
private function credential_input( $key, $password ) {
$constants = array(
'aws_access_key' => 'AI_CHAT_BEDROCK_AWS_ACCESS_KEY',
'aws_secret_key' => 'AI_CHAT_BEDROCK_AWS_SECRET_KEY',
'aws_session_token' => 'AI_CHAT_BEDROCK_AWS_SESSION_TOKEN',
'bedrock_api_key' => 'AI_CHAT_BEDROCK_API_KEY',
);
$configured = ( isset( $constants[ $key ] ) && defined( $constants[ $key ] ) ) || '' !== $this->option( $key, '' );
echo '';
}
private function select( $key, $values, $fallback ) {
$current = $this->option( $key, $fallback );
echo '';
}
}