You are here

Home » API reference » Twitter 7.4

README.txt in Twitter 7.4

Same filename and directory in other branches
  1. 8 README.txt
  2. 6.5 README.txt
  3. 6.3 README.txt
  4. 6.4 README.txt
  5. 7.6 README.txt
  6. 7.3 README.txt
  7. 7.5 README.txt
Introduction
============
Twitter module allows listing tweets in blocks or pages. Its integration with Views opens the
door to all sorts of formatting (ie. as an automatic slideshow with views_slideshow). It also
provides useful input filters to easily link Twitter accounts and searches within text.

Twitter's submodules allow posting to twitter, executing actions/rules when tweeting or login
with a Twitter account.

Installation
============
Twitter's REST API library is out of the module. Although this needs an extra step on installation,
it makes the library reusable for both Drupal 6 and 6 versions and also other modules.

To set it up, just download twitter.lib.php from https://github.com/juampy72/twitter-rest-php/downloads
to your libraries directory (normally sites/all/libraries) so its final location is
sites/all/libraries/twitter/twitter.lib.php

To verify that it has been installed correctly, view the Status Report at
http://yoursite/admin/reports/status.

OAuth
=====
OAuth module is required for all requests to the Twitter REST API 1.1.

When you download the OAuth module, get the latest stable release available at http://drupal.org/project/oauth

Once OAuth has been enabled, go to admin/config/services/twitter and follow instructions in order
to provide your Application keys.

How to add a Twitter account to a Drupal user account
=====================================================
Read http://drupal.org/node/1253026 for details.

How to use the username and hashtag input filters
=================================================
1. Go to admin/config/content/formats.
2. Select the text format where you want to use the filters.
3. At "Enabled filters" check the Twitter converters.

After that, clear cache and try to create a page with the following body:

#drupal @drupal

The above links to a search in Twitter over the #drupal tag and a to the @drupal profile.
These filters are avilable when configuring a tweets Views.

How to post to Twitter
======================
1. Read the OAuth section to install and configure OAuth.
2. Once OAuth has been configured, go to admin/config/services/twitter/post and select from which
   node types a user may post to Twitter and the default message.
3. Verify permissions at admin/people/permissions.
4. Add a Twitter account and try to edit or post content.

How to sign in with Twitter
===========================
Existing and new users can sign in with Twitter by enabling the twitter_signin module. The following scenarios are being contemplated so far:

* A visitor logs in with his Twitter account and, once authenticated at Twitter.com, he fills in
  his email in the Drupal registration form and receives an email to log in and set his account
  password.
* An existing user signs in with Twitter and then logs in into his Drupal user account. This results
  in the Twitter account getting related to the user account so next time Twitter sign in will work.
* An existing user with an already configured Twitter account can log in automatically by clicking
  on the Sign in with Twitter button.

File

README.txt
View source 
  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. 

  7. Twitter's submodules allow posting to twitter, executing actions/rules when tweeting or login

  8. with a Twitter account.

  9. 

  10. Installation

  11. ============

  12. Twitter's REST API library is out of the module. Although this needs an extra step on installation,

  13. it makes the library reusable for both Drupal 6 and 6 versions and also other modules.

  14. 

  15. To set it up, just download twitter.lib.php from https://github.com/juampy72/twitter-rest-php/downloads

  16. to your libraries directory (normally sites/all/libraries) so its final location is

  17. sites/all/libraries/twitter/twitter.lib.php

  18. 

  19. To verify that it has been installed correctly, view the Status Report at

  20. http://yoursite/admin/reports/status.

  21. 

  22. OAuth

  23. =====

  24. OAuth module is required for all requests to the Twitter REST API 1.1.

  25. 

  26. When you download the OAuth module, get the latest stable release available at http://drupal.org/project/oauth

  27. 

  28. Once OAuth has been enabled, go to admin/config/services/twitter and follow instructions in order

  29. to provide your Application keys.

  30. 

  31. How to add a Twitter account to a Drupal user account

  32. =====================================================

  33. Read http://drupal.org/node/1253026 for details.

  34. 

  35. How to use the username and hashtag input filters

  36. =================================================

  37. 1. Go to admin/config/content/formats.

  38. 2. Select the text format where you want to use the filters.

  39. 3. At "Enabled filters" check the Twitter converters.

  40. 

  41. After that, clear cache and try to create a page with the following body:

  42. 

  43. #drupal @drupal

  44. 

  45. The above links to a search in Twitter over the #drupal tag and a to the @drupal profile.

  46. These filters are avilable when configuring a tweets Views.

  47. 

  48. How to post to Twitter

  49. ======================

  50. 1. Read the OAuth section to install and configure OAuth.

  51. 2. Once OAuth has been configured, go to admin/config/services/twitter/post and select from which

  52.    node types a user may post to Twitter and the default message.

  53. 3. Verify permissions at admin/people/permissions.

  54. 4. Add a Twitter account and try to edit or post content.

  55. 

  56. How to sign in with Twitter

  57. ===========================

  58. Existing and new users can sign in with Twitter by enabling the twitter_signin module. The following scenarios are being contemplated so far:

  59. 

  60. * A visitor logs in with his Twitter account and, once authenticated at Twitter.com, he fills in

  61.   his email in the Drupal registration form and receives an email to log in and set his account

  62.   password.

  63. * An existing user signs in with Twitter and then logs in into his Drupal user account. This results

  64.   in the Twitter account getting related to the user account so next time Twitter sign in will work.

  65. * An existing user with an already configured Twitter account can log in automatically by clicking

  66.   on the Sign in with Twitter button.