WHAT IS “GEO-TEXTING”?
|
(def) “Geo-texting” – (verb) the act of inviting folks by way of textual content to share their location realtime with one another on a personal geomap…uberstyle. Anybody with a smartphone and might textual content to the geo-text telephone quantity can play dispatcher and invite folks to share a geomap. To arrange your individual geo-text your individual setting, you’ll must host this plug-in, my newest script PHP Uber-style Geotracking and Twilio’s SMS “texting” providers (www.twilio.com).
You’ll be able to strive it out NOW in my demo setting right here. Simply textual content instructions (beneath) to 415-360-0886 – Click on here or on “Stay Demo” hyperlink above to get the complete record of instructions. QUICK START EXAMPLE: textual content the command ‘list-maps’ to 415-360-0886 in your telephone now, it ought to say you don’t have any maps. Create a map and invite some folks to trace – textual content a comma or an area delimited record of telephone numbers or e mail addresses to 415-360-0886. These numbers and e mail addresses will obtain an e mail or textual content the place there’s a hyperlink than when clicked on utilizing a smartphone will likely be tracked in a personal geomap.) |
WHAT DOES THIS TWILIO “GEO-TEXT” PLUG-IN DO?
This geotext plug-in is an SMS textual content front-end (leveraging Twilio) to my authentic geolocation script – PHP Uber-style GeoTracking script.
This Twilio “Geo-text” plug-in is an add-on to my PHP Uber-style Geotracking script that enables anybody with entry to your Twilio telephone quantity to ask folks by way of textual content to share their location with others uber-style on a personal geomap. As well as the script options dispatcher performance not discovered within the authentic geotracking script. This performance consists of managing a number of geomaps, including/deleting geotrackees, renaming maps and geotrackees, pinging geotrackees to replace their location, all from a smartphone utilizing SMS texting.
The script is straightforward to put in – simply unzip contents – 1 file – into the <root>/php/sms folder of your authentic PHP Uber-style Geotracking instalation. This requires a Twilio account to ship and course of SMS texts. Configuration directions to hyperlink your Twilio telephone quantity to this plug-in seem beneath.
NOTE: THIS SCRIPT IS AN ADD-ON AND REQUIRES THE PURCHASE OF MY PHP UBER-STYLE GEOTRACKING SCRIPT. THIS ALSO REQUIRES SIGNING UP FOR A PAID TWILIO ACCOUNT.
This script consists of PHP code that CAN BE USED BY PHP DEVELOPERS AS A TEMPLATE for utilizing SMS TEXTING (utilizing Twilio) because the consumer interface for his or her software program/internet functions. For PHP builders who haven’t explored SMS texting as a consumer interface on your software program (as I’ve completed right here), it’s price exploring. Texting is one thing everybody is aware of do (younger, previous and in between) and cuts studying curve of utilizing your software program. (see “Overview of PHP Code” part beneath for the way code is structured).
QUICK DEMO/START
Utilizing the plug-in is as straightforward as texting an inventory of geotrackees to the script’s twilio telephone quantity (or for demo – 415-360-0886). Click on on “Stay Demo” hyperlink above for extra detailed directions.
- Set up script/plug-in. For demo, textual content to 415-360-0886.
- Merely “textual content” an area or comma separated record of geotrackee e mail addresses or sensible telephone numbers to ask to a personal geomap. The script will textual content you an invite hyperlink (it robotically consists of map proprietor as a geotrackee in each map. It would additionally textual content you affirmation which geotrackees have been invited and which of them didn’t (didn’t go validation).
- So as to add extra geotrackees, proceed to textual content emaill handle and telephone numbers to the plug-in telephone quantity in step 1.
OTHER DISPATCHER FEATURES
Right here is the record of all of the dispatcher options constructed into this script that may be executed by texting instructions to your Twilio telephone quantity in your smartphone.
- LIST ALL YOUR MAPS – Textual content “list-maps” or “lm” to the twilio quantity to get a numbered record of maps you personal.
- ADD A NEW MAP – Textual content “new-map” or “nm” to the twilio quantity
- SWITCH ACTIVE MAP – Textual content “switch-map” or “sm” after which the map quantity (from “list-maps” record) to the twilio quantity (e.g. “sm 3”)
- RENAME MAP – Give your map a friendlier title. Textual content “rename-map” or “rm”, adopted by the map quantity after which the pleasant title you need to give the map. (e.g. “rm 2 My Take a look at Map”)
- DELETING A MAP – Textual content “delete-map” or “dm” after which the map quantity you need to delete adopted by the map quantity you need to delete.
- ADDING A GEOTRACKEE – Textual content “add-geotrackee” or “ag” after which a comma or area separated record of geotrackee emails and telephone numbers. That is elective, you possibly can simply textual content new emails and telephone numbers. (e.g. “ag [email protected] [email protected] 4153333333”)
- LIST ALL GEOTRACKEES OF ACTIVE MAP – Textual content “list-geotrackees” or “lg” to get a numbered record of geotrackees within the lively map. (e.g. “ag [email protected] [email protected] 4153333333”)
- DELETING A GEOTRACKEE – Textual content “delete-geotrackee” or “dg” and the geotrackee’s quantity from “list-geotrackee” record. (e.g. “dg 2”)
- RENAME A GEOTRACKEE – Textual content “rename-geotrackee” or “rg”, the geotrackee’s quantity from “list-geotrackee” record and the geotrackee’s nickname. (e.g. “rg 2 Fortunate Louie”)
- PING ALL THE GEOTRACKEES IN THE ACTIVE MAP – Textual content “ping-geotrackee” or “pg”, then the phrase “all”. (e.g. “pg all”)
- PING AN INDIVIDUAL GEOTRACKEE IN THE ACTIVE MAP – Textual content “ping-geotrackee” or “pg”, then the geotrackee’s quantity you need to ping. (e.g. “pg 3”)
- GETTING HELP – Textual content “help-me” or ”?” to clear all of the maps and geotrackees and reset.
- RESETTING – Textual content “clear-all” or “ca” to clear all of the maps and geotrackees and reset.
HOW DO I INSTALL THIS PLUG-IN?
- If in case you have not completed so, buy the “PHP Uber-style Geotracker” script from codecanyon.net
- If in case you have not completed so, set up the script (see ‘Set up Directions’ part within the script’s documentation)
- Buy this plug-in- Twilio “Geo-Textual content” Plug-In
- Unzip the contents of the zip file into the next folder in your set up from step 1 and a couple of (http://<domain root>/php/sms/)
- Go to Twilio.com and join your account (join the SMS product – be sure you buy a twilio telephone quantity on your customers to textual content to)
- Click on on ‘Dashboard’ hyperlink to show Console Dashboard.
- Click on on ‘Programmable SMS’ hyperlink beneath the All Twilio Merchandise part on Console Dashboard.
- Click on on ‘Messaging Providers’ hyperlink on the Programmable SMS Dashbaord web page
- Click on on ’+’ signal on the Messaging Providers web page
- Enter ‘geotracker’ because the pleasant title and ‘Notifications, 2-Manner’ because the use case
- Verify the ‘Course of Inbound Messages’ examine field and enter https://<your area>/php/sms/obtain.php and save Configure web page
LIST OF TEXT COMMANDS
See desk beneath for record of instructions. Examples beneath are “textual content” instructions which are despatched to the Twilio telephone quantity you arrange throughout set up (or use the demo telephone quantity: 415-360-0886).
| LIST OF COMMANDS | DESCRIPTION |
| help-me or hm | get assist or record of instructions textual content: “help-me” |
| clear-all or ca | clear all my maps and geotrackees textual content: “clear-all” or “ca” |
| new-map or nm | create new map textual content: “new-map” or “nm” |
| list-maps or lm | record all my maps textual content: “list-maps” or “lm” |
| rename-map or rm | rename current map textual content: “rm 2 My Map” |
| switch-map or sm | swap lively map textual content: “switch-map 3” |
| delete-map or dm | textual content: “delete-map 2” |
| add-geotrackees or ag | add geotrackees to the lively map (default) textual content: “ag [email protected] 4154444444” |
| list-geotrackees or lg | get record of geotrackees in lively map textual content: “list-geotrackees” |
| delete-geotrackee or dg | delete geotrackee textual content: “dg 4” |
| rename-geotrackee or rg | create nickname for a geotrackee textual content: “rename-geotrackee 2 Cool Dude” |
| ping-geotrackees or pg | ping all geotrackee to replace location textual content: “pg 1,2,3” or “pg all” |
| or just sort in a comma separated (”,”) record of e mail addresses and telephone numbers instantly to ask folks to an lively geotracking map |
OVERVIEW OF PHP CODE
With this script comes a “template” PHP class that can be utilized as a place to begin for PHP builders to create different conversational Twilio SMS functions. See beneath documentation of this PHP class.
CLASS SYNOPSIS
class smsGeotracker {
// Properties
non-public $twilioFrom; // telephone variety of “texter”
non-public $twilioBody; // physique of the textual content
non-public $twilioAccountSid; // Twilio Account Sid
non-public $twilioAuthToken; // Twilio Auth Token
non-public $twilioPhoneNumber; // Twilio Telephone Quantity
non-public $sessionActiveMap; // mapkey for present lively map
non-public $db; // deal with to database db
non-public $urlRoot; // url of script
non-public $background; // background coloration of geotrackee icon
non-public $letter; // assigned geotrackee letter
non-public $headers; // e mail headers<
// Strategies
public operate getTwilioFrom()
public operate setTwilioFrom($twilioFrom)
public operate getTwilioBody()
public operate setTwilioBody($twilioBody)
public operate getUrlRoot()
public operate setUrlRoot($urlRoot)
public operate getLetter()
public operate setLetter($letter)
public operate getHeaders()
public operate setHeaders($headers)
public operate getBackground()
public operate setBackground($background)
public operate getTwilioAccountSid()
public operate setTwilioAccountSid($twilioAccountSid)
public operate getTwilioAuthToken()
public operate setTwilioAuthToken($twilioAuthToken)
public operate getTwilioPhoneNumber()
public operate setTwilioPhoneNumber($twilioPhoneNumber)
public operate getSessionActiveMap()
public operate setSessionActiveMap($sessionActiveMap)
public operate getDb()
public operate setDb($db)
public operate getGeotrackeeCount() // get geotrackee rely
public operate getGeotrackeeTable() // assemble geotrackee desk for e mail
public operate generateRandomKey($size = 10) // generate random key
public operate validatePhone($phoneNumber)
public operate getMode() // get present mode of operation
public operate getArg($argNo) // get n-th token from command (textual content physique)
public operate getMapkey($arg) // get mapkey of lively map
public operate getMapname($arg) // get mapname of lively map
public operate getMapCreated($arg) // get created date of lively map
public operate sendSms($to, $msg) // ship sms again to “texter”
public operate getActiveMap() // get lively map data
public operate doHelpMe() // do “help-me” command
public operate doListMaps() // do “list-maps” command
public operate doClearAll() // do “clear-all” command
public operate doActiveMap() // do “active-map” command
public operate doSwitchMap() // do “switch-map” command
public operate doDeleteMap() // do “delete-map” command
public operate doAddMap() // do “add-map” command
public operate doRenameMap() // do “rename-map” command
public operate doListGeotrackees() // do “list-geotrackees” command
public operate doDeleteGeotrackee() // do “delete-geotrackee” command
public operate doAddGeotrackees() // do “add-geotrackee” command
public operate doPingGeotrackee() // do “ping-geotrackee” command
}
|
FUTURE IMPROVEMENTS – FROM THE NINJA Unsure if there may be far more so as to add to this script. I’ll need to add some geotrackee viewing restrictions so as to differentiate between geotrackee’s that may see everybody’s location, with geotrackees that may solely see their very own and in addition hiding proprietor’s location. |
I do plan to create a dispatcher module that makes use of a daily desktop consumer interface for critical dispatching. However undecided of the timing of this. It would in all probability leverage my different scripts together with PHP Dashboards, and so on. Let me know what you suppose by commenting on this script.
-Knowledge Ninja
AUTHOR’S NOTE IN BLOG: see weblog submit – Author’s Note: Twilio “Geo-text” Plug-In
DOCUMENTATION: see weblog submit – Author’s Note: Twilio “Geo-Text” Plug-In
REMINDER ON EXTENDED LICENSES: Only a pleasant reminder that there are two completely different license ranges at codecanyon.internet. The common license is for single FREE consumer use. If in case you have a number of shoppers or charging shoppers for performance from this script, then an prolonged license is the suitable degree. It’s solely truthful as I do spend quite a lot of time tuning these scripts. And extra gross sales/revenues means I can code extra options and it has come to my consideration that many purchasers are utilizing my script for business (for pay) functions with simply the common license. Thanks for you assist. Click on for extra particulars – Regular vs. Extended License Comparison
SYSTEM REQUIREMENTS
- Any browser that helps HTML5/Javascript, jQuery (2.1.4). Examined with Chrome Model 49.0.2623.110 (64-bit), Safari Model 5.1.7 (7534.57.2), Web Explorer 11.0.9600.18230, Firefox 5.0.2
- A PHP/MySQL supported webserver is required for jsfiddle options (preview, share, save) and render script choices #3 and #4 – click on here for phpinfo for PHP/MySQL variations and configuration choices of the server serving up the demo. IMPORTANT: be certain that to match with phpinfo of your set up. Many PHP/MySQL errors stem from configuration choices of buyer php server situations.
- You have to a PAID Twilio account and telephone quantity
(See set up directions on this web page to see how to enroll and set up)
VERSION HISTORY – Twilio “Geo-text” Plug-In
- VERSION 1.0 (10/02/2017) – Preliminary launch model
- Twilio SMS texting consumer interface for the PHP Uber-style Geotracker script.
- Dispatcher options not discovered within the authentic geotracker script. See ’’Record of Textual content Instructions’ part on this web page for the record of options included on this preliminary model.
My Different Scripts at Codecanyon:
– (BRAND NEW!!!) PHP Dashboard v5 (Enterprise Edition)
– PHP Daytrader’s Candlestick Pattern Hunter v1.0
– Twilio “Geo-text” Plug-In (a PHP Uber-style Geotracker Add On)
– PHP Uber-style GeoTracker
– PHP Dashboard v4.0 Collaborative Social Dashboards
– PHP Dashboard v3.0 – For Mobile Devices
– PHP Dashboard v2.7 – Responsive Carousels
– PHP Dashboard – NEW Version 1.2
– HTML5 Data-Driven Documents (D3js) Plug-In
– HTML5 Cloud Dashboard Designer
– HTML5 Streetmaps
– PHP Streetmaps
OTHER LINKS
