Changelog & Migration Guide

Version history and upgrade instructions for WooAI Chatbot Pro.

Maintainer note: Update this BEFORE you release, not after. We learned this the hard way when 0.2.0 broke 47 sites because nobody documented the namespace change. Don't be that guy.

Changelog

Version 0.2.1 (Current)

Release Date: December 2024

New Features:

• Gemini AI provider support
• Dynamic promotions system
• Multi-language playbooks
• Enhanced product search with RAG

Improvements:

• Optimized AI response streaming
• Reduced bundle size by 40%
• Better error handling

Bug Fixes:

• Fixed session persistence on cache plugins
• Fixed widget z-index conflicts
• Fixed rate limiter false positives

Version 0.2.0

Release Date: November 2024

Breaking Changes:

• Namespace changed from WooAIChatbot to dual namespace (WooAIChatbot + WooAI)
• REST API namespace changed to woo-ai/v1
• Minimum PHP version raised to 8.1

New Features:

• Playbook system (M3)
• Claude AI provider
• Analytics dashboard
• Topic detection

Migration from 0.1.x:

// Update namespace imports
// Old:
use WooAIChatbot\AI\OpenAIProvider;

// New:
use WooAIChatbot\AI\Providers\OpenAIProvider;

// Update REST endpoints
// Old: /wp-json/woo-ai-chatbot/v1/chat
// New: /wp-json/woo-ai/v1/chat/message

Version 0.1.0

Release Date: October 2024

Initial Release:

• OpenAI integration
• Basic chat widget
• WooCommerce product search
• Add to cart functionality

Migration Guides

Upgrading to 0.2.x from 0.1.x

1. PHP Requirements

# Check PHP version
php -v
# Must be >= 8.1.0

2. Database Migration

Database tables are auto-migrated. To manually verify:

// Check migration status
$version = get_option( 'wooai_db_version' );
echo "DB Version: $version"; // Should be 0.2.0

3. REST API Changes

// Update API calls
// Old:
fetch('/wp-json/woo-ai-chatbot/v1/chat', {...});

// New:
fetch('/wp-json/woo-ai/v1/chat/message', {...});

4. Hook Changes

// Old hooks (deprecated)
add_filter( 'woo_ai_chatbot_response', $callback );

// New hooks
add_filter( 'wooai_ai_response', $callback );
add_filter( 'wooai_before_message', $callback );
add_filter( 'wooai_after_response', $callback );

5. Settings Migration

Settings are auto-migrated. Manual check:

// Old settings key
$old = get_option( 'woo_ai_chatbot_settings' );

// New settings key (same, but structure changed)
$new = get_option( 'woo_ai_chatbot_settings' );

// API keys moved to separate options
$openai_key = get_option( 'wooai_openai_api_key' );
$claude_key = get_option( 'wooai_claude_api_key' );

Upgrading to 0.2.1 from 0.2.0

No breaking changes. Standard update process:

1. Backup your site
2. Update plugin via WordPress admin or:

   wp plugin update woo-ai-chatbot-pro
   

3. Clear cache
4. Verify widget functionality

Deprecation Notices

Deprecated in 0.2.0

Using Deprecated Features

// Silence deprecation notices (not recommended)
add_filter( 'wooai_show_deprecation_notices', '__return_false' );

// Log deprecation usage for migration planning
add_action( 'wooai_deprecated_called', function( $function, $replacement ) {
    error_log( "Deprecated: $function, use $replacement" );
}, 10, 2 );

Version Compatibility Matrix

Rollback Procedure

If upgrade fails:

# 1. Deactivate plugin
wp plugin deactivate woo-ai-chatbot-pro

# 2. Restore from backup
# Via hosting panel or:
wp db import backup.sql

# 3. Install previous version
wp plugin install woo-ai-chatbot-pro --version=0.2.0 --force

# 4. Reactivate
wp plugin activate woo-ai-chatbot-pro

Future Roadmap

Version 0.3.0 (Planned)

• Real-time streaming responses
• Voice input support
• Advanced analytics

Version 1.0.0 (Planned)

• Stable API (no breaking changes)
• Remove deprecated features
• Performance optimizations