FAQ (Frequently Asked Questions)
--------------------------------

Q: Why the core codes are licensed as GPL version 2?
A: GPL is one of the open source license, choosing this will force 
   users or developers to contribute back when they modify the core.

Q: Why plugins and API related codes are licensed as LGPL?
A: So that you can create your own or modify from others a playSMS 
   plugins and merge them with your proprietary software comfortably.


A. LOGIN
--------
1.  How to login for the first time after installation?
    Answer:
    Browse playSMS URL and login with username admin and password admin

2.  What should I do next after I logged in as Administrator?
    Answer:
    Change your default password, add new normal users, setup main 
    configuration, create group and add mobile phone number.

3.  What should I do for the first time as Normal User?
    Answer:
    Change your default password given by Administrator, create group
    and add mobile phone number to phonebook.


B. SEND SMS
-----------    
1.  How to send one SMS from web?
    Answer:
    Use Send SMS page.

2.  How to send broadcast SMS from web?
    Answer:
    Use Send SMS page.

3.  Is there any delivery status reported?
    Answer:
    Yes. Go to Outgoing SMS page.
    Status "Failed" is for failed attempt.
    Status "Pending" is for queued SMS (on server).
    Status "Sent" is for SMS sent (SMS sent to gateway).
    Status "Delivered" is for SMS delivered to phone.

4.  Can we delete Outgoing SMS?
    Answer:
    Yes, but its not really deleted, its just permanently hidden from
    everyone's Outgoing SMS page (including from administrator's).

5.  Can we retrieve deleted Outgoing SMS?
    Answer:
    No, not at the moment. Not from playSMS interface.

6.  If we delete Outgoing SMS, is it affecting SMS transmission?
    Answer:
    No, playSMS will keep trying to send the SMS.

7.  How do my sent SMS look like at the recipient mobile phones?
    Answer:
    If you set the SMS footer in your Preferences, then the SMS footer
    will be added to the end of your SMS, this is useful when using 
    gateway module with no ability to set SMS sender ID.
    Gateway modules which have the ability to set SMS sender ID will 
    set SMS sender ID to the SMS.
    The sender ID is set according to this order:
	1. Default sender ID on Main configuration (in case it exists)
	2. Module sender ID on active gateway configuration (in case it exists)
	3. SMS sender ID on User preferences


C. RECEIVE SMS
--------------    
1.  Can I receive SMS?
    Answer:
    Yes, your incoming SMS are stored on your Inbox. Current version
    have new feature to forward incoming SMS to your email and to your
    mobile phone.

2.  How do I receive SMS?
    Answer:
    Tell people to send SMS to your playSMS number with format:
        PV [your_username] [their message]
    or this format (since playSMS 0.9.5.2):
        @[your username] [their message]
    or as long as the SMS contains @[your username] (since playSMS 0.9.8)

    eg: 
	PV devteam your application works!
	pv devteam i want to help you developing this application :)
	@devteam your application rocks!
	@devteam I want to help but dunno wht todo, any idea?
	@admin bro, please set me as admin too !!
	Hi @admin, nice to know that now we have a free SMS service!
	
3.  Can I forward SMS from my mobile phone to my phonebook group?
    Answer:
    When you create a group in your phonebook you will be asked for 
    a Group Code. Use that Group Code as parameter to forward SMS to 
    group using special keyword BC you may forward SMS to your group:
        BC [group code] [your message]
    or as long as the SMS contains #[group code] (since playSMS 0.9.8)

    eg: 
	BC DEV thx for joining our crussade :)
	bc DEV dont forget to read function.php
	Bc DEV testing only, sending this SMS to group code DEV
	#DEV its nice to meet you all
	To all of you in #DEV please get this bug fixed asap!

    Note: playSMS will use Mobile number sets in user Preferences to
    authenticate keyword BC

4.  What happened to the received/incoming SMS without keyword PV 
    or keyword (or messages) with @ sign ?
    Answer:
    They will only be shown in All Incoming SMS menu as an 'unhandled' 
    SMS where only admin users have access to them.


D. WEBSERVICES
--------------
1.  Can I use my own application or 3rd party application to send SMS
    using playSMS?
    Answer:
    Yes, more information how to use this feature can be read in 
    docs/WEBSERVICES

2.  Can I retrieve delivery status remotely so I can process it from
    other application?
    Answer:
    Yes, delivery statuses are retrieved in CSV or XML format, more 
    information about this feature can be read in docs/WEBSERVICES


E. SMS BOARD
------------
1.  What is SMS board?
    Answer:
    Administrator can add new SMS board with keyword other than PV and
    BC. Incoming SMS with the specified keyword will be handled by SMS
    board and be forwarded to a unique web page served by playSMS.
    Incoming SMS will also be forwarded to an email specified in each
    SMS board keywords.

2.  If I add SMS board, howto access web page for a keyword?
    Answer:
    For example you've added SMS board with keyword INFO. The web page 
    for keyword INFO (referred as SMS board INFO) would be accessable
    through this url: 
    http://playsms/index.php?app=webservices&ta=sms_board&keyword=INFO
    Other parameter you can use to refine the display:
    line	: show x line number of rows 
    bodybgcolor	: set body background color
    oddbgcolor	: set odd row backround color
    evenbgcolor	: set even row backround color
    eg:
      http://playsms/index.php?app=webservices&ta=sms_board&keyword=INFO&line=15
    
3.  What output formats available for SMS board webservices?
    Answer:
    PHP serialize, json, xml, rss feed (0.91, 1.0, 2.0, ATOM) and html.
    Please see menu view in SMS board.
    
4.  How to put that web page on my main website?
    Answer:
    Use IFRAME html tag. Customize your IFRAME to match your main 
    website look and feel.
    eg:
      <IFRAME 
      src="http://playsms/index.php?app=webservices&ta=sms_board&keyword=INFO">
      </IFRAME>
    Note: other solution may be available.


F. SMS COMMAND
--------------    
1.  Can I command server todo something?
    Answer:
    Yes. Login as admin user and configure SMS command feature.

2.  How to setup SMS command?
    Answer:
    Add new SMS command and associate a command that will be executed
    on incoming SMS that matched your keyword.
    On incoming SMS, playSMS will pass variables to the command.
    They are:
    	{SMSDATETIME} replaced by incoming SMS date/time
    	{SMSSENDER} replaced by sender mobile phone number
    	{COMMANDKEYWORD} replaced by incoming SMS keyword
    	{COMMANDPARAM} replaced by incoming SMS parameter    
    	{COMMANDRAW} replaced by SMS raw message

3.  How to utilized a defined SMS command?
    Answer:
    Send SMS to your playSMS with format:
    	[COMMAND KEYWORD] [COMMAND PARAM]
    eg: 
	reg email devteam@playsms.org
	retr pop3 pop3.ngoprek.org devteam mypwd
	uptime

4.  What commands are available from SMS command?
    Answer:
    Any commands are available to be executed from SMS command.

5.  What is the check box 'Make return as reply' for?
    Answer:
    playSMS will pickup output of executed command as reply to sender


G. SMS CUSTOM
-------------    
1.  What is SMS custom?
    Answer:
    SMS custom is used to process incoming SMS by passing the SMS
    information to another application in other server using HTTP.
    [sender] --GSM-- [playSMS] --IP-- [other host processing SMS]

2.  How to setup SMS custom?
    Answer:
    Add new SMS custom from menu, and then set custom URL of the host
    handling SMS.
    On incoming SMS, playSMS will pass variables to the URL.
    They are:
    	{SMSDATETIME} replaced by SMS incoming date/time
    	{SMSSENDER} replaced by sender mobile phones number
    	{CUSTOMKEYWORD} replaced by custom keyword
    	{CUSTOMPARAM} replaced by custom parameter
    	{CUSTOMRAW} replaced by SMS raw message

3.  How to utilized a defined SMS custom?
    Answer:
    Send SMS to your playSMS with format:
    	[CUSTOM KEYWORD] [CUSTOM PARAM]
    eg: 
	reg email devteam@playsms.org
	retr pop3 pop3.ngoprek.org devteam mypwd
	uptime

4.  What is the check box 'Make return as reply' for?
    Answer:
    playSMS will pickup output of URL/other host as reply to sender


H. SMS POLL
-----------
1.  How to use SMS poll system?
    Answer:
    Add new poll or list/edit/delete it. Write down poll keyword and 
    each choice keyword you have defined.
    Tell  voters to send SMS to playSMS SMS gateway mobile number with
    format:
    [POLL KEYWORD] [CHOICE KEYWORD]
    eg:
    food chicken
    pres 3

2.  Howto show results of SMS poll in other website?
    Answer:
    For example polling with keyword PRES
    Webpage for poll named PRES would be accessable trough this url: 
    http://your_playsms/index.php?app=webservices&ta=sms_poll&keyword=PRES
    Other parameter you can use:
    bodybgcolor	: set body background color
    refresh=yes	: check latest incoming sms and refresh webpage output
    Use IFRAME html tag.
    eg:
	<IFRAME src="http://your_playsms_web_domain/index.php?app=webservices
	&ta=sms_poll&keyword=PRES"></IFRAME>

3.  What output formats available for SMS poll webservices?
    Answer:
    PHP serialize, json, xml, and graph. Please see menu view in SMS poll.


I. SMS QUIZ
-----------
1.  What is SMS quiz system?
    Answer:
    Administrator can add quiz keywords, questions and answers, and 
    define message reply for participants. 
    Once a participant send message with quiz keyword and quiz answer
    keyword, system will reply with a message to tell participant 
    whether the answer is correct or incorrect.
	
2.  Howto use SMS quiz system?
    Answer:
    Add new quiz or list/edit/delete it. Write down quiz keyword, quiz
    question, quiz answer and message to participants for correct and 
    incorrect message.
    Tell  participants to send SMS to playSMS mobile number with 
    format:
    [QUIZ KEYWORD] [ANSWER KEYWORD]
    eg:
    soccer germany
   
    
J. SMS SUBSCRIBE
----------------
1.  What is SMS subscribe system?
    Answer:
    Administrator can add SMS keyword which people can subscribe to.
    Once a number subscribed, administrator can send message to all 
    subscribed number at once.
	
2.  Howto use SMS subscribe system?
    Answer:
    Add new subscribe or list/edit/delete it. Write down subscribe 
    keyword, subscribe message, and unsubscribe message.
    When a number has subscribed the system will automatically send 
    a subscribe message, and when a number has unsubscribe the system 
    will automatically send an unsubscribe message.
    Add message to each subscribe keyword, this message will be sent 
    to all subscribed number.    
    Tell  people to send SMS to playSMS SMS gateway mobile number with
    format:
    [SUBSCRIBE KEYWORD] [INSTRUCTION]
    eg:
    PLAYSMS REG
    PLAYSMS UNREG
    theclub REG
    theclub off
    

K. GATEWAY MODULE
-----------------    
1.  I've heard that from version 0.5 playSMS support any gateway other
    than gnokii. Is this true?
    Answer:
    Yes. From version 0.5 you can write a gateway module and place on 
    $apps_path[plug]/gateway to load it.

2.  So if I don't have GSM modem or nokia 5110, say I have access to 
    an SMSC or Internet SMS Gateway like http://www.clickatell.com can
    I use playSMS?
    Answer:
    Yes. Use gateway module kannel for connecting directly to an SMSC
    or use gateway module clickatell and uplink for connecting to 
    other sms gateway/server such as Clickatell or another playSMS.
    Please see $apps_path[plug]/gateway/clickatell/ for Clickatell and
    $apps_path[plug]/gateway/uplink/ for Uplink.
        
3.  Is kannel (http://kannel.org) supported by playSMS?
    Answer:
    Yes, starting version 0.6
    Please see $apps_path[plug]/gateway/kannel/

4.  How can I configure each gateway module?
    Answer: 
    Starting from version 0.8 a web based control panel for gateway 
    modules configurations is available for Administrator.

5.  How can I setup which gateway module active?
    Answer:
    Login as Administrator and activate the chosen gateway by clicking
    "Activate" menu on each gateway module configuration.

6.  Can I build my own gateway module ?
    Answer:
    Yes.


L. SMS RATE AND CREDIT
----------------------
1.  What is Manage SMS rate menu in Administration drop-down menu?
    Answer:
    It is where administrator can set rate by prefix.
    
2.  What is term 'rate' means?
    Answer:
    Rate is credit value per SMS sent.
    
3.  What is term 'credit' means?
    Answer:
    Credit is money value equivalent a user have on their balance
    
4.  What if user send SMS to destination that is not configured in 
    Manage SMS rate?
    Answer:
    Default SMS rate in Main configuration menu will be used instead.
    
5.  How to change credit per user ?
    Answer:
    Go to Manage user menu in Administration drop-down menu and edit 
    each user.
    
6.  What kind of SMS being rated ?
    Answer:
    Only sent SMS.


M. CONTACT
----------    
1.  Is there any place where I can discuss playSMS matters?
    Answer:
    Yes. playSMS mailing list. It is intended for general users but
    focus on developers. Please join the group by sending empty email
    to playsms-devel-subscribe@yahoogroups.com

2.  What is the official website for playSMS?
    Answer:
    http://www.playsms.org

3.  Should I tell you guys when I install playSMS on my site?
    Answer:
    Please send email to the mailing list.
    
4.  If I have wishes, what should I do?
    Answer:
    If its about playSMS, please visit http://www.playsms.org/support
    If its about your life, you have to stay on your path, be brave
    and never give up!
    
5.  If I found bugs and/or security holes, what should I do?
    Answer:
    Please visit http://www.playsms.org/support

