This Plugin requires :

• RainLab User plugin
• Cellphone
• User Select
• Twilio account

Go to Twilio account and setup your account and phone number.

Basic Steps:

• Install plugin ( Installation code : kurtjensen.twilio )
• Logout and back into october backend.
• Goto Settings - Twilio
  • Enter your Twilio _AccountSID
  • AuthToken from www.twilio.com/user/account
  • SMS Phone Numbers ( one per line ) to match the Twilio phone number(s) you want to send from.
    • Multiple numbers can be used to send by entering each son separate line.
    • Include Area code + number but not the "+1" prefix.
  • Phone Country Prefix ( use "+1" for USA )
  • Hook Response - message sent back to people who try send text to your number.

Twilio SMS Sender Page

• Add _Twilio_SMSSender component to a page.
• Setup access to you page so that only the users you want on your list can access the page and send messages. See:Passage Permission.

Your page markup should look like this:

{% component 'SendSMS' %}

Twilio SMS Compose Message Page

• Create a new page.
• Add Cellphone Checkform
  • Set property for page that contains the "_Twilio_SMSSender" Component from Twilio that you just made above.
• Add User Selector Component form User Select
• Set Group Type parameter ( ALL for all custom group type buttons or restrict based on “Type” you set in custom checklist group.)
• Set the Submit Button Label to match the context of your page

Your page markup should look like this:

{% component 'Checkform' %}
{% component 'Checklist' %}

Your checklist will now show-up when page is viewed and the selections are added or removed from Database when buttons are pressed.

( Don't worry; It will make sense when you see it. )

Later you will want to review protecting your pages using instructions from Passage Permission Keys Plugin.

That should be all you need to get started. Please feel free to contact me if you have questions.

Upgrade guide

• Upgrading to 2.0.0 from 1.1.0

• Upgrading to 1.1.0 from 1.0.10

• Upgrading to 1.0.5 from 1.0.4

<a name="upgrade-2.0.0"></a>

Upgrading To 2.0.0

This is an important update that contains breaking changes.

The SendSMS component is depreciated and is being replaced by SendSelectUsers component. This will allow messages to be sent by scheduling ahead of time and it also allows users to edit or delete their unsent / scheduled messages. The SMS form is much more responsive to the user now because Twilio Server connections are done in the background at scheduled intervals of five minutes. Logging is also done in messages table and in the future users will be able to check the status of sent messages after they are processed by Twilio.

<a name="upgrade-1.1.0"></a>

Upgrading To 1.1.0

This is an important update that contains breaking changes.

The Twilio settings only has one "From Phone" number to send from. Best practice is to only use one number to avoid being marked as SPAM.

From Phone is a new field in the Twilio settings labeled as SMS Phone Number and will need to be set by you after upgrading or an Exception will occur on components.

There is also a new setting for Phone Country Prefix that needs to be set. For users in USA this should be set to "+1".

A new Test Phone Number field for sending messages to is also in settings.

<a name="upgrade-1.0.5"></a>

Upgrading To 1.0.5

This is an important update that contains breaking changes.

The Twilio SMS Sender component no longer has a From Phone property to hold the phone number(s) on twillo to send from.

From Phone has been moved into the Twilio settings as SMS Phone Numbers and will need to be set by you after upgrading or an Exception will occur on the SMS Sender component.

There is also a new setting for Phone Country Prefix that needs to be set. For users in USA this should be set to "+1".