load_options(); $this->llm_service = new LLM_Service(); add_action('admin_menu', array($this, 'add_admin_menu')); add_action('admin_init', array($this, 'register_settings')); add_action('admin_enqueue_scripts', array($this, 'enqueue_admin_scripts')); add_action('wp_ajax_test_api_connection', array($this, 'ajax_test_api_connection')); add_action('wp_ajax_regenerate_excerpt', array($this, 'ajax_regenerate_excerpt')); add_action('wp_ajax_bulk_generate_excerpts', array($this, 'ajax_bulk_generate_excerpts')); add_action('wp_ajax_get_bulk_progress', array($this, 'ajax_get_bulk_progress')); add_action('wp_ajax_reset_bulk_progress', array($this, 'ajax_reset_bulk_progress')); add_action('wp_ajax_get_excerpt_status', array($this, 'ajax_get_excerpt_status')); add_action('wp_ajax_debug_test', array($this, 'ajax_debug_test')); add_action('wp_ajax_generate_excerpt_preview', array($this, 'ajax_generate_excerpt_preview')); add_action('wp_ajax_save_excerpt_manual', array($this, 'ajax_save_excerpt_manual')); // Post editor meta box add_action('add_meta_boxes', array($this, 'add_excerpt_meta_box')); add_action('save_post', array($this, 'save_excerpt_meta_box'), 5, 2); } /** * Load options (allows for refresh). */ private function load_options() { $defaults = array( 'is_active' => false, 'admin_only' => false, 'llm_provider' => 'claude', 'claude_model' => 'claude-3-5-haiku-20241022', 'openai_model' => 'gpt-4o', 'gemini_model' => 'gemini-1.5-flash', 'api_key' => '', 'excerpt_type' => 'seo', 'max_length' => 300, 'min_content_length' => 100, 'featured_image' => false, 'featured_size' => 'thumbnail', 'featured_align' => 'alignleft', 'search_featured' => false, 'more_link_text' => '', 'skip_manual' => false, 'fallback_enabled' => true, 'background_processing' => true, 'immediate_threshold' => 1000, 'batch_size' => 5, 'batch_delay' => 300 ); $this->options = wp_parse_args(get_option('ai_smart_excerpt_options', array()), $defaults); } /** * Add admin menu. */ public function add_admin_menu() { add_options_page( esc_html__('AI Smart Excerpt Settings', 'ai-smart-excerpt'), esc_html__('AI Smart Excerpt', 'ai-smart-excerpt'), 'manage_options', 'ai-smart-excerpt', array($this, 'admin_page') ); } /** * Register plugin settings. */ public function register_settings() { register_setting( 'ai_smart_excerpt_options', 'ai_smart_excerpt_options', array($this, 'validate_options') ); // General Settings Section add_settings_section( 'general_settings', esc_html__('General Settings', 'ai-smart-excerpt'), array($this, 'general_settings_callback'), 'ai-smart-excerpt' ); // AI Provider Settings Section add_settings_section( 'ai_settings', esc_html__('AI Provider Settings', 'ai-smart-excerpt'), array($this, 'ai_settings_callback'), 'ai-smart-excerpt' ); // Excerpt Settings Section add_settings_section( 'excerpt_settings', esc_html__('Excerpt Settings', 'ai-smart-excerpt'), array($this, 'excerpt_settings_callback'), 'ai-smart-excerpt' ); // Display Settings Section add_settings_section( 'display_settings', esc_html__('Display Settings', 'ai-smart-excerpt'), array($this, 'display_settings_callback'), 'ai-smart-excerpt' ); // Advanced Settings Section add_settings_section( 'advanced_settings', esc_html__('Advanced Settings', 'ai-smart-excerpt'), array($this, 'advanced_settings_callback'), 'ai-smart-excerpt' ); $this->add_settings_fields(); } /** * Add settings fields. */ private function add_settings_fields() { // General Settings add_settings_field( 'is_active', esc_html__('Enable Plugin', 'ai-smart-excerpt'), array($this, 'checkbox_field'), 'ai-smart-excerpt', 'general_settings', array('field' => 'is_active', 'description' => esc_html__('Enable AI-powered excerpt generation', 'ai-smart-excerpt')) ); add_settings_field( 'admin_only', esc_html__('Admin Only Mode', 'ai-smart-excerpt'), array($this, 'checkbox_field'), 'ai-smart-excerpt', 'general_settings', array('field' => 'admin_only', 'description' => esc_html__('Only generate excerpts for admin users (for testing)', 'ai-smart-excerpt')) ); // AI Provider Settings add_settings_field( 'llm_provider', esc_html__('AI Provider', 'ai-smart-excerpt'), array($this, 'select_field'), 'ai-smart-excerpt', 'ai_settings', array( 'field' => 'llm_provider', 'options' => LLM_Service::get_providers(), 'description' => esc_html__('Choose your preferred AI provider', 'ai-smart-excerpt') ) ); add_settings_field( 'api_key', esc_html__('API Key', 'ai-smart-excerpt'), array($this, 'password_field'), 'ai-smart-excerpt', 'ai_settings', array('field' => 'api_key', 'description' => esc_html__('Enter your API key for the selected provider', 'ai-smart-excerpt')) ); // Excerpt Settings add_settings_field( 'excerpt_type', esc_html__('Excerpt Type', 'ai-smart-excerpt'), array($this, 'select_field'), 'ai-smart-excerpt', 'excerpt_settings', array( 'field' => 'excerpt_type', 'options' => array( 'seo' => esc_html__('SEO Optimized', 'ai-smart-excerpt'), 'social' => esc_html__('Social Media Optimized', 'ai-smart-excerpt'), 'summary' => esc_html__('Summary', 'ai-smart-excerpt'), 'teaser' => esc_html__('Engaging Teaser', 'ai-smart-excerpt') ), 'description' => esc_html__('Choose the type of excerpt to generate', 'ai-smart-excerpt') ) ); add_settings_field( 'max_length', esc_html__('Maximum Length', 'ai-smart-excerpt'), array($this, 'number_field'), 'ai-smart-excerpt', 'excerpt_settings', array( 'field' => 'max_length', 'min' => 50, 'max' => 500, 'description' => esc_html__('Maximum excerpt length in characters', 'ai-smart-excerpt') ) ); add_settings_field( 'min_content_length', esc_html__('Minimum Content Length', 'ai-smart-excerpt'), array($this, 'number_field'), 'ai-smart-excerpt', 'excerpt_settings', array( 'field' => 'min_content_length', 'min' => 50, 'max' => 1000, 'description' => esc_html__('Minimum post content length to process (shorter posts will be skipped)', 'ai-smart-excerpt') ) ); // Display Settings add_settings_field( 'featured_image', esc_html__('Show Featured Image', 'ai-smart-excerpt'), array($this, 'checkbox_field'), 'ai-smart-excerpt', 'display_settings', array('field' => 'featured_image', 'description' => esc_html__('Display featured image with excerpt', 'ai-smart-excerpt')) ); add_settings_field( 'featured_size', esc_html__('Image Size', 'ai-smart-excerpt'), array($this, 'select_field'), 'ai-smart-excerpt', 'display_settings', array( 'field' => 'featured_size', 'options' => array( 'thumbnail' => esc_html__('Thumbnail', 'ai-smart-excerpt'), 'medium' => esc_html__('Medium', 'ai-smart-excerpt'), 'large' => esc_html__('Large', 'ai-smart-excerpt'), 'full' => esc_html__('Full Size', 'ai-smart-excerpt') ), 'description' => esc_html__('Size of the featured image to display', 'ai-smart-excerpt') ) ); add_settings_field( 'featured_align', esc_html__('Image Alignment', 'ai-smart-excerpt'), array($this, 'select_field'), 'ai-smart-excerpt', 'display_settings', array( 'field' => 'featured_align', 'options' => array( 'alignleft' => esc_html__('Left', 'ai-smart-excerpt'), 'alignright' => esc_html__('Right', 'ai-smart-excerpt'), 'aligncenter' => esc_html__('Center', 'ai-smart-excerpt') ), 'description' => esc_html__('Alignment of the featured image', 'ai-smart-excerpt') ) ); add_settings_field( 'search_featured', esc_html__('Search for Images', 'ai-smart-excerpt'), array($this, 'checkbox_field'), 'ai-smart-excerpt', 'display_settings', array('field' => 'search_featured', 'description' => esc_html__('If no featured image, search for first image in content', 'ai-smart-excerpt')) ); add_settings_field( 'more_link_text', esc_html__('Read More Text', 'ai-smart-excerpt'), array($this, 'text_field'), 'ai-smart-excerpt', 'display_settings', array('field' => 'more_link_text', 'description' => esc_html__('Text for "read more" link (leave empty to disable)', 'ai-smart-excerpt')) ); // Advanced Settings add_settings_field( 'skip_manual', esc_html__('Override Manual Excerpts', 'ai-smart-excerpt'), array($this, 'checkbox_field'), 'ai-smart-excerpt', 'advanced_settings', array('field' => 'skip_manual', 'description' => esc_html__('Generate AI excerpts even when manual excerpts exist', 'ai-smart-excerpt')) ); add_settings_field( 'fallback_enabled', esc_html__('Enable Fallback', 'ai-smart-excerpt'), array($this, 'checkbox_field'), 'ai-smart-excerpt', 'advanced_settings', array('field' => 'fallback_enabled', 'description' => esc_html__('Use simple excerpt generation if AI fails', 'ai-smart-excerpt')) ); } /** * Section callbacks. */ public function general_settings_callback() { echo '
' . esc_html__('Basic plugin activation and testing settings.', 'ai-smart-excerpt') . '
'; } public function ai_settings_callback() { echo '' . esc_html__('Configure your AI provider and API credentials.', 'ai-smart-excerpt') . '
'; } public function excerpt_settings_callback() { echo '' . esc_html__('Customize how excerpts are generated.', 'ai-smart-excerpt') . '
'; } public function display_settings_callback() { echo '' . esc_html__('Control how excerpts are displayed on your site.', 'ai-smart-excerpt') . '
'; } public function advanced_settings_callback() { echo '' . esc_html__('Advanced configuration options.', 'ai-smart-excerpt') . '
'; } /** * Field callbacks. */ public function checkbox_field($args) { $field = $args['field']; $value = isset($this->options[$field]) ? $this->options[$field] : false; $description = isset($args['description']) ? $args['description'] : ''; echo ''; } public function text_field($args) { $field = $args['field']; $value = isset($this->options[$field]) ? $this->options[$field] : ''; $description = isset($args['description']) ? $args['description'] : ''; echo ''; if ($description) { echo '' . esc_html($description) . '
'; } } public function password_field($args) { $field = $args['field']; $value = isset($this->options[$field]) ? $this->options[$field] : ''; $description = isset($args['description']) ? $args['description'] : ''; echo ''; if ($field === 'api_key') { echo ' '; echo ''; } if ($description) { echo '' . esc_html($description) . '
'; } } public function number_field($args) { $field = $args['field']; $value = isset($this->options[$field]) ? $this->options[$field] : ''; $min = isset($args['min']) ? $args['min'] : ''; $max = isset($args['max']) ? $args['max'] : ''; $description = isset($args['description']) ? $args['description'] : ''; echo ''; if ($description) { echo '' . esc_html($description) . '
'; } } public function select_field($args) { $field = $args['field']; $value = isset($this->options[$field]) ? $this->options[$field] : ''; $options = $args['options']; $description = isset($args['description']) ? $args['description'] : ''; echo ''; if ($description) { echo '' . esc_html($description) . '
'; } } /** * Validate options. * * @param array $input Raw input data. * @return array Validated options. */ public function validate_options($input) { // Start with existing options to preserve values not in current form $existing_options = get_option('ai_smart_excerpt_options', array()); $validated = $existing_options; // Determine which form section was submitted $form_section = isset($input['ai_smart_excerpt_form_section']) ? $input['ai_smart_excerpt_form_section'] : 'unknown'; // Define which fields belong to each form section $section_fields = array( 'general' => array('is_active', 'admin_only'), 'ai_provider' => array('llm_provider', 'api_key', 'claude_model', 'openai_model', 'gemini_model'), 'excerpts' => array('excerpt_type', 'max_length', 'min_content_length'), 'display' => array('featured_image', 'featured_size', 'featured_align', 'search_featured', 'more_link_text'), 'advanced' => array('skip_manual', 'fallback_enabled') ); // Boolean fields $boolean_fields = array('is_active', 'admin_only', 'featured_image', 'search_featured', 'skip_manual', 'fallback_enabled'); // Only update fields that belong to the submitted form section if (isset($section_fields[$form_section])) { $fields_to_update = $section_fields[$form_section]; foreach ($fields_to_update as $field) { if (in_array($field, $boolean_fields)) { // Handle boolean fields $validated[$field] = isset($input[$field]) ? true : false; } else { // Handle other fields if present in input if (isset($input[$field])) { $validated[$field] = $input[$field]; // Will be sanitized below } } } } else { // Fallback: if no section specified, handle all boolean fields for backward compatibility foreach ($boolean_fields as $field) { if (array_key_exists($field, $input)) { $validated[$field] = isset($input[$field]) ? true : false; } } // Also handle non-boolean fields if they exist in input $all_fields = array_merge( $section_fields['general'] ?? array(), $section_fields['ai_provider'] ?? array(), $section_fields['excerpts'] ?? array(), $section_fields['display'] ?? array(), $section_fields['advanced'] ?? array() ); foreach ($all_fields as $field) { if (!in_array($field, $boolean_fields) && isset($input[$field])) { $validated[$field] = $input[$field]; } } } // Apply proper sanitization to validated fields // Text fields $text_fields = array('api_key', 'more_link_text'); foreach ($text_fields as $field) { if (isset($validated[$field]) && $validated[$field] !== $existing_options[$field]) { $validated[$field] = sanitize_text_field($validated[$field]); } } // Select fields with specific options $select_fields = array( 'llm_provider' => array_keys(LLM_Service::get_providers()), 'claude_model' => array_keys(LLM_Service::get_models_for_provider('claude')), 'openai_model' => array_keys(LLM_Service::get_models_for_provider('openai')), 'gemini_model' => array_keys(LLM_Service::get_models_for_provider('gemini')), 'excerpt_type' => array('seo', 'social', 'summary', 'teaser'), 'featured_size' => array('thumbnail', 'medium', 'large', 'full'), 'featured_align' => array('alignleft', 'alignright', 'aligncenter') ); foreach ($select_fields as $field => $valid_options) { if (isset($validated[$field])) { if (!in_array($validated[$field], $valid_options)) { // Invalid value, revert to existing or default if (isset($existing_options[$field]) && in_array($existing_options[$field], $valid_options)) { $validated[$field] = $existing_options[$field]; } else { $validated[$field] = $valid_options[0]; // Use first valid option as default } } // Value is valid, keep it as is } else if (isset($input[$field]) && in_array($input[$field], $valid_options)) { // Field wasn't processed by section logic but exists in input and is valid $validated[$field] = $input[$field]; } } // Number fields $number_fields = array( 'max_length' => array('min' => 50, 'max' => 500), 'min_content_length' => array('min' => 50, 'max' => 1000), ); foreach ($number_fields as $field => $limits) { if (isset($validated[$field])) { if ($validated[$field] !== $existing_options[$field]) { $value = intval($validated[$field]); $validated[$field] = max($limits['min'], min($limits['max'], $value)); } } else if (isset($input[$field])) { // Field wasn't processed by section logic but exists in input $value = intval($input[$field]); $validated[$field] = max($limits['min'], min($limits['max'], $value)); } } // Validate API key format if (!empty($validated['api_key']) && !empty($validated['llm_provider'])) { if (!$this->llm_service->validate_api_key_format($validated['llm_provider'], $validated['api_key'])) { add_settings_error( 'ai_smart_excerpt_options', 'invalid_api_key', esc_html__('API key format is invalid for the selected provider.', 'ai-smart-excerpt') ); } } return $validated; } /** * Admin page display. */ public function admin_page() { if (!current_user_can('manage_options')) { return; } // Reload options to ensure we have the latest values $this->load_options(); $active_tab = isset($_GET['tab']) ? sanitize_text_field($_GET['tab']) : 'overview'; ?>
' . esc_html($description) . '
'; } break; case 'password': echo ''; if ($description) { echo '' . esc_html($description) . '
'; } break; case 'number': $min = isset($args['min']) ? $args['min'] : ''; $max = isset($args['max']) ? $args['max'] : ''; echo ''; if ($description) { echo '' . esc_html($description) . '
'; } break; case 'select': echo ''; if ($description) { echo '' . esc_html($description) . '
'; } break; } echo '