boot.php

   1 <?php
   2
   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');
  12 require_once('include/features.php');
  13
  14 define ( 'FRIENDICA_PLATFORM',     'Friendica');
  15 define ( 'FRIENDICA_VERSION',      '3.1.1614' );
  16 define ( 'DFRN_PROTOCOL_VERSION',  '2.23'    );
  17 define ( 'DB_UPDATE_VERSION',      1159      );
  18
  19 define ( 'EOL',                    "<br />\r\n"     );
  20 define ( 'ATOM_TIME',              'Y-m-d\TH:i:s\Z' );
  21
  22
  23 /**
  24  *
  25  * Image storage quality. Lower numbers save space at cost of image detail.
  26  * For ease of upgrade, please do not change here. Change jpeg quality with
  27  * $a->config['system']['jpeg_quality'] = n;
  28  * in .htconfig.php, where n is netween 1 and 100, and with very poor results
  29  * below about 50
  30  *
  31  */
  32
  33 define ( 'JPEG_QUALITY',            100  );
  34 /**
  35  * $a->config['system']['png_quality'] from 0 (uncompressed) to 9
  36  */
  37 define ( 'PNG_QUALITY',             8  );
  38
  39 /**
  40  *
  41  * An alternate way of limiting picture upload sizes. Specify the maximum pixel
  42  * length that pictures are allowed to be (for non-square pictures, it will apply
  43  * to the longest side). Pictures longer than this length will be resized to be
  44  * this length (on the longest side, the other side will be scaled appropriately).
  45  * Modify this value using
  46  *
  47  *    $a->config['system']['max_image_length'] = n;
  48  *
  49  * in .htconfig.php
  50  *
  51  * If you don't want to set a maximum length, set to -1. The default value is
  52  * defined by 'MAX_IMAGE_LENGTH' below.
  53  *
  54  */
  55 define ( 'MAX_IMAGE_LENGTH',        -1  );
  56
  57
  58 /**
  59  * Not yet used
  60  */
  61
  62 define ( 'DEFAULT_DB_ENGINE',  'MyISAM'  );
  63
  64 /**
  65  * SSL redirection policies
  66  */
  67
  68 define ( 'SSL_POLICY_NONE',         0 );
  69 define ( 'SSL_POLICY_FULL',         1 );
  70 define ( 'SSL_POLICY_SELFSIGN',     2 );
  71
  72
  73 /**
  74  * log levels
  75  */
  76
  77 define ( 'LOGGER_NORMAL',          0 );
  78 define ( 'LOGGER_TRACE',           1 );
  79 define ( 'LOGGER_DEBUG',           2 );
  80 define ( 'LOGGER_DATA',            3 );
  81 define ( 'LOGGER_ALL',             4 );
  82
  83 /**
  84  * registration policies
  85  */
  86
  87 define ( 'REGISTER_CLOSED',        0 );
  88 define ( 'REGISTER_APPROVE',       1 );
  89 define ( 'REGISTER_OPEN',          2 );
  90
  91 /**
  92  * relationship types
  93  */
  94
  95 define ( 'CONTACT_IS_FOLLOWER', 1);
  96 define ( 'CONTACT_IS_SHARING',  2);
  97 define ( 'CONTACT_IS_FRIEND',   3);
  98
  99
 100 /**
 101  * DB update return values
 102  */
 103
 104 define ( 'UPDATE_SUCCESS', 0);
 105 define ( 'UPDATE_FAILED',  1);
 106
 107
 108 /**
 109  *
 110  * page/profile types
 111  *
 112  * PAGE_NORMAL is a typical personal profile account
 113  * PAGE_SOAPBOX automatically approves all friend requests as CONTACT_IS_SHARING, (readonly)
 114  * PAGE_COMMUNITY automatically approves all friend requests as CONTACT_IS_SHARING, but with
 115  *      write access to wall and comments (no email and not included in page owner's ACL lists)
 116  * PAGE_FREELOVE automatically approves all friend requests as full friends (CONTACT_IS_FRIEND).
 117  *
 118  */
 119
 120 define ( 'PAGE_NORMAL',            0 );
 121 define ( 'PAGE_SOAPBOX',           1 );
 122 define ( 'PAGE_COMMUNITY',         2 );
 123 define ( 'PAGE_FREELOVE',          3 );
 124 define ( 'PAGE_BLOG',              4 );
 125 define ( 'PAGE_PRVGROUP',          5 );
 126
 127 /**
 128  * Network and protocol family types
 129  */
 130
 131 define ( 'NETWORK_DFRN',             'dfrn');    // Friendica, Mistpark, other DFRN implementations
 132 define ( 'NETWORK_ZOT',              'zot!');    // Zot!
 133 define ( 'NETWORK_OSTATUS',          'stat');    // status.net, identi.ca, GNU-social, other OStatus implementations
 134 define ( 'NETWORK_FEED',             'feed');    // RSS/Atom feeds with no known "post/notify" protocol
 135 define ( 'NETWORK_DIASPORA',         'dspr');    // Diaspora
 136 define ( 'NETWORK_MAIL',             'mail');    // IMAP/POP
 137 define ( 'NETWORK_MAIL2',            'mai2');    // extended IMAP/POP
 138 define ( 'NETWORK_FACEBOOK',         'face');    // Facebook API
 139 define ( 'NETWORK_LINKEDIN',         'lnkd');    // LinkedIn
 140 define ( 'NETWORK_XMPP',             'xmpp');    // XMPP
 141 define ( 'NETWORK_MYSPACE',          'mysp');    // MySpace
 142 define ( 'NETWORK_GPLUS',            'goog');    // Google+
 143
 144 define ( 'NETWORK_PHANTOM',          'unkn');    // Place holder
 145
 146 /**
 147  * These numbers are used in stored permissions
 148  * and existing allocations MUST NEVER BE CHANGED
 149  * OR RE-ASSIGNED! You may only add to them.
 150  */
 151
 152 $netgroup_ids = array(
 153         NETWORK_DFRN     => (-1),
 154         NETWORK_ZOT      => (-2),
 155         NETWORK_OSTATUS  => (-3),
 156         NETWORK_FEED     => (-4),
 157         NETWORK_DIASPORA => (-5),
 158         NETWORK_MAIL     => (-6),
 159         NETWORK_MAIL2    => (-7),
 160         NETWORK_FACEBOOK => (-8),
 161         NETWORK_LINKEDIN => (-9),
 162         NETWORK_XMPP     => (-10),
 163         NETWORK_MYSPACE  => (-11),
 164         NETWORK_GPLUS    => (-12),
 165
 166         NETWORK_PHANTOM  => (-127),
 167 );
 168
 169
 170 /**
 171  * Maximum number of "people who like (or don't like) this"  that we will list by name
 172  */
 173
 174 define ( 'MAX_LIKERS',    75);
 175
 176 /**
 177  * Communication timeout
 178  */
 179
 180 define ( 'ZCURL_TIMEOUT' , (-1));
 181
 182
 183 /**
 184  * email notification options
 185  */
 186
 187 define ( 'NOTIFY_INTRO',    0x0001 );
 188 define ( 'NOTIFY_CONFIRM',  0x0002 );
 189 define ( 'NOTIFY_WALL',     0x0004 );
 190 define ( 'NOTIFY_COMMENT',  0x0008 );
 191 define ( 'NOTIFY_MAIL',     0x0010 );
 192 define ( 'NOTIFY_SUGGEST',  0x0020 );
 193 define ( 'NOTIFY_PROFILE',  0x0040 );
 194 define ( 'NOTIFY_TAGSELF',  0x0080 );
 195 define ( 'NOTIFY_TAGSHARE', 0x0100 );
 196 define ( 'NOTIFY_POKE',     0x0200 );
 197
 198 define ( 'NOTIFY_SYSTEM',   0x8000 );
 199
 200
 201 /**
 202  * Tag/term types
 203  */
 204
 205 define ( 'TERM_UNKNOWN',   0 );
 206 define ( 'TERM_HASHTAG',   1 );
 207 define ( 'TERM_MENTION',   2 );
 208 define ( 'TERM_CATEGORY',  3 );
 209 define ( 'TERM_PCATEGORY', 4 );
 210 define ( 'TERM_FILE',      5 );
 211
 212 define ( 'TERM_OBJ_POST',  1 );
 213 define ( 'TERM_OBJ_PHOTO', 2 );
 214
 215
 216
 217 /**
 218  * various namespaces we may need to parse
 219  */
 220
 221 define ( 'NAMESPACE_ZOT',             'http://purl.org/zot' );
 222 define ( 'NAMESPACE_DFRN' ,           'http://purl.org/macgirvin/dfrn/1.0' );
 223 define ( 'NAMESPACE_THREAD' ,         'http://purl.org/syndication/thread/1.0' );
 224 define ( 'NAMESPACE_TOMB' ,           'http://purl.org/atompub/tombstones/1.0' );
 225 define ( 'NAMESPACE_ACTIVITY',        'http://activitystrea.ms/spec/1.0/' );
 226 define ( 'NAMESPACE_ACTIVITY_SCHEMA', 'http://activitystrea.ms/schema/1.0/' );
 227 define ( 'NAMESPACE_MEDIA',           'http://purl.org/syndication/atommedia' );
 228 define ( 'NAMESPACE_SALMON_ME',       'http://salmon-protocol.org/ns/magic-env' );
 229 define ( 'NAMESPACE_OSTATUSSUB',      'http://ostatus.org/schema/1.0/subscribe' );
 230 define ( 'NAMESPACE_GEORSS',          'http://www.georss.org/georss' );
 231 define ( 'NAMESPACE_POCO',            'http://portablecontacts.net/spec/1.0' );
 232 define ( 'NAMESPACE_FEED',            'http://schemas.google.com/g/2010#updates-from' );
 233 define ( 'NAMESPACE_OSTATUS',         'http://ostatus.org/schema/1.0' );
 234 define ( 'NAMESPACE_STATUSNET',       'http://status.net/schema/api/1/' );
 235 define ( 'NAMESPACE_ATOM1',           'http://www.w3.org/2005/Atom' );
 236 /**
 237  * activity stream defines
 238  */
 239
 240 define ( 'ACTIVITY_LIKE',        NAMESPACE_ACTIVITY_SCHEMA . 'like' );
 241 define ( 'ACTIVITY_DISLIKE',     NAMESPACE_DFRN            . '/dislike' );
 242 define ( 'ACTIVITY_OBJ_HEART',   NAMESPACE_DFRN            . '/heart' );
 243
 244 define ( 'ACTIVITY_FRIEND',      NAMESPACE_ACTIVITY_SCHEMA . 'make-friend' );
 245 define ( 'ACTIVITY_REQ_FRIEND',  NAMESPACE_ACTIVITY_SCHEMA . 'request-friend' );
 246 define ( 'ACTIVITY_UNFRIEND',    NAMESPACE_ACTIVITY_SCHEMA . 'remove-friend' );
 247 define ( 'ACTIVITY_FOLLOW',      NAMESPACE_ACTIVITY_SCHEMA . 'follow' );
 248 define ( 'ACTIVITY_UNFOLLOW',    NAMESPACE_ACTIVITY_SCHEMA . 'stop-following' );
 249 define ( 'ACTIVITY_JOIN',        NAMESPACE_ACTIVITY_SCHEMA . 'join' );
 250
 251 define ( 'ACTIVITY_POST',        NAMESPACE_ACTIVITY_SCHEMA . 'post' );
 252 define ( 'ACTIVITY_UPDATE',      NAMESPACE_ACTIVITY_SCHEMA . 'update' );
 253 define ( 'ACTIVITY_TAG',         NAMESPACE_ACTIVITY_SCHEMA . 'tag' );
 254 define ( 'ACTIVITY_FAVORITE',    NAMESPACE_ACTIVITY_SCHEMA . 'favorite' );
 255
 256 define ( 'ACTIVITY_POKE',        NAMESPACE_ZOT . '/activity/poke' );
 257 define ( 'ACTIVITY_MOOD',        NAMESPACE_ZOT . '/activity/mood' );
 258
 259 define ( 'ACTIVITY_OBJ_COMMENT', NAMESPACE_ACTIVITY_SCHEMA . 'comment' );
 260 define ( 'ACTIVITY_OBJ_NOTE',    NAMESPACE_ACTIVITY_SCHEMA . 'note' );
 261 define ( 'ACTIVITY_OBJ_PERSON',  NAMESPACE_ACTIVITY_SCHEMA . 'person' );
 262 define ( 'ACTIVITY_OBJ_PHOTO',   NAMESPACE_ACTIVITY_SCHEMA . 'photo' );
 263 define ( 'ACTIVITY_OBJ_P_PHOTO', NAMESPACE_ACTIVITY_SCHEMA . 'profile-photo' );
 264 define ( 'ACTIVITY_OBJ_ALBUM',   NAMESPACE_ACTIVITY_SCHEMA . 'photo-album' );
 265 define ( 'ACTIVITY_OBJ_EVENT',   NAMESPACE_ACTIVITY_SCHEMA . 'event' );
 266 define ( 'ACTIVITY_OBJ_GROUP',   NAMESPACE_ACTIVITY_SCHEMA . 'group' );
 267 define ( 'ACTIVITY_OBJ_TAGTERM', NAMESPACE_DFRN            . '/tagterm' );
 268 define ( 'ACTIVITY_OBJ_PROFILE', NAMESPACE_DFRN            . '/profile' );
 269
 270 /**
 271  * item weight for query ordering
 272  */
 273
 274 define ( 'GRAVITY_PARENT',       0);
 275 define ( 'GRAVITY_LIKE',         3);
 276 define ( 'GRAVITY_COMMENT',      6);
 277
 278 /**
 279  *
 280  * Reverse the effect of magic_quotes_gpc if it is enabled.
 281  * Please disable magic_quotes_gpc so we don't have to do this.
 282  * See http://php.net/manual/en/security.magicquotes.disabling.php
 283  *
 284  */
 285
 286 function startup() {
 287
 288         error_reporting(E_ERROR | E_WARNING | E_PARSE);
 289
 290         set_time_limit(0);
 291
 292         // This has to be quite large to deal with embedded private photos
 293         ini_set('pcre.backtrack_limit', 500000);
 294
 295
 296         if (get_magic_quotes_gpc()) {
 297                 $process = array(&$_GET, &$_POST, &$_COOKIE, &$_REQUEST);
 298                 while (list($key, $val) = each($process)) {
 299                         foreach ($val as $k => $v) {
 300                                 unset($process[$key][$k]);
 301                                 if (is_array($v)) {
 302                                         $process[$key][stripslashes($k)] = $v;
 303                                         $process[] = &$process[$key][stripslashes($k)];
 304                                 } else {
 305                                         $process[$key][stripslashes($k)] = stripslashes($v);
 306                                 }
 307                         }
 308                 }
 309                 unset($process);
 310         }
 311
 312 }
 313
 314 /**
 315  *
 316  * class: App
 317  *
 318  * Our main application structure for the life of this page
 319  * Primarily deals with the URL that got us here
 320  * and tries to make some sense of it, and
 321  * stores our page contents and config storage
 322  * and anything else that might need to be passed around
 323  * before we spit the page out.
 324  *
 325  */
 326
 327 if(! class_exists('App')) {
 328         class App {
 329
 330                 public  $module_loaded = false;
 331                 public  $query_string;
 332                 public  $config;
 333                 public  $page;
 334                 public  $profile;
 335                 public  $user;
 336                 public  $cid;
 337                 public  $contact;
 338                 public  $contacts;
 339                 public  $page_contact;
 340                 public  $content;
 341                 public  $data = array();
 342                 public  $error = false;
 343                 public  $cmd;
 344                 public  $argv;
 345                 public  $argc;
 346                 public  $module;
 347                 public  $pager;
 348                 public  $strings;
 349                 public  $path;
 350                 public  $hooks;
 351                 public  $timezone;
 352                 public  $interactive = true;
 353                 public  $plugins;
 354                 public  $apps = array();
 355                 public  $identities;
 356                 public  $is_mobile;
 357                 public  $is_tablet;
 358
 359                 public $nav_sel;
 360
 361                 public $category;
 362
 363
 364                 // Allow themes to control internal parameters
 365                 // by changing App values in theme.php
 366
 367                 public  $sourcename = '';
 368                 public  $videowidth = 425;
 369                 public  $videoheight = 350;
 370                 public  $force_max_items = 0;
 371                 public  $theme_thread_allow = true;
 372
 373                 // An array for all theme-controllable parameters
 374                 // Mostly unimplemented yet. Only options 'stylesheet' and
 375                 // beyond are used.
 376
 377                 public  $theme = array(
 378                         'sourcename' => '',
 379                         'videowidth' => 425,
 380                         'videoheight' => 350,
 381                         'force_max_items' => 0,
 382                         'thread_allow' => true,
 383                         'stylesheet' => '',
 384                         'template_engine' => 'internal',
 385                 );
 386
 387                 private $ldelim = array(
 388                         'internal' => '',
 389                         'smarty3' => '{{'
 390                 );
 391                 private $rdelim = array(
 392                         'internal' => '',
 393                         'smarty3' => '}}'
 394                 );
 395
 396                 private $scheme;
 397                 private $hostname;
 398                 private $baseurl;
 399                 private $db;
 400
 401                 private $curl_code;
 402                 private $curl_headers;
 403
 404                 private $cached_profile_image;
 405                 private $cached_profile_picdate;
 406
 407                 function __construct() {
 408
 409                         global $default_timezone, $argv, $argc;
 410
 411                         $this->timezone = ((x($default_timezone)) ? $default_timezone : 'UTC');
 412
 413                         date_default_timezone_set($this->timezone);
 414
 415                         $this->config = array();
 416                         $this->page = array();
 417                         $this->pager= array();
 418
 419                         $this->query_string = '';
 420
 421                         startup();
 422
 423                         $this->scheme = 'http';
 424                         if(x($_SERVER,'HTTPS') && $_SERVER['HTTPS'])
 425                                 $this->scheme = 'https';
 426                         elseif(x($_SERVER,'SERVER_PORT') && (intval($_SERVER['SERVER_PORT']) == 443))
 427                         $this->scheme = 'https';
 428
 429                         if(x($_SERVER,'SERVER_NAME')) {
 430                                 $this->hostname = $_SERVER['SERVER_NAME'];
 431
 432                                 // See bug 437 - this didn't work so disabling it
 433                                 //if(stristr($this->hostname,'xn--')) {
 434                                         // PHP or webserver may have converted idn to punycode, so
 435                                         // convert punycode back to utf-8
 436                                 //      require_once('library/simplepie/idn/idna_convert.class.php');
 437                                 //      $x = new idna_convert();
 438                                 //      $this->hostname = $x->decode($_SERVER['SERVER_NAME']);
 439                                 //}
 440
 441                                 if(x($_SERVER,'SERVER_PORT') && $_SERVER['SERVER_PORT'] != 80 && $_SERVER['SERVER_PORT'] != 443)
 442                                         $this->hostname .= ':' . $_SERVER['SERVER_PORT'];
 443                                 /**
 444                                  * Figure out if we are running at the top of a domain
 445                                  * or in a sub-directory and adjust accordingly
 446                                  */
 447
 448                                 $path = trim(dirname($_SERVER['SCRIPT_NAME']),'/\\');
 449                                 if(isset($path) && strlen($path) && ($path != $this->path))
 450                                         $this->path = $path;
 451                         }
 452                         if (is_array($argv) && $argc>1 && substr(end($argv), 0, 4)=="http" ) {
 453                                 $this->set_baseurl(array_pop($argv) );
 454                                 $argc --;
 455                         }
 456
 457                         set_include_path(
 458                                         "include/$this->hostname" . PATH_SEPARATOR
 459                                         . 'include' . PATH_SEPARATOR
 460                                         . 'library' . PATH_SEPARATOR
 461                                         . 'library/phpsec' . PATH_SEPARATOR
 462                                         . 'library/langdet' . PATH_SEPARATOR
 463                                         . '.' );
 464
 465
 466                         if((x($_SERVER,'QUERY_STRING')) && substr($_SERVER['QUERY_STRING'],0,2) === "q=") {
 467                                 $this->query_string = substr($_SERVER['QUERY_STRING'],2);
 468                                 // removing trailing / - maybe a nginx problem
 469                                 if (substr($this->query_string, 0, 1) == "/")
 470                                         $this->query_string = substr($this->query_string, 1);
 471                         }
 472                         if(x($_GET,'q'))
 473                                 $this->cmd = trim($_GET['q'],'/\\');
 474
 475                         // unix style "homedir"
 476
 477                         if(substr($this->cmd,0,1) === '~')
 478                                 $this->cmd = 'profile/' . substr($this->cmd,1);
 479
 480                         // Diaspora style profile url
 481
 482                         if(substr($this->cmd,0,2) === 'u/')
 483                                 $this->cmd = 'profile/' . substr($this->cmd,2);
 484
 485                         /**
 486                          *
 487                          * Break the URL path into C style argc/argv style arguments for our
 488                          * modules. Given "http://example.com/module/arg1/arg2", $this->argc
 489                          * will be 3 (integer) and $this->argv will contain:
 490                          *   [0] => 'module'
 491                          *   [1] => 'arg1'
 492                          *   [2] => 'arg2'
 493                          *
 494                          *
 495                          * There will always be one argument. If provided a naked domain
 496                          * URL, $this->argv[0] is set to "home".
 497                          *
 498                          */
 499
 500                         $this->argv = explode('/',$this->cmd);
 501                         $this->argc = count($this->argv);
 502                         if((array_key_exists('0',$this->argv)) && strlen($this->argv[0])) {
 503                                 $this->module = str_replace(".", "_", $this->argv[0]);
 504                                 $this->module = str_replace("-", "_", $this->module);
 505                         }
 506                         else {
 507                                 $this->argc = 1;
 508                                 $this->argv = array('home');
 509                                 $this->module = 'home';
 510                         }
 511
 512                         /**
 513                          * See if there is any page number information, and initialise
 514                          * pagination
 515                          */
 516
 517                         $this->pager['page'] = ((x($_GET,'page') && intval($_GET['page']) > 0) ? intval($_GET['page']) : 1);
 518                         $this->pager['itemspage'] = 50;
 519                         $this->pager['start'] = ($this->pager['page'] * $this->pager['itemspage']) - $this->pager['itemspage'];
 520                         if($this->pager['start'] < 0)
 521                                 $this->pager['start'] = 0;
 522                         $this->pager['total'] = 0;
 523
 524                         /**
 525                          * Detect mobile devices
 526                          */
 527
 528                         $mobile_detect = new Mobile_Detect();
 529                         $this->is_mobile = $mobile_detect->isMobile();
 530                         $this->is_tablet = $mobile_detect->isTablet();
 531                 }
 532
 533                 function get_basepath() {
 534
 535                         $basepath = get_config("system", "basepath");
 536
 537                         if ($basepath == "")
 538                                 $basepath = $_SERVER["DOCUMENT_ROOT"];
 539
 540                         if ($basepath == "")
 541                                 $basepath = $_SERVER["PWD"];
 542
 543                         return($basepath);
 544                 }
 545
 546                 function get_baseurl($ssl = false) {
 547
 548                         $scheme = $this->scheme;
 549
 550                         if((x($this->config,'system')) && (x($this->config['system'],'ssl_policy'))) {
 551                                 if(intval($this->config['system']['ssl_policy']) === intval(SSL_POLICY_FULL))
 552                                         $scheme = 'https';
 553
 554                                 //      Basically, we have $ssl = true on any links which can only be seen by a logged in user
 555                                 //      (and also the login link). Anything seen by an outsider will have it turned off.
 556
 557                                 if($this->config['system']['ssl_policy'] == SSL_POLICY_SELFSIGN) {
 558                                         if($ssl)
 559                                                 $scheme = 'https';
 560                                         else
 561                                                 $scheme = 'http';
 562                                 }
 563                         }
 564
 565                         $this->baseurl = $scheme . "://" . $this->hostname . ((isset($this->path) && strlen($this->path)) ? '/' . $this->path : '' );
 566                         return $this->baseurl;
 567                 }
 568
 569                 function set_baseurl($url) {
 570                         $parsed = @parse_url($url);
 571
 572                         $this->baseurl = $url;
 573
 574                         if($parsed) {
 575                                 $this->scheme = $parsed['scheme'];
 576
 577                                 $this->hostname = $parsed['host'];
 578                                 if(x($parsed,'port'))
 579                                         $this->hostname .= ':' . $parsed['port'];
 580                                 if(x($parsed,'path'))
 581                                         $this->path = trim($parsed['path'],'\\/');
 582                         }
 583
 584                 }
 585
 586                 function get_hostname() {
 587                         return $this->hostname;
 588                 }
 589
 590                 function set_hostname($h) {
 591                         $this->hostname = $h;
 592                 }
 593
 594                 function set_path($p) {
 595                         $this->path = trim(trim($p),'/');
 596                 }
 597
 598                 function get_path() {
 599                         return $this->path;
 600                 }
 601
 602                 function set_pager_total($n) {
 603                         $this->pager['total'] = intval($n);
 604                 }
 605
 606                 function set_pager_itemspage($n) {
 607                         $this->pager['itemspage'] = ((intval($n) > 0) ? intval($n) : 0);
 608                         $this->pager['start'] = ($this->pager['page'] * $this->pager['itemspage']) - $this->pager['itemspage'];
 609
 610                 }
 611
 612                 function init_pagehead() {
 613                         $interval = ((local_user()) ? get_pconfig(local_user(),'system','update_interval') : 40000);
 614                         if($interval < 10000)
 615                                 $interval = 40000;
 616
 617                         $this->page['title'] = $this->config['sitename'];
 618
 619                         /* put the head template at the beginning of page['htmlhead']
 620                          * since the code added by the modules frequently depends on it
 621                          * being first
 622                          */
 623                         if(!isset($this->page['htmlhead']))
 624                                 $this->page['htmlhead'] = '';
 625
 626                         // If we're using Smarty, then doing replace_macros() will replace
 627                         // any unrecognized variables with a blank string. Since we delay
 628                         // replacing $stylesheet until later, we need to replace it now
 629                         // with another variable name
 630                         if($this->theme['template_engine'] === 'smarty3')
 631                                 $stylesheet = $this->get_template_ldelim('smarty3') . '$stylesheet' . $this->get_template_rdelim('smarty3');
 632                         else
 633                                 $stylesheet = '$stylesheet';
 634
 635                         $tpl = get_markup_template('head.tpl');
 636                         $this->page['htmlhead'] = replace_macros($tpl,array(
 637                                 '$baseurl' => $this->get_baseurl(), // FIXME for z_path!!!!
 638                                 '$local_user' => local_user(),
 639                                 '$generator' => 'Friendica' . ' ' . FRIENDICA_VERSION,
 640                                 '$delitem' => t('Delete this item?'),
 641                                 '$comment' => t('Comment'),
 642                                 '$showmore' => t('show more'),
 643                                 '$showfewer' => t('show fewer'),
 644                                 '$update_interval' => $interval,
 645                                 '$stylesheet' => $stylesheet
 646                         )) . $this->page['htmlhead'];
 647                 }
 648
 649                 function init_page_end() {
 650                         if(!isset($this->page['end']))
 651                                 $this->page['end'] = '';
 652                         $tpl = get_markup_template('end.tpl');
 653                         $this->page['end'] = replace_macros($tpl,array(
 654                                 '$baseurl' => $this->get_baseurl() // FIXME for z_path!!!!
 655                         )) . $this->page['end'];
 656                 }
 657
 658                 function set_curl_code($code) {
 659                         $this->curl_code = $code;
 660                 }
 661
 662                 function get_curl_code() {
 663                         return $this->curl_code;
 664                 }
 665
 666                 function set_curl_headers($headers) {
 667                         $this->curl_headers = $headers;
 668                 }
 669
 670                 function get_curl_headers() {
 671                         return $this->curl_headers;
 672                 }
 673
 674                 function get_cached_avatar_image($avatar_image){
 675                         if($this->cached_profile_image[$avatar_image])
 676                                 return $this->cached_profile_image[$avatar_image];
 677
 678                         $path_parts = explode("/",$avatar_image);
 679                         $common_filename = $path_parts[count($path_parts)-1];
 680
 681                         if($this->cached_profile_picdate[$common_filename]){
 682                                 $this->cached_profile_image[$avatar_image] = $avatar_image . $this->cached_profile_picdate[$common_filename];
 683                         } else {
 684                                 $r = q("SELECT `contact`.`avatar-date` AS picdate FROM `contact` WHERE `contact`.`thumb` like \"%%/%s\"",
 685                                         $common_filename);
 686                                 if(! count($r)){
 687                                         $this->cached_profile_image[$avatar_image] = $avatar_image;
 688                                 } else {
 689                                         $this->cached_profile_picdate[$common_filename] = "?rev=" . urlencode($r[0]['picdate']);
 690                                         $this->cached_profile_image[$avatar_image] = $avatar_image . $this->cached_profile_picdate[$common_filename];
 691                                 }
 692                         }
 693                         return $this->cached_profile_image[$avatar_image];
 694                 }
 695
 696                 function get_template_engine() {
 697                         return $this->theme['template_engine'];
 698                 }
 699
 700                 function set_template_engine($engine = 'internal') {
 701
 702                         $this->theme['template_engine'] = 'internal';
 703
 704                         switch($engine) {
 705                                 case 'smarty3':
 706                                         if(is_writable('view/smarty3/'))
 707                                                 $this->theme['template_engine'] = 'smarty3';
 708                                         break;
 709                                 default:
 710                                         break;
 711                         }
 712                 }
 713
 714                 function get_template_ldelim($engine = 'internal') {
 715                         return $this->ldelim[$engine];
 716                 }
 717
 718                 function get_template_rdelim($engine = 'internal') {
 719                         return $this->rdelim[$engine];
 720                 }
 721
 722         }
 723 }
 724
 725 // retrieve the App structure
 726 // useful in functions which require it but don't get it passed to them
 727
 728 if(! function_exists('get_app')) {
 729         function get_app() {
 730                 global $a;
 731                 return $a;
 732         }
 733 };
 734
 735
 736 // Multi-purpose function to check variable state.
 737 // Usage: x($var) or $x($array,'key')
 738 // returns false if variable/key is not set
 739 // if variable is set, returns 1 if has 'non-zero' value, otherwise returns 0.
 740 // e.g. x('') or x(0) returns 0;
 741
 742 if(! function_exists('x')) {
 743         function x($s,$k = NULL) {
 744                 if($k != NULL) {
 745                         if((is_array($s)) && (array_key_exists($k,$s))) {
 746                                 if($s[$k])
 747                                         return (int) 1;
 748                                 return (int) 0;
 749                 }
 750                         return false;
 751                 }
 752                 else {
 753                         if(isset($s)) {
 754                                 if($s) {
 755                                         return (int) 1;
 756                                 }
 757                                 return (int) 0;
 758                         }
 759                         return false;
 760                 }
 761         }
 762 }
 763
 764 // called from db initialisation if db is dead.
 765
 766 if(! function_exists('system_unavailable')) {
 767         function system_unavailable() {
 768                 include('system_unavailable.php');
 769                 system_down();
 770                 killme();
 771         }
 772 }
 773
 774
 775
 776 function clean_urls() {
 777         global $a;
 778         //      if($a->config['system']['clean_urls'])
 779         return true;
 780         //      return false;
 781 }
 782
 783 function z_path() {
 784         global $a;
 785         $base = $a->get_baseurl();
 786         if(! clean_urls())
 787                 $base .= '/?q=';
 788         return $base;
 789 }
 790
 791 function z_root() {
 792         global $a;
 793         return $a->get_baseurl();
 794 }
 795
 796 function absurl($path) {
 797         if(strpos($path,'/') === 0)
 798                 return z_path() . $path;
 799         return $path;
 800 }
 801
 802 function is_ajax() {
 803         return (!empty($_SERVER['HTTP_X_REQUESTED_WITH']) && strtolower($_SERVER['HTTP_X_REQUESTED_WITH']) == 'xmlhttprequest');
 804 }
 805
 806 function check_db() {
 807
 808         $build = get_config('system','build');
 809         if(! x($build)) {
 810                 set_config('system','build',DB_UPDATE_VERSION);
 811                 $build = DB_UPDATE_VERSION;
 812         }
 813         if($build != DB_UPDATE_VERSION)
 814                 proc_run('php', 'include/dbupdate.php');
 815
 816 }
 817
 818
 819
 820
 821 // Sets the base url for use in cmdline programs which don't have
 822 // $_SERVER variables
 823
 824 if(! function_exists('check_url')) {
 825         function check_url(&$a) {
 826
 827                 $url = get_config('system','url');
 828
 829                 // if the url isn't set or the stored url is radically different
 830                 // than the currently visited url, store the current value accordingly.
 831                 // "Radically different" ignores common variations such as http vs https
 832                 // and www.example.com vs example.com.
 833                 // We will only change the url to an ip address if there is no existing setting
 834
 835                 if(! x($url))
 836                         $url = set_config('system','url',$a->get_baseurl());
 837                 if((! link_compare($url,$a->get_baseurl())) && (! preg_match("/^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/",$a->get_hostname)))
 838                         $url = set_config('system','url',$a->get_baseurl());
 839
 840                 return;
 841         }
 842 }
 843
 844
 845 // Automatic database updates
 846
 847 if(! function_exists('update_db')) {
 848         function update_db(&$a) {
 849
 850                 $build = get_config('system','build');
 851                 if(! x($build))
 852                         $build = set_config('system','build',DB_UPDATE_VERSION);
 853
 854                 if($build != DB_UPDATE_VERSION) {
 855                         $stored = intval($build);
 856                         $current = intval(DB_UPDATE_VERSION);
 857                         if(($stored < $current) && file_exists('update.php')) {
 858
 859                                 load_config('database');
 860
 861                                 // We're reporting a different version than what is currently installed.
 862                                 // Run any existing update scripts to bring the database up to current.
 863
 864                                 require_once('update.php');
 865
 866                                 // make sure that boot.php and update.php are the same release, we might be
 867                                 // updating right this very second and the correct version of the update.php
 868                                 // file may not be here yet. This can happen on a very busy site.
 869
 870                                 if(DB_UPDATE_VERSION == UPDATE_VERSION) {
 871
 872                                         for($x = $stored; $x < $current; $x ++) {
 873                                                 if(function_exists('update_' . $x)) {
 874
 875                                                         // There could be a lot of processes running or about to run.
 876                                                         // We want exactly one process to run the update command.
 877                                                         // So store the fact that we're taking responsibility
 878                                                         // after first checking to see if somebody else already has.
 879
 880                                                         // If the update fails or times-out completely you may need to
 881                                                         // delete the config entry to try again.
 882
 883                                                         $t = get_config('database','update_' . $x);
 884                                                         if($t !== false)
 885                                                                 break;
 886                                                         set_config('database','update_' . $x, time());
 887
 888                                                         // call the specific update
 889
 890                                                         $func = 'update_' . $x;
 891                                                         $retval = $func();
 892                                                         if($retval) {
 893                                                                 //send the administrator an e-mail
 894                                                                 $email_tpl = get_intltext_template("update_fail_eml.tpl");
 895                                                                 $email_msg = replace_macros($email_tpl, array(
 896                                                                         '$sitename' => $a->config['sitename'],
 897                                                                         '$siteurl' =>  $a->get_baseurl(),
 898                                                                         '$update' => $x,
 899                                                                         '$error' => sprintf( t('Update %s failed. See error logs.'), $x)
 900                                                                 ));
 901                                                                 $subject=sprintf(t('Update Error at %s'), $a->get_baseurl());
 902                                                                 require_once('include/email.php');
 903                                                                 $subject = email_header_encode($subject,'UTF-8');
 904                                                                 mail($a->config['admin_email'], $subject, $email_msg,
 905                                                                         'From: ' . 'Administrator' . '@' . $_SERVER['SERVER_NAME'] . "\n"
 906                                                                         . 'Content-type: text/plain; charset=UTF-8' . "\n"
 907                                                                         . 'Content-transfer-encoding: 8bit' );
 908                                                                 //try the logger
 909                                                                 logger('CRITICAL: Update Failed: '. $x);
 910                                                                 break;
 911                                                         }
 912                                                         else {
 913                                                                 set_config('database','update_' . $x, 'success');
 914                                                                 set_config('system','build', $x + 1);
 915                                                         }
 916                                                 }
 917                                         }
 918                                 }
 919                         }
 920                 }
 921
 922                 return;
 923         }
 924 }
 925
 926
 927 if(! function_exists('check_plugins')) {
 928         function check_plugins(&$a) {
 929
 930                 /**
 931                  *
 932                  * Synchronise plugins:
 933                  *
 934                  * $a->config['system']['addon'] contains a comma-separated list of names
 935                  * of plugins/addons which are used on this system.
 936                  * Go through the database list of already installed addons, and if we have
 937                  * an entry, but it isn't in the config list, call the uninstall procedure
 938                  * and mark it uninstalled in the database (for now we'll remove it).
 939                  * Then go through the config list and if we have a plugin that isn't installed,
 940                  * call the install procedure and add it to the database.
 941                  *
 942                  */
 943
 944                 $r = q("SELECT * FROM `addon` WHERE `installed` = 1");
 945                 if(count($r))
 946                         $installed = $r;
 947                 else
 948                         $installed = array();
 949
 950                 $plugins = get_config('system','addon');
 951                 $plugins_arr = array();
 952
 953                 if($plugins)
 954                         $plugins_arr = explode(',',str_replace(' ', '',$plugins));
 955
 956                 $a->plugins = $plugins_arr;
 957
 958                 $installed_arr = array();
 959
 960                 if(count($installed)) {
 961                         foreach($installed as $i) {
 962                                 if(! in_array($i['name'],$plugins_arr)) {
 963                                         uninstall_plugin($i['name']);
 964                                 }
 965                                 else {
 966                                         $installed_arr[] = $i['name'];
 967                                 }
 968                         }
 969                 }
 970
 971                 if(count($plugins_arr)) {
 972                         foreach($plugins_arr as $p) {
 973                                 if(! in_array($p,$installed_arr)) {
 974                                         install_plugin($p);
 975                                 }
 976                         }
 977                 }
 978
 979
 980                 load_hooks();
 981
 982                 return;
 983         }
 984 }
 985
 986
 987 function get_guid($size=16) {
 988         $exists = true; // assume by default that we don't have a unique guid
 989         do {
 990                 $s = random_string($size);
 991                 $r = q("select id from guid where guid = '%s' limit 1", dbesc($s));
 992                 if(! count($r))
 993                         $exists = false;
 994         } while($exists);
 995         q("insert into guid ( guid ) values ( '%s' ) ", dbesc($s));
 996         return $s;
 997 }
 998
 999
1000 // wrapper for adding a login box. If $register == true provide a registration
1001 // link. This will most always depend on the value of $a->config['register_policy'].
1002 // returns the complete html for inserting into the page
1003
1004 if(! function_exists('login')) {
1005         function login($register = false, $hiddens=false) {
1006                 $a = get_app();
1007                 $o = "";
1008                 $reg = false;
1009                 if ($register) {
1010                         $reg = array(
1011                                 'title' => t('Create a New Account'),
1012                                 'desc' => t('Register')
1013                         );
1014                 }
1015
1016                 $noid = get_config('system','no_openid');
1017
1018                 $dest_url = $a->get_baseurl(true) . '/' . $a->query_string;
1019
1020                 if(local_user()) {
1021                         $tpl = get_markup_template("logout.tpl");
1022                 }
1023                 else {
1024                         $a->page['htmlhead'] .= replace_macros(get_markup_template("login_head.tpl"),array(
1025                                 '$baseurl'              => $a->get_baseurl(true)
1026                         ));
1027
1028                         $tpl = get_markup_template("login.tpl");
1029                         $_SESSION['return_url'] = $a->query_string;
1030                         $a->module = 'login';
1031                 }
1032
1033                 $o .= replace_macros($tpl, array(
1034
1035                         '$dest_url'     => $dest_url,
1036                         '$logout'       => t('Logout'),
1037                         '$login'        => t('Login'),
1038
1039                         '$lname'                => array('username', t('Nickname or Email address: ') , '', ''),
1040                         '$lpassword'    => array('password', t('Password: '), '', ''),
1041                         '$lremember'    => array('remember', t('Remember me'), 0, ''),
1042
1043                         '$openid'               => !$noid,
1044                         '$lopenid'      => array('openid_url', t('Or login using OpenID: '),'',''),
1045
1046                         '$hiddens'      => $hiddens,
1047
1048                         '$register'     => $reg,
1049
1050                         '$lostpass'     => t('Forgot your password?'),
1051                         '$lostlink'     => t('Password Reset'),
1052
1053                         '$tostitle'     => t('Website Terms of Service'),
1054                         '$toslink'      => t('terms of service'),
1055
1056                         '$privacytitle' => t('Website Privacy Policy'),
1057                         '$privacylink'  => t('privacy policy'),
1058
1059                 ));
1060
1061                 call_hooks('login_hook',$o);
1062
1063                 return $o;
1064         }
1065 }
1066
1067 // Used to end the current process, after saving session state.
1068
1069 if(! function_exists('killme')) {
1070         function killme() {
1071                 session_write_close();
1072                 exit;
1073         }
1074 }
1075
1076 // redirect to another URL and terminate this process.
1077
1078 if(! function_exists('goaway')) {
1079         function goaway($s) {
1080                 header("Location: $s");
1081                 killme();
1082         }
1083 }
1084
1085
1086 // Returns the uid of locally logged in user or false.
1087
1088 if(! function_exists('local_user')) {
1089         function local_user() {
1090                 if((x($_SESSION,'authenticated')) && (x($_SESSION,'uid')))
1091                         return intval($_SESSION['uid']);
1092                 return false;
1093         }
1094 }
1095
1096 // Returns contact id of authenticated site visitor or false
1097
1098 if(! function_exists('remote_user')) {
1099         function remote_user() {
1100                 if((x($_SESSION,'authenticated')) && (x($_SESSION,'visitor_id')))
1101                         return intval($_SESSION['visitor_id']);
1102                 return false;
1103         }
1104 }
1105
1106 // contents of $s are displayed prominently on the page the next time
1107 // a page is loaded. Usually used for errors or alerts.
1108
1109 if(! function_exists('notice')) {
1110         /**
1111          * Show an error message to user.
1112          *
1113          * This function save text in session, to be shown to the user at next page load
1114          *
1115          * @param string $s - Text of notice
1116          */
1117         function notice($s) {
1118                 $a = get_app();
1119                 if(! x($_SESSION,'sysmsg'))     $_SESSION['sysmsg'] = array();
1120                 if($a->interactive)
1121                         $_SESSION['sysmsg'][] = $s;
1122         }
1123 }
1124 if(! function_exists('info')) {
1125         /**
1126          * Show an info message to user.
1127          *
1128          * This function save text in session, to be shown to the user at next page load
1129          *
1130          * @param string $s - Text of notice
1131          */
1132         function info($s) {
1133                 $a = get_app();
1134                 if(! x($_SESSION,'sysmsg_info')) $_SESSION['sysmsg_info'] = array();
1135                 if($a->interactive)
1136                         $_SESSION['sysmsg_info'][] = $s;
1137         }
1138 }
1139
1140
1141 // wrapper around config to limit the text length of an incoming message
1142
1143 if(! function_exists('get_max_import_size')) {
1144         function get_max_import_size() {
1145                 global $a;
1146                 return ((x($a->config,'max_import_size')) ? $a->config['max_import_size'] : 0 );
1147         }
1148 }
1149
1150
1151
1152 /**
1153  *
1154  * Function : profile_load
1155  * @parameter App    $a
1156  * @parameter string $nickname
1157  * @parameter int    $profile
1158  *
1159  * Summary: Loads a profile into the page sidebar.
1160  * The function requires a writeable copy of the main App structure, and the nickname
1161  * of a registered local account.
1162  *
1163  * If the viewer is an authenticated remote viewer, the profile displayed is the
1164  * one that has been configured for his/her viewing in the Contact manager.
1165  * Passing a non-zero profile ID can also allow a preview of a selected profile
1166  * by the owner.
1167  *
1168  * Profile information is placed in the App structure for later retrieval.
1169  * Honours the owner's chosen theme for display.
1170  *
1171  * IMPORTANT: Should only be run in the _init() functions of a module. That ensures that
1172  * the theme is chosen before the _init() function of a theme is run, which will usually
1173  * load a lot of theme-specific content
1174  *
1175  */
1176
1177 if(! function_exists('profile_load')) {
1178         function profile_load(&$a, $nickname, $profile = 0) {
1179
1180                 $user = q("select uid from user where nickname = '%s' limit 1",
1181                         dbesc($nickname)
1182                 );
1183
1184                 if(! ($user && count($user))) {
1185                         logger('profile error: ' . $a->query_string, LOGGER_DEBUG);
1186                         notice( t('Requested account is not available.') . EOL );
1187                         $a->error = 404;
1188                         return;
1189                 }
1190
1191                 if(remote_user() && count($_SESSION['remote'])) {
1192                         foreach($_SESSION['remote'] as $visitor) {
1193                                 if($visitor['uid'] == $user[0]['uid']) {
1194                                         $r = q("SELECT `profile-id` FROM `contact` WHERE `id` = %d LIMIT 1",
1195                                                 intval($visitor['cid'])
1196                                         );
1197                                         if(count($r))
1198                                                 $profile = $r[0]['profile-id'];
1199                                         break;
1200                                 }
1201                         }
1202                 }
1203
1204                 $r = null;
1205
1206                 if($profile) {
1207                         $profile_int = intval($profile);
1208                         $r = q("SELECT `profile`.`uid` AS `profile_uid`, `profile`.* , `contact`.`avatar-date` AS picdate, `user`.* FROM `profile`
1209                                         left join `contact` on `contact`.`uid` = `profile`.`uid` LEFT JOIN `user` ON `profile`.`uid` = `user`.`uid`
1210                                         WHERE `user`.`nickname` = '%s' AND `profile`.`id` = %d and `contact`.`self` = 1 LIMIT 1",
1211                                         dbesc($nickname),
1212                                         intval($profile_int)
1213                         );
1214                 }
1215                 if((! $r) && (!  count($r))) {
1216                         $r = q("SELECT `profile`.`uid` AS `profile_uid`, `profile`.* , `contact`.`avatar-date` AS picdate, `user`.* FROM `profile`
1217                                         left join `contact` on `contact`.`uid` = `profile`.`uid` LEFT JOIN `user` ON `profile`.`uid` = `user`.`uid`
1218                                         WHERE `user`.`nickname` = '%s' AND `profile`.`is-default` = 1 and `contact`.`self` = 1 LIMIT 1",
1219                                         dbesc($nickname)
1220                         );
1221                 }
1222
1223                 if(($r === false) || (! count($r))) {
1224                         logger('profile error: ' . $a->query_string, LOGGER_DEBUG);
1225                         notice( t('Requested profile is not available.') . EOL );
1226                         $a->error = 404;
1227                         return;
1228                 }
1229
1230                 // fetch user tags if this isn't the default profile
1231
1232                 if(! $r[0]['is-default']) {
1233                         $x = q("select `pub_keywords` from `profile` where uid = %d and `is-default` = 1 limit 1",
1234                                         intval($r[0]['profile_uid'])
1235                         );
1236                         if($x && count($x))
1237                                 $r[0]['pub_keywords'] = $x[0]['pub_keywords'];
1238                 }
1239
1240                 $a->profile = $r[0];
1241
1242                 $a->profile['mobile-theme'] = get_pconfig($a->profile['profile_uid'], 'system', 'mobile_theme');
1243
1244
1245                 $a->page['title'] = $a->profile['name'] . " @ " . $a->config['sitename'];
1246                 $_SESSION['theme'] = $a->profile['theme'];
1247                 $_SESSION['mobile-theme'] = $a->profile['mobile-theme'];
1248
1249                 /**
1250                  * load/reload current theme info
1251                  */
1252
1253                 $a->set_template_engine(); // reset the template engine to the default in case the user's theme doesn't specify one
1254
1255                 $theme_info_file = "view/theme/".current_theme()."/theme.php";
1256                 if (file_exists($theme_info_file)){
1257                         require_once($theme_info_file);
1258                 }
1259
1260                 if(! (x($a->page,'aside')))
1261                         $a->page['aside'] = '';
1262
1263                 if(local_user() && local_user() == $a->profile['uid']) {
1264                         $a->page['aside'] .= replace_macros(get_markup_template('profile_edlink.tpl'),array(
1265                                 '$editprofile' => t('Edit profile'),
1266                                 '$profid' => $a->profile['id']
1267                         ));
1268                 }
1269
1270                 $block = (((get_config('system','block_public')) && (! local_user()) && (! remote_user())) ? true : false);
1271
1272                 $a->page['aside'] .= profile_sidebar($a->profile, $block);
1273
1274                 /*if(! $block)
1275                  $a->page['aside'] .= contact_block();*/
1276
1277                 return;
1278         }
1279 }
1280
1281
1282 /**
1283  *
1284  * Function: profile_sidebar
1285  *
1286  * Formats a profile for display in the sidebar.
1287  * It is very difficult to templatise the HTML completely
1288  * because of all the conditional logic.
1289  *
1290  * @parameter: array $profile
1291  *
1292  * Returns HTML string stuitable for sidebar inclusion
1293  * Exceptions: Returns empty string if passed $profile is wrong type or not populated
1294  *
1295  */
1296
1297
1298 if(! function_exists('profile_sidebar')) {
1299         function profile_sidebar($profile, $block = 0) {
1300
1301                 $a = get_app();
1302
1303                 $o = '';
1304                 $location = false;
1305                 $address = false;
1306                 $pdesc = true;
1307
1308                 if((! is_array($profile)) && (! count($profile)))
1309                         return $o;
1310
1311                 $profile['picdate'] = urlencode($profile['picdate']);
1312
1313                 call_hooks('profile_sidebar_enter', $profile);
1314
1315
1316                 // don't show connect link to yourself
1317                 $connect = (($profile['uid'] != local_user()) ? t('Connect')  : False);
1318
1319                 // don't show connect link to authenticated visitors either
1320
1321                 if(remote_user() && count($_SESSION['remote'])) {
1322                         foreach($_SESSION['remote'] as $visitor) {
1323                                 if($visitor['uid'] == $profile['uid']) {
1324                                         $connect = false;
1325                                         break;
1326                                 }
1327                         }
1328                 }
1329
1330                 if( get_my_url() && $profile['unkmail'] && ($profile['uid'] != local_user()) )
1331                         $wallmessage = t('Message');
1332                 else
1333                         $wallmessage = false;
1334
1335
1336
1337                 // show edit profile to yourself
1338                 if ($profile['uid'] == local_user() && feature_enabled(local_user(),'multi_profiles')) {
1339                         $profile['edit'] = array($a->get_baseurl(). '/profiles', t('Profiles'),"", t('Manage/edit profiles'));
1340
1341                         $r = q("SELECT * FROM `profile` WHERE `uid` = %d",
1342                                         local_user());
1343
1344                         $profile['menu'] = array(
1345                                 'chg_photo' => t('Change profile photo'),
1346                                 'cr_new' => t('Create New Profile'),
1347                                 'entries' => array(),
1348                         );
1349
1350                         if(count($r)) {
1351
1352                                 foreach($r as $rr) {
1353                                         $profile['menu']['entries'][] = array(
1354                                                 'photo' => $rr['thumb'],
1355                                                 'id' => $rr['id'],
1356                                                 'alt' => t('Profile Image'),
1357                                                 'profile_name' => $rr['profile-name'],
1358                                                 'isdefault' => $rr['is-default'],
1359                                                 'visibile_to_everybody' =>  t('visible to everybody'),
1360                                                 'edit_visibility' => t('Edit visibility'),
1361
1362                                         );
1363                                 }
1364
1365
1366                         }
1367                 }
1368         if ($profile['uid'] == local_user() && !feature_enabled(local_user(),'multi_profiles')) {
1369             $profile['edit'] = array($a->get_baseurl(). '/profiles/'.$profile['id'], t('Edit profile'),"", t('Edit profile'));
1370                 $profile['menu'] = array(
1371                                 'chg_photo' => t('Change profile photo'),
1372                                 'cr_new' => null,
1373                                 'entries' => array(),
1374                         );
1375         }
1376
1377
1378
1379
1380                 if((x($profile,'address') == 1)
1381                                 || (x($profile,'locality') == 1)
1382                                 || (x($profile,'region') == 1)
1383                                 || (x($profile,'postal-code') == 1)
1384                                 || (x($profile,'country-name') == 1))
1385                         $location = t('Location:');
1386
1387                 $gender = ((x($profile,'gender') == 1) ? t('Gender:') : False);
1388
1389
1390                 $marital = ((x($profile,'marital') == 1) ?  t('Status:') : False);
1391
1392                 $homepage = ((x($profile,'homepage') == 1) ?  t('Homepage:') : False);
1393
1394                 if(($profile['hidewall'] || $block) && (! local_user()) && (! remote_user())) {
1395                         $location = $pdesc = $gender = $marital = $homepage = False;
1396                 }
1397
1398                 $firstname = ((strpos($profile['name'],' '))
1399                                 ? trim(substr($profile['name'],0,strpos($profile['name'],' '))) : $profile['name']);
1400                 $lastname = (($firstname === $profile['name']) ? '' : trim(substr($profile['name'],strlen($firstname))));
1401
1402                 $diaspora = array(
1403                         'podloc' => $a->get_baseurl(),
1404                         'searchable' => (($profile['publish'] && $profile['net-publish']) ? 'true' : 'false' ),
1405                         'nickname' => $profile['nickname'],
1406                         'fullname' => $profile['name'],
1407                         'firstname' => $firstname,
1408                         'lastname' => $lastname,
1409                         'photo300' => $a->get_cached_avatar_image($a->get_baseurl() . '/photo/custom/300/' . $profile['uid'] . '.jpg'),
1410                         'photo100' => $a->get_cached_avatar_image($a->get_baseurl() . '/photo/custom/100/' . $profile['uid'] . '.jpg'),
1411                         'photo50' => $a->get_cached_avatar_image($a->get_baseurl() . '/photo/custom/50/'  . $profile['uid'] . '.jpg'),
1412                 );
1413
1414                 if (!$block){
1415                         $contact_block = contact_block();
1416                 }
1417
1418
1419                 $p = array();
1420                 foreach($profile as $k => $v) {
1421                         $k = str_replace('-','_',$k);
1422                         $p[$k] = $v;
1423                 }
1424
1425                 if($a->theme['template_engine'] === 'internal')
1426                         $location = template_escape($location);
1427
1428
1429                 $tpl = get_markup_template('profile_vcard.tpl');
1430                 $o .= replace_macros($tpl, array(
1431                         '$profile' => $p,
1432                         '$connect'  => $connect,
1433                         '$wallmessage' => $wallmessage,
1434                         '$location' => $location,
1435                         '$gender'   => $gender,
1436                         '$pdesc'        => $pdesc,
1437                         '$marital'  => $marital,
1438                         '$homepage' => $homepage,
1439                         '$diaspora' => $diaspora,
1440                         '$contact_block' => $contact_block,
1441                 ));
1442
1443
1444                 $arr = array('profile' => &$profile, 'entry' => &$o);
1445
1446                 call_hooks('profile_sidebar', $arr);
1447
1448                 return $o;
1449         }
1450 }
1451
1452
1453 if(! function_exists('get_birthdays')) {
1454         function get_birthdays() {
1455
1456                 $a = get_app();
1457                 $o = '';
1458
1459                 if(! local_user() || $a->is_mobile || $a->is_tablet)
1460                         return $o;
1461
1462 //              $mobile_detect = new Mobile_Detect();
1463 //              $is_mobile = $mobile_detect->isMobile() || $mobile_detect->isTablet();
1464
1465 //              if($is_mobile)
1466 //                      return $o;
1467
1468                 $bd_format = t('g A l F d') ; // 8 AM Friday January 18
1469                 $bd_short = t('F d');
1470
1471                 $r = q("SELECT `event`.*, `event`.`id` AS `eid`, `contact`.* FROM `event`
1472                                 LEFT JOIN `contact` ON `contact`.`id` = `event`.`cid`
1473                                 WHERE `event`.`uid` = %d AND `type` = 'birthday' AND `start` < '%s' AND `finish` > '%s'
1474                                 ORDER BY `start` ASC ",
1475                                 intval(local_user()),
1476                                 dbesc(datetime_convert('UTC','UTC','now + 6 days')),
1477                                 dbesc(datetime_convert('UTC','UTC','now'))
1478                 );
1479
1480                 if($r && count($r)) {
1481                         $total = 0;
1482                         $now = strtotime('now');
1483                         $cids = array();
1484
1485                         $istoday = false;
1486                         foreach($r as $rr) {
1487                                 if(strlen($rr['name']))
1488                                         $total ++;
1489                                 if((strtotime($rr['start'] . ' +00:00') < $now) && (strtotime($rr['finish'] . ' +00:00') > $now))
1490                                         $istoday = true;
1491                         }
1492                         $classtoday = $istoday ? ' birthday-today ' : '';
1493                         if($total) {
1494                                 foreach($r as &$rr) {
1495                                         if(! strlen($rr['name']))
1496                                                 continue;
1497
1498                                         // avoid duplicates
1499
1500                                         if(in_array($rr['cid'],$cids))
1501                                                 continue;
1502                                         $cids[] = $rr['cid'];
1503
1504                                         $today = (((strtotime($rr['start'] . ' +00:00') < $now) && (strtotime($rr['finish'] . ' +00:00') > $now)) ? true : false);
1505                                         $sparkle = '';
1506                                         $url = $rr['url'];
1507                                         if($rr['network'] === NETWORK_DFRN) {
1508                                                 $sparkle = " sparkle";
1509                                                 $url = $a->get_baseurl() . '/redir/'  . $rr['cid'];
1510                                         }
1511
1512                                         $rr['link'] = $url;
1513                                         $rr['title'] = $rr['name'];
1514                                         $rr['date'] = day_translate(datetime_convert('UTC', $a->timezone, $rr['start'], $rr['adjust'] ? $bd_format : $bd_short)) . (($today) ?  ' ' . t('[today]') : '');
1515                                         $rr['startime'] = Null;
1516                                         $rr['today'] = $today;
1517
1518                                 }
1519                         }
1520                 }
1521                 $tpl = get_markup_template("birthdays_reminder.tpl");
1522                 return replace_macros($tpl, array(
1523                         '$baseurl' => $a->get_baseurl(),
1524                         '$classtoday' => $classtoday,
1525                         '$count' => $total,
1526                         '$event_reminders' => t('Birthday Reminders'),
1527                         '$event_title' => t('Birthdays this week:'),
1528                         '$events' => $r,
1529                         '$lbr' => '{',  // raw brackets mess up if/endif macro processing
1530                         '$rbr' => '}'
1531
1532                 ));
1533         }
1534 }
1535
1536
1537 if(! function_exists('get_events')) {
1538         function get_events() {
1539
1540                 require_once('include/bbcode.php');
1541
1542                 $a = get_app();
1543
1544                 if(! local_user() || $a->is_mobile || $a->is_tablet)
1545                         return $o;
1546
1547
1548 //              $mobile_detect = new Mobile_Detect();
1549 //              $is_mobile = $mobile_detect->isMobile() || $mobile_detect->isTablet();
1550
1551 //              if($is_mobile)
1552 //                      return $o;
1553
1554                 $bd_format = t('g A l F d') ; // 8 AM Friday January 18
1555                 $bd_short = t('F d');
1556
1557                 $r = q("SELECT `event`.* FROM `event`
1558                                 WHERE `event`.`uid` = %d AND `type` != 'birthday' AND `start` < '%s' AND `start` > '%s'
1559                                 ORDER BY `start` ASC ",
1560                                 intval(local_user()),
1561                                 dbesc(datetime_convert('UTC','UTC','now + 6 days')),
1562                                 dbesc(datetime_convert('UTC','UTC','now - 1 days'))
1563                 );
1564
1565                 if($r && count($r)) {
1566                         $now = strtotime('now');
1567                         $istoday = false;
1568                         foreach($r as $rr) {
1569                                 if(strlen($rr['name']))
1570                                         $total ++;
1571
1572                                 $strt = datetime_convert('UTC',$rr['convert'] ? $a->timezone : 'UTC',$rr['start'],'Y-m-d');
1573                                 if($strt === datetime_convert('UTC',$a->timezone,'now','Y-m-d'))
1574                                         $istoday = true;
1575                         }
1576                         $classtoday = (($istoday) ? 'event-today' : '');
1577
1578
1579                         foreach($r as &$rr) {
1580                                 if($rr['adjust'])
1581                                         $md = datetime_convert('UTC',$a->timezone,$rr['start'],'Y/m');
1582                                 else
1583                                         $md = datetime_convert('UTC','UTC',$rr['start'],'Y/m');
1584                                 $md .= "/#link-".$rr['id'];
1585
1586                                 $title = substr(strip_tags(bbcode($rr['desc'])),0,32) . '... ';
1587                                 if(! $title)
1588                                         $title = t('[No description]');
1589
1590                                 $strt = datetime_convert('UTC',$rr['convert'] ? $a->timezone : 'UTC',$rr['start']);
1591                                 $today = ((substr($strt,0,10) === datetime_convert('UTC',$a->timezone,'now','Y-m-d')) ? true : false);
1592
1593                                 $rr['link'] = $md;
1594                                 $rr['title'] = $title;
1595                                 $rr['date'] = day_translate(datetime_convert('UTC', $rr['adjust'] ? $a->timezone : 'UTC', $rr['start'], $bd_format)) . (($today) ?  ' ' . t('[today]') : '');
1596                                 $rr['startime'] = $strt;
1597                                 $rr['today'] = $today;
1598                         }
1599                 }
1600
1601                 $tpl = get_markup_template("events_reminder.tpl");
1602                 return replace_macros($tpl, array(
1603                         '$baseurl' => $a->get_baseurl(),
1604                         '$classtoday' => $classtoday,
1605                         '$count' => count($r),
1606                         '$event_reminders' => t('Event Reminders'),
1607                         '$event_title' => t('Events this week:'),
1608                         '$events' => $r,
1609                 ));
1610         }
1611 }
1612
1613
1614 /**
1615  *
1616  * Wrap calls to proc_close(proc_open()) and call hook
1617  * so plugins can take part in process :)
1618  *
1619  * args:
1620  * $cmd program to run
1621  *  next args are passed as $cmd command line
1622  *
1623  * e.g.: proc_run("ls","-la","/tmp");
1624  *
1625  * $cmd and string args are surrounded with ""
1626  */
1627
1628 if(! function_exists('proc_run')) {
1629         function proc_run($cmd){
1630
1631                 $a = get_app();
1632
1633                 $args = func_get_args();
1634
1635                 $newargs = array();
1636                 if(! count($args))
1637                         return;
1638
1639                 // expand any arrays
1640
1641                 foreach($args as $arg) {
1642                         if(is_array($arg)) {
1643                                 foreach($arg as $n) {
1644                                         $newargs[] = $n;
1645                                 }
1646                         }
1647                         else
1648                                 $newargs[] = $arg;
1649                 }
1650
1651                 $args = $newargs;
1652
1653                 $arr = array('args' => $args, 'run_cmd' => true);
1654
1655                 call_hooks("proc_run", $arr);
1656                 if(! $arr['run_cmd'])
1657                         return;
1658
1659                 if(count($args) && $args[0] === 'php')
1660                         $args[0] = ((x($a->config,'php_path')) && (strlen($a->config['php_path'])) ? $a->config['php_path'] : 'php');
1661
1662         // add baseurl to args. cli scripts can't construct it
1663         $args[] = $a->get_baseurl();
1664
1665         for($x = 0; $x < count($args); $x ++)
1666                         $args[$x] = escapeshellarg($args[$x]);
1667
1668
1669
1670                 $cmdline = implode($args," ");
1671                 if(get_config('system','proc_windows'))
1672                         proc_close(proc_open('cmd /c start /b ' . $cmdline,array(),$foo,dirname(__FILE__)));
1673                 else
1674                         proc_close(proc_open($cmdline." &",array(),$foo,dirname(__FILE__)));
1675         }
1676 }
1677
1678 if(! function_exists('current_theme')) {
1679         function current_theme(){
1680                 $app_base_themes = array('duepuntozero', 'dispy', 'quattro');
1681
1682                 $a = get_app();
1683
1684 //              $mobile_detect = new Mobile_Detect();
1685 //              $is_mobile = $mobile_detect->isMobile() || $mobile_detect->isTablet();
1686                 $is_mobile = $a->is_mobile || $a->is_tablet;
1687
1688                 if($is_mobile) {
1689                         if(isset($_SESSION['show-mobile']) && !$_SESSION['show-mobile']) {
1690                                 $system_theme = '';
1691                                 $theme_name = '';
1692                         }
1693                         else {
1694                                 $system_theme = ((isset($a->config['system']['mobile-theme'])) ? $a->config['system']['mobile-theme'] : '');
1695                                 $theme_name = ((isset($_SESSION) && x($_SESSION,'mobile-theme')) ? $_SESSION['mobile-theme'] : $system_theme);
1696
1697                                 if($theme_name === '---') {
1698                                         // user has selected to have the mobile theme be the same as the normal one
1699                                         $system_theme = '';
1700                                         $theme_name = '';
1701                                 }
1702                         }
1703                 }
1704                 if(!$is_mobile || ($system_theme === '' && $theme_name === '')) {
1705                         $system_theme = ((isset($a->config['system']['theme'])) ? $a->config['system']['theme'] : '');
1706                         $theme_name = ((isset($_SESSION) && x($_SESSION,'theme')) ? $_SESSION['theme'] : $system_theme);
1707                 }
1708
1709                 if($theme_name &&
1710                                 (file_exists('view/theme/' . $theme_name . '/style.css') ||
1711                                                 file_exists('view/theme/' . $theme_name . '/style.php')))
1712                         return($theme_name);
1713
1714                 foreach($app_base_themes as $t) {
1715                         if(file_exists('view/theme/' . $t . '/style.css')||
1716                                         file_exists('view/theme/' . $t . '/style.php'))
1717                                 return($t);
1718                 }
1719
1720                 $fallback = array_merge(glob('view/theme/*/style.css'),glob('view/theme/*/style.php'));
1721                 if(count($fallback))
1722                         return (str_replace('view/theme/','', substr($fallback[0],0,-10)));
1723
1724         }
1725 }
1726
1727 /*
1728  * Return full URL to theme which is currently in effect.
1729 * Provide a sane default if nothing is chosen or the specified theme does not exist.
1730 */
1731 if(! function_exists('current_theme_url')) {
1732         function current_theme_url() {
1733                 global $a;
1734                 $t = current_theme();
1735                 if (file_exists('view/theme/' . $t . '/style.php'))
1736                         return($a->get_baseurl() . '/view/theme/' . $t . '/style.pcss');
1737                 return($a->get_baseurl() . '/view/theme/' . $t . '/style.css');
1738         }
1739 }
1740
1741 if(! function_exists('feed_birthday')) {
1742         function feed_birthday($uid,$tz) {
1743
1744                 /**
1745                  *
1746                  * Determine the next birthday, but only if the birthday is published
1747                  * in the default profile. We _could_ also look for a private profile that the
1748                  * recipient can see, but somebody could get mad at us if they start getting
1749                  * public birthday greetings when they haven't made this info public.
1750                  *
1751                  * Assuming we are able to publish this info, we are then going to convert
1752                  * the start time from the owner's timezone to UTC.
1753                  *
1754                  * This will potentially solve the problem found with some social networks
1755                  * where birthdays are converted to the viewer's timezone and salutations from
1756                  * elsewhere in the world show up on the wrong day. We will convert it to the
1757                  * viewer's timezone also, but first we are going to convert it from the birthday
1758                  * person's timezone to GMT - so the viewer may find the birthday starting at
1759                  * 6:00PM the day before, but that will correspond to midnight to the birthday person.
1760                  *
1761                  */
1762
1763
1764                 $birthday = '';
1765
1766                 if(! strlen($tz))
1767                         $tz = 'UTC';
1768
1769                 $p = q("SELECT `dob` FROM `profile` WHERE `is-default` = 1 AND `uid` = %d LIMIT 1",
1770                                 intval($uid)
1771                 );
1772
1773                 if($p && count($p)) {
1774                         $tmp_dob = substr($p[0]['dob'],5);
1775                         if(intval($tmp_dob)) {
1776                                 $y = datetime_convert($tz,$tz,'now','Y');
1777                                 $bd = $y . '-' . $tmp_dob . ' 00:00';
1778                                 $t_dob = strtotime($bd);
1779                                 $now = strtotime(datetime_convert($tz,$tz,'now'));
1780                                 if($t_dob < $now)
1781                                         $bd = $y + 1 . '-' . $tmp_dob . ' 00:00';
1782                                 $birthday = datetime_convert($tz,'UTC',$bd,ATOM_TIME);
1783                         }
1784                 }
1785
1786                 return $birthday;
1787         }
1788 }
1789
1790 if(! function_exists('is_site_admin')) {
1791         function is_site_admin() {
1792                 $a = get_app();
1793                 if(local_user() && x($a->user,'email') && x($a->config,'admin_email') && ($a->user['email'] === $a->config['admin_email']))
1794                         return true;
1795                 return false;
1796         }
1797 }
1798
1799
1800 if(! function_exists('load_contact_links')) {
1801         function load_contact_links($uid) {
1802
1803                 $a = get_app();
1804
1805                 $ret = array();
1806
1807                 if(! $uid || x($a->contacts,'empty'))
1808                         return;
1809
1810                 $r = q("SELECT `id`,`network`,`url`,`thumb` FROM `contact` WHERE `uid` = %d AND `self` = 0 AND `blocked` = 0 ",
1811                                 intval($uid)
1812                 );
1813                 if(count($r)) {
1814                         foreach($r as $rr){
1815                                 $url = normalise_link($rr['url']);
1816                                 $ret[$url] = $rr;
1817                         }
1818                 }
1819                 else
1820                         $ret['empty'] = true;
1821                 $a->contacts = $ret;
1822                 return;
1823         }
1824 }
1825
1826 if(! function_exists('profile_tabs')){
1827         function profile_tabs($a, $is_owner=False, $nickname=Null){
1828                 //echo "<pre>"; var_dump($a->user); killme();
1829
1830                 if (is_null($nickname))
1831                         $nickname  = $a->user['nickname'];
1832
1833                 if(x($_GET,'tab'))
1834                         $tab = notags(trim($_GET['tab']));
1835
1836                 $url = $a->get_baseurl() . '/profile/' . $nickname;
1837
1838                 $tabs = array(
1839                         array(
1840                                 'label'=>t('Status'),
1841                                 'url' => $url,
1842                                 'sel' => ((!isset($tab)&&$a->argv[0]=='profile')?'active':''),
1843                                 'title' => t('Status Messages and Posts'),
1844                                 'id' => 'status-tab',
1845                         ),
1846                         array(
1847                                 'label' => t('Profile'),
1848                                 'url'   => $url.'/?tab=profile',
1849                                 'sel'   => ((isset($tab) && $tab=='profile')?'active':''),
1850                                 'title' => t('Profile Details'),
1851                                 'id' => 'profile-tab',
1852                         ),
1853                         array(
1854                                 'label' => t('Photos'),
1855                                 'url'   => $a->get_baseurl() . '/photos/' . $nickname,
1856                                 'sel'   => ((!isset($tab)&&$a->argv[0]=='photos')?'active':''),
1857                                 'title' => t('Photo Albums'),
1858                                 'id' => 'photo-tab',
1859                         ),
1860                 );
1861
1862                 if ($is_owner){
1863                         $tabs[] = array(
1864                                 'label' => t('Events'),
1865                                 'url'   => $a->get_baseurl() . '/events',
1866                                 'sel'   =>((!isset($tab)&&$a->argv[0]=='events')?'active':''),
1867                                 'title' => t('Events and Calendar'),
1868                                 'id' => 'events-tab',
1869                         );
1870                         $tabs[] = array(
1871                                 'label' => t('Personal Notes'),
1872                                 'url'   => $a->get_baseurl() . '/notes',
1873                                 'sel'   =>((!isset($tab)&&$a->argv[0]=='notes')?'active':''),
1874                                 'title' => t('Only You Can See This'),
1875                                 'id' => 'notes-tab',
1876                         );
1877                 }
1878
1879
1880                 $arr = array('is_owner' => $is_owner, 'nickname' => $nickname, 'tab' => (($tab) ? $tab : false), 'tabs' => $tabs);
1881                 call_hooks('profile_tabs', $arr);
1882
1883                 $tpl = get_markup_template('common_tabs.tpl');
1884
1885                 return replace_macros($tpl,array('$tabs' => $arr['tabs']));
1886         }
1887 }
1888
1889 function get_my_url() {
1890         if(x($_SESSION,'my_url'))
1891                 return $_SESSION['my_url'];
1892         return false;
1893 }
1894
1895 function zrl_init(&$a) {
1896         $tmp_str = get_my_url();
1897         if(validate_url($tmp_str)) {
1898                 proc_run('php','include/gprobe.php',bin2hex($tmp_str));
1899                 $arr = array('zrl' => $tmp_str, 'url' => $a->cmd);
1900                 call_hooks('zrl_init',$arr);
1901         }
1902 }
1903
1904 function zrl($s,$force = false) {
1905         if(! strlen($s))
1906                 return $s;
1907         if((! strpos($s,'/profile/')) && (! $force))
1908                 return $s;
1909         if($force && substr($s,-1,1) !== '/')
1910                 $s = $s . '/';
1911         $achar = strpos($s,'?') ? '&' : '?';
1912         $mine = get_my_url();
1913         if($mine and ! link_compare($mine,$s))
1914                 return $s . $achar . 'zrl=' . urlencode($mine);
1915         return $s;
1916 }
1917
1918 /**
1919 * returns querystring as string from a mapped array
1920 *
1921 * @param params Array
1922 * @return string
1923 */
1924 function build_querystring($params, $name=null) {
1925     $ret = "";
1926     foreach($params as $key=>$val) {
1927         if(is_array($val)) {
1928             if($name==null) {
1929                 $ret .= build_querystring($val, $key);
1930             } else {
1931                 $ret .= build_querystring($val, $name."[$key]");
1932             }
1933         } else {
1934             $val = urlencode($val);
1935             if($name!=null) {
1936                 $ret.=$name."[$key]"."=$val&";
1937             } else {
1938                 $ret.= "$key=$val&";
1939             }
1940         }
1941     }
1942     return $ret;
1943 }
1944
1945 function explode_querystring($query) {
1946         $arg_st = strpos($query, '?');
1947         if($arg_st !== false) {
1948                 $base = substr($query, 0, $arg_st);
1949                 $arg_st += 1;
1950         }
1951         else {
1952                 $base = '';
1953                 $arg_st = 0;
1954         }
1955
1956         $args = explode('&', substr($query, $arg_st));
1957         foreach($args as $k=>$arg) {
1958                 if($arg === '')
1959                         unset($args[$k]);
1960         }
1961         $args = array_values($args);
1962
1963         if(!$base) {
1964                 $base = $args[0];
1965                 unset($args[0]);
1966                 $args = array_values($args);
1967         }
1968
1969         return array(
1970                 'base' => $base,
1971                 'args' => $args,
1972         );
1973 }
1974
1975 /**
1976 * Returns the complete URL of the current page, e.g.: http(s)://something.com/network
1977 *
1978 * Taken from http://webcheatsheet.com/php/get_current_page_url.php
1979 */
1980 function curPageURL() {
1981         $pageURL = 'http';
1982         if ($_SERVER["HTTPS"] == "on") {$pageURL .= "s";}
1983         $pageURL .= "://";
1984         if ($_SERVER["SERVER_PORT"] != "80" && $_SERVER["SERVER_PORT"] != "443") {
1985                 $pageURL .= $_SERVER["SERVER_NAME"].":".$_SERVER["SERVER_PORT"].$_SERVER["REQUEST_URI"];
1986         } else {
1987                 $pageURL .= $_SERVER["SERVER_NAME"].$_SERVER["REQUEST_URI"];
1988         }
1989         return $pageURL;
1990 }
1991
1992 function random_digits($digits) {
1993         $rn = '';
1994         for($i = 0; $i < $digits; $i++) {
1995                 $rn .= rand(0,9);
1996         }
1997         return $rn;
1998 }
1999
2000 function get_cachefile($file, $writemode = true) {
2001         $cache = get_config("system","itemcache");
2002
2003         if ($cache == "")
2004                 return("");
2005
2006         if (!is_dir($cache))
2007                 return("");
2008
2009         $subfolder = $cache."/".substr($file, 0, 2);
2010
2011         $cachepath = $subfolder."/".$file;
2012
2013         if ($writemode) {
2014                 if (!is_dir($subfolder)) {
2015                         mkdir($subfolder);
2016                         chmod($subfolder, 0777);
2017                 }
2018         }
2019
2020         return($cachepath);
2021 }
2022
2023 function clear_cache($basepath = "", $path = "") {
2024         if ($path == "") {
2025                 $basepath = get_config('system','itemcache');
2026                 $path = $basepath;
2027         }
2028
2029         if (($path == "") OR (!is_dir($path)))
2030                 return;
2031
2032         if (substr(realpath($path), 0, strlen($basepath)) != $basepath)
2033                 return;
2034
2035         $cachetime = (int)get_config('system','itemcache_duration');
2036         if ($cachetime == 0)
2037                 $cachetime = 86400;
2038
2039         if ($dh = opendir($path)) {
2040                 while (($file = readdir($dh)) !== false) {
2041                         $fullpath = $path."/".$file;
2042                         if ((filetype($fullpath) == "dir") and ($file != ".") and ($file != ".."))
2043                                 clear_cache($basepath, $fullpath);
2044                         if ((filetype($fullpath) == "file") and (filectime($fullpath) < (time() - $cachetime)))
2045                                 unlink($fullpath);
2046                 }
2047                 closedir($dh);
2048         }
2049 }
2050
2051 function set_template_engine(&$a, $engine = 'internal') {
2052 // This function is no longer necessary, but keep it as a wrapper to the class method
2053 // to avoid breaking themes again unnecessarily
2054
2055         $a->set_template_engine($engine);
2056 }
2057