diff --git a/api-changes-1.1.1/CHANGES b/api-changes-1.1.1/CHANGES index 424cbba..853ee63 100644 --- a/api-changes-1.1.1/CHANGES +++ b/api-changes-1.1.1/CHANGES @@ -5,6 +5,7 @@ * actions/apistatusesfavs.php New api action * actions/apicheckhub.php New api action (not used yet) * actions/apiexternalprofileshow.php New api action + * actions/apigroupadmins.php New api action * lib/apiaction.php @@ -79,7 +80,12 @@ array('action' => 'ApiCheckHub')); $m->connect('api/externalprofile/show.json', - array('action' => 'ApiExternalProfileShow')); + array('action' => 'ApiExternalProfileShow')); + + $m->connect('api/statusnet/groups/admins/:id.:format', + array('action' => 'ApiGroupAdmins', + 'id' => Nickname::INPUT_FMT, + 'format' => '(xml|json)')); - also, tags need regexp to work with unicode charachters, e.g. farsi and arabic: diff --git a/api-changes-1.1.1/actions/apigroupadmins.php b/api-changes-1.1.1/actions/apigroupadmins.php new file mode 100644 index 0000000..089a486 --- /dev/null +++ b/api-changes-1.1.1/actions/apigroupadmins.php @@ -0,0 +1,193 @@ +. + * + * @category API + * @package StatusNet + * @author Craig Andrews + * @author Evan Prodromou + * @author Jeffery To + * @author Zach Copley + * @author Hannes Mannerheim + * @copyright 2009 StatusNet, Inc. + * @copyright 2009 Free Software Foundation, Inc http://www.fsf.org + * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0 + * @link http://status.net/ + */ + +if (!defined('STATUSNET')) { + exit(1); +} + +require_once INSTALLDIR . '/lib/apiprivateauth.php'; + +/** + * List 20 newest admins of the group specified by name or ID. + * + * @category API + * @package StatusNet + * @author Craig Andrews + * @author Evan Prodromou + * @author Jeffery To + * @author Zach Copley + * @author Hannes Mannerheim + * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0 + * @link http://status.net/ + */ +class ApiGroupAdminsAction extends ApiPrivateAuthAction +{ + var $group = null; + var $profiles = null; + + /** + * Take arguments for running + * + * @param array $args $_REQUEST args + * + * @return boolean success flag + */ + function prepare($args) + { + parent::prepare($args); + + $this->group = $this->getTargetGroup($this->arg('id')); + if (empty($this->group)) { + // TRANS: Client error displayed trying to show group membership on a non-existing group. + $this->clientError(_('Group not found.'), 404, $this->format); + return false; + } + + $this->profiles = $this->getProfiles(); + + return true; + } + + /** + * Handle the request + * + * Show the admin of the group + * + * @param array $args $_REQUEST data (unused) + * + * @return void + */ + function handle($args) + { + parent::handle($args); + + // XXX: RSS and Atom + + switch($this->format) { + case 'xml': + $this->showTwitterXmlUsers($this->profiles); + break; + case 'json': + $this->showJsonUsers($this->profiles); + break; + default: + $this->clientError( + // TRANS: Client error displayed when coming across a non-supported API method. + _('API method not found.'), + 404, + $this->format + ); + break; + } + } + + /** + * Fetch the admins of a group + * + * @return array $profiles list of profiles + */ + function getProfiles() + { + $profiles = array(); + + $profile = $this->group->getAdmins( + ($this->page - 1) * $this->count, + $this->count, + $this->since_id, + $this->max_id + ); + + while ($profile->fetch()) { + $profiles[] = clone($profile); + } + + return $profiles; + } + + /** + * Is this action read only? + * + * @param array $args other arguments + * + * @return boolean true + */ + function isReadOnly($args) + { + return true; + } + + /** + * When was this list of profiles last modified? + * + * @return string datestamp of the lastest profile in the group + */ + function lastModified() + { + if (!empty($this->profiles) && (count($this->profiles) > 0)) { + return strtotime($this->profiles[0]->created); + } + + return null; + } + + /** + * An entity tag for this list of groups + * + * Returns an Etag based on the action name, language + * the group id, and timestamps of the first and last + * user who has joined the group + * + * @return string etag + */ + function etag() + { + if (!empty($this->profiles) && (count($this->profiles) > 0)) { + + $last = count($this->profiles) - 1; + + return '"' . implode( + ':', + array($this->arg('action'), + common_user_cache_hash($this->auth_user), + common_language(), + $this->group->id, + strtotime($this->profiles[0]->created), + strtotime($this->profiles[$last]->created)) + ) + . '"'; + } + + return null; + } +} diff --git a/api-changes-1.1.1/lib/router.php b/api-changes-1.1.1/lib/router.php index cbed72a..268f952 100644 --- a/api-changes-1.1.1/lib/router.php +++ b/api-changes-1.1.1/lib/router.php @@ -463,7 +463,9 @@ class Router array('action' => 'ApiStatusesRetweets', 'id' => '[0-9]+', 'format' => '(xml|json)')); - + + // new qvitter apis + $m->connect('api/statuses/favs/:id.json', array('action' => 'ApiStatusesFavs', 'id' => '[0-9]+')); @@ -476,7 +478,12 @@ class Router array('action' => 'ApiCheckHub')); $m->connect('api/externalprofile/show.json', - array('action' => 'ApiExternalProfileShow')); + array('action' => 'ApiExternalProfileShow')); + + $m->connect('api/statusnet/groups/admins/:id.:format', + array('action' => 'ApiGroupAdmins', + 'id' => Nickname::INPUT_FMT, + 'format' => '(xml|json)')); // users