AI Search – Intelligent Search for WooCommerce and WordPress

Registo de alterações

1.22.0

• Domain Mismatch Detection: Admin warning when site domain differs from the registered AI Search Service domain
• One-Click Reconnect: Button to easily reconnect and get a new token for the current domain
• Automatic Origin Tracking: Plugin now stores the registered origin for future mismatch detection
• Improved Migration Support: Better handling when moving sites between domains (staging to production, domain changes)

1.21.0

• Reusable CPT/Taxonomy Selector Component: New shared UI component for Post Type, Taxonomy, and Term selection
• Clear Embeddings by Post Type/Taxonomy: Delete embeddings for specific post types or taxonomy terms (not just all at once)
• Improved Cache & Clean Tab: Added filtered clearing option alongside existing “Clear All” functionality
• UI Component Architecture: Introduced components/ folder for reusable admin UI elements
• Code Refactoring: Reduced code duplication between Generate Embeddings and Cache & Clean tabs
• Taxonomy/Category Filter for Embeddings: Generate embeddings filtered by specific categories or taxonomies (not just post types)
• Dynamic Taxonomy Loading: Taxonomies and terms load dynamically via AJAX based on selected post type
• Improved Generate Embeddings UI: Cleaner form layout with loading states and better UX

1.20.0

• Performance Optimization for Large Sites: Major improvements for sites with thousands of posts
• Batched Processing: Posts are now processed in batches of 100 for optimal memory usage
• Search Results Caching: Results are cached for 5 minutes to speed up repeated queries
• Direct Database Queries: Optimized queries that fetch only necessary data
• Memory Management: Automatic cleanup between batches to prevent memory exhaustion
• New Default Threshold: Changed default similarity threshold from 65% to 30% for better out-of-box results
• Improved Threshold Guidelines: Updated slider recommendations (30% now recommended as starting point)

1.19.0

• Dedicated Admin Menu: AI Search now has its own top-level menu in WordPress admin (no longer under Settings)
• Improved Menu Navigation: Settings pages and Setup Wizard now correctly highlight the AI Search menu
• Contact the Author: New submenu link to contact the plugin author directly
• URL Structure Update: All admin URLs now use admin.php?page=ai-search for better WordPress integration

1.18.0

• REST API Settings Endpoint: New public endpoint at /wp-json/ai-search/v1/settings exposing plugin configuration for debugging (no sensitive data)
• OpenAI Model Selection: Choose between text-embedding-3-small (default, recommended) and text-embedding-3-large when using your own OpenAI API key
• Extended Threshold Range: Similarity threshold now supports 10-100% (previously 50-100%) for broader search flexibility
• Updated Default Model: OpenAI embeddings now use text-embedding-3-small instead of the older text-embedding-ada-002

1.17.0

• Hybrid Search: New feature combining AI semantic search with traditional keyword matching for improved accuracy
• Search Configuration Tab: Dedicated settings tab for fine-tuning search behavior (similarity threshold and hybrid search)
• Configurable Balance Slider: Adjust the weight between AI semantic search (0-100%) and keyword matching
• Enhanced Keyword Matching: Keyword scoring now includes custom fields and WooCommerce fields configured in settings
• Reusable UI Components: New slider components for threshold and hybrid balance configuration
• Improved Search Accuracy: Better ranking when exact keyword matches are important alongside semantic understanding

1.16.0

• Automatic Embedding Generation on Publish: Embeddings now generated automatically when posts/pages/custom post types are published
• Improved Performance: Removed automatic embedding generation on every save – now only triggers on publish status transition
• Universal CPT Support: Automatic embedding generation works seamlessly for all post types without additional configuration
• Post Meta Box Enhancement: Content quality indicator and embedding preview available for published posts only
• Better Resource Management: Reduced API calls by only generating embeddings when content is ready for public viewing
• Setup Wizard Updates: Final step now includes similarity threshold configuration with better default value (0.65)
• Admin Interface Improvements: Post Meta Box now provides clear status messages for unpublished posts
• Case-Insensitive Search: All content and search queries converted to lowercase for consistent matching
• Enhanced Similarity Display: AI Search badges now show percentage similarity scores on search results (editors/admins only)
• Fallback Search Improvements: Fallback results now calculate and display actual similarity scores instead of showing 0%
• Threshold Filtering on Fallback: All fallback search strategies now respect the similarity threshold setting
• CSS Classes for Results: Added ai-search-similarity-{percentage} CSS classes to all search results for custom styling
• Frontend Threshold Slider: Admins can test different threshold values directly on search results pages

1.15.0

• Enhanced Setup Wizard: Expanded from 3 to 4 steps with new custom fields configuration
• Custom Fields Step: New dedicated wizard step for choosing searchable content
• Content Richness Emphasis: Added messaging that “richer content = better search results”
• Post Type Selection: Choose which post types (posts, pages, custom types) are searchable during setup
• WooCommerce Field Configuration: Configure product fields (SKU, categories, tags, attributes) in wizard
• Streamlined Admin Menu: Simplified submenu to General Settings, Setup Wizard, and Support Forum link
• Direct Support Access: Added WordPress.org support forum link directly in admin menu
• Improved Quota Display: Quota tab now shows relevant message for users with their own OpenAI API key
• Better Onboarding Flow: Setup wizard now guides users to configure content before generating embeddings
• Brazilian Portuguese Translation: Added pt_BR translation file for readme

1.14.0

• Quota Management Tab: New dedicated tab showing real-time usage statistics from AI Search Service
• Usage Monitoring: Visual progress bars displaying total embeddings and daily usage against limits
• Quota Status Indicators: Clear status badges showing if quotas are active or exceeded
• Manual Refresh: On-demand quota data refresh with intelligent 6-hour caching
• Detailed Error Messages: Enhanced error handling with specific API error messages
• Last Updated Timestamp: Human-readable “last updated X ago” display for quota data
• Quota Manager Class: New dedicated controller class for quota management (separation of concerns)
• API Integration: Direct integration with /clients/quota endpoint using Bearer token authentication
• Internationalization: All new quota strings fully translatable

1.13.0

• Top-Level Admin Menu: AI Search moved from Settings submenu to main WordPress admin menu (position 58, before Settings)
• Custom Menu Icon: Added plugin icon (SVG) to admin menu
• Full i18n Support: All admin settings pages now fully translatable
• Improved Admin UX: Better visibility and professional appearance in WordPress admin

1.12.0

• Automatic Service Registration: Plugin now registers with AI Search Service immediately on activation
• Setup Wizard Redirect: Users are automatically redirected to the setup wizard after plugin activation
• Simplified Settings UI: Removed service token field from settings – connection is now managed automatically
• Check Connection Button: Replaced “Validate Token” with cleaner “Check Connection” button showing usage stats
• Streamlined Onboarding: Better first-time user experience with automatic configuration
• Code Cleanup: Removed unused spelling suggestions and search highlighter classes

1.11.0

• Exibição de Limiar Baseada em Percentagem: O limiar de similaridade agora é exibido como percentagem (20-100%) em vez de decimal (0.2-1.0) para mais fácil compreensão
• Opção de Visibilidade Pública do Distintivo: Nova definição de administração para mostrar o distintivo AI Search a todos os visitantes, não apenas editores/administradores
• Funcionalidade de Analítica Removida: Plugin simplificado ao remover painel de analítica de pesquisa e acompanhamento
• Documentação WooCommerce Melhorada: Readme melhorado com palavras-chave específicas de eCommerce e casos de uso
• Melhorias Visuais: Secção de limiar de similaridade redesenhada com indicadores visuais proeminentes
• Política Sem Emojis: Removidos todos os emojis da interface de administração para aparência profissional
• Lançamento do site: Adicionada ligação para https://wp-search.ai para documentação e demonstrações

1.10.1

• Distintivo de Resultado AI Search: Distintivo visual exibido nos resultados de pesquisa baseados em IA
  • Mostra a etiqueta “Resultado AI Search” com o ícone do plugin
  • Apenas visível para editores e administradores
  • Dica explica a restrição de visibilidade
• Classes CSS de Similaridade: Adicionadas classes CSS aos artigos de resultados de pesquisa
  • classe ai-search-result para resultados baseados em IA
  • classe ai-search-similarity-{0-100} com percentagem exata de similaridade
  • classe ai-search-match quando o resultado atinge o limiar configurado
  • classe ai-search-fallback para resultados de contingência não-IA
• Avisos de Frontend Removidos: Removidos os avisos intrusivos de feedback de pesquisa que eram mostrados a todos os utilizadores
• Melhoria para Programadores: Pontuações de similaridade acessíveis através de propriedades estáticas para personalização de temas

1.10.0

• Painel de Analítica de Pesquisa: Acompanhe e analise o comportamento de pesquisa
  • Registar todas as consultas de pesquisa com contagens de resultados
  • Acompanhamento de cliques nos resultados de pesquisa
  • Consultas populares e análise de resultados zero
  • Estatísticas e tendências baseadas em tempo
  • Funcionalidade de exportação CSV
• Sugestões de Ortografia “Quis dizer?”: Correcção ortográfica inteligente
  • Vocabulário construído a partir de títulos de artigos e taxonomias
  • Correspondência de palavras baseada em distância de Levenshtein
  • Sugestões em cache para desempenho
• Destaque de Termos de Pesquisa: Feedback visual nos resultados de pesquisa
  • Destaca termos correspondentes em títulos e excertos
  • Cores de destaque personalizáveis através de filtros
  • Suporte para modo escuro

1.9.2

• Consistência de Versão: Corrigida incompatibilidade de versão entre cabeçalho do plugin e constantes internas
• Pronto para Internacionalização: Adicionado text-domain ‘ai-search’ e caminho de domínio para suporte de tradução
• Correcção de Documentação: Corrigida a documentação do intervalo do limiar de similaridade (0.2-1.0)
• Filtro de Programador: Adicionado filtro ai_search_searchable_post_types para personalizar que tipos de conteúdo são pesquisáveis

1.9.0

• Sistema de Pesquisa de Contingência Melhorado: Introduzido mecanismo inteligente de contingência de 4 níveis para pesquisas sem resultados:
  • Contingência para pesquisa predefinida do WordPress com exibição de contagem de resultados
  • Pesquisa semântica mais ampla com limiares de similaridade relaxados
  • Pesquisa de conteúdo não processado para artigos sem embeddings
  • Sistema inteligente de sugestão de consultas para pesquisas completamente falhadas
• Notificações de Feedback do Utilizador: Sistema de feedback de pesquisa em tempo real com avisos que podem ser dispensados:
  • Indicadores visuais mostrando que método de contingência foi usado
  • Contagens de resultados de pesquisa para transparência
  • Limpeza automática de transientes de feedback
  • Mensagens contextuais para diferentes cenários de pesquisa
• Demonstração Interactiva de Limiar: Interface profissional de demonstração de limiar:
  • Visualização de similaridade de produtos em tempo real
  • Conjunto de dados de exemplo de loja de roupa com cenário de pesquisa de verão
  • Filtragem dinâmica baseada em ajustes de limiar
  • Indicadores de desempenho mostrando taxas de recuperação e níveis de precisão
  • Pontuações de similaridade codificadas por cor e feedback visual
• Sistema de Validação de Token: Gestão abrangente de token de serviço:
  • Validação de token com um clique com estatísticas de utilização detalhadas
  • Monitorização de quota em tempo real (limites diários/totais)
  • Exibição de informações do cliente incluindo verificação de origem
  • Tratamento de erros para tokens inválidos ou expirados
• Melhoria do Assistente de Configuração: Experiência de primeira utilização melhorada:
  • Processo de configuração passo a passo
  • Comparação de fornecedores com recomendações claras
  • Indicadores visuais de progresso e transições suaves
  • Fluxo de conclusão abrangente

1.8.0

• Gestão de Token de Serviço: Adicionado campo manual de token de serviço nas Definições Gerais para melhor controlo e transparência
• Sistema de Validação de Token: Novo botão “Validar Token” com validação em tempo real e estatísticas de utilização detalhadas
• Interface de Administração Melhorada: Campo de token de serviço mostra/oculta automaticamente com base na selecção do fornecedor
• Resultados de Validação Abrangentes: Exibe ID do cliente, origem, limites diários/totais, utilização actual e estado da quota
• Tratamento de Erros Melhorado: Melhores mensagens de erro para falhas de validação de token e problemas de conexão
• Melhorias de Experiência do Utilizador: Spinner de carregamento, estados de botões e orientação de utilizador mais clara
• Melhorias de Depuração: Adicionado registo de erros para melhor resolução de problemas e monitorização de resposta da API

1.7.0

• Grandes melhorias de desempenho e UX
• Optimização de Registo de Serviço: Movido o registo de serviço de IA da inicialização do plugin para gravação de definições, eliminando chamadas API desnecessárias durante carregamentos normais de página
• Separador de Gestão de Cache: Adicionada interface abrangente de gestão de cache com três opções de limpeza:
  • Limpar cache de embeddings (transientes) – regeneração segura
  • Limpar meta embeddings de artigos – requer regeneração manual
  • Limpar todos os dados de embeddings – opção de reposição completa
• Limiar de Similaridade Melhorado**: Precisão e intervalo melhorados:
  • Intervalo alterado de 0.0-1.0 para 0.2-1.0 (elimina resultados de relevância muito baixa permitindo pesquisas mais amplas)
  • Precisão aumentada de passos de 0.01 para 0.001 (3 casas decimais)
  • Melhor orientação de utilizador e formatação
• Arquitetura de Código Modular: Refactorizado registo de serviço em métodos isolados e reutilizáveis para melhor manutenção
• Estatísticas de Cache em Tempo Real: Exibir tamanho actual da cache e contagens de embeddings de artigos
• Tratamento de Erros Melhorado**: Melhor feedback ao utilizador quando o serviço de IA está indisponível com contingência automática
• Melhorias de Segurança: Verificação de nonce melhorada e verificações de capacidade de utilizador

1.6

• Substituído armazenamento interno de embeddings por integração de serviço externo.
• Autenticação baseada em token por origem.
• Repor pesquisa original no caso de não haver resultados de IA
• Resolver erros fatais no caso de os vectores não terem o mesmo tamanho

1.5

• Geração de embeddings em massa baseada em número personalizado de artigos

1.4

• Reformulação da UI de Definições: Introduzida navegação por separadores para separar “Definições Gerais” e “Gerar Embeddings” para melhor organização.
• Geração de Embeddings em Lote: Os utilizadores podem agora desencadear a geração de embeddings para até 50 artigos de cada vez.
• Selecção de Tipo de Conteúdo Personalizado: Foi adicionado um selector, permitindo aos utilizadores escolher para que CPT querem gerar embeddings.
• Optimização de Embeddings: Agora processa apenas artigos que ainda não têm embeddings para evitar chamadas de API redundantes e melhorar o desempenho.
• Melhorias de Segurança: Adicionada verificação de nonce para proteger actualizações de definições.

Esta actualização melhora significativamente a usabilidade, optimiza o desempenho e dá aos utilizadores mais controlo sobre os embeddings de pesquisa baseados em IA.

1.3

• Controlo de Limiar de Similaridade: Adicionado um campo de entrada de intervalo (0-1) nas definições para permitir aos utilizadores ajustar o limiar de similaridade dinamicamente.

1.2

• Embeddings de pesquisa em cache, guardados em transientes por um dia

1.1

• text-davinci-003 (obsoleto) foi substituído pelo modelo text-embedding-ada-002
• Manipulação de base de dados foi substituída pela abordagem custom_post_meta

1.0

• Lançamento inicial, adicionando a página de definições e o filtro de pesquisa.