IMPORTANT: Both Crowdmap "Classic" and Ushahidi users will need to make this change to use Twitter with your map project.

To have your deployment pull tweets based on hashtag/s, you will need to set up your deployment as an application on twitter.

Steps

  1. Sign in on  https://dev.twitter.com/ with your twitter username and password
  2. Once signed in, on the right-hand side, click on your profile picture, you will get a drop-down , select the “My Applications” link.
  3. On the next page, click on “Create a new application”
  4. Fill in the application details
    1. Name – this can be your deployment/site name e.g Uchaguzi
    2. Description – this is your deployment/site description – what your deployment does
    3. Website – this is your deployment url/link i.e http://yourdeployment
    4. Callback url – this one leave it blank.
  5.  After creating the application, you will get some of your authentication details but you are not yet done, on the same page click on the "API Keys" tab. Here you will need to generate your access tokens. To do this click on "create my access token" button. The tokens will take a few minutes to be generated, you can refresh the page after a few minutes to see them.
  6. After all the hoops, click on "Test OAuth" on the top right corner of the page to get all the information for your twitter application. These include CONSUMER KEY,CONSUMER SECRET, ACCESS TOKEN, ACCESS TOKEN SECRET.
  7. Go back to http://yourdeployment/admin/settings/twitter and key in those details. In addition, add the hashtags you want to pull tweets from and hit on “save settings”.  Leave the rest of the magic to happen, your tweets will display on http://yourdeployment/admin/messages/twitter.