]> git.mxchange.org Git - quix0rs-gnu-social.git/commitdiff
update README for Meteor plugin
authorEvan Prodromou <evan@controlyourself.ca>
Mon, 13 Jul 2009 07:25:08 +0000 (03:25 -0400)
committerEvan Prodromou <evan@controlyourself.ca>
Mon, 13 Jul 2009 07:25:08 +0000 (03:25 -0400)
plugins/Meteor/README

index 4abd40af7ae18bbb3e350559ac7d2ab1fd888e46..22f548462f02ce2db89fc8cbff0f70a50ffaf327 100644 (file)
@@ -2,25 +2,26 @@ This is a plugin to automatically load notices in the browser no
 matter who creates them -- the kind of thing we see with
 search.twitter.com, rejaw.com, or FriendFeed's "real time" news.
 
-NOTE: this is an insecure version; don't roll it out on a production
-server.
+It requires a meteor server.
 
-It requires a cometd server. I've only had the cometd-java server work
-correctly; something's wiggy with the Twisted-based server.
+   http://meteorserver.org/
 
-After you have a cometd server installed, just add this code to your
-config.php:
+Note that the controller interface needs to be accessible by the Web
+server, and the subscriber interface needs to be accessible by your
+Web users. You MUST firewall the controller interface from users;
+otherwise anyone will be able to push any message to your subscribers.
+Not good!
 
-    require_once(INSTALLDIR.'/plugins/Comet/CometPlugin.php');
-    $cp = new CometPlugin('http://example.com:8080/cometd/');
+You can enable the plugin with this line in config.php:
 
-Change 'example.com:8080' to the name and port of the server you
-installed cometd on.
+addPlugin('Meteor', array('webserver' => 'meteor server address'));
 
-TODO:
+Available parameters:
+
+* webserver: Web server address. Defaults to site server.
+* webport: port to connect to for Web access. Defaults to 4670.
+* controlserver: Control server address. Defaults to webserver.
+* controlport: port to connect to for control. Defaults to 4671.
+* channelbase: a base string to use for channels. Good if you have
+  multiple sites using the same meteor server.
 
-* Needs to be tested with Ajax submission. Probably messes everything
-  up.
-* Add more timelines: personal inbox and tags would be great.
-* Add security. In particular, only let the PHP code publish notices
-  to the cometd server. Currently, it doesn't try to authenticate.