SMS Sender
This module enables sending SMS from ExpressionEngine frontend pages.
To send SMS, you will need to use third-party SMS gateway service. Currently following are supported: Twilio.
Sending the message
{exp:sms_sender:form}
{exp:sms_sender:form}
<p>Message:
<textarea name="message"></textarea>
</p>
<p>Recipients:
<textarea name="recipients"></textarea>
</p>
<p><input type="submit" value="Send SMS" /></p>
{/exp:sms_sender:form}
Tag parameters:
- return — a page to return to after submitting the form. Can be a full URL or URI segments.
Use return="SAME_PAGE" to return user to the page used to display this form. - skip_success_message="yes" — force redirect to return page without showing success message.
- ajax="yes" — turn on AJAX mode. The success or error messages shown upon submission will be shown as simple text, without using message templates. The "return" parameter will not be functional if you supply this parameter.
- id — form ID (defaults to 'sms_sender_form')
- class — form class (defaults to 'sms_sender_form')
- name — form name (defaults to 'sms_sender_form')
Form fields:
- message — SMS message text
- recipients — list of recipients phones (in internation format). Put each number on new line, or separate with comma
Log of sent messages
<table>
<tr>
<th>Message</th>
<th>Recipient</th>
<th>Date sent</th>
<th>Status</th>
</tr>
{exp:sms_sender:log sender_id="CURRENT_USER"}
<tr>
<td>{message_text}</td>
<td>{recipient}</td>
<td>{sending_date format="%Y-%m-%d %H:%i:%s"}</td>
<td>{status}</td>
</tr>
{/exp:sms_sender:log}
</table>
{exp:sms_sender:log} tag will display log of all messages sent by module.
Tag parameters (all optional):
- sender_id — member ID of sender. Use CURRENT_USER to display log of messages sent by logged in member
- recipient — recipient phone number (to display only messages sent to certain phone)
- date_from — display messages sent after certain date
- date_to — display messages sent before certain date
Single variables:
- member_id — sender member id
- username — sender username
- screen_name — sender screen_name
- message_text — SMS message text
- recipient — recipient phone number
- sending_date format="%Y-%m-%d" — the date when SMS was sent
- status — message status (can be "ok" or "error")