]> git.mxchange.org Git - friendica.git/blob - boot.php
better mailing list support, email addr can be either 'from' or 'to'
[friendica.git] / boot.php
1 <?php
2
3 set_time_limit(0);
4 ini_set('pcre.backtrack_limit', 250000);
5
6
7 define ( 'FRIENDIKA_VERSION',      '2.2.985' );
8 define ( 'DFRN_PROTOCOL_VERSION',  '2.21'    );
9 define ( 'DB_UPDATE_VERSION',      1054      );
10
11 define ( 'EOL',                    "<br />\r\n"     );
12 define ( 'ATOM_TIME',              'Y-m-d\TH:i:s\Z' );
13 define ( 'DOWN_ARROW',             '&#x21e9;'       );
14
15 /**
16  *
17  * Image storage quality. Lower numbers save space at cost of image detail.
18  * For ease of upgrade, please do not change here. Change jpeg quality with 
19  * set_config('system','jpeg_quality',n) in .htconfig.php
20  * where n is netween 1 and 100, and with very poor results below about 50 
21  *
22  */
23
24 define ( 'JPEG_QUALITY',            100  );         
25
26 /**
27  * SSL redirection policies
28  */
29
30 define ( 'SSL_POLICY_NONE',         0 );
31 define ( 'SSL_POLICY_FULL',         1 );
32 define ( 'SSL_POLICY_SELFSIGN',     2 );
33
34
35 /**
36  * log levels
37  */
38
39 define ( 'LOGGER_NORMAL',          0 );
40 define ( 'LOGGER_TRACE',           1 );
41 define ( 'LOGGER_DEBUG',           2 );
42 define ( 'LOGGER_DATA',            3 );
43 define ( 'LOGGER_ALL',             4 );
44
45 /**
46  * registration policies
47  */
48
49 define ( 'REGISTER_CLOSED',        0 );
50 define ( 'REGISTER_APPROVE',       1 );
51 define ( 'REGISTER_OPEN',          2 );
52
53 /**
54  * relationship types
55  * When used in contact records, this indicates that 'uid' has 
56  * this relationship with contact['name']
57  */
58
59 define ( 'REL_VIP',        1);
60 define ( 'REL_FAN',        2);
61 define ( 'REL_BUD',        3);
62
63 /**
64  * Hook array order
65  */
66  
67 define ( 'HOOK_HOOK',      0);
68 define ( 'HOOK_FILE',      1);
69 define ( 'HOOK_FUNCTION',  2);
70
71 /**
72  *
73  * page/profile types
74  *
75  * PAGE_NORMAL is a typical personal profile account
76  * PAGE_SOAPBOX automatically approves all friend requests as REL_FAN, (readonly)
77  * PAGE_COMMUNITY automatically approves all friend requests as REL_FAN, but with 
78  *      write access to wall and comments (no email and not included in page owner's ACL lists)
79  * PAGE_FREELOVE automatically approves all friend requests as full friends (REL_BUD). 
80  *
81  */
82
83 define ( 'PAGE_NORMAL',            0 );
84 define ( 'PAGE_SOAPBOX',           1 );
85 define ( 'PAGE_COMMUNITY',         2 );
86 define ( 'PAGE_FREELOVE',          3 );
87
88 /**
89  * Network and protocol family types 
90  */
91
92 define ( 'NETWORK_DFRN',             'dfrn');    // Friendika, Mistpark, other DFRN implementations
93 define ( 'NETWORK_OSTATUS',          'stat');    // status.net, identi.ca, GNU-social, other OStatus implementations
94 define ( 'NETWORK_FEED',             'feed');    // RSS/Atom feeds with no known "post/notify" protocol
95 define ( 'NETWORK_DIASPORA',         'dspr');    // Diaspora
96 define ( 'NETWORK_MAIL',             'mail');    // IMAP/POP
97 define ( 'NETWORK_FACEBOOK',         'face');    // Facebook API     
98
99
100 /**
101  * Maximum number of "people who like (or don't like) this"  that we will list by name
102  */
103
104 define ( 'MAX_LIKERS',    75);
105
106 /**
107  * email notification options
108  */
109
110 define ( 'NOTIFY_INTRO',   0x0001 );
111 define ( 'NOTIFY_CONFIRM', 0x0002 );
112 define ( 'NOTIFY_WALL',    0x0004 );
113 define ( 'NOTIFY_COMMENT', 0x0008 );
114 define ( 'NOTIFY_MAIL',    0x0010 );
115
116 /**
117  * various namespaces we may need to parse
118  */
119
120 define ( 'NAMESPACE_DFRN' ,           'http://purl.org/macgirvin/dfrn/1.0' ); 
121 define ( 'NAMESPACE_THREAD' ,         'http://purl.org/syndication/thread/1.0' );
122 define ( 'NAMESPACE_TOMB' ,           'http://purl.org/atompub/tombstones/1.0' );
123 define ( 'NAMESPACE_ACTIVITY',        'http://activitystrea.ms/spec/1.0/' );
124 define ( 'NAMESPACE_ACTIVITY_SCHEMA', 'http://activitystrea.ms/schema/1.0/' );
125 define ( 'NAMESPACE_MEDIA',           'http://purl.org/syndication/atommedia' );
126 define ( 'NAMESPACE_SALMON_ME',       'http://salmon-protocol.org/ns/magic-env' );
127 define ( 'NAMESPACE_OSTATUSSUB',      'http://ostatus.org/schema/1.0/subscribe' );
128 define ( 'NAMESPACE_GEORSS',          'http://www.georss.org/georss' );
129 define ( 'NAMESPACE_POCO',            'http://portablecontacts.net/spec/1.0' );
130 define ( 'NAMESPACE_FEED',            'http://schemas.google.com/g/2010#updates-from' );
131
132 /**
133  * activity stream defines
134  */
135
136 define ( 'ACTIVITY_LIKE',        NAMESPACE_ACTIVITY_SCHEMA . 'like' );
137 define ( 'ACTIVITY_DISLIKE',     NAMESPACE_DFRN            . '/dislike' );
138 define ( 'ACTIVITY_OBJ_HEART',   NAMESPACE_DFRN            . '/heart' );
139
140 define ( 'ACTIVITY_FRIEND',      NAMESPACE_ACTIVITY_SCHEMA . 'make-friend' );
141 define ( 'ACTIVITY_FOLLOW',      NAMESPACE_ACTIVITY_SCHEMA . 'follow' );
142 define ( 'ACTIVITY_UNFOLLOW',    NAMESPACE_ACTIVITY_SCHEMA . 'stop-following' );
143 define ( 'ACTIVITY_POST',        NAMESPACE_ACTIVITY_SCHEMA . 'post' );
144 define ( 'ACTIVITY_UPDATE',      NAMESPACE_ACTIVITY_SCHEMA . 'update' );
145 define ( 'ACTIVITY_TAG',         NAMESPACE_ACTIVITY_SCHEMA . 'tag' );
146
147 define ( 'ACTIVITY_OBJ_COMMENT', NAMESPACE_ACTIVITY_SCHEMA . 'comment' );
148 define ( 'ACTIVITY_OBJ_NOTE',    NAMESPACE_ACTIVITY_SCHEMA . 'note' );
149 define ( 'ACTIVITY_OBJ_PERSON',  NAMESPACE_ACTIVITY_SCHEMA . 'person' );
150 define ( 'ACTIVITY_OBJ_PHOTO',   NAMESPACE_ACTIVITY_SCHEMA . 'photo' );
151 define ( 'ACTIVITY_OBJ_P_PHOTO', NAMESPACE_ACTIVITY_SCHEMA . 'profile-photo' );
152 define ( 'ACTIVITY_OBJ_ALBUM',   NAMESPACE_ACTIVITY_SCHEMA . 'photo-album' );
153
154 /**
155  * item weight for query ordering
156  */
157
158 define ( 'GRAVITY_PARENT',       0);
159 define ( 'GRAVITY_LIKE',         3);
160 define ( 'GRAVITY_COMMENT',      6);
161
162 /**
163  *
164  * Reverse the effect of magic_quotes_gpc if it is enabled.
165  * Please disable magic_quotes_gpc so we don't have to do this.
166  * See http://php.net/manual/en/security.magicquotes.disabling.php
167  *
168  */
169
170 if (get_magic_quotes_gpc()) {
171     $process = array(&$_GET, &$_POST, &$_COOKIE, &$_REQUEST);
172     while (list($key, $val) = each($process)) {
173         foreach ($val as $k => $v) {
174             unset($process[$key][$k]);
175             if (is_array($v)) {
176                 $process[$key][stripslashes($k)] = $v;
177                 $process[] = &$process[$key][stripslashes($k)];
178             } else {
179                 $process[$key][stripslashes($k)] = stripslashes($v);
180             }
181         }
182     }
183     unset($process);
184 }
185
186 /*
187  * translation system
188  */
189 require_once("include/pgettext.php");
190
191
192 /**
193  *
194  * class: App
195  *
196  * Our main application structure for the life of this page
197  * Primarily deals with the URL that got us here
198  * and tries to make some sense of it, and 
199  * stores our page contents and config storage
200  * and anything else that might need to be passed around 
201  * before we spit the page out. 
202  *
203  */
204
205 if(! class_exists('App')) {
206 class App {
207
208         public  $module_loaded = false;
209         public  $query_string;
210         public  $config;
211         public  $page;
212         public  $profile;
213         public  $user;
214         public  $cid;
215         public  $contact;
216         public  $contacts;
217         public  $page_contact;
218         public  $content;
219         public  $data;
220         public  $error = false;
221         public  $cmd;
222         public  $argv;
223         public  $argc;
224         public  $module;
225         public  $pager;
226         public  $strings;   
227         public  $path;
228         public  $hooks;
229         public  $timezone;
230         public  $interactive = true;
231         public  $plugins;
232         public  $apps;
233         public  $identities;
234
235         private $scheme;
236         private $hostname;
237         private $baseurl;
238         private $db;
239
240         private $curl_code;
241         private $curl_headers;
242
243         function __construct() {
244
245                 $this->config = array();
246                 $this->page = array();
247                 $this->pager= array();
248
249                 $this->query_string = '';
250
251                 $this->scheme = ((isset($_SERVER['HTTPS']) && ($_SERVER['HTTPS']))      ?  'https' : 'http' );
252
253                 if(x($_SERVER,'SERVER_NAME')) {
254                         $this->hostname = $_SERVER['SERVER_NAME'];
255
256                         /** 
257                          * Figure out if we are running at the top of a domain
258                          * or in a sub-directory and adjust accordingly
259                          */
260
261                         $path = trim(dirname($_SERVER['SCRIPT_NAME']),'/\\');
262                         if(isset($path) && strlen($path) && ($path != $this->path))
263                                 $this->path = $path;
264                 }
265
266                 set_include_path("include/$this->hostname" . PATH_SEPARATOR . 'include' . PATH_SEPARATOR . '.' );
267
268                 if((x($_SERVER,'QUERY_STRING')) && substr($_SERVER['QUERY_STRING'],0,2) === "q=")
269                         $this->query_string = substr($_SERVER['QUERY_STRING'],2);
270                 if(x($_GET,'q'))
271                         $this->cmd = trim($_GET['q'],'/\\');
272
273
274
275                 /**
276                  *
277                  * Break the URL path into C style argc/argv style arguments for our
278                  * modules. Given "http://example.com/module/arg1/arg2", $this->argc
279                  * will be 3 (integer) and $this->argv will contain:
280                  *   [0] => 'module'
281                  *   [1] => 'arg1'
282                  *   [2] => 'arg2'
283                  *
284                  *
285                  * There will always be one argument. If provided a naked domain
286                  * URL, $this->argv[0] is set to "home".
287                  *
288                  */
289
290                 $this->argv = explode('/',$this->cmd);
291                 $this->argc = count($this->argv);
292                 if((array_key_exists('0',$this->argv)) && strlen($this->argv[0])) {
293                         $this->module = str_replace(".", "_", $this->argv[0]);
294                 }
295                 else {
296                         $this->module = 'home';
297                 }
298
299                 /**
300                  * Special handling for the webfinger/lrdd host XRD file
301                  * Just spit out the contents and exit.
302                  */
303
304                 if($this->cmd === '.well-known/host-meta') {
305                         require_once('include/hostxrd.php');
306                         hostxrd($this->get_baseurl());
307                         // NOTREACHED
308                 }
309
310                 /**
311                  * See if there is any page number information, and initialise 
312                  * pagination
313                  */
314
315                 $this->pager['page'] = ((x($_GET,'page')) ? $_GET['page'] : 1);
316                 $this->pager['itemspage'] = 50;
317                 $this->pager['start'] = ($this->pager['page'] * $this->pager['itemspage']) - $this->pager['itemspage'];
318                 $this->pager['total'] = 0;
319         }
320
321         function get_baseurl($ssl = false) {
322
323                 $scheme = $this->scheme;
324
325                 if(x($this->config,'ssl_policy')) {
326                         if(($ssl) || ($this->config['ssl_policy'] == SSL_POLICY_FULL)) 
327                                 $scheme = 'https';
328                         if(($this->config['ssl_policy'] == SSL_POLICY_SELFSIGN) && (local_user() || x($_POST,'auth-params')))
329                                 $scheme = 'https';
330                 }
331
332                 $this->baseurl = $scheme . "://" . $this->hostname . ((isset($this->path) && strlen($this->path)) ? '/' . $this->path : '' );
333                 return $this->baseurl;
334         }
335
336         function set_baseurl($url) {
337                 $parsed = @parse_url($url);
338
339                 $this->baseurl = $url;
340
341                 if($parsed) {           
342                         $this->scheme = $parsed['scheme'];
343
344                         $this->hostname = $parsed['host'];
345                         if(x($parsed,'port'))
346                                 $this->hostname .= ':' . $parsed['port'];
347                         if(x($parsed,'path'))
348                                 $this->path = trim($parsed['path'],'\\/');
349                 }
350
351         }
352
353         function get_hostname() {
354                 return $this->hostname;
355         }
356
357         function set_hostname($h) {
358                 $this->hostname = $h;
359         }
360
361         function set_path($p) {
362                 $this->path = trim(trim($p),'/');
363         } 
364
365         function get_path() {
366                 return $this->path;
367         }
368
369         function set_pager_total($n) {
370                 $this->pager['total'] = intval($n);
371         }
372
373         function set_pager_itemspage($n) {
374                 $this->pager['itemspage'] = intval($n);
375                 $this->pager['start'] = ($this->pager['page'] * $this->pager['itemspage']) - $this->pager['itemspage'];
376
377         } 
378
379         function init_pagehead() {
380                 $this->page['title'] = $this->config['sitename'];
381                 $tpl = file_get_contents('view/head.tpl');
382                 $this->page['htmlhead'] = replace_macros($tpl,array(
383                         '$baseurl' => $this->get_baseurl(),
384                         '$generator' => 'Friendika' . ' ' . FRIENDIKA_VERSION,
385                         '$delitem' => t('Delete this item?'),
386                         '$comment' => t('Comment')
387                 ));
388         }
389
390         function set_curl_code($code) {
391                 $this->curl_code = $code;
392         }
393
394         function get_curl_code() {
395                 return $this->curl_code;
396         }
397
398         function set_curl_headers($headers) {
399                 $this->curl_headers = $headers;
400         }
401
402         function get_curl_headers() {
403                 return $this->curl_headers;
404         }
405
406
407 }}
408
409 // retrieve the App structure
410 // useful in functions which require it but don't get it passed to them
411
412 if(! function_exists('get_app')) {
413 function get_app() {
414         global $a;
415         return $a;
416 }};
417
418
419 // Multi-purpose function to check variable state.
420 // Usage: x($var) or $x($array,'key')
421 // returns false if variable/key is not set
422 // if variable is set, returns 1 if has 'non-zero' value, otherwise returns 0.
423 // e.g. x('') or x(0) returns 0;
424
425 if(! function_exists('x')) {
426 function x($s,$k = NULL) {
427         if($k != NULL) {
428                 if((is_array($s)) && (array_key_exists($k,$s))) {
429                         if($s[$k])
430                                 return (int) 1;
431                         return (int) 0;
432                 }
433                 return false;
434         }
435         else {          
436                 if(isset($s)) {
437                         if($s) {
438                                 return (int) 1;
439                         }
440                         return (int) 0;
441                 }
442                 return false;
443         }
444 }}
445
446 // called from db initialisation if db is dead.
447
448 if(! function_exists('system_unavailable')) {
449 function system_unavailable() {
450         include('system_unavailable.php');
451         system_down();
452         killme();
453 }}
454
455 // Primarily involved with database upgrade, but also sets the 
456 // base url for use in cmdline programs which don't have
457 // $_SERVER variables, and synchronising the state of installed plugins.
458
459
460 if(! function_exists('check_config')) {
461 function check_config(&$a) {
462
463
464         load_config('system');
465
466         $build = get_config('system','build');
467         if(! x($build))
468                 $build = set_config('system','build',DB_UPDATE_VERSION);
469
470         $url = get_config('system','url');
471
472         // if the url isn't set or the stored url is radically different 
473         // than the currently visited url, store the current value accordingly.
474         // "Radically different" ignores common variations such as http vs https 
475         // and www.example.com vs example.com.
476
477         if((! x($url)) || (! link_compare($url,$a->get_baseurl())))
478                 $url = set_config('system','url',$a->get_baseurl());
479
480         if($build != DB_UPDATE_VERSION) {
481                 $stored = intval($build);
482                 $current = intval(DB_UPDATE_VERSION);
483                 if(($stored < $current) && file_exists('update.php')) {
484                         // We're reporting a different version than what is currently installed.
485                         // Run any existing update scripts to bring the database up to current.
486
487                         require_once('update.php');
488                         for($x = $stored; $x < $current; $x ++) {
489                                 if(function_exists('update_' . $x)) {
490                                         $func = 'update_' . $x;
491                                         $func($a);
492                                 }
493                         }
494                         set_config('system','build', DB_UPDATE_VERSION);
495                 }
496         }
497
498         /**
499          *
500          * Synchronise plugins:
501          *
502          * $a->config['system']['addon'] contains a comma-separated list of names
503          * of plugins/addons which are used on this system. 
504          * Go through the database list of already installed addons, and if we have
505          * an entry, but it isn't in the config list, call the uninstall procedure
506          * and mark it uninstalled in the database (for now we'll remove it).
507          * Then go through the config list and if we have a plugin that isn't installed,
508          * call the install procedure and add it to the database.
509          *
510          */
511
512         $r = q("SELECT * FROM `addon` WHERE `installed` = 1");
513         if(count($r))
514                 $installed = $r;
515         else
516                 $installed = array();
517
518         $plugins = get_config('system','addon');
519         $plugins_arr = array();
520
521         if($plugins)
522                 $plugins_arr = explode(',',str_replace(' ', '',$plugins));
523
524         $a->plugins = $plugins_arr;
525
526         $installed_arr = array();
527
528         if(count($installed)) {
529                 foreach($installed as $i) {
530                         if(! in_array($i['name'],$plugins_arr)) {
531                                 logger("Addons: uninstalling " . $i['name']);
532                                 q("DELETE FROM `addon` WHERE `id` = %d LIMIT 1",
533                                         intval($i['id'])
534                                 );
535
536                                 @include_once('addon/' . $i['name'] . '/' . $i['name'] . '.php');
537                                 if(function_exists($i['name'] . '_uninstall')) {
538                                         $func = $i['name'] . '_uninstall';
539                                         $func();
540                                 }
541                         }
542                         else
543                                 $installed_arr[] = $i['name'];
544                 }
545         }
546
547         if(count($plugins_arr)) {
548                 foreach($plugins_arr as $p) {
549                         if(! in_array($p,$installed_arr)) {
550                                 logger("Addons: installing " . $p);
551                                 $t = filemtime('addon/' . $p . '/' . $p . '.php');
552                                 @include_once('addon/' . $p . '/' . $p . '.php');
553                                 if(function_exists($p . '_install')) {
554                                         $func = $p . '_install';
555                                         $func();
556                                         $r = q("INSERT INTO `addon` (`name`, `installed`, `timestamp`) VALUES ( '%s', 1, %d ) ",
557                                                 dbesc($p),
558                                                 intval($t)
559                                         );
560                                 }
561                         }
562                 }
563         }
564
565
566         load_hooks();
567
568         return;
569 }}
570
571 // reload all updated plugins
572
573 if(! function_exists('reload_plugins')) {
574 function reload_plugins() {
575         $plugins = get_config('system','addon');
576         if(strlen($plugins)) {
577
578                 $r = q("SELECT * FROM `addon` WHERE `installed` = 1");
579                 if(count($r))
580                         $installed = $r;
581                 else
582                         $installed = array();
583
584                 $parr = explode(',',$plugins);
585                 if(count($parr)) {
586                         foreach($parr as $pl) {
587                                 $pl = trim($pl);
588                                 
589                                 $t = filemtime('addon/' . $pl . '/' . $pl . '.php');
590                                 foreach($installed as $i) {
591                                         if(($i['name'] == $pl) && ($i['timestamp'] != $t)) {    
592                                                 logger('Reloading plugin: ' . $i['name']);
593                                                 @include_once('addon/' . $pl . '/' . $pl . '.php');
594
595                                                 if(function_exists($pl . '_uninstall')) {
596                                                         $func = $pl . '_uninstall';
597                                                         $func();
598                                                 }
599                                                 if(function_exists($pl . '_install')) {
600                                                         $func = $pl . '_install';
601                                                         $func();
602                                                 }
603                                                 q("UPDATE `addon` SET `timestamp` = %d WHERE `id` = %d LIMIT 1",
604                                                         intval($t),
605                                                         intval($i['id'])
606                                                 );
607                                         }
608                                 }
609                         }
610                 }
611         }
612 }}
613                                 
614
615
616 // This is our template processor.
617 // $s is the string requiring macro substitution.
618 // $r is an array of key value pairs (search => replace)
619 // returns substituted string.
620 // WARNING: this is pretty basic, and doesn't properly handle search strings that are substrings of each other.
621 // For instance if 'test' => "foo" and 'testing' => "bar", testing could become either bar or fooing, 
622 // depending on the order in which they were declared in the array.   
623
624 require_once("include/template_processor.php");
625
626 if(! function_exists('replace_macros')) {  
627 function replace_macros($s,$r) {
628         global $t;
629         
630         return $t->replace($s,$r);
631
632 }}
633
634
635 // curl wrapper. If binary flag is true, return binary
636 // results. 
637
638 if(! function_exists('fetch_url')) {
639 function fetch_url($url,$binary = false, &$redirects = 0) {
640
641         $a = get_app();
642
643         $ch = curl_init($url);
644         if(($redirects > 8) || (! $ch)) 
645                 return false;
646
647         curl_setopt($ch, CURLOPT_HEADER, true);
648         curl_setopt($ch, CURLOPT_RETURNTRANSFER,true);
649
650
651         $curl_time = intval(get_config('system','curl_timeout'));
652         curl_setopt($ch, CURLOPT_TIMEOUT, (($curl_time !== false) ? $curl_time : 60));
653
654         // by default we will allow self-signed certs
655         // but you can override this
656
657         $check_cert = get_config('system','verifyssl');
658         curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, (($check_cert) ? true : false));
659
660         $prx = get_config('system','proxy');
661         if(strlen($prx)) {
662                 curl_setopt($ch, CURLOPT_HTTPPROXYTUNNEL, 1);
663                 curl_setopt($ch, CURLOPT_PROXY, $prx);
664                 $prxusr = get_config('system','proxyuser');
665                 if(strlen($prxusr))
666                         curl_setopt($ch, CURLOPT_PROXYUSERPWD, $prxusr);
667         }
668         if($binary)
669                 curl_setopt($ch, CURLOPT_BINARYTRANSFER,1);
670
671         $a->set_curl_code(0);
672
673         // don't let curl abort the entire application
674         // if it throws any errors.
675
676         $s = @curl_exec($ch);
677
678         $http_code = intval(curl_getinfo($ch, CURLINFO_HTTP_CODE));
679         $header = substr($s,0,strpos($s,"\r\n\r\n"));
680         if(stristr($header,'100') && (strlen($header) < 30)) {
681                 // 100 Continue has two headers, get the real one
682                 $s = substr($s,strlen($header)+4);
683                 $header = substr($s,0,strpos($s,"\r\n\r\n"));
684         }
685         if($http_code == 301 || $http_code == 302 || $http_code == 303) {
686         $matches = array();
687         preg_match('/(Location:|URI:)(.*?)\n/', $header, $matches);
688         $url = trim(array_pop($matches));
689         $url_parsed = @parse_url($url);
690         if (isset($url_parsed)) {
691             $redirects++;
692             return fetch_url($url,$binary,$redirects);
693         }
694     }
695         $a->set_curl_code($http_code);
696
697         $body = substr($s,strlen($header)+4);
698
699         /* one more try to make sure there are no more headers */
700
701         if(strpos($body,'HTTP/') === 0) {
702                 $header = substr($body,0,strpos($body,"\r\n\r\n"));
703                 $body = substr($body,strlen($header)+4);
704         }
705
706         $a->set_curl_headers($header);
707
708         curl_close($ch);
709         return($body);
710 }}
711
712 // post request to $url. $params is an array of post variables.
713
714 if(! function_exists('post_url')) {
715 function post_url($url,$params, $headers = null, &$redirects = 0) {
716         $a = get_app();
717         $ch = curl_init($url);
718         if(($redirects > 8) || (! $ch)) 
719                 return false;
720
721         curl_setopt($ch, CURLOPT_HEADER, true);
722         curl_setopt($ch, CURLOPT_RETURNTRANSFER,true);
723         curl_setopt($ch, CURLOPT_POST,1);
724         curl_setopt($ch, CURLOPT_POSTFIELDS,$params);
725
726         $curl_time = intval(get_config('system','curl_timeout'));
727         curl_setopt($ch, CURLOPT_TIMEOUT, (($curl_time !== false) ? $curl_time : 60));
728
729         if(is_array($headers))
730                 curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
731
732         $check_cert = get_config('system','verifyssl');
733         curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, (($check_cert) ? true : false));
734         $prx = get_config('system','proxy');
735         if(strlen($prx)) {
736                 curl_setopt($ch, CURLOPT_HTTPPROXYTUNNEL, 1);
737                 curl_setopt($ch, CURLOPT_PROXY, $prx);
738                 $prxusr = get_config('system','proxyuser');
739                 if(strlen($prxusr))
740                         curl_setopt($ch, CURLOPT_PROXYUSERPWD, $prxusr);
741         }
742
743         $a->set_curl_code(0);
744
745         // don't let curl abort the entire application
746         // if it throws any errors.
747
748         $s = @curl_exec($ch);
749
750         $http_code = intval(curl_getinfo($ch, CURLINFO_HTTP_CODE));
751         $header = substr($s,0,strpos($s,"\r\n\r\n"));
752         if(stristr($header,'100') && (strlen($header) < 30)) {
753                 // 100 Continue has two headers, get the real one
754                 $s = substr($s,strlen($header)+4);
755                 $header = substr($s,0,strpos($s,"\r\n\r\n"));
756         }
757         if($http_code == 301 || $http_code == 302 || $http_code == 303) {
758         $matches = array();
759         preg_match('/(Location:|URI:)(.*?)\n/', $header, $matches);
760         $url = trim(array_pop($matches));
761         $url_parsed = @parse_url($url);
762         if (isset($url_parsed)) {
763             $redirects++;
764             return post_url($url,$binary,$headers,$redirects);
765         }
766     }
767         $a->set_curl_code($http_code);
768         $body = substr($s,strlen($header)+4);
769
770         /* one more try to make sure there are no more headers */
771
772         if(strpos($body,'HTTP/') === 0) {
773                 $header = substr($body,0,strpos($body,"\r\n\r\n"));
774                 $body = substr($body,strlen($header)+4);
775         }
776
777         $a->set_curl_headers($header);
778
779         curl_close($ch);
780         return($body);
781 }}
782
783 // random hash, 64 chars
784
785 if(! function_exists('random_string')) {
786 function random_string() {
787         return(hash('sha256',uniqid(rand(),true)));
788 }}
789
790 /**
791  * This is our primary input filter. 
792  *
793  * The high bit hack only involved some old IE browser, forget which (IE5/Mac?)
794  * that had an XSS attack vector due to stripping the high-bit on an 8-bit character
795  * after cleansing, and angle chars with the high bit set could get through as markup.
796  * 
797  * This is now disabled because it was interfering with some legitimate unicode sequences 
798  * and hopefully there aren't a lot of those browsers left. 
799  *
800  * Use this on any text input where angle chars are not valid or permitted
801  * They will be replaced with safer brackets. This may be filtered further
802  * if these are not allowed either.   
803  *
804  */
805
806 if(! function_exists('notags')) {
807 function notags($string) {
808
809         return(str_replace(array("<",">"), array('[',']'), $string));
810
811 //  High-bit filter no longer used
812 //      return(str_replace(array("<",">","\xBA","\xBC","\xBE"), array('[',']','','',''), $string));
813 }}
814
815 // use this on "body" or "content" input where angle chars shouldn't be removed,
816 // and allow them to be safely displayed.
817
818 if(! function_exists('escape_tags')) {
819 function escape_tags($string) {
820
821         return(htmlspecialchars($string));
822 }}
823
824 // wrapper for adding a login box. If $register == true provide a registration
825 // link. This will most always depend on the value of $a->config['register_policy'].
826 // returns the complete html for inserting into the page
827
828 if(! function_exists('login')) {
829 function login($register = false) {
830         $o = "";
831         $register_tpl = (($register) ? get_markup_template("register-link.tpl") : "");
832         
833         $register_html = replace_macros($register_tpl,array(
834                 '$title' => t('Create a New Account'),
835                 '$desc' => t('Register')
836         ));
837
838         $noid = get_config('system','no_openid');
839         if($noid) {
840                 $classname = 'no-openid';
841                 $namelabel = t('Nickname or Email address: ');
842                 $passlabel = t('Password: ');
843                 $login     = t('Login');
844         }
845         else {
846                 $classname = 'openid';
847                 $namelabel = t('Nickname/Email/OpenID: ');
848                 $passlabel = t("Password \x28if not OpenID\x29: ");
849                 $login     = t('Login');
850         }
851         $lostpass = t('Forgot your password?');
852         $lostlink = t('Password Reset');
853
854         if(local_user()) {
855                 $tpl = get_markup_template("logout.tpl");
856         }
857         else {
858                 $tpl = get_markup_template("login.tpl");
859
860         }
861
862         $o = '<script type="text/javascript"> $(document).ready(function() { $("#login-name").focus();} );</script>';   
863
864         $o .= replace_macros($tpl,array(
865                 '$logout'        => t('Logout'),
866                 '$register_html' => $register_html, 
867                 '$classname'     => $classname,
868                 '$namelabel'     => $namelabel,
869                 '$passlabel'     => $passlabel,
870                 '$login'         => $login,
871                 '$lostpass'      => $lostpass,
872                 '$lostlink'      => $lostlink 
873         ));
874
875         return $o;
876 }}
877
878 // generate a string that's random, but usually pronounceable. 
879 // used to generate initial passwords
880
881 if(! function_exists('autoname')) {
882 function autoname($len) {
883
884         $vowels = array('a','a','ai','au','e','e','e','ee','ea','i','ie','o','ou','u'); 
885         if(mt_rand(0,5) == 4)
886                 $vowels[] = 'y';
887
888         $cons = array(
889                         'b','bl','br',
890                         'c','ch','cl','cr',
891                         'd','dr',
892                         'f','fl','fr',
893                         'g','gh','gl','gr',
894                         'h',
895                         'j',
896                         'k','kh','kl','kr',
897                         'l',
898                         'm',
899                         'n',
900                         'p','ph','pl','pr',
901                         'qu',
902                         'r','rh',
903                         's','sc','sh','sm','sp','st',
904                         't','th','tr',
905                         'v',
906                         'w','wh',
907                         'x',
908                         'z','zh'
909                         );
910
911         $midcons = array('ck','ct','gn','ld','lf','lm','lt','mb','mm', 'mn','mp',
912                                 'nd','ng','nk','nt','rn','rp','rt');
913
914         $noend = array('bl', 'br', 'cl','cr','dr','fl','fr','gl','gr',
915                                 'kh', 'kl','kr','mn','pl','pr','rh','tr','qu','wh');
916
917         $start = mt_rand(0,2);
918         if($start == 0)
919                 $table = $vowels;
920         else
921                 $table = $cons;
922
923         $word = '';
924
925         for ($x = 0; $x < $len; $x ++) {
926                 $r = mt_rand(0,count($table) - 1);
927                 $word .= $table[$r];
928   
929                 if($table == $vowels)
930                         $table = array_merge($cons,$midcons);
931                 else
932                         $table = $vowels;
933
934         }
935
936         $word = substr($word,0,$len);
937
938         foreach($noend as $noe) {
939                 if((strlen($word) > 2) && (substr($word,-2) == $noe)) {
940                         $word = substr($word,0,-1);
941                         break;
942                 }
943         }
944         if(substr($word,-1) == 'q')
945                 $word = substr($word,0,-1);    
946         return $word;
947 }}
948
949 // Used to end the current process, after saving session state. 
950
951 if(! function_exists('killme')) {
952 function killme() {
953         session_write_close();
954         exit;
955 }}
956
957 // redirect to another URL and terminate this process.
958
959 if(! function_exists('goaway')) {
960 function goaway($s) {
961         header("Location: $s");
962         killme();
963 }}
964
965 // Generic XML return
966 // Outputs a basic dfrn XML status structure to STDOUT, with a <status> variable 
967 // of $st and an optional text <message> of $message and terminates the current process. 
968
969 if(! function_exists('xml_status')) {
970 function xml_status($st, $message = '') {
971
972         $xml_message = ((strlen($message)) ? "\t<message>" . xmlify($message) . "</message>\r\n" : '');
973
974         if($st)
975                 logger('xml_status returning non_zero: ' . $st . " message=" . $message);
976
977         header( "Content-type: text/xml" );
978         echo '<?xml version="1.0" encoding="UTF-8"?>'."\r\n";
979         echo "<result>\r\n\t<status>$st</status>\r\n$xml_message</result>\r\n";
980         killme();
981 }}
982
983 // Returns the uid of locally logged in user or false.
984
985 if(! function_exists('local_user')) {
986 function local_user() {
987         if((x($_SESSION,'authenticated')) && (x($_SESSION,'uid')))
988                 return intval($_SESSION['uid']);
989         return false;
990 }}
991
992 // Returns contact id of authenticated site visitor or false
993
994 if(! function_exists('remote_user')) {
995 function remote_user() {
996         if((x($_SESSION,'authenticated')) && (x($_SESSION,'visitor_id')))
997                 return intval($_SESSION['visitor_id']);
998         return false;
999 }}
1000
1001 // contents of $s are displayed prominently on the page the next time
1002 // a page is loaded. Usually used for errors or alerts.
1003
1004 if(! function_exists('notice')) {
1005 function notice($s) {
1006         $a = get_app();
1007         if($a->interactive)
1008                 $_SESSION['sysmsg'] .= $s;
1009 }}
1010
1011 // wrapper around config to limit the text length of an incoming message
1012
1013 if(! function_exists('get_max_import_size')) {
1014 function get_max_import_size() {
1015         global $a;
1016         return ((x($a->config,'max_import_size')) ? $a->config['max_import_size'] : 0 );
1017 }}
1018
1019
1020 // escape text ($str) for XML transport
1021 // returns escaped text.
1022
1023 if(! function_exists('xmlify')) {
1024 function xmlify($str) {
1025         $buffer = '';
1026         
1027         for($x = 0; $x < strlen($str); $x ++) {
1028                 $char = $str[$x];
1029         
1030                 switch( $char ) {
1031
1032                         case "\r" :
1033                                 break;
1034                         case "&" :
1035                                 $buffer .= '&amp;';
1036                                 break;
1037                         case "'" :
1038                                 $buffer .= '&apos;';
1039                                 break;
1040                         case "\"" :
1041                                 $buffer .= '&quot;';
1042                                 break;
1043                         case '<' :
1044                                 $buffer .= '&lt;';
1045                                 break;
1046                         case '>' :
1047                                 $buffer .= '&gt;';
1048                                 break;
1049                         case "\n" :
1050                                 $buffer .= "\n";
1051                                 break;
1052                         default :
1053                                 $buffer .= $char;
1054                                 break;
1055                 }       
1056         }
1057         $buffer = trim($buffer);
1058         return($buffer);
1059 }}
1060
1061 // undo an xmlify
1062 // pass xml escaped text ($s), returns unescaped text
1063
1064 if(! function_exists('unxmlify')) {
1065 function unxmlify($s) {
1066         $ret = str_replace('&amp;','&', $s);
1067         $ret = str_replace(array('&lt;','&gt;','&quot;','&apos;'),array('<','>','"',"'"),$ret);
1068         return $ret;    
1069 }}
1070
1071 // convenience wrapper, reverse the operation "bin2hex"
1072
1073 if(! function_exists('hex2bin')) {
1074 function hex2bin($s) {
1075         if(! ctype_xdigit($s)) {
1076                 logger('hex2bin: illegal input: ' . print_r(debug_backtrace(), true));
1077                 return($s);
1078         }
1079
1080         return(pack("H*",$s));
1081 }}
1082
1083 // Automatic pagination.
1084 // To use, get the count of total items.
1085 // Then call $a->set_pager_total($number_items);
1086 // Optionally call $a->set_pager_itemspage($n) to the number of items to display on each page
1087 // Then call paginate($a) after the end of the display loop to insert the pager block on the page
1088 // (assuming there are enough items to paginate).
1089 // When using with SQL, the setting LIMIT %d, %d => $a->pager['start'],$a->pager['itemspage']
1090 // will limit the results to the correct items for the current page. 
1091 // The actual page handling is then accomplished at the application layer. 
1092
1093 if(! function_exists('paginate')) {
1094 function paginate(&$a) {
1095         $o = '';
1096         $stripped = preg_replace('/(&page=[0-9]*)/','',$a->query_string);
1097         $stripped = str_replace('q=','',$stripped);
1098         $stripped = trim($stripped,'/');
1099         $pagenum = $a->pager['page'];
1100         $url = $a->get_baseurl() . '/' . $stripped;
1101
1102
1103           if($a->pager['total'] > $a->pager['itemspage']) {
1104                 $o .= '<div class="pager">';
1105                 if($a->pager['page'] != 1)
1106                         $o .= '<span class="pager_prev">'."<a href=\"$url".'&page='.($a->pager['page'] - 1).'">' . t('prev') . '</a></span> ';
1107
1108                 $o .=  "<span class=\"pager_first\"><a href=\"$url"."&page=1\">" . t('first') . "</a></span> ";
1109
1110                 $numpages = $a->pager['total'] / $a->pager['itemspage'];
1111
1112                         $numstart = 1;
1113                 $numstop = $numpages;
1114
1115                 if($numpages > 14) {
1116                         $numstart = (($pagenum > 7) ? ($pagenum - 7) : 1);
1117                         $numstop = (($pagenum > ($numpages - 7)) ? $numpages : ($numstart + 14));
1118                 }
1119    
1120                 for($i = $numstart; $i <= $numstop; $i++){
1121                         if($i == $a->pager['page'])
1122                                 $o .= '<span class="pager_current">'.(($i < 10) ? '&nbsp;'.$i : $i);
1123                         else
1124                                 $o .= "<span class=\"pager_n\"><a href=\"$url"."&page=$i\">".(($i < 10) ? '&nbsp;'.$i : $i)."</a>";
1125                         $o .= '</span> ';
1126                 }
1127
1128                 if(($a->pager['total'] % $a->pager['itemspage']) != 0) {
1129                         if($i == $a->pager['page'])
1130                                 $o .= '<span class="pager_current">'.(($i < 10) ? '&nbsp;'.$i : $i);
1131                         else
1132                                 $o .= "<span class=\"pager_n\"><a href=\"$url"."&page=$i\">".(($i < 10) ? '&nbsp;'.$i : $i)."</a>";
1133                         $o .= '</span> ';
1134                 }
1135
1136                 $lastpage = (($numpages > intval($numpages)) ? intval($numpages)+1 : $numpages);
1137                 $o .= "<span class=\"pager_last\"><a href=\"$url"."&page=$lastpage\">" . t('last') . "</a></span> ";
1138
1139                 if(($a->pager['total'] - ($a->pager['itemspage'] * $a->pager['page'])) > 0)
1140                         $o .= '<span class="pager_next">'."<a href=\"$url"."&page=".($a->pager['page'] + 1).'">' . t('next') . '</a></span>';
1141                 $o .= '</div>'."\r\n";
1142         }
1143         return $o;
1144 }}
1145
1146 // Turn user/group ACLs stored as angle bracketed text into arrays
1147
1148 if(! function_exists('expand_acl')) {
1149 function expand_acl($s) {
1150         // turn string array of angle-bracketed elements into numeric array
1151         // e.g. "<1><2><3>" => array(1,2,3);
1152         $ret = array();
1153
1154         if(strlen($s)) {
1155                 $t = str_replace('<','',$s);
1156                 $a = explode('>',$t);
1157                 foreach($a as $aa) {
1158                         if(intval($aa))
1159                                 $ret[] = intval($aa);
1160                 }
1161         }
1162         return $ret;
1163 }}              
1164
1165 // Used to wrap ACL elements in angle brackets for storage 
1166
1167 if(! function_exists('sanitise_acl')) {
1168 function sanitise_acl(&$item) {
1169         if(intval($item))
1170                 $item = '<' . intval(notags(trim($item))) . '>';
1171         else
1172                 unset($item);
1173 }}
1174
1175 // retrieve a "family" of config variables from database to cached storage
1176
1177 if(! function_exists('load_config')) {
1178 function load_config($family) {
1179         global $a;
1180         $r = q("SELECT * FROM `config` WHERE `cat` = '%s'",
1181                 dbesc($family)
1182         );
1183         if(count($r)) {
1184                 foreach($r as $rr) {
1185                         $k = $rr['k'];
1186                         $a->config[$family][$k] = $rr['v'];
1187                 }
1188         }
1189 }}
1190
1191 // get a particular config variable given the family name
1192 // and key. Returns false if not set.
1193 // $instore is only used by the set_config function
1194 // to determine if the key already exists in the DB
1195 // If a key is found in the DB but doesn't exist in
1196 // local config cache, pull it into the cache so we don't have
1197 // to hit the DB again for this item.
1198
1199 if(! function_exists('get_config')) {
1200 function get_config($family, $key, $instore = false) {
1201
1202         global $a;
1203
1204         if(! $instore) {
1205                 if(isset($a->config[$family][$key])) {
1206                         if($a->config[$family][$key] === '!<unset>!') {
1207                                 return false;
1208                         }
1209                         return $a->config[$family][$key];
1210                 }
1211         }
1212         $ret = q("SELECT `v` FROM `config` WHERE `cat` = '%s' AND `k` = '%s' LIMIT 1",
1213                 dbesc($family),
1214                 dbesc($key)
1215         );
1216         if(count($ret)) {
1217                 $a->config[$family][$key] = $ret[0]['v'];
1218                 return $ret[0]['v'];
1219         }
1220         else {
1221                 $a->config[$family][$key] = '!<unset>!';
1222         }
1223         return false;
1224 }}
1225
1226 // Store a config value ($value) in the category ($family)
1227 // under the key ($key)
1228 // Return the value, or false if the database update failed
1229
1230 if(! function_exists('set_config')) {
1231 function set_config($family,$key,$value) {
1232
1233         global $a;
1234
1235         if(get_config($family,$key,true) === false) {
1236                 $a->config[$family][$key] = $value;
1237                 $ret = q("INSERT INTO `config` ( `cat`, `k`, `v` ) VALUES ( '%s', '%s', '%s' ) ",
1238                         dbesc($family),
1239                         dbesc($key),
1240                         dbesc($value)
1241                 );
1242                 if($ret) 
1243                         return $value;
1244                 return $ret;
1245         }
1246         $ret = q("UPDATE `config` SET `v` = '%s' WHERE `cat` = '%s' AND `k` = '%s' LIMIT 1",
1247                 dbesc($value),
1248                 dbesc($family),
1249                 dbesc($key)
1250         );
1251
1252         $a->config[$family][$key] = $value;
1253
1254         if($ret)
1255                 return $value;
1256         return $ret;
1257 }}
1258
1259
1260 if(! function_exists('load_pconfig')) {
1261 function load_pconfig($uid,$family) {
1262         global $a;
1263         $r = q("SELECT * FROM `pconfig` WHERE `cat` = '%s' AND `uid` = %d",
1264                 dbesc($family),
1265                 intval($uid)
1266         );
1267         if(count($r)) {
1268                 foreach($r as $rr) {
1269                         $k = $rr['k'];
1270                         $a->config[$uid][$family][$k] = $rr['v'];
1271                 }
1272         }
1273 }}
1274
1275
1276
1277 if(! function_exists('get_pconfig')) {
1278 function get_pconfig($uid,$family, $key, $instore = false) {
1279
1280         global $a;
1281
1282         if(! $instore) {
1283                 if(isset($a->config[$uid][$family][$key])) {
1284                         if($a->config[$uid][$family][$key] === '!<unset>!') {
1285                                 return false;
1286                         }
1287                         return $a->config[$uid][$family][$key];
1288                 }
1289         }
1290
1291         $ret = q("SELECT `v` FROM `pconfig` WHERE `uid` = %d AND `cat` = '%s' AND `k` = '%s' LIMIT 1",
1292                 intval($uid),
1293                 dbesc($family),
1294                 dbesc($key)
1295         );
1296
1297         if(count($ret)) {
1298                 $a->config[$uid][$family][$key] = $ret[0]['v'];
1299                 return $ret[0]['v'];
1300         }
1301         else {
1302                 $a->config[$uid][$family][$key] = '!<unset>!';
1303         }
1304         return false;
1305 }}
1306
1307 if(! function_exists('del_config')) {
1308 function del_config($family,$key) {
1309
1310         global $a;
1311         if(x($a->config[$family],$key))
1312                 unset($a->config[$family][$key]);
1313         $ret = q("DELETE FROM `config` WHERE `cat` = '%s' AND `k` = '%s' LIMIT 1",
1314                 dbesc($cat),
1315                 dbesc($key)
1316         );
1317         return $ret;
1318 }}
1319
1320
1321
1322 // Same as above functions except these are for personal config storage and take an
1323 // additional $uid argument.
1324
1325 if(! function_exists('set_pconfig')) {
1326 function set_pconfig($uid,$family,$key,$value) {
1327
1328         global $a;
1329
1330         if(get_pconfig($uid,$family,$key,true) === false) {
1331                 $a->config[$uid][$family][$key] = $value;
1332                 $ret = q("INSERT INTO `pconfig` ( `uid`, `cat`, `k`, `v` ) VALUES ( %d, '%s', '%s', '%s' ) ",
1333                         intval($uid),
1334                         dbesc($family),
1335                         dbesc($key),
1336                         dbesc($value)
1337                 );
1338                 if($ret) 
1339                         return $value;
1340                 return $ret;
1341         }
1342         $ret = q("UPDATE `pconfig` SET `v` = '%s' WHERE `uid` = %d AND `cat` = '%s' AND `k` = '%s' LIMIT 1",
1343                 dbesc($value),
1344                 intval($uid),
1345                 dbesc($family),
1346                 dbesc($key)
1347         );
1348
1349         $a->config[$uid][$family][$key] = $value;
1350
1351         if($ret)
1352                 return $value;
1353         return $ret;
1354 }}
1355
1356 if(! function_exists('del_pconfig')) {
1357 function del_pconfig($uid,$family,$key) {
1358
1359         global $a;
1360         if(x($a->config[$uid][$family],$key))
1361                 unset($a->config[$uid][$family][$key]);
1362         $ret = q("DELETE FROM `pconfig` WHERE `uid` = %d AND `cat` = '%s' AND `k` = '%s' LIMIT 1",
1363                 intval($uid),
1364                 dbesc($family),
1365                 dbesc($key)
1366         );
1367         return $ret;
1368 }}
1369
1370
1371 // convert an XML document to a normalised, case-corrected array
1372 // used by webfinger
1373
1374 if(! function_exists('convert_xml_element_to_array')) {
1375 function convert_xml_element_to_array($xml_element, &$recursion_depth=0) {
1376
1377         // If we're getting too deep, bail out
1378         if ($recursion_depth > 512) {
1379                 return(null);
1380         }
1381
1382         if (!is_string($xml_element) &&
1383         !is_array($xml_element) &&
1384         (get_class($xml_element) == 'SimpleXMLElement')) {
1385                 $xml_element_copy = $xml_element;
1386                 $xml_element = get_object_vars($xml_element);
1387         }
1388
1389         if (is_array($xml_element)) {
1390                 $result_array = array();
1391                 if (count($xml_element) <= 0) {
1392                         return (trim(strval($xml_element_copy)));
1393                 }
1394
1395                 foreach($xml_element as $key=>$value) {
1396
1397                         $recursion_depth++;
1398                         $result_array[strtolower($key)] =
1399                 convert_xml_element_to_array($value, $recursion_depth);
1400                         $recursion_depth--;
1401                 }
1402                 if ($recursion_depth == 0) {
1403                         $temp_array = $result_array;
1404                         $result_array = array(
1405                                 strtolower($xml_element_copy->getName()) => $temp_array,
1406                         );
1407                 }
1408
1409                 return ($result_array);
1410
1411         } else {
1412                 return (trim(strval($xml_element)));
1413         }
1414 }}
1415
1416 // Given an email style address, perform webfinger lookup and 
1417 // return the resulting DFRN profile URL, or if no DFRN profile URL
1418 // is located, returns an OStatus subscription template (prefixed 
1419 // with the string 'stat:' to identify it as on OStatus template).
1420 // If this isn't an email style address just return $s.
1421 // Return an empty string if email-style addresses but webfinger fails,
1422 // or if the resultant personal XRD doesn't contain a supported 
1423 // subscription/friend-request attribute.
1424
1425 if(! function_exists('webfinger_dfrn')) {
1426 function webfinger_dfrn($s) {
1427         if(! strstr($s,'@')) {
1428                 return $s;
1429         }
1430         $links = webfinger($s);
1431         logger('webfinger_dfrn: ' . $s . ':' . print_r($links,true), LOGGER_DATA);
1432         if(count($links)) {
1433                 foreach($links as $link)
1434                         if($link['@attributes']['rel'] === NAMESPACE_DFRN)
1435                                 return $link['@attributes']['href'];
1436                 foreach($links as $link)
1437                         if($link['@attributes']['rel'] === NAMESPACE_OSTATUSSUB)
1438                                 return 'stat:' . $link['@attributes']['template'];              
1439         }
1440         return '';
1441 }}
1442
1443 // Given an email style address, perform webfinger lookup and 
1444 // return the array of link attributes from the personal XRD file.
1445 // On error/failure return an empty array.
1446
1447
1448 if(! function_exists('webfinger')) {
1449 function webfinger($s) {
1450         $host = '';
1451         if(strstr($s,'@')) {
1452                 $host = substr($s,strpos($s,'@') + 1);
1453         }
1454         if(strlen($host)) {
1455                 $tpl = fetch_lrdd_template($host);
1456                 logger('webfinger: lrdd template: ' . $tpl);
1457                 if(strlen($tpl)) {
1458                         $pxrd = str_replace('{uri}', urlencode('acct:' . $s), $tpl);
1459                         logger('webfinger: pxrd: ' . $pxrd);
1460                         $links = fetch_xrd_links($pxrd);
1461                         if(! count($links)) {
1462                                 // try with double slashes
1463                                 $pxrd = str_replace('{uri}', urlencode('acct://' . $s), $tpl);
1464                                 logger('webfinger: pxrd: ' . $pxrd);
1465                                 $links = fetch_xrd_links($pxrd);
1466                         }
1467                         return $links;
1468                 }
1469         }
1470         return array();
1471 }}
1472
1473 if(! function_exists('lrdd')) {
1474 function lrdd($uri) {
1475
1476         $a = get_app();
1477
1478         // default priority is host priority, host-meta first
1479
1480         $priority = 'host';
1481
1482         // All we have is an email address. Resource-priority is irrelevant
1483         // because our URI isn't directly resolvable.
1484
1485         if(strstr($uri,'@')) {  
1486                 return(webfinger($uri));
1487         }
1488
1489         // get the host meta file
1490
1491         $host = @parse_url($uri);
1492
1493         if($host) {
1494                 $url  = ((x($host,'scheme')) ? $host['scheme'] : 'http') . '://';
1495                 $url .= $host['host'] . '/.well-known/host-meta' ;
1496         }
1497         else
1498                 return array();
1499
1500         logger('lrdd: constructed url: ' . $url);
1501
1502         $xml = fetch_url($url);
1503         $headers = $a->get_curl_headers();
1504
1505         if (! $xml)
1506                 return array();
1507
1508         logger('lrdd: host_meta: ' . $xml, LOGGER_DATA);
1509
1510         $h = parse_xml_string($xml);
1511
1512         $arr = convert_xml_element_to_array($h);
1513
1514         if(isset($arr['xrd']['property'])) {
1515                 $property = $arr['crd']['property'];
1516                 if(! isset($property[0]))
1517                         $properties = array($property);
1518                 else
1519                         $properties = $property;
1520                 foreach($properties as $prop)
1521                         if((string) $prop['@attributes'] === 'http://lrdd.net/priority/resource')
1522                                 $priority = 'resource';
1523         } 
1524
1525         // save the links in case we need them
1526
1527         $links = array();
1528
1529         if(isset($arr['xrd']['link'])) {
1530                 $link = $arr['xrd']['link'];
1531                 if(! isset($link[0]))
1532                         $links = array($link);
1533                 else
1534                         $links = $link;
1535         }
1536
1537         // do we have a template or href?
1538
1539         if(count($links)) {
1540                 foreach($links as $link) {
1541                         if($link['@attributes']['rel'] && attribute_contains($link['@attributes']['rel'],'lrdd')) {
1542                                 if(x($link['@attributes'],'template'))
1543                                         $tpl = $link['@attributes']['template'];
1544                                 elseif(x($link['@attributes'],'href'))
1545                                         $href = $link['@attributes']['href'];
1546                         }
1547                 }               
1548         }
1549
1550         if((! isset($tpl)) || (! strpos($tpl,'{uri}')))
1551                 $tpl = '';
1552
1553         if($priority === 'host') {
1554                 if(strlen($tpl)) 
1555                         $pxrd = str_replace('{uri}', urlencode($uri), $tpl);
1556                 elseif(isset($href))
1557                         $pxrd = $href;
1558                 if(isset($pxrd)) {
1559                         logger('lrdd: (host priority) pxrd: ' . $pxrd);
1560                         $links = fetch_xrd_links($pxrd);
1561                         return $links;
1562                 }
1563
1564                 $lines = explode("\n",$headers);
1565                 if(count($lines)) {
1566                         foreach($lines as $line) {                              
1567                                 if((stristr($line,'link:')) && preg_match('/<([^>].*)>.*rel\=[\'\"]lrdd[\'\"]/',$line,$matches)) {
1568                                         return(fetch_xrd_links($matches[1]));
1569                                         break;
1570                                 }
1571                         }
1572                 }
1573         }
1574
1575
1576         // priority 'resource'
1577
1578
1579         $html = fetch_url($uri);
1580         $headers = $a->get_curl_headers();
1581         logger('lrdd: headers=' . $headers, LOGGER_DEBUG);
1582
1583         // don't try and parse raw xml as html
1584         if(! strstr($html,'<?xml')) {
1585                 require_once('library/HTML5/Parser.php');
1586                 $dom = @HTML5_Parser::parse($html);
1587
1588                 if($dom) {
1589                         $items = $dom->getElementsByTagName('link');
1590                         foreach($items as $item) {
1591                                 $x = $item->getAttribute('rel');
1592                                 if($x == "lrdd") {
1593                                         $pagelink = $item->getAttribute('href');
1594                                         break;
1595                                 }
1596                         }
1597                 }
1598         }
1599
1600         if(isset($pagelink))
1601                 return(fetch_xrd_links($pagelink));
1602
1603         // next look in HTTP headers
1604
1605         $lines = explode("\n",$headers);
1606         if(count($lines)) {
1607                 foreach($lines as $line) {                              
1608                         // TODO alter the following regex to support multiple relations (space separated)
1609                         if((stristr($line,'link:')) && preg_match('/<([^>].*)>.*rel\=[\'\"]lrdd[\'\"]/',$line,$matches)) {
1610                                 $pagelink = $matches[1];
1611                                 break;
1612                         }
1613                         // don't try and run feeds through the html5 parser
1614                         if(stristr($line,'content-type:') && ((stristr($line,'application/atom+xml')) || (stristr($line,'application/rss+xml'))))
1615                                 return array();
1616                         if(stristr($html,'<rss') || stristr($html,'<feed'))
1617                                 return array();
1618                 }
1619         }
1620
1621         if(isset($pagelink))
1622                 return(fetch_xrd_links($pagelink));
1623
1624         // If we haven't found any links, return the host xrd links (which we have already fetched)
1625
1626         if(isset($links))
1627                 return $links;
1628
1629         return array();
1630
1631 }}
1632
1633
1634
1635 // Given a host name, locate the LRDD template from that
1636 // host. Returns the LRDD template or an empty string on
1637 // error/failure.
1638
1639 if(! function_exists('fetch_lrdd_template')) {
1640 function fetch_lrdd_template($host) {
1641         $tpl = '';
1642
1643         $url1 = 'https://' . $host . '/.well-known/host-meta' ;
1644         $url2 = 'http://' . $host . '/.well-known/host-meta' ;
1645         $links = fetch_xrd_links($url1);
1646         logger('template (https): ' . print_r($links,true));
1647         if(! count($links)) {
1648                 $links = fetch_xrd_links($url2);
1649                 logger('template (http): ' . print_r($links,true));
1650         }
1651         if(count($links)) {
1652                 foreach($links as $link)
1653                         if($link['@attributes']['rel'] && $link['@attributes']['rel'] === 'lrdd')
1654                                 $tpl = $link['@attributes']['template'];
1655         }
1656         if(! strpos($tpl,'{uri}'))
1657                 $tpl = '';
1658         return $tpl;
1659 }}
1660
1661 // Given a URL, retrieve the page as an XRD document.
1662 // Return an array of links.
1663 // on error/failure return empty array.
1664
1665 if(! function_exists('fetch_xrd_links')) {
1666 function fetch_xrd_links($url) {
1667
1668
1669         $xml = fetch_url($url);
1670         if (! $xml)
1671                 return array();
1672
1673         logger('fetch_xrd_links: ' . $xml, LOGGER_DATA);
1674         $h = parse_xml_string($xml);
1675         $arr = convert_xml_element_to_array($h);
1676
1677         $links = array();
1678
1679         if(isset($arr['xrd']['link'])) {
1680                 $link = $arr['xrd']['link'];
1681                 if(! isset($link[0]))
1682                         $links = array($link);
1683                 else
1684                         $links = $link;
1685         }
1686         if(isset($arr['xrd']['alias'])) {
1687                 $alias = $arr['xrd']['alias'];
1688                 if(! isset($alias[0]))
1689                         $aliases = array($alias);
1690                 else
1691                         $aliases = $alias;
1692                 foreach($aliases as $alias) {
1693                         $links[]['@attributes'] = array('rel' => 'alias' , 'href' => $alias);
1694                 }
1695         }
1696
1697         logger('fetch_xrd_links: ' . print_r($links,true), LOGGER_DATA);
1698
1699         return $links;
1700
1701 }}
1702
1703 // Convert an ACL array to a storable string
1704
1705 if(! function_exists('perms2str')) {
1706 function perms2str($p) {
1707         $ret = '';
1708         $tmp = $p;
1709         if(is_array($tmp)) {
1710                 array_walk($tmp,'sanitise_acl');
1711                 $ret = implode('',$tmp);
1712         }
1713         return $ret;
1714 }}
1715
1716 // generate a guaranteed unique (for this domain) item ID for ATOM
1717 // safe from birthday paradox
1718
1719 if(! function_exists('item_new_uri')) {
1720 function item_new_uri($hostname,$uid) {
1721
1722         do {
1723                 $dups = false;
1724                 $hash = random_string();
1725
1726                 $uri = "urn:X-dfrn:" . $hostname . ':' . $uid . ':' . $hash;
1727
1728                 $r = q("SELECT `id` FROM `item` WHERE `uri` = '%s' LIMIT 1",
1729                         dbesc($uri));
1730                 if(count($r))
1731                         $dups = true;
1732         } while($dups == true);
1733         return $uri;
1734 }}
1735
1736 // Generate a guaranteed unique photo ID.
1737 // safe from birthday paradox
1738
1739 if(! function_exists('photo_new_resource')) {
1740 function photo_new_resource() {
1741
1742         do {
1743                 $found = false;
1744                 $resource = hash('md5',uniqid(mt_rand(),true));
1745                 $r = q("SELECT `id` FROM `photo` WHERE `resource-id` = '%s' LIMIT 1",
1746                         dbesc($resource)
1747                 );
1748                 if(count($r))
1749                         $found = true;
1750         } while($found == true);
1751         return $resource;
1752 }}
1753
1754
1755 // Take a URL from the wild, prepend http:// if necessary
1756 // and check DNS to see if it's real
1757 // return true if it's OK, false if something is wrong with it
1758
1759 if(! function_exists('validate_url')) {
1760 function validate_url(&$url) {
1761         if(substr($url,0,4) != 'http')
1762                 $url = 'http://' . $url;
1763         $h = @parse_url($url);
1764
1765         if(($h) && (dns_get_record($h['host'], DNS_A + DNS_CNAME + DNS_PTR))) {
1766                 return true;
1767         }
1768         return false;
1769 }}
1770
1771 // checks that email is an actual resolvable internet address
1772
1773 if(! function_exists('validate_email')) {
1774 function validate_email($addr) {
1775
1776         if(! strpos($addr,'@'))
1777                 return false;
1778         $h = substr($addr,strpos($addr,'@') + 1);
1779
1780         if(($h) && (dns_get_record($h, DNS_A + DNS_CNAME + DNS_PTR + DNS_MX))) {
1781                 return true;
1782         }
1783         return false;
1784 }}
1785
1786 // Check $url against our list of allowed sites,
1787 // wildcards allowed. If allowed_sites is unset return true;
1788 // If url is allowed, return true.
1789 // otherwise, return false
1790
1791 if(! function_exists('allowed_url')) {
1792 function allowed_url($url) {
1793
1794         $h = @parse_url($url);
1795
1796         if(! $h) {
1797                 return false;
1798         }
1799
1800         $str_allowed = get_config('system','allowed_sites');
1801         if(! $str_allowed)
1802                 return true;
1803
1804         $found = false;
1805
1806         $host = strtolower($h['host']);
1807
1808         // always allow our own site
1809
1810         if($host == strtolower($_SERVER['SERVER_NAME']))
1811                 return true;
1812
1813         $fnmatch = function_exists('fnmatch');
1814         $allowed = explode(',',$str_allowed);
1815
1816         if(count($allowed)) {
1817                 foreach($allowed as $a) {
1818                         $pat = strtolower(trim($a));
1819                         if(($fnmatch && fnmatch($pat,$host)) || ($pat == $host)) {
1820                                 $found = true; 
1821                                 break;
1822                         }
1823                 }
1824         }
1825         return $found;
1826 }}
1827
1828 // check if email address is allowed to register here.
1829 // Compare against our list (wildcards allowed).
1830 // Returns false if not allowed, true if allowed or if
1831 // allowed list is not configured.
1832
1833 if(! function_exists('allowed_email')) {
1834 function allowed_email($email) {
1835
1836
1837         $domain = strtolower(substr($email,strpos($email,'@') + 1));
1838         if(! $domain)
1839                 return false;
1840
1841         $str_allowed = get_config('system','allowed_email');
1842         if(! $str_allowed)
1843                 return true;
1844
1845         $found = false;
1846
1847         $fnmatch = function_exists('fnmatch');
1848         $allowed = explode(',',$str_allowed);
1849
1850         if(count($allowed)) {
1851                 foreach($allowed as $a) {
1852                         $pat = strtolower(trim($a));
1853                         if(($fnmatch && fnmatch($pat,$domain)) || ($pat == $domain)) {
1854                                 $found = true; 
1855                                 break;
1856                         }
1857                 }
1858         }
1859         return $found;
1860 }}
1861
1862
1863
1864 // wrapper to load a view template, checking for alternate
1865 // languages before falling back to the default
1866
1867 // obsolete, deprecated.
1868
1869 if(! function_exists('load_view_file')) {
1870 function load_view_file($s) {
1871         global $lang, $a;
1872         if(! isset($lang))
1873                 $lang = 'en';
1874         $b = basename($s);
1875         $d = dirname($s);
1876         if(file_exists("$d/$lang/$b"))
1877                 return file_get_contents("$d/$lang/$b");
1878         
1879         $theme = current_theme();
1880         
1881         if(file_exists("$d/theme/$theme/$b"))
1882                 return file_get_contents("$d/theme/$theme/$b");
1883                         
1884         return file_get_contents($s);
1885 }}
1886
1887 if(! function_exists('get_intltext_template')) {
1888 function get_intltext_template($s) {
1889         global $lang;
1890
1891         if(! isset($lang))
1892                 $lang = 'en';
1893
1894         if(file_exists("view/$lang/$s"))
1895                 return file_get_contents("view/$lang/$s");
1896         elseif(file_exists("view/en/$s"))
1897                 return file_get_contents("view/en/$s");
1898         else
1899                 return file_get_contents("view/$s");
1900 }}
1901
1902 if(! function_exists('get_markup_template')) {
1903 function get_markup_template($s) {
1904
1905         $theme = current_theme();
1906         
1907         if(file_exists("view/theme/$theme/$s"))
1908                 return file_get_contents("view/theme/$theme/$s");
1909         else
1910                 return file_get_contents("view/$s");
1911
1912 }}
1913
1914
1915
1916
1917
1918 // for html,xml parsing - let's say you've got
1919 // an attribute foobar="class1 class2 class3"
1920 // and you want to find out if it contains 'class3'.
1921 // you can't use a normal sub string search because you
1922 // might match 'notclass3' and a regex to do the job is 
1923 // possible but a bit complicated. 
1924 // pass the attribute string as $attr and the attribute you 
1925 // are looking for as $s - returns true if found, otherwise false
1926
1927 if(! function_exists('attribute_contains')) {
1928 function attribute_contains($attr,$s) {
1929         $a = explode(' ', $attr);
1930         if(count($a) && in_array($s,$a))
1931                 return true;
1932         return false;
1933 }}
1934
1935 if(! function_exists('logger')) {
1936 function logger($msg,$level = 0) {
1937         $debugging = get_config('system','debugging');
1938         $loglevel  = intval(get_config('system','loglevel'));
1939         $logfile   = get_config('system','logfile');
1940
1941         if((! $debugging) || (! $logfile) || ($level > $loglevel))
1942                 return;
1943         
1944         @file_put_contents($logfile, datetime_convert() . ':' . session_id() . ' ' . $msg . "\n", FILE_APPEND);
1945         return;
1946 }}
1947
1948
1949 if(! function_exists('activity_match')) {
1950 function activity_match($haystack,$needle) {
1951         if(($haystack === $needle) || ((basename($needle) === $haystack) && strstr($needle,NAMESPACE_ACTIVITY_SCHEMA)))
1952                 return true;
1953         return false;
1954 }}
1955
1956
1957 // Pull out all #hashtags and @person tags from $s;
1958 // We also get @person@domain.com - which would make 
1959 // the regex quite complicated as tags can also
1960 // end a sentence. So we'll run through our results
1961 // and strip the period from any tags which end with one.
1962 // Returns array of tags found, or empty array.
1963
1964
1965 if(! function_exists('get_tags')) {
1966 function get_tags($s) {
1967         $ret = array();
1968
1969         // ignore anything in a code block
1970
1971         $s = preg_replace('/\[code\](.*?)\[\/code\]/sm','',$s);
1972
1973         if(preg_match_all('/([@#][^ \x0D\x0A,:?]+)([ \x0D\x0A,:?]|$)/',$s,$match)) {
1974                 foreach($match[1] as $match) {
1975                         if(strstr($match,"]")) {
1976                                 // we might be inside a bbcode color tag - leave it alone
1977                                 continue;
1978                         }
1979                         if(substr($match,-1,1) === '.')
1980                                 $ret[] = substr($match,0,-1);
1981                         else
1982                                 $ret[] = $match;
1983                 }
1984         }
1985
1986         return $ret;
1987 }}
1988
1989
1990 // quick and dirty quoted_printable encoding
1991
1992 if(! function_exists('qp')) {
1993 function qp($s) {
1994 return str_replace ("%","=",rawurlencode($s));
1995 }} 
1996
1997
1998
1999 if(! function_exists('get_mentions')) {
2000 function get_mentions($item) {
2001         $o = '';
2002         if(! strlen($item['tag']))
2003                 return $o;
2004
2005         $arr = explode(',',$item['tag']);
2006         foreach($arr as $x) {
2007                 $matches = null;
2008                 if(preg_match('/@\[url=([^\]]*)\]/',$x,$matches)) {
2009                         $o .= "\t\t" . '<link rel="mentioned" href="' . $matches[1] . '" />' . "\r\n";
2010                         $o .= "\t\t" . '<link rel="ostatus:attention" href="' . $matches[1] . '" />' . "\r\n";
2011                 }
2012         }
2013         return $o;
2014 }}
2015
2016 if(! function_exists('contact_block')) {
2017 function contact_block() {
2018         $o = '';
2019         $a = get_app();
2020
2021         $shown = get_pconfig($a->profile['uid'],'system','display_friend_count');
2022         if(! $shown)
2023                 $shown = 24;
2024
2025         if((! is_array($a->profile)) || ($a->profile['hide-friends']))
2026                 return $o;
2027         $r = q("SELECT COUNT(*) AS `total` FROM `contact` WHERE `uid` = %d AND `self` = 0 AND `blocked` = 0 and `pending` = 0",
2028                         intval($a->profile['uid'])
2029         );
2030         if(count($r)) {
2031                 $total = intval($r[0]['total']);
2032         }
2033         if(! $total) {
2034                 $o .= '<h4 class="contact-h4">' . t('No contacts') . '</h4>';
2035                 return $o;
2036         }
2037         $r = q("SELECT * FROM `contact` WHERE `uid` = %d AND `self` = 0 AND `blocked` = 0 and `pending` = 0 ORDER BY RAND() LIMIT %d",
2038                         intval($a->profile['uid']),
2039                         intval($shown)
2040         );
2041         if(count($r)) {
2042                 $o .= '<h4 class="contact-h4">' .  sprintf( tt('%d Contact','%d Contacts', $total),$total) . '</h4><div id="contact-block">';
2043                 foreach($r as $rr) {
2044                         $o .= micropro($rr,true,'mpfriend');
2045                 }
2046                 $o .= '</div><div id="contact-block-end"></div>';
2047                 $o .=  '<div id="viewcontacts"><a id="viewcontacts-link" href="viewcontacts/' . $a->profile['nickname'] . '">' . t('View Contacts') . '</a></div>';
2048                 
2049         }
2050
2051         $arr = array('contacts' => $r, 'output' => $o);
2052
2053         call_hooks('contact_block_end', $arr);
2054         return $o;
2055
2056 }}
2057
2058 if(! function_exists('micropro')) {
2059 function micropro($contact, $redirect = false, $class = '', $textmode = false) {
2060
2061         if($class)
2062                 $class = ' ' . $class;
2063
2064         $url = $contact['url'];
2065         $sparkle = '';
2066
2067         if($redirect) {
2068                 $a = get_app();
2069                 $redirect_url = $a->get_baseurl() . '/redir/' . $contact['id'];
2070                 if(local_user() && ($contact['uid'] == local_user()) && ($contact['network'] === 'dfrn')) {
2071                         $url = $redirect_url;
2072                         $sparkle = ' sparkle';
2073                 }
2074         }
2075         $click = ((x($contact,'click')) ? ' onclick="' . $contact['click'] . '" ' : '');
2076         if($click)
2077                 $url = '';
2078         if($textmode) {
2079                 return '<div class="contact-block-textdiv' . $class . '"><a class="contact-block-link' . $class . $sparkle 
2080                         . (($click) ? ' fakelink' : '') . '" '
2081                         . (($url) ? ' href="' . $url . '"' : '') . $click
2082                         . '" title="' . $contact['name'] . ' [' . $contact['url'] . ']" alt="' . $contact['name'] 
2083                         . '" >'. $contact['name'] . '</a></div>' . "\r\n";
2084         }
2085         else {
2086                 return '<div class="contact-block-div' . $class . '"><a class="contact-block-link' . $class . $sparkle 
2087                         . (($click) ? ' fakelink' : '') . '" '
2088                         . (($url) ? ' href="' . $url . '"' : '') . $click . ' ><img class="contact-block-img' . $class . $sparkle . '" src="' 
2089                         . $contact['micro'] . '" title="' . $contact['name'] . ' [' . $contact['url'] . ']" alt="' . $contact['name'] 
2090                         . '" /></a></div>' . "\r\n";
2091         }
2092 }}
2093
2094
2095
2096 if(! function_exists('search')) {
2097 function search($s) {
2098         $a = get_app();
2099         $o  = '<div id="search-box">';
2100         $o .= '<form action="' . $a->get_baseurl() . '/search' . '" method="get" >';
2101         $o .= '<input type="text" name="search" id="search-text" value="' . $s .'" />';
2102         $o .= '<input type="submit" name="submit" id="search-submit" value="' . t('Search') . '" />'; 
2103         $o .= '</form></div>';
2104         return $o;
2105 }}
2106
2107 if(! function_exists('valid_email')) {
2108 function valid_email($x){
2109         if(preg_match('/^[_a-zA-Z0-9-]+(\.[_a-zA-Z0-9-]+)*@[a-zA-Z0-9-]+(\.[a-zA-Z0-9-]+)+$/',$x))
2110                 return true;
2111         return false;
2112 }}
2113
2114
2115 if(! function_exists('gravatar_img')) {
2116 function gravatar_img($email) {
2117         $size = 175;
2118         $opt = 'identicon';   // psuedo-random geometric pattern if not found
2119         $rating = 'pg';
2120         $hash = md5(trim(strtolower($email)));
2121         
2122         $url = 'http://www.gravatar.com/avatar/' . $hash . '.jpg' 
2123                 . '?s=' . $size . '&d=' . $opt . '&r=' . $rating;
2124
2125         logger('gravatar: ' . $email . ' ' . $url);
2126         return $url;
2127 }}
2128
2129 if(! function_exists('aes_decrypt')) {
2130 function aes_decrypt($val,$ky)
2131 {
2132     $key="\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0";
2133     for($a=0;$a<strlen($ky);$a++)
2134       $key[$a%16]=chr(ord($key[$a%16]) ^ ord($ky[$a]));
2135     $mode = MCRYPT_MODE_ECB;
2136     $enc = MCRYPT_RIJNDAEL_128;
2137     $dec = @mcrypt_decrypt($enc, $key, $val, $mode, @mcrypt_create_iv( @mcrypt_get_iv_size($enc, $mode), MCRYPT_DEV_URANDOM ) );
2138     return rtrim($dec,(( ord(substr($dec,strlen($dec)-1,1))>=0 and ord(substr($dec, strlen($dec)-1,1))<=16)? chr(ord( substr($dec,strlen($dec)-1,1))):null));
2139 }}
2140
2141
2142 if(! function_exists('aes_encrypt')) {
2143 function aes_encrypt($val,$ky)
2144 {
2145     $key="\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0";
2146     for($a=0;$a<strlen($ky);$a++)
2147       $key[$a%16]=chr(ord($key[$a%16]) ^ ord($ky[$a]));
2148     $mode=MCRYPT_MODE_ECB;
2149     $enc=MCRYPT_RIJNDAEL_128;
2150     $val=str_pad($val, (16*(floor(strlen($val) / 16)+(strlen($val) % 16==0?2:1))), chr(16-(strlen($val) % 16)));
2151     return mcrypt_encrypt($enc, $key, $val, $mode, mcrypt_create_iv( mcrypt_get_iv_size($enc, $mode), MCRYPT_DEV_URANDOM));
2152 }} 
2153
2154
2155 /**
2156  *
2157  * Function: linkify
2158  *
2159  * Replace naked text hyperlink with HTML formatted hyperlink
2160  *
2161  */
2162
2163 if(! function_exists('linkify')) {
2164 function linkify($s) {
2165         $s = preg_replace("/(https?\:\/\/[a-zA-Z0-9\:\/\-\?\&\.\=\_\~\#\'\%\$\!\+]*)/", ' <a href="$1" target="external-link">$1</a>', $s);
2166         return($s);
2167 }}
2168
2169
2170 /**
2171  * 
2172  * Function: smilies
2173  *
2174  * Description:
2175  * Replaces text emoticons with graphical images
2176  *
2177  * @Parameter: string $s
2178  *
2179  * Returns string
2180  */
2181
2182 if(! function_exists('smilies')) {
2183 function smilies($s) {
2184         $a = get_app();
2185
2186         return str_replace(
2187         array( '&lt;3', '&lt;/3', '&lt;\\3', ':-)', ';-)', ':-(', ':(', ':-P', ':P', ':-"', ':-x', ':-X', ':-D', '8-|', '8-O'),
2188         array(
2189                 '<img src="' . $a->get_baseurl() . '/images/smiley-heart.gif" alt="<3" />',
2190                 '<img src="' . $a->get_baseurl() . '/images/smiley-brokenheart.gif" alt="</3" />',
2191                 '<img src="' . $a->get_baseurl() . '/images/smiley-brokenheart.gif" alt="<\\3" />',
2192                 '<img src="' . $a->get_baseurl() . '/images/smiley-smile.gif" alt=":-)" />',
2193                 '<img src="' . $a->get_baseurl() . '/images/smiley-wink.gif" alt=";-)" />',
2194                 '<img src="' . $a->get_baseurl() . '/images/smiley-frown.gif" alt=":-(" />',
2195                 '<img src="' . $a->get_baseurl() . '/images/smiley-frown.gif" alt=":(" />',
2196                 '<img src="' . $a->get_baseurl() . '/images/smiley-tongue-out.gif" alt=":-P" />',
2197                 '<img src="' . $a->get_baseurl() . '/images/smiley-tongue-out.gif" alt=":P" />',
2198                 '<img src="' . $a->get_baseurl() . '/images/smiley-kiss.gif" alt=":-\"" />',
2199                 '<img src="' . $a->get_baseurl() . '/images/smiley-kiss.gif" alt=":-x" />',
2200                 '<img src="' . $a->get_baseurl() . '/images/smiley-kiss.gif" alt=":-X" />',
2201                 '<img src="' . $a->get_baseurl() . '/images/smiley-laughing.gif" alt=":-D" />',
2202                 '<img src="' . $a->get_baseurl() . '/images/smiley-surprised.gif" alt="8-|" />',
2203                 '<img src="' . $a->get_baseurl() . '/images/smiley-surprised.gif" alt="8-O" />'
2204         ), $s);
2205 }}
2206
2207
2208 /**
2209  *
2210  * Function : profile_load
2211  * @parameter App    $a
2212  * @parameter string $nickname
2213  * @parameter int    $profile
2214  *
2215  * Summary: Loads a profile into the page sidebar. 
2216  * The function requires a writeable copy of the main App structure, and the nickname
2217  * of a registered local account.
2218  *
2219  * If the viewer is an authenticated remote viewer, the profile displayed is the
2220  * one that has been configured for his/her viewing in the Contact manager.
2221  * Passing a non-zero profile ID can also allow a preview of a selected profile
2222  * by the owner.
2223  *
2224  * Profile information is placed in the App structure for later retrieval.
2225  * Honours the owner's chosen theme for display. 
2226  *
2227  */
2228
2229 if(! function_exists('profile_load')) {
2230 function profile_load(&$a, $nickname, $profile = 0) {
2231         if(remote_user()) {
2232                 $r = q("SELECT `profile-id` FROM `contact` WHERE `id` = %d LIMIT 1",
2233                         intval($_SESSION['visitor_id']));
2234                 if(count($r))
2235                         $profile = $r[0]['profile-id'];
2236         } 
2237
2238         $r = null;
2239
2240         if($profile) {
2241                 $profile_int = intval($profile);
2242                 $r = q("SELECT `profile`.`uid` AS `profile_uid`, `profile`.* , `user`.* FROM `profile` 
2243                         LEFT JOIN `user` ON `profile`.`uid` = `user`.`uid`
2244                         WHERE `user`.`nickname` = '%s' AND `profile`.`id` = %d LIMIT 1",
2245                         dbesc($nickname),
2246                         intval($profile_int)
2247                 );
2248         }
2249         if(! count($r)) {       
2250                 $r = q("SELECT `profile`.`uid` AS `profile_uid`, `profile`.* , `user`.* FROM `profile` 
2251                         LEFT JOIN `user` ON `profile`.`uid` = `user`.`uid`
2252                         WHERE `user`.`nickname` = '%s' AND `profile`.`is-default` = 1 LIMIT 1",
2253                         dbesc($nickname)
2254                 );
2255         }
2256
2257         if(($r === false) || (! count($r))) {
2258                 notice( t('No profile') . EOL );
2259                 $a->error = 404;
2260                 return;
2261         }
2262
2263         $a->profile = $r[0];
2264
2265
2266         $a->page['title'] = $a->profile['name'] . " @ " . $a->config['sitename'];
2267         $_SESSION['theme'] = $a->profile['theme'];
2268
2269         if(! (x($a->page,'aside')))
2270                 $a->page['aside'] = '';
2271
2272         $a->page['aside'] .= profile_sidebar($a->profile);
2273         $a->page['aside'] .= contact_block();
2274
2275         return;
2276 }}
2277
2278
2279 /**
2280  *
2281  * Function: profile_sidebar
2282  *
2283  * Formats a profile for display in the sidebar.
2284  * It is very difficult to templatise the HTML completely
2285  * because of all the conditional logic.
2286  *
2287  * @parameter: array $profile
2288  *
2289  * Returns HTML string stuitable for sidebar inclusion
2290  * Exceptions: Returns empty string if passed $profile is wrong type or not populated
2291  *
2292  */
2293
2294
2295 if(! function_exists('profile_sidebar')) {
2296 function profile_sidebar($profile) {
2297
2298         $o = '';
2299         $location = '';
2300         $address = false;
2301
2302         if((! is_array($profile)) && (! count($profile)))
2303                 return $o;
2304
2305         call_hooks('profile_sidebar_enter', $profile);
2306
2307         $fullname = '<div class="fn">' . $profile['name'] . '</div>';
2308
2309         $pdesc = '<div class="title">' . $profile['pdesc'] . '</div>';
2310
2311         $tabs = '';
2312
2313         $photo = '<div id="profile-photo-wrapper"><img class="photo" src="' . $profile['photo'] . '" alt="' . $profile['name'] . '" /></div>';
2314
2315         // don't show connect link to yourself
2316         
2317         $connect = (($profile['uid'] != local_user()) ? '<li><a id="dfrn-request-link" href="dfrn_request/' . $profile['nickname'] . '">' . t('Connect') . '</a></li>' : '');
2318
2319         // don't show connect link to authenticated visitors either
2320
2321         if((remote_user()) && ($_SESSION['visitor_visiting'] == $profile['uid']))
2322                 $connect = ''; 
2323
2324         if((x($profile,'address') == 1) 
2325                 || (x($profile,'locality') == 1) 
2326                 || (x($profile,'region') == 1) 
2327                 || (x($profile,'postal-code') == 1) 
2328                 || (x($profile,'country-name') == 1))
2329                 $address = true;
2330
2331         if($address) {
2332                 $location .= '<div class="location"><span class="location-label">' . t('Location:') . '</span> <div class="adr">';
2333                 $location .= ((x($profile,'address') == 1) ? '<div class="street-address">' . $profile['address'] . '</div>' : '');
2334                 $location .= (((x($profile,'locality') == 1) || (x($profile,'region') == 1) || (x($profile,'postal-code') == 1)) 
2335                         ? '<span class="city-state-zip"><span class="locality">' . $profile['locality'] . '</span>' 
2336                         . ((x($profile['locality']) == 1) ? t(', ') : '') 
2337                         . '<span class="region">' . $profile['region'] . '</span>'
2338                         . ' <span class="postal-code">' . $profile['postal-code'] . '</span></span>' : '');
2339                 $location .= ((x($profile,'country-name') == 1) ? ' <span class="country-name">' . $profile['country-name'] . '</span>' : '');  
2340                 $location .= '</div></div><div class="profile-clear"></div>';
2341
2342         }
2343
2344         $gender = ((x($profile,'gender') == 1) ? '<div class="mf"><span class="gender-label">' . t('Gender:') . '</span> <span class="x-gender">' . $profile['gender'] . '</span></div><div class="profile-clear"></div>' : '');
2345
2346         $pubkey = ((x($profile,'pubkey') == 1) ? '<div class="key" style="display:none;">' . $profile['pubkey'] . '</div>' : '');
2347
2348         $marital = ((x($profile,'marital') == 1) ? '<div class="marital"><span class="marital-label"><span class="heart">&hearts;</span> ' . t('Status:') . ' </span><span class="marital-text">' . $profile['marital'] . '</span></div><div class="profile-clear"></div>' : '');
2349
2350         $homepage = ((x($profile,'homepage') == 1) ? '<div class="homepage"><span class="homepage-label">' . t('Homepage:') . ' </span><span class="homepage-url">' . linkify($profile['homepage']) . '</span></div><div class="profile-clear"></div>' : '');
2351
2352         $tpl = get_markup_template('profile_vcard.tpl');
2353
2354         $o .= replace_macros($tpl, array(
2355                 '$fullname' => $fullname,
2356                 '$pdesc'    => $pdesc,
2357                 '$tabs'     => $tabs,
2358                 '$photo'    => $photo,
2359                 '$connect'  => $connect,                
2360                 '$location' => $location,
2361                 '$gender'   => $gender,
2362                 '$pubkey'   => $pubkey,
2363                 '$marital'  => $marital,
2364                 '$homepage' => $homepage
2365         ));
2366
2367
2368         $arr = array('profile' => $profile, 'entry' => $o);
2369
2370         call_hooks('profile_sidebar', $arr);
2371
2372         return $o;
2373 }}
2374
2375
2376 if(! function_exists('register_hook')) {
2377 function register_hook($hook,$file,$function) {
2378
2379         $r = q("SELECT * FROM `hook` WHERE `hook` = '%s' AND `file` = '%s' AND `function` = '%s' LIMIT 1",
2380                 dbesc($hook),
2381                 dbesc($file),
2382                 dbesc($function)
2383         );
2384         if(count($r))
2385                 return true;
2386
2387         $r = q("INSERT INTO `hook` (`hook`, `file`, `function`) VALUES ( '%s', '%s', '%s' ) ",
2388                 dbesc($hook),
2389                 dbesc($file),
2390                 dbesc($function)
2391         );
2392         return $r;
2393 }}
2394
2395 if(! function_exists('unregister_hook')) {
2396 function unregister_hook($hook,$file,$function) {
2397
2398         $r = q("DELETE FROM `hook` WHERE `hook` = '%s' AND `file` = '%s' AND `function` = '%s' LIMIT 1",
2399                 dbesc($hook),
2400                 dbesc($file),
2401                 dbesc($function)
2402         );
2403         return $r;
2404 }}
2405
2406
2407 if(! function_exists('load_hooks')) {
2408 function load_hooks() {
2409         $a = get_app();
2410         $a->hooks = array();
2411         $r = q("SELECT * FROM `hook` WHERE 1");
2412         if(count($r)) {
2413                 foreach($r as $rr) {
2414                         $a->hooks[] = array($rr['hook'], $rr['file'], $rr['function']);
2415                 }
2416         }
2417 }}
2418
2419
2420 if(! function_exists('call_hooks')) {
2421 function call_hooks($name, &$data = null) {
2422         $a = get_app();
2423
2424         if(count($a->hooks)) {
2425                 foreach($a->hooks as $hook) {
2426                         if($hook[HOOK_HOOK] === $name) {
2427                                 @include_once($hook[HOOK_FILE]);
2428                                 if(function_exists($hook[HOOK_FUNCTION])) {
2429                                         $func = $hook[HOOK_FUNCTION];
2430                                         $func($a,$data);
2431                                 }
2432                         }
2433                 }
2434         }
2435 }}
2436
2437
2438 if(! function_exists('day_translate')) {
2439 function day_translate($s) {
2440         $ret = str_replace(array('Monday','Tuesday','Wednesday','Thursday','Friday','Saturday','Sunday'),
2441                 array( t('Monday'), t('Tuesday'), t('Wednesday'), t('Thursday'), t('Friday'), t('Saturday'), t('Sunday')),
2442                 $s);
2443
2444         $ret = str_replace(array('January','February','March','April','May','June','July','August','September','October','November','December'),
2445                 array( t('January'), t('February'), t('March'), t('April'), t('May'), t('June'), t('July'), t('August'), t('September'), t('October'), t('November'), t('December')),
2446                 $ret);
2447
2448         return $ret;
2449 }}
2450
2451 if(! function_exists('get_birthdays')) {
2452 function get_birthdays() {
2453
2454         $a = get_app();
2455         $o = '';
2456
2457         if(! local_user())
2458                 return $o;
2459
2460         $bd_format = t('g A l F d') ; // 8 AM Friday January 18
2461
2462         $r = q("SELECT `event`.*, `event`.`id` AS `eid`, `contact`.* FROM `event` 
2463                 LEFT JOIN `contact` ON `contact`.`id` = `event`.`cid` 
2464                 WHERE `event`.`uid` = %d AND `type` = 'birthday' AND `start` < '%s' AND `finish` > '%s' 
2465                 ORDER BY `start` DESC ",
2466                 intval(local_user()),
2467                 dbesc(datetime_convert('UTC','UTC','now + 6 days')),
2468                 dbesc(datetime_convert('UTC','UTC','now'))
2469         );
2470
2471         if($r && count($r)) {
2472                 $total = 0;
2473                 foreach($r as $rr)
2474                         if(strlen($rr['name']))
2475                                 $total ++;
2476
2477                 if($total) {
2478                         $o .= '<div id="birthday-notice" class="birthday-notice fakelink" onclick=openClose(\'birthday-wrapper\'); >' . t('Birthday Reminders') . ' ' . '(' . $total . ')' . '</div>'; 
2479                         $o .= '<div id="birthday-wrapper" style="display: none;" ><div id="birthday-title">' . t('Birthdays this week:') . '</div>'; 
2480                         $o .= '<div id="birthday-adjust">' . t("\x28Adjusted for local time\x29") . '</div>';
2481                         $o .= '<div id="birthday-title-end"></div>';
2482
2483                         foreach($r as $rr) {
2484                                 if(! strlen($rr['name']))
2485                                         continue;
2486                                 $now = strtotime('now');
2487                                 $today = (((strtotime($rr['start'] . ' +00:00') < $now) && (strtotime($rr['finish'] . ' +00:00') > $now)) ? true : false); 
2488         
2489                                 $o .= '<div class="birthday-list" id="birthday-' . $rr['eid'] . '"><a class="sparkle" href="' 
2490                                 . $a->get_baseurl() . '/redir/'  . $rr['cid'] . '">' . $rr['name'] . '</a> ' 
2491                                 . day_translate(datetime_convert('UTC', $a->timezone, $rr['start'], $bd_format)) . (($today) ?  ' ' . t('[today]') : '')
2492                                 . '</div>' ;
2493                         }
2494                         $o .= '</div></div>';
2495                 }
2496         }
2497         return $o;
2498 }}
2499
2500
2501 if(! function_exists('normalise_link')) {
2502 function normalise_link($url) {
2503         $ret = str_replace(array('https:','//www.'), array('http:','//'), $url);
2504         return(rtrim($ret,'/'));
2505 }}
2506
2507 /**
2508  *
2509  * Compare two URLs to see if they are the same, but ignore
2510  * slight but hopefully insignificant differences such as if one 
2511  * is https and the other isn't, or if one is www.something and 
2512  * the other isn't - and also ignore case differences.
2513  *
2514  * Return true if the URLs match, otherwise false.
2515  *
2516  */
2517
2518 if(! function_exists('link_compare')) {
2519 function link_compare($a,$b) {
2520         if(strcasecmp(normalise_link($a),normalise_link($b)) === 0)
2521                 return true;
2522         return false;
2523 }}
2524
2525
2526 if(! function_exists('prepare_body')) {
2527 function prepare_body($item) {
2528         return prepare_text($item['body']);
2529 }}
2530
2531 if(! function_exists('prepare_text')) {
2532 function prepare_text($text) {
2533
2534         require_once('include/bbcode.php');
2535
2536         $s = smilies(bbcode($text));
2537
2538         return $s;
2539 }}
2540
2541 /**
2542  * 
2543  * Wrap calls to proc_close(proc_open()) and call hook
2544  * so plugins can take part in process :)
2545  * 
2546  * args:
2547  * $cmd program to run
2548  *  next args are passed as $cmd command line
2549  * 
2550  * e.g.: proc_run("ls","-la","/tmp");
2551  * 
2552  * $cmd and string args are surrounded with ""
2553  */
2554
2555 if(! function_exists('proc_run')) {
2556 function proc_run($cmd){
2557
2558         $a = get_app();
2559
2560         $args = func_get_args();
2561         call_hooks("proc_run", $args);
2562
2563         if(count($args) && $args[0] === 'php')
2564         $args[0] = ((x($a->config,'php_path')) && (strlen($a->config['php_path'])) ? $a->config['php_path'] : 'php');
2565         
2566         foreach ($args as $arg){
2567                 $arg = escapeshellarg($arg);
2568         }
2569         $cmdline = implode($args," ");
2570         proc_close(proc_open($cmdline." &",array(),$foo));
2571 }}
2572
2573 if(! function_exists('current_theme')) {
2574 function current_theme(){
2575         $app_base_themes = array('duepuntozero', 'loozah');
2576         
2577         $a = get_app();
2578         
2579         $system_theme = ((isset($a->config['system']['theme'])) ? $a->config['system']['theme'] : '');
2580         $theme_name = ((is_array($_SESSION) && x($_SESSION,'theme')) ? $_SESSION['theme'] : $system_theme);
2581         
2582         if($theme_name && file_exists('view/theme/' . $theme_name . '/style.css'))
2583                 return($theme_name);
2584         
2585         foreach($app_base_themes as $t) {
2586                 if(file_exists('view/theme/' . $t . '/style.css'))
2587                         return($t);
2588         }
2589         
2590         $fallback = glob('view/theme/*/style.css');
2591         if(count($fallback))
2592                 return (str_replace('view/theme/','', str_replace("/style.css","",$fallback[0])));
2593
2594 }}
2595
2596 /*
2597 * Return full URL to theme which is currently in effect.
2598 * Provide a sane default if nothing is chosen or the specified theme does not exist.
2599 */
2600 if(! function_exists('current_theme_url')) {
2601 function current_theme_url() {
2602         global $a;
2603         $t = current_theme();
2604         return($a->get_baseurl() . '/view/theme/' . $t . '/style.css');
2605 }}
2606
2607 if(! function_exists('feed_birthday')) {
2608 function feed_birthday($uid,$tz) {
2609
2610         /**
2611          *
2612          * Determine the next birthday, but only if the birthday is published
2613          * in the default profile. We _could_ also look for a private profile that the
2614          * recipient can see, but somebody could get mad at us if they start getting
2615          * public birthday greetings when they haven't made this info public. 
2616          *
2617          * Assuming we are able to publish this info, we are then going to convert
2618          * the start time from the owner's timezone to UTC. 
2619          *
2620          * This will potentially solve the problem found with some social networks
2621          * where birthdays are converted to the viewer's timezone and salutations from
2622          * elsewhere in the world show up on the wrong day. We will convert it to the
2623          * viewer's timezone also, but first we are going to convert it from the birthday
2624          * person's timezone to GMT - so the viewer may find the birthday starting at
2625          * 6:00PM the day before, but that will correspond to midnight to the birthday person.
2626          *
2627          */
2628
2629         $birthday = '';
2630
2631         $p = q("SELECT `dob` FROM `profile` WHERE `is-default` = 1 AND `uid` = %d LIMIT 1",
2632                 intval($uid)
2633         );
2634
2635         if($p && count($p)) {
2636                 $tmp_dob = substr($p[0]['dob'],5);
2637                 if(intval($tmp_dob)) {
2638                         $y = datetime_convert($tz,$tz,'now','Y');
2639                         $bd = $y . '-' . $tmp_dob . ' 00:00';
2640                         $t_dob = strtotime($bd);
2641                         $now = strtotime(datetime_convert($tz,$tz,'now'));
2642                         if($t_dob < $now)
2643                                 $bd = $y + 1 . '-' . $tmp_dob . ' 00:00';
2644                         $birthday = datetime_convert($tz,'UTC',$bd,ATOM_TIME); 
2645                 }
2646         }
2647
2648         return $birthday;
2649 }}
2650
2651 /**
2652  * return atom link elements for all of our hubs
2653  */
2654
2655 if(! function_exists('feed_hublinks')) {
2656 function feed_hublinks() {
2657
2658         $hub = get_config('system','huburl');
2659
2660         $hubxml = '';
2661         if(strlen($hub)) {
2662                 $hubs = explode(',', $hub);
2663                 if(count($hubs)) {
2664                         foreach($hubs as $h) {
2665                                 $h = trim($h);
2666                                 if(! strlen($h))
2667                                         continue;
2668                                 $hubxml .= '<link rel="hub" href="' . xmlify($h) . '" />' . "\n" ;
2669                         }
2670                 }
2671         }
2672         return $hubxml;
2673 }}
2674
2675 /* return atom link elements for salmon endpoints */
2676
2677 if(! function_exists('feed_salmonlinks')) {
2678 function feed_salmonlinks($nick) {
2679
2680         $a = get_app();
2681
2682         $salmon  = '<link rel="salmon" href="' . xmlify($a->get_baseurl() . '/salmon/' . $nick) . '" />' . "\n" ;
2683
2684         // old style links that status.net still needed as of 12/2010 
2685
2686         $salmon .= '  <link rel="http://salmon-protocol.org/ns/salmon-replies" href="' . xmlify($a->get_baseurl() . '/salmon/' . $nick) . '" />' . "\n" ; 
2687         $salmon .= '  <link rel="http://salmon-protocol.org/ns/salmon-mention" href="' . xmlify($a->get_baseurl() . '/salmon/' . $nick) . '" />' . "\n" ; 
2688         return $salmon;
2689 }}
2690
2691 if(! function_exists('get_plink')) {
2692 function get_plink($item) {
2693         $a = get_app(); 
2694         $plink = (((x($item,'plink')) && (! $item['private'])) ? '<div class="wall-item-links-wrapper"><a href="' 
2695                         . $item['plink'] . '" title="' . t('link to source') . '" target="external-link" class="icon remote-link"></a></div>' : '');
2696         return $plink;
2697 }}
2698
2699 if(! function_exists('unamp')) {
2700 function unamp($s) {
2701         return str_replace('&amp;', '&', $s);
2702 }}
2703
2704
2705 if(! function_exists('lang_selector')) {
2706 function lang_selector() {
2707         global $lang;
2708         $o .= '<div id="language-selector" style="display: none;" >';
2709         $o .= '<form action="" method="post" ><select name="system_language" onchange="this.form.submit();" >';
2710         $langs = glob('view/*/strings.php');
2711         if(is_array($langs) && count($langs)) {
2712                 if(! in_array('view/en/strings.php',$langs))
2713                         $langs[] = 'view/en/';
2714                 foreach($langs as $l) {
2715                         $ll = substr($l,5);
2716                         $ll = substr($ll,0,strrpos($ll,'/'));
2717                         $selected = (($ll === $lang) ? ' selected="selected" ' : '');
2718                         $o .= '<option value="' . $ll . '"' . $selected . '>' . $ll . '</option>';
2719                 }
2720         }
2721         $o .= '</select></form></div>';
2722         return $o;
2723 }}
2724
2725
2726 if(! function_exists('parse_xml_string')) {
2727 function parse_xml_string($s) {
2728         if(! strstr($s,'<?xml'))
2729                 return false;
2730         $s2 = substr($s,strpos($s,'<?xml'));
2731         libxml_use_internal_errors(true);
2732         $x = @simplexml_load_string($s2);
2733         if(count(libxml_get_errors()))
2734                 foreach(libxml_get_errors() as $err)
2735                         logger('libxml: parse: ' . $err->code." at ".$err->line.":".$err->column." : ".$err->message, LOGGER_DATA);
2736         libxml_clear_errors();
2737         return $x;
2738 }}
2739
2740 if(! function_exists('is_site_admin')) {
2741 function is_site_admin() {
2742         $a = get_app();
2743         if(local_user() && x($a->user,'email') && x($a->config,'admin_email') && ($a->user['email'] === $a->config['admin_email']))
2744                 return true;
2745         return false;
2746 }}