Skip to content

boxlinknet/moodle-local_kwtsms

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

39 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

kwtSMS for Moodle

Moodle Plugin PHP License: GPL v3 GitHub issues GitHub release

Send SMS notifications to students and administrators via the kwtSMS gateway (kwtsms.com).

About kwtSMS

kwtSMS is a Kuwait-based SMS gateway providing reliable message delivery across the Middle East and internationally. Features include:

  • SMS delivery to 200+ countries
  • Transactional and promotional sender IDs
  • Real-time balance and delivery tracking
  • Arabic and English message support
  • REST/JSON API with client libraries for PHP, Python, JavaScript, and more

Sign up for a kwtSMS account to get your API credentials and start sending SMS from your Moodle site.

For more integrations, visit the kwtSMS Integrations page.

Features

  • Event-driven SMS: Automatic notifications for enrollment, unenrollment, grading, course completion, quiz submission, assignment submission, and new user registration
  • 7-tab admin interface: Dashboard, Settings, Gateway, Templates, Integrations, Logs, Help
  • Multilingual templates: English + Arabic with placeholder support ({firstname}, {coursename}, {grade}, etc.)
  • Gateway management: Login/logout, balance monitoring, sender ID selection, country code configuration
  • SMS logging: Full log with status tracking, phone masking, filtering, pagination, and CSV export
  • Daily sync: Automatic refresh of balance, sender IDs, and coverage data
  • RTL support: Right-to-left layout support for Arabic interfaces
  • Test mode: Send to API without delivery for development and testing

Requirements

Installation

  1. Download and extract to local/kwtsms/ in your Moodle directory
  2. Visit Site administration > Notifications to complete the installation
  3. Go to Site administration > Plugins > Local plugins > kwtSMS
  4. Open the Gateway tab and log in with your kwtSMS API credentials

Configuration

  1. Gateway tab: Enter your API username and password, click Login. Select your Sender ID and default country code.
  2. Settings tab: Enable the gateway, configure test mode, set admin phone numbers, and set the low balance alert threshold.
  3. Integrations tab: Enable the events you want to trigger SMS notifications.
  4. Templates tab: Customize the English and Arabic SMS message templates for each event.

Supported Events

Event Recipient Description
User Enrolled Student Sent when a user is enrolled in a course
User Unenrolled Student Sent when a user is removed from a course
Grade Posted Student Sent when a grade is published
Course Completed Student Sent when a user completes a course
Quiz Submitted Student Sent when a quiz attempt is submitted
Assignment Submitted Student Sent when an assignment file is uploaded
New User Registered Admin Sent to admin phones when a new user registers

Template Placeholders

Placeholder Available In Description
{firstname} All events User's first name
{lastname} All events User's last name
{coursename} Course events Course full name
{grade} Grade Posted The grade value
{activityname} Quiz/Assignment Activity name
{sitename} All events Moodle site name

Sender ID

KWT-SMS is a shared testing sender ID. For production use, register a private sender ID through your kwtSMS account:

  • Transactional: Required for OTP and alerts, bypasses DND filtering
  • Promotional: For announcements and marketing, subject to DND filtering

Support

License

This plugin is licensed under the GNU GPL v3 or later. See https://www.gnu.org/copyleft/gpl.html for details.

About

Moodle plugin for sending SMS notifications through the kwtSMS gateway (kwtsms.com). Automates messages for enrollment, grading, course completion, quiz and assignment submissions. Bilingual templates

Topics

Resources

Security policy

Stars

Watchers

Forks

Packages