1: <?php
   2: /**
   3:  * Defines the general CONTENIDO functions
   4:  *
   5:  * @package Core
   6:  * @subpackage Backend
   7:  * @version SVN Revision $Rev:$
   8:  *
   9:  * @author Jan Lengowski
  10:  * @copyright four for business AG <www.4fb.de>
  11:  * @license http://www.contenido.org/license/LIZENZ.txt
  12:  * @link http://www.4fb.de
  13:  * @link http://www.contenido.org
  14:  */
  15: 
  16: defined('CON_FRAMEWORK') || die('Illegal call: Missing framework initialization - request aborted.');
  17: 
  18: cInclude('includes', 'functions.file.php');
  19: 
  20: /**
  21:  * Extracts the available content-types from the database
  22:  *
  23:  * Creates an array $a_content[type][number] = content string
  24:  * f.e. $a_content['CMS_HTML'][1] = content string
  25:  * Same for array $a_description
  26:  *
  27:  * @param int $idartlang Language specific ID of the arcticle
  28:  */
  29: function getAvailableContentTypes($idartlang) {
  30:     global $db, $cfg, $a_content, $a_description;
  31: 
  32:     $sql = "SELECT
  33:                 *
  34:             FROM
  35:                 " . $cfg["tab"]["content"] . " AS a,
  36:                 " . $cfg["tab"]["art_lang"] . " AS b,
  37:                 " . $cfg["tab"]["type"] . " AS c
  38:             WHERE
  39:                 a.idtype    = c.idtype AND
  40:                 a.idartlang = b.idartlang AND
  41:                 b.idartlang = " . (int) $idartlang;
  42: 
  43:     $db->query($sql);
  44: 
  45:     while ($db->nextRecord()) {
  46:         $a_content[$db->f('type')][$db->f('typeid')] = $db->f('value');
  47:         $a_description[$db->f('type')][$db->f('typeid')] = i18n($db->f('description'));
  48:     }
  49: }
  50: 
  51: /**
  52:  * Checks if an article is assigned to multiple categories
  53:  *
  54:  * @param int $idart Article-Id
  55:  * @return bool Article assigned to multiple categories
  56:  */
  57: function isArtInMultipleUse($idart) {
  58:     global $cfg;
  59: 
  60:     $db = cRegistry::getDb();
  61:     $sql = "SELECT idart FROM " . $cfg["tab"]["cat_art"] . " WHERE idart = " . (int) $idart;
  62:     $db->query($sql);
  63: 
  64:     return ($db->affectedRows() > 1);
  65: }
  66: 
  67: /**
  68:  * Checks if a value is alphanumeric
  69:  *
  70:  * @param mixed $test Value to test
  71:  * @param bool $umlauts [Use german Umlaute] Optional
  72:  * @return bool Value is alphanumeric
  73:  */
  74: function isAlphanumeric($test, $umlauts = true) {
  75:     if ($umlauts == true) {
  76:         $match = "/^[a-z0-9ÄäÖöÜüß ]+$/i";
  77:     } else {
  78:         $match = "/^[a-z0-9 ]+$/i";
  79:     }
  80: 
  81:     return (preg_match($match, $test));
  82: }
  83: 
  84: /**
  85:  * Returns whether a string is UTF-8 encoded or not
  86:  *
  87:  * @param string $input
  88:  * @return bool
  89:  */
  90: function isUtf8($input) {
  91:     $len = strlen($input);
  92: 
  93:     for ($i = 0; $i < $len; $i++) {
  94:         $char = ord($input[$i]);
  95:         $n = 0;
  96: 
  97:         if ($char < 0x80) { // ASCII char
  98:             continue;
  99:         } else if (($char & 0xE0) === 0xC0 && $char > 0xC1) { // 2 byte long
 100:             // char
 101:             $n = 1;
 102:         } else if (($char & 0xF0) === 0xE0) { // 3 byte long char
 103:             $n = 2;
 104:         } else if (($char & 0xF8) === 0xF0 && $char < 0xF5) { // 4 byte long
 105:             // char
 106:             $n = 3;
 107:         } else {
 108:             return false;
 109:         }
 110: 
 111:         for ($j = 0; $j < $n; $j++) {
 112:             $i++;
 113: 
 114:             if ($i == $len || (ord($input[$i]) & 0xC0) !== 0x80) {
 115:                 return false;
 116:             }
 117:         }
 118:     }
 119:     return true;
 120: }
 121: 
 122: /**
 123:  * Returns multi-language month name (canonical) by its numeric value
 124:  *
 125:  * @param int $month
 126:  * @return string
 127:  */
 128: function getCanonicalMonth($month) {
 129:     switch ($month) {
 130:         case 1:
 131:             return (i18n("January"));
 132:             break;
 133:         case 2:
 134:             return (i18n("February"));
 135:             break;
 136:         case 3:
 137:             return (i18n("March"));
 138:             break;
 139:         case 4:
 140:             return (i18n("April"));
 141:             break;
 142:         case 5:
 143:             return (i18n("May"));
 144:             break;
 145:         case 6:
 146:             return (i18n("June"));
 147:             break;
 148:         case 7:
 149:             return (i18n("July"));
 150:             break;
 151:         case 8:
 152:             return (i18n("August"));
 153:             break;
 154:         case 9:
 155:             return (i18n("September"));
 156:             break;
 157:         case 10:
 158:             return (i18n("October"));
 159:             break;
 160:         case 11:
 161:             return (i18n("November"));
 162:             break;
 163:         case 12:
 164:             return (i18n("December"));
 165:             break;
 166:     }
 167: }
 168: 
 169: /**
 170:  * Get multi-language day
 171:  *
 172:  * @param int $iDay The day number of date(w)
 173:  * @return string Dayname of current language
 174:  */
 175: function getCanonicalDay($iDay) {
 176:     switch ($iDay) {
 177:         case 1:
 178:             return (i18n("Monday"));
 179:             break;
 180:         case 2:
 181:             return (i18n("Tuesday"));
 182:             break;
 183:         case 3:
 184:             return (i18n("Wednesday"));
 185:             break;
 186:         case 4:
 187:             return (i18n("Thursday"));
 188:             break;
 189:         case 5:
 190:             return (i18n("Friday"));
 191:             break;
 192:         case 6:
 193:             return (i18n("Saturday"));
 194:             break;
 195:         case 0:
 196:             return (i18n("Sunday"));
 197:             break;
 198:         default:
 199:             break;
 200:     }
 201: }
 202: 
 203: /**
 204:  * Returns a formatted date and/or timestring according to the current settings
 205:  *
 206:  * @param mixed $timestamp a timestamp. If no value is given the current time
 207:  *        will be used.
 208:  * @param bool $date if true the date will be included in the string
 209:  * @param bool $time if true the time will be included in the string
 210:  * @return string the formatted time string.
 211:  */
 212: function displayDatetime($timestamp = "", $date = false, $time = false) {
 213:     if ($timestamp == "") {
 214:         $timestamp = time();
 215:     } else {
 216:         $timestamp = strtotime($timestamp);
 217:     }
 218: 
 219:     $ret = "";
 220: 
 221:     if ($date && !$time) {
 222:         $ret = date(getEffectiveSetting("dateformat", "date", "Y-m-d"), $timestamp);
 223:     } else if ($time && !$date) {
 224:         $ret = date(getEffectiveSetting("dateformat", "time", "H:i:s"), $timestamp);
 225:     } else {
 226:         $ret = date(getEffectiveSetting("dateformat", "full", "Y-m-d H:i:s"), $timestamp);
 227:     }
 228:     return $ret;
 229: }
 230: 
 231: /**
 232:  * Returns the id of passed area
 233:  *
 234:  * @param int|string $area Area name or id
 235:  * @return int string
 236:  */
 237: function getIDForArea($area) {
 238:     if (!is_numeric($area)) {
 239:         $oArea = new cApiArea();
 240:         if ($oArea->loadBy('name', $area)) {
 241:             $area = $oArea->get('idarea');
 242:         }
 243:     }
 244: 
 245:     return $area;
 246: }
 247: 
 248: /**
 249:  * Returns the parent id of passed area
 250:  *
 251:  * @param mixed $area
 252:  * @return int
 253:  */
 254: function getParentAreaId($area) {
 255:     $oAreaColl = new cApiAreaCollection();
 256:     return $oAreaColl->getParentAreaID($area);
 257: }
 258: 
 259: /**
 260:  * Write JavaScript to mark submenu item.
 261:  *
 262:  * @param int $menuitem  Which menuitem to mark
 263:  * @param bool $return Return or echo script
 264:  */
 265: function markSubMenuItem($menuitem, $return = false) {
 266:     global $changeview;
 267: 
 268:     if (!isset($changeview) || 'prev' !== $changeview) {
 269:         // CONTENIDO backend but not in preview mode
 270:         $str = <<<JS
 271: <script type="text/javascript">
 272: Con.markSubmenuItem('c_{$menuitem}');
 273: </script>
 274: JS;
 275:     } else {
 276:         // CONTENIDO backend and article preview mode. We don't have the JavaScript object Con here!
 277:         $str = <<<JS
 278: <script type="text/javascript">
 279: (function(id) {
 280:     var menuItem;
 281:     try {
 282:         // Check if we are in a dual-frame or a quad-frame
 283:         if (parent.parent.frames[0].name == 'header') {
 284:             if (parent.frames.right_top.document.getElementById(id)) {
 285:                 menuItem = parent.frames.right_top.document.getElementById(id).getElementsByTagName('a')[0];
 286:                 parent.frames.right_top.Con.Subnav.clicked(menuItem);
 287:             }
 288:         } else {
 289:             // Check if submenuItem is existing and mark it
 290:             if (parent.parent.frames.right.frames.right_top.document.getElementById(id)) {
 291:                 menuItem = parent.parent.frames.right.frames.right_top.document.getElementById(id).getElementsByTagName('a')[0];
 292:                 parent.parent.frames.right.frames.right_top.Con.Subnav.clicked(menuItem);
 293:             }
 294:         }
 295:     } catch (e) {}
 296: })('c_{$menuitem}');
 297: </script>
 298: JS;
 299:     }
 300: 
 301:     if ($return) {
 302:         return $str;
 303:     } else {
 304:         echo $str;
 305:     }
 306: }
 307: 
 308: /**
 309:  * Creates a inline script wrapped with a self executing function
 310:  *
 311:  * @param int $menuitem Which menuitem to mark
 312:  * @param bool $return Return or echo script
 313:  */
 314: function conMakeInlineScript($content) {
 315:     $script = <<<JS
 316: <script type="text/javascript">
 317: (function(Con, $) {
 318: {$content}
 319: })(Con, Con.$);
 320: </script>
 321: JS;
 322:     return $script;
 323: }
 324: 
 325: /**
 326:  * Redirect to main area
 327:  *
 328:  * @param bool $send Redirect Yes/No
 329:  */
 330: function backToMainArea($send) {
 331:     if ($send) {
 332:         // Global vars
 333:         global $area, $sess, $idart, $idcat, $idartlang, $idcatart, $frame;
 334: 
 335:         // Get main area
 336:         $oAreaColl = new cApiAreaCollection();
 337:         $parent = $oAreaColl->getParentAreaID($area);
 338: 
 339:         // Create url string
 340:         $url_str = 'main.php?' . 'area=' . $parent . '&' . 'idcat=' . $idcat . '&' . 'idart=' . $idart . '&' . 'idartlang=' . $idartlang . '&' . 'idcatart=' . $idcatart . '&' . 'force=1&' . 'frame=' . $frame;
 341:         $url = $sess->url($url_str);
 342: 
 343:         // Redirect
 344:         header("location: $url");
 345:     }
 346: }
 347: 
 348: /**
 349:  * Returns list of languages (language ids) by passed client.
 350:  *
 351:  * @param int $client
 352:  * @return array
 353:  */
 354: function getLanguagesByClient($client) {
 355:     $oClientLangColl = new cApiClientLanguageCollection();
 356:     return $oClientLangColl->getLanguagesByClient($client);
 357: }
 358: 
 359: /**
 360:  * Returns all languages (language ids and names) of an client
 361:  *
 362:  * @param int $client
 363:  * @return array List of languages where the key is the language id and value
 364:  *         the language name
 365:  */
 366: function getLanguageNamesByClient($client) {
 367:     $oClientLangColl = new cApiClientLanguageCollection();
 368:     return $oClientLangColl->getLanguageNamesByClient($client);
 369: }
 370: 
 371: /**
 372:  * Adds slashes to passed string if PHP setting for magic quotes is disabled
 373:  *
 374:  * @param string $code String by reference
 375:  */
 376: function set_magic_quotes_gpc(&$code) {
 377:     global $cfg;
 378:     if (!$cfg['simulate_magic_quotes']) {
 379:         if (get_magic_quotes_gpc() == 0) {
 380:             $code = addslashes($code);
 381:         }
 382:     }
 383: }
 384: 
 385: /**
 386:  * Returns a list with all clients and languages.
 387:  *
 388:  * @return array Indexed array where the value is an assoziative array as
 389:  *         follows:
 390:  *         <pre>
 391:  *         - $arr[0]['idlang']
 392:  *         - $arr[0]['langname']
 393:  *         - $arr[0]['idclient']
 394:  *         - $arr[0]['clientname']
 395:  *         </pre>
 396:  */
 397: function getAllClientsAndLanguages() {
 398:     global $db, $cfg;
 399: 
 400:     $sql = "SELECT
 401:                 a.idlang as idlang,
 402:                 a.name as langname,
 403:                 b.name as clientname,
 404:                 b.idclient as idclient
 405:              FROM
 406:                 " . $cfg["tab"]["lang"] . " as a,
 407:                 " . $cfg["tab"]["clients_lang"] . " as c,
 408:                 " . $cfg["tab"]["clients"] . " as b
 409:              WHERE
 410:                 a.idlang = c.idlang AND
 411:                 c.idclient = b.idclient";
 412:     $db->query($sql);
 413: 
 414:     $aRs = array();
 415:     while ($db->nextRecord()) {
 416:         $aRs[] = array(
 417:             'idlang' => $db->f('idlang'),
 418:             'langname' => $db->f('langname'),
 419:             'idclient' => $db->f('idclient'),
 420:             'clientname' => $db->f('clientname')
 421:         );
 422:     }
 423:     return $aRs;
 424: }
 425: 
 426: function getmicrotime() {
 427:     list($usec, $sec) = explode(' ', microtime());
 428:     return ((float) $usec + (float) $sec);
 429: }
 430: 
 431: function isGroup($uid) {
 432:     $user = new cApiUser();
 433:     if ($user->loadByPrimaryKey($uid) === false) {
 434:         return true;
 435:     } else {
 436:         return false;
 437:     }
 438: }
 439: 
 440: function getGroupOrUserName($uid) {
 441:     $user = new cApiUser();
 442:     if ($user->loadByPrimaryKey($uid) === false) {
 443:         $group = new cApiGroup();
 444:         // Yes, it's a group. Let's try to load the group members!
 445:         if ($group->loadByPrimaryKey($uid) === false) {
 446:             return false;
 447:         } else {
 448:             return $group->getGroupName(true);
 449:         }
 450:     } else {
 451:         return $user->getField('realname');
 452:     }
 453: }
 454: 
 455: /**
 456:  * Checks if passed email address is valid or not
 457:  *
 458:  * @param string $email
 459:  * @param bool $strict No more used!
 460:  */
 461: function isValidMail($email, $strict = false) {
 462:     $validator = cValidatorFactory::getInstance('email');
 463:     return $validator->isValid($email);
 464: }
 465: 
 466: function htmldecode($string) {
 467:     $trans_tbl = conGetHtmlTranslationTable(HTML_ENTITIES);
 468:     $trans_tbl = array_flip($trans_tbl);
 469:     $ret = strtr($string, $trans_tbl);
 470:     return $ret;
 471: }
 472: 
 473: /**
 474:  * Loads the client information from the database and stores it in
 475:  * config.client.php.
 476:  * Reinitializes the $cfgClient array and fills it wih updated information if
 477:  * provided.
 478:  *
 479:  * @param number $idclient client id which will be updated
 480:  * @param string $htmlpath new HTML path. Starting with "http://"
 481:  * @param string $frontendpath path the to the frontend
 482:  */
 483: function updateClientCache($idclient = 0, $htmlpath = '', $frontendpath = '') {
 484:     global $cfg, $cfgClient, $errsite_idcat, $errsite_idart, $db;
 485: 
 486:     if (!is_array($cfgClient)) {
 487:         $cfgClient = array();
 488:     }
 489: 
 490:     if (!is_object($db)) {
 491:         $db = cRegistry::getDb();
 492:     }
 493: 
 494:     if ($idclient != 0 && $htmlpath != '' && $frontendpath != '') {
 495:         $cfgClient[$idclient]['path']['frontend'] = cSecurity::escapeString($frontendpath);
 496:         $cfgClient[$idclient]['path']['htmlpath'] = cSecurity::escapeString($htmlpath);
 497:     }
 498: 
 499:     $sql = 'SELECT idclient, name, errsite_cat, errsite_art FROM ' . $cfg['tab']['clients'];
 500:     $db->query($sql);
 501: 
 502:     $htmlpaths = array();
 503:     $frontendpaths = array();
 504:     foreach ($cfgClient as $id => $aclient) {
 505:         if (is_array($aclient)) {
 506:             $htmlpaths[$id] = $aclient["path"]["htmlpath"];
 507:             $frontendpaths[$id] = $aclient["path"]["frontend"];
 508:         }
 509:     }
 510:     unset($cfgClient);
 511:     $cfgClient = array();
 512: 
 513:     foreach ($htmlpaths as $id => $path) {
 514:         $cfgClient[$id]["path"]["htmlpath"] = $htmlpaths[$id];
 515:         $cfgClient[$id]["path"]["frontend"] = $frontendpaths[$id];
 516:     }
 517: 
 518:     while ($db->nextRecord()) {
 519:         $iClient = $db->f('idclient');
 520:         $cfgClient['set'] = 'set';
 521: 
 522:         $cfgClient[$iClient]['name'] = conHtmlSpecialChars(str_replace(array(
 523:             '*/',
 524:             '/*',
 525:             '//'
 526:         ), '', $db->f('name')));
 527: 
 528:         $errsite_idcat[$iClient] = $db->f('errsite_cat');
 529:         $errsite_idart[$iClient] = $db->f('errsite_art');
 530:         $cfgClient[$iClient]["errsite"]["idcat"] = $errsite_idcat[$iClient];
 531:         $cfgClient[$iClient]["errsite"]["idart"] = $errsite_idart[$iClient];
 532: 
 533:         $cfgClient[$iClient]['images'] = $cfgClient[$iClient]['path']['htmlpath'] . 'images/';
 534:         $cfgClient[$iClient]['upload'] = 'upload/';
 535: 
 536:         $cfgClient[$iClient]['htmlpath']['frontend'] = $cfgClient[$iClient]['path']['htmlpath'];
 537: 
 538:         $cfgClient[$iClient]['upl']['path'] = $cfgClient[$iClient]['path']['frontend'] . 'upload/';
 539:         $cfgClient[$iClient]['upl']['htmlpath'] = $cfgClient[$iClient]['htmlpath']['frontend'] . 'upload/';
 540:         $cfgClient[$iClient]['upl']['frontendpath'] = 'upload/';
 541: 
 542:         $cfgClient[$iClient]['css']['path'] = $cfgClient[$iClient]['path']['frontend'] . 'css/';
 543: 
 544:         $cfgClient[$iClient]['js']['path'] = $cfgClient[$iClient]['path']['frontend'] . 'js/';
 545: 
 546:         $cfgClient[$iClient]['tpl']['path'] = $cfgClient[$iClient]['path']['frontend'] . 'templates/';
 547: 
 548:         $cfgClient[$iClient]['cache']['path'] = $cfgClient[$iClient]['path']['frontend'] . 'cache/';
 549:         $cfgClient[$iClient]['cache']['frontendpath'] = 'cache/';
 550: 
 551:         $cfgClient[$iClient]['code']['path'] = $cfgClient[$iClient]['path']['frontend'] . 'cache/code/';
 552:         $cfgClient[$iClient]['code']['frontendpath'] = 'cache/code/';
 553: 
 554:         $cfgClient[$iClient]['xml']['path'] = $cfgClient[$iClient]['path']['frontend'] . 'xml/';
 555:         $cfgClient[$iClient]['xml']['frontendpath'] = 'xml/';
 556: 
 557:         $cfgClient[$iClient]['template']['path'] = $cfgClient[$iClient]['path']['frontend'] . 'templates/';
 558:         $cfgClient[$iClient]['template']['frontendpath'] = 'templates/';
 559: 
 560:         $cfgClient[$iClient]['data']['path'] = $cfgClient[$iClient]['path']['frontend'] . 'data/';
 561: 
 562:         $cfgClient[$iClient]['module']['path'] = $cfgClient[$iClient]['path']['frontend'] . 'data/modules/';
 563:         $cfgClient[$iClient]['module']['frontendpath'] = 'data/modules/';
 564: 
 565:         $cfgClient[$iClient]['config']['path'] = $cfgClient[$iClient]['path']['frontend'] . 'data/config/' . CON_ENVIRONMENT . '/';
 566:         $cfgClient[$iClient]['config']['frontendpath'] = 'data/config/';
 567: 
 568:         $cfgClient[$iClient]['layout']['path'] = $cfgClient[$iClient]['path']['frontend'] . 'data/layouts/';
 569:         $cfgClient[$iClient]['layout']['frontendpath'] = 'data/layouts/';
 570: 
 571:         $cfgClient[$iClient]['log']['path'] = $cfgClient[$iClient]['path']['frontend'] . 'data/logs/';
 572:         $cfgClient[$iClient]['log']['frontendpath'] = 'data/logs/';
 573: 
 574:         $cfgClient[$iClient]['version']['path'] = $cfgClient[$iClient]['path']['frontend'] . 'data/version/';
 575:         $cfgClient[$iClient]['version']['frontendpath'] = 'data/version/';
 576:     }
 577: 
 578:     $aConfigFileContent = array();
 579:     $aConfigFileContent[] = '<?php';
 580:     $aConfigFileContent[] = 'global $cfgClient;';
 581:     $aConfigFileContent[] = '';
 582: 
 583:     foreach ($cfgClient as $iIdClient => $aClient) {
 584:         if ((int) $iIdClient > 0 && is_array($aClient)) {
 585: 
 586:             $aConfigFileContent[] = '/* ' . $aClient['name'] . ' */';
 587:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["name"] = "' . $aClient['name'] . '";';
 588:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["errsite"]["idcat"] = "' . $aClient["errsite"]["idcat"] . '";';
 589:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["errsite"]["idart"] = "' . $aClient["errsite"]["idart"] . '";';
 590:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["images"] = "' . $aClient["path"]["htmlpath"] . 'images/";';
 591:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["upload"] = "upload/";';
 592: 
 593:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["path"]["frontend"] = "' . $aClient["path"]["frontend"] . '";';
 594: 
 595:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["htmlpath"]["frontend"] = "' . $aClient["path"]["htmlpath"] . '";';
 596: 
 597:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["upl"]["path"] = $cfgClient[' . $iIdClient . ']["path"]["frontend"] . "upload/";';
 598:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["upl"]["htmlpath"] = "' . $aClient["htmlpath"]["frontend"] . 'upload/";';
 599:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["upl"]["frontendpath"] = "upload/";';
 600: 
 601:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["css"]["path"] = $cfgClient[' . $iIdClient . ']["path"]["frontend"] . "css/";';
 602: 
 603:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["js"]["path"] = $cfgClient[' . $iIdClient . ']["path"]["frontend"] . "js/";';
 604: 
 605:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["tpl"]["path"] = $cfgClient[' . $iIdClient . ']["path"]["frontend"] . "templates/";';
 606: 
 607:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["cache"]["path"] = $cfgClient[' . $iIdClient . ']["path"]["frontend"] . "cache/";';
 608:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["cache"]["frontendpath"] = "cache/";';
 609: 
 610:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["code"]["path"] = $cfgClient[' . $iIdClient . ']["path"]["frontend"] . "cache/code/";';
 611:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["code"]["frontendpath"] = "cache/code/";';
 612: 
 613:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["xml"]["path"] = $cfgClient[' . $iIdClient . ']["path"]["frontend"] . "xml/";';
 614:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["xml"]["frontendpath"] = "xml/";';
 615: 
 616:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["template"]["path"] = $cfgClient[' . $iIdClient . ']["path"]["frontend"] . "templates/";';
 617:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["template"]["frontendpath"] = "templates/";';
 618: 
 619:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["data"]["path"] = $cfgClient[' . $iIdClient . ']["path"]["frontend"] . "data/";';
 620: 
 621:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["module"]["path"] = $cfgClient[' . $iIdClient . ']["path"]["frontend"] . "data/modules/";';
 622:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["module"]["frontendpath"] = "data/modules/";';
 623: 
 624:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["config"]["path"] = $cfgClient[' . $iIdClient . ']["path"]["frontend"] . "data/config/' . CON_ENVIRONMENT . '/";';
 625:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["config"]["frontendpath"] = "data/config/";';
 626: 
 627:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["layout"]["path"] = $cfgClient[' . $iIdClient . ']["path"]["frontend"] . "data/layouts/";';
 628:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["layout"]["frontendpath"] = "data/layouts/";';
 629: 
 630:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["log"]["path"] = $cfgClient[' . $iIdClient . ']["path"]["frontend"] . "data/logs/";';
 631:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["log"]["frontendpath"] = "data/logs/";';
 632: 
 633:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["version"]["path"] = $cfgClient[' . $iIdClient . ']["path"]["frontend"] . "data/version/";';
 634:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["version"]["frontendpath"] = "data/version/";';
 635:             $aConfigFileContent[] = '$cfgClient[' . $iIdClient . ']["path"]["htmlpath"] = "' . $aClient['path']['htmlpath'] . '";';
 636:             $aConfigFileContent[] = '';
 637:         }
 638:     }
 639:     $aConfigFileContent[] = '$cfgClient["set"] = "set";';
 640:     $aConfigFileContent[] = '?>';
 641: 
 642:     cFileHandler::write($cfg['path']['contenido_config'] . 'config.clients.php', implode(PHP_EOL, $aConfigFileContent));
 643: 
 644:     return $cfgClient;
 645: }
 646: 
 647: /**
 648:  * Sets a system property entry
 649:  *
 650:  * @modified Timo Trautmann 22.02.2008 Support for editing name and type
 651:  *
 652:  * @param string $type The type of the item
 653:  * @param string $name The name of the item
 654:  * @param string $value The value of the item
 655:  * @param int $idsystemprop The sysprop id, use optional. If set it allows to
 656:  *        modify type name and value
 657:  */
 658: function setSystemProperty($type, $name, $value, $idsystemprop = 0) {
 659:     if ($type == '' || $name == '') {
 660:         return false;
 661:     }
 662: 
 663:     $idsystemprop = (int) $idsystemprop;
 664: 
 665:     $systemPropColl = new cApiSystemPropertyCollection();
 666: 
 667:     if ($idsystemprop == 0) {
 668:         $prop = $systemPropColl->setValueByTypeName($type, $name, $value);
 669:     } else {
 670:         $prop = $systemPropColl->setTypeNameValueById($type, $name, $value, $idsystemprop);
 671:     }
 672: }
 673: 
 674: /**
 675:  * Remove a system property entry
 676:  *
 677:  * @param string $type The type of the item
 678:  * @param string $name The name of the item
 679:  * @return bool
 680:  */
 681: function deleteSystemProperty($type, $name) {
 682:     $systemPropColl = new cApiSystemPropertyCollection();
 683:     $systemPropColl->deleteByTypeName($type, $name);
 684: }
 685: 
 686: /**
 687:  * Retrieves all available system properties.
 688:  * Array format:
 689:  *
 690:  * $array[$type][$name] = $value;
 691:  *
 692:  * @modified Timo Trautmann 22.02.2008 Support for editing name and type editing
 693:  * by primaray key idsystemprop
 694:  * if bGetPropId is set:
 695:  * $array[$type][$name][value] = $value;
 696:  * $array[$type][$name][idsystemprop] = $idsystemprop;
 697:  *
 698:  * @param bool $bGetPropId If true special mode is activated which generates for
 699:  *        each property a third array, which also contains idsystemprop value
 700:  * @return array
 701:  */
 702: function getSystemProperties($bGetPropId = false) {
 703:     $return = array();
 704: 
 705:     $systemPropColl = new cApiSystemPropertyCollection();
 706:     $props = $systemPropColl->fetchAll('type ASC, name ASC, value ASC');
 707:     foreach ($props as $prop) {
 708:         $item = $prop->toArray();
 709: 
 710:         if ($bGetPropId) {
 711:             $return[$item['type']][$item['name']]['value'] = $item['value'];
 712:             $return[$item['type']][$item['name']]['idsystemprop'] = $item['idsystemprop'];
 713:         } else {
 714:             $return[$item['type']][$item['name']] = $item['value'];
 715:         }
 716:     }
 717: 
 718:     return $return;
 719: }
 720: 
 721: /**
 722:  * Gets a system property entry
 723:  *
 724:  * @param string $type The type of the item
 725:  * @param string $name The name of the item
 726:  * @return string bool property value or false if nothing was found
 727:  */
 728: function getSystemProperty($type, $name) {
 729:     $systemPropColl = new cApiSystemPropertyCollection();
 730:     $prop = $systemPropColl->fetchByTypeName($type, $name);
 731:     return ($prop) ? $prop->get('value') : false;
 732: }
 733: 
 734: /**
 735:  * Gets system property entries
 736:  *
 737:  * @param string $type The type of the properties
 738:  * @return array Assoziative array like $arr[name] = value
 739:  */
 740: function getSystemPropertiesByType($type) {
 741:     $return = array();
 742: 
 743:     $systemPropColl = new cApiSystemPropertyCollection();
 744:     $props = $systemPropColl->fetchByType($type);
 745:     foreach ($props as $prop) {
 746:         $return[$prop->get('name')] = $prop->get('value');
 747:     }
 748:     if (count($return) > 1) {
 749:         ksort($return);
 750:     }
 751:     return $return;
 752: }
 753: 
 754: /**
 755:  * Returns effective setting for a property.
 756:  *
 757:  * The order is: System => Client => Client (language) => Group => User
 758:  *
 759:  * System properties can be overridden by the group, and group properties
 760:  * can be overridden by the user.
 761:  *
 762:  * NOTE: If you provide a default value (other than empty string), then it will be returned back
 763:  *       in case of not existing or empty setting.
 764:  *
 765:  * @param  string  $type  The type of the item
 766:  * @param  string  $name  The name of the item
 767:  * @param  string  $default  Optional default value
 768:  * @return  bool|string  Setting value or false
 769:  */
 770: function getEffectiveSetting($type, $name, $default = '') {
 771:     return cEffectiveSetting::get($type, $name, $default);
 772: }
 773: 
 774: /**
 775:  * Returns the current effective settings for a type of properties.
 776:  *
 777:  * The order is:
 778:  * System => Client => Group => User
 779:  *
 780:  * System properties can be overridden by the group, and group
 781:  * properties can be overridden by the user.
 782:  *
 783:  * @param string $type The type of the item
 784:  * @return array Value
 785:  */
 786: function getEffectiveSettingsByType($type) {
 787:     return cEffectiveSetting::getByType($type);
 788: }
 789: 
 790: /**
 791:  * Retrieve list of article specifications for current client and language
 792:  *
 793:  * @return array list of article specifications
 794:  */
 795: function getArtspec() {
 796:     global $db, $cfg, $lang, $client;
 797:     $sql = "SELECT artspec, idartspec, online, artspecdefault FROM " . $cfg['tab']['art_spec'] . "
 798:             WHERE client = " . (int) $client . " AND lang = " . (int) $lang . " ORDER BY artspec ASC";
 799:     $db->query($sql);
 800: 
 801:     $artspec = array();
 802: 
 803:     while ($db->nextRecord()) {
 804:         $artspec[$db->f("idartspec")]['artspec'] = $db->f("artspec");
 805:         $artspec[$db->f("idartspec")]['online'] = $db->f("online");
 806:         $artspec[$db->f("idartspec")]['default'] = $db->f("artspecdefault");
 807:     }
 808:     return $artspec;
 809: }
 810: 
 811: /**
 812:  * Add new article specification
 813:  *
 814:  * @param string $artspectext specification text
 815:  * @param int $online Online status (1 or 0)
 816:  */
 817: function addArtspec($artspectext, $online) {
 818:     global $db, $cfg, $lang, $client;
 819: 
 820:     if (isset($_POST['idartspec'])) { // update
 821:         $fields = array(
 822:             'artspec' => $artspectext,
 823:             'online' => (int) $online
 824:         );
 825:         $where = array(
 826:             'idartspec' => (int) $_POST['idartspec']
 827:         );
 828:         $sql = $db->buildUpdate($cfg['tab']['art_spec'], $fields, $where);
 829:     } else {
 830:         $fields = array(
 831:             'client' => (int) $client,
 832:             'lang' => (int) $lang,
 833:             'artspec' => $artspectext,
 834:             'online' => 0,
 835:             'artspecdefault' => 0
 836:         );
 837:         $sql = $db->buildInsert($cfg['tab']['art_spec'], $fields);
 838:     }
 839:     $db->query($sql);
 840: }
 841: 
 842: /**
 843:  * Delete specified article specification
 844:  *
 845:  * @param int $idartspec article specification id
 846:  */
 847: function deleteArtspec($idartspec) {
 848:     global $db, $cfg;
 849:     $sql = "DELETE FROM " . $cfg['tab']['art_spec'] . " WHERE idartspec = " . (int) $idartspec;
 850:     $db->query($sql);
 851: 
 852:     $sql = "UPDATE " . $cfg["tab"]["art_lang"] . " SET artspec = 0 WHERE artspec = " . (int) $idartspec;
 853:     $db->query($sql);
 854: }
 855: 
 856: /**
 857:  * Set article specifications online
 858:  *
 859:  * Flag to switch if an article specification should be shown the frontend or
 860:  * not
 861:  *
 862:  * @param int $idartspec article specification id
 863:  * @param int $online 0/1 switch the status between on an offline
 864:  */
 865: function setArtspecOnline($idartspec, $online) {
 866:     global $db, $cfg;
 867:     $sql = "UPDATE " . $cfg['tab']['art_spec'] . " SET online = " . (int) $online . " WHERE idartspec = " . (int) $idartspec;
 868:     $db->query($sql);
 869: }
 870: 
 871: /**
 872:  * Set a default article specification
 873:  *
 874:  * While creating a new article this defined article specification will be
 875:  * default setting
 876:  *
 877:  * @param int $idartspec Article specification id
 878:  */
 879: function setArtspecDefault($idartspec) {
 880:     global $db, $cfg, $lang, $client;
 881:     $sql = "UPDATE " . $cfg['tab']['art_spec'] . " SET artspecdefault=0 WHERE client = " . (int) $client . " AND lang = " . (int) $lang;
 882:     $db->query($sql);
 883: 
 884:     $sql = "UPDATE " . $cfg['tab']['art_spec'] . " SET artspecdefault = 1 WHERE idartspec = " . (int) $idartspec;
 885:     $db->query($sql);
 886: }
 887: 
 888: /**
 889:  * Build a Article select Box
 890:  *
 891:  * @param string $sName Name of the SelectBox
 892:  * @param string $iIdCat category id
 893:  * @param string $sValue Value of the SelectBox
 894:  * @return string HTML
 895:  */
 896: function buildArticleSelect($sName, $iIdCat, $sValue) {
 897:     global $cfg, $lang;
 898: 
 899:     $db = cRegistry::getDb();
 900: 
 901:     $selectElem = new cHTMLSelectElement($sName, "", $sName);
 902:     $selectElem->appendOptionElement(new cHTMLOptionElement(i18n("Please choose"), ""));
 903: 
 904:     $sql = "SELECT b.title, b.idart FROM
 905:                " . $cfg["tab"]["art"] . " AS a, " . $cfg["tab"]["art_lang"] . " AS b, " . $cfg["tab"]["cat_art"] . " AS c
 906:                WHERE c.idcat = " . (int) $iIdCat . "
 907:                AND b.idlang = " . (int) $lang . " AND b.idart = a.idart and b.idart = c.idart
 908:                ORDER BY b.title";
 909: 
 910:     $db->query($sql);
 911: 
 912:     while ($db->nextRecord()) {
 913:         if ($sValue != $db->f('idart')) {
 914:             $selectElem->appendOptionElement(new cHTMLOptionElement($db->f('title'), $db->f('idart')));
 915:         } else {
 916:             $selectElem->appendOptionElement(new cHTMLOptionElement($db->f('title'), $db->f('idart'), true));
 917:         }
 918:     }
 919: 
 920:     return $selectElem->toHTML();
 921: }
 922: 
 923: /**
 924:  * Build a Category / Article select Box
 925:  *
 926:  * @param string $sName Name of the SelectBox
 927:  * @param string $sValue Value of the SelectBox
 928:  * @param int $Level Value of highest level that should be shown
 929:  * @param string $sClass Optional css class for select
 930:  * @return string HTML
 931:  */
 932: function buildCategorySelect($sName, $sValue, $sLevel = 0, $sClass = '') {
 933:     global $cfg, $client, $lang;
 934: 
 935:     $db = cRegistry::getDb();
 936:     $db2 = cRegistry::getDb();
 937: 
 938:     $selectElem = new cHTMLSelectElement($sName, "", $sName);
 939:     $selectElem->setClass($sClass);
 940:     $selectElem->appendOptionElement(new cHTMLOptionElement(i18n("Please choose"), ""));
 941: 
 942:     if ($sLevel > 0) {
 943:         $addString = "AND c.level < " . (int) $sLevel;
 944:     }
 945: 
 946:     $sql = "SELECT a.idcat AS idcat, b.name AS name, c.level FROM
 947:            " . $cfg["tab"]["cat"] . " AS a, " . $cfg["tab"]["cat_lang"] . " AS b,
 948:            " . $cfg["tab"]["cat_tree"] . " AS c WHERE a.idclient = " . (int) $client . "
 949:            AND b.idlang = " . (int) $lang . " AND b.idcat = a.idcat AND c.idcat = a.idcat " . $addString . "
 950:            ORDER BY c.idtree";
 951: 
 952:     $db->query($sql);
 953: 
 954:     $categories = array();
 955: 
 956:     while ($db->nextRecord()) {
 957:         $categories[$db->f("idcat")]["name"] = $db->f("name");
 958: 
 959:         $sql2 = "SELECT level FROM " . $cfg["tab"]["cat_tree"] . " WHERE idcat = " . (int) $db->f("idcat");
 960:         $db2->query($sql2);
 961: 
 962:         if ($db2->nextRecord()) {
 963:             $categories[$db->f("idcat")]["level"] = $db2->f("level");
 964:         }
 965: 
 966:         $sql2 = "SELECT a.title AS title, b.idcatart AS idcatart FROM
 967:                 " . $cfg["tab"]["art_lang"] . " AS a,  " . $cfg["tab"]["cat_art"] . " AS b
 968:                 WHERE b.idcat = '" . $db->f("idcat") . "' AND a.idart = b.idart AND
 969:                 a.idlang = " . (int) $lang;
 970: 
 971:         $db2->query($sql2);
 972: 
 973:         while ($db2->nextRecord()) {
 974:             $categories[$db->f("idcat")]["articles"][$db2->f("idcatart")] = $db2->f("title");
 975:         }
 976:     }
 977: 
 978:     foreach ($categories as $tmpidcat => $props) {
 979:         $spaces = "&nbsp;&nbsp;";
 980: 
 981:         for ($i = 0; $i < $props["level"]; $i++) {
 982:             $spaces .= "&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;";
 983:         }
 984: 
 985:         $tmp_val = $tmpidcat;
 986: 
 987:         if ($sValue != $tmp_val) {
 988:             $selectElem->appendOptionElement(new cHTMLOptionElement($spaces . ">" . $props["name"], $tmp_val));
 989:         } else {
 990:             $selectElem->appendOptionElement(new cHTMLOptionElement($spaces . ">" . $props["name"], $tmp_val, true));
 991:         }
 992:     }
 993: 
 994:     return $selectElem->toHTML();
 995: }
 996: 
 997: /**
 998:  * Converts a size in bytes in a human readable form
 999:  *
1000:  * @param int $number Some number of bytes
1001:  * @return string
1002:  */
1003: function humanReadableSize($number) {
1004:     $base = 1024;
1005:     $suffixes = array(
1006:         'Bytes',
1007:         'KiB',
1008:         'MiB',
1009:         'GiB',
1010:         'TiB',
1011:         'PiB',
1012:         'EiB'
1013:     );
1014: 
1015:     $usesuf = 0;
1016:     $n = (float) $number; // Appears to be necessary to avoid rounding
1017:     while ($n >= $base) {
1018:         $n /= (float) $base;
1019:         $usesuf++;
1020:     }
1021: 
1022:     $places = 2 - floor(log10($n));
1023:     $places = max($places, 0);
1024:     $retval = number_format($n, $places, '.', '') . ' ' . $suffixes[$usesuf];
1025:     return $retval;
1026: }
1027: 
1028: /**
1029:  * Converts a byte size like "8M" to the absolute number of bytes
1030:  *
1031:  * @param string $sizeString contains the size acquired from ini_get for example
1032:  * @return number
1033:  */
1034: function machineReadableSize($sizeString) {
1035:     $val = trim($sizeString);
1036:     $last = strtolower($val[strlen($val) - 1]);
1037:     $val = (float) substr($val, 0, strlen($val) - 1);
1038:     switch ($last) {
1039:         case 'g':
1040:             $val *= 1024;
1041:         case 'm':
1042:             $val *= 1024;
1043:         case 'k':
1044:             $val *= 1024;
1045:     }
1046: 
1047:     return $val;
1048: }
1049: 
1050: /**
1051:  * Checks if the script is being runned from the web
1052:  *
1053:  * @return bool True if the script is running from the web
1054:  */
1055: function isRunningFromWeb() {
1056:     if ($_SERVER['PHP_SELF'] == '' || php_sapi_name() == 'cgi' || php_sapi_name() == 'cli') {
1057:         return false;
1058:     }
1059: 
1060:     return true;
1061: }
1062: 
1063: /**
1064:  * Scans a given plugin directory and places the found plugins into the array
1065:  * $cfg['plugins'].
1066:  *
1067:  * Result:
1068:  * $cfg['plugins']['frontendusers'] => array with all found plugins
1069:  *
1070:  * Note: Plugins are only "found" if the following directory structure if found:
1071:  *
1072:  * entity/
1073:  * plugin1/plugin1.php
1074:  * plugin2/plugin2.php
1075:  *
1076:  * The plugin's directory and file name have to be the same, otherwise the
1077:  * function
1078:  * won't find them!
1079:  *
1080:  * @param string $entity Name of the directory to scan
1081:  */
1082: function scanPlugins($entity) {
1083:     global $cfg;
1084: 
1085:     $basedir = cRegistry::getBackendPath() . $cfg['path']['plugins'] . $entity . '/';
1086:     if (is_dir($basedir) === false) {
1087:         return;
1088:     }
1089: 
1090:     $pluginorder = getSystemProperty('plugin', $entity . '-pluginorder');
1091:     $lastscantime = (int) getSystemProperty('plugin', $entity . '-lastscantime');
1092: 
1093:     $plugins = array();
1094: 
1095:     // Fetch and trim the plugin order
1096:     if ($pluginorder != '') {
1097:         $plugins = explode(',', $pluginorder);
1098:         foreach ($plugins as $key => $plugin) {
1099:             $plugins[$key] = trim($plugin);
1100:         }
1101:     }
1102: 
1103:     // Don't scan all the time, but each 5 minutes
1104:     if ($lastscantime + 300 < time()) {
1105:         setSystemProperty('plugin', $entity . '-lastscantime', time());
1106:         if (is_dir($basedir)) {
1107:             if (false !== $dh = opendir($basedir)) {
1108:                 while (($file = readdir($dh)) !== false) {
1109:                     if (is_dir($basedir . $file) && $file != 'includes' && $file != '.' && $file != '..') {
1110:                         if (!in_array($file, $plugins)) {
1111:                             if (cFileHandler::exists($basedir . $file . '/' . $file . '.php')) {
1112:                                 $plugins[] = $file;
1113:                             }
1114:                         }
1115:                     }
1116:                 }
1117:                 closedir($dh);
1118:             }
1119:         }
1120: 
1121:         foreach ($plugins as $key => $value) {
1122:             if (!is_dir($basedir . $value) || !cFileHandler::exists($basedir . $value . '/' . $value . '.php')) {
1123:                 unset($plugins[$key]);
1124:             }
1125:         }
1126: 
1127:         sort($plugins);
1128: 
1129:         $pluginorder = implode(',', $plugins);
1130:         setSystemProperty('plugin', $entity . '-pluginorder', $pluginorder);
1131:     }
1132: 
1133:     foreach ($plugins as $key => $value) {
1134:         if (!is_dir($basedir . $value) || !cFileHandler::exists($basedir . $value . '/' . $value . '.php')) {
1135:             unset($plugins[$key]);
1136:         } else {
1137:             i18nRegisterDomain($entity . '_' . $value, $basedir . $value . '/locale/');
1138:         }
1139:     }
1140: 
1141:     $cfg['plugins'][$entity] = $plugins;
1142: }
1143: 
1144: /**
1145:  * Includes plugins for a given entity.
1146:  *
1147:  * @param $entity string Name of the directory to scan
1148:  */
1149: function includePlugins($entity) {
1150:     global $cfg;
1151: 
1152:     if (is_array($cfg['plugins'][$entity])) {
1153:         foreach ($cfg['plugins'][$entity] as $plugin) {
1154:             plugin_include($entity, $plugin . '/' . $plugin . '.php');
1155:         }
1156:     }
1157: }
1158: 
1159: /**
1160:  * Calls the plugin's store methods.
1161:  *
1162:  * @param string $entity Name of the directory to scan
1163:  */
1164: function callPluginStore($entity) {
1165:     global $cfg;
1166: 
1167:     // Check out if there are any plugins
1168:     if (is_array($cfg['plugins'][$entity])) {
1169:         foreach ($cfg['plugins'][$entity] as $plugin) {
1170:             if (function_exists($entity . '_' . $plugin . '_wantedVariables') && function_exists($entity . '_' . $plugin . '_store')) {
1171:                 $wantVariables = call_user_func($entity . '_' . $plugin . '_wantedVariables');
1172: 
1173:                 if (is_array($wantVariables)) {
1174:                     $varArray = array();
1175:                     foreach ($wantVariables as $value) {
1176:                         $varArray[$value] = stripslashes($GLOBALS[$value]);
1177:                     }
1178:                 }
1179:                 $store = call_user_func($entity . '_' . $plugin . '_store', $varArray);
1180:             }
1181:         }
1182:     }
1183: }
1184: 
1185: /**
1186:  * Creates a random name (example: Passwords).
1187:  *
1188:  * @param int $nameLength Length of the generated string
1189:  * @return string Random name
1190:  */
1191: function createRandomName($nameLength) {
1192:     $NameChars = 'abcdefghijklmnopqrstuvwxyz';
1193:     $Vouel = 'aeiou';
1194:     $Name = '';
1195: 
1196:     for ($index = 1; $index <= $nameLength; $index++) {
1197:         if ($index % 3 == 0) {
1198:             $randomNumber = rand(1, strlen($Vouel));
1199:             $Name .= substr($Vouel, $randomNumber - 1, 1);
1200:         } else {
1201:             $randomNumber = rand(1, strlen($NameChars));
1202:             $Name .= substr($NameChars, $randomNumber - 1, 1);
1203:         }
1204:     }
1205: 
1206:     return $Name;
1207: }
1208: 
1209: /**
1210:  * @deprecated [2013-10-02]  Use getJsHelpContext() instead
1211:  */
1212: function setHelpContext($area) {
1213:     cDeprecated("The function setHelpContext() is deprecated. Use getJsHelpContext() instead.");
1214:     return getJsHelpContext($area);
1215: }
1216: 
1217: /**
1218:  * Returns the JavaScript help context code, if help confuguration is enabled
1219:  * @param string $area  The area name
1220:  * @return The context context JS code
1221:  */
1222: function getJsHelpContext($area) {
1223:     global $cfg;
1224: 
1225:     if ($cfg['help'] == true) {
1226:         $hc = "parent.parent.parent.frames[0].document.getElementById('help').setAttribute('data', '$area');";
1227:     } else {
1228:         $hc = '';
1229:     }
1230: 
1231:     return $hc;
1232: }
1233: 
1234: /**
1235:  * Defines a constant if not defined before.
1236:  *
1237:  * @param string $constant Name of constant to define
1238:  * @param mixed $value It's value
1239:  */
1240: function defineIfNotDefined($constant, $value) {
1241:     if (!defined($constant)) {
1242:         define($constant, $value);
1243:     }
1244: }
1245: 
1246: /**
1247:  * CONTENIDO die-alternative.
1248:  * Logs the message and calls die().
1249:  *
1250:  * @param string $file File name (use __FILE__)
1251:  * @param int $line Line number (use __LINE__)
1252:  * @param string $message Message to display
1253:  */
1254: function cDie($file, $line, $message) {
1255:     cError($file, $line, $message);
1256:     die("$file $line: $message");
1257: }
1258: 
1259: /**
1260:  * Returns a formatted string with a stack trace ready for output.
1261:  * "\tfunction1() called in file $filename($line)"
1262:  * "\tfunction2() called in file $filename($line)"
1263:  * ...
1264:  *
1265:  * @param int $startlevel The startlevel. Note that 0 is always buildStackString
1266:  *        and 1 is the function called buildStackString (e.g. cWarning)
1267:  * @return string
1268:  */
1269: function buildStackString($startlevel = 2) {
1270:     $e = new Exception();
1271:     $stack = $e->getTrace();
1272: 
1273:     $msg = '';
1274: 
1275:     for ($i = $startlevel; $i < count($stack); $i++) {
1276:         $filename = basename($stack[$i]['file']);
1277: 
1278:         $msg .= "\t" . $stack[$i]['function'] . "() called in file " . $filename . "(" . $stack[$i]['line'] . ")\n";
1279:     }
1280: 
1281:     return $msg;
1282: }
1283: 
1284: /**
1285:  * CONTENIDO warning
1286:  *
1287:  * Examples:
1288:  * <pre>
1289:  * // New version
1290:  * cWarning('Some warning message');
1291:  * // Old version
1292:  * cWarning(__FILE__, __LINE__, 'Some warning message');
1293:  * </pre>
1294:  *
1295:  * @param Multiple parameters
1296:  */
1297: function cWarning() {
1298:     global $cfg;
1299: 
1300:     $args = func_get_args();
1301:     if (count($args) == 3) {
1302:         // Old version
1303:         $file = $args[0];
1304:         $line = $args[1];
1305:         $message = $args[2];
1306:     } else {
1307:         // New version
1308:         $file = '';
1309:         $line = '';
1310:         $message = $args[0];
1311:     }
1312: 
1313:     $msg = "[" . date("Y-m-d H:i:s") . "] ";
1314:     $msg .= "Warning: \"" . $message . "\" at ";
1315: 
1316:     $e = new Exception();
1317:     $stack = $e->getTrace();
1318:     $function_name = $stack[1]['function'];
1319: 
1320:     $msg .= $function_name . "() [" . basename($stack[0]['file']) . "(" . $stack[0]['line'] . ")]\n";
1321: 
1322:     if ($cfg['debug']['log_stacktraces'] == true) {
1323:         $msg .= buildStackString();
1324:         $msg .= "\n";
1325:     }
1326: 
1327:     cFileHandler::write($cfg['path']['contenido_logs'] . 'errorlog.txt', $msg, true);
1328: 
1329:     trigger_error($message, E_USER_WARNING);
1330: }
1331: 
1332: /**
1333:  * CONTENIDO error
1334:  *
1335:  * Examples:
1336:  * <pre>
1337:  * // New version
1338:  * cWarning('Some error message');
1339:  * // Old version
1340:  * cWarning(__FILE__, __LINE__, 'Some error message');
1341:  * </pre>
1342:  *
1343:  * @param Multiple parameters
1344:  */
1345: function cError($message) {
1346:     global $cfg;
1347: 
1348:     $args = func_get_args();
1349:     if (count($args) == 3) {
1350:         // Old version
1351:         $file = $args[0];
1352:         $line = $args[1];
1353:         $message = $args[2];
1354:     } else {
1355:         // New version
1356:         $file = '';
1357:         $line = '';
1358:         $message = $args[0];
1359:     }
1360: 
1361:     $msg = "[" . date("Y-m-d H:i:s") . "] ";
1362:     $msg .= "Error: \"" . $message . "\" at ";
1363: 
1364:     $e = new Exception();
1365:     $stack = $e->getTrace();
1366:     $function_name = $stack[1]['function'];
1367: 
1368:     $msg .= $function_name . "() called in " . basename($stack[1]['file']) . "(" . $stack[1]['line'] . ")\n";
1369: 
1370:     if ($cfg['debug']['log_stacktraces'] == true) {
1371:         $msg .= buildStackString();
1372:         $msg .= "\n";
1373:     }
1374: 
1375:     cFileHandler::write($cfg['path']['contenido_logs'] . 'errorlog.txt', $msg, true);
1376: 
1377:     trigger_error($message, E_USER_ERROR);
1378: }
1379: 
1380: /**
1381:  * Writes a note to deprecatedlog.txt
1382:  *
1383:  * @param string $amsg Optional message (e.g. "Use function XYZ instead")
1384:  */
1385: function cDeprecated($message = '') {
1386:     global $cfg;
1387: 
1388:     if (isset($cfg['debug']['log_deprecations']) && $cfg['debug']['log_deprecations'] == false) {
1389:         return;
1390:     }
1391: 
1392:     $e = new Exception();
1393:     $stack = $e->getTrace();
1394:     $function_name = $stack[1]['function'];
1395: 
1396:     $msg = "Deprecated call: " . $function_name . "() [" . basename($stack[0]['file']) . "(" . $stack[0]['line'] . ")]: ";
1397:     if ($message != '') {
1398:         $msg .= "\"" . $message . "\"" . "\n";
1399:     } else {
1400:         $msg .= "\n";
1401:     }
1402: 
1403:     if ($cfg['debug']['log_stacktraces'] == true) {
1404:         $msg .= buildStackString(2);
1405:         $msg .= "\n";
1406:     }
1407: 
1408:     cFileHandler::write($cfg['path']['contenido_logs'] . 'deprecatedlog.txt', $msg, true);
1409: }
1410: 
1411: /**
1412:  * Returns the name of the numeric frame given
1413:  *
1414:  * @param int $frame Frame number
1415:  * @return string Canonical name of the frame
1416:  */
1417: function getNamedFrame($frame) {
1418:     switch ($frame) {
1419:         case 1:
1420:             return 'left_top';
1421:             break;
1422:         case 2:
1423:             return 'left_bottom';
1424:             break;
1425:         case 3:
1426:             return 'right_top';
1427:             break;
1428:         case 4:
1429:             return 'right_bottom';
1430:             break;
1431:         default:
1432:             return '';
1433:             break;
1434:     }
1435: }
1436: 
1437: /**
1438:  * Starts the timing for a specific function
1439:  *
1440:  * @param string $function Name of the function
1441:  * @param array $parameters All parameters for the function to measure
1442:  * @return int uuid for this measure process
1443:  */
1444: function startTiming($function, $parameters = array()) {
1445:     global $_timings, $cfg;
1446: 
1447:     if ($cfg['debug']['functiontiming'] == false) {
1448:         return;
1449:     }
1450: 
1451:     // Create (almost) unique ID
1452:     $uuid = md5(uniqid(rand(), true));
1453: 
1454:     if (!is_array($parameters)) {
1455:         cWarning(__FILE__, __LINE__, "Warning: startTiming's parameters parameter expects an array");
1456:         $parameters = array();
1457:     }
1458: 
1459:     $_timings[$uuid]['parameters'] = $parameters;
1460:     $_timings[$uuid]['function'] = $function;
1461: 
1462:     $_timings[$uuid]['start'] = getmicrotime();
1463: 
1464:     return $uuid;
1465: }
1466: 
1467: /**
1468:  * Ends the timing process and logs it to the timings file
1469:  *
1470:  * @param $uuid int UUID which has been used for timing
1471:  */
1472: function endAndLogTiming($uuid) {
1473:     global $_timings, $cfg;
1474: 
1475:     if ($cfg['debug']['functiontiming'] == false) {
1476:         return;
1477:     }
1478: 
1479:     $_timings[$uuid]['end'] = getmicrotime();
1480: 
1481:     $timeSpent = $_timings[$uuid]['end'] - $_timings[$uuid]['start'];
1482: 
1483:     $myparams = array();
1484: 
1485:     // Build nice representation of the function
1486:     foreach ($_timings[$uuid]['parameters'] as $parameter) {
1487:         switch (gettype($parameter)) {
1488:             case 'string':
1489:                 $myparams[] = '"' . $parameter . '"';
1490:                 break;
1491:             case 'boolean':
1492:                 if ($parameter == true) {
1493:                     $myparams[] = 'true';
1494:                 } else {
1495:                     $myparams[] = 'false';
1496:                 }
1497:                 break;
1498:             default:
1499:                 if ($parameter == '') {
1500:                     $myparams[] = '"' . $parameter . '"';
1501:                 } else {
1502:                     $myparams[] = $parameter;
1503:                 }
1504:         }
1505:     }
1506: 
1507:     $parameterString = implode(', ', $myparams);
1508: 
1509:     cDebug::out('calling function ' . $_timings[$uuid]['function'] . '(' . $parameterString . ') took ' . $timeSpent . ' seconds');
1510: }
1511: 
1512: /**
1513:  * Function checks current language and client settings by HTTP-Params and DB
1514:  * settings.
1515:  * Based on this informations it will send an HTTP header for right encoding.
1516:  *
1517:  * @param cDb $db NO MORE NEEDED
1518:  * @param array $cfg Global cfg-array
1519:  * @param int $lang Global language id
1520:  * @param string $contentType Mime type
1521:  */
1522: function sendEncodingHeader($db, $cfg, $lang, $contentType = 'text/html') {
1523:     if (isset($_GET['use_encoding'])) {
1524:         $use_encoding = trim(strip_tags($_GET['use_encoding']));
1525:     } elseif (isset($_POST['use_encoding'])) {
1526:         $use_encoding = trim(strip_tags($_POST['use_encoding']));
1527:     } else {
1528:         $use_encoding = true;
1529:     }
1530: 
1531:     if (is_string($use_encoding)) {
1532:         $use_encoding = ($use_encoding == 'false') ? false : true;
1533:     }
1534: 
1535:     if ($use_encoding != false) {
1536:         $aLanguageEncodings = array();
1537: 
1538:         $oLangColl = new cApiLanguageCollection();
1539:         $oLangColl->select();
1540:         while (($oItem = $oLangColl->next()) !== false) {
1541:             $aLanguageEncodings[$oItem->get('idlang')] = $oItem->get('encoding');
1542:         }
1543: 
1544:         $charset = 'utf-8';
1545:         if (isset($aLanguageEncodings[$lang])) {
1546:             if (in_array($aLanguageEncodings[$lang], $cfg['AvailableCharsets'])) {
1547:                 $charset = $aLanguageEncodings[$lang];
1548:             }
1549:         }
1550:         header('Content-Type: ' . $contentType . '; charset=' . $charset);
1551:     }
1552: }
1553: 
1554: /**
1555:  * IP match
1556:  *
1557:  * @param string $network
1558:  * @param string $mask
1559:  * @param string $ip
1560:  * @return boolean
1561:  */
1562: function ipMatch($network, $mask, $ip) {
1563:     bcscale(3);
1564:     $ip_long = ip2long($ip);
1565:     $mask_long = ip2long($network);
1566: 
1567:     // Convert mask to divider
1568:     if (preg_match('/^[0-9]+$/', $mask)) {
1569:         // / 212.50.13.0/27 style mask (Cisco style)
1570:         $divider = bcpow(2, (32 - $mask));
1571:     } else {
1572:         // / 212.50.13.0/255.255.255.0 style mask
1573:         $xmask = ip2long($mask);
1574:         if ($xmask < 0) {
1575:             $xmask = bcadd(bcpow(2, 32), $xmask);
1576:         }
1577:         $divider = bcsub(bcpow(2, 32), $xmask);
1578:     }
1579:     // Test is IP within specified mask
1580:     if (floor(bcdiv($ip_long, $divider)) == floor(bcdiv($mask_long, $divider))) {
1581:         // match - this IP is within specified mask
1582:         return true;
1583:     } else {
1584:         // fail - this IP is NOT within specified mask
1585:         return false;
1586:     }
1587: }
1588: 
1589: /**
1590:  * @deprecated [2013-08-14]  Use cString::endsWith() instead
1591:  */
1592: function endsWith($haystack, $needle) {
1593:     cDeprecated("The function endsWith is deprecated. Use cString::endsWith() instead.");
1594:     return cString::endsWith($haystack, $needle);
1595: }
1596: 
1597: /**
1598:  * Checks, if a function is disabled or not ('disable_functions' setting in php.ini)
1599:  * @param  string  $functionName  Name of the function to check
1600:  * @return bool
1601:  */
1602: function isFunctionDisabled($functionName) {
1603:     static $disabledFunctions;
1604: 
1605:     if (empty($functionName)) {
1606:         return true;
1607:     }
1608: 
1609:     if (!isset($disabledFunctions)) {
1610:         $disabledFunctions = array_map('trim', explode(',', ini_get('disable_functions')));
1611:     }
1612: 
1613:     return (in_array($functionName, $disabledFunctions));
1614: }
1615: 
1616: /**
1617:  * Generates category article breadcrumb for backend
1618:  *
1619:  * @param string $syncoptions syncstate of backend
1620:  * @param string $showArticle show also current article or categories only (optional)
1621:  * @return NULL
1622:  */
1623: function renderBackendBreadcrumb($syncoptions, $showArticle = true, $return = false) {
1624:     $tplBread = new cTemplate();
1625:     $tplBread->set('s', 'LABEL', i18n("You are here"));
1626:     $syncoptions = (int) $syncoptions;
1627: 
1628:     $helper = cCategoryHelper::getInstance();
1629:     $categories = $helper->getCategoryPath(cRegistry::getCategoryId(), 1);
1630:     $catCount = count($categories);
1631:     $tplCfg = new cApiTemplateConfiguration();
1632:     $sess = cRegistry::getSession();
1633:     $cfg = cRegistry::getConfig();
1634:     $lang = cRegistry::getLanguageId();
1635:     $idart = cRegistry::getArticleId();
1636: 
1637: 
1638:     for ($i = 0; $i < $catCount; $i++) {
1639:         $idcat_tpl = 0;
1640:         $idcat_bread = $categories[$i]->getField('idcat');
1641:         $idcat_name = $categories[$i]->getField('name');
1642:         $idcat_tplcfg = $categories[$i]->getField('idtplcfg');
1643:         if ((int) $idcat_tplcfg > 0) {
1644:             $tplCfg->loadByPrimaryKey($idcat_tplcfg);
1645:             if ($tplCfg->isLoaded()) {
1646:                 $idcat_tpl = $tplCfg->getField('idtpl');
1647:             }
1648:         }
1649: 
1650:         $linkUrl = $sess->url(cRegistry::getBackendUrl() . "main.php?area=con&frame=4&idcat=$idcat_bread&idtpl=$idcat_tpl&syncoptions=$syncoptions&contenido=1");
1651:         $tplBread->set('d', 'LINK', $linkUrl);
1652:         $tplBread->set('d', 'NAME', $idcat_name);
1653: 
1654:         $sepArrow = '';
1655:         if ($i < $catCount - 1) {
1656:             $sepArrow = ' > ';
1657:         } else {
1658:             if ((int) $idart > 0 && $showArticle === true) {
1659:                 $art = new cApiArticleLanguage();
1660:                 $art->loadByArticleAndLanguageId($idart, $lang);
1661:                 if ($art->isLoaded()) {
1662:                     $name = $art->getField('title');
1663:                     $sepArrow = ' > ' . $name;
1664:                 }
1665:             }
1666:         }
1667:         $tplBread->set('d', 'SEP_ARROW', $sepArrow);
1668: 
1669:         $tplBread->next();
1670:     }
1671: 
1672:     return $tplBread->generate($cfg['path']['templates'] . $cfg['templates']['breadcrumb'], $return);
1673: }
1674: 
1675: ?>