dwindown/WooNooW
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
146 Commits 1 Branch 0 Tags
28bbce5434ef59191f1a076570f6072703053f67
Commit Graph

2 Commits

Author SHA1 Message Date
dwindown
28bbce5434 feat: Tax settings + Checkout fields - Full implementation 
## ✅ TAX SETTINGS - COMPLETE

### Backend (TaxController.php):
- ✅ GET /settings/tax - Get all tax settings
- ✅ POST /settings/tax/toggle - Enable/disable tax
- ✅ GET /settings/tax/suggested - Smart suggestions based on selling locations
- ✅ POST /settings/tax/rates - Create tax rate
- ✅ PUT /settings/tax/rates/{id} - Update tax rate
- ✅ DELETE /settings/tax/rates/{id} - Delete tax rate

**Predefined Rates:**
- Indonesia: 11% (PPN)
- Malaysia: 6% (SST)
- Singapore: 9% (GST)
- Thailand: 7% (VAT)
- Philippines: 12% (VAT)
- Vietnam: 10% (VAT)
- + Australia, NZ, UK, Germany, France, Italy, Spain, Canada

**Smart Detection:**
- Reads WooCommerce "Selling location(s)" setting
- If specific countries selected → Show those rates
- If sell to all → Show store base country rate
- Zero re-selection needed!

### Frontend (Tax.tsx):
- ✅ Toggle to enable/disable tax
- ✅ Suggested rates card (based on selling locations)
- ✅ Quick "Add Rate" button for suggested rates
- ✅ Tax rates list with Edit/Delete
- ✅ Add/Edit tax rate dialog
- ✅ Display settings (prices include tax, shop/cart display)
- ✅ Link to WooCommerce advanced settings

**User Flow:**
1. Enable tax toggle
2. See: "🇮🇩 Indonesia: 11% (PPN)" [Add Rate]
3. Click Add Rate
4. Done! Tax working.

## ✅ CHECKOUT FIELDS - COMPLETE

### Backend (CheckoutController.php):
- ✅ POST /checkout/fields - Get fields with all filters applied

**Features:**
- Listens to WooCommerce `woocommerce_checkout_fields` filter
- Respects addon hide/show logic:
  - Checks `hidden` class
  - Checks `enabled` flag
  - Checks `hide` class
- Respects digital-only products logic (hides shipping)
- Returns field metadata:
  - required, hidden, type, options, priority
  - Flags custom fields (from addons)
  - Includes validation rules

**How It Works:**
1. Addon adds field via filter
2. API applies all filters
3. Returns fields with metadata
4. Frontend renders dynamically

**Example:**
```php
// Indonesian Shipping Addon
add_filter('woocommerce_checkout_fields', function($fields) {
    $fields['shipping']['shipping_subdistrict'] = [
        'required' => true,
        'type' => 'select',
        'options' => get_subdistricts(),
    ];
    return $fields;
});
```

WooNooW automatically:
- Fetches field
- Sees required=true
- Renders it
- Validates it

## Benefits:

**Tax:**
- Zero learning curve (30 seconds setup)
- No re-selecting countries
- Smart suggestions
- Scales for single/multi-country

**Checkout Fields:**
- Addon responsibility (not hardcoded)
- Works with ANY addon
- Respects hide/show logic
- Preserves digital-only logic
- Future-proof

## Next: Frontend integration for checkout fields
 2025-11-10 12:23:44 +07:00
dwindown
603d94b73c feat: Tax settings + unified addon guide + Biteship spec 
## 1. Created BITESHIP_ADDON_SPEC.md ✅
- Complete plugin specification
- Database schema, API endpoints
- WooCommerce integration
- React components
- Implementation timeline

## 2. Merged Addon Documentation ✅
Created ADDON_DEVELOPMENT_GUIDE.md (single source of truth):
- Merged ADDON_INJECTION_GUIDE.md + ADDON_HOOK_SYSTEM.md
- Two addon types: Route Injection + Hook System
- Clear examples for each type
- Best practices and troubleshooting
- Deleted old documents

## 3. Tax Settings ✅
Frontend (admin-spa/src/routes/Settings/Tax.tsx):
- Enable/disable tax calculation toggle
- Display standard/reduced/zero tax rates
- Show tax options (prices include tax, based on, display)
- Link to WooCommerce for advanced config
- Clean, simple UI

Backend (includes/Api/TaxController.php):
- GET /settings/tax - Fetch tax settings
- POST /settings/tax/toggle - Enable/disable taxes
- Fetches rates from woocommerce_tax_rates table
- Clears WooCommerce cache on update

## 4. Advanced Local Pickup - TODO
Will be simple: Admin adds multiple pickup locations

## Key Decisions:
✅ Hook system = No hardcoding, zero coupling
✅ Tax settings = Simple toggle + view, advanced in WC
✅ Single addon guide = One source of truth

Next: Advanced Local Pickup locations
 2025-11-09 23:13:52 +07:00