]> git.mxchange.org Git - friendica.git/blob - boot.php
ab1505d793511464acda87e5326d9f1baf9104c4
[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.975' );
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 = load_view_file('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) ? load_view_file("view/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 = load_view_file("view/logout.tpl");
856         }
857         else {
858                 $tpl = load_view_file("view/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 if(! function_exists('load_view_file')) {
1868 function load_view_file($s) {
1869         global $lang, $a;
1870         if(! isset($lang))
1871                 $lang = 'en';
1872         $b = basename($s);
1873         $d = dirname($s);
1874         if(file_exists("$d/$lang/$b"))
1875                 return file_get_contents("$d/$lang/$b");
1876         
1877         $theme = current_theme();
1878         
1879         if(file_exists("$d/theme/$theme/$b"))
1880                 return file_get_contents("$d/theme/$theme/$b");
1881                         
1882         return file_get_contents($s);
1883 }}
1884
1885 // for html,xml parsing - let's say you've got
1886 // an attribute foobar="class1 class2 class3"
1887 // and you want to find out if it contains 'class3'.
1888 // you can't use a normal sub string search because you
1889 // might match 'notclass3' and a regex to do the job is 
1890 // possible but a bit complicated. 
1891 // pass the attribute string as $attr and the attribute you 
1892 // are looking for as $s - returns true if found, otherwise false
1893
1894 if(! function_exists('attribute_contains')) {
1895 function attribute_contains($attr,$s) {
1896         $a = explode(' ', $attr);
1897         if(count($a) && in_array($s,$a))
1898                 return true;
1899         return false;
1900 }}
1901
1902 if(! function_exists('logger')) {
1903 function logger($msg,$level = 0) {
1904         $debugging = get_config('system','debugging');
1905         $loglevel  = intval(get_config('system','loglevel'));
1906         $logfile   = get_config('system','logfile');
1907
1908         if((! $debugging) || (! $logfile) || ($level > $loglevel))
1909                 return;
1910         
1911         @file_put_contents($logfile, datetime_convert() . ':' . session_id() . ' ' . $msg . "\n", FILE_APPEND);
1912         return;
1913 }}
1914
1915
1916 if(! function_exists('activity_match')) {
1917 function activity_match($haystack,$needle) {
1918         if(($haystack === $needle) || ((basename($needle) === $haystack) && strstr($needle,NAMESPACE_ACTIVITY_SCHEMA)))
1919                 return true;
1920         return false;
1921 }}
1922
1923
1924 // Pull out all #hashtags and @person tags from $s;
1925 // We also get @person@domain.com - which would make 
1926 // the regex quite complicated as tags can also
1927 // end a sentence. So we'll run through our results
1928 // and strip the period from any tags which end with one.
1929 // Returns array of tags found, or empty array.
1930
1931
1932 if(! function_exists('get_tags')) {
1933 function get_tags($s) {
1934         $ret = array();
1935
1936         // ignore anything in a code block
1937
1938         $s = preg_replace('/\[code\](.*?)\[\/code\]/sm','',$s);
1939
1940         if(preg_match_all('/([@#][^ \x0D\x0A,:?]+)([ \x0D\x0A,:?]|$)/',$s,$match)) {
1941                 foreach($match[1] as $match) {
1942                         if(strstr($match,"]")) {
1943                                 // we might be inside a bbcode color tag - leave it alone
1944                                 continue;
1945                         }
1946                         if(substr($match,-1,1) === '.')
1947                                 $ret[] = substr($match,0,-1);
1948                         else
1949                                 $ret[] = $match;
1950                 }
1951         }
1952
1953         return $ret;
1954 }}
1955
1956
1957 // quick and dirty quoted_printable encoding
1958
1959 if(! function_exists('qp')) {
1960 function qp($s) {
1961 return str_replace ("%","=",rawurlencode($s));
1962 }} 
1963
1964
1965
1966 if(! function_exists('get_mentions')) {
1967 function get_mentions($item) {
1968         $o = '';
1969         if(! strlen($item['tag']))
1970                 return $o;
1971
1972         $arr = explode(',',$item['tag']);
1973         foreach($arr as $x) {
1974                 $matches = null;
1975                 if(preg_match('/@\[url=([^\]]*)\]/',$x,$matches)) {
1976                         $o .= "\t\t" . '<link rel="mentioned" href="' . $matches[1] . '" />' . "\r\n";
1977                         $o .= "\t\t" . '<link rel="ostatus:attention" href="' . $matches[1] . '" />' . "\r\n";
1978                 }
1979         }
1980         return $o;
1981 }}
1982
1983 if(! function_exists('contact_block')) {
1984 function contact_block() {
1985         $o = '';
1986         $a = get_app();
1987
1988         $shown = get_pconfig($a->profile['uid'],'system','display_friend_count');
1989         if(! $shown)
1990                 $shown = 24;
1991
1992         if((! is_array($a->profile)) || ($a->profile['hide-friends']))
1993                 return $o;
1994         $r = q("SELECT COUNT(*) AS `total` FROM `contact` WHERE `uid` = %d AND `self` = 0 AND `blocked` = 0 and `pending` = 0",
1995                         intval($a->profile['uid'])
1996         );
1997         if(count($r)) {
1998                 $total = intval($r[0]['total']);
1999         }
2000         if(! $total) {
2001                 $o .= '<h4 class="contact-h4">' . t('No contacts') . '</h4>';
2002                 return $o;
2003         }
2004         $r = q("SELECT * FROM `contact` WHERE `uid` = %d AND `self` = 0 AND `blocked` = 0 and `pending` = 0 ORDER BY RAND() LIMIT %d",
2005                         intval($a->profile['uid']),
2006                         intval($shown)
2007         );
2008         if(count($r)) {
2009                 $o .= '<h4 class="contact-h4">' .  sprintf( tt('%d Contact','%d Contacts', $total),$total) . '</h4><div id="contact-block">';
2010                 foreach($r as $rr) {
2011                         $o .= micropro($rr,true,'mpfriend');
2012                 }
2013                 $o .= '</div><div id="contact-block-end"></div>';
2014                 $o .=  '<div id="viewcontacts"><a id="viewcontacts-link" href="viewcontacts/' . $a->profile['nickname'] . '">' . t('View Contacts') . '</a></div>';
2015                 
2016         }
2017
2018         $arr = array('contacts' => $r, 'output' => $o);
2019
2020         call_hooks('contact_block_end', $arr);
2021         return $o;
2022
2023 }}
2024
2025 if(! function_exists('micropro')) {
2026 function micropro($contact, $redirect = false, $class = '') {
2027
2028         if($class)
2029                 $class = ' ' . $class;
2030
2031         $url = $contact['url'];
2032         $sparkle = '';
2033
2034         if($redirect) {
2035                 $a = get_app();
2036                 $redirect_url = $a->get_baseurl() . '/redir/' . $contact['id'];
2037                 if(local_user() && ($contact['uid'] == local_user()) && ($contact['network'] === 'dfrn')) {
2038                         $url = $redirect_url;
2039                         $sparkle = ' sparkle';
2040                 }
2041         }
2042         $click = ((x($contact,'click')) ? ' onclick="' . $contact['click'] . '" ' : '');
2043         if($click)
2044                 $url = '';
2045         return '<div class="contact-block-div' . $class . '"><a class="contact-block-link' . $class . $sparkle 
2046                 . (($click) ? ' fakelink' : '') . '" '
2047                 . (($url) ? ' href="' . $url . '"' : '') . $click . ' ><img class="contact-block-img' . $class . $sparkle . '" src="' 
2048                 . $contact['micro'] . '" title="' . $contact['name'] . ' [' . $contact['url'] . ']" alt="' . $contact['name'] 
2049                 . '" /></a></div>' . "\r\n";
2050 }}
2051
2052
2053
2054 if(! function_exists('search')) {
2055 function search($s) {
2056         $a = get_app();
2057         $o  = '<div id="search-box">';
2058         $o .= '<form action="' . $a->get_baseurl() . '/search' . '" method="get" >';
2059         $o .= '<input type="text" name="search" id="search-text" value="' . $s .'" />';
2060         $o .= '<input type="submit" name="submit" id="search-submit" value="' . t('Search') . '" />'; 
2061         $o .= '</form></div>';
2062         return $o;
2063 }}
2064
2065 if(! function_exists('valid_email')) {
2066 function valid_email($x){
2067         if(preg_match('/^[_a-zA-Z0-9-]+(\.[_a-zA-Z0-9-]+)*@[a-zA-Z0-9-]+(\.[a-zA-Z0-9-]+)+$/',$x))
2068                 return true;
2069         return false;
2070 }}
2071
2072
2073 if(! function_exists('gravatar_img')) {
2074 function gravatar_img($email) {
2075         $size = 175;
2076         $opt = 'identicon';   // psuedo-random geometric pattern if not found
2077         $rating = 'pg';
2078         $hash = md5(trim(strtolower($email)));
2079         
2080         $url = 'http://www.gravatar.com/avatar/' . $hash . '.jpg' 
2081                 . '?s=' . $size . '&d=' . $opt . '&r=' . $rating;
2082
2083         logger('gravatar: ' . $email . ' ' . $url);
2084         return $url;
2085 }}
2086
2087 if(! function_exists('aes_decrypt')) {
2088 function aes_decrypt($val,$ky)
2089 {
2090     $key="\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0";
2091     for($a=0;$a<strlen($ky);$a++)
2092       $key[$a%16]=chr(ord($key[$a%16]) ^ ord($ky[$a]));
2093     $mode = MCRYPT_MODE_ECB;
2094     $enc = MCRYPT_RIJNDAEL_128;
2095     $dec = @mcrypt_decrypt($enc, $key, $val, $mode, @mcrypt_create_iv( @mcrypt_get_iv_size($enc, $mode), MCRYPT_DEV_URANDOM ) );
2096     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));
2097 }}
2098
2099
2100 if(! function_exists('aes_encrypt')) {
2101 function aes_encrypt($val,$ky)
2102 {
2103     $key="\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0";
2104     for($a=0;$a<strlen($ky);$a++)
2105       $key[$a%16]=chr(ord($key[$a%16]) ^ ord($ky[$a]));
2106     $mode=MCRYPT_MODE_ECB;
2107     $enc=MCRYPT_RIJNDAEL_128;
2108     $val=str_pad($val, (16*(floor(strlen($val) / 16)+(strlen($val) % 16==0?2:1))), chr(16-(strlen($val) % 16)));
2109     return mcrypt_encrypt($enc, $key, $val, $mode, mcrypt_create_iv( mcrypt_get_iv_size($enc, $mode), MCRYPT_DEV_URANDOM));
2110 }} 
2111
2112
2113 /**
2114  *
2115  * Function: linkify
2116  *
2117  * Replace naked text hyperlink with HTML formatted hyperlink
2118  *
2119  */
2120
2121 if(! function_exists('linkify')) {
2122 function linkify($s) {
2123         $s = preg_replace("/(https?\:\/\/[a-zA-Z0-9\:\/\-\?\&\.\=\_\~\#\'\%\$\!\+]*)/", ' <a href="$1" target="external-link">$1</a>', $s);
2124         return($s);
2125 }}
2126
2127
2128 /**
2129  * 
2130  * Function: smilies
2131  *
2132  * Description:
2133  * Replaces text emoticons with graphical images
2134  *
2135  * @Parameter: string $s
2136  *
2137  * Returns string
2138  */
2139
2140 if(! function_exists('smilies')) {
2141 function smilies($s) {
2142         $a = get_app();
2143
2144         return str_replace(
2145         array( '&lt;3', '&lt;/3', '&lt;\\3', ':-)', ';-)', ':-(', ':(', ':-P', ':P', ':-"', ':-x', ':-X', ':-D', '8-|', '8-O'),
2146         array(
2147                 '<img src="' . $a->get_baseurl() . '/images/smiley-heart.gif" alt="<3" />',
2148                 '<img src="' . $a->get_baseurl() . '/images/smiley-brokenheart.gif" alt="</3" />',
2149                 '<img src="' . $a->get_baseurl() . '/images/smiley-brokenheart.gif" alt="<\\3" />',
2150                 '<img src="' . $a->get_baseurl() . '/images/smiley-smile.gif" alt=":-)" />',
2151                 '<img src="' . $a->get_baseurl() . '/images/smiley-wink.gif" alt=";-)" />',
2152                 '<img src="' . $a->get_baseurl() . '/images/smiley-frown.gif" alt=":-(" />',
2153                 '<img src="' . $a->get_baseurl() . '/images/smiley-frown.gif" alt=":(" />',
2154                 '<img src="' . $a->get_baseurl() . '/images/smiley-tongue-out.gif" alt=":-P" />',
2155                 '<img src="' . $a->get_baseurl() . '/images/smiley-tongue-out.gif" alt=":P" />',
2156                 '<img src="' . $a->get_baseurl() . '/images/smiley-kiss.gif" alt=":-\"" />',
2157                 '<img src="' . $a->get_baseurl() . '/images/smiley-kiss.gif" alt=":-x" />',
2158                 '<img src="' . $a->get_baseurl() . '/images/smiley-kiss.gif" alt=":-X" />',
2159                 '<img src="' . $a->get_baseurl() . '/images/smiley-laughing.gif" alt=":-D" />',
2160                 '<img src="' . $a->get_baseurl() . '/images/smiley-surprised.gif" alt="8-|" />',
2161                 '<img src="' . $a->get_baseurl() . '/images/smiley-surprised.gif" alt="8-O" />'
2162         ), $s);
2163 }}
2164
2165
2166 /**
2167  *
2168  * Function : profile_load
2169  * @parameter App    $a
2170  * @parameter string $nickname
2171  * @parameter int    $profile
2172  *
2173  * Summary: Loads a profile into the page sidebar. 
2174  * The function requires a writeable copy of the main App structure, and the nickname
2175  * of a registered local account.
2176  *
2177  * If the viewer is an authenticated remote viewer, the profile displayed is the
2178  * one that has been configured for his/her viewing in the Contact manager.
2179  * Passing a non-zero profile ID can also allow a preview of a selected profile
2180  * by the owner.
2181  *
2182  * Profile information is placed in the App structure for later retrieval.
2183  * Honours the owner's chosen theme for display. 
2184  *
2185  */
2186
2187 if(! function_exists('profile_load')) {
2188 function profile_load(&$a, $nickname, $profile = 0) {
2189         if(remote_user()) {
2190                 $r = q("SELECT `profile-id` FROM `contact` WHERE `id` = %d LIMIT 1",
2191                         intval($_SESSION['visitor_id']));
2192                 if(count($r))
2193                         $profile = $r[0]['profile-id'];
2194         } 
2195
2196         $r = null;
2197
2198         if($profile) {
2199                 $profile_int = intval($profile);
2200                 $r = q("SELECT `profile`.`uid` AS `profile_uid`, `profile`.* , `user`.* FROM `profile` 
2201                         LEFT JOIN `user` ON `profile`.`uid` = `user`.`uid`
2202                         WHERE `user`.`nickname` = '%s' AND `profile`.`id` = %d LIMIT 1",
2203                         dbesc($nickname),
2204                         intval($profile_int)
2205                 );
2206         }
2207         if(! count($r)) {       
2208                 $r = q("SELECT `profile`.`uid` AS `profile_uid`, `profile`.* , `user`.* FROM `profile` 
2209                         LEFT JOIN `user` ON `profile`.`uid` = `user`.`uid`
2210                         WHERE `user`.`nickname` = '%s' AND `profile`.`is-default` = 1 LIMIT 1",
2211                         dbesc($nickname)
2212                 );
2213         }
2214
2215         if(($r === false) || (! count($r))) {
2216                 notice( t('No profile') . EOL );
2217                 $a->error = 404;
2218                 return;
2219         }
2220
2221         $a->profile = $r[0];
2222
2223
2224         $a->page['title'] = $a->profile['name'] . " @ " . $a->config['sitename'];
2225         $_SESSION['theme'] = $a->profile['theme'];
2226
2227         if(! (x($a->page,'aside')))
2228                 $a->page['aside'] = '';
2229
2230         $a->page['aside'] .= profile_sidebar($a->profile);
2231         $a->page['aside'] .= contact_block();
2232
2233         return;
2234 }}
2235
2236
2237 /**
2238  *
2239  * Function: profile_sidebar
2240  *
2241  * Formats a profile for display in the sidebar.
2242  * It is very difficult to templatise the HTML completely
2243  * because of all the conditional logic.
2244  *
2245  * @parameter: array $profile
2246  *
2247  * Returns HTML string stuitable for sidebar inclusion
2248  * Exceptions: Returns empty string if passed $profile is wrong type or not populated
2249  *
2250  */
2251
2252
2253 if(! function_exists('profile_sidebar')) {
2254 function profile_sidebar($profile) {
2255
2256         $o = '';
2257         $location = '';
2258         $address = false;
2259
2260         if((! is_array($profile)) && (! count($profile)))
2261                 return $o;
2262
2263         call_hooks('profile_sidebar_enter', $profile);
2264
2265         $fullname = '<div class="fn">' . $profile['name'] . '</div>';
2266
2267         $pdesc = '<div class="title">' . $profile['pdesc'] . '</div>';
2268
2269         $tabs = '';
2270
2271         $photo = '<div id="profile-photo-wrapper"><img class="photo" src="' . $profile['photo'] . '" alt="' . $profile['name'] . '" /></div>';
2272
2273         // don't show connect link to yourself
2274         
2275         $connect = (($profile['uid'] != local_user()) ? '<li><a id="dfrn-request-link" href="dfrn_request/' . $profile['nickname'] . '">' . t('Connect') . '</a></li>' : '');
2276
2277         // don't show connect link to authenticated visitors either
2278
2279         if((remote_user()) && ($_SESSION['visitor_visiting'] == $profile['uid']))
2280                 $connect = ''; 
2281
2282         if((x($profile,'address') == 1) 
2283                 || (x($profile,'locality') == 1) 
2284                 || (x($profile,'region') == 1) 
2285                 || (x($profile,'postal-code') == 1) 
2286                 || (x($profile,'country-name') == 1))
2287                 $address = true;
2288
2289         if($address) {
2290                 $location .= '<div class="location"><span class="location-label">' . t('Location:') . '</span> <div class="adr">';
2291                 $location .= ((x($profile,'address') == 1) ? '<div class="street-address">' . $profile['address'] . '</div>' : '');
2292                 $location .= (((x($profile,'locality') == 1) || (x($profile,'region') == 1) || (x($profile,'postal-code') == 1)) 
2293                         ? '<span class="city-state-zip"><span class="locality">' . $profile['locality'] . '</span>' 
2294                         . ((x($profile['locality']) == 1) ? t(', ') : '') 
2295                         . '<span class="region">' . $profile['region'] . '</span>'
2296                         . ' <span class="postal-code">' . $profile['postal-code'] . '</span></span>' : '');
2297                 $location .= ((x($profile,'country-name') == 1) ? ' <span class="country-name">' . $profile['country-name'] . '</span>' : '');  
2298                 $location .= '</div></div><div class="profile-clear"></div>';
2299
2300         }
2301
2302         $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>' : '');
2303
2304         $pubkey = ((x($profile,'pubkey') == 1) ? '<div class="key" style="display:none;">' . $profile['pubkey'] . '</div>' : '');
2305
2306         $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>' : '');
2307
2308         $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>' : '');
2309
2310         $tpl = load_view_file('view/profile_vcard.tpl');
2311
2312         $o .= replace_macros($tpl, array(
2313                 '$fullname' => $fullname,
2314                 '$pdesc'    => $pdesc,
2315                 '$tabs'     => $tabs,
2316                 '$photo'    => $photo,
2317                 '$connect'  => $connect,                
2318                 '$location' => $location,
2319                 '$gender'   => $gender,
2320                 '$pubkey'   => $pubkey,
2321                 '$marital'  => $marital,
2322                 '$homepage' => $homepage
2323         ));
2324
2325
2326         $arr = array('profile' => $profile, 'entry' => $o);
2327
2328         call_hooks('profile_sidebar', $arr);
2329
2330         return $o;
2331 }}
2332
2333
2334 if(! function_exists('register_hook')) {
2335 function register_hook($hook,$file,$function) {
2336
2337         $r = q("SELECT * FROM `hook` WHERE `hook` = '%s' AND `file` = '%s' AND `function` = '%s' LIMIT 1",
2338                 dbesc($hook),
2339                 dbesc($file),
2340                 dbesc($function)
2341         );
2342         if(count($r))
2343                 return true;
2344
2345         $r = q("INSERT INTO `hook` (`hook`, `file`, `function`) VALUES ( '%s', '%s', '%s' ) ",
2346                 dbesc($hook),
2347                 dbesc($file),
2348                 dbesc($function)
2349         );
2350         return $r;
2351 }}
2352
2353 if(! function_exists('unregister_hook')) {
2354 function unregister_hook($hook,$file,$function) {
2355
2356         $r = q("DELETE FROM `hook` WHERE `hook` = '%s' AND `file` = '%s' AND `function` = '%s' LIMIT 1",
2357                 dbesc($hook),
2358                 dbesc($file),
2359                 dbesc($function)
2360         );
2361         return $r;
2362 }}
2363
2364
2365 if(! function_exists('load_hooks')) {
2366 function load_hooks() {
2367         $a = get_app();
2368         $a->hooks = array();
2369         $r = q("SELECT * FROM `hook` WHERE 1");
2370         if(count($r)) {
2371                 foreach($r as $rr) {
2372                         $a->hooks[] = array($rr['hook'], $rr['file'], $rr['function']);
2373                 }
2374         }
2375 }}
2376
2377
2378 if(! function_exists('call_hooks')) {
2379 function call_hooks($name, &$data = null) {
2380         $a = get_app();
2381
2382         if(count($a->hooks)) {
2383                 foreach($a->hooks as $hook) {
2384                         if($hook[HOOK_HOOK] === $name) {
2385                                 @include_once($hook[HOOK_FILE]);
2386                                 if(function_exists($hook[HOOK_FUNCTION])) {
2387                                         $func = $hook[HOOK_FUNCTION];
2388                                         $func($a,$data);
2389                                 }
2390                         }
2391                 }
2392         }
2393 }}
2394
2395
2396 if(! function_exists('day_translate')) {
2397 function day_translate($s) {
2398         $ret = str_replace(array('Monday','Tuesday','Wednesday','Thursday','Friday','Saturday','Sunday'),
2399                 array( t('Monday'), t('Tuesday'), t('Wednesday'), t('Thursday'), t('Friday'), t('Saturday'), t('Sunday')),
2400                 $s);
2401
2402         $ret = str_replace(array('January','February','March','April','May','June','July','August','September','October','November','December'),
2403                 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')),
2404                 $ret);
2405
2406         return $ret;
2407 }}
2408
2409 if(! function_exists('get_birthdays')) {
2410 function get_birthdays() {
2411
2412         $a = get_app();
2413         $o = '';
2414
2415         if(! local_user())
2416                 return $o;
2417
2418         $bd_format = t('g A l F d') ; // 8 AM Friday January 18
2419
2420         $r = q("SELECT `event`.*, `event`.`id` AS `eid`, `contact`.* FROM `event` 
2421                 LEFT JOIN `contact` ON `contact`.`id` = `event`.`cid` 
2422                 WHERE `event`.`uid` = %d AND `type` = 'birthday' AND `start` < '%s' AND `finish` > '%s' 
2423                 ORDER BY `start` DESC ",
2424                 intval(local_user()),
2425                 dbesc(datetime_convert('UTC','UTC','now + 6 days')),
2426                 dbesc(datetime_convert('UTC','UTC','now'))
2427         );
2428
2429         if($r && count($r)) {
2430                 $total = 0;
2431                 foreach($r as $rr)
2432                         if(strlen($rr['name']))
2433                                 $total ++;
2434
2435                 $o .= '<div id="birthday-notice" class="birthday-notice fakelink" onclick=openClose(\'birthday-wrapper\'); >' . t('Birthday Reminders') . ' ' . '(' . $total . ')' . '</div>'; 
2436                 $o .= '<div id="birthday-wrapper" style="display: none;" ><div id="birthday-title">' . t('Birthdays this week:') . '</div>'; 
2437                 $o .= '<div id="birthday-adjust">' . t("\x28Adjusted for local time\x29") . '</div>';
2438                 $o .= '<div id="birthday-title-end"></div>';
2439
2440                 foreach($r as $rr) {
2441                         if(! strlen($rr['name']))
2442                                 continue;
2443                         $now = strtotime('now');
2444                         $today = (((strtotime($rr['start'] . ' +00:00') < $now) && (strtotime($rr['finish'] . ' +00:00') > $now)) ? true : false); 
2445
2446                         $o .= '<div class="birthday-list" id="birthday-' . $rr['eid'] . '"><a class="sparkle" href="' 
2447                         . $a->get_baseurl() . '/redir/'  . $rr['cid'] . '">' . $rr['name'] . '</a> ' 
2448                         . day_translate(datetime_convert('UTC', $a->timezone, $rr['start'], $bd_format)) . (($today) ?  ' ' . t('[today]') : '')
2449                         . '</div>' ;
2450                 }
2451
2452                 $o .= '</div></div>';
2453         }
2454
2455   return $o;
2456
2457 }}
2458
2459
2460 if(! function_exists('normalise_link')) {
2461 function normalise_link($url) {
2462         $ret = str_replace(array('https:','//www.'), array('http:','//'), $url);
2463         return(rtrim($ret,'/'));
2464 }}
2465
2466 /**
2467  *
2468  * Compare two URLs to see if they are the same, but ignore
2469  * slight but hopefully insignificant differences such as if one 
2470  * is https and the other isn't, or if one is www.something and 
2471  * the other isn't - and also ignore case differences.
2472  *
2473  * Return true if the URLs match, otherwise false.
2474  *
2475  */
2476
2477 if(! function_exists('link_compare')) {
2478 function link_compare($a,$b) {
2479         if(strcasecmp(normalise_link($a),normalise_link($b)) === 0)
2480                 return true;
2481         return false;
2482 }}
2483
2484
2485 if(! function_exists('prepare_body')) {
2486 function prepare_body($item) {
2487         return prepare_text($item['body']);
2488 }}
2489
2490 if(! function_exists('prepare_text')) {
2491 function prepare_text($text) {
2492
2493         require_once('include/bbcode.php');
2494
2495         $s = smilies(bbcode($text));
2496
2497         return $s;
2498 }}
2499
2500 /**
2501  * 
2502  * Wrap calls to proc_close(proc_open()) and call hook
2503  * so plugins can take part in process :)
2504  * 
2505  * args:
2506  * $cmd program to run
2507  *  next args are passed as $cmd command line
2508  * 
2509  * e.g.: proc_run("ls","-la","/tmp");
2510  * 
2511  * $cmd and string args are surrounded with ""
2512  */
2513
2514 if(! function_exists('proc_run')) {
2515 function proc_run($cmd){
2516
2517         $a = get_app();
2518
2519         $args = func_get_args();
2520         call_hooks("proc_run", $args);
2521
2522         if(count($args) && $args[0] === 'php')
2523         $args[0] = ((x($a->config,'php_path')) && (strlen($a->config['php_path'])) ? $a->config['php_path'] : 'php');
2524         
2525         foreach ($args as $arg){
2526                 $arg = escapeshellarg($arg);
2527         }
2528         $cmdline = implode($args," ");
2529         proc_close(proc_open($cmdline." &",array(),$foo));
2530 }}
2531
2532 if(! function_exists('current_theme')) {
2533 function current_theme(){
2534         $app_base_themes = array('duepuntozero', 'loozah');
2535         
2536         $a = get_app();
2537         
2538         $system_theme = ((isset($a->config['system']['theme'])) ? $a->config['system']['theme'] : '');
2539         $theme_name = ((is_array($_SESSION) && x($_SESSION,'theme')) ? $_SESSION['theme'] : $system_theme);
2540         
2541         if($theme_name && file_exists('view/theme/' . $theme_name . '/style.css'))
2542                 return($theme_name);
2543         
2544         foreach($app_base_themes as $t) {
2545                 if(file_exists('view/theme/' . $t . '/style.css'))
2546                         return($t);
2547         }
2548         
2549         $fallback = glob('view/theme/*/style.css');
2550         if(count($fallback))
2551                 return (str_replace('view/theme/','', str_replace("/style.css","",$fallback[0])));
2552
2553 }}
2554
2555 /*
2556 * Return full URL to theme which is currently in effect.
2557 * Provide a sane default if nothing is chosen or the specified theme does not exist.
2558 */
2559 if(! function_exists('current_theme_url')) {
2560 function current_theme_url() {
2561         global $a;
2562         $t = current_theme();
2563         return($a->get_baseurl() . '/view/theme/' . $t . '/style.css');
2564 }}
2565
2566 if(! function_exists('feed_birthday')) {
2567 function feed_birthday($uid,$tz) {
2568
2569         /**
2570          *
2571          * Determine the next birthday, but only if the birthday is published
2572          * in the default profile. We _could_ also look for a private profile that the
2573          * recipient can see, but somebody could get mad at us if they start getting
2574          * public birthday greetings when they haven't made this info public. 
2575          *
2576          * Assuming we are able to publish this info, we are then going to convert
2577          * the start time from the owner's timezone to UTC. 
2578          *
2579          * This will potentially solve the problem found with some social networks
2580          * where birthdays are converted to the viewer's timezone and salutations from
2581          * elsewhere in the world show up on the wrong day. We will convert it to the
2582          * viewer's timezone also, but first we are going to convert it from the birthday
2583          * person's timezone to GMT - so the viewer may find the birthday starting at
2584          * 6:00PM the day before, but that will correspond to midnight to the birthday person.
2585          *
2586          */
2587
2588         $birthday = '';
2589
2590         $p = q("SELECT `dob` FROM `profile` WHERE `is-default` = 1 AND `uid` = %d LIMIT 1",
2591                 intval($uid)
2592         );
2593
2594         if($p && count($p)) {
2595                 $tmp_dob = substr($p[0]['dob'],5);
2596                 if(intval($tmp_dob)) {
2597                         $y = datetime_convert($tz,$tz,'now','Y');
2598                         $bd = $y . '-' . $tmp_dob . ' 00:00';
2599                         $t_dob = strtotime($bd);
2600                         $now = strtotime(datetime_convert($tz,$tz,'now'));
2601                         if($t_dob < $now)
2602                                 $bd = $y + 1 . '-' . $tmp_dob . ' 00:00';
2603                         $birthday = datetime_convert($tz,'UTC',$bd,ATOM_TIME); 
2604                 }
2605         }
2606
2607         return $birthday;
2608 }}
2609
2610 /**
2611  * return atom link elements for all of our hubs
2612  */
2613
2614 if(! function_exists('feed_hublinks')) {
2615 function feed_hublinks() {
2616
2617         $hub = get_config('system','huburl');
2618
2619         $hubxml = '';
2620         if(strlen($hub)) {
2621                 $hubs = explode(',', $hub);
2622                 if(count($hubs)) {
2623                         foreach($hubs as $h) {
2624                                 $h = trim($h);
2625                                 if(! strlen($h))
2626                                         continue;
2627                                 $hubxml .= '<link rel="hub" href="' . xmlify($h) . '" />' . "\n" ;
2628                         }
2629                 }
2630         }
2631         return $hubxml;
2632 }}
2633
2634 /* return atom link elements for salmon endpoints */
2635
2636 if(! function_exists('feed_salmonlinks')) {
2637 function feed_salmonlinks($nick) {
2638
2639         $a = get_app();
2640
2641         $salmon  = '<link rel="salmon" href="' . xmlify($a->get_baseurl() . '/salmon/' . $nick) . '" />' . "\n" ;
2642
2643         // old style links that status.net still needed as of 12/2010 
2644
2645         $salmon .= '  <link rel="http://salmon-protocol.org/ns/salmon-replies" href="' . xmlify($a->get_baseurl() . '/salmon/' . $nick) . '" />' . "\n" ; 
2646         $salmon .= '  <link rel="http://salmon-protocol.org/ns/salmon-mention" href="' . xmlify($a->get_baseurl() . '/salmon/' . $nick) . '" />' . "\n" ; 
2647         return $salmon;
2648 }}
2649
2650 if(! function_exists('get_plink')) {
2651 function get_plink($item) {
2652         $a = get_app(); 
2653         $plink = (((x($item,'plink')) && (! $item['private'])) ? '<div class="wall-item-links-wrapper"><a href="' 
2654                         . $item['plink'] . '" title="' . t('link to source') . '" target="external-link" class="icon remote-link"></a></div>' : '');
2655         return $plink;
2656 }}
2657
2658 if(! function_exists('unamp')) {
2659 function unamp($s) {
2660         return str_replace('&amp;', '&', $s);
2661 }}
2662
2663
2664 if(! function_exists('lang_selector')) {
2665 function lang_selector() {
2666         global $lang;
2667         $o .= '<div id="language-selector" style="display: none;" >';
2668         $o .= '<form action="" method="post" ><select name="system_language" onchange="this.form.submit();" >';
2669         $langs = glob('view/*/strings.php');
2670         if(is_array($langs) && count($langs)) {
2671                 if(! in_array('view/en/strings.php',$langs))
2672                         $langs[] = 'view/en/';
2673                 foreach($langs as $l) {
2674                         $ll = substr($l,5);
2675                         $ll = substr($ll,0,strrpos($ll,'/'));
2676                         $selected = (($ll === $lang) ? ' selected="selected" ' : '');
2677                         $o .= '<option value="' . $ll . '"' . $selected . '>' . $ll . '</option>';
2678                 }
2679         }
2680         $o .= '</select></form></div>';
2681         return $o;
2682 }}
2683
2684
2685 if(! function_exists('parse_xml_string')) {
2686 function parse_xml_string($s) {
2687         if(! strstr($s,'<?xml'))
2688                 return false;
2689         $s2 = substr($s,strpos($s,'<?xml'));
2690         libxml_use_internal_errors(true);
2691         $x = @simplexml_load_string($s2);
2692         if(count(libxml_get_errors()))
2693                 foreach(libxml_get_errors() as $err)
2694                         logger('libxml: parse: ' . $err->code." at ".$err->line.":".$err->column." : ".$err->message, LOGGER_DATA);
2695         libxml_clear_errors();
2696         return $x;
2697 }}