WooCommerce WA Notifications

This Version is Only For Bangladesh Numbers Country Code 880

A WordPress plugin that integrates WA notifications with WooCommerce orders. This plugin allows store owners to automatically send WA messages to customers when their order status changes.

Features

1. Order Status Notifications

• Automatically sends WhatsApp messages when order status changes
• Supports all WooCommerce order statuses
• Customizable message templates for each status

2. Message Templates

• Customizable templates for each order status
• Rich set of placeholders for dynamic content
• Support for HTML formatting in messages

3. Available Placeholders

The following placeholders can be used in message templates:

Order Information

• {order_id} - Order ID
• {order_number} - Order number
• {order_status} - Current order status
• {order_date} - Order date
• {order_time} - Order time
• {order_total} - Total order amount
• {order_subtotal} - Order subtotal
• {order_tax} - Order tax amount
• {order_shipping} - Shipping cost
• {order_discount} - Discount amount

Customer Information

• {customer_name} - Full customer name
• {customer_first_name} - Customer's first name
• {customer_last_name} - Customer's last name
• {customer_email} - Customer's email
• {customer_phone} - Customer's phone number

Address Information

• {billing_address} - Complete billing address
• {billing_city} - Billing city
• {billing_state} - Billing state
• {billing_postcode} - Billing postcode
• {billing_country} - Billing country
• {shipping_address} - Complete shipping address
• {shipping_city} - Shipping city
• {shipping_state} - Shipping state
• {shipping_postcode} - Shipping postcode
• {shipping_country} - Shipping country

Shipping & Payment

• {shipping_method} - Selected shipping method
• {payment_method} - Payment method title

Product Information

• {product_names} - List of ordered products
• {product_quantities} - Quantities of ordered products

Tracking Information

• {tracking_number} - Order tracking number
• {tracking_url} - Order tracking URL

Store Information

• {shop_name} - Store name
• {shop_url} - Store URL
• {shop_email} - Store email

Additional Information

• {order_notes} - Customer-facing order notes

4. Phone Number Formatting

The plugin automatically formats phone numbers to ensure compatibility with the WhatsApp API:

• Removes all non-numeric characters
• Preserves leading '0'
• Adds '88' country code prefix if not present
• Validates final number length (13 digits: 88 + 0 + 10 digits)

5. HPOS Compatibility

• Fully compatible with WooCommerce High-Performance Order Storage (HPOS)
• Uses HPOS-compatible methods for order data retrieval

6. Error Handling

• Logs invalid phone number formats
• Logs API communication errors
• Graceful handling of failed message deliveries

Installation

1. Upload the plugin files to /wp-content/plugins/wc-whatsapp-notifications
2. Activate the plugin through the WordPress admin panel
3. Go to WooCommerce → WA Notifications to configure the plugin

Configuration

1. Enter your WhatsApp API credentials:

   • API Key
   • Instance ID

2. Configure message templates for each order status:

   • Navigate to WooCommerce → WhatsApp Notifications
   • Select the order status
   • Enter your message template using available placeholders
   • Save changes

Requirements

• WordPress 5.0 or higher
• WooCommerce 6.0 or higher
• PHP 7.4 or higher
• Active WhatsApp Business API account

Security

• All settings are stored securely in WordPress options table
• API credentials are encrypted
• Input sanitization for all user inputs
• Output escaping for all displayed data

Support

For support, please contact the plugin developer or create an issue in the plugin's repository.

License

This plugin is licensed under the GPL v2 or later.

Credits

Developed by [Tanvir Ahmed/Total Active Sports]