3 * StatusNet - the distributed open-source microblogging tool
4 * Copyright (C) 2010, StatusNet, Inc.
6 * A sample module to show best practices for StatusNet plugins
10 * This program is free software: you can redistribute it and/or modify
11 * it under the terms of the GNU Affero General Public License as published by
12 * the Free Software Foundation, either version 3 of the License, or
13 * (at your option) any later version.
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU Affero General Public License for more details.
20 * You should have received a copy of the GNU Affero General Public License
21 * along with this program. If not, see <http://www.gnu.org/licenses/>.
24 * @author James Walker <james@status.net>
25 * @copyright 2010 StatusNet, Inc.
26 * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html AGPL 3.0
27 * @link http://status.net/
30 define('WEBFINGER_SERVICE_REL_VALUE', 'lrdd');
33 * Implement the webfinger protocol.
38 const PROFILEPAGE = 'http://webfinger.net/rel/profile-page';
39 const UPDATESFROM = 'http://schemas.google.com/g/2010#updates-from';
42 * Perform a webfinger lookup given an account.
45 public function lookup($id)
47 $id = $this->normalize($id);
48 list($name, $domain) = explode('@', $id);
50 $links = $this->getServiceLinks($domain);
56 foreach ($links as $link) {
57 if ($link['template']) {
58 return $this->getServiceDescription($link['template'], $id);
61 return $this->getServiceDescription($link['href'], $id);
67 * Normalize an account ID
69 function normalize($id)
71 if (substr($id, 0, 7) == 'acct://') {
72 return substr($id, 7);
73 } else if (substr($id, 0, 5) == 'acct:') {
74 return substr($id, 5);
80 function getServiceLinks($domain)
82 $url = 'http://'. $domain .'/.well-known/host-meta';
83 $content = $this->fetchURL($url);
84 if (empty($content)) {
85 common_log(LOG_DEBUG, 'Error fetching host-meta');
88 $result = XRD::parse($content);
90 // Ensure that the host == domain (spec may include signing later)
91 if ($result->host != $domain) {
96 foreach ($result->links as $link) {
97 if ($link['rel'] == WEBFINGER_SERVICE_REL_VALUE) {
105 function getServiceDescription($template, $id)
107 $url = $this->applyTemplate($template, 'acct:' . $id);
109 $content = $this->fetchURL($url);
115 return XRD::parse($content);
118 function fetchURL($url)
121 $client = new HTTPClient();
122 $response = $client->get($url);
123 } catch (HTTP_Request2_Exception $e) {
127 if ($response->getStatus() != 200) {
131 return $response->getBody();
134 function applyTemplate($template, $id)
136 $template = str_replace('{uri}', urlencode($id), $template);
141 function getHostMeta($domain, $template) {
143 $xrd->host = $domain;
144 $xrd->links[] = array('rel' => 'lrdd',
145 'template' => $template,
146 'title' => array('Resource Descriptor'));
148 return $xrd->toXML();