/**
  * Validates the passed chunk of data.
  * In most cases, this'll be a string-object.
  *
  * @param string $objValue
  * @return bool
  */
 public function validate($objValue)
 {
     if (is_string($objValue) && uniStrlen($objValue) == 1) {
         return true;
     }
     return false;
 }

 /**
  * Validates the passed chunk of data.
  * In most cases, this'll be a string-object.
  *
  * @param string $objValue
  * @return bool
  */
 public function validate($objValue)
 {
     if (!is_string($objValue) || uniStrlen($objValue) == 0) {
         return false;
     }
     return is_dir(_realpath_ . $objValue);
 }

 /**
  * Validates the passed chunk of data.
  * In most cases, this'll be a string-object.
  *
  * @param string $objValue
  * @return bool
  */
 public function validate($objValue)
 {
     if (!is_string($objValue) || uniStrlen($objValue) == 0) {
         return false;
     }
     return is_file(_realpath_ . $this->strBaseDir . $objValue);
 }

 /**
  * @return string
  */
 private function getUserlist()
 {
     $strReturn = "";
     $strTemplateWrapperID = $this->objTemplate->readTemplate("/element_userlist/" . $this->arrElementData["char1"], "userlist_wrapper");
     $strTemplateRowID = $this->objTemplate->readTemplate("/element_userlist/" . $this->arrElementData["char1"], "userlist_row");
     $arrUserFinal = $this->loadUserlist();
     $strRows = "";
     foreach ($arrUserFinal as $objOneUser) {
         $objTargetUser = $objOneUser->getObjSourceUser();
         if ($objTargetUser instanceof class_usersources_user_kajona) {
             $arrRow = array();
             $arrRow["userName"] = $objTargetUser->getStrName();
             $arrRow["userForename"] = $objTargetUser->getStrForename();
             $arrRow["userStreet"] = $objTargetUser->getStrStreet();
             $arrRow["userEmail"] = $objTargetUser->getStrEmail();
             $arrRow["userPostal"] = $objTargetUser->getStrPostal();
             $arrRow["userCity"] = $objTargetUser->getStrCity();
             $arrRow["userPhone"] = $objTargetUser->getStrTel();
             $arrRow["userMobile"] = $objTargetUser->getStrMobile();
             $arrRow["userBirthday"] = uniStrlen($objTargetUser->getLongDate()) > 5 ? dateToString(new class_date($objTargetUser->getLongDate()), false) : "";
             $strRows .= $this->fillTemplate($arrRow, $strTemplateRowID);
         }
     }
     $strLink = getLinkPortalHref($this->getPagename(), "", "exportToCsv");
     $strReturn .= $this->fillTemplate(array("userlist_rows" => $strRows, "csvHref" => $strLink), $strTemplateWrapperID);
     return $strReturn;
 }

 /**
  * Calls the single search-functions, sorts the results and creates the output.
  * Method for portal-searches.
  *
  * @param class_module_search_search $objSearch
  *
  * @return class_search_result[]
  */
 public function doPortalSearch($objSearch)
 {
     $objSearch->setStrQuery(trim(uniStrReplace("%", "", $objSearch->getStrQuery())));
     if (uniStrlen($objSearch->getStrQuery()) == 0) {
         return array();
     }
     //create a search object
     $objSearch->setBitPortalObjectFilter(true);
     $arrHits = $this->doIndexedSearch($objSearch);
     $arrReturn = array();
     foreach ($arrHits as $objOneResult) {
         $objInstance = $objOneResult->getObjObject();
         if ($objInstance instanceof class_module_pages_pageelement) {
             $objInstance = $objInstance->getConcreteAdminInstance();
             if ($objInstance != null) {
                 $objInstance->loadElementData();
             } else {
                 continue;
             }
         }
         $arrUpdatedResults = $objInstance->updateSearchResult($objOneResult);
         if (is_array($arrUpdatedResults)) {
             $arrReturn = array_merge($arrReturn, $arrUpdatedResults);
         } else {
             if ($objOneResult != null && $objOneResult instanceof class_search_result) {
                 $arrReturn[] = $objOneResult;
             }
         }
     }
     //log the query
     class_module_search_log::generateLogEntry($objSearch->getStrQuery());
     $arrReturn = $this->mergeDuplicates($arrReturn);
     return $arrReturn;
 }

 /**
  * Overwritten in order to load key-value pairs declared by annotations
  */
 protected function updateValue()
 {
     parent::updateValue();
     if ($this->getObjSourceObject() != null && $this->getStrSourceProperty() != "") {
         $objReflection = new class_reflection($this->getObjSourceObject());
         //try to find the matching source property
         $arrProperties = $objReflection->getPropertiesWithAnnotation(self::STR_TEMPLATEDIR_ANNOTATION);
         $strSourceProperty = null;
         foreach ($arrProperties as $strPropertyName => $strValue) {
             if (uniSubstr(uniStrtolower($strPropertyName), uniStrlen($this->getStrSourceProperty()) * -1) == $this->getStrSourceProperty()) {
                 $strSourceProperty = $strPropertyName;
             }
         }
         if ($strSourceProperty == null) {
             return;
         }
         $strTemplateDir = $objReflection->getAnnotationValueForProperty($strSourceProperty, self::STR_TEMPLATEDIR_ANNOTATION);
         //load templates
         $arrTemplates = class_resourceloader::getInstance()->getTemplatesInFolder($strTemplateDir);
         $arrTemplatesDD = array();
         if (count($arrTemplates) > 0) {
             foreach ($arrTemplates as $strTemplate) {
                 $arrTemplatesDD[$strTemplate] = $strTemplate;
             }
         }
         $this->setArrKeyValues($arrTemplatesDD);
     }
 }

 /**
  * Overwritten in order to load key-value pairs declared by annotations
  */
 protected function updateValue()
 {
     parent::updateValue();
     if ($this->getObjSourceObject() != null && $this->getStrSourceProperty() != "") {
         $objReflection = new class_reflection($this->getObjSourceObject());
         //try to find the matching source property
         $arrProperties = $objReflection->getPropertiesWithAnnotation(self::STR_DDVALUES_ANNOTATION);
         $strSourceProperty = null;
         foreach ($arrProperties as $strPropertyName => $strValue) {
             if (uniSubstr(uniStrtolower($strPropertyName), uniStrlen($this->getStrSourceProperty()) * -1) == $this->getStrSourceProperty()) {
                 $strSourceProperty = $strPropertyName;
             }
         }
         if ($strSourceProperty == null) {
             return;
         }
         $strDDValues = $objReflection->getAnnotationValueForProperty($strSourceProperty, self::STR_DDVALUES_ANNOTATION);
         if ($strDDValues !== null && $strDDValues != "") {
             $arrDDValues = array();
             foreach (explode(",", $strDDValues) as $strOneKeyVal) {
                 $strOneKeyVal = uniSubstr(trim($strOneKeyVal), 1, -1);
                 $arrOneKeyValue = explode("=>", $strOneKeyVal);
                 $strKey = trim($arrOneKeyValue[0]) == "" ? " " : trim($arrOneKeyValue[0]);
                 if (count($arrOneKeyValue) == 2) {
                     $strValue = class_carrier::getInstance()->getObjLang()->getLang(trim($arrOneKeyValue[1]), $this->getObjSourceObject()->getArrModule("modul"));
                     if ($strValue == "!" . trim($arrOneKeyValue[1]) . "!") {
                         $strValue = $arrOneKeyValue[1];
                     }
                     $arrDDValues[$strKey] = $strValue;
                 }
             }
             $this->setArrKeyValues($arrDDValues);
         }
     }
 }

 /**
  * Validates the passed chunk of data.
  * In most cases, this'll be a string-object.
  *
  * @param string $objValue
  * @return bool
  */
 public function validate($objValue)
 {
     if (!is_string($objValue)) {
         return false;
     }
     return uniStrlen($objValue) === 2;
 }

 /**
  * Splits the current text into several tokens
  * @return void
  */
 private function tokenizeAndClearShortText()
 {
     $arrResults = array();
     preg_match_all('/\\w{1,}/u', $this->getText(), $arrResults);
     $arrFiltered = array_filter($arrResults[0], function ($strOneHit) {
         return is_numeric($strOneHit) || uniStrlen($strOneHit) > 2;
     });
     $this->setResults($arrFiltered);
     $this->setResults(array_count_values($this->getResults()));
 }

 /**
  * Tries to authenticate a user with the given credentials.
  * The password is unencrypted, each source should take care of its own encryption.
  *
  * @param interface_usersources_user|class_usersources_user_kajona $objUser
  * @param string $strPassword
  *
  * @return bool
  */
 public function authenticateUser(interface_usersources_user $objUser, $strPassword)
 {
     if ($objUser instanceof class_usersources_user_kajona) {
         $bitMD5Encryption = false;
         if (uniStrlen($objUser->getStrFinalPass()) == 32) {
             $bitMD5Encryption = true;
         }
         if ($objUser->getStrFinalPass() == self::encryptPassword($strPassword, $objUser->getStrSalt(), $bitMD5Encryption)) {
             return true;
         }
     }
     return false;
 }

 /**
  * Tries to get the name of an action (edit, delete, list, new, save) for a given object-type.
  * Example: Converts list to listOtherObject for the object class_module_demo_demo if the annotation
  *          @ objectListOtherObject class_module_demo_demo is declared
  *
  * @param string $strAction
  * @param $objInstance
  *
  * @return string
  */
 protected function getActionNameForClass($strAction, $objInstance)
 {
     if (isset(self::$arrActionNameMapping[$strAction])) {
         $strAnnotationPrefix = self::$arrActionNameMapping[$strAction];
         if ($strAction == "new") {
             return $strAction . $this->getStrCurObjectTypeName();
         } else {
             $objReflection = new class_reflection($this);
             $arrAnnotations = $objReflection->getAnnotationsWithValueFromClass(get_class($objInstance));
             foreach ($arrAnnotations as $strProperty) {
                 if (uniStrpos($strProperty, $strAnnotationPrefix) === 0) {
                     return $strAction . uniSubstr($strProperty, uniStrlen($strAnnotationPrefix));
                 }
             }
         }
     }
     return parent::getActionNameForClass($strAction, $objInstance);
 }

 /**
  * Validates the passed chunk of data.
  * In most cases, this'll be a string-object.
  *
  * @param string $objValue
  * @return bool
  */
 public function validate($objValue)
 {
     if (!is_string($objValue)) {
         return false;
     }
     $intMin = 1;
     $intMax = 0;
     //todo does not makes sense here as the else part will never be reached?extract intMax to class variable?
     $intLen = uniStrlen($objValue);
     if ($intMax == 0) {
         if ($intLen >= $intMin) {
             return true;
         }
     } else {
         if ($intLen >= $intMin && $intLen <= $intMax) {
             return true;
         }
     }
     return false;
 }

 private function getSourceDir()
 {
     if ($this->getObjSourceObject() != null && $this->getStrSourceProperty() != "") {
         $objReflection = new class_reflection($this->getObjSourceObject());
         //try to find the matching source property
         $arrProperties = $objReflection->getPropertiesWithAnnotation(self::STR_SOURCEDIR_ANNOTATION);
         $strSourceProperty = null;
         foreach ($arrProperties as $strPropertyName => $strValue) {
             if (uniSubstr(uniStrtolower($strPropertyName), uniStrlen($this->getStrSourceProperty()) * -1) == $this->getStrSourceProperty()) {
                 $strSourceProperty = $strPropertyName;
             }
         }
         if ($strSourceProperty != null) {
             $strDir = $objReflection->getAnnotationValueForProperty($strSourceProperty, self::STR_SOURCEDIR_ANNOTATION);
             if ($strDir !== null && $strDir != "") {
                 return $strDir;
             }
         }
     }
     return null;
 }

 /**
  * @see interface_admin_systemtask::getAdminForm()
  * @return string
  */
 public function getAdminForm()
 {
     $strReturn = "";
     //show dropdown to select db-dump
     $objFilesystem = new class_filesystem();
     $arrFiles = $objFilesystem->getFilelist(_projectpath_ . "/dbdumps/", array(".sql", ".gz"));
     $arrOptions = array();
     foreach ($arrFiles as $strOneFile) {
         $arrDetails = $objFilesystem->getFileDetails(_projectpath_ . "/dbdumps/" . $strOneFile);
         $strTimestamp = "";
         if (uniStrpos($strOneFile, "_") !== false) {
             $strTimestamp = uniSubstr($strOneFile, uniStrrpos($strOneFile, "_") + 1, uniStrpos($strOneFile, ".") - uniStrrpos($strOneFile, "_"));
         }
         if (uniStrlen($strTimestamp) > 9 && is_numeric($strTimestamp)) {
             $arrOptions[$strOneFile] = $strOneFile . " (" . bytesToString($arrDetails["filesize"]) . ")" . "<br />" . $this->getLang("systemtask_dbimport_datefilename") . " " . timeToString($strTimestamp) . "<br />" . $this->getLang("systemtask_dbimport_datefileinfo") . " " . timeToString($arrDetails['filechange']);
         } else {
             $arrOptions[$strOneFile] = $strOneFile . " (" . bytesToString($arrDetails["filesize"]) . ")" . "<br />" . $this->getLang("systemtask_dbimport_datefileinfo") . " " . timeToString($arrDetails['filechange']);
         }
     }
     $strReturn .= $this->objToolkit->formInputRadiogroup("dbImportFile", $arrOptions, $this->getLang("systemtask_dbimport_file"));
     return $strReturn;
 }

 /**
  * Returns a textual representation of the formentries' value.
  * May contain html, but should be stripped down to text-only.
  *
  * @return string
  */
 public function getValueAsText()
 {
     //load all matching and possible values based on the prefix
     if ($this->getObjSourceObject() == null || $this->getStrSourceProperty() == "") {
         return $this->getStrValue() . " Error: No target object mapped or missing @fieldValuePrefix annotation!";
     }
     $objReflection = new class_reflection($this->getObjSourceObject());
     //try to find the matching source property
     $arrProperties = $objReflection->getPropertiesWithAnnotation(self::STR_VALUE_ANNOTATION);
     $strSourceProperty = null;
     foreach ($arrProperties as $strPropertyName => $strValue) {
         if (uniSubstr(uniStrtolower($strPropertyName), uniStrlen($this->getStrSourceProperty()) * -1) == $this->getStrSourceProperty()) {
             $strSourceProperty = $strPropertyName;
         }
     }
     if ($strSourceProperty == null) {
         return $this->getStrValue();
     }
     $strPrefix = trim($objReflection->getAnnotationValueForProperty($strSourceProperty, self::STR_VALUE_ANNOTATION));
     if ($this->getStrValue() !== null && $this->getStrValue() !== "") {
         return $this->getObjSourceObject()->getLang($strPrefix . $this->getStrValue());
     }
     return "";
 }

 /**
  * Returns the filter modules to edit the filter modules
  *
  * @return array
  */
 public function getFilterModules()
 {
     if (uniStrlen($this->strInternalFilterModules) > 0 && $this->strInternalFilterModules != "-1") {
         return explode(",", $this->strInternalFilterModules);
     }
     return array();
 }

 /**
  * Returns a textual description of the current element, based
  * on the lang key element_description.
  *
  * @return string
  * @since 3.2.1
  */
 public function getElementDescription()
 {
     $strName = uniSubstr(get_class($this), uniStrlen("class_"), -6);
     $strDesc = $this->getLang($strName . "_description");
     if ($strDesc == "!" . $strName . "_description!") {
         $strDesc = "";
     }
     return $strDesc;
 }

 /**
  * Creates a raw Link for the portal (just the href)
  *
  * @param string $strPageI
  * @param string $strPageE
  * @param string $strAction
  * @param string $strParams
  * @param string $strSystemid
  * @param string $strLanguage
  * @param string $strSeoAddon Only used if using mod_rewrite
  * @return string
  */
 public static function getLinkPortalHref($strPageI, $strPageE = "", $strAction = "", $strParams = "", $strSystemid = "", $strLanguage = "", $strSeoAddon = "")
 {
     $strReturn = "";
     $bitInternal = true;
     //return "#" if neither an internal nor an external page is set
     if ($strPageI == "" && $strPageE == "") {
         return "#";
     }
     //Internal links are more important than external links!
     if ($strPageI == "" && $strPageE != "") {
         $bitInternal = false;
     }
     //create an array out of the params
     if ($strSystemid != "") {
         $strParams .= "&systemid=" . $strSystemid;
         $strSystemid = "";
     }
     $arrParams = self::parseParamsString($strParams, $strSystemid);
     // any anchors set to the page?
     $strAnchor = "";
     if (uniStrpos($strPageI, "#") !== false) {
         //get anchor, remove anchor from link
         $strAnchor = urlencode(uniSubstr($strPageI, uniStrpos($strPageI, "#") + 1));
         $strPageI = uniSubstr($strPageI, 0, uniStrpos($strPageI, "#"));
     }
     //urlencoding
     $strPageI = urlencode($strPageI);
     $strAction = urlencode($strAction);
     //more than one language installed?
     if ($strLanguage == "" && self::getIntNumberOfPortalLanguages() > 1) {
         $strLanguage = self::getStrPortalLanguage();
     } else {
         if ($strLanguage != "" && self::getIntNumberOfPortalLanguages() <= 1) {
             $strLanguage = "";
         }
     }
     $strHref = "";
     if ($bitInternal) {
         //check, if we could use mod_rewrite
         $bitRegularLink = true;
         if (class_module_system_setting::getConfigValue("_system_mod_rewrite_") == "true") {
             $strAddKeys = "";
             //used later to add seo-relevant keywords
             $objPage = class_module_pages_page::getPageByName($strPageI);
             if ($objPage !== null) {
                 if ($strLanguage != "") {
                     $objPage->setStrLanguage($strLanguage);
                     $objPage->initObject();
                 }
                 $strAddKeys = $objPage->getStrSeostring() . ($strSeoAddon != "" && $objPage->getStrSeostring() != "" ? "-" : "") . urlSafeString($strSeoAddon);
                 if (uniStrlen($strAddKeys) > 0 && uniStrlen($strAddKeys) <= 2) {
                     $strAddKeys .= "__";
                 }
                 //trim string
                 $strAddKeys = uniStrTrim($strAddKeys, 100, "");
                 if ($strLanguage != "") {
                     $strHref .= $strLanguage . "/";
                 }
                 $strPath = $objPage->getStrPath();
                 if ($strPath == "") {
                     $objPage->updatePath();
                     $strPath = $objPage->getStrPath();
                     $objPage->updateObjectToDb();
                 }
                 if ($strPath != "") {
                     $strHref .= $strPath . "/";
                 }
             }
             //ok, here we go. schema for rewrite_links: pagename.addKeywords.action.systemid.language.html
             //but: special case: just pagename & language
             if ($strAction == "" && $strSystemid == "" && $strAddKeys == "") {
                 $strHref .= $strPageI . ".html";
             } elseif ($strAction == "" && $strSystemid == "") {
                 $strHref .= $strPageI . ($strAddKeys == "" ? "" : "." . $strAddKeys) . ".html";
             } elseif ($strAction != "" && $strSystemid == "") {
                 $strHref .= $strPageI . "." . $strAddKeys . "." . $strAction . ".html";
             } else {
                 $strHref .= $strPageI . "." . $strAddKeys . "." . $strAction . "." . $strSystemid . ".html";
             }
             //params?
             if (count($arrParams) > 0) {
                 $strHref .= "?" . implode("&amp;", $arrParams);
             }
             // add anchor if given
             if ($strAnchor != "") {
                 $strHref .= "#" . $strAnchor;
             }
             //plus the domain as a prefix
//.........这里部分代码省略.........

 /**
  * Inserts a line-break to long legend-values
  *
  * @param $strLegend
  * @return string
  */
 private function stripLegend($strLegend)
 {
     $intStart = $this->intLegendBreakCount;
     while (uniStrlen($strLegend) > $intStart) {
         $strLegend = uniSubstr($strLegend, 0, $intStart) . "\n" . uniSubstr($strLegend, $intStart);
         $intStart += $this->intLegendBreakCount;
     }
     return $strLegend;
 }

 /**
  * Internal helper, loads all files available including a traversal
  * of the nested folders.
  *
  * @param $strParentId
  * @param int|bool $strCategoryFilter
  * @param int $intStart
  * @param int $intEnd
  * @param bool $strNameFilter
  *
  * @return class_module_mediamanager_file[]
  */
 private function getAllPackages($strParentId, $strCategoryFilter = false, $intStart = null, $intEnd = null, $strNameFilter = false)
 {
     $arrReturn = array();
     if (validateSystemid($strParentId)) {
         $arrSubfiles = class_module_mediamanager_file::loadFilesDB($strParentId, false, true, null, null, true);
         foreach ($arrSubfiles as $objOneFile) {
             if ($objOneFile->getIntType() == class_module_mediamanager_file::$INT_TYPE_FILE) {
                 //filename based check if the file should be included
                 if ($strNameFilter !== false) {
                     if (uniStrpos($strNameFilter, ",") !== false) {
                         if (in_array($objOneFile->getStrName(), explode(",", $strNameFilter))) {
                             $arrReturn[] = $objOneFile;
                         }
                     } else {
                         if (uniSubstr($objOneFile->getStrName(), 0, uniStrlen($strNameFilter)) == $strNameFilter) {
                             $arrReturn[] = $objOneFile;
                         }
                     }
                 } else {
                     $arrReturn[] = $objOneFile;
                 }
             } else {
                 $arrReturn = array_merge($arrReturn, $this->getAllPackages($objOneFile->getSystemid()));
             }
         }
         if ($intStart !== null && $intEnd !== null && $intStart > 0 && $intEnd > $intStart) {
             if ($intEnd > count($arrReturn)) {
                 $intEnd = count($arrReturn);
             }
             $arrTemp = array();
             for ($intI = $intStart; $intI <= $intEnd; $intI++) {
                 $arrTemp[] = $arrReturn[$intI];
             }
             $arrReturn = $arrTemp;
         }
         //sort them by filename
         usort($arrReturn, function (class_module_mediamanager_file $objA, class_module_mediamanager_file $objB) {
             return strcmp($objA->getStrName(), $objB->getStrName());
         });
     } else {
         $arrReturn = class_module_mediamanager_file::getFlatPackageList($strCategoryFilter, true, $intStart, $intEnd, $strNameFilter);
     }
     return $arrReturn;
 }