davidbwire/instant-ussd-app

Sample application using InstantUssd library

InstantUssd App

This project recommends a file structure for incorporating bitmarshals/instant-ussd USSD library to your project.

It also provides the quickest way to boot up a fully functional USSD application within 3 minutes or less.

Goals

• Speed up USSD development
• Ease maintenance of USSD code

Features

• Minimal coding (provide USSD menus as config)
• Automatic screen to screen navigation
• Out of the box validation of user inputs
• Ready solutions for complex USSD flows involving going back and forth, optional screens, looping set of screens, jumping from screen to screen and resuming timed-out USSD sessions

Requirements

PHP >=5.6

bitmarshals/instant-ussd:0.1.*

Installation

Via Composer

Run

$ composer create-project davidbwire/instant-ussd-app

Configure database tables and connection (see below)

Configuration

Import instant ussd tables from database.sql file and then add database connection params to the config file.

Finally, map incoming USSD requests to http://your_domain_or_ip/callback.php

Documentation

1. How It Works
2. Configuration
3. Capturing Incoming Data

License

InstantUssd App is open-sourced software licensed under the MIT license.

instant-ussd-app's Issues

Custom menu leads to error

Hello,

I keep getting this error , I have customizing the app

I have observed the different in dump result from your app to mine, What is the problem is EventManager listener in showhomepage() does not return instance of Response

This is the response from event manager listeneresult

This is my menus option

Resume timed-out USSD sessions

Kindly I habe an issue with my sessions to time out mostly, can you share trick how to resumetimed-out USSD sessions? I have a session where user input full names and address.
Secondary it seems the script too longtime to respond sometimes,I do not know wether is my hosting issue or script itself or internet connection!
Regards

How to validate number only

I want to know more about validation code, how can I custom more validation
e.g I want to validate for phonenumber, email etc only as input
Regards

Custom Selector Number

Hi How do i create custom selector numbers for my list of items for the client to choose for example by default when you create menu items, it goes in the proper number sequence like so

Choose an item:
1. check stock 
2. select currency 
3. Add more currency 

and from above options the user selects his desired option BUT WHAT IF
i want to customize the selector number like below

Choose an item:
1. check stock 
22. select currency 
23. Add more currency 

Using this your beautiful library how do i make it happen.
Thanks in advance

Column 'session_id' cannot be null

Hello,

Please help me to resolve this, I tried to run the application after set up the database and he configuration file. Unfortunately when run it I get the above error. Is there any setting I have to make before testing the application.

Am running on php 7.2 in windows environment

commands chaining

Hello,

Does library supports method chaining. Can clients enter such configuration *{USSD_NUMBER}*1*1*{mobile_number}*{PIN}# ?

Ability to return conditional menus

I like this tool that you have created, very helpful.

Is it possible to incorporate a conditional USSD menu? One whose values change based on a previous selection?

END screen

How can I configure the END screen (I mean final screen where no input is provided) last session.

How to disable Go Back, Main Menu and Exit on my custom screen?

How can I play sound on session submit?

How are brother?
Is there any way to play sound (mp3) as notification on any session submit?
Regards

Save and retrieve data to/from mysql database

I appreciate your good work brother.
Kindly I am lost, can you help me with example how to collect user input to database and able to print back in response after some processing , example how to view commission after sales of some products(@Product with unit price and quantity)
Thanks

How to attach logger ?

Hello,
I'm trying to make test application. Can you show how to attach logger to it