--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_pubsub_twitter/README.markdown Fri Aug 28 18:03:58 2015 +0200
@@ -0,0 +1,44 @@
+---
+labels:
+- 'Stage-Alpha'
+summary: Subscribe to Twitter search queries over pubsub
+...
+
+Introduction
+------------
+
+Twitter has an open 'realtime' search API, but it requires polling
+(within their rate limits). This module allows Prosody to poll for you,
+and push new results to subscribers over XMPP.
+
+Configuration
+-------------
+
+This module must be loaded on a Prosody pubsub component. Add it to
+`modules_enabled` and configure like so:
+
+ Component "pubsub.example.com" "pubsub"
+ modules_enabled = { "pubsub_twitter" }
+
+ twitter_searches = {
+ realtime = "xmpp OR realtime";
+ prosody = "prosody xmpp";
+ }
+
+This example creates two nodes, 'realtime' and 'prosody' that clients
+can subscribe to using
+[XEP-0060](http://xmpp.org/extensions/xep-0060.html). Results are in
+[ATOM 1.0 format](http://atomenabled.org/) for easy consumption.
+
+ Option Description
+ ------------------------- --------------------------------------------------------------------------------
+ twitter\_searches A list of virtual nodes to create and their associated Twitter search queries.
+ twitter\_pull\_interval Number of minutes between polling for new results (default 20)
+ twitter\_search\_url URL of the JSON search API, default: "http://search.twitter.com/search.json"
+
+Compatibility
+-------------
+
+ ----- -------
+ 0.9 Works
+ ----- -------