summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorEvan Prodromou <evan@prodromou.name>2008-05-22 14:34:21 -0400
committerEvan Prodromou <evan@prodromou.name>2008-05-22 14:34:21 -0400
commiteecd611f678febabe1d62d5cf9b0bc152caf7596 (patch)
tree72c75722a2ceb82ba6418187ad90353dc4121542 /doc
parent41f013578024a1ce558bde4030a0171e2895ed09 (diff)
tags and XRDS
Starting the process of remote subscriptions. First, add the capacity to mint tags. May in the future want to allow some kind of UUID or URL for unique URIs. New config options for tag authority and date, and a function for minting tags. Store URIs in the DB. If the admin changes his/her tag config, this shouldn't change the URIs in the DB. Unless they really want to make that happen. Generate an XRDS document with the appropriate URLs for microblogging. Also, redefined some stuff in openmicroblogging.txt. And moved the file. darcs-hash:20080522183421-84dde-fe46f32e4050f2c4b6c850334103007ed7feabf7.gz
Diffstat (limited to 'doc')
-rw-r--r--doc/README9
-rw-r--r--doc/TODO2
-rw-r--r--doc/openmicroblogging.txt (renamed from doc/openlisten.txt)35
3 files changed, 19 insertions, 27 deletions
diff --git a/doc/README b/doc/README
index 546e4320b..7bde30916 100644
--- a/doc/README
+++ b/doc/README
@@ -3,4 +3,11 @@ This package requires PHP 5.x and the following PHP Pear libraries:
- DB_DataObject
- Validate
- XMLWriter
-
+- Auth_Yadis from OpenIDEnabled (not the PEAR version!). I decided
+ to use the openidenabled.com version since it's more widely
+ implemented, seems to be better supported, and it may make sense to
+ use the openidenabled.com libraries for OpenID auth sometime in the
+ future. Note that this is no longer distributed separately; it's only
+ in the openidenabled.com OpenID PHP tarball.
+
+
diff --git a/doc/TODO b/doc/TODO
index 25f2731ed..c5f692b43 100644
--- a/doc/TODO
+++ b/doc/TODO
@@ -53,6 +53,8 @@
+ public stream link in top menu
+ dump, fix, undump database
+ release 0.2
+- YADIS document link on showstream
+- YADIS document
- subscribe remote
- add subscriber remote
- send remote notice
diff --git a/doc/openlisten.txt b/doc/openmicroblogging.txt
index b3208c24f..77c52a10f 100644
--- a/doc/openlisten.txt
+++ b/doc/openmicroblogging.txt
@@ -69,45 +69,28 @@ Discovery
The remote service recovers a YADIS document from the profile URL, as
described in YADIS 1.0.
-The remote service looks for a service of this type:
+The remote service looks for the URIs of Service of these types:
- http://openmicroblogging.org/protocol/0.1
-
-The service must include the following 5 URLs. [*]_
-
-omb:requestToken
+http://openmicroblogging.org/protocol/0.1/requestToken
Request Token URL, as in OAuth 1.0
-omb:userAuthorization
+http://openmicroblogging.org/protocol/0.1/userAuthorization
User Authorization URL, as in OAuth 1.0
-omb:accessToken
+http://openmicroblogging.org/protocol/0.1/accessToken
Access Token URL, as in OAuth 1.0
-omb:postNotice
+http://openmicroblogging.org/protocol/0.1/postNotice
Post Notice URL, as defined below.
-omb:updateProfile
+http://openmicroblogging.org/protocol/0.1/updateProfile
Update Profile URL, as defined below.
-It must also include the following URI:
-
-omb:identifier
+http://openmicroblogging.org/protocol/0.1/identifier
identifier URI for the user with this profile URL.
-
-Here, omb: is the namespace prefix for:
-
- http://openmicroblogging.org/xmlns/0.1
-
-The YADIS URI defined for the service can be ignored.
-.. [*] I decided to use a separate namespace with 5 elements to enable
- having different providers for general OAuth and specific OµB. A
- future version of this document may have a mode that allows a
- single URL defined in the <URI> element with an additional URL
- parameter like 'action=requesttoken', 'action=userauthorization' or
- something similar. But that simplifies the YADIS doc at the expense
- of the rest of the protocol.
+If any of the URIs is unavailable, the remote service MUST stop
+processing.
Authorization
=============