|
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 ----- -------
|
