WP Manifestindependent plugin directory
manifest / ecommerce / nigeria-bulk-sms-woocommerce

Nigeria Bulk SMS for WooCommerce

A WordPress plugin that integrates Nigeria Bulk SMS service with WooCommerce to send SMS notifications to customers and users.

by Chidera Progress Nwaokwa · github.com/gresstechs/nigeria-bulk-sms-woocommerce · website

★ 1stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/gresstechs/nigeria-bulk-sms-woocommerce/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/gresstechs/nigeria-bulk-sms-woocommerce ↗

A WordPress plugin that integrates Nigeria Bulk SMS service with WooCommerce to send SMS notifications to customers and users.

🚀 Features

  • 📱 Welcome SMS: Automatically send SMS to new user registrations
  • 🛒 WooCommerce Integration: SMS notifications for WooCommerce customers
  • 📊 SMS Statistics: Track sent/failed SMS with detailed logs
  • 💰 Balance Monitoring: Check your SMS account balance in real-time
  • 📤 Bulk SMS: Send messages to all registered users
  • 🧪 Test Mode: Safe testing without sending actual SMS
  • 🔧 Debug Logging: Detailed logging for troubleshooting
  • 📋 Shortcodes: Frontend integration with shortcodes

📋 Requirements

  • WordPress 5.0 or higher
  • WooCommerce 3.0 or higher (optional but recommended)
  • PHP 7.4 or higher
  • Nigeria Bulk SMS account credentials

📦 Installation

  1. Download the plugin files
  2. Upload to your WordPress /wp-content/plugins/ directory
  3. Activate the plugin through the WordPress admin panel
  4. Go to Settings > Nigeria Bulk SMS to configure

⚙️ Configuration

API Setup

  1. Sign up for a Nigeria Bulk SMS account
  2. Get your API credentials (username and password)
  3. Enter your credentials in the plugin settings
  4. Test the configuration using the built-in test SMS feature

Settings Options

  • API Username: Your Nigeria Bulk SMS username
  • API Password: Your Nigeria Bulk SMS password
  • API URL: Default is https://portal.nigeriabulksms.com/api/
  • Sender Name: Your SMS sender name (max 11 characters)
  • Welcome Message: Template for new user SMS
  • Phone Field: Meta field name for user phone numbers
  • Test Mode: Enable for safe testing
  • Debug Mode: Enable detailed logging

Available Placeholders

You can use these placeholders in your SMS message templates:

Placeholder What It Shows Example
{username} Display name or username "John Doe"
{first_name} First name "John"
{user_login} Login username "johndoe"
{site_name} Your site name "FoodBoox"
{role} Customer or Vendor "Customer" or "Vendor"
{user_email} Email address "john@example.com"

Example SMS Template:

Welcome {first_name}! Thank you for joining {site_name}. Your account {user_login} is now active.

📝 Shortcodes

Phone Field Shortcode

Display a phone number input field anywhere on your site:

[sms_phone_field]
[sms_phone_field label="Your Phone" required="true"]
[sms_phone_field placeholder="2348012345678" class="my-phone-field"]

User Phone Display

Show the current user's phone number:

[sms_user_phone]
[sms_user_phone format="display"]
[sms_user_phone format="edit"]

SMS Statistics (Admin Only)

Display SMS usage statistics:

[sms_stats]

🔌 API Integration

This plugin uses the official Nigeria Bulk SMS API:

Send SMS

GET https://portal.nigeriabulksms.com/api/?username=user&password=pass&message=text&sender=name&mobiles=2348012345678

Check Balance

GET https://portal.nigeriabulksms.com/api/?username=user&password=pass&action=balance

Response Formats

  • Success: {"status":"OK","count":1,"price":8}
  • Error: {"error":"Login denied.","errno":"103"}

📱 Phone Number Formats

The plugin automatically formats Nigerian phone numbers:

  • 08012345678 → 2348012345678
  • +2348012345678 → 2348012345678
  • 2348012345678 → 2348012345678 (already correct)

🔧 Development

Debug Mode

Enable debug mode to see detailed API requests and responses:

  1. Enable WP_DEBUG and WP_DEBUG_LOG in wp-config.php
  2. Check debug mode in plugin settings
  3. View logs in /wp-content/debug.log

📊 Changelog

Version 1.5 (Current)

  • Renamed to "Nigeria Bulk SMS for WooCommerce"
  • Enhanced WooCommerce integration
  • Improved admin interface
  • Added shortcode system
  • Better error handling and logging

🆘 Support

For support and feature requests:

  • Create an issue on this GitHub repository
  • Check the WordPress debug log for error details
  • Ensure your Nigeria Bulk SMS account has sufficient balance

📄 License

This plugin is licensed under the GPL v2 or later.

👨‍💻 Credits

  • Author: Chidera Progress Nwaokwa
  • SMS Service: Nigeria Bulk SMS
  • Built for: WordPress & WooCommerce

☕ Support the Developer

If this plugin has been helpful to you, consider buying me a coffee! Your support helps maintain and improve this plugin.

PayPal: paypal.me/gresstech

Every contribution, no matter how small, is greatly appreciated! 🙏