Skip to content

WooCommerce SMS Notifications

Documentation for the Plug and Pay WooCommerce SMS Notifications plugin.

Requirements

Technical Requirements

  • 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: 5.0 or higher

Service Prerequisites

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

Supported Providers

ProviderStatusWebsite
SMS Office✅smsoffice.ge
Sender.ge✅sender.ge

Notification Types

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

NotificationRecipientTrigger
New OrderAdminSent when a new order is received.
Cancelled OrderAdminSent when an order is cancelled.
Failed OrderAdminSent when a payment fails.
Customer NoteUserSent when an admin adds a note to the order.
New AccountUserSent when a user registers on the site.
Reset PasswordUserSent when a user requests a password reset.
Order StatusUserHighly flexible notifications based on status changes.

Configuration

General Settings

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 Credentials: Enter the API Key or Token provided by your SMS service.
  4. Sender ID: The name or number that will appear as the sender on the customer's phone.

Extra Features

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

Phone Number Masking

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 (e.g., +995 5XX XXX XXX). This helps ensure that phone numbers are always collected in the correct international format required by SMS providers.

Registration Phone Field

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.

Cutt.ly URL Shortening

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.

Order Status Notifications

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

Order Status SMS Notifications

How it works:

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!"

Dynamic Filtering:

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.

Using Placeholders

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.

Debugging

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.