3 require_once('include/config.php');
4 require_once('include/network.php');
5 require_once('include/plugin.php');
6 require_once('include/text.php');
7 require_once('include/datetime.php');
8 require_once('include/pgettext.php');
9 require_once('include/nav.php');
10 require_once('include/cache.php');
11 require_once('library/Mobile_Detect/Mobile_Detect.php');
13 define ( 'FRIENDICA_PLATFORM', 'Friendica');
14 define ( 'FRIENDICA_VERSION', '3.0.1426' );
15 define ( 'DFRN_PROTOCOL_VERSION', '2.23' );
16 define ( 'DB_UPDATE_VERSION', 1154 );
18 define ( 'EOL', "<br />\r\n" );
19 define ( 'ATOM_TIME', 'Y-m-d\TH:i:s\Z' );
24 * Image storage quality. Lower numbers save space at cost of image detail.
25 * For ease of upgrade, please do not change here. Change jpeg quality with
26 * $a->config['system']['jpeg_quality'] = n;
27 * in .htconfig.php, where n is netween 1 and 100, and with very poor results
32 define ( 'JPEG_QUALITY', 100 );
34 * $a->config['system']['png_quality'] from 0 (uncompressed) to 9
36 define ( 'PNG_QUALITY', 8 );
40 * An alternate way of limiting picture upload sizes. Specify the maximum pixel
41 * length that pictures are allowed to be (for non-square pictures, it will apply
42 * to the longest side). Pictures longer than this length will be resized to be
43 * this length (on the longest side, the other side will be scaled appropriately).
44 * Modify this value using
46 * $a->config['system']['max_image_length'] = n;
50 * If you don't want to set a maximum length, set to -1. The default value is
51 * defined by 'MAX_IMAGE_LENGTH' below.
54 define ( 'MAX_IMAGE_LENGTH', -1 );
61 define ( 'DEFAULT_DB_ENGINE', 'MyISAM' );
64 * SSL redirection policies
67 define ( 'SSL_POLICY_NONE', 0 );
68 define ( 'SSL_POLICY_FULL', 1 );
69 define ( 'SSL_POLICY_SELFSIGN', 2 );
76 define ( 'LOGGER_NORMAL', 0 );
77 define ( 'LOGGER_TRACE', 1 );
78 define ( 'LOGGER_DEBUG', 2 );
79 define ( 'LOGGER_DATA', 3 );
80 define ( 'LOGGER_ALL', 4 );
83 * registration policies
86 define ( 'REGISTER_CLOSED', 0 );
87 define ( 'REGISTER_APPROVE', 1 );
88 define ( 'REGISTER_OPEN', 2 );
94 define ( 'CONTACT_IS_FOLLOWER', 1);
95 define ( 'CONTACT_IS_SHARING', 2);
96 define ( 'CONTACT_IS_FRIEND', 3);
100 * DB update return values
103 define ( 'UPDATE_SUCCESS', 0);
104 define ( 'UPDATE_FAILED', 1);
111 * PAGE_NORMAL is a typical personal profile account
112 * PAGE_SOAPBOX automatically approves all friend requests as CONTACT_IS_SHARING, (readonly)
113 * PAGE_COMMUNITY automatically approves all friend requests as CONTACT_IS_SHARING, but with
114 * write access to wall and comments (no email and not included in page owner's ACL lists)
115 * PAGE_FREELOVE automatically approves all friend requests as full friends (CONTACT_IS_FRIEND).
119 define ( 'PAGE_NORMAL', 0 );
120 define ( 'PAGE_SOAPBOX', 1 );
121 define ( 'PAGE_COMMUNITY', 2 );
122 define ( 'PAGE_FREELOVE', 3 );
123 define ( 'PAGE_BLOG', 4 );
124 define ( 'PAGE_PRVGROUP', 5 );
127 * Network and protocol family types
130 define ( 'NETWORK_DFRN', 'dfrn'); // Friendica, Mistpark, other DFRN implementations
131 define ( 'NETWORK_ZOT', 'zot!'); // Zot!
132 define ( 'NETWORK_OSTATUS', 'stat'); // status.net, identi.ca, GNU-social, other OStatus implementations
133 define ( 'NETWORK_FEED', 'feed'); // RSS/Atom feeds with no known "post/notify" protocol
134 define ( 'NETWORK_DIASPORA', 'dspr'); // Diaspora
135 define ( 'NETWORK_MAIL', 'mail'); // IMAP/POP
136 define ( 'NETWORK_MAIL2', 'mai2'); // extended IMAP/POP
137 define ( 'NETWORK_FACEBOOK', 'face'); // Facebook API
138 define ( 'NETWORK_LINKEDIN', 'lnkd'); // LinkedIn
139 define ( 'NETWORK_XMPP', 'xmpp'); // XMPP
140 define ( 'NETWORK_MYSPACE', 'mysp'); // MySpace
141 define ( 'NETWORK_GPLUS', 'goog'); // Google+
143 define ( 'NETWORK_PHANTOM', 'unkn'); // Place holder
146 * These numbers are used in stored permissions
147 * and existing allocations MUST NEVER BE CHANGED
148 * OR RE-ASSIGNED! You may only add to them.
151 $netgroup_ids = array(
152 NETWORK_DFRN => (-1),
154 NETWORK_OSTATUS => (-3),
155 NETWORK_FEED => (-4),
156 NETWORK_DIASPORA => (-5),
157 NETWORK_MAIL => (-6),
158 NETWORK_MAIL2 => (-7),
159 NETWORK_FACEBOOK => (-8),
160 NETWORK_LINKEDIN => (-9),
161 NETWORK_XMPP => (-10),
162 NETWORK_MYSPACE => (-11),
163 NETWORK_GPLUS => (-12),
165 NETWORK_PHANTOM => (-127),
170 * Maximum number of "people who like (or don't like) this" that we will list by name
173 define ( 'MAX_LIKERS', 75);
176 * Communication timeout
179 define ( 'ZCURL_TIMEOUT' , (-1));
183 * email notification options
186 define ( 'NOTIFY_INTRO', 0x0001 );
187 define ( 'NOTIFY_CONFIRM', 0x0002 );
188 define ( 'NOTIFY_WALL', 0x0004 );
189 define ( 'NOTIFY_COMMENT', 0x0008 );
190 define ( 'NOTIFY_MAIL', 0x0010 );
191 define ( 'NOTIFY_SUGGEST', 0x0020 );
192 define ( 'NOTIFY_PROFILE', 0x0040 );
193 define ( 'NOTIFY_TAGSELF', 0x0080 );
194 define ( 'NOTIFY_TAGSHARE', 0x0100 );
195 define ( 'NOTIFY_POKE', 0x0200 );
197 define ( 'NOTIFY_SYSTEM', 0x8000 );
204 define ( 'TERM_UNKNOWN', 0 );
205 define ( 'TERM_HASHTAG', 1 );
206 define ( 'TERM_MENTION', 2 );
207 define ( 'TERM_CATEGORY', 3 );
208 define ( 'TERM_PCATEGORY', 4 );
209 define ( 'TERM_FILE', 5 );
211 define ( 'TERM_OBJ_POST', 1 );
212 define ( 'TERM_OBJ_PHOTO', 2 );
217 * various namespaces we may need to parse
220 define ( 'NAMESPACE_ZOT', 'http://purl.org/zot' );
221 define ( 'NAMESPACE_DFRN' , 'http://purl.org/macgirvin/dfrn/1.0' );
222 define ( 'NAMESPACE_THREAD' , 'http://purl.org/syndication/thread/1.0' );
223 define ( 'NAMESPACE_TOMB' , 'http://purl.org/atompub/tombstones/1.0' );
224 define ( 'NAMESPACE_ACTIVITY', 'http://activitystrea.ms/spec/1.0/' );
225 define ( 'NAMESPACE_ACTIVITY_SCHEMA', 'http://activitystrea.ms/schema/1.0/' );
226 define ( 'NAMESPACE_MEDIA', 'http://purl.org/syndication/atommedia' );
227 define ( 'NAMESPACE_SALMON_ME', 'http://salmon-protocol.org/ns/magic-env' );
228 define ( 'NAMESPACE_OSTATUSSUB', 'http://ostatus.org/schema/1.0/subscribe' );
229 define ( 'NAMESPACE_GEORSS', 'http://www.georss.org/georss' );
230 define ( 'NAMESPACE_POCO', 'http://portablecontacts.net/spec/1.0' );
231 define ( 'NAMESPACE_FEED', 'http://schemas.google.com/g/2010#updates-from' );
232 define ( 'NAMESPACE_OSTATUS', 'http://ostatus.org/schema/1.0' );
233 define ( 'NAMESPACE_STATUSNET', 'http://status.net/schema/api/1/' );
234 define ( 'NAMESPACE_ATOM1', 'http://www.w3.org/2005/Atom' );
236 * activity stream defines
239 define ( 'ACTIVITY_LIKE', NAMESPACE_ACTIVITY_SCHEMA . 'like' );
240 define ( 'ACTIVITY_DISLIKE', NAMESPACE_DFRN . '/dislike' );
241 define ( 'ACTIVITY_OBJ_HEART', NAMESPACE_DFRN . '/heart' );
243 define ( 'ACTIVITY_FRIEND', NAMESPACE_ACTIVITY_SCHEMA . 'make-friend' );
244 define ( 'ACTIVITY_REQ_FRIEND', NAMESPACE_ACTIVITY_SCHEMA . 'request-friend' );
245 define ( 'ACTIVITY_UNFRIEND', NAMESPACE_ACTIVITY_SCHEMA . 'remove-friend' );
246 define ( 'ACTIVITY_FOLLOW', NAMESPACE_ACTIVITY_SCHEMA . 'follow' );
247 define ( 'ACTIVITY_UNFOLLOW', NAMESPACE_ACTIVITY_SCHEMA . 'stop-following' );
248 define ( 'ACTIVITY_JOIN', NAMESPACE_ACTIVITY_SCHEMA . 'join' );
250 define ( 'ACTIVITY_POST', NAMESPACE_ACTIVITY_SCHEMA . 'post' );
251 define ( 'ACTIVITY_UPDATE', NAMESPACE_ACTIVITY_SCHEMA . 'update' );
252 define ( 'ACTIVITY_TAG', NAMESPACE_ACTIVITY_SCHEMA . 'tag' );
253 define ( 'ACTIVITY_FAVORITE', NAMESPACE_ACTIVITY_SCHEMA . 'favorite' );
255 define ( 'ACTIVITY_POKE', NAMESPACE_ZOT . '/activity/poke' );
257 define ( 'ACTIVITY_OBJ_COMMENT', NAMESPACE_ACTIVITY_SCHEMA . 'comment' );
258 define ( 'ACTIVITY_OBJ_NOTE', NAMESPACE_ACTIVITY_SCHEMA . 'note' );
259 define ( 'ACTIVITY_OBJ_PERSON', NAMESPACE_ACTIVITY_SCHEMA . 'person' );
260 define ( 'ACTIVITY_OBJ_PHOTO', NAMESPACE_ACTIVITY_SCHEMA . 'photo' );
261 define ( 'ACTIVITY_OBJ_P_PHOTO', NAMESPACE_ACTIVITY_SCHEMA . 'profile-photo' );
262 define ( 'ACTIVITY_OBJ_ALBUM', NAMESPACE_ACTIVITY_SCHEMA . 'photo-album' );
263 define ( 'ACTIVITY_OBJ_EVENT', NAMESPACE_ACTIVITY_SCHEMA . 'event' );
264 define ( 'ACTIVITY_OBJ_GROUP', NAMESPACE_ACTIVITY_SCHEMA . 'group' );
265 define ( 'ACTIVITY_OBJ_TAGTERM', NAMESPACE_DFRN . '/tagterm' );
266 define ( 'ACTIVITY_OBJ_PROFILE', NAMESPACE_DFRN . '/profile' );
269 * item weight for query ordering
272 define ( 'GRAVITY_PARENT', 0);
273 define ( 'GRAVITY_LIKE', 3);
274 define ( 'GRAVITY_COMMENT', 6);
278 * Reverse the effect of magic_quotes_gpc if it is enabled.
279 * Please disable magic_quotes_gpc so we don't have to do this.
280 * See http://php.net/manual/en/security.magicquotes.disabling.php
285 error_reporting(E_ERROR | E_WARNING | E_PARSE);
288 // This has to be quite large to deal with embedded private photos
289 ini_set('pcre.backtrack_limit', 500000);
292 if (get_magic_quotes_gpc()) {
293 $process = array(&$_GET, &$_POST, &$_COOKIE, &$_REQUEST);
294 while (list($key, $val) = each($process)) {
295 foreach ($val as $k => $v) {
296 unset($process[$key][$k]);
298 $process[$key][stripslashes($k)] = $v;
299 $process[] = &$process[$key][stripslashes($k)];
301 $process[$key][stripslashes($k)] = stripslashes($v);
314 * Our main application structure for the life of this page
315 * Primarily deals with the URL that got us here
316 * and tries to make some sense of it, and
317 * stores our page contents and config storage
318 * and anything else that might need to be passed around
319 * before we spit the page out.
323 if(! class_exists('App')) {
326 public $module_loaded = false;
327 public $query_string;
335 public $page_contact;
337 public $data = array();
338 public $error = false;
348 public $interactive = true;
350 public $apps = array();
357 // Allow themes to control internal parameters
358 // by changing App values in theme.php
360 // Possibly should make these part of the plugin
361 // system, but it seems like overkill to invoke
362 // all the plugin machinery just to change a couple
364 public $sourcename = '';
365 public $videowidth = 425;
366 public $videoheight = 350;
374 private $curl_headers;
376 private $cached_profile_image;
377 private $cached_profile_picdate;
379 function __construct() {
381 global $default_timezone;
383 $this->timezone = ((x($default_timezone)) ? $default_timezone : 'UTC');
385 date_default_timezone_set($this->timezone);
387 $this->config = array();
388 $this->page = array();
389 $this->pager= array();
391 $this->query_string = '';
395 $this->scheme = 'http';
396 if(x($_SERVER,'HTTPS') && $_SERVER['HTTPS'])
397 $this->scheme = 'https';
398 elseif(x($_SERVER,'SERVER_PORT') && (intval($_SERVER['SERVER_PORT']) == 443))
399 $this->scheme = 'https';
402 if(x($_SERVER,'SERVER_NAME')) {
403 $this->hostname = $_SERVER['SERVER_NAME'];
405 // See bug 437 - this didn't work so disabling it
406 //if(stristr($this->hostname,'xn--')) {
407 // PHP or webserver may have converted idn to punycode, so
408 // convert punycode back to utf-8
409 // require_once('library/simplepie/idn/idna_convert.class.php');
410 // $x = new idna_convert();
411 // $this->hostname = $x->decode($_SERVER['SERVER_NAME']);
414 if(x($_SERVER,'SERVER_PORT') && $_SERVER['SERVER_PORT'] != 80 && $_SERVER['SERVER_PORT'] != 443)
415 $this->hostname .= ':' . $_SERVER['SERVER_PORT'];
417 * Figure out if we are running at the top of a domain
418 * or in a sub-directory and adjust accordingly
421 $path = trim(dirname($_SERVER['SCRIPT_NAME']),'/\\');
422 if(isset($path) && strlen($path) && ($path != $this->path))
427 "include/$this->hostname" . PATH_SEPARATOR
428 . 'include' . PATH_SEPARATOR
429 . 'library' . PATH_SEPARATOR
430 . 'library/phpsec' . PATH_SEPARATOR
431 . 'library/langdet' . PATH_SEPARATOR
434 if((x($_SERVER,'QUERY_STRING')) && substr($_SERVER['QUERY_STRING'],0,2) === "q=") {
435 $this->query_string = substr($_SERVER['QUERY_STRING'],2);
436 // removing trailing / - maybe a nginx problem
437 if (substr($this->query_string, 0, 1) == "/")
438 $this->query_string = substr($this->query_string, 1);
441 $this->cmd = trim($_GET['q'],'/\\');
443 // unix style "homedir"
445 if(substr($this->cmd,0,1) === '~')
446 $this->cmd = 'profile/' . substr($this->cmd,1);
448 // Diaspora style profile url
450 if(substr($this->cmd,0,2) === 'u/')
451 $this->cmd = 'profile/' . substr($this->cmd,2);
455 * Break the URL path into C style argc/argv style arguments for our
456 * modules. Given "http://example.com/module/arg1/arg2", $this->argc
457 * will be 3 (integer) and $this->argv will contain:
463 * There will always be one argument. If provided a naked domain
464 * URL, $this->argv[0] is set to "home".
468 $this->argv = explode('/',$this->cmd);
469 $this->argc = count($this->argv);
470 if((array_key_exists('0',$this->argv)) && strlen($this->argv[0])) {
471 $this->module = str_replace(".", "_", $this->argv[0]);
475 $this->argv = array('home');
476 $this->module = 'home';
480 * Special handling for the webfinger/lrdd host XRD file
483 if($this->cmd === '.well-known/host-meta') {
485 $this->argv = array('hostxrd');
486 $this->module = 'hostxrd';
490 * See if there is any page number information, and initialise
494 $this->pager['page'] = ((x($_GET,'page') && intval($_GET['page']) > 0) ? intval($_GET['page']) : 1);
495 $this->pager['itemspage'] = 50;
496 $this->pager['start'] = ($this->pager['page'] * $this->pager['itemspage']) - $this->pager['itemspage'];
497 if($this->pager['start'] < 0)
498 $this->pager['start'] = 0;
499 $this->pager['total'] = 0;
502 function get_baseurl($ssl = false) {
504 $scheme = $this->scheme;
506 if((x($this->config,'system')) && (x($this->config['system'],'ssl_policy'))) {
507 if(intval($this->config['system']['ssl_policy']) === intval(SSL_POLICY_FULL))
510 // Basically, we have $ssl = true on any links which can only be seen by a logged in user
511 // (and also the login link). Anything seen by an outsider will have it turned off.
513 if($this->config['system']['ssl_policy'] == SSL_POLICY_SELFSIGN) {
521 $this->baseurl = $scheme . "://" . $this->hostname . ((isset($this->path) && strlen($this->path)) ? '/' . $this->path : '' );
522 return $this->baseurl;
525 function set_baseurl($url) {
526 $parsed = @parse_url($url);
528 $this->baseurl = $url;
531 $this->scheme = $parsed['scheme'];
533 $this->hostname = $parsed['host'];
534 if(x($parsed,'port'))
535 $this->hostname .= ':' . $parsed['port'];
536 if(x($parsed,'path'))
537 $this->path = trim($parsed['path'],'\\/');
542 function get_hostname() {
543 return $this->hostname;
546 function set_hostname($h) {
547 $this->hostname = $h;
550 function set_path($p) {
551 $this->path = trim(trim($p),'/');
554 function get_path() {
558 function set_pager_total($n) {
559 $this->pager['total'] = intval($n);
562 function set_pager_itemspage($n) {
563 $this->pager['itemspage'] = ((intval($n) > 0) ? intval($n) : 0);
564 $this->pager['start'] = ($this->pager['page'] * $this->pager['itemspage']) - $this->pager['itemspage'];
568 function init_pagehead() {
569 $interval = ((local_user()) ? get_pconfig(local_user(),'system','update_interval') : 40000);
570 if($interval < 10000)
573 $this->page['title'] = $this->config['sitename'];
574 $tpl = get_markup_template('head.tpl');
575 $this->page['htmlhead'] = replace_macros($tpl,array(
576 '$baseurl' => $this->get_baseurl(), // FIXME for z_path!!!!
577 '$local_user' => local_user(),
578 '$generator' => 'Friendica' . ' ' . FRIENDICA_VERSION,
579 '$delitem' => t('Delete this item?'),
580 '$comment' => t('Comment'),
581 '$showmore' => t('show more'),
582 '$showfewer' => t('show fewer'),
583 '$update_interval' => $interval
587 function init_page_end() {
588 $tpl = get_markup_template('end.tpl');
589 $this->page['end'] = replace_macros($tpl,array(
590 '$baseurl' => $this->get_baseurl() // FIXME for z_path!!!!
594 function set_curl_code($code) {
595 $this->curl_code = $code;
598 function get_curl_code() {
599 return $this->curl_code;
602 function set_curl_headers($headers) {
603 $this->curl_headers = $headers;
606 function get_curl_headers() {
607 return $this->curl_headers;
610 function get_cached_avatar_image($avatar_image){
611 if($this->cached_profile_image[$avatar_image])
612 return $this->cached_profile_image[$avatar_image];
614 $path_parts = explode("/",$avatar_image);
615 $common_filename = $path_parts[count($path_parts)-1];
617 if($this->cached_profile_picdate[$common_filename]){
618 $this->cached_profile_image[$avatar_image] = $avatar_image . $this->cached_profile_picdate[$common_filename];
620 $r = q("SELECT `contact`.`avatar-date` AS picdate FROM `contact` WHERE `contact`.`thumb` like \"%%/%s\"",
623 $this->cached_profile_image[$avatar_image] = $avatar_image;
625 $this->cached_profile_picdate[$common_filename] = "?rev=" . urlencode($r[0]['picdate']);
626 $this->cached_profile_image[$avatar_image] = $avatar_image . $this->cached_profile_picdate[$common_filename];
629 return $this->cached_profile_image[$avatar_image];
636 // retrieve the App structure
637 // useful in functions which require it but don't get it passed to them
639 if(! function_exists('get_app')) {
647 // Multi-purpose function to check variable state.
648 // Usage: x($var) or $x($array,'key')
649 // returns false if variable/key is not set
650 // if variable is set, returns 1 if has 'non-zero' value, otherwise returns 0.
651 // e.g. x('') or x(0) returns 0;
653 if(! function_exists('x')) {
654 function x($s,$k = NULL) {
656 if((is_array($s)) && (array_key_exists($k,$s))) {
675 // called from db initialisation if db is dead.
677 if(! function_exists('system_unavailable')) {
678 function system_unavailable() {
679 include('system_unavailable.php');
687 function clean_urls() {
689 // if($a->config['system']['clean_urls'])
696 $base = $a->get_baseurl();
704 return $a->get_baseurl();
707 function absurl($path) {
708 if(strpos($path,'/') === 0)
709 return z_path() . $path;
714 return (!empty($_SERVER['HTTP_X_REQUESTED_WITH']) && strtolower($_SERVER['HTTP_X_REQUESTED_WITH']) == 'xmlhttprequest');
718 // Primarily involved with database upgrade, but also sets the
719 // base url for use in cmdline programs which don't have
720 // $_SERVER variables, and synchronising the state of installed plugins.
723 if(! function_exists('check_config')) {
724 function check_config(&$a) {
726 $build = get_config('system','build');
728 $build = set_config('system','build',DB_UPDATE_VERSION);
730 $url = get_config('system','url');
732 // if the url isn't set or the stored url is radically different
733 // than the currently visited url, store the current value accordingly.
734 // "Radically different" ignores common variations such as http vs https
735 // and www.example.com vs example.com.
737 if((! x($url)) || (! link_compare($url,$a->get_baseurl())))
738 $url = set_config('system','url',$a->get_baseurl());
740 if($build != DB_UPDATE_VERSION) {
741 $stored = intval($build);
742 $current = intval(DB_UPDATE_VERSION);
743 if(($stored < $current) && file_exists('update.php')) {
745 load_config('database');
747 // We're reporting a different version than what is currently installed.
748 // Run any existing update scripts to bring the database up to current.
750 require_once('update.php');
752 // make sure that boot.php and update.php are the same release, we might be
753 // updating right this very second and the correct version of the update.php
754 // file may not be here yet. This can happen on a very busy site.
756 if(DB_UPDATE_VERSION == UPDATE_VERSION) {
758 for($x = $stored; $x < $current; $x ++) {
759 if(function_exists('update_' . $x)) {
761 // There could be a lot of processes running or about to run.
762 // We want exactly one process to run the update command.
763 // So store the fact that we're taking responsibility
764 // after first checking to see if somebody else already has.
766 // If the update fails or times-out completely you may need to
767 // delete the config entry to try again.
769 $t = get_config('database','update_' . $x);
772 set_config('database','update_' . $x, time());
774 // call the specific update
776 $func = 'update_' . $x;
779 //send the administrator an e-mail
780 $email_tpl = get_intltext_template("update_fail_eml.tpl");
781 $email_msg = replace_macros($email_tpl, array(
782 '$sitename' => $a->config['sitename'],
783 '$siteurl' => $a->get_baseurl(),
785 '$error' => sprintf( t('Update %s failed. See error logs.'), $x)
787 $subject=sprintf(t('Update Error at %s'), $a->get_baseurl());
789 mail($a->config['admin_email'], $subject, $email_msg,
790 'From: ' . t('Administrator') . '@' . $_SERVER['SERVER_NAME'] . "\n"
791 . 'Content-type: text/plain; charset=UTF-8' . "\n"
792 . 'Content-transfer-encoding: 8bit' );
794 logger('CRITICAL: Update Failed: '. $x);
798 set_config('database','update_' . $x, 'success');
799 set_config('system','build', $x + 1);
809 * Synchronise plugins:
811 * $a->config['system']['addon'] contains a comma-separated list of names
812 * of plugins/addons which are used on this system.
813 * Go through the database list of already installed addons, and if we have
814 * an entry, but it isn't in the config list, call the uninstall procedure
815 * and mark it uninstalled in the database (for now we'll remove it).
816 * Then go through the config list and if we have a plugin that isn't installed,
817 * call the install procedure and add it to the database.
821 $r = q("SELECT * FROM `addon` WHERE `installed` = 1");
825 $installed = array();
827 $plugins = get_config('system','addon');
828 $plugins_arr = array();
831 $plugins_arr = explode(',',str_replace(' ', '',$plugins));
833 $a->plugins = $plugins_arr;
835 $installed_arr = array();
837 if(count($installed)) {
838 foreach($installed as $i) {
839 if(! in_array($i['name'],$plugins_arr)) {
840 uninstall_plugin($i['name']);
843 $installed_arr[] = $i['name'];
848 if(count($plugins_arr)) {
849 foreach($plugins_arr as $p) {
850 if(! in_array($p,$installed_arr)) {
864 function get_guid($size=16) {
865 $exists = true; // assume by default that we don't have a unique guid
867 $s = random_string($size);
868 $r = q("select id from guid where guid = '%s' limit 1", dbesc($s));
872 q("insert into guid ( guid ) values ( '%s' ) ", dbesc($s));
877 // wrapper for adding a login box. If $register == true provide a registration
878 // link. This will most always depend on the value of $a->config['register_policy'].
879 // returns the complete html for inserting into the page
881 if(! function_exists('login')) {
882 function login($register = false, $hiddens=false) {
888 'title' => t('Create a New Account'),
889 'desc' => t('Register')
893 $noid = get_config('system','no_openid');
895 $dest_url = $a->get_baseurl(true) . '/' . $a->query_string;
898 $tpl = get_markup_template("logout.tpl");
901 $tpl = get_markup_template("login.tpl");
902 $_SESSION['return_url'] = $a->query_string;
906 $o .= replace_macros($tpl,array(
908 '$dest_url' => $dest_url,
909 '$logout' => t('Logout'),
910 '$login' => t('Login'),
912 '$lname' => array('username', t('Nickname or Email address: ') , '', ''),
913 '$lpassword' => array('password', t('Password: '), '', ''),
916 '$lopenid' => array('openid_url', t('Or login using OpenID: '),'',''),
918 '$hiddens' => $hiddens,
922 '$lostpass' => t('Forgot your password?'),
923 '$lostlink' => t('Password Reset'),
926 call_hooks('login_hook',$o);
932 // Used to end the current process, after saving session state.
934 if(! function_exists('killme')) {
936 session_write_close();
941 // redirect to another URL and terminate this process.
943 if(! function_exists('goaway')) {
944 function goaway($s) {
945 header("Location: $s");
951 // Returns the uid of locally logged in user or false.
953 if(! function_exists('local_user')) {
954 function local_user() {
955 if((x($_SESSION,'authenticated')) && (x($_SESSION,'uid')))
956 return intval($_SESSION['uid']);
961 // Returns contact id of authenticated site visitor or false
963 if(! function_exists('remote_user')) {
964 function remote_user() {
965 if((x($_SESSION,'authenticated')) && (x($_SESSION,'visitor_id')))
966 return intval($_SESSION['visitor_id']);
971 // contents of $s are displayed prominently on the page the next time
972 // a page is loaded. Usually used for errors or alerts.
974 if(! function_exists('notice')) {
975 function notice($s) {
977 if(! x($_SESSION,'sysmsg')) $_SESSION['sysmsg'] = array();
979 $_SESSION['sysmsg'][] = $s;
982 if(! function_exists('info')) {
985 if(! x($_SESSION,'sysmsg_info')) $_SESSION['sysmsg_info'] = array();
987 $_SESSION['sysmsg_info'][] = $s;
992 // wrapper around config to limit the text length of an incoming message
994 if(! function_exists('get_max_import_size')) {
995 function get_max_import_size() {
997 return ((x($a->config,'max_import_size')) ? $a->config['max_import_size'] : 0 );
1005 * Function : profile_load
1007 * @parameter string $nickname
1008 * @parameter int $profile
1010 * Summary: Loads a profile into the page sidebar.
1011 * The function requires a writeable copy of the main App structure, and the nickname
1012 * of a registered local account.
1014 * If the viewer is an authenticated remote viewer, the profile displayed is the
1015 * one that has been configured for his/her viewing in the Contact manager.
1016 * Passing a non-zero profile ID can also allow a preview of a selected profile
1019 * Profile information is placed in the App structure for later retrieval.
1020 * Honours the owner's chosen theme for display.
1024 if(! function_exists('profile_load')) {
1025 function profile_load(&$a, $nickname, $profile = 0) {
1027 $r = q("SELECT `profile-id` FROM `contact` WHERE `id` = %d LIMIT 1",
1028 intval($_SESSION['visitor_id']));
1030 $profile = $r[0]['profile-id'];
1036 $profile_int = intval($profile);
1037 $r = q("SELECT `profile`.`uid` AS `profile_uid`, `profile`.* , `contact`.`avatar-date` AS picdate, `user`.* FROM `profile`
1038 left join `contact` on `contact`.`uid` = `profile`.`uid` LEFT JOIN `user` ON `profile`.`uid` = `user`.`uid`
1039 WHERE `user`.`nickname` = '%s' AND `profile`.`id` = %d and `contact`.`self` = 1 LIMIT 1",
1041 intval($profile_int)
1044 if((! $r) && (! count($r))) {
1045 $r = q("SELECT `profile`.`uid` AS `profile_uid`, `profile`.* , `contact`.`avatar-date` AS picdate, `user`.* FROM `profile`
1046 left join `contact` on `contact`.`uid` = `profile`.`uid` LEFT JOIN `user` ON `profile`.`uid` = `user`.`uid`
1047 WHERE `user`.`nickname` = '%s' AND `profile`.`is-default` = 1 and `contact`.`self` = 1 LIMIT 1",
1052 if(($r === false) || (! count($r))) {
1053 logger('profile error: ' . $a->query_string, LOGGER_DEBUG);
1054 notice( t('Requested profile is not available.') . EOL );
1059 // fetch user tags if this isn't the default profile
1061 if(! $r[0]['is-default']) {
1062 $x = q("select `pub_keywords` from `profile` where uid = %d and `is-default` = 1 limit 1",
1063 intval($profile_uid)
1066 $r[0]['pub_keywords'] = $x[0]['pub_keywords'];
1069 $a->profile = $r[0];
1072 $a->page['title'] = $a->profile['name'] . " @ " . $a->config['sitename'];
1073 $_SESSION['theme'] = $a->profile['theme'];
1076 * load/reload current theme info
1079 $theme_info_file = "view/theme/".current_theme()."/theme.php";
1080 if (file_exists($theme_info_file)){
1081 require_once($theme_info_file);
1084 if(! (x($a->page,'aside')))
1085 $a->page['aside'] = '';
1087 if(local_user() && local_user() == $a->profile['uid']) {
1088 $a->page['aside'] .= replace_macros(get_markup_template('profile_edlink.tpl'),array(
1089 '$editprofile' => t('Edit profile'),
1090 '$profid' => $a->profile['id']
1094 $block = (((get_config('system','block_public')) && (! local_user()) && (! remote_user())) ? true : false);
1096 $a->page['aside'] .= profile_sidebar($a->profile, $block);
1099 $a->page['aside'] .= contact_block();*/
1108 * Function: profile_sidebar
1110 * Formats a profile for display in the sidebar.
1111 * It is very difficult to templatise the HTML completely
1112 * because of all the conditional logic.
1114 * @parameter: array $profile
1116 * Returns HTML string stuitable for sidebar inclusion
1117 * Exceptions: Returns empty string if passed $profile is wrong type or not populated
1122 if(! function_exists('profile_sidebar')) {
1123 function profile_sidebar($profile, $block = 0) {
1132 if((! is_array($profile)) && (! count($profile)))
1135 $profile['picdate'] = urlencode($profile['picdate']);
1137 call_hooks('profile_sidebar_enter', $profile);
1140 // don't show connect link to yourself
1141 $connect = (($profile['uid'] != local_user()) ? t('Connect') : False);
1143 // don't show connect link to authenticated visitors either
1145 if((remote_user()) && ($_SESSION['visitor_visiting'] == $profile['uid']))
1148 if(get_my_url() && $profile['unkmail'])
1149 $wallmessage = t('Message');
1151 $wallmessage = false;
1155 // show edit profile to yourself
1156 if ($profile['uid'] == local_user()) {
1157 $profile['edit'] = array($a->get_baseurl(). '/profiles', t('Profiles'),"", t('Manage/edit profiles'));
1159 $r = q("SELECT * FROM `profile` WHERE `uid` = %d",
1162 $profile['menu'] = array(
1163 'chg_photo' => t('Change profile photo'),
1164 'cr_new' => t('Create New Profile'),
1165 'entries' => array(),
1170 foreach($r as $rr) {
1171 $profile['menu']['entries'][] = array(
1172 'photo' => $rr['thumb'],
1174 'alt' => t('Profile Image'),
1175 'profile_name' => $rr['profile-name'],
1176 'isdefault' => $rr['is-default'],
1177 'visibile_to_everybody' => t('visible to everybody'),
1178 'edit_visibility' => t('Edit visibility'),
1192 if((x($profile,'address') == 1)
1193 || (x($profile,'locality') == 1)
1194 || (x($profile,'region') == 1)
1195 || (x($profile,'postal-code') == 1)
1196 || (x($profile,'country-name') == 1))
1197 $location = t('Location:');
1199 $gender = ((x($profile,'gender') == 1) ? t('Gender:') : False);
1202 $marital = ((x($profile,'marital') == 1) ? t('Status:') : False);
1204 $homepage = ((x($profile,'homepage') == 1) ? t('Homepage:') : False);
1206 if(($profile['hidewall'] || $block) && (! local_user()) && (! remote_user())) {
1207 $location = $pdesc = $gender = $marital = $homepage = False;
1210 $firstname = ((strpos($profile['name'],' '))
1211 ? trim(substr($profile['name'],0,strpos($profile['name'],' '))) : $profile['name']);
1212 $lastname = (($firstname === $profile['name']) ? '' : trim(substr($profile['name'],strlen($firstname))));
1215 'podloc' => $a->get_baseurl(),
1216 'searchable' => (($profile['publish'] && $profile['net-publish']) ? 'true' : 'false' ),
1217 'nickname' => $profile['nickname'],
1218 'fullname' => $profile['name'],
1219 'firstname' => $firstname,
1220 'lastname' => $lastname,
1221 'photo300' => $a->get_cached_avatar_image($a->get_baseurl() . '/photo/custom/300/' . $profile['uid'] . '.jpg'),
1222 'photo100' => $a->get_cached_avatar_image($a->get_baseurl() . '/photo/custom/100/' . $profile['uid'] . '.jpg'),
1223 'photo50' => $a->get_cached_avatar_image($a->get_baseurl() . '/photo/custom/50/' . $profile['uid'] . '.jpg'),
1227 $contact_block = contact_block();
1231 $tpl = get_markup_template('profile_vcard.tpl');
1233 $o .= replace_macros($tpl, array(
1234 '$profile' => $profile,
1235 '$connect' => $connect,
1236 '$wallmessage' => $wallmessage,
1237 '$location' => template_escape($location),
1238 '$gender' => $gender,
1240 '$marital' => $marital,
1241 '$homepage' => $homepage,
1242 '$diaspora' => $diaspora,
1243 '$contact_block' => $contact_block,
1247 $arr = array('profile' => &$profile, 'entry' => &$o);
1249 call_hooks('profile_sidebar', $arr);
1256 if(! function_exists('get_birthdays')) {
1257 function get_birthdays() {
1265 $mobile_detect = new Mobile_Detect();
1266 $is_mobile = $mobile_detect->isMobile() || $mobile_detect->isTablet();
1271 $bd_format = t('g A l F d') ; // 8 AM Friday January 18
1272 $bd_short = t('F d');
1274 $r = q("SELECT `event`.*, `event`.`id` AS `eid`, `contact`.* FROM `event`
1275 LEFT JOIN `contact` ON `contact`.`id` = `event`.`cid`
1276 WHERE `event`.`uid` = %d AND `type` = 'birthday' AND `start` < '%s' AND `finish` > '%s'
1277 ORDER BY `start` ASC ",
1278 intval(local_user()),
1279 dbesc(datetime_convert('UTC','UTC','now + 6 days')),
1280 dbesc(datetime_convert('UTC','UTC','now'))
1283 if($r && count($r)) {
1285 $now = strtotime('now');
1289 foreach($r as $rr) {
1290 if(strlen($rr['name']))
1292 if((strtotime($rr['start'] . ' +00:00') < $now) && (strtotime($rr['finish'] . ' +00:00') > $now))
1295 $classtoday = $istoday ? ' birthday-today ' : '';
1297 foreach($r as &$rr) {
1298 if(! strlen($rr['name']))
1303 if(in_array($rr['cid'],$cids))
1305 $cids[] = $rr['cid'];
1307 $today = (((strtotime($rr['start'] . ' +00:00') < $now) && (strtotime($rr['finish'] . ' +00:00') > $now)) ? true : false);
1310 if($rr['network'] === NETWORK_DFRN) {
1311 $sparkle = " sparkle";
1312 $url = $a->get_baseurl() . '/redir/' . $rr['cid'];
1316 $rr['title'] = $rr['name'];
1317 $rr['date'] = day_translate(datetime_convert('UTC', $a->timezone, $rr['start'], $rr['adjust'] ? $bd_format : $bd_short)) . (($today) ? ' ' . t('[today]') : '');
1318 $rr['startime'] = Null;
1319 $rr['today'] = $today;
1324 $tpl = get_markup_template("birthdays_reminder.tpl");
1325 return replace_macros($tpl, array(
1326 '$baseurl' => $a->get_baseurl(),
1327 '$classtoday' => $classtoday,
1329 '$event_reminders' => t('Birthday Reminders'),
1330 '$event_title' => t('Birthdays this week:'),
1332 '$lbr' => '{', // raw brackets mess up if/endif macro processing
1340 if(! function_exists('get_events')) {
1341 function get_events() {
1343 require_once('include/bbcode.php');
1351 $mobile_detect = new Mobile_Detect();
1352 $is_mobile = $mobile_detect->isMobile() || $mobile_detect->isTablet();
1357 $bd_format = t('g A l F d') ; // 8 AM Friday January 18
1358 $bd_short = t('F d');
1360 $r = q("SELECT `event`.* FROM `event`
1361 WHERE `event`.`uid` = %d AND `type` != 'birthday' AND `start` < '%s' AND `start` > '%s'
1362 ORDER BY `start` ASC ",
1363 intval(local_user()),
1364 dbesc(datetime_convert('UTC','UTC','now + 6 days')),
1365 dbesc(datetime_convert('UTC','UTC','now - 1 days'))
1368 if($r && count($r)) {
1369 $now = strtotime('now');
1371 foreach($r as $rr) {
1372 if(strlen($rr['name']))
1375 $strt = datetime_convert('UTC',$rr['convert'] ? $a->timezone : 'UTC',$rr['start'],'Y-m-d');
1376 if($strt === datetime_convert('UTC',$a->timezone,'now','Y-m-d'))
1379 $classtoday = (($istoday) ? 'event-today' : '');
1382 foreach($r as &$rr) {
1384 $md = datetime_convert('UTC',$a->timezone,$rr['start'],'Y/m');
1386 $md = datetime_convert('UTC','UTC',$rr['start'],'Y/m');
1387 $md .= "/#link-".$rr['id'];
1389 $title = substr(strip_tags(bbcode($rr['desc'])),0,32) . '... ';
1391 $title = t('[No description]');
1393 $strt = datetime_convert('UTC',$rr['convert'] ? $a->timezone : 'UTC',$rr['start']);
1394 $today = ((substr($strt,0,10) === datetime_convert('UTC',$a->timezone,'now','Y-m-d')) ? true : false);
1397 $rr['title'] = $title;
1398 $rr['date'] = day_translate(datetime_convert('UTC', $rr['adjust'] ? $a->timezone : 'UTC', $rr['start'], $bd_format)) . (($today) ? ' ' . t('[today]') : '');
1399 $rr['startime'] = $strt;
1400 $rr['today'] = $today;
1404 $tpl = get_markup_template("events_reminder.tpl");
1405 return replace_macros($tpl, array(
1406 '$baseurl' => $a->get_baseurl(),
1407 '$classtoday' => $classtoday,
1408 '$count' => count($r),
1409 '$event_reminders' => t('Event Reminders'),
1410 '$event_title' => t('Events this week:'),
1419 * Wrap calls to proc_close(proc_open()) and call hook
1420 * so plugins can take part in process :)
1423 * $cmd program to run
1424 * next args are passed as $cmd command line
1426 * e.g.: proc_run("ls","-la","/tmp");
1428 * $cmd and string args are surrounded with ""
1431 if(! function_exists('proc_run')) {
1432 function proc_run($cmd){
1436 $args = func_get_args();
1442 // expand any arrays
1444 foreach($args as $arg) {
1445 if(is_array($arg)) {
1446 foreach($arg as $n) {
1456 $arr = array('args' => $args, 'run_cmd' => true);
1458 call_hooks("proc_run", $arr);
1459 if(! $arr['run_cmd'])
1462 if(count($args) && $args[0] === 'php')
1463 $args[0] = ((x($a->config,'php_path')) && (strlen($a->config['php_path'])) ? $a->config['php_path'] : 'php');
1464 for($x = 0; $x < count($args); $x ++)
1465 $args[$x] = escapeshellarg($args[$x]);
1467 $cmdline = implode($args," ");
1468 proc_close(proc_open($cmdline." &",array(),$foo));
1472 if(! function_exists('current_theme')) {
1473 function current_theme(){
1474 $app_base_themes = array('duepuntozero', 'dispy', 'quattro');
1478 $mobile_detect = new Mobile_Detect();
1479 $is_mobile = $mobile_detect->isMobile() || $mobile_detect->isTablet();
1482 $system_theme = ((isset($a->config['system']['mobile-theme'])) ? $a->config['system']['mobile-theme'] : '');
1483 $theme_name = ((isset($_SESSION) && x($_SESSION,'mobile-theme')) ? $_SESSION['mobile-theme'] : $system_theme);
1485 if(!$is_mobile || ($system_theme === '' && $theme_name === '')) {
1486 $system_theme = ((isset($a->config['system']['theme'])) ? $a->config['system']['theme'] : '');
1487 $theme_name = ((isset($_SESSION) && x($_SESSION,'theme')) ? $_SESSION['theme'] : $system_theme);
1491 (file_exists('view/theme/' . $theme_name . '/style.css') ||
1492 file_exists('view/theme/' . $theme_name . '/style.php')))
1493 return($theme_name);
1495 foreach($app_base_themes as $t) {
1496 if(file_exists('view/theme/' . $t . '/style.css')||
1497 file_exists('view/theme/' . $t . '/style.php'))
1501 $fallback = array_merge(glob('view/theme/*/style.css'),glob('view/theme/*/style.php'));
1502 if(count($fallback))
1503 return (str_replace('view/theme/','', substr($fallback[0],0,-10)));
1509 * Return full URL to theme which is currently in effect.
1510 * Provide a sane default if nothing is chosen or the specified theme does not exist.
1512 if(! function_exists('current_theme_url')) {
1513 function current_theme_url() {
1515 $t = current_theme();
1516 if (file_exists('view/theme/' . $t . '/style.php'))
1517 return($a->get_baseurl() . '/view/theme/' . $t . '/style.pcss');
1518 return($a->get_baseurl() . '/view/theme/' . $t . '/style.css');
1522 if(! function_exists('feed_birthday')) {
1523 function feed_birthday($uid,$tz) {
1527 * Determine the next birthday, but only if the birthday is published
1528 * in the default profile. We _could_ also look for a private profile that the
1529 * recipient can see, but somebody could get mad at us if they start getting
1530 * public birthday greetings when they haven't made this info public.
1532 * Assuming we are able to publish this info, we are then going to convert
1533 * the start time from the owner's timezone to UTC.
1535 * This will potentially solve the problem found with some social networks
1536 * where birthdays are converted to the viewer's timezone and salutations from
1537 * elsewhere in the world show up on the wrong day. We will convert it to the
1538 * viewer's timezone also, but first we are going to convert it from the birthday
1539 * person's timezone to GMT - so the viewer may find the birthday starting at
1540 * 6:00PM the day before, but that will correspond to midnight to the birthday person.
1550 $p = q("SELECT `dob` FROM `profile` WHERE `is-default` = 1 AND `uid` = %d LIMIT 1",
1554 if($p && count($p)) {
1555 $tmp_dob = substr($p[0]['dob'],5);
1556 if(intval($tmp_dob)) {
1557 $y = datetime_convert($tz,$tz,'now','Y');
1558 $bd = $y . '-' . $tmp_dob . ' 00:00';
1559 $t_dob = strtotime($bd);
1560 $now = strtotime(datetime_convert($tz,$tz,'now'));
1562 $bd = $y + 1 . '-' . $tmp_dob . ' 00:00';
1563 $birthday = datetime_convert($tz,'UTC',$bd,ATOM_TIME);
1571 if(! function_exists('is_site_admin')) {
1572 function is_site_admin() {
1574 if(local_user() && x($a->user,'email') && x($a->config,'admin_email') && ($a->user['email'] === $a->config['admin_email']))
1581 if(! function_exists('load_contact_links')) {
1582 function load_contact_links($uid) {
1588 if(! $uid || x($a->contacts,'empty'))
1591 $r = q("SELECT `id`,`network`,`url`,`thumb` FROM `contact` WHERE `uid` = %d AND `self` = 0 AND `blocked` = 0 ",
1596 $url = normalise_link($rr['url']);
1601 $ret['empty'] = true;
1602 $a->contacts = $ret;
1607 if(! function_exists('profile_tabs')){
1608 function profile_tabs($a, $is_owner=False, $nickname=Null){
1609 //echo "<pre>"; var_dump($a->user); killme();
1611 if (is_null($nickname))
1612 $nickname = $a->user['nickname'];
1615 $tab = notags(trim($_GET['tab']));
1617 $url = $a->get_baseurl() . '/profile/' . $nickname;
1621 'label'=>t('Status'),
1623 'sel' => ((!isset($tab)&&$a->argv[0]=='profile')?'active':''),
1624 'title' => t('Status Messages and Posts'),
1625 'id' => 'status-tab',
1628 'label' => t('Profile'),
1629 'url' => $url.'/?tab=profile',
1630 'sel' => ((isset($tab) && $tab=='profile')?'active':''),
1631 'title' => t('Profile Details'),
1632 'id' => 'profile-tab',
1635 'label' => t('Photos'),
1636 'url' => $a->get_baseurl() . '/photos/' . $nickname,
1637 'sel' => ((!isset($tab)&&$a->argv[0]=='photos')?'active':''),
1638 'title' => t('Photo Albums'),
1639 'id' => 'photo-tab',
1645 'label' => t('Events'),
1646 'url' => $a->get_baseurl() . '/events',
1647 'sel' =>((!isset($tab)&&$a->argv[0]=='events')?'active':''),
1648 'title' => t('Events and Calendar'),
1649 'id' => 'events-tab',
1652 'label' => t('Personal Notes'),
1653 'url' => $a->get_baseurl() . '/notes',
1654 'sel' =>((!isset($tab)&&$a->argv[0]=='notes')?'active':''),
1655 'title' => t('Only You Can See This'),
1656 'id' => 'notes-tab',
1661 $arr = array('is_owner' => $is_owner, 'nickname' => $nickname, 'tab' => (($tab) ? $tab : false), 'tabs' => $tabs);
1662 call_hooks('profile_tabs', $arr);
1664 $tpl = get_markup_template('common_tabs.tpl');
1666 return replace_macros($tpl,array('$tabs' => $arr['tabs']));
1670 function get_my_url() {
1671 if(x($_SESSION,'my_url'))
1672 return $_SESSION['my_url'];
1676 function zrl_init(&$a) {
1677 $tmp_str = get_my_url();
1678 if(validate_url($tmp_str)) {
1679 proc_run('php','include/gprobe.php',bin2hex($tmp_str));
1680 $arr = array('zrl' => $tmp_str, 'url' => $a->cmd);
1681 call_hooks('zrl_init',$arr);
1685 function zrl($s,$force = false) {
1688 if((! strpos($s,'/profile/')) && (! $force))
1690 if($force && substr($s,-1,1) !== '/')
1692 $achar = strpos($s,'?') ? '&' : '?';
1693 $mine = get_my_url();
1694 if($mine and ! link_compare($mine,$s))
1695 return $s . $achar . 'zrl=' . urlencode($mine);
1700 * returns querystring as string from a mapped array
1702 * @param params Array
1705 function build_querystring($params, $name=null) {
1707 foreach($params as $key=>$val) {
1708 if(is_array($val)) {
1710 $ret .= build_querystring($val, $key);
1712 $ret .= build_querystring($val, $name."[$key]");
1715 $val = urlencode($val);
1717 $ret.=$name."[$key]"."=$val&";
1719 $ret.= "$key=$val&";