README.txt 2.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354
  1. Introduction
  2. ============
  3. Twitter module allows listing tweets in blocks or pages. Its integration with Views opens the
  4. door to all sorts of formatting (ie. as an automatic slideshow with views_slideshow). It also
  5. provides useful input filters to easily link Twitter accounts and searches within text.
  6. Twitter's submodules allow posting to twitter, executing actions/rules when tweeting or login
  7. with a Twitter account.
  8. OAuth
  9. =====
  10. Except for just listing tweets, OAuth module is required to authenticate against Twitter. If you
  11. just want to list tweets in a block, follow the steps at http://drupal.org/node/1253026.
  12. When you download the OAuth module, get the latest stable release available at http://drupal.org/project/oauth
  13. Once OAuth has been enabled, go to admin/config/services/twitter and follow instructions.
  14. How to add a Twitter account to a Drupal user account
  15. =====================================================
  16. Read http://drupal.org/node/1253026 for details.
  17. How to use the username and hashtag input filters
  18. =================================================
  19. 1. Go to admin/config/content/formats.
  20. 2. Select the text format where you want to use the filters.
  21. 3. At "Enabled filters" check the Twitter converters.
  22. After that, clear cache and try to create a page with the following body:
  23. #drupal @drupal
  24. The above links to a search in Twitter over the #drupal tag and a to the @drupal profile.
  25. These filters are avilable when configuring a tweets Views.
  26. How to post to Twitter
  27. ======================
  28. 1. Read the OAuth section to install and configure OAuth.
  29. 2. Once OAuth has been configured, go to admin/config/services/twitter/post and select from which
  30. node types a user may post to Twitter and the default message.
  31. 3. Verify permissions at admin/people/permissions.
  32. 4. Add a Twitter account and try to edit or post content.
  33. How to sign in with Twitter
  34. ===========================
  35. Existing and new users can sign in with Twitter by enabling the twitter_signin module. The following scenarios are being contemplated so far:
  36. * A visitor logs in with his Twitter account and, once authenticated at Twitter.com, he fills in
  37. his email in the Drupal registration form and receives an email to log in and set his account
  38. password.
  39. * An existing user signs in with Twitter and then logs in into his Drupal user account. This results
  40. in the Twitter account getting related to the user account so next time Twitter sign in will work.
  41. * An existing user with an already configured Twitter account can log in automatically by clicking
  42. on the Sign in with Twitter button.