Odoo-Modules/fusion-woo-odoo/fusion-woodoo/CLAUDE.md

Fusion WooDoo — WordPress Plugin

What This Is

Thin WordPress/WooCommerce plugin that pairs with the fusion_woocommerce Odoo module. Receives data from Odoo, displays documents in the customer My Account portal, and fires webhooks to notify Odoo of WC events.

Architecture

• Receives from Odoo: REST endpoints accept order status, invoices, deliveries, messages
• Sends to Odoo: WooCommerce webhooks fire on order/product/customer events
• Displays to customers: My Account tabs for sales orders, invoices, deliveries, returns, order timeline

Key Files

fusion-woodoo.php              — Plugin entry, activation/deactivation hooks
includes/class-fusion-woodoo.php    — Singleton main class, loads all includes
includes/class-admin-settings.php   — WP admin settings (Odoo URL, API key, toggles)
includes/class-rest-endpoints.php   — REST API endpoints (receive from Odoo)
includes/class-webhooks.php         — WC webhook registration/lifecycle
includes/class-my-account.php       — My Account tab registration
includes/class-order-timeline.php   — Visual order status timeline
includes/class-returns.php          — Return/RMA request handling
includes/class-api-client.php       — PHP client for calling Odoo API
templates/my-account/               — Customer portal templates
assets/css/my-account.css           — Portal styles
assets/js/my-account.js             — Portal JS (AJAX, reorder, returns)

Authentication

• Odoo → WP plugin: Odoo API key as bearer token in Authorization header
• WP plugin → Odoo: Not direct — uses WC webhooks which Odoo validates via HMAC

PDF Storage

• Invoices: wp-content/uploads/fusion-woodoo/invoices/ (.htaccess protected)
• Deliveries: wp-content/uploads/fusion-woodoo/deliveries/ (.htaccess protected)
• Served via PHP handler that validates user owns the order

WordPress Options

• fusion_woodoo_odoo_url — Odoo instance URL
• fusion_woodoo_api_key — API key for Odoo auth
• fusion_woodoo_show_sales_orders — Toggle sales orders tab
• fusion_woodoo_show_invoices — Toggle invoices tab
• fusion_woodoo_show_deliveries — Toggle deliveries tab
• fusion_woodoo_show_returns — Toggle returns tab

WooCommerce Order Meta Keys

• _odoo_order_id, _odoo_invoice_id — Linked Odoo record IDs
• _odoo_invoice_pdf, _odoo_delivery_pdf — PDF file paths
• _odoo_tracking_number, _odoo_shipping_carrier — Shipping info
• _odoo_order_status — Status for timeline display
• _odoo_messages — JSON array of customer-visible messages

Deployment

# Deploy to westin WordPress
sshpass -p '9896924728Kk@@##' scp -r fusion-woo-odoo/fusion-woodoo/* westin@192.168.1.152:/tmp/fusion-woodoo/
sshpass -p '9896924728Kk@@##' ssh westin@192.168.1.152 "echo '9896924728Kk@@##' | sudo -S cp -r /tmp/fusion-woodoo/* /home/westinwp/htdocs/westinhealthcare.ca/wp-content/plugins/fusion-woodoo/"

Webhook Lifecycle

• Registered on plugin activation / settings save
• Unregistered on plugin deactivation
• Re-registered when Odoo URL changes
• Topics: order.created, order.updated, product.updated, customer.created, customer.updated

Requirements

• WordPress 6.0+
• WooCommerce 8.0+
• PHP 8.0+
• Odoo 19 with fusion_woocommerce module installed