WooCommerce SMS Notifications

Documentation for the Plug and Pay WooCommerce SMS Notifications plugin.

• PHP: 7.4, 8.1, 8.2, or 8.3
• ionCube Loader: Required. For version requirements and installation details, check the IonCube Loader documentation.
• WooCommerce: 3.0.0 or higher

• SMS Provider Account: You must have an active account with a supported SMS provider (e.g., SMS Office, Sender.ge).

The plugin supports two types of notifications: those sent to the store administrator (Admin) and those sent directly to the customer (User).

Navigate to WooCommerce > Settings > SMS to configure the plugin.

1. Enable/Disable: Toggle the overall SMS notification system.
2. Provider: Select your preferred SMS provider.
3. API key: Enter the API key or token provided by your SMS service.
4. Debug Log: Enable this to log SMS events under WooCommerce > Status > Logs.

The plugin includes several utility features to improve the user experience and message deliverability.

Under the Extras section in settings, you can enable JS phone masking. When enabled, the billing phone field on the checkout and registration pages will automatically format inputs for Georgian numbers (for example, +995577123456). For Georgian billing addresses, checkout validation requires the E.164 format +995XXXXXXXXX.

You can enable a Phone field on the standard WooCommerce registration form. This allows you to collect customer phone numbers at the point of account creation, rather than waiting until their first checkout.

Since SMS messages have character limits, long URLs (like those for viewing an order) can be problematic. You can provide a Cutt.ly API key in the plugin settings to automatically shorten the {order_url} placeholder into a compact cutt.ly link.

This is the most flexible part of the plugin. Unlike fixed notifications, you can create multiple rules for status transitions.

You can define rules that trigger an SMS when an order moves from one status to another. For example:

• Rule 1: From Pending to Processing -> "Thank you! We received your order #{order_number}."
• Rule 2: From Processing to Completed -> "Your order #{order_number} is ready!"

For each rule, you can restrict the notification based on:

• Payment Gateway: Only send the SMS if the customer used a specific payment method (e.g., Bank of Georgia).
• Shipping Method: Only send if they chose a specific delivery zone or method (e.g., Wolt).

This allows you to provide highly relevant information (like specific pickup instructions or delivery links) only to the customers who need it.

You can use variables in your SMS messages to personalize them.

Universal Placeholders:

• {site_title} - Your website name.
• {order_date} - The date the order was created.
• {order_number} - The WooCommerce order number.

Customer Specific Placeholders (for order status changes):

• {billing_first_name} - Customer's first name.
• {billing_last_name} - Customer's last name.
• {billing_phone} - Customer's phone number.
• {billing_email} - Customer's email address.
• {order_url} - A shortened link to view the order.
• {shipping_address} - The formatted shipping address.

Other notification types have their own placeholders in the notification settings. For example, admin order notifications include {order_billing_full_name}, and customer note notifications include {customer_note}.

If SMS notifications are not being sent:

1. Check your SMS Balance on the provider's dashboard.
2. Verify that the API Key is correct in the plugin settings.
3. Enable Logging in WooCommerce > Status > Logs to see errors from the SMS provider.