Metadata-Version: 2.1
Name: django-universal-sms
Version: 1.0.6
Summary: Send SMS using Django
Home-page: https://github.com/hizbul25/django-send-sms
Author: Hizbul Bahar
Author-email: hizbul.ku@gmail.com
Maintainer: Hizbul Bahar
Maintainer-email: hizbul.ku@gmail.com
License: MIT
Keywords: SMS,SEND SMS,Universal SMS,Django SMS
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Framework :: Django
Classifier: Framework :: Django :: 3.2
Classifier: Framework :: Django :: 4.0
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: Django>=2.2
Requires-Dist: requests>=2.2.0

## django-universal-sms

Send SMS from Django application using any SMS service provider just writing a single line of code.

## Features

- Support all standard SMS service provider
- SMS configuration from django admin panel
- There is SMS Log listing page
- You can also test SMS sending from admin panel
- Enough test coverage

## Installation

### pip

```bash
pip install django-universal-sms
```

## Install apps in `settings.py`

```python
INSTALLED_APPS = [
    'django.contrib.admin',
    '...',
    'send_sms',
]
```

### migration

```bash
python manage.py migrate
```

## Configuration

- Go to admin panel by login with you admin credentials
- Find out **SMS Settings** menu under **SEND SMS** and click on it.
- There you'll see couple of fields to fill it up using SMS service provider credentials.
  ![Here is the example](/media/SMS_Settings.png).
- Carfefully compelete this part and save it.

## Usage

Whenever you need to send SMS just use following code:

```bash
from send_sms.views import send_sms

send_sms(['mobile_number'], 'Your Message')
```

For each successful sending SMS you can see the log from **SMS Log** under under **SEND SMS** menu.

## Support

Feel free to ask for the support over the email hizbul.ku[at]gmail.com.
