label. */ function aatg_get_image_size_options() { return array( 'thumbnail' => __( 'Thumbnail', 'ai-auto-alt-text-generator' ), 'medium' => __( 'Medium', 'ai-auto-alt-text-generator' ), 'large' => __( 'Large', 'ai-auto-alt-text-generator' ), 'full' => __( 'Full', 'ai-auto-alt-text-generator' ), ); } /** * Where to create an API key for each provider. * * @return array Provider ID => URL. */ function aatg_get_api_key_urls() { return array( 'openai' => 'https://platform.openai.com/api-keys', 'anthropic' => 'https://platform.claude.com/settings/keys', 'deepseek' => 'https://platform.deepseek.com/api_keys', ); } /* ---------- sanitising ---------- */ /** * Keep a value only if it is one of the allowed choices. * * @param mixed $value Submitted value. * @param array $allowed Allowed values. * @param string $default Fallback. * @return string */ function aatg_sanitize_choice( $value, array $allowed, $default ) { $value = is_scalar( $value ) ? (string) $value : ''; return in_array( $value, $allowed, true ) ? $value : $default; } /** * A known model ID; retired models map to their replacement. * * @param mixed $value Submitted value. * @return string */ function aatg_sanitize_model( $value ) { $value = is_scalar( $value ) ? (string) $value : ''; $retired = aatg_get_retired_models(); if ( isset( $retired[ $value ] ) ) { return $retired[ $value ]; } return array_key_exists( $value, aatg_get_models() ) ? $value : AATG_DEFAULT_MODEL; } /** * An integer clamped to a range; non-numbers give the default. * * @param mixed $value Submitted value. * @param int $min Minimum. * @param int $max Maximum. * @param int $default Fallback for non-numeric input. * @return int */ function aatg_sanitize_int_range( $value, $min, $max, $default ) { if ( ! is_numeric( $value ) ) { return (int) $default; } return max( (int) $min, min( (int) $max, (int) $value ) ); } /** * 'on' or 'off' for a checkbox (unchecked boxes submit nothing). * * @param mixed $value Submitted value. * @return string */ function aatg_sanitize_checkbox( $value ) { return 'on' === $value ? 'on' : 'off'; } /** * Secret fields are never sent back to the browser, so a blank submission of * the settings form keeps the saved value; the matching "remove" checkbox * clears it. Updates from code or WP-CLI store exactly what they are given. * * Hooked to pre_update_option_{option}. * * @param mixed $value New value. * @param mixed $old_value Saved value. * @param string $option Option name. * @return string */ function aatg_sanitize_api_key( $value, $old_value, $option ) { $clear_fields = array( 'aatg_openai_api_key' => 'aatg_clear_openai_key', 'aatg_anthropic_api_key' => 'aatg_clear_anthropic_key', 'aatg_deepseek_api_key' => 'aatg_clear_deepseek_key', 'aatg_webhook_secret' => 'aatg_clear_webhook_secret', ); $value = trim( sanitize_text_field( (string) $value ) ); // phpcs:disable WordPress.Security.NonceVerification.Missing -- options.php has verified the settings nonce. $from_form = isset( $_POST['option_page'] ) && 'aatg_options_group' === $_POST['option_page']; if ( ! $from_form ) { return $value; } if ( isset( $clear_fields[ $option ] ) && ! empty( $_POST[ $clear_fields[ $option ] ] ) ) { return ''; } // phpcs:enable return '' === $value ? (string) $old_value : $value; } foreach ( array( 'aatg_openai_api_key', 'aatg_anthropic_api_key', 'aatg_deepseek_api_key', 'aatg_webhook_secret' ) as $aatg_secret_option ) { add_filter( 'pre_update_option_' . $aatg_secret_option, 'aatg_sanitize_api_key', 10, 3 ); } unset( $aatg_secret_option ); /* ---------- registration ---------- */ /** * Register plugin settings, sections and fields. */ function aatg_register_settings_init() { $group = 'aatg_options_group'; $settings = array( 'aatg_openai_model' => array( 'string', 'aatg_sanitize_model', AATG_DEFAULT_MODEL ), 'aatg_openai_api_key' => array( 'string', 'sanitize_text_field', '' ), 'aatg_anthropic_api_key' => array( 'string', 'sanitize_text_field', '' ), 'aatg_deepseek_api_key' => array( 'string', 'sanitize_text_field', '' ), 'aatg_language' => array( 'string', function ( $value ) { return aatg_sanitize_choice( $value, array_keys( aatg_get_language_options() ), 'en_US' ); }, 'en_US', ), 'aatg_image_size' => array( 'string', function ( $value ) { return aatg_sanitize_choice( $value, array_keys( aatg_get_image_size_options() ), 'large' ); }, 'large', ), 'aatg_image_delivery' => array( 'string', function ( $value ) { return aatg_sanitize_choice( $value, array( 'embed', 'url' ), 'embed' ); }, 'embed', ), 'aatg_use_page_context' => array( 'string', 'aatg_sanitize_checkbox', 'on' ), 'aatg_send_filename' => array( 'string', 'aatg_sanitize_checkbox', 'on' ), 'aatg_site_context' => array( 'string', 'sanitize_textarea_field', '' ), 'aatg_auto_title' => array( 'string', 'aatg_sanitize_checkbox', 'on' ), 'aatg_image_detail' => array( 'string', function ( $value ) { return aatg_sanitize_choice( $value, array( 'low', 'high' ), 'low' ); }, 'low', ), 'aatg_bulk_batch_size' => array( 'integer', function ( $value ) { return aatg_sanitize_int_range( $value, 1, 10, 4 ); }, 4, ), 'aatg_bulk_delay' => array( 'integer', function ( $value ) { return aatg_sanitize_int_range( $value, 0, 60, 3 ); }, 3, ), 'aatg_request_timeout' => array( 'integer', function ( $value ) { return aatg_sanitize_int_range( $value, 10, 120, 30 ); }, 30, ), 'aatg_webhook_url' => array( 'string', 'esc_url_raw', '' ), 'aatg_webhook_secret' => array( 'string', 'sanitize_text_field', '' ), ); foreach ( $settings as $name => $setting ) { register_setting( $group, $name, array( 'type' => $setting[0], 'sanitize_callback' => $setting[1], 'default' => $setting[2], ) ); } $page = 'aatg-settings'; add_settings_section( 'aatg_settings_section', __( 'AI provider & model', 'ai-auto-alt-text-generator' ), 'aatg_section_callback', $page ); add_settings_section( 'aatg_content_section', __( 'Images & context', 'ai-auto-alt-text-generator' ), 'aatg_content_section_callback', $page ); add_settings_section( 'aatg_rate_limit_section', __( 'Performance & Rate Limits', 'ai-auto-alt-text-generator' ), 'aatg_rate_limit_section_callback', $page ); add_settings_section( 'aatg_integrations_section', __( 'Integrations & Webhooks', 'ai-auto-alt-text-generator' ), 'aatg_integrations_section_callback', $page ); add_settings_field( 'aatg_provider', __( 'AI provider', 'ai-auto-alt-text-generator' ), 'aatg_provider_render', $page, 'aatg_settings_section', array( 'label_for' => 'aatg_provider' ) ); add_settings_field( 'aatg_openai_model', __( 'Model', 'ai-auto-alt-text-generator' ), 'aatg_openai_model_render', $page, 'aatg_settings_section', array( 'label_for' => 'aatg_openai_model' ) ); foreach ( aatg_get_providers() as $provider => $label ) { add_settings_field( 'aatg_' . $provider . '_api_key', /* translators: %s = provider name */ sprintf( __( '%s API key', 'ai-auto-alt-text-generator' ), $label ), 'aatg_api_key_render', $page, 'aatg_settings_section', array( 'provider' => $provider, 'label_for' => 'aatg_' . $provider . '_api_key', 'class' => 'aatg-key-row aatg-key-row-' . $provider, ) ); } add_settings_field( 'aatg_language', __( 'Output language', 'ai-auto-alt-text-generator' ), 'aatg_language_render', $page, 'aatg_settings_section', array( 'label_for' => 'aatg_language' ) ); add_settings_field( 'aatg_auto_title', __( 'Automatically generate image title', 'ai-auto-alt-text-generator' ), 'aatg_auto_title_render', $page, 'aatg_content_section' ); add_settings_field( 'aatg_use_page_context', __( 'Use page context', 'ai-auto-alt-text-generator' ), 'aatg_use_page_context_render', $page, 'aatg_content_section' ); add_settings_field( 'aatg_site_context', __( 'Site context', 'ai-auto-alt-text-generator' ), 'aatg_site_context_render', $page, 'aatg_content_section', array( 'label_for' => 'aatg_site_context' ) ); add_settings_field( 'aatg_send_filename', __( 'Send image file name', 'ai-auto-alt-text-generator' ), 'aatg_send_filename_render', $page, 'aatg_content_section' ); add_settings_field( 'aatg_image_size', __( 'Image size to send', 'ai-auto-alt-text-generator' ), 'aatg_image_size_render', $page, 'aatg_content_section', array( 'label_for' => 'aatg_image_size' ) ); add_settings_field( 'aatg_image_delivery', __( 'Image delivery', 'ai-auto-alt-text-generator' ), 'aatg_image_delivery_render', $page, 'aatg_content_section', array( 'label_for' => 'aatg_image_delivery' ) ); add_settings_field( 'aatg_image_detail', __( 'Image detail quality', 'ai-auto-alt-text-generator' ), 'aatg_image_detail_render', $page, 'aatg_rate_limit_section', array( 'label_for' => 'aatg_image_detail' ) ); add_settings_field( 'aatg_bulk_batch_size', __( 'Bulk batch size', 'ai-auto-alt-text-generator' ), 'aatg_bulk_batch_size_render', $page, 'aatg_rate_limit_section', array( 'label_for' => 'aatg_bulk_batch_size' ) ); add_settings_field( 'aatg_bulk_delay', __( 'Bulk optimiser delay (seconds)', 'ai-auto-alt-text-generator' ), 'aatg_bulk_delay_render', $page, 'aatg_rate_limit_section', array( 'label_for' => 'aatg_bulk_delay' ) ); add_settings_field( 'aatg_request_timeout', __( 'Request timeout (seconds)', 'ai-auto-alt-text-generator' ), 'aatg_request_timeout_render', $page, 'aatg_rate_limit_section', array( 'label_for' => 'aatg_request_timeout' ) ); add_settings_field( 'aatg_webhook_url', __( 'Webhook URL', 'ai-auto-alt-text-generator' ), 'aatg_webhook_url_render', $page, 'aatg_integrations_section', array( 'label_for' => 'aatg_webhook_url' ) ); add_settings_field( 'aatg_webhook_secret', __( 'Webhook signing secret', 'ai-auto-alt-text-generator' ), 'aatg_webhook_secret_render', $page, 'aatg_integrations_section', array( 'label_for' => 'aatg_webhook_secret' ) ); } add_action( 'admin_init', 'aatg_register_settings_init' ); /* ---------- section descriptions ---------- */ function aatg_section_callback() { echo '
' . esc_html__( 'Choose the AI provider and vision model, and add an API key for that provider. Keys are stored in your database (or defined in wp-config.php) and only ever sent to that provider.', 'ai-auto-alt-text-generator' ) . '
'; } function aatg_content_section_callback() { echo '' . esc_html__( 'Control what is sent with each image. Page context helps the model pick relevant details, such as the heading and text around the image or the product it shows.', 'ai-auto-alt-text-generator' ) . '
'; } function aatg_rate_limit_section_callback() { echo '' . esc_html__( 'Tune these settings to reduce token usage and avoid rate limits during bulk runs.', 'ai-auto-alt-text-generator' ) . '
'; } function aatg_integrations_section_callback() { echo '' . esc_html__( 'Optionally POST to an external URL each time alt text or a title is generated — useful for automation tools (Zapier, Make), logging, or syncing to other systems.', 'ai-auto-alt-text-generator' ) . '
'; } /* ---------- field renderers ---------- */ /** * Print a