1803
|
1 --- |
|
2 labels: |
|
3 - 'Stage-Alpha' |
|
4 summary: Subscribe to Twitter search queries over pubsub |
|
5 ... |
|
6 |
|
7 Introduction |
|
8 ------------ |
|
9 |
|
10 Twitter has an open 'realtime' search API, but it requires polling |
|
11 (within their rate limits). This module allows Prosody to poll for you, |
|
12 and push new results to subscribers over XMPP. |
|
13 |
|
14 Configuration |
|
15 ------------- |
|
16 |
|
17 This module must be loaded on a Prosody pubsub component. Add it to |
|
18 `modules_enabled` and configure like so: |
|
19 |
|
20 Component "pubsub.example.com" "pubsub" |
|
21 modules_enabled = { "pubsub_twitter" } |
|
22 |
|
23 twitter_searches = { |
|
24 realtime = "xmpp OR realtime"; |
|
25 prosody = "prosody xmpp"; |
|
26 } |
|
27 |
|
28 This example creates two nodes, 'realtime' and 'prosody' that clients |
|
29 can subscribe to using |
|
30 [XEP-0060](http://xmpp.org/extensions/xep-0060.html). Results are in |
|
31 [ATOM 1.0 format](http://atomenabled.org/) for easy consumption. |
|
32 |
|
33 Option Description |
|
34 ------------------------- -------------------------------------------------------------------------------- |
|
35 twitter\_searches A list of virtual nodes to create and their associated Twitter search queries. |
|
36 twitter\_pull\_interval Number of minutes between polling for new results (default 20) |
|
37 twitter\_search\_url URL of the JSON search API, default: "http://search.twitter.com/search.json" |
|
38 |
|
39 Compatibility |
|
40 ------------- |
|
41 |
|
42 ----- ------- |
|
43 0.9 Works |
|
44 ----- ------- |