Description
Ersaal SMS Gateway allows WordPress administrators to send SMS messages directly from the WordPress admin dashboard, verify Libyan mobile phone numbers with secure One-Time Passwords (OTP), and automatically notify WooCommerce customers about their order statuses using the robust Ersaal API.
Key Features
- Native Admin Dashboard: Monitor live delivery statuses, cost estimations, and daily messaging volume.
- Manual SMS: Send individual or targeted SMS messages with real-time GSM-7 and Unicode part estimations.
- WooCommerce Automated Notifications: Automatically send customized SMS alerts on Order Pending, Processing, Completed, and Cancelled events.
- One-Time Password (OTP) Verification: Optional phone verification for user profiles and Two-Factor Authentication (2FA) for WordPress logins.
- Libyan Telecom Network Validation: Native normalization and validation for Almadar (091, 093) and Libyana (092, 094) mobile networks.
- Comprehensive Logs & Privacy: Detailed local logging with sensitive number masking, carrier telemetry, and CSV export.
- Fully Localized: Complete Arabic and English native interfaces with full RTL and LTR support.
Third-Party Services
This plugin connects to the external Ersaal SMS Gateway API to send SMS notifications, estimate message parts, and verify mobile phone numbers via One-Time Passwords (OTP).
- Service Provider: Ersaal SMS Gateway
- Website: https://getersaal.com/
- Data Transmitted: Recipient mobile phone numbers, sender IDs, and notification message contents. No user passwords or WordPress administrative credentials are transmitted to the service.
Requirements
- WordPress 6.0 or higher
- PHP 8.1 or higher (PHP 8.2+ recommended)
- PHP
curl,json, andopensslextensions - PHP
mbstringextension recommended for optimal multibyte Arabic character handling (safe fallbacks are included)
Screenshots





Installation
- Upload the
ersaalfolder to the/wp-content/plugins/directory, or install directly through the WordPress Plugins screen. - Activate the plugin through the ‘Plugins’ screen in WordPress.
- Navigate to Ersaal SMS -> Settings to configure your API URL and Token.
- Test the API connection to confirm project readiness.
FAQ
-
Do I need an Ersaal account?
-
Yes. You need an active account and API Bearer Token from Ersaal.
-
Which Libyan telecom networks are supported?
-
The plugin natively validates and normalizes Libyan mobile numbers for Almadar Aljaded (091, 093) and Libyana Mobile Phone (092, 094).
-
How does WooCommerce order notification work?
-
Under Ersaal SMS -> WooCommerce, enable notifications and customize templates using dynamic tags like
{customer_name},{order_number}, and{order_total}. -
Is OTP verification mandatory?
-
No. OTP features and Login Two-Factor Authentication (2FA) are opt-in and disabled by default.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Ersaal SMS Gateway” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Ersaal SMS Gateway” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.3.1
- Resolved security, stability, compatibility, and build issues (#23-#32).
- Hardened HTTP/HTTPS connection validation and API error handling.
- Enhanced UTF-8 multibyte string handling for Arabic SMS content (Str::substr, Str::length, Str::limit).
- Improved WooCommerce order SMS status transitions and carrier validation.
- Refined admin views with strict typing and WordPress standard compliance.
1.3.0
- Added automatic log retention and scheduled daily cleanup via WP-Cron with customizable retention window (#17).
- Flattened repository structure to support direct WordPress installation and clean git workflows (#13).
- Refactored dependency injection for LogRepository and Client across WooCommerce and Manual Send modules (#14, #15).
- Corrected message cost calculation, display, and currency handling for wallet (LYD) and subscription parts (#10).
- Hardened OTP Login Two-Factor Authentication flow against invalid challenge execution escape (#16).
- Enhanced Advanced Settings UI with native design tokens and comprehensive Arabic/English translations.
1.2.0
- Full WordPress.org plugin directory compliance.
- Hardened database queries with prepared statements.
- Enhanced RTL styling and responsive design.
- Added official GPLv2 licensing and clean distribution packaging.
1.1.0
- Added OTP initiate and verify service.
- Added optional WordPress user profile phone verification and Login 2FA.
- Added runtime migration for dedicated OTP activity logs.
1.0.0
- Initial release with Manual Send, WooCommerce notifications, and local activity logging.
