Commit Graph

15 Commits

Author SHA1 Message Date
dwindown
60658c6786 feat: Complete backend wiring for notification system
 Global System Toggle:
- Added GET/POST /notifications/system-mode endpoints
- Switch between WooNooW and WooCommerce notification systems
- Stored in: woonoow_notification_system_mode
- EmailManager::is_enabled() checks system mode
- NotificationManager checks mode before sending

 Template System Wired:
- Templates saved via API are used when sending
- EmailRenderer fetches templates from TemplateProvider
- Variables replaced automatically
- Markdown parsed (cards, buttons, images)
- Email customization applied (colors, logo, branding)

 Channel Toggle Wired:
- Frontend toggles saved to database
- NotificationManager::is_channel_enabled() checks before sending
- Email: woonoow_email_notifications_enabled
- Push: woonoow_push_notifications_enabled

 Event Toggle Wired:
- Per-event channel settings saved
- NotificationManager::is_event_channel_enabled() checks before sending
- Stored in: woonoow_notification_settings

 Email Sending Flow:
Event → EmailManager → Check System Mode → Check Channel Toggle
→ Check Event Toggle → EmailRenderer → Get Template → Replace Variables
→ Parse Markdown → Apply Branding → wp_mail() → Sent

 All Settings Applied:
- Template modifications saved and used
- Channel toggles respected
- Event toggles respected
- Global system mode respected
- Email customization applied
- Push settings applied

📋 Modified Files:
- NotificationsController.php: Added system-mode endpoints
- NotificationManager.php: Added system mode check, wired EmailRenderer
- EmailManager.php: Added is_enabled() check for system mode

🎯 Result: Complete end-to-end notification system fully functional
2025-11-15 21:59:46 +07:00
dwindown
4471cd600f feat: Complete markdown syntax refinement and variable protection
 New cleaner syntax implemented:
- [card:type] instead of [card type='type']
- [button:style](url)Text[/button] instead of [button url='...' style='...']
- Standard markdown images: ![alt](url)

 Variable protection from markdown parsing:
- Variables with underscores (e.g., {order_items_table}) now protected
- HTML comment placeholders prevent italic/bold parsing
- All variables render correctly in preview

 Button rendering fixes:
- Buttons work in Visual mode inside cards
- Buttons work in Preview mode
- Button clicks prevented in visual editor
- Proper styling for solid and outline buttons

 Backward compatibility:
- Old syntax still supported
- No breaking changes

 Bug fixes:
- Fixed order_item_table → order_items_table naming
- Fixed button regex to match across newlines
- Added button/image parsing to parseMarkdownBasics
- Prevented button clicks on .button and .button-outline classes

📚 Documentation:
- NEW_MARKDOWN_SYNTAX.md - Complete user guide
- MARKDOWN_SYNTAX_AND_VARIABLES.md - Technical analysis
2025-11-15 20:05:50 +07:00
dwindown
a3aab7f4a0 feat: Complete Default Email Templates for All Events! 📧
## Task 7 Complete: Default Email Content 

### New File Created:
**`DefaultEmailTemplates.php`**
- Comprehensive default templates for all 9 events
- Separate templates for staff vs customer recipients
- Professional, well-structured HTML with card blocks
- All use modern card-based email builder syntax

### Email Templates Included:

**Order Events:**
1. **Order Placed** (Staff)
   - Hero card with order notification
   - Order details, customer info, items list
   - View order button

2. **Order Processing** (Customer)
   - Success card confirmation
   - Order summary with status
   - What's next information
   - Track order button

3. **Order Completed** (Customer)
   - Success card celebration
   - Order details with completion date
   - Thank you message
   - View order + Continue shopping buttons

4. **Order Cancelled** (Staff)
   - Warning card notification
   - Order and customer details
   - View order button

5. **Order Refunded** (Customer)
   - Info card with refund notification
   - Refund details and amount
   - Timeline expectations
   - View order button

**Product Events:**
6. **Low Stock Alert** (Staff)
   - Warning card
   - Product details with stock levels
   - Action required message
   - View product button

7. **Out of Stock Alert** (Staff)
   - Warning card
   - Product details
   - Immediate action required
   - Manage product button

**Customer Events:**
8. **New Customer** (Customer)
   - Hero welcome card
   - Account details
   - Feature list (order history, tracking, etc.)
   - My Account + Start Shopping buttons

9. **Customer Note** (Customer)
   - Info card
   - Order details
   - Note content display
   - View order button

### Integration:
- Updated `TemplateProvider.php` to use DefaultEmailTemplates
- Automatic template generation for all events
- Push notification templates also complete
- Proper variable mapping per event type

### Features:
- Card-based modern design
- Hero/Success/Warning/Info card types
- Multiple buttons with solid/outline styles
- Proper variable placeholders
- Professional copy for all scenarios
- Consistent branding throughout

All 7 tasks now complete! 🎉
2025-11-13 15:27:16 +07:00
dwindown
b6c2b077ee feat: Complete Social Icons & Settings Expansion! 🎨
## Implemented (Tasks 1-6):

### 1. All Social Platforms Added 
**Platforms:**
- Facebook, X (Twitter), Instagram
- LinkedIn, YouTube
- Discord, Spotify, Telegram
- WhatsApp, Threads, Website

**Frontend:** Updated select dropdown with all platforms
**Backend:** Added to allowed_platforms whitelist

### 2. PNG Icons Instead of Emoji 
- Use local PNG files from `/assets/icons/`
- Format: `mage--{platform}-{color}.png`
- Applied to email rendering and preview
- Much more accurate than emoji

### 3. Icon Color Option (Black/White) 
- New setting: `social_icon_color`
- Select dropdown: White Icons / Black Icons
- White for dark backgrounds
- Black for light backgrounds
- Applied to all social icons

### 4. Body Background Color Setting 
- New setting: `body_bg_color`
- Color picker + hex input
- Default: #f8f8f8
- Applied to email body background
- Applied to preview

### 5. Editor Mode Styling 📝
**Note:** Editor mode intentionally shows structure/content
Preview mode shows final styled result with all customizations
This is standard email builder UX pattern

### 6. Hero Preview Text Color Fixed 
- Applied `hero_text_color` directly to h3 and p
- Now correctly shows selected color
- Both heading and paragraph use custom color

## Technical Changes:

**Frontend:**
- Added body_bg_color and social_icon_color to interface
- Updated all social platform icons (Lucide)
- PNG icon URLs in preview
- Hero preview color fix

**Backend:**
- Added body_bg_color and social_icon_color to defaults
- Sanitization for new fields
- Updated allowed_platforms array
- PNG icon URL generation with color param

**Email Rendering:**
- Use PNG icons with color selection
- Apply body_bg_color
- get_social_icon_url() updated for PNG files

## Files Modified:
- `routes/Settings/Notifications/EmailCustomization.tsx`
- `routes/Settings/Notifications/EditTemplate.tsx`
- `includes/Api/NotificationsController.php`
- `includes/Core/Notifications/EmailRenderer.php`

Task 7 (default email content) pending - separate commit.
2025-11-13 14:50:55 +07:00
dwindown
2a98d6fc2b feat: Backend API & Email Rendering with Settings! 🔌
## 4. Wire to Backend 

### API Endpoints Created:
- `GET /woonoow/v1/notifications/email-settings` - Fetch settings
- `POST /woonoow/v1/notifications/email-settings` - Save settings
- `DELETE /woonoow/v1/notifications/email-settings` - Reset to defaults

### Features:
- Proper sanitization (sanitize_hex_color, esc_url_raw, etc.)
- Social links validation (allowed platforms only)
- Defaults fallback
- Stored in wp_options as `woonoow_email_settings`

### Email Rendering Integration:
**Logo & Header:**
- Uses logo_url if set, otherwise header_text
- Falls back to store name

**Footer:**
- Uses footer_text with {current_year} support
- Replaces {current_year} with actual year dynamically
- Social icons rendered from social_links array

**Hero Cards:**
- Applies hero_gradient_start and hero_gradient_end
- Applies hero_text_color to text and headings
- Works for type="hero" and type="success" cards

**Button Colors:**
- Ready to apply primary_color and button_text_color
- (Template needs update for dynamic button colors)

### Files:
- `includes/Api/NotificationsController.php` - API endpoints
- `includes/Core/Notifications/EmailRenderer.php` - Apply settings to emails

### Security:
- Permission checks (check_permission)
- Input sanitization
- URL validation
- Platform whitelist for social links

Frontend can now save/load settings! Backend applies them to emails! 🎉
2025-11-13 13:45:03 +07:00
dwindown
5d04878264 feat: Major UX Improvements - Perfect Builder Experience! 🎯
##  1. Prevent Link/Button Navigation in Builder
**Problem:** Clicking links/buttons redirected users, preventing editing
**Solution:**
- Added click handler in BlockRenderer to prevent navigation
- Added handleClick in TipTap editorProps
- Links and buttons now only editable, not clickable

**Files:**
- `components/EmailBuilder/BlockRenderer.tsx`
- `components/ui/rich-text-editor.tsx`

##  2. Default Templates Use Raw Buttons
**Problem:** Default content had formatted buttons in cards
**Solution:**
- Changed `[card]<a class="button">...</a>[/card]`
- To `[button link="..." style="solid"]...[/button]`
- Matches current block structure

**File:**
- `includes/Core/Notifications/TemplateProvider.php`

##  3. Split Order Items into List & Table
**Problem:** Only one order_items variable
**Solution:**
- `{order_items_list}` - Formatted list (ul/li)
- `{order_items_table}` - Formatted table
- Better control over presentation

**File:**
- `includes/Core/Notifications/TemplateProvider.php`

##  4. Payment URL Variable Added
**Problem:** No way to link to payment page
**Solution:**
- Added `{payment_url}` variable
- Strategy:
  - Manual payment → order details/thankyou page
  - API payment → payment gateway URL
- Reads from order payment_meta

**File:**
- `includes/Core/Notifications/TemplateProvider.php`

##  5. Variable Categorization (Noted)
**Strategy for future:**
- Order events: order_items_table, payment_url
- Account events: login_url, account_url
- Contextual variables only
- Better UX, less confusion

##  6. WordPress Media Library Fixed
**Problem:** WP Media not loaded, showing browser prompt
**Solution:**
- Added `wp_enqueue_media()` in Assets.php
- Changed prompt to alert with better message
- Added debugging console logs
- Now loads properly!

**Files:**
- `includes/Admin/Assets.php`
- `lib/wp-media.ts`

---

## 📋 Summary

All 6 UX improvements implemented:
1.  No navigation in builder (links/buttons editable only)
2.  Default templates use raw buttons
3.  Order items split: list & table
4.  Payment URL variable added
5.  Variable categorization strategy noted
6.  WordPress Media library properly loaded

**Perfect builder experience achieved!** 🎉
2025-11-13 10:32:52 +07:00
dwindown
aa9ca24988 fix: All 7 User Feedback Issues Resolved! 🎯
##  Issue 1: WordPress Media Not Loading
**Problem:** WP media library not loaded error
**Solution:**
- Added fallback to URL prompt
- Better error handling
- User can still insert images if WP media fails

##  Issue 2: Button Variables Filter
**Problem:** All variables shown in button link field
**Solution:**
- Filter to only show URL variables
- Applied to both RichTextEditor and EmailBuilder
- Only `*_url` variables displayed

**Before:** {order_number} {customer_name} {order_total} ...
**After:** {order_url} {store_url} only

##  Issue 3: Color Customization Note
**Noted for future:**
- Hero card gradient colors
- Button primary color
- Button secondary border color
- Will be added to email customization form later

##  Issue 4 & 5: Heading Display in Editor & Builder
**Problem:** Headings looked like paragraphs
**Solution:**
- Added Tailwind heading styles to RichTextEditor
- Added heading styles to BlockRenderer
- Now headings are visually distinct:
  - H1: 3xl, bold
  - H2: 2xl, bold
  - H3: xl, bold
  - H4: lg, bold

**Files Modified:**
- `components/ui/rich-text-editor.tsx`
- `components/EmailBuilder/BlockRenderer.tsx`

##  Issue 6: Order Items Variable
**Problem:** No variable for product list/table
**Solution:**
- Added `order_items` variable
- Description: "Order Items (formatted table)"
- Will render formatted product list in emails

**File Modified:**
- `includes/Core/Notifications/TemplateProvider.php`

##  Issue 7: Remove Edit Icon from Spacer/Divider
**Problem:** Edit button shown but no options to edit
**Solution:**
- Conditional rendering of edit button
- Only show for `card` and `button` blocks
- Spacer and divider only show: ↑ ↓ ×

**File Modified:**
- `components/EmailBuilder/BlockRenderer.tsx`

---

## 📋 Summary

All user feedback addressed:
1.  WP Media fallback
2.  Button variables filtered
3.  Color customization noted
4.  Headings visible in editor
5.  Headings visible in builder
6.  Order items variable added
7.  Edit icon removed from spacer/divider

Ready for testing! ��
2025-11-13 10:12:03 +07:00
dwindown
1573bff7b3 feat: Card-based email system implementation
##  Core Card System Complete!

### base.html Template
-  Single, theme-agnostic template
-  Card system CSS (default, highlight, info, warning, success, bg)
-  Customizable header (logo/text)
-  Customizable footer + social icons
-  Customizable body background
-  Mobile responsive
-  Email client compatible (Outlook, Gmail, etc.)

### EmailRenderer.php - Card Parser
-  `parse_cards()` - Parses [card]...[/card] syntax
-  `parse_card_attributes()` - Extracts type and bg attributes
-  `render_card()` - Renders card HTML
-  `render_card_spacing()` - 24px spacing between cards
-  `render_html()` - Email customization support
-  `get_social_icon_url()` - Social media icons

### Card Types Supported
```
[card]                        → Default white card
[card type="highlight"]       → Purple gradient card
[card type="info"]            → Blue info card
[card type="warning"]         → Yellow warning card
[card type="success"]         → Green success card
[card bg="https://..."]       → Background image card
```

### Email Customization
-  Header: Logo or text
-  Body background color
-  Footer text
-  Social media links (Facebook, Instagram, Twitter, LinkedIn)
-  Stored in `woonoow_notification_settings[email_appearance]`

### Default Templates Updated
-  order_placed_email - Multi-card layout
-  order_processing_email - Success card + summary
-  Other templates ready to update

---

**Architecture:**
```
Content with [card] tags
    ↓
parse_cards()
    ↓
render_card() × N
    ↓
base.html template
    ↓
Beautiful HTML email! 🎨
```

**Next:** Settings UI + Live Preview 🚀
2025-11-12 23:14:00 +07:00
dwindown
30384464a1 feat: Custom email system foundation
##  Step 1-3: Email System Core

### EmailManager.php
-  Disables WooCommerce emails (prevents duplicates)
-  Hooks into all WC order status changes
-  Hooks into customer, product events
-  Checks if events are enabled before sending
-  Sends via wp_mail() (SMTP plugin compatible)

### EmailRenderer.php
-  Renders emails with design templates
-  Variable replacement system
-  Gets recipient email (staff/customer)
-  Loads order/product/customer variables
-  Filter hook: `woonoow_email_template`
-  Supports HTML template designs

### Email Design Templates (3)
**templates/emails/modern.html**
-  Clean, minimalist, Apple-inspired
-  Dark mode support
-  Mobile responsive
-  2024 design trends

**templates/emails/classic.html**
-  Professional, traditional
-  Gradient header
-  Table styling
-  Business-appropriate

**templates/emails/minimal.html**
-  Ultra-clean, monospace font
-  Black & white aesthetic
-  Text-focused
-  Dark mode invert

### Architecture
```
Design Template (HTML) → Content Template (Text) → Final Email
   modern.html        →  order_processing      →  Beautiful HTML
```

---

**Next:** Rich text editor + Content templates 🎨
2025-11-12 18:48:55 +07:00
dwindown
c8adb9e924 feat: Integrate WooCommerce email templates
##  Issue #4: WooCommerce Template Integration

**TemplateProvider.php:**
-  Added `get_wc_email_template()` method
-  Loads actual WooCommerce email subjects
-  Falls back to custom defaults if WC not available
-  Maps WooNooW events to WC email classes:
  - order_placed → WC_Email_New_Order
  - order_processing → WC_Email_Customer_Processing_Order
  - order_completed → WC_Email_Customer_Completed_Order
  - order_cancelled → WC_Email_Cancelled_Order
  - order_refunded → WC_Email_Customer_Refunded_Order
  - new_customer → WC_Email_Customer_New_Account
  - customer_note → WC_Email_Customer_Note

### How It Works
1. On template load, checks if WooCommerce is active
2. Loads WC email objects via `WC()->mailer()->get_emails()`
3. Extracts subject, heading, enabled status
4. Uses WC subject as default, falls back to custom if not available
5. Body remains custom (WC templates are HTML, we use plain text)

### Benefits
-  Consistent with WooCommerce email settings
-  Respects store owner customizations
-  Automatic updates when WC emails change
-  Graceful fallback if WC not available

---

**Result:** Templates now load from WooCommerce! 🎉
2025-11-11 21:06:56 +07:00
dwindown
fbb0e87f6e feat: Add NotificationManager with dual-level toggle logic
##  Notification Logic Implementation

### NotificationManager Class

**Location:** `includes/Core/Notifications/NotificationManager.php`

**Key Features:**
1.  Dual-level validation (global + per-event)
2.  Channel enabled checking
3.  Event-channel enabled checking
4.  Combined validation logic
5.  Recipient management
6.  Extensible for addons

**Methods:**
- `is_channel_enabled($channel_id)` - Global state
- `is_event_channel_enabled($event_id, $channel_id)` - Event state
- `should_send_notification($event_id, $channel_id)` - Combined validation
- `get_recipient($event_id, $channel_id)` - Get recipient type
- `send($event_id, $channel_id, $data)` - Send notification

### Logic Flow

```
┌─────────────────────────────────┐
│ Global Channel Toggle           │
│ (Channels Page)                 │
│ ✓ Affects ALL events            │
└────────────┬────────────────────┘
             │
             ↓
┌─────────────────────────────────┐
│ Per-Event Channel Toggle        │
│ (Events Page)                   │
│ ✓ Affects specific event        │
└────────────┬────────────────────┘
             │
             ↓
┌─────────────────────────────────┐
│ Both Enabled?                   │
│ ✓ Yes → Send notification       │
│ ✗ No  → Skip                    │
└─────────────────────────────────┘
```

### Documentation

**Added:** `NOTIFICATION_LOGIC.md`

**Contents:**
- Toggle hierarchy explanation
- Decision logic with examples
- Implementation details
- Usage examples
- Storage structure
- Testing checklist
- Future enhancements

### Integration Points

**For Addon Developers:**
```php
// Check before sending
if (NotificationManager::should_send_notification($event_id, $channel_id)) {
    // Your addon logic here
}

// Hook into send
add_filter('woonoow_send_notification', function($sent, $event_id, $channel_id, $recipient, $data) {
    if ($channel_id === 'my_channel') {
        // Handle your channel
        return my_send_function($data);
    }
    return $sent;
}, 10, 5);
```

### Testing

**Manual Tests:**
1.  Disable email globally → No emails
2.  Enable email globally, disable per-event → Selective emails
3.  Enable both → Emails sent
4.  Same for push notifications
5.  UI state persistence
6.  Visual feedback (colors, toasts)

---

**Notification system is production-ready with proper validation!** 🎯
2025-11-11 15:34:40 +07:00
dwindown
26eb7cb898 feat: Implement push notification settings backend and UI
##  Push Notification Settings - Fully Functional

### Backend (PHP)

**PushNotificationHandler Updates:**
- Added `SETTINGS_KEY` constant
- `ensure_default_settings()` - Initialize defaults
- `get_default_settings()` - Return default config
- `get_settings()` - Fetch current settings
- `update_settings()` - Save settings

**Default Settings:**
```php
[
  'use_logo' => true,
  'use_product_images' => true,
  'use_gravatar' => false,
  'click_action' => '/wp-admin/admin.php?page=woonoow#/orders',
  'require_interaction' => false,
  'silent' => false,
]
```

**NotificationsController:**
- `GET /notifications/push/settings` - Fetch settings
- `POST /notifications/push/settings` - Update settings
- Permission-protected endpoints

### Frontend (React)

**ChannelConfig Component:**
- Fetches push settings on open
- Real-time state management
- Connected switches and inputs
- Save mutation with loading state
- Toast notifications for success/error
- Disabled state during save

**Settings Available:**
1. **Branding**
   - Use Store Logo
   - Use Product Images
   - Use Customer Gravatar

2. **Behavior**
   - Click Action URL (input)
   - Require Interaction
   - Silent Notifications

### Features

 **Backend Storage** - Settings saved in wp_options
 **REST API** - GET and POST endpoints
 **Frontend UI** - Full CRUD interface
 **State Management** - React Query integration
 **Loading States** - Skeleton and button states
 **Error Handling** - Toast notifications
 **Default Values** - Sensible defaults

---

**Next: Email channel toggle** 📧
2025-11-11 15:15:02 +07:00
dwindown
97e76a837b feat: Add template editor and push notifications infrastructure
##  Template Editor + Push Notifications

### Backend (PHP)

**1. TemplateProvider** (`includes/Core/Notifications/TemplateProvider.php`)
- Manages notification templates in wp_options
- Default templates for all events x channels
- Variable system (order, product, customer, store)
- Template CRUD operations
- Variable replacement engine

**2. PushNotificationHandler** (`includes/Core/Notifications/PushNotificationHandler.php`)
- VAPID keys generation and storage
- Push subscription management
- Queue system for push notifications
- User-specific subscriptions
- Service worker integration ready

**3. NotificationsController** - Extended with:
- GET /notifications/templates - List all templates
- GET /notifications/templates/:eventId/:channelId - Get template
- POST /notifications/templates - Save template
- DELETE /notifications/templates/:eventId/:channelId - Reset to default
- GET /notifications/push/vapid-key - Get VAPID public key
- POST /notifications/push/subscribe - Subscribe to push
- POST /notifications/push/unsubscribe - Unsubscribe

**4. Push channel added to built-in channels**

### Frontend (React)

**1. TemplateEditor Component** (`TemplateEditor.tsx`)
- Modal dialog for editing templates
- Subject + Body text editors
- Variable insertion with dropdown
- Click-to-insert variables
- Live preview
- Save and reset to default
- Per event + channel customization

**2. Templates Page** - Completely rewritten:
- Lists all events x channels
- Shows "Custom" badge for customized templates
- Edit button opens template editor
- Fetches templates from API
- Variable reference guide
- Organized by channel

### Key Features

 **Simple Text Editor** (not HTML builder)
- Subject line
- Body text with variables
- Variable picker
- Preview mode

 **Variable System**
- Order variables: {order_number}, {order_total}, etc.
- Customer variables: {customer_name}, {customer_email}, etc.
- Product variables: {product_name}, {stock_quantity}, etc.
- Store variables: {store_name}, {store_url}, etc.
- Click to insert at cursor position

 **Push Notifications Ready**
- VAPID key generation
- Subscription management
- Queue system
- PWA integration ready
- Built-in channel (alongside email)

 **Template Management**
- Default templates for all events
- Per-event, per-channel customization
- Reset to default functionality
- Custom badge indicator

### Default Templates Included

**Email:**
- Order Placed, Processing, Completed, Cancelled, Refunded
- Low Stock, Out of Stock
- New Customer, Customer Note

**Push:**
- Order Placed, Processing, Completed
- Low Stock Alert

### Next Steps

1.  Service worker for push notifications
2.  Push subscription UI in Channels page
3.  Test push notifications
4.  Addon integration examples

---

**Ready for testing!** 🚀
2025-11-11 13:09:33 +07:00
dwindown
ffdc7aae5f feat: Implement notification system with 3 subpages (Events, Channels, Templates)
##  Correct Implementation Following NOTIFICATION_STRATEGY.md

### Frontend (React) - 3 Subpages

**1. Main Notifications Page** (`Notifications.tsx`)
- Tab navigation for 3 sections
- Events | Channels | Templates

**2. Events Subpage** (`Notifications/Events.tsx`)
- Configure which channels per event
- Grouped by category (Orders, Products, Customers)
- Toggle channels (Email, WhatsApp, Telegram, etc.)
- Show recipient (Admin/Customer/Both)
- Switch UI for enable/disable per channel

**3. Channels Subpage** (`Notifications/Channels.tsx`)
- List available channels
- Built-in channels (Email)
- Addon channels (WhatsApp, Telegram, SMS, Push)
- Channel status (Active/Inactive)
- Configure button for each channel
- Addon discovery cards

**4. Templates Subpage** (`Notifications/Templates.tsx`)
- Email templates (link to WooCommerce)
- Addon channel templates
- Template variables reference
- Preview and edit buttons
- Variable documentation ({order_number}, {customer_name}, etc.)

### Backend (PHP) - Bridge to WooCommerce

**NotificationsController** (`includes/Api/NotificationsController.php`)
- Bridges to WooCommerce email system
- Does NOT reinvent notification system
- Provides addon integration hooks

**REST API Endpoints:**
```
GET  /notifications/channels  - List channels (email + addons)
GET  /notifications/events     - List events (maps to WC emails)
POST /notifications/events/update - Update event channel settings
```

**Key Features:**
 Leverages WooCommerce emails (not reinventing)
 Stores settings in wp_options
 Provides hooks for addons:
   - `woonoow_notification_channels` filter
   - `woonoow_notification_events` filter
   - `woonoow_notification_event_updated` action

### Addon Integration

**Example: WhatsApp Addon**
```php
// Register channel
add_filter("woonoow_notification_channels", function($channels) {
    $channels[] = [
        "id" => "whatsapp",
        "label" => "WhatsApp",
        "icon" => "message-circle",
        "enabled" => true,
        "addon" => "woonoow-whatsapp",
    ];
    return $channels;
});

// React to event updates
add_action("woonoow_notification_event_updated", function($event_id, $channel_id, $enabled, $recipient) {
    if ($channel_id === "whatsapp" && $enabled) {
        // Setup WhatsApp notification for this event
    }
}, 10, 4);

// Hook into WooCommerce email triggers
add_action("woocommerce_order_status_processing", function($order_id) {
    // Send WhatsApp notification
}, 10, 1);
```

### Architecture

**NOT a new notification system** 
- Uses WooCommerce email infrastructure
- Maps events to WC email IDs
- Addons hook into WC triggers

**IS an extensible framework** 
- Unified UI for all channels
- Per-event channel configuration
- Template management
- Addon discovery

### Files Created
- `Notifications.tsx` - Main page with tabs
- `Notifications/Events.tsx` - Events configuration
- `Notifications/Channels.tsx` - Channel management
- `Notifications/Templates.tsx` - Template editor
- `NotificationsController.php` - REST API bridge

### Files Modified
- `Routes.php` - Register NotificationsController

---

**Ready for addon development!** 🚀
Next: Build Telegram addon as proof of concept
2025-11-11 12:31:13 +07:00
dwindown
01fc3eb36d feat: Implement notification system with extensible channel architecture
##  Notification System Implementation

Following NOTIFICATION_STRATEGY.md, built on top of WooCommerce email infrastructure.

### Backend (PHP)

**1. NotificationManager** (`includes/Core/Notifications/NotificationManager.php`)
- Central manager for notification system
- Registers email channel (built-in)
- Registers default notification events (orders, products, customers)
- Provides hooks for addon channels
- Maps to WooCommerce email IDs

**2. NotificationSettingsProvider** (`includes/Core/Notifications/NotificationSettingsProvider.php`)
- Manages settings in wp_options
- Per-event channel configuration
- Per-channel recipient settings (admin/customer/both)
- Default settings with email enabled

**3. NotificationsController** (`includes/Api/NotificationsController.php`)
- REST API endpoints:
  - GET /notifications/channels - List available channels
  - GET /notifications/events - List notification events (grouped by category)
  - GET /notifications/settings - Get all settings
  - POST /notifications/settings - Update settings

### Frontend (React)

**Updated Notifications.tsx:**
- Shows available notification channels (email + addons)
- Channel cards with built-in/addon badges
- Event configuration by category (orders, products, customers)
- Toggle channels per event with button UI
- Link to WooCommerce advanced email settings
- Responsive and modern UI

### Key Features

 **Built on WooCommerce Emails**
- Email channel uses existing WC email system
- No reinventing the wheel
- Maps events to WC email IDs

 **Extensible Architecture**
- Addons can register channels via hooks
- `woonoow_notification_channels` filter
- `woonoow_notification_send_{channel}` action
- Per-event channel selection

 **User-Friendly UI**
- Clear channel status (Active/Inactive)
- Per-event channel toggles
- Category grouping (orders, products, customers)
- Addon discovery hints

 **Settings Storage**
- Stored in wp_options (woonoow_notification_settings)
- Per-event configuration
- Per-channel settings
- Default: email enabled for all events

### Addon Integration Example

```php
// Addon registers WhatsApp channel
add_action("woonoow_register_notification_channels", function() {
    NotificationManager::register_channel("whatsapp", [
        "label" => "WhatsApp",
        "icon" => "message-circle",
        "addon" => "woonoow-whatsapp",
    ]);
});

// Addon handles sending
add_action("woonoow_notification_send_whatsapp", function($event_id, $data) {
    // Send WhatsApp message
}, 10, 2);
```

### Files Created
- NotificationManager.php
- NotificationSettingsProvider.php
- NotificationsController.php

### Files Modified
- Routes.php - Register NotificationsController
- Bootstrap.php - Initialize NotificationManager
- Notifications.tsx - New UI with channels and events

---

**Ready for addon development!** 🚀
Next: Build Telegram addon as proof of concept
2025-11-11 12:11:08 +07:00