]> git.mxchange.org Git - quix0rs-gnu-social.git/blob - lib/router.php
Added README
[quix0rs-gnu-social.git] / lib / router.php
1 <?php
2 /**
3  * StatusNet, the distributed open-source microblogging tool
4  *
5  * URL routing utilities
6  *
7  * PHP version 5
8  *
9  * LICENCE: This program is free software: you can redistribute it and/or modify
10  * it under the terms of the GNU Affero General Public License as published by
11  * the Free Software Foundation, either version 3 of the License, or
12  * (at your option) any later version.
13  *
14  * This program is distributed in the hope that it will be useful,
15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17  * GNU Affero General Public License for more details.
18  *
19  * You should have received a copy of the GNU Affero General Public License
20  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
21  *
22  * @category  URL
23  * @package   StatusNet
24  * @author    Evan Prodromou <evan@status.net>
25  * @copyright 2009 StatusNet, Inc.
26  * @license   http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
27  * @link      http://status.net/
28  */
29
30 if (!defined('STATUSNET') && !defined('LACONICA')) {
31     exit(1);
32 }
33
34 require_once 'Net/URL/Mapper.php';
35
36 class StatusNet_URL_Mapper extends Net_URL_Mapper {
37
38     private static $_singleton = null;
39
40     private function __construct()
41     {
42     }
43
44     public static function getInstance($id = '__default__')
45     {
46         if (empty(self::$_singleton)) {
47             self::$_singleton = new StatusNet_URL_Mapper();
48         }
49         return self::$_singleton;
50     }
51
52     public function connect($path, $defaults = array(), $rules = array())
53     {
54         $result = null;
55         if (Event::handle('StartConnectPath', array(&$path, &$defaults, &$rules, &$result))) {
56             $result = parent::connect($path, $defaults, $rules);
57             Event::handle('EndConnectPath', array($path, $defaults, $rules, $result));
58         }
59         return $result;
60     }
61 }
62
63 /**
64  * URL Router
65  *
66  * Cheap wrapper around Net_URL_Mapper
67  *
68  * @category URL
69  * @package  StatusNet
70  * @author   Evan Prodromou <evan@status.net>
71  * @license  http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
72  * @link     http://status.net/
73  */
74
75 class Router
76 {
77     var $m = null;
78     static $inst = null;
79     static $bare = array('requesttoken', 'accesstoken', 'userauthorization',
80                          'postnotice', 'updateprofile', 'finishremotesubscribe');
81
82     static function get()
83     {
84         if (!Router::$inst) {
85             Router::$inst = new Router();
86         }
87         return Router::$inst;
88     }
89
90     function __construct()
91     {
92         if (!$this->m) {
93             $this->m = $this->initialize();
94         }
95     }
96
97     function initialize()
98     {
99         $m = StatusNet_URL_Mapper::getInstance();
100
101         if (Event::handle('StartInitializeRouter', array(&$m))) {
102
103             $m->connect('robots.txt', array('action' => 'robotstxt'));
104
105             $m->connect('opensearch/people', array('action' => 'opensearch',
106                                                    'type' => 'people'));
107             $m->connect('opensearch/notice', array('action' => 'opensearch',
108                                                    'type' => 'notice'));
109
110             // docs
111
112             $m->connect('doc/:title', array('action' => 'doc'));
113
114             $m->connect('main/otp/:user_id/:token',
115                         array('action' => 'otp'),
116                         array('user_id' => '[0-9]+',
117                               'token' => '.+'));
118
119             // main stuff is repetitive
120
121             $main = array('login', 'logout', 'register', 'subscribe',
122                           'unsubscribe', 'confirmaddress', 'recoverpassword',
123                           'invite', 'favor', 'disfavor', 'sup',
124                           'block', 'unblock', 'subedit',
125                           'groupblock', 'groupunblock',
126                           'sandbox', 'unsandbox',
127                           'silence', 'unsilence',
128                           'grantrole', 'revokerole',
129                           'repeat',
130                           'deleteuser',
131                           'geocode',
132                           'version',
133                           );
134
135             foreach ($main as $a) {
136                 $m->connect('main/'.$a, array('action' => $a));
137             }
138
139             // Also need a block variant accepting ID on URL for mail links
140             $m->connect('main/block/:profileid',
141                         array('action' => 'block'),
142                         array('profileid' => '[0-9]+'));
143
144             $m->connect('main/sup/:seconds', array('action' => 'sup'),
145                         array('seconds' => '[0-9]+'));
146
147             $m->connect('main/tagother/:id', array('action' => 'tagother'));
148
149             $m->connect('main/oembed',
150                         array('action' => 'oembed'));
151
152             $m->connect('main/xrds',
153                         array('action' => 'publicxrds'));
154
155             // these take a code
156
157             foreach (array('register', 'confirmaddress', 'recoverpassword') as $c) {
158                 $m->connect('main/'.$c.'/:code', array('action' => $c));
159             }
160
161             // exceptional
162
163             $m->connect('main/remote', array('action' => 'remotesubscribe'));
164             $m->connect('main/remote?nickname=:nickname', array('action' => 'remotesubscribe'), array('nickname' => '[A-Za-z0-9_-]+'));
165
166             foreach (Router::$bare as $action) {
167                 $m->connect('index.php?action=' . $action, array('action' => $action));
168             }
169
170             // settings
171
172             foreach (array('profile', 'avatar', 'password', 'im', 'oauthconnections',
173                            'oauthapps', 'email', 'sms', 'userdesign', 'other') as $s) {
174                 $m->connect('settings/'.$s, array('action' => $s.'settings'));
175             }
176
177             $m->connect('settings/oauthapps/show/:id',
178                 array('action' => 'showapplication'),
179                 array('id' => '[0-9]+')
180             );
181             $m->connect('settings/oauthapps/new',
182                 array('action' => 'newapplication')
183             );
184             $m->connect('settings/oauthapps/edit/:id',
185                 array('action' => 'editapplication'),
186                 array('id' => '[0-9]+')
187             );
188             $m->connect('settings/oauthapps/delete/:id',
189                 array('action' => 'deleteapplication'),
190                 array('id' => '[0-9]+')
191             );
192
193             // search
194
195             foreach (array('group', 'people', 'notice') as $s) {
196                 $m->connect('search/'.$s, array('action' => $s.'search'));
197                 $m->connect('search/'.$s.'?q=:q',
198                             array('action' => $s.'search'),
199                             array('q' => '.+'));
200             }
201
202             // The second of these is needed to make the link work correctly
203             // when inserted into the page. The first is needed to match the
204             // route on the way in. Seems to be another Net_URL_Mapper bug to me.
205             $m->connect('search/notice/rss', array('action' => 'noticesearchrss'));
206             $m->connect('search/notice/rss?q=:q', array('action' => 'noticesearchrss'),
207                         array('q' => '.+'));
208
209             $m->connect('attachment/:attachment',
210                         array('action' => 'attachment'),
211                         array('attachment' => '[0-9]+'));
212
213             $m->connect('attachment/:attachment/ajax',
214                         array('action' => 'attachment_ajax'),
215                         array('attachment' => '[0-9]+'));
216
217             $m->connect('attachment/:attachment/thumbnail',
218                         array('action' => 'attachment_thumbnail'),
219                         array('attachment' => '[0-9]+'));
220
221             $m->connect('notice/new', array('action' => 'newnotice'));
222             $m->connect('notice/new?replyto=:replyto',
223                         array('action' => 'newnotice'),
224                         array('replyto' => '[A-Za-z0-9_-]+'));
225             $m->connect('notice/new?replyto=:replyto&inreplyto=:inreplyto',
226                         array('action' => 'newnotice'),
227                         array('replyto' => '[A-Za-z0-9_-]+'),
228                         array('inreplyto' => '[0-9]+'));
229
230             $m->connect('notice/:notice/file',
231                         array('action' => 'file'),
232                         array('notice' => '[0-9]+'));
233
234             $m->connect('notice/:notice',
235                         array('action' => 'shownotice'),
236                         array('notice' => '[0-9]+'));
237             $m->connect('notice/delete', array('action' => 'deletenotice'));
238             $m->connect('notice/delete/:notice',
239                         array('action' => 'deletenotice'),
240                         array('notice' => '[0-9]+'));
241
242             $m->connect('bookmarklet/new', array('action' => 'bookmarklet'));
243
244             // conversation
245
246             $m->connect('conversation/:id',
247                         array('action' => 'conversation'),
248                         array('id' => '[0-9]+'));
249
250             $m->connect('message/new', array('action' => 'newmessage'));
251             $m->connect('message/new?to=:to', array('action' => 'newmessage'), array('to' => '[A-Za-z0-9_-]+'));
252             $m->connect('message/:message',
253                         array('action' => 'showmessage'),
254                         array('message' => '[0-9]+'));
255
256             $m->connect('user/:id',
257                         array('action' => 'userbyid'),
258                         array('id' => '[0-9]+'));
259
260             $m->connect('tags/', array('action' => 'publictagcloud'));
261             $m->connect('tag/', array('action' => 'publictagcloud'));
262             $m->connect('tags', array('action' => 'publictagcloud'));
263             $m->connect('tag', array('action' => 'publictagcloud'));
264             $m->connect('tag/:tag/rss',
265                         array('action' => 'tagrss'),
266                         array('tag' => '[\pL\pN_\-\.]{1,64}'));
267             $m->connect('tag/:tag',
268                         array('action' => 'tag'),
269                         array('tag' => '[\pL\pN_\-\.]{1,64}'));
270
271             $m->connect('peopletag/:tag',
272                         array('action' => 'peopletag'),
273                         array('tag' => '[a-zA-Z0-9]+'));
274
275             // groups
276
277             $m->connect('group/new', array('action' => 'newgroup'));
278
279             foreach (array('edit', 'join', 'leave') as $v) {
280                 $m->connect('group/:nickname/'.$v,
281                             array('action' => $v.'group'),
282                             array('nickname' => '[a-zA-Z0-9]+'));
283                 $m->connect('group/:id/id/'.$v,
284                             array('action' => $v.'group'),
285                             array('id' => '[0-9]+'));
286             }
287
288             foreach (array('members', 'logo', 'rss', 'designsettings') as $n) {
289                 $m->connect('group/:nickname/'.$n,
290                             array('action' => 'group'.$n),
291                             array('nickname' => '[a-zA-Z0-9]+'));
292             }
293
294             $m->connect('group/:nickname/foaf',
295                         array('action' => 'foafgroup'),
296                         array('nickname' => '[a-zA-Z0-9]+'));
297
298             $m->connect('group/:nickname/blocked',
299                         array('action' => 'blockedfromgroup'),
300                         array('nickname' => '[a-zA-Z0-9]+'));
301
302             $m->connect('group/:nickname/makeadmin',
303                         array('action' => 'makeadmin'),
304                         array('nickname' => '[a-zA-Z0-9]+'));
305
306             $m->connect('group/:id/id',
307                         array('action' => 'groupbyid'),
308                         array('id' => '[0-9]+'));
309
310             $m->connect('group/:nickname',
311                         array('action' => 'showgroup'),
312                         array('nickname' => '[a-zA-Z0-9]+'));
313
314             $m->connect('group/', array('action' => 'groups'));
315             $m->connect('group', array('action' => 'groups'));
316             $m->connect('groups/', array('action' => 'groups'));
317             $m->connect('groups', array('action' => 'groups'));
318
319             // Twitter-compatible API
320
321             // statuses API
322
323             $m->connect('api/statuses/public_timeline.:format',
324                         array('action' => 'ApiTimelinePublic',
325                               'format' => '(xml|json|rss|atom)'));
326
327             $m->connect('api/statuses/friends_timeline.:format',
328                         array('action' => 'ApiTimelineFriends',
329                               'format' => '(xml|json|rss|atom)'));
330
331             $m->connect('api/statuses/friends_timeline/:id.:format',
332                         array('action' => 'ApiTimelineFriends',
333                               'id' => '[a-zA-Z0-9]+',
334                               'format' => '(xml|json|rss|atom)'));
335
336             $m->connect('api/statuses/home_timeline.:format',
337                         array('action' => 'ApiTimelineHome',
338                               'format' => '(xml|json|rss|atom)'));
339
340             $m->connect('api/statuses/home_timeline/:id.:format',
341                         array('action' => 'ApiTimelineHome',
342                               'id' => '[a-zA-Z0-9]+',
343                               'format' => '(xml|json|rss|atom)'));
344
345             $m->connect('api/statuses/user_timeline.:format',
346                         array('action' => 'ApiTimelineUser',
347                               'format' => '(xml|json|rss|atom)'));
348
349             $m->connect('api/statuses/user_timeline/:id.:format',
350                         array('action' => 'ApiTimelineUser',
351                               'id' => '[a-zA-Z0-9]+',
352                               'format' => '(xml|json|rss|atom)'));
353
354             $m->connect('api/statuses/mentions.:format',
355                         array('action' => 'ApiTimelineMentions',
356                               'format' => '(xml|json|rss|atom)'));
357
358             $m->connect('api/statuses/mentions/:id.:format',
359                         array('action' => 'ApiTimelineMentions',
360                               'id' => '[a-zA-Z0-9]+',
361                               'format' => '(xml|json|rss|atom)'));
362
363             $m->connect('api/statuses/replies.:format',
364                         array('action' => 'ApiTimelineMentions',
365                               'format' => '(xml|json|rss|atom)'));
366
367             $m->connect('api/statuses/replies/:id.:format',
368                         array('action' => 'ApiTimelineMentions',
369                               'id' => '[a-zA-Z0-9]+',
370                               'format' => '(xml|json|rss|atom)'));
371
372             $m->connect('api/statuses/retweeted_by_me.:format',
373                         array('action' => 'ApiTimelineRetweetedByMe',
374                               'format' => '(xml|json|atom)'));
375
376             $m->connect('api/statuses/retweeted_to_me.:format',
377                         array('action' => 'ApiTimelineRetweetedToMe',
378                               'format' => '(xml|json|atom)'));
379
380             $m->connect('api/statuses/retweets_of_me.:format',
381                         array('action' => 'ApiTimelineRetweetsOfMe',
382                               'format' => '(xml|json|atom)'));
383
384             $m->connect('api/statuses/friends.:format',
385                         array('action' => 'ApiUserFriends',
386                               'format' => '(xml|json)'));
387
388             $m->connect('api/statuses/friends/:id.:format',
389                         array('action' => 'ApiUserFriends',
390                               'id' => '[a-zA-Z0-9]+',
391                               'format' => '(xml|json)'));
392
393             $m->connect('api/statuses/followers.:format',
394                         array('action' => 'ApiUserFollowers',
395                               'format' => '(xml|json)'));
396
397             $m->connect('api/statuses/followers/:id.:format',
398                         array('action' => 'ApiUserFollowers',
399                               'id' => '[a-zA-Z0-9]+',
400                               'format' => '(xml|json)'));
401
402             $m->connect('api/statuses/show.:format',
403                         array('action' => 'ApiStatusesShow',
404                               'format' => '(xml|json)'));
405
406             $m->connect('api/statuses/show/:id.:format',
407                         array('action' => 'ApiStatusesShow',
408                               'id' => '[0-9]+',
409                               'format' => '(xml|json)'));
410
411             $m->connect('api/statuses/update.:format',
412                         array('action' => 'ApiStatusesUpdate',
413                               'format' => '(xml|json)'));
414
415             $m->connect('api/statuses/destroy.:format',
416                         array('action' => 'ApiStatusesDestroy',
417                               'format' => '(xml|json)'));
418
419             $m->connect('api/statuses/destroy/:id.:format',
420                         array('action' => 'ApiStatusesDestroy',
421                               'id' => '[0-9]+',
422                               'format' => '(xml|json)'));
423
424             $m->connect('api/statuses/retweet/:id.:format',
425                         array('action' => 'ApiStatusesRetweet',
426                               'id' => '[0-9]+',
427                               'format' => '(xml|json)'));
428
429             $m->connect('api/statuses/retweets/:id.:format',
430                         array('action' => 'ApiStatusesRetweets',
431                               'id' => '[0-9]+',
432                               'format' => '(xml|json)'));
433
434             // users
435
436             $m->connect('api/users/show.:format',
437                         array('action' => 'ApiUserShow',
438                               'format' => '(xml|json)'));
439
440             $m->connect('api/users/show/:id.:format',
441                         array('action' => 'ApiUserShow',
442                               'id' => '[a-zA-Z0-9]+',
443                               'format' => '(xml|json)'));
444
445             // direct messages
446
447             $m->connect('api/direct_messages.:format',
448                         array('action' => 'ApiDirectMessage',
449                               'format' => '(xml|json|rss|atom)'));
450
451             $m->connect('api/direct_messages/sent.:format',
452                         array('action' => 'ApiDirectMessage',
453                               'format' => '(xml|json|rss|atom)',
454                               'sent' => true));
455
456             $m->connect('api/direct_messages/new.:format',
457                         array('action' => 'ApiDirectMessageNew',
458                               'format' => '(xml|json)'));
459
460             // friendships
461
462             $m->connect('api/friendships/show.:format',
463                         array('action' => 'ApiFriendshipsShow',
464                               'format' => '(xml|json)'));
465
466             $m->connect('api/friendships/exists.:format',
467                         array('action' => 'ApiFriendshipsExists',
468                               'format' => '(xml|json)'));
469
470             $m->connect('api/friendships/create.:format',
471                         array('action' => 'ApiFriendshipsCreate',
472                               'format' => '(xml|json)'));
473
474             $m->connect('api/friendships/destroy.:format',
475                         array('action' => 'ApiFriendshipsDestroy',
476                               'format' => '(xml|json)'));
477
478             $m->connect('api/friendships/create/:id.:format',
479                         array('action' => 'ApiFriendshipsCreate',
480                               'id' => '[a-zA-Z0-9]+',
481                               'format' => '(xml|json)'));
482
483             $m->connect('api/friendships/destroy/:id.:format',
484                         array('action' => 'ApiFriendshipsDestroy',
485                               'id' => '[a-zA-Z0-9]+',
486                               'format' => '(xml|json)'));
487
488             // Social graph
489
490             $m->connect('api/friends/ids/:id.:format',
491                         array('action' => 'apiuserfriends',
492                               'ids_only' => true));
493
494             $m->connect('api/followers/ids/:id.:format',
495                         array('action' => 'apiuserfollowers',
496                               'ids_only' => true));
497
498             $m->connect('api/friends/ids.:format',
499                         array('action' => 'apiuserfriends',
500                               'ids_only' => true));
501
502             $m->connect('api/followers/ids.:format',
503                         array('action' => 'apiuserfollowers',
504                               'ids_only' => true));
505
506             // account
507
508             $m->connect('api/account/verify_credentials.:format',
509                         array('action' => 'ApiAccountVerifyCredentials'));
510
511             $m->connect('api/account/update_profile.:format',
512                         array('action' => 'ApiAccountUpdateProfile'));
513
514             $m->connect('api/account/update_profile_image.:format',
515                         array('action' => 'ApiAccountUpdateProfileImage'));
516
517             $m->connect('api/account/update_profile_background_image.:format',
518                         array('action' => 'ApiAccountUpdateProfileBackgroundImage'));
519
520             $m->connect('api/account/update_profile_colors.:format',
521                         array('action' => 'ApiAccountUpdateProfileColors'));
522
523             $m->connect('api/account/update_delivery_device.:format',
524                         array('action' => 'ApiAccountUpdateDeliveryDevice'));
525
526             // special case where verify_credentials is called w/out a format
527
528             $m->connect('api/account/verify_credentials',
529                         array('action' => 'ApiAccountVerifyCredentials'));
530
531             $m->connect('api/account/rate_limit_status.:format',
532                         array('action' => 'ApiAccountRateLimitStatus'));
533
534             // favorites
535
536             $m->connect('api/favorites.:format',
537                         array('action' => 'ApiTimelineFavorites',
538                               'format' => '(xml|json|rss|atom)'));
539
540             $m->connect('api/favorites/:id.:format',
541                         array('action' => 'ApiTimelineFavorites',
542                               'id' => '[a-zA-Z0-9]+',
543                               'format' => '(xml|json|rss|atom)'));
544
545             $m->connect('api/favorites/create/:id.:format',
546                         array('action' => 'ApiFavoriteCreate',
547                               'id' => '[a-zA-Z0-9]+',
548                               'format' => '(xml|json)'));
549
550             $m->connect('api/favorites/destroy/:id.:format',
551                         array('action' => 'ApiFavoriteDestroy',
552                               'id' => '[a-zA-Z0-9]+',
553                               'format' => '(xml|json)'));
554             // blocks
555
556             $m->connect('api/blocks/create/:id.:format',
557                         array('action' => 'ApiBlockCreate',
558                               'id' => '[a-zA-Z0-9]+',
559                               'format' => '(xml|json)'));
560
561             $m->connect('api/blocks/destroy/:id.:format',
562                         array('action' => 'ApiBlockDestroy',
563                               'id' => '[a-zA-Z0-9]+',
564                               'format' => '(xml|json)'));
565             // help
566
567             $m->connect('api/help/test.:format',
568                         array('action' => 'ApiHelpTest',
569                               'format' => '(xml|json)'));
570
571             // statusnet
572
573             $m->connect('api/statusnet/version.:format',
574                         array('action' => 'ApiStatusnetVersion',
575                               'format' => '(xml|json)'));
576
577             $m->connect('api/statusnet/config.:format',
578                         array('action' => 'ApiStatusnetConfig',
579                               'format' => '(xml|json)'));
580
581             // For older methods, we provide "laconica" base action
582
583             $m->connect('api/laconica/version.:format',
584                         array('action' => 'ApiStatusnetVersion',
585                               'format' => '(xml|json)'));
586
587             $m->connect('api/laconica/config.:format',
588                         array('action' => 'ApiStatusnetConfig',
589                               'format' => '(xml|json)'));
590
591             // Groups and tags are newer than 0.8.1 so no backward-compatibility
592             // necessary
593
594             // Groups
595             //'list' has to be handled differently, as php will not allow a method to be named 'list'
596
597             $m->connect('api/statusnet/groups/timeline/:id.:format',
598                         array('action' => 'ApiTimelineGroup',
599                               'id' => '[a-zA-Z0-9]+',
600                               'format' => '(xml|json|rss|atom)'));
601
602             $m->connect('api/statusnet/groups/show.:format',
603                         array('action' => 'ApiGroupShow',
604                               'format' => '(xml|json)'));
605
606             $m->connect('api/statusnet/groups/show/:id.:format',
607                         array('action' => 'ApiGroupShow',
608                               'id' => '[a-zA-Z0-9]+',
609                               'format' => '(xml|json)'));
610
611             $m->connect('api/statusnet/groups/join.:format',
612                         array('action' => 'ApiGroupJoin',
613                               'id' => '[a-zA-Z0-9]+',
614                               'format' => '(xml|json)'));
615
616             $m->connect('api/statusnet/groups/join/:id.:format',
617                         array('action' => 'ApiGroupJoin',
618                               'format' => '(xml|json)'));
619
620             $m->connect('api/statusnet/groups/leave.:format',
621                         array('action' => 'ApiGroupLeave',
622                               'id' => '[a-zA-Z0-9]+',
623                               'format' => '(xml|json)'));
624
625             $m->connect('api/statusnet/groups/leave/:id.:format',
626                         array('action' => 'ApiGroupLeave',
627                               'format' => '(xml|json)'));
628
629             $m->connect('api/statusnet/groups/is_member.:format',
630                         array('action' => 'ApiGroupIsMember',
631                               'format' => '(xml|json)'));
632
633             $m->connect('api/statusnet/groups/list.:format',
634                         array('action' => 'ApiGroupList',
635                               'format' => '(xml|json|rss|atom)'));
636
637             $m->connect('api/statusnet/groups/list/:id.:format',
638                         array('action' => 'ApiGroupList',
639                               'id' => '[a-zA-Z0-9]+',
640                               'format' => '(xml|json|rss|atom)'));
641
642             $m->connect('api/statusnet/groups/list_all.:format',
643                         array('action' => 'ApiGroupListAll',
644                               'format' => '(xml|json|rss|atom)'));
645
646             $m->connect('api/statusnet/groups/membership.:format',
647                         array('action' => 'ApiGroupMembership',
648                               'format' => '(xml|json)'));
649
650             $m->connect('api/statusnet/groups/membership/:id.:format',
651                         array('action' => 'ApiGroupMembership',
652                               'id' => '[a-zA-Z0-9]+',
653                               'format' => '(xml|json)'));
654
655             $m->connect('api/statusnet/groups/create.:format',
656                         array('action' => 'ApiGroupCreate',
657                               'format' => '(xml|json)'));
658
659             $m->connect('api/statusnet/groups/update/:id.:format',
660                         array('action' => 'ApiGroupProfileUpdate',
661                               'id' => '[a-zA-Z0-9]+',
662                               'format' => '(xml|json)'));
663
664             // Tags
665             $m->connect('api/statusnet/tags/timeline/:tag.:format',
666                         array('action' => 'ApiTimelineTag',
667                               'format' => '(xml|json|rss|atom)'));
668
669             // media related
670             $m->connect(
671                 'api/statusnet/media/upload',
672                 array('action' => 'ApiMediaUpload')
673             );
674
675             // search
676             $m->connect('api/search.atom', array('action' => 'ApiSearchAtom'));
677             $m->connect('api/search.json', array('action' => 'ApiSearchJSON'));
678             $m->connect('api/trends.json', array('action' => 'ApiTrends'));
679
680             $m->connect('api/oauth/request_token',
681                         array('action' => 'apioauthrequesttoken'));
682
683             $m->connect('api/oauth/access_token',
684                         array('action' => 'apioauthaccesstoken'));
685
686             $m->connect('api/oauth/authorize',
687                         array('action' => 'apioauthauthorize'));
688
689             // Admin
690
691             $m->connect('admin/site', array('action' => 'siteadminpanel'));
692             $m->connect('admin/design', array('action' => 'designadminpanel'));
693             $m->connect('admin/user', array('action' => 'useradminpanel'));
694                 $m->connect('admin/access', array('action' => 'accessadminpanel'));
695             $m->connect('admin/paths', array('action' => 'pathsadminpanel'));
696             $m->connect('admin/sessions', array('action' => 'sessionsadminpanel'));
697             $m->connect('admin/sitenotice', array('action' => 'sitenoticeadminpanel'));
698             $m->connect('admin/snapshot', array('action' => 'snapshotadminpanel'));
699             $m->connect('admin/plugins', array('action' => 'pluginsadminpanel'));
700             $m->connect('admin/plugins/enable/:plugin',
701                         array('action' => 'pluginenable'),
702                         array('plugin' => '[A-Za-z0-9_]+'));
703             $m->connect('admin/plugins/disable/:plugin',
704                         array('action' => 'plugindisable'),
705                         array('plugin' => '[A-Za-z0-9_]+'));
706
707             $m->connect('getfile/:filename',
708                         array('action' => 'getfile'),
709                         array('filename' => '[A-Za-z0-9._-]+'));
710
711             // In the "root"
712
713             if (common_config('singleuser', 'enabled')) {
714
715                 $user = User::siteOwner();
716
717                 if (!empty($user)) {
718                     $nickname = $user->nickname;
719                 } else {
720                     $nickname = common_config('singleuser', 'nickname');
721                     if (empty($nickname)) {
722                         throw new ServerException(_("No single user defined for single-user mode."));
723                     }
724                 }
725
726                 foreach (array('subscriptions', 'subscribers',
727                                'all', 'foaf', 'xrds',
728                                'replies', 'microsummary', 'hcard') as $a) {
729                     $m->connect($a,
730                                 array('action' => $a,
731                                       'nickname' => $nickname));
732                 }
733
734                 foreach (array('subscriptions', 'subscribers') as $a) {
735                     $m->connect($a.'/:tag',
736                                 array('action' => $a,
737                                       'nickname' => $nickname),
738                                 array('tag' => '[a-zA-Z0-9]+'));
739                 }
740
741                 foreach (array('rss', 'groups') as $a) {
742                     $m->connect($a,
743                                 array('action' => 'user'.$a,
744                                       'nickname' => $nickname));
745                 }
746
747                 foreach (array('all', 'replies', 'favorites') as $a) {
748                     $m->connect($a.'/rss',
749                                 array('action' => $a.'rss',
750                                       'nickname' => $nickname));
751                 }
752
753                 $m->connect('favorites',
754                             array('action' => 'showfavorites',
755                                   'nickname' => $nickname));
756
757                 $m->connect('avatar/:size',
758                             array('action' => 'avatarbynickname',
759                                   'nickname' => $nickname),
760                             array('size' => '(original|96|48|24)'));
761
762                 $m->connect('tag/:tag/rss',
763                             array('action' => 'userrss',
764                                   'nickname' => $nickname),
765                             array('tag' => '[\pL\pN_\-\.]{1,64}'));
766
767                 $m->connect('tag/:tag',
768                             array('action' => 'showstream',
769                                   'nickname' => $nickname),
770                             array('tag' => '[\pL\pN_\-\.]{1,64}'));
771
772                 $m->connect('rsd.xml',
773                             array('action' => 'rsd',
774                                   'nickname' => $nickname));
775
776                 $m->connect('',
777                             array('action' => 'showstream',
778                                   'nickname' => $nickname));
779
780             } else {
781
782                 $m->connect('', array('action' => 'public'));
783                 $m->connect('rss', array('action' => 'publicrss'));
784                 $m->connect('featuredrss', array('action' => 'featuredrss'));
785                 $m->connect('favoritedrss', array('action' => 'favoritedrss'));
786                 $m->connect('featured/', array('action' => 'featured'));
787                 $m->connect('featured', array('action' => 'featured'));
788                 $m->connect('favorited/', array('action' => 'favorited'));
789                 $m->connect('favorited', array('action' => 'favorited'));
790                 $m->connect('rsd.xml', array('action' => 'rsd'));
791
792                 foreach (array('subscriptions', 'subscribers',
793                                'nudge', 'all', 'foaf', 'xrds',
794                                'replies', 'inbox', 'outbox', 'microsummary', 'hcard') as $a) {
795                     $m->connect(':nickname/'.$a,
796                                 array('action' => $a),
797                                 array('nickname' => '[a-zA-Z0-9]{1,64}'));
798                 }
799
800                 foreach (array('subscriptions', 'subscribers') as $a) {
801                     $m->connect(':nickname/'.$a.'/:tag',
802                                 array('action' => $a),
803                                 array('tag' => '[a-zA-Z0-9]+',
804                                       'nickname' => '[a-zA-Z0-9]{1,64}'));
805                 }
806
807                 foreach (array('rss', 'groups') as $a) {
808                     $m->connect(':nickname/'.$a,
809                                 array('action' => 'user'.$a),
810                                 array('nickname' => '[a-zA-Z0-9]{1,64}'));
811                 }
812
813                 foreach (array('all', 'replies', 'favorites') as $a) {
814                     $m->connect(':nickname/'.$a.'/rss',
815                                 array('action' => $a.'rss'),
816                                 array('nickname' => '[a-zA-Z0-9]{1,64}'));
817                 }
818
819                 $m->connect(':nickname/favorites',
820                             array('action' => 'showfavorites'),
821                             array('nickname' => '[a-zA-Z0-9]{1,64}'));
822
823                 $m->connect(':nickname/avatar/:size',
824                             array('action' => 'avatarbynickname'),
825                             array('size' => '(original|96|48|24)',
826                                   'nickname' => '[a-zA-Z0-9]{1,64}'));
827
828                 $m->connect(':nickname/tag/:tag/rss',
829                             array('action' => 'userrss'),
830                             array('nickname' => '[a-zA-Z0-9]{1,64}'),
831                             array('tag' => '[\pL\pN_\-\.]{1,64}'));
832
833                 $m->connect(':nickname/tag/:tag',
834                             array('action' => 'showstream'),
835                             array('nickname' => '[a-zA-Z0-9]{1,64}'),
836                             array('tag' => '[\pL\pN_\-\.]{1,64}'));
837
838                 $m->connect(':nickname/rsd.xml',
839                             array('action' => 'rsd'),
840                             array('nickname' => '[a-zA-Z0-9]{1,64}'));
841
842                 $m->connect(':nickname',
843                             array('action' => 'showstream'),
844                             array('nickname' => '[a-zA-Z0-9]{1,64}'));
845             }
846
847             // user stuff
848
849             Event::handle('RouterInitialized', array($m));
850         }
851
852         return $m;
853     }
854
855     function map($path)
856     {
857         try {
858             $match = $this->m->match($path);
859         } catch (Net_URL_Mapper_InvalidException $e) {
860             common_log(LOG_ERR, "Problem getting route for $path - " .
861                        $e->getMessage());
862             $cac = new ClientErrorAction("Page not found.", 404);
863             $cac->showPage();
864         }
865
866         return $match;
867     }
868
869     function build($action, $args=null, $params=null, $fragment=null)
870     {
871         $action_arg = array('action' => $action);
872
873         if ($args) {
874             $args = array_merge($action_arg, $args);
875         } else {
876             $args = $action_arg;
877         }
878
879         $url = $this->m->generate($args, $params, $fragment);
880
881         // Due to a bug in the Net_URL_Mapper code, the returned URL may
882         // contain a malformed query of the form ?p1=v1?p2=v2?p3=v3. We
883         // repair that here rather than modifying the upstream code...
884
885         $qpos = strpos($url, '?');
886         if ($qpos !== false) {
887             $url = substr($url, 0, $qpos+1) .
888               str_replace('?', '&', substr($url, $qpos+1));
889         }
890         return $url;
891     }
892 }