3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.4 |
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2013 |
7 +--------------------------------------------------------------------+
8 | This file is a part of CiviCRM. |
10 | CiviCRM is free software; you can copy, modify, and distribute it |
11 | under the terms of the GNU Affero General Public License |
12 | Version 3, 19 November 2007 and the CiviCRM Licensing Exception. |
14 | CiviCRM is distributed in the hope that it will be useful, but |
15 | WITHOUT ANY WARRANTY; without even the implied warranty of |
16 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |
17 | See the GNU Affero General Public License for more details. |
19 | You should have received a copy of the GNU Affero General Public |
20 | License and the CiviCRM Licensing Exception along |
21 | with this program; if not, contact CiviCRM LLC |
22 | at info[AT]civicrm[DOT]org. If you have questions about the |
23 | GNU Affero General Public License or the licensing of CiviCRM, |
24 | see the CiviCRM license FAQ at http://civicrm.org/licensing |
25 +--------------------------------------------------------------------+
31 * @copyright CiviCRM LLC (c) 2004-2013
37 * BAO object for civicrm_setting table. This table is used to store civicrm settings that are not used
38 * very frequently (i.e. not on every page load)
40 * The group column is used for grouping together all settings that logically belong to the same set.
41 * Thus all settings in the same group are retrieved with one DB call and then cached for future needs.
44 class CRM_Core_BAO_Setting
extends CRM_Core_DAO_Setting
{
47 * various predefined settings that have been migrated to the setting table
50 ADDRESS_STANDARDIZATION_PREFERENCES_NAME
= 'Address Standardization Preferences',
51 CAMPAIGN_PREFERENCES_NAME
= 'Campaign Preferences',
52 DIRECTORY_PREFERENCES_NAME
= 'Directory Preferences',
53 EVENT_PREFERENCES_NAME
= 'Event Preferences',
54 MAILING_PREFERENCES_NAME
= 'Mailing Preferences',
55 CONTRIBUTE_PREFERENCES_NAME
= 'Contribute Preferences',
56 MEMBER_PREFERENCES_NAME
= 'Member Preferences',
57 MULTISITE_PREFERENCES_NAME
= 'Multi Site Preferences',
58 PERSONAL_PREFERENCES_NAME
= 'Personal Preferences',
59 SYSTEM_PREFERENCES_NAME
= 'CiviCRM Preferences',
60 URL_PREFERENCES_NAME
= 'URL Preferences',
61 LOCALIZATION_PREFERENCES_NAME
= 'Localization Preferences',
62 SEARCH_PREFERENCES_NAME
= 'Search Preferences';
63 static $_cache = NULL;
66 * Checks whether an item is present in the in-memory cache table
68 * @param string $group (required) The group name of the item
69 * @param string $name (required) The name of the setting
70 * @param int $componentID The optional component ID (so componenets can share the same name space)
71 * @param int $contactID If set, this is a contactID specific setting, else its a global setting
72 * @param int $load if true, load from local cache (typically memcache)
74 * @return boolean true if item is already in cache
78 static function inCache(
87 if (!isset(self
::$_cache)) {
88 self
::$_cache = array();
91 $cacheKey = "CRM_Setting_{$group}_{$componentID}_{$contactID}_{$domainID}";
95 ($force ||
!isset(self
::$_cache[$cacheKey]))
98 // check in civi cache if present (typically memcache)
99 $globalCache = CRM_Utils_Cache
::singleton();
100 $result = $globalCache->get($cacheKey);
103 self
::$_cache[$cacheKey] = $result;
107 return isset(self
::$_cache[$cacheKey]) ?
$cacheKey : NULL;
110 * Allow key o be cleared
111 * @param string $cacheKey
113 static function flushCache($cacheKey){
114 unset(self
::$_cache[$cacheKey]);
115 $globalCache = CRM_Utils_Cache
::singleton();
116 $globalCache->delete($cacheKey);
119 static function setCache($values,
125 if (!isset(self
::$_cache)) {
126 self
::$_cache = array();
129 $cacheKey = "CRM_Setting_{$group}_{$componentID}_{$contactID}_{$domainID}";
131 self
::$_cache[$cacheKey] = $values;
133 $globalCache = CRM_Utils_Cache
::singleton();
134 $result = $globalCache->set($cacheKey, $values);
139 static function dao($group,
145 if (self
::isUpgradeFromPreFourOneAlpha1()) {
146 // civicrm_setting table is not going to be present. For now we'll just
147 // return a dummy object
148 $dao = new CRM_Core_DAO_Domain();
149 $dao->id
= -1; // so ->find() doesn't fetch any data later on
152 $dao = new CRM_Core_DAO_Setting();
154 $dao->group_name
= $group;
156 $dao->component_id
= $componentID;
157 if (empty($domainID)) {
158 $dao->domain_id
= CRM_Core_Config
::domainID();
161 $dao->domain_id
= $domainID;
165 $dao->contact_id
= $contactID;
176 * Retrieve the value of a setting from the DB table
178 * @param string $group (required) The group name of the item
179 * @param string $name (required) The name under which this item is stored
180 * @param int $componentID The optional component ID (so componenets can share the same name space)
181 * @param string $defaultValue The default value to return for this setting if not present in DB
182 * @param int $contactID If set, this is a contactID specific setting, else its a global setting
185 * @return object The data if present in the setting table, else null
189 static function getItem(
193 $defaultValue = NULL,
198 if (NULL !== ($override = self
::getOverride($group, $name, NULL))) {
202 if (empty($domainID)) {
203 $domainID = CRM_Core_Config
::domainID();
205 $cacheKey = self
::inCache($group, $name, $componentID, $contactID, TRUE, $domainID);
207 $dao = self
::dao($group, NULL, $componentID, $contactID, $domainID);
211 while ($dao->fetch()) {
212 if (NULL !== ($override = self
::getOverride($group, $dao->name
, NULL))) {
213 $values[$dao->name
] = $override;
215 elseif ($dao->value
) {
216 $values[$dao->name
] = unserialize($dao->value
);
219 $values[$dao->name
] = NULL;
224 $cacheKey = self
::setCache($values, $group, $componentID, $contactID, $domainID);
226 return $name ? CRM_Utils_Array
::value($name, self
::$_cache[$cacheKey], $defaultValue) : self
::$_cache[$cacheKey];
230 * Store multiple items in the setting table
232 * @param array $params (required) An api formatted array of keys and values
233 * @domains array an array of domains to get settings for. Default is the current domain
238 static function getItems(&$params, $domains = NULL, $settingsToReturn) {
239 $originalDomain = CRM_Core_Config
::domainID();
240 if (empty($domains)) {
241 $domains[] = $originalDomain;
243 if (!empty($settingsToReturn) && !is_array($settingsToReturn)) {
244 $settingsToReturn = array($settingsToReturn);
246 $reloadConfig = FALSE;
248 $fields = $result = array();
249 $fieldsToGet = self
::validateSettingsInput(array_flip($settingsToReturn), $fields, FALSE);
250 foreach ($domains as $domainID) {
251 if($domainID != CRM_Core_Config
::domainID()){
252 $reloadConfig = TRUE;
253 CRM_Core_BAO_Domain
::setDomain($domainID);
255 $config = CRM_Core_Config
::singleton($reloadConfig, $reloadConfig);
256 $result[$domainID] = array();
257 foreach ($fieldsToGet as $name => $value) {
258 if(!empty($fields['values'][$name]['prefetch'])){
259 if(isset($params['filters']) && isset($params['filters']['prefetch'])
260 && $params['filters']['prefetch'] == 0){
261 // we are filtering out the prefetches from the return array
265 $configKey = CRM_Utils_Array
::value('config_key', $fields['values'][$name], $name);
266 if(isset($config->$configKey)){
267 $setting = $config->$configKey;
272 CRM_Core_BAO_Setting
::getItem(
273 $fields['values'][$name]['group_name'],
275 CRM_Utils_Array
::value('component_id', $params),
277 CRM_Utils_Array
::value('contact_id', $params),
281 if (!is_null($setting)) {
282 // we won't return if not set - helps in return all scenario - otherwise we can't indentify the missing ones
283 // e.g for revert of fill actions
284 $result[$domainID][$name] = $setting;
287 CRM_Core_BAO_Domain
::resetDomain();
293 * Store an item in the setting table
295 * _setItem() is the common logic shared by setItem() and setItems().
297 * @param object $value (required) The value that will be serialized and stored
298 * @param string $group (required) The group name of the item
299 * @param string $name (required) The name of the setting
300 * @param int $componentID The optional component ID (so componenets can share the same name space)
301 * @param int $createdID An optional ID to assign the creator to. If not set, retrieved from session
307 static function setItem(
317 $fieldsToSet = self
::validateSettingsInput(array($name => $value), $fields);
318 //We haven't traditionally validated inputs to setItem, so this breaks things.
319 //foreach ($fieldsToSet as $settingField => &$settingValue) {
320 // self::validateSetting($settingValue, $fields['values'][$settingField]);
323 return self
::_setItem($fields['values'][$name], $value, $group, $name, $componentID, $contactID, $createdID, $domainID);
327 * Store an item in a setting table
329 * _setItem() is the common logic shared by setItem() and setItems().
331 * @param array $metadata metadata describing this field
335 * @param null $componentID
336 * @param null $contactID
337 * @param null $createdID
338 * @param null $domainID
340 static function _setItem(
350 if (empty($domainID)) {
351 $domainID = CRM_Core_Config
::domainID();
354 $dao = self
::dao($group, $name, $componentID, $contactID, $domainID);
357 if (isset($metadata['on_change'])) {
358 foreach ($metadata['on_change'] as $callback) {
359 call_user_func($callback, unserialize($dao->value
), $value, $metadata);
363 if (CRM_Utils_System
::isNull($value)) {
364 $dao->value
= 'null';
367 $dao->value
= serialize($value);
370 $dao->created_date
= date('Ymdhis');
373 $dao->created_id
= $createdID;
376 $session = CRM_Core_Session
::singleton();
377 $createdID = $session->get('userID');
380 // ensure that this is a valid contact id (for session inconsistency rules)
381 $cid = CRM_Core_DAO
::getFieldValue('CRM_Contact_DAO_Contact',
387 $dao->created_id
= $session->get('userID');
395 // also save in cache if needed
396 $cacheKey = self
::inCache($group, $name, $componentID, $contactID, FALSE, $domainID);
398 self
::$_cache[$cacheKey][$name] = $value;
403 * Store multiple items in the setting table. Note that this will also store config keys
404 * the storage is determined by the metdata and is affected by
405 * 'name' setting's name
406 * 'prefetch' = store in config
407 * 'config_only' = don't store in settings
408 * 'config_key' = the config key is different to the settings key - e.g. debug where there was a conflict
409 * 'legacy_key' = rename from config or setting with this name
411 * _setItem() is the common logic shared by setItem() and setItems().
413 * @param array $params (required) An api formatted array of keys and values
414 * @domains array an array of domains to get settings for. Default is the current domain
419 static function setItems(&$params, $domains = NULL) {
420 $originalDomain = CRM_Core_Config
::domainID();
421 if (empty($domains)) {
422 $domains[] = $originalDomain;
424 $reloadConfig = FALSE;
425 $fields = $config_keys = array();
426 $fieldsToSet = self
::validateSettingsInput($params, $fields);
428 foreach ($fieldsToSet as $settingField => &$settingValue) {
429 self
::validateSetting($settingValue, $fields['values'][$settingField]);
432 foreach ($domains as $domainID) {
433 if($domainID != CRM_Core_Config
::domainID()){
434 $reloadConfig = TRUE;
435 CRM_Core_BAO_Domain
::setDomain($domainID);
437 $result[$domainID] = array();
438 foreach ($fieldsToSet as $name => $value) {
439 if(empty($fields['values'][$name]['config_only'])){
440 CRM_Core_BAO_Setting
::_setItem(
441 $fields['values'][$name],
443 $fields['values'][$name]['group_name'],
445 CRM_Utils_Array
::value('component_id', $params),
446 CRM_Utils_Array
::value('contact_id', $params),
447 CRM_Utils_Array
::value('created_id', $params),
451 if(!empty($fields['values'][$name]['prefetch'])){
452 if(!empty($fields['values'][$name]['config_key'])){
453 $name = $fields['values'][$name]['config_key'];
455 $config_keys[$name] = $value;
457 $result[$domainID][$name] = $value;
460 CRM_Core_Config
::singleton($reloadConfig, $reloadConfig);
463 if(!empty($config_keys)){
464 CRM_Core_BAO_ConfigSetting
::create($config_keys);
467 CRM_Core_BAO_Domain
::resetDomain();
475 * gets metadata about the settings fields (from getfields) based on the fields being passed in
477 * This function filters on the fields like 'version' & 'debug' that are not settings
478 * @param array $params Parameters as passed into API
479 * @param array $fields empty array to be populated with fields metadata
480 * @param bool $createMode
482 * @return array $fieldstoset name => value array of the fields to be set (with extraneous removed)
484 static function validateSettingsInput($params, &$fields, $createMode = TRUE) {
485 $group = CRM_Utils_Array
::value('group', $params);
487 $ignoredParams = array(
504 $settingParams = array_diff_key($params, array_fill_keys($ignoredParams, TRUE));
505 $getFieldsParams = array('version' => 3);
506 if (count($settingParams) ==1) {
507 // ie we are only setting one field - we'll pass it into getfields for efficiency
508 list($name) = array_keys($settingParams);
509 $getFieldsParams['name'] = $name;
511 $fields = civicrm_api('setting','getfields', $getFieldsParams);
512 $invalidParams = (array_diff_key($settingParams, $fields['values']));
513 if (!empty($invalidParams)) {
514 throw new api_Exception(implode(',', $invalidParams) . " not valid settings");
516 if (!empty($settingParams)) {
517 $filteredFields = array_intersect_key($settingParams, $fields['values']);
520 // no filters so we are interested in all for get mode. In create mode this means nothing to set
521 $filteredFields = $createMode ?
array() : $fields['values'];
523 return $filteredFields;
527 * Validate & convert settings input
529 * @value mixed value of the setting to be set
530 * @fieldSpec array Metadata for given field (drawn from the xml)
532 static function validateSetting(&$value, $fieldSpec) {
533 if($fieldSpec['type'] == 'String' && is_array($value)){
534 $value = CRM_Core_DAO
::VALUE_SEPARATOR
. implode(CRM_Core_DAO
::VALUE_SEPARATOR
,$value) . CRM_Core_DAO
::VALUE_SEPARATOR
;
536 if (empty($fieldSpec['validate_callback'])) {
540 list($class,$fn) = explode('::',$fieldSpec['validate_callback']);
541 if (!$class::$fn($value,$fieldSpec)) {
542 throw new api_Exception("validation failed for {$fieldSpec['name']} = $value based on callback {$fieldSpec['validate_callback']}");
548 * Validate & convert settings input - translate True False to 0 or 1
550 * @value mixed value of the setting to be set
551 * @fieldSpec array Metadata for given field (drawn from the xml)
553 static function validateBoolSetting(&$value, $fieldSpec) {
554 if (!CRM_Utils_Rule
::boolean($value)) {
555 throw new api_Exception("Boolean value required for {$fieldSpec['name']}");
567 * Delete some or all of the items in the settings table
569 * @param string $group The group name of the entries to be deleted
570 * @param string $name The name of the setting to be deleted
571 * @param int $componentID The optional component ID (so componenets can share the same name space)
577 static function deleteItem($group, $name = NULL, $componentID = NULL, $contactID = NULL) {
578 $dao = self::dao($group, $name, $componentID, $contactID);
581 // also reset memory cache if any
582 CRM_Utils_System::flushCache();
584 $cacheKey = self::inCache($group, $name, $componentID, $contactID, FALSE);
587 unset(self::$_cache[$cacheKey][$name]);
590 unset(self::$_cache[$cacheKey]);
596 * This provides information about the setting - similar to the fields concept for DAO information.
597 * As the setting is serialized code creating validation setting input needs to know the data type
598 * This also helps move information out of the form layer into the data layer where people can interact with
599 * it via the API or other mechanisms. In order to keep this consistent it is important the form layer
602 * Note that this function should never be called when using the runtime getvalue function. Caching works
603 * around the expectation it will be called during setting administration
605 * Function is intended for configuration rather than runtime access to settings
607 * The following params will filter the result. If none are passed all settings will be returns
609 * @params string $name Name of specific setting e.g customCSSURL
610 * @params integer $componentID id of relevant component.
612 * @return array $result - the following information as appropriate for each setting
616 * - add (CiviCRM version added)
622 static function getSettingSpecification(
628 $cacheString = 'settingsMetadata_' . $domainID . '_' . $profile;
629 foreach ($filters as $filterField => $filterString) {
630 $cacheString .= "_{$filterField}_{$filterString}";
633 $settingsMetadata = CRM_Core_BAO_Cache
::getItem('CiviCRM setting Specs', $cacheString, $componentID);
634 if ($settingsMetadata === NULL) {
635 $settingsMetadata = CRM_Core_BAO_Cache
::getItem('CiviCRM setting Spec', 'All', $componentID);
636 if (empty($settingsMetadata)) {
637 $settingsMetadata = array();
638 global $civicrm_root;
639 $metaDataFolders = array($civicrm_root. '/settings');
640 CRM_Utils_Hook
::alterSettingsFolders($metaDataFolders);
641 foreach ($metaDataFolders as $metaDataFolder) {
642 $settingsMetadata = $settingsMetadata + self
::loadSettingsMetaData($metaDataFolder);
644 CRM_Core_BAO_Cache
::setItem($settingsMetadata,'CiviCRM setting Spec', 'All', $componentID);
649 $hookCacheString = CRM_Utils_Hook
::alterSettingsMetaData($settingsMetadata, $domainID, $profile);
650 self
::_filterSettingsSpecification($filters, $settingsMetadata);
651 if(!$cached ||
!empty($hookCacheString)){
652 // this is a bit 'heavy' if you are using hooks but this function is expected to only be called during setting administration
653 // it should not be called by 'getvalue' or 'getitem
654 CRM_Core_BAO_Cache
::setItem($settingsMetadata,'CiviCRM setting Specs', $cacheString . $hookCacheString, $componentID);
656 return $settingsMetadata;
661 * Load up settings metadata from files
663 static function loadSettingsMetadata($metaDataFolder) {
664 $settingMetaData = array();
665 $settingsFiles = CRM_Utils_File
::findFiles($metaDataFolder, '*.setting.php');
666 foreach ($settingsFiles as $file) {
667 $settings = include $file;
668 $settingMetaData = array_merge($settingMetaData, $settings);
670 CRM_Core_BAO_Cache
::setItem($settingMetaData,'CiviCRM setting Spec', 'All');
671 return $settingMetaData;
675 * Filter the settings metadata according to filters passed in. This is a convenience filter
676 * and allows selective reverting / filling of settings
678 * @param array $filters Filters to match against data
679 * @param array $settingSpec metadata to filter
681 static function _filterSettingsSpecification($filters, &$settingSpec) {
682 if (empty($filters)) {
685 else if (array_keys($filters) == array('name')) {
686 $settingSpec = array($filters['name'] => $settingSpec[$filters['name']]);
690 foreach ($settingSpec as $field => $fieldValues) {
691 if (array_intersect_assoc($fieldValues, $filters) != $filters) {
692 unset($settingSpec[$field]);
700 * Look for any missing settings and convert them from config or load default as appropriate
701 * This should be run from GenCode & also from upgrades to add any new defaults.
703 * Multisites have often been overlooked in upgrade scripts so can be expected to be missing
704 * a number of settings
706 static function updateSettingsFromMetaData() {
709 'domain_id' => 'all',
710 'filters' => array('prefetch' => 0),
712 $existing = civicrm_api('setting', 'get', $apiParams);
714 if (!empty($existing['values'])) {
715 $allSettings = civicrm_api('setting', 'getfields', array('version' => 3));
716 foreach ($existing['values'] as $domainID => $domainSettings) {
717 CRM_Core_BAO_Domain
::setDomain($domainID);
718 $missing = array_diff_key($allSettings['values'], $domainSettings);
719 foreach ($missing as $name => $settings) {
720 self
::convertConfigToSetting($name, $domainID);
722 CRM_Core_BAO_Domain
::resetDomain();
728 * move an item from being in the config array to being stored as a setting
729 * remove from config - as appropriate based on metadata
731 * Note that where the key name is being changed the 'legacy_key' will give us the old name
733 static function convertConfigToSetting($name, $domainID = NULL) {
734 // we have to force this here in case more than one domain is in play.
735 // whenever there is a possibility of more than one domain we must force it
736 $config = CRM_Core_Config
::singleton();
737 if (empty($domainID)) {
738 $domainID= CRM_Core_Config
::domainID();
740 $domain = new CRM_Core_DAO_Domain();
741 $domain->id
= $domainID;
743 if ($domain->config_backend
) {
744 $values = unserialize($domain->config_backend
);
748 $spec = self
::getSettingSpecification(NULL, array('name' => $name), $domainID);
749 $configKey = CRM_Utils_Array
::value('config_key', $spec[$name], CRM_Utils_Array
::value('legacy_key', $spec[$name], $name));
750 //if the key is set to config_only we don't need to do anything
751 if(empty($spec[$name]['config_only'])){
752 if (!empty($values[$configKey])) {
753 civicrm_api('setting', 'create', array('version' => 3, $name => $values[$configKey], 'domain_id' => $domainID));
756 civicrm_api('setting', 'fill', array('version' => 3, 'name' => $name, 'domain_id' => $domainID));
759 if (empty($spec[$name]['prefetch']) && !empty($values[$configKey])) {
760 unset($values[$configKey]);
761 $domain->config_backend
= serialize($values);
763 unset($config->$configKey);
768 static function valueOptions($group,
773 $returnField = 'name',
774 $returnNameANDLabels = FALSE,
777 $optionValue = self
::getItem($group, $name);
779 $groupValues = CRM_Core_OptionGroup
::values($name, FALSE, FALSE, $localize, $condition, $returnField);
781 //enabled name => label require for new contact edit form, CRM-4605
782 if ($returnNameANDLabels) {
783 $names = $labels = $nameAndLabels = array();
784 if ($returnField == 'name') {
785 $names = $groupValues;
786 $labels = CRM_Core_OptionGroup
::values($name, FALSE, FALSE, $localize, $condition, 'label');
789 $labels = $groupValues;
790 $names = CRM_Core_OptionGroup
::values($name, FALSE, FALSE, $localize, $condition, 'name');
794 $returnValues = array();
795 foreach ($groupValues as $gn => $gv) {
796 $returnValues[$gv] = 0;
799 if ($optionValue && !empty($groupValues)) {
800 $dbValues = explode(CRM_Core_DAO
::VALUE_SEPARATOR
,
801 substr($optionValue, 1, -1)
804 if (!empty($dbValues)) {
805 foreach ($groupValues as $key => $val) {
806 if (in_array($key, $dbValues)) {
807 $returnValues[$val] = 1;
808 if ($returnNameANDLabels) {
809 $nameAndLabels[$names[$key]] = $labels[$key];
815 return ($returnNameANDLabels) ?
$nameAndLabels : $returnValues;
818 static function setValueOption($group,
828 elseif (is_array($value)) {
829 $groupValues = CRM_Core_OptionGroup
::values($name, FALSE, FALSE, FALSE, NULL, $keyField);
832 foreach ($groupValues as $key => $val) {
833 if (CRM_Utils_Array
::value($val, $value)) {
838 if (!empty($cbValues)) {
839 $optionValue = CRM_Core_DAO
::VALUE_SEPARATOR
. implode(CRM_Core_DAO
::VALUE_SEPARATOR
,
840 array_keys($cbValues)
841 ) . CRM_Core_DAO
::VALUE_SEPARATOR
;
848 $optionValue = $value;
851 self
::setItem($optionValue, $group, $name);
854 static function fixAndStoreDirAndURL(&$params, $domainID = NULL) {
855 if (self
::isUpgradeFromPreFourOneAlpha1()) {
859 if (empty($domainID)) {
860 $domainID = CRM_Core_Config
::domainID();
863 SELECT name, group_name
866 AND ( group_name = %2
870 1 => array($domainID, 'Integer'),
871 2 => array(self
::DIRECTORY_PREFERENCES_NAME
, 'String'),
872 3 => array(self
::URL_PREFERENCES_NAME
, 'String'),
875 $dirParams = array();
876 $urlParams = array();
878 $dao = CRM_Core_DAO
::executeQuery($sql,
884 // trap exceptions as error
888 if (is_a($dao, 'DB_Error')) {
889 if (CRM_Core_Config
::isUpgradeMode()) {
890 // seems like this is a 4.0 -> 4.1 upgrade, so we suppress this error and continue
894 echo "Fatal DB error, exiting, seems like your schema does not have civicrm_setting table\n";
899 while ($dao->fetch()) {
900 if (!isset($params[$dao->name
])) {
903 if ($dao->group_name
== self
::DIRECTORY_PREFERENCES_NAME
) {
904 $dirParams[$dao->name
] = CRM_Utils_Array
::value($dao->name
, $params, '');
907 $urlParams[$dao->name
] = CRM_Utils_Array
::value($dao->name
, $params, '');
909 unset($params[$dao->name
]);
912 if (!empty($dirParams)) {
913 self
::storeDirectoryOrURLPreferences($dirParams,
914 self
::DIRECTORY_PREFERENCES_NAME
918 if (!empty($urlParams)) {
919 self
::storeDirectoryOrURLPreferences($urlParams,
920 self
::URL_PREFERENCES_NAME
925 static function storeDirectoryOrURLPreferences(&$params, $group) {
926 foreach ($params as $name => $value) {
927 // always try to store relative directory or url from CMS root
928 $value = ($group == self
::DIRECTORY_PREFERENCES_NAME
) ? CRM_Utils_File
::relativeDirectory($value) : CRM_Utils_System
::relativeURL($value);
930 self
::setItem($value, $group, $name);
934 static function retrieveDirectoryAndURLPreferences(&$params, $setInConfig = FALSE) {
935 if (CRM_Core_Config
::isUpgradeMode()) {
936 $isJoomla = (defined('CIVICRM_UF') && CIVICRM_UF
== 'Joomla') ?
TRUE : FALSE;
937 // hack to set the resource base url so that js/ css etc is loaded correctly
939 $params['userFrameworkResourceURL'] = CRM_Utils_File
::addTrailingSlash(CIVICRM_UF_BASEURL
, '/') . str_replace('administrator', '', CRM_Core_DAO
::getFieldValue('CRM_Core_DAO_OptionValue', 'userFrameworkResourceURL', 'value', 'name'));
941 if (self
::isUpgradeFromPreFourOneAlpha1()) {
947 $config = CRM_Core_Config
::singleton();
951 SELECT name, group_name, value
953 WHERE ( group_name = %1
957 $sqlParams = array(1 => array(self
::DIRECTORY_PREFERENCES_NAME
, 'String'),
958 2 => array(self
::URL_PREFERENCES_NAME
, 'String'),
959 3 => array(CRM_Core_Config
::domainID(), 'Integer'),
962 $dao = CRM_Core_DAO
::executeQuery($sql,
968 // trap exceptions as error
972 if (is_a($dao, 'DB_Error')) {
973 echo "Fatal DB error, exiting, seems like your schema does not have civicrm_setting table\n";
977 while ($dao->fetch()) {
978 $value = self
::getOverride($dao->group_name
, $dao->name
, NULL);
979 if ($value === NULL && $dao->value
) {
980 $value = unserialize($dao->value
);
981 if ($dao->group_name
== self
::DIRECTORY_PREFERENCES_NAME
) {
982 $value = CRM_Utils_File
::absoluteDirectory($value);
985 // CRM-7622: we need to remove the language part
986 $value = CRM_Utils_System
::absoluteURL($value, TRUE);
989 // CRM-10931, If DB doesn't have any value, carry on with any default value thats already available
990 if (!isset($value) && CRM_Utils_Array
::value($dao->name
, $params)) {
991 $value = $params[$dao->name
];
993 $params[$dao->name
] = $value;
996 $config->{$dao->name
} = $value;
1002 * Determine what, if any, overrides have been provided
1005 * @return mixed, NULL or an overriden value
1007 protected static function getOverride($group, $name, $default) {
1008 global $civicrm_setting;
1009 if ($group && $name && isset($civicrm_setting[$group][$name])) {
1010 return $civicrm_setting[$group][$name];
1018 * civicrm_setting didn't exist before 4.1.alpha1 and this function helps taking decisions during upgrade
1022 static function isUpgradeFromPreFourOneAlpha1() {
1023 if (CRM_Core_Config
::isUpgradeMode()) {
1024 $currentVer = CRM_Core_BAO_Domain
::version();
1025 if (version_compare($currentVer, '4.1.alpha1') < 0) {