More doc comments on SN_YammerClient

This commit is contained in:
Brion Vibber 2010-09-22 17:53:38 -07:00
parent 472dab4a86
commit e8526b2e1f
1 changed files with 10 additions and 1 deletions

View File

@ -139,8 +139,11 @@ class SN_YammerClient
} }
/** /**
* Encode a key-value pair for use in an authentication header.
*
* @param string $key * @param string $key
* @param string $val * @param string $val
* @return string
*/ */
protected function authHeaderChunk($key, $val) protected function authHeaderChunk($key, $val)
{ {
@ -148,6 +151,9 @@ class SN_YammerClient
} }
/** /**
* Ask the Yammer server for a request token, which can be passed on
* to authorizeUrl() for the user to start the authentication process.
*
* @return array of oauth return data; should contain nice things * @return array of oauth return data; should contain nice things
*/ */
public function requestToken() public function requestToken()
@ -162,6 +168,9 @@ class SN_YammerClient
} }
/** /**
* Get a final access token from the verifier/PIN code provided to
* the user from Yammer's auth pages.
*
* @return array of oauth return data; should contain nice things * @return array of oauth return data; should contain nice things
*/ */
public function accessToken($verifier) public function accessToken($verifier)
@ -175,7 +184,7 @@ class SN_YammerClient
} }
/** /**
* Give the URL to send users to to authorize a new app setup * Give the URL to send users to to authorize a new app setup.
* *
* @param string $token as returned from accessToken() * @param string $token as returned from accessToken()
* @return string URL * @return string URL