PHPackages                             lindemannrock/craft-sms-manager - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Mail & Notifications](/categories/mail)
4. /
5. lindemannrock/craft-sms-manager

ActiveCraft-plugin[Mail & Notifications](/categories/mail)

lindemannrock/craft-sms-manager
===============================

SMS gateway and management for Craft CMS with multi-provider support

5.10.2(1mo ago)0473proprietaryPHPPHP ^8.2CI passing

Since Jan 12Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/LindemannRock/craft-sms-manager)[ Packagist](https://packagist.org/packages/lindemannrock/craft-sms-manager)[ RSS](/packages/lindemannrock-craft-sms-manager/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (15)Versions (28)Used By (3)

SMS Manager for Craft CMS
=========================

[](#sms-manager-for-craft-cms)

[![Latest Version](https://camo.githubusercontent.com/cbc00d1bab02d5f3b548959828b89a52c35fa47464849b023cd6eca84cf117ad/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c696e64656d616e6e726f636b2f63726166742d736d732d6d616e616765722e737667)](https://packagist.org/packages/lindemannrock/craft-sms-manager)[![Craft CMS](https://camo.githubusercontent.com/21f96a88b167fb3d44f5353f9cd480b0311e4612eb2bef7725ecfc09a8b0b8d7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4372616674253230434d532d352e302532422d6f72616e67652e737667)](https://craftcms.com/)[![PHP](https://camo.githubusercontent.com/0f16581d1180dbfd4c0e13166ec1267d4ad2f2fab8281ea6d6b284cf5c65d921/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322532422d626c75652e737667)](https://php.net/)[![Logging Library](https://camo.githubusercontent.com/6f3321d27476dcc0d5ac1f9605d706f24b1d035a73871acbb599d376424d03a9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6f6767696e672532304c6962726172792d352e302532422d677265656e2e737667)](https://github.com/LindemannRock/craft-logging-library)[![License](https://camo.githubusercontent.com/7916c7754af702db6097cb605441d329e4ea84dee39b2a720183aa1bf222e439/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6c696e64656d616e6e726f636b2f63726166742d736d732d6d616e616765722e737667)](LICENSE)

SMS gateway and management plugin for Craft CMS 5.x with multi-provider support, analytics, and delivery tracking.

License
-------

[](#license)

This is a commercial plugin licensed under the [Craft License](https://craftcms.github.io/license/). It will be available on the [Craft Plugin Store](https://plugins.craftcms.com) soon. See [LICENSE.md](LICENSE.md) for details.

⚠️ Pre-Release
--------------

[](#️-pre-release)

This plugin is in active development and not yet available on the Craft Plugin Store. Features and APIs may change before the initial public release.

Features
--------

[](#features)

- **Multi-Provider Support**: Extensible provider system for different SMS gateways
    - **MPP-SMS**: Kuwait SMS provider with Arabic and English support
    - Extensible architecture for adding custom providers
- **Sender ID Management**: Configure multiple sender IDs per provider
    - Enable/disable sender IDs individually
    - Set default sender IDs per provider
    - Handle-based API access for templates
- **Multi-Language Support**: Native support for Arabic (UCS-2 encoding) and English messages
- **Comprehensive Analytics**:
    - Daily SMS statistics (sent, failed, pending)
    - Language breakdown (English, Arabic, other)
    - Provider and sender ID performance tracking
    - Source plugin tracking (know which plugin triggered each SMS)
    - Configurable retention period
- **Delivery Logs**:
    - Full message history with status tracking
    - Provider response logging
    - Error message capture
    - Export to CSV
    - Configurable retention and auto-cleanup
- **Dashboard**: Real-time overview of SMS activity and provider status
- **User Permissions**: Granular access control for providers, sender IDs, analytics, logs, and settings
- **Utilities**: Clear analytics and logs from Craft's utilities section
- **Logging**: Structured logging via Logging Library with configurable levels

Requirements
------------

[](#requirements)

- Craft CMS 5.0 or greater
- PHP 8.2 or greater
- [Logging Library](https://github.com/LindemannRock/craft-logging-library) 5.0 or greater (installed automatically as dependency)

Installation
------------

[](#installation)

### Via Composer

[](#via-composer)

```
cd /path/to/project
```

```
composer require lindemannrock/craft-sms-manager
```

```
./craft plugin/install sms-manager
```

### Using DDEV

[](#using-ddev)

```
cd /path/to/project
```

```
ddev composer require lindemannrock/craft-sms-manager
```

```
ddev craft plugin/install sms-manager
```

### Via Control Panel

[](#via-control-panel)

In the Control Panel, go to Settings → Plugins and click "Install" for SMS Manager.

Configuration
-------------

[](#configuration)

### Settings

[](#settings)

Navigate to **SMS Manager → Settings** in the control panel to configure:

**General Settings:**

- **Plugin Name**: Customize the display name in the control panel

**Default Provider Settings:**

- **Default Provider**: Provider to use when none specified
- **Default Sender ID**: Sender ID to use when none specified

**Analytics Settings:**

- **Enable Analytics**: Toggle analytics tracking
- **Analytics Limit**: Maximum records to retain
- **Analytics Retention**: Days to keep analytics (0 = forever)
- **Auto-Trim Analytics**: Automatically clean up old records

**Logs Settings:**

- **Enable Logs**: Toggle delivery logging
- **Logs Limit**: Maximum log records to retain
- **Logs Retention**: Days to keep logs (0 = forever)
- **Auto-Trim Logs**: Automatically clean up old records

**Interface Settings:**

- **Items Per Page**: Number of items in list views
- **Dashboard Refresh**: Auto-refresh interval in seconds

**Logging Library Settings:**

- **Log Level**: debug, info, warning, error

### Config File

[](#config-file)

Create a `config/sms-manager.php` file to override default settings and define providers/sender IDs:

```
cp vendor/lindemannrock/craft-sms-manager/src/config.php config/sms-manager.php
```

The config file supports multi-environment configuration with `*` for global settings and environment-specific overrides:

```