- Added license_duration_days field to ProductVariant type
- Added License Duration input to each variation card
- Backend: ProductsController saves/loads variation-level _license_duration_days meta
- Allows different license periods per variation (e.g., 1-year, 2-year, lifetime)
Copy Cart/Checkout Links:
- Added to GeneralTab for simple products (same pattern as variations)
- Link generation with add-to-cart and redirect params
Licensing Settings:
- 'Enable licensing for this product' checkbox in Additional Options
- License settings panel: activation limit, duration (days)
- State management in ProductFormTabbed
- Backend: ProductsController saves/loads licensing meta fields
Backend:
- _licensing_enabled, _license_activation_limit, _license_duration_days post meta
- LicensingSettings.php with key format, activation limits, expiry settings
- LicenseManager.php with key generation, activation/deactivation, validation
- LicensingModule.php with WooCommerce product meta integration
- LicensesController.php with admin, customer, and public API endpoints
- Database tables: woonoow_licenses, woonoow_license_activations
- has_settings enabled in ModuleRegistry
1. Admin Store Link - Add to WP admin bar (Menu.php) with proper option check
2. Activity Log - Fix Loading text to show correct state after data loads
3. Avatar Upload - Use correct option key woonoow_allow_custom_avatar
4. Downloadable Files - Connect to WooCommerce native:
- Add downloads array to format_product_full
- Add downloads/download_limit/download_expiry handling in update_product
- Add downloads handling in create_product
- Add Store link to admin header (visible when customer SPA is enabled)
- Add storeUrl and customerSpaEnabled to WNW_CONFIG in Assets.php and StandaloneAdmin.php
- Update window.d.ts with new WNW_CONFIG properties
- Create ActivityLog.tsx component with search, filters, and pagination
- Add /notifications/logs API endpoint to NotificationsController
- Update Notifications.tsx to link to activity log page
- Add ActivityLog route to App.tsx
Phase 1: Core Documentation
- Created docs/ folder with 8 markdown documentation files
- Getting Started, Installation, Troubleshooting, FAQ
- Configuration docs (Appearance, SPA Mode)
- Feature docs (Shop, Checkout)
- PHP registry with filter hook for addon extensibility
Phase 2: Documentation Viewer
- DocsController.php with REST API endpoints
- GET /woonoow/v1/docs - List all docs (with addon hook)
- GET /woonoow/v1/docs/{slug} - Get document content
- Admin SPA /help route with sidebar navigation
- Markdown rendering with react-markdown
- Added Help & Docs to More page for mobile access
Filter Hook: woonoow_docs_registry
Addons can register their own documentation sections.
- Fixed redirect_wc_pages_to_spa: added spa_mode check (only redirect when 'full')
- Fixed PHP fatal error: use get_queried_object() instead of global $product
- Removed all error_log debug statements from codebase
- Fixed broken syntax in PaymentGatewaysProvider.php after error_log removal
- Created ResetPassword.tsx with:
- Password reset form with strength indicator
- Key validation on load
- Show/hide password toggle
- Success/error states
- Redirect to login on success
- Updated EmailManager.php:
- Changed reset_link from wp-login.php to SPA route
- Format: /wp-admin/admin.php?page=woonoow#/reset-password?key=KEY&login=LOGIN
- Added AuthController API methods:
- validate_reset_key: Validates reset key before showing form
- reset_password: Performs actual password reset
- Registered new REST routes in Routes.php:
- POST /auth/validate-reset-key
- POST /auth/reset-password
Password reset emails now link to the SPA instead of native WordPress.
1. API Route Fix (NotificationsController.php):
- Changed PUT to POST for /templates/:eventId/:channelId
- Frontend was using api.post() but backend only accepted PUT
- Templates can now be saved
2. Contextual Variables (EventRegistry.php):
- Added get_variables_for_event() method
- Returns category-based variables (order, customer, product, etc.)
- Merges event-specific variables from event definition
- Sorted alphabetically for easy browsing
3. API Response (NotificationsController.php):
- Template API now returns available_variables for the event
- Frontend can show only relevant variables
4. Frontend (EditTemplate.tsx):
- Removed hardcoded 50+ variable list
- Now uses template.available_variables from API
- Variables update based on selected event type
1. Auto-login after checkout:
- Added wp_set_auth_cookie() and wp_set_current_user() in CheckoutController
- Auto-registered users are now logged in when thank-you page loads
2. ThankYou page guest buttons:
- Added 'Login / Create Account' button for guests
- Shows for both receipt and basic templates
- No more dead-end after placing order as guest
3. Forgot password flow:
- Created ForgotPassword page component (/forgot-password route)
- Added forgot_password API endpoint in AuthController
- Uses WordPress retrieve_password() for reset email
- Replaced wp-login.php link in Login page
1. Temp password for auto-registered users:
- Store password in _woonoow_temp_password user meta (CheckoutController)
- Add {user_temp_password} and {login_url} variables (EmailRenderer)
- Update new_customer email template to show credentials
2. WC page redirects to SPA routes:
- Added redirect_wc_pages_to_spa() in TemplateOverride
- Maps: /shop → /store/#/, /cart → /store/#/cart, etc.
- /checkout → /store/#/checkout, /my-account → /store/#/account
- Single products → /store/#/products/{slug}
3. Removed shortcode system:
- Commented out Shortcodes::init() in Bootstrap
- WC pages now redirect to SPA instead
- Created Login/index.tsx with styled form
- Added /auth/customer-login API endpoint (no admin perms required)
- Registered route in Routes.php
- Added /login route in customer-spa App.tsx
- Account page now redirects to SPA login instead of wp-login.php
- Login supports redirect param for post-login navigation
1. Remove wishlist setting from customer settings (now in module toggle)
- Removed from CustomerSettingsProvider.php
- Removed from Customers.tsx
2. Remove auto-login from REST API (causes cookie issues)
- Auto-login in REST context doesn't properly set browser cookies
- Removed wp_set_current_user/wp_set_auth_cookie calls
3. Fix cart not clearing after order
- Added WC()->cart->empty_cart() after successful order
- Server-side cart was not being cleared, causing re-population
- Frontend clears local store but Cart page syncs with server
- After creating new user account, immediately log them in
- Uses wp_set_current_user() and wp_set_auth_cookie()
- Provides smoother UX - customer is logged in after placing order
- Shop page and other customer pages need to read module settings
- Settings are non-sensitive configuration values (e.g. wishlist display)
- POST endpoint remains admin-only for security
- Fixes 401 errors on shop page for /modules/wishlist/settings
- When 'Auto-register customers as site members' is enabled
- Creates WP user account with 'customer' role for guest checkouts
- Links order to existing user if email already registered
- Sets WooCommerce customer billing data on new account
- Triggers woocommerce_created_customer action for email notification
- Add public /checkout/order/{id} endpoint with order_key validation
- Update checkout redirect to include order_key parameter
- Update ThankYou page to use new public endpoint with key
- Support both guest (via key) and logged-in (via customer_id) access
Problem 1: Customer SPA not loading (stuck on 'Loading...')
Root Cause: Missing type='module' attribute on customer SPA script tag
Solution: Added script_loader_tag filter to inject type='module' for ES modules
Problem 2: Production zip too large (21-41MB)
Root Cause: Build script included unnecessary files (dist folder, fonts, .vite, test files, archives)
Solution:
- Exclude entire customer-spa and admin-spa directories from rsync
- Manually copy only app.js and app.css for both SPAs
- Exclude dist/, archive/, test-*.php, check-*.php files
- Simplified Frontend/Assets.php to always load app.js/app.css directly (no manifest needed)
Changes:
- includes/Frontend/Assets.php:
* Added type='module' to customer SPA script (both manifest and fallback paths)
* Removed manifest logic, always load app.js and app.css directly
- build-production.sh:
* Exclude customer-spa and admin-spa directories completely
* Manually copy only dist/app.js and dist/app.css
* Exclude dist/, archive/, test files
Result:
✅ Customer SPA loads with type='module' support
✅ Production zip reduced from 21-41MB to 1.6MB
✅ Only essential files included (app.js + app.css for both SPAs)
✅ Clean production package without dev artifacts
Package contents:
- Customer SPA: 480K (app.js) + 52K (app.css) = 532K
- Admin SPA: 2.6M (app.js) + 76K (app.css) = 2.7M
- PHP Backend: ~500K
- Total: 1.6M (compressed)
Problem: Routes were registered but methods didn't exist, causing 500 Internal Server Error
Error: 'The handler for the route is invalid'
Root Cause: The previous multi_edit tool call failed to add the method implementations.
Only the route registrations were added, but the actual PHP methods were missing.
Solution: Added all 9 taxonomy CRUD methods to ProductsController:
Categories:
- create_category() - Uses wp_insert_term()
- update_category() - Uses wp_update_term()
- delete_category() - Uses wp_delete_term()
Tags:
- create_tag() - Uses wp_insert_term()
- update_tag() - Uses wp_update_term()
- delete_tag() - Uses wp_delete_term()
Attributes:
- create_attribute() - Uses wc_create_attribute()
- update_attribute() - Uses wc_update_attribute()
- delete_attribute() - Uses wc_delete_attribute()
Each method includes:
✅ Input sanitization
✅ Error handling with WP_Error checks
✅ Proper response format matching frontend expectations
✅ Try-catch blocks for exception handling
Files Modified:
- includes/Api/ProductsController.php (added 354 lines of CRUD methods)
Result:
✅ All taxonomy CRUD operations now work
✅ No more 500 Internal Server Error
✅ Categories, tags, and attributes can be created/updated/deleted
Fixed duplicate code and broken docblock comment that was causing PHP syntax error.
The multi_edit tool had issues with the large edit and left broken code.
Navigation Fixes:
1. Newsletter submenu now hidden when module disabled
- NavigationRegistry checks ModuleRegistry::is_enabled('newsletter')
- Menu updates dynamically based on module status
2. Module toggle now updates navigation in real-time
- Fixed toggle_module API to return success response (was returning error)
- Navigation cache flushes and rebuilds when module toggled
- Newsletter menu appears/disappears immediately after toggle
3. Coupon routes now activate Marketing menu (not Dashboard)
- Added special case in useActiveSection for /coupons paths
- Marketing menu stays active when viewing coupons
- Submenu shows correct Marketing items (Newsletter, Coupons)
4. Dashboard menu no longer always shows active
- Fixed by proper path matching in useActiveSection
- Only active when on dashboard routes
Files Modified (4):
- includes/Compat/NavigationRegistry.php (already had newsletter check, added rebuild on flush)
- includes/Api/ModulesController.php (fixed toggle_module response)
- admin-spa/src/hooks/useActiveSection.ts (added /coupons special case)
- admin-spa/dist/app.js (rebuilt)
All 4 navigation issues resolved!
- Fix: Marketing events now display in Staff notifications tab
- Reorganize: Move Coupons to Marketing/Coupons for better organization
- Add: Comprehensive email/phone validation with extensible filter hooks
- Email validation with regex pattern (xxxx@xxxx.xx)
- Phone validation with WhatsApp verification support
- Filter hooks for external API integration (QuickEmailVerification, etc.)
- Fix: Newsletter template routes now use centralized notification email builder
- Add: Validation.php class for reusable validation logic
- Add: VALIDATION_HOOKS.md documentation with integration examples
- Add: NEWSLETTER_CAMPAIGN_PLAN.md architecture for future campaign system
- Fix: API delete method call in Newsletter.tsx (delete -> del)
- Remove: Duplicate EmailTemplates.tsx (using notification system instead)
- Update: Newsletter controller to use centralized Validation class
Breaking changes:
- Coupons routes moved from /routes/Coupons to /routes/Marketing/Coupons
- Legacy /coupons routes maintained for backward compatibility
- Add WishlistController with full CRUD API
- Create wishlist page in My Account
- Add heart icon to all product card layouts (always visible)
- Implement useWishlist hook for state management
- Add wishlist toggle in admin Settings > Customer
- Fix wishlist menu visibility based on admin settings
- Fix double navigation in wishlist page
- Fix variable product navigation to use React Router
- Add TypeScript type casting fix for addresses
- Add AddressController with full CRUD API for saved addresses
- Implement address management UI in My Account > Addresses
- Add modal-based address selector in checkout (Tokopedia-style)
- Hide checkout forms when saved address is selected
- Add search functionality in address modal
- Auto-select default addresses on page load
- Fix variable products to show 'Select Options' instead of 'Add to Cart'
- Add admin toggle for multiple addresses feature
- Clean up debug logs and fix TypeScript errors
- Created LayoutWrapper component to conditionally render header/footer based on route
- Created MinimalHeader component (logo only)
- Created MinimalFooter component (trust badges + policy links)
- Created usePageVisibility hook to get visibility settings per page
- Wrapped ClassicLayout with LayoutWrapper for conditional rendering
- Header/footer visibility now controlled directly in React SPA
- Settings: show/minimal/hide for both header and footer
- Background color support for checkout and thankyou pages
Fixed 2 critical issues:
1. ✅ Orders Not Loading:
Backend (OrdersController.php):
- Added customer_id parameter support
- Lines 300-304: Filter orders by customer
- Uses WooCommerce customer_id arg
Frontend (Detail.tsx):
- Already passing customer_id correctly
- Orders will now load properly
2. ✅ Added Tabs for Better Organization:
Implemented 3-tab layout:
**Overview Tab:**
- Stats cards: Total Orders, Total Spent, Registered
- Contact information (email, phone)
- Clean, focused view
**Orders Tab:**
- Full order history (not just 10)
- Order count display
- Better empty state
- All orders clickable to detail
**Address Tab:**
- Billing address (full details)
- Shipping address (full details)
- Company names if available
- Phone in billing section
- Empty states for missing addresses
Benefits:
✅ Clean, organized, contextual data per tab
✅ No information overload
✅ Easy navigation between sections
✅ Better mobile experience
✅ Consistent with modern admin UX
Technical:
- Uses shadcn/ui Tabs component
- Responsive grid layouts
- Proper empty states
- Type-safe with TypeScript
Result: Customer detail page is now properly organized with working order history!
Fixed all 6 issues in Customer index:
1. ✅ Search Input - Match Coupon Module:
- Mobile: Native input with proper styling
- Desktop: Native input with proper styling
- Consistent with Coupon module pattern
- Better focus states and padding
2. ✅ Filter - Not Needed:
- Customer data is simple (name, email, stats)
- Search is sufficient for finding customers
- No complex filtering like products/coupons
3. ✅ Stats Display - FIXED:
- Backend: Changed format_customer() to include stats (detailed=true)
- Now shows actual order count and total spent
- No more zero orders or dashed values
4. ✅ Member/Guest Column - Added:
- New 'Type' column in table
- Shows badge: Member (blue) or Guest (gray)
- Based on customer.role field
5. ✅ Actions Column - Added:
- New 'Actions' column with Edit button
- Edit icon + text link
- Navigates to /customers/:id/edit
6. ✅ Navigation - Fixed:
- Name click → Detail page (/customers/:id)
- Edit button → Edit page (/customers/:id/edit)
- Mobile cards also link to detail page
- Separation of concerns: view vs edit
Changes Made:
Backend (CustomersController.php):
- Line 96: format_customer(, true) to include stats
Frontend (Customers/index.tsx):
- Search inputs: Match Coupon module styling
- Table: Added Type and Actions columns
- Type badge: Member (blue) / Guest (gray)
- Actions: Edit button with icon
- Navigation: Name → detail, Edit → edit
- Mobile cards: Link to detail page
Table Structure:
- Checkbox | Customer | Email | Type | Orders | Total Spent | Registered | Actions
- 8 columns total (was 6)
Next: Create customer detail page with related orders and stats
Fixed root cause of 'Indonesia' in billing_phone - was fallback to country value
Issue:
❌ billing_phone showing 'Indonesia' instead of phone number
❌ Weak validation: ! empty() allows any non-empty string
❌ No sanitization - direct assignment of raw values
❌ Inconsistent validation between order and customer updates
Root Cause:
- OrdersController used ! empty() check
- Allowed 'Indonesia' (country) to be saved as phone
- No sanitization or format validation
- Applied to ALL fields, not just phone
Changes Made:
1. Created Sanitization Helpers (Lines 9-58):
✅ sanitize_field() - Trims, validates text fields
✅ sanitize_phone() - Removes non-numeric except +, -, spaces
✅ sanitize_email_field() - Validates email format
✅ Returns empty string if invalid (prevents bad data)
2. Fixed Order Billing/Shipping (Lines 645-673, 909-940):
✅ Update method: Sanitize all order address fields
✅ Create method: Sanitize all order address fields
✅ Applied to: first_name, last_name, email, phone, address_1, address_2, city, state, postcode, country
3. Fixed Customer Data - Existing Member (Lines 1089-1132):
✅ Sanitize all billing fields before WC_Customer update
✅ Sanitize all shipping fields before WC_Customer update
✅ Only set if not empty (allow clearing fields)
✅ Prevents 'Indonesia' or invalid data from being saved
4. Fixed Customer Data - New Member (Lines 1161-1204):
✅ Sanitize all billing fields on customer creation
✅ Sanitize all shipping fields on customer creation
✅ Same validation as existing member
✅ Consistent data quality for all customers
Sanitization Logic:
Phone:
- Remove non-numeric except +, -, spaces
- Trim whitespace
- Return empty if only symbols
- Example: 'Indonesia' → '' (empty)
- Example: '08123456789' → '08123456789' ✅
Email:
- Use sanitize_email() + is_email()
- Return empty if invalid format
- Prevents malformed emails
Text Fields:
- Use sanitize_text_field()
- Trim whitespace
- Return empty if only whitespace
- Prevents injection attacks
Impact:
Before:
- 'Indonesia' saved as phone ❌
- Country name in phone field ❌
- No validation ❌
- Inconsistent data ❌
After:
- Invalid phone → empty string ✅
- All fields sanitized ✅
- Consistent validation ✅
- Clean customer data ✅
Applies To:
✅ Order creation (new orders)
✅ Order updates (edit orders)
✅ Customer data - existing members
✅ Customer data - new members (auto-register)
✅ All billing fields
✅ All shipping fields
Testing Required:
1. Create order with existing customer - verify phone sanitized
2. Create order with new customer - verify no 'Indonesia' in phone
3. Edit order - verify all fields sanitized
4. Virtual products - verify phone still works correctly
Result: No more 'Indonesia' or invalid data in customer fields!
Backend implementation for Customer module
Created CustomersController.php:
✅ GET /customers - List with pagination, search, role filter
✅ GET /customers/{id} - Get single customer with full details
✅ POST /customers - Create new customer with validation
✅ PUT /customers/{id} - Update customer data
✅ DELETE /customers/{id} - Delete customer (with safety checks)
✅ GET /customers/search - Autocomplete search
Features:
- Full WooCommerce integration (WC_Customer)
- Billing and shipping address management
- Order stats (total_orders, total_spent)
- Email uniqueness validation
- Username auto-generation from email
- Password generation if not provided
- Role-based permissions (list_users, create_users, etc.)
- Cannot delete current user (safety)
- Optional new account email notification
Data format:
- List: Basic customer info (id, name, email, registered)
- Detail: Full data including billing, shipping, stats
- Search: Minimal data for autocomplete (id, name, email)
Registered routes in Routes.php:
- Added CustomersController import
- Registered all customer endpoints
Next: Frontend API client and CRUD pages
Moved 'Register as site member' from order-level to site-level setting
Frontend Changes:
1. Customer Settings - Added new General section
- Auto-register customers as site members toggle
- Clear description of functionality
- Saved to backend via existing API
2. OrderForm - Removed checkbox
- Removed registerAsMember state
- Removed checkbox UI
- Removed register_as_member from payload
- Backend now uses site setting
Backend Changes:
1. CustomerSettingsProvider.php
- Added auto_register_members setting
- Default: false (no)
- Stored as woonoow_auto_register_members option
- Included in get_settings()
- Handled in update_settings()
2. OrdersController.php
- Removed register_as_member parameter
- Now reads from CustomerSettingsProvider
- Site-level setting applies to all orders
- Consistent behavior across all order creation
Benefits:
✅ Site-level control (not per-order)
✅ Consistent customer experience
✅ Easier to manage (one setting)
✅ No UI clutter in order form
✅ Setting persists across all orders
Migration:
- Old orders with checkbox: No impact
- New orders: Use site setting
- Default: Disabled (safe default)
Result:
Admins can now control customer registration site-wide from Customer Settings instead of per-order checkbox
**Issue:** Core had default allowed meta fields for specific addons
- OrdersController: _tracking_number, _tracking_provider, etc.
- ProductsController: _custom_field
**Problem:** This violates our core principle:
❌ WooNooW Core = Zero addon dependencies
❌ We do NOT support specific plugins in core
❌ We do NOT hardcode addon fields
**Solution:** Empty defaults, plugins register via filters
**Before:**
```php
$allowed = apply_filters('woonoow/order_allowed_private_meta', [
'_tracking_number', // ❌ Addon-specific
'_tracking_provider', // ❌ Addon-specific
], $order);
```
**After:**
```php
// Core has ZERO defaults - plugins register via filter
$allowed = apply_filters('woonoow/order_allowed_private_meta', [], $order);
```
**How Plugins Register:**
```php
// Shipment Tracking plugin (or any plugin)
add_filter('woonoow/order_allowed_private_meta', function($allowed) {
$allowed[] = '_tracking_number';
$allowed[] = '_tracking_provider';
return $allowed;
});
```
**Principle Maintained:**
✅ Core has ZERO addon dependencies
✅ Core does NOT know about specific plugins
✅ Plugins register themselves via standard WP filters
✅ Community does the integration, not core
**Changed:**
- OrdersController: Empty defaults for allowed/updatable meta
- ProductsController: Empty defaults for allowed/updatable meta
- Added comments: 'Core has ZERO defaults - plugins register via filter'
**Result:**
- Public meta (no underscore): Always exposed automatically
- Private meta (starts with _): Only if plugin registers via filter
- Clean separation: Core provides mechanism, plugins use it
**Implemented: Backend API Enhancement for Level 1 Compatibility**
Following IMPLEMENTATION_PLAN_META_COMPAT.md Phase 1
**OrdersController.php:**
✅ Added get_order_meta_data() - Expose meta in API responses
✅ Added update_order_meta_data() - Update meta from API
✅ Modified show() - Include meta in response
✅ Modified update() - Handle meta updates
✅ Added filter: woonoow/order_allowed_private_meta
✅ Added filter: woonoow/order_updatable_meta
✅ Added filter: woonoow/order_api_data
✅ Added action: woonoow/order_updated
**ProductsController.php:**
✅ Added get_product_meta_data() - Expose meta in API responses
✅ Added update_product_meta_data() - Update meta from API
✅ Modified format_product_full() - Include meta in response
✅ Modified update_product() - Handle meta updates
✅ Added filter: woonoow/product_allowed_private_meta
✅ Added filter: woonoow/product_updatable_meta
✅ Added filter: woonoow/product_api_data
✅ Added action: woonoow/product_updated
**Meta Filtering Logic:**
- Skip internal WooCommerce meta (_wc_*)
- Skip WooNooW internal meta (_woonoow_*)
- Public meta (no underscore) - always expose
- Private meta (starts with _) - check allowed list
- Plugins can add to allowed list via filters
**Default Allowed Meta (Orders):**
- _tracking_number
- _tracking_provider
- _tracking_url
- _shipment_tracking_items
- _wc_shipment_tracking_items
- _transaction_id
- _payment_method_title
**How It Works:**
1. Plugin stores: update_post_meta($order_id, '_tracking_number', '123')
2. WooNooW API exposes: GET /orders/123 returns meta._tracking_number
3. Frontend can read/write via API
4. Plugin works WITHOUT any extra effort
**Next Steps:**
- Phase 2: Frontend components (MetaFields, useMetaFields)
- Phase 3: PHP MetaFieldsRegistry system
- Testing with popular plugins
**Status:** Backend API ready for Level 1 compatibility! 🎉
**Issue 1: Empty Color Values in /products/search**
- Problem: Variation attributes still showing empty (Color: "")
- Cause: OrdersController using get_variation_attributes() incorrectly
- Root: Same issue we had with ProductsController last night
**Solution:**
- Match ProductsController implementation exactly
- Get parent product attributes first
- Handle taxonomy attributes (pa_*) vs custom attributes
- For taxonomy: Convert slug to term name
- For custom: Get from post meta (attribute_AttributeName)
**Changes to OrdersController.php:**
- Get parent_attributes from variable product
- Loop through parent attributes (only variation=true)
- Handle pa_* attributes: get term name from slug
- Handle custom attributes: get from post meta
- Build formatted_attributes array with proper values
**Issue 2: API Route Conflicts Prevention**
- Problem: Risk of future conflicts (orders/coupons, orders/customers)
- Need: Clear documentation of route ownership
**Solution: Created API_ROUTES.md**
**Route Registry:**
**Conflict Prevention Rules:**
1. Each resource has ONE primary controller
2. Cross-resource operations use specific action routes
3. Use sub-resources for related data (/orders/{id}/coupons)
4. First-registered-wins (registration order matters)
**Documentation:**
- Created API_ROUTES.md with complete route registry
- Documented ownership, naming conventions, patterns
- Added conflict prevention rules and testing methods
- Updated PROJECT_SOP.md to reference API_ROUTES.md
- Added to Documentation Standards section
**Result:**
✅ Variation attributes now display correctly (Color: Red)
✅ Clear API route ownership documented
✅ Future conflicts prevented with standards
✅ Ready for Coupons and Customers CRUD implementation
**Testing:**
- Test /products/search returns proper Color values
- Verify no route conflicts in REST API
- Confirm OrderForm displays variations correctly
Following PROJECT_SOP.md section 5.7 - Variable Product Handling:
**Backend (OrdersController.php):**
- Updated /products/search endpoint to return:
- Product type (simple/variable)
- Variations array with attributes, prices, stock
- Formatted attribute names (Color, Size, etc.)
**Frontend (OrderForm.tsx):**
- Updated ProductSearchItem type to include variations
- Updated LineItem type to support variation_id and variation_name
- Added variation selector drawer (mobile + desktop)
- Each variation = separate cart item row
- Display variation name below product name
- Fixed remove button to work with variations (by index)
**UX Pattern:**
1. Search product → If variable, show variation drawer
2. Select variation → Add as separate line item
3. Can add same product with different variations
4. Each variation shown clearly: 'Product Name' + 'Color: Red'
**Result:**
✅ Tokopedia/Shopee pattern implemented
✅ No auto-selection of first variation
✅ Each variation is independent cart item
✅ Works on mobile and desktop
**Next:** Fix PageHeader max-w-5xl to only apply on settings pages
Found the issue from debug log:
- WooCommerce stores as: attribute_Color (exact case match)
- We were trying: attribute_color (lowercase) ❌
Fixed:
- Use 'attribute_' + exact attribute name
- get_post_meta with true flag returns single value (not array)
Result:
- Variation #362: {"Color": "Red"} ✅
- Variation #363: {"Color": "Blue"} ✅
Removed debug logging as requested.
Added logging to see ALL meta keys and values for variations.
This will show us exactly how WooCommerce stores the attribute values.
Check debug.log for:
Variation #362 ALL META: Array(...)
This will reveal the actual meta key format.
