From: Evan Prodromou <evan@controlyourself.ca>
Date: Sun, 26 Apr 2009 19:41:55 +0000 (-0400)
Subject: README for the comet plugin
X-Git-Url: https://git.mxchange.org/?a=commitdiff_plain;h=781341d91fd4c7406d8687e7828ab86f9696cf66;p=quix0rs-gnu-social.git

README for the comet plugin
---

diff --git a/plugins/Comet/README b/plugins/Comet/README
new file mode 100644
index 0000000000..4abd40af7a
--- /dev/null
+++ b/plugins/Comet/README
@@ -0,0 +1,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 cometd server. I've only had the cometd-java server work
+correctly; something's wiggy with the Twisted-based server.
+
+After you have a cometd server installed, just add this code to your
+config.php:
+
+    require_once(INSTALLDIR.'/plugins/Comet/CometPlugin.php');
+    $cp = new CometPlugin('http://example.com:8080/cometd/');
+
+Change 'example.com:8080' to the name and port of the server you
+installed cometd on.
+
+TODO:
+
+* 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.