PHPackages                             sarhanm/sms-survey - 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. sarhanm/sms-survey

ActiveLibrary

sarhanm/sms-survey
==================

SMS Driven Survey - PHP

v1.0.5(11y ago)5222PHPPHP >=5.4.0

Since Apr 15Pushed 11y ago2 watchersCompare

[ Source](https://github.com/sarhanm/sms-survey)[ Packagist](https://packagist.org/packages/sarhanm/sms-survey)[ Docs](http://www.TODO.com)[ RSS](/packages/sarhanm-sms-survey/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependencies (5)Versions (7)Used By (0)

[![Build Status](https://camo.githubusercontent.com/d5cbee27e350f1d154d8b25173ef433e39f3c61f59c8a83a1fab5927ce622156/68747470733a2f2f7472617669732d63692e6f72672f73617268616e6d2f736d732d7375727665792e706e67)](https://travis-ci.org/sarhanm/sms-survey)

SMS Survey Manager
==================

[](#sms-survey-manager)

About this Library
------------------

[](#about-this-library)

Twilio is a text messaging service which allows you to interact with your users/clients/community via text messages. No need for smart phones or building apps.

This library uses twilio to conduct surveys. This project was born out of a need for non-profit groups to survey their communities for feed back (mostly after an event/class/seminars) without paying lots and lots of money. Twilio.org offers a discounted rate for 501(c)3 organizations, which makes it ideal.

\##Screenshots

Adding a survey

[![Add a survey](https://raw.githubusercontent.com/sarhanm/sms-survey/master/docs/create_new_survey.png)](https://raw.githubusercontent.com/sarhanm/sms-survey/master/docs/create_new_survey.png)

List of active and disabled surveys:

[![survey list](https://raw.githubusercontent.com/sarhanm/sms-survey/master/docs/survey_list.png)](https://raw.githubusercontent.com/sarhanm/sms-survey/master/docs/survey_list.png)

Adding a question to a survey

[![Adding Questions](https://raw.githubusercontent.com/sarhanm/sms-survey/master/docs/add_question.png)](https://raw.githubusercontent.com/sarhanm/sms-survey/master/docs/add_question.png)

Survey Report (Text was all sample text)

[![Survey Report](https://raw.githubusercontent.com/sarhanm/sms-survey/master/docs/survey_report.png)](https://raw.githubusercontent.com/sarhanm/sms-survey/master/docs/survey_report.png)

Features
--------

[](#features)

### Manage Survey

[](#manage-survey)

You can create as many surveys as you want, all running at the same time. Surveys can be created via the admin interface. The admin interface also gives you pie and bar charts of your survey answers to easily digest the results.

### Survey Questions

[](#survey-questions)

Survey questions can be of the following types

1. Text
2. Yes/No
3. 5 start rating.

You can have as many questions as you want per survey. Although you should minimize questions to 2 or 3.

### Starting a Survey

[](#starting-a-survey)

Surveys are activated by texting the survey name to your assigned twilio phone number. The user than has 10 minutes to complete the survey.

\#Installation

### Install via Composer

[](#install-via-composer)

```
    "require": {
        "sarhanm/sms-survey": "1.0.2"
    }
```

### Install Manually

[](#install-manually)

1. Clone this repo.
2. Run composer to install all dependencies

```
php composer.phar install
```

Note: You can download composer.phar from

#### Test Manual Setup

[](#test-manual-setup)

```
php vendor/bin/phpunit tests/
```

NOTE: By default, this does not test your database setup as the tests are run against a in-memory database. If you would like to test against a real database, just change the `$test` in `survey-db-config.php` to reference your database.

Database Configuration
======================

[](#database-configuration)

#### 1. Create a file named "survey-db-config.php"

[](#1-create-a-file-named-survey-db-configphp)

File should contain the following:

```