Nigeria Bulk SMS for 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! 🙏