fatalErrorTemplate) && $config->fatalErrorTemplate != 'CRM/common/fatal.tpl') { $preUpgradeMessage .= '
' . ts('The custom fatal error template setting will be removed during the upgrade. You are currently using this custom template: %1 . Following the upgrade you will need to use the standard approach to overriding template files, as described in the documentation.', array(1 => $config->fatalErrorTemplate)) . '
'; } } if ($rev == '4.7.alpha4') { // CRM-17004 Warn of Moneris removal $count = 1; // Query only works in 4.3+ if (version_compare($currentVer, "4.3.0") > 0) { $count = CRM_Core_DAO::singleValueQuery("SELECT COUNT(id) FROM civicrm_payment_processor WHERE payment_processor_type_id IN (SELECT id FROM civicrm_payment_processor_type WHERE name = 'Moneris')"); } if ($count && !function_exists('moneris_civicrm_managed')) { $preUpgradeMessage .= '' . ts('The %1 payment processor is no longer bundled with CiviCRM. After upgrading you will need to install the extension to continue using it.', array(1 => 'Moneris')) . '
'; } } } /** * Compute any messages which should be displayed after upgrade. * * @param string $postUpgradeMessage * alterable. * @param string $rev * an intermediate version; note that setPostUpgradeMessage is called repeatedly with different $revs. */ public function setPostUpgradeMessage(&$postUpgradeMessage, $rev) { if ($rev == '4.7.alpha1') { $config = CRM_Core_Config::singleton(); // FIXME: Performing an upgrade step during postUpgrade message phase is probably bad $editor_id = self::updateWysiwyg(); $msg = NULL; $ext_href = 'href="' . CRM_Utils_System::url('civicrm/admin/extensions', 'reset=1') . '"'; $dsp_href = 'href="' . CRM_Utils_System::url('civicrm/admin/setting/preferences/display', 'reset=1') . '"'; $blog_href = 'href="https://civicrm.org/blogs/colemanw/big-changes-wysiwyg-editing-47"'; switch ($editor_id) { // TinyMCE case 1: $msg = ts('Your configured editor "TinyMCE" is no longer part of the main CiviCRM download. To continue using it, visit the Manage Extensions page to download and install the TinyMCE extension.', array(1 => $ext_href)); break; // Drupal/Joomla editor case 3: case 4: $msg = ts('CiviCRM no longer integrates with the "%1 Default Editor." Your wysiwyg setting has been reset to the built-in CKEditor. Learn more...', array(1 => $config->userFramework, 2 => $blog_href)); break; } if ($msg) { $postUpgradeMessage .= '' . $msg . '
'; } $postUpgradeMessage .= '' . ts('CiviCRM now includes the easy-to-use CKEditor Configurator. To customize the features and display of your wysiwyg editor, visit the Display Preferences page. Learn more...', array(1 => $dsp_href, 2 => $blog_href)) . '
'; $postUpgradeMessage .= '' . ts('The custom fatal error template setting has been removed.') . '
'; } } /** * Upgrade function. * * @param string $rev */ public function upgrade_4_7_alpha1($rev) { $this->addTask('Migrate \'on behalf of\' information to module_data', 'migrateOnBehalfOfInfo'); $this->addTask(ts('Upgrade DB to %1: SQL', array(1 => $rev)), 'runSql', $rev); $this->addTask(ts('Migrate Settings to %1', array(1 => $rev)), 'migrateSettings', $rev); $this->addTask('Add Getting Started dashlet', 'addGettingStartedDashlet', $rev); } /** * Upgrade function. * * @param string $rev */ public function upgrade_4_7_alpha4($rev) { $this->addTask(ts('Upgrade DB to %1: SQL', array(1 => $rev)), 'runSql', $rev); $this->addTask(ts('Remove %1', array(1 => 'Moneris')), 'removePaymentProcessorType', 'Moneris'); $this->addTask('Update Smart Groups', 'fixContactTypeInSmartGroups'); } /** * Upgrade function. * * @param string $rev */ public function upgrade_4_7_beta2($rev) { $this->addTask(ts('Upgrade DB to %1: SQL', array(1 => $rev)), 'runSql', $rev); $this->addTask('Delete unused file', 'deleteVersionCheckCacheFile'); } /** * Upgrade function. * * @param string $rev */ public function upgrade_4_7_beta6($rev) { $this->addTask(ts('Upgrade DB to %1: SQL', array(1 => $rev)), 'runSql', $rev); $this->addTask('Disable flexible jobs extension', 'disableFlexibleJobsExtension'); $this->addTask('Add Index to financial_trxn trxn_id field', 'addIndexFinancialTrxnTrxnID'); } /** * Upgrade function. * * @param string $rev */ public function upgrade_4_7_1($rev) { $this->addTask(ts('Upgrade DB to %1: SQL', array(1 => $rev)), 'runSql', $rev); $this->addTask('Add Index to civicrm_contribution creditnote_id field', 'addIndexContributionCreditNoteID'); } /** * Upgrade function. * * @param string $rev */ public function upgrade_4_7_2($rev) { $this->addTask(ts('Upgrade DB to %1: SQL', array(1 => $rev)), 'runSql', $rev); $this->addTask('Fix Index on civicrm_financial_item combined entity_id + entity_table', 'addCombinedIndexFinancialItemEntityIDEntityType'); $this->addTask('enable financial account relationships for chargeback & refund', 'addRefundAndChargeBackAccountsIfNotExist'); $this->addTask('Add Index to civicrm_contribution.source', 'addIndexContributionSource'); } /** * Upgrade function. * * @param string $rev */ public function upgrade_4_7_3($rev) { $this->addTask(ts('Upgrade DB to %1: SQL', array(1 => $rev)), 'runSql', $rev); $this->addTask('Add Index to civicrm_contribution.total_amount', 'addIndexContributionAmount'); } /** * Upgrade function. * * @param string $rev */ public function upgrade_4_7_4($rev) { $this->addTask(ts('Upgrade DB to %1: SQL', array(1 => $rev)), 'runSql', $rev); $this->addTask('Add Contact Deleted by Merge Activity Type', 'addDeletedByMergeActivityType'); } /** * Upgrade function. * * @param string $rev */ public function upgrade_4_7_7($rev) { $this->addTask(ts('Upgrade DB to %1: SQL', array(1 => $rev)), 'runSql', $rev); // https://issues.civicrm.org/jira/browse/CRM-18006 if (CRM_Core_DAO::checkTableExists('civicrm_install_canary')) { CRM_Core_DAO::executeQuery('ALTER TABLE civicrm_install_canary ENGINE=InnoDB'); } } /** * Upgrade function. * * @param string $rev */ public function upgrade_4_7_8($rev) { $this->addTask(ts('Upgrade DB to %1: SQL', array(1 => $rev)), 'runSql', $rev); $this->addTask('Upgrade mailing foreign key constraints', 'upgradeMailingFKs'); } /* * Important! All upgrade functions MUST call the 'runSql' task. * Uncomment and use the following template for a new upgrade version * (change the x in the function name): */ // /** // * Upgrade function. // * // * @param string $rev // */ // public function upgrade_4_7_x($rev) { // $this->addTask(ts('Upgrade DB to %1: SQL', array(1 => $rev)), 'runSql', $rev); // // Additional tasks here... // } /** * CRM-16354 * * @return int */ public static function updateWysiwyg() { $editorID = Civi::settings()->get('editor_id'); // Previously a numeric value indicated one of 4 wysiwyg editors shipped in core, and no value indicated 'Textarea' // Now the options are "Textarea", "CKEditor", and the rest have been dropped from core. $newEditor = $editorID ? "CKEditor" : "Textarea"; Civi::settings()->set('editor_id', $newEditor); return $editorID; } /** * Migrate any last remaining options from `civicrm_domain.config_backend` to `civicrm_setting`. * Cleanup setting schema. * * @param CRM_Queue_TaskContext $ctx * @return bool */ public function migrateSettings(CRM_Queue_TaskContext $ctx) { // Tip: If there are problems with adding the new uniqueness index, try inspecting: // SELECT name, domain_id, contact_id, count(*) AS dupes FROM civicrm_setting cs GROUP BY name, domain_id, contact_id HAVING dupes > 1; // Nav records are expendable. https://forum.civicrm.org/index.php?topic=36933.0 CRM_Core_DAO::executeQuery('DELETE FROM civicrm_setting WHERE contact_id IS NOT NULL AND name = "navigation"'); CRM_Core_DAO::executeQuery('ALTER TABLE civicrm_setting DROP INDEX index_group_name'); CRM_Core_DAO::executeQuery('ALTER TABLE civicrm_setting DROP COLUMN group_name'); // Handle Strange activity_tab_filter settings. CRM_Core_DAO::executeQuery('CREATE TABLE civicrm_activity_setting LIKE civicrm_setting'); CRM_Core_DAO::executeQuery('ALTER TABLE civicrm_activity_setting ADD UNIQUE INDEX index_domain_contact_name (domain_id, contact_id, name)'); CRM_Core_DAO::executeQuery('INSERT INTO civicrm_activity_setting (name, contact_id, domain_id, value) SELECT DISTINCT name, contact_id, domain_id, value FROM civicrm_setting WHERE name = "activity_tab_filter" AND value is not NULL'); CRM_Core_DAO::executeQuery('DELETE FROM civicrm_setting WHERE name = "activity_tab_filter"'); $date = CRM_Utils_Time::getTime('Y-m-d H:i:s'); CRM_Core_DAO::executeQuery('ALTER TABLE civicrm_setting ADD UNIQUE INDEX index_domain_contact_name (domain_id, contact_id, name)'); CRM_Core_DAO::executeQuery("INSERT INTO civicrm_setting (name, contact_id, domain_id, value, is_domain, created_id, created_date) SELECT name, contact_id, domain_id, value, 0, contact_id,'$date' FROM civicrm_activity_setting WHERE name = 'activity_tab_filter' AND value is not NULL" ); CRM_Core_DAO::executeQuery('DROP TABLE civicrm_activity_setting'); $domainDao = CRM_Core_DAO::executeQuery('SELECT id, config_backend FROM civicrm_domain'); while ($domainDao->fetch()) { $settings = CRM_Upgrade_Incremental_php_FourSeven::convertBackendToSettings($domainDao->id, $domainDao->config_backend); CRM_Core_Error::debug_var('convertBackendToSettings', array( 'domainId' => $domainDao->id, 'backend' => $domainDao->config_backend, 'settings' => $settings, )); foreach ($settings as $name => $value) { $rowParams = array( 1 => array($domainDao->id, 'Positive'), 2 => array($name, 'String'), 3 => array(serialize($value), 'String'), ); $settingId = CRM_Core_DAO::singleValueQuery( 'SELECT id FROM civicrm_setting WHERE domain_id = %1 AND name = %2', $rowParams); if (!$settingId) { CRM_Core_DAO::executeQuery( 'INSERT INTO civicrm_setting (domain_id, name, value, is_domain) VALUES (%1,%2,%3,1)', $rowParams); } } } CRM_Core_DAO::executeQuery('ALTER TABLE civicrm_domain DROP COLUMN config_backend'); return TRUE; } /** * Take a config_backend blob and produce an equivalent list of settings. * * @param int $domainId * Domain ID. * @param string $config_backend * Serialized blob. * @return array */ public static function convertBackendToSettings($domainId, $config_backend) { if (!$config_backend) { return array(); } $backend = unserialize($config_backend); if (!$backend) { return array(); } $mappings = \CRM_Core_Config_MagicMerge::getPropertyMap(); $settings = array(); foreach ($backend as $propertyName => $propertyValue) { if (isset($mappings[$propertyName][0]) && preg_match('/^setting/', $mappings[$propertyName][0])) { // $mapping format: $propertyName => Array(0 => $type, 1 => $setting|NULL). $settingName = isset($mappings[$propertyName][1]) ? $mappings[$propertyName][1] : $propertyName; $settings[$settingName] = $propertyValue; } } return $settings; } /** * Add Getting Started dashlet to dashboard * * @param \CRM_Queue_TaskContext $ctx * * @return bool */ public function addGettingStartedDashlet(CRM_Queue_TaskContext $ctx) { $sql = "SELECT count(*) FROM civicrm_dashboard WHERE name='getting-started'"; $res = CRM_Core_DAO::singleValueQuery($sql); $domainId = CRM_Core_Config::domainID(); if ($res <= 0) { $sql = "INSERT INTO `civicrm_dashboard` ( `domain_id`, `name`, `label`, `url`, `permission`, `permission_operator`, `column_no`, `is_minimized`, `is_active`, `weight`, `fullscreen_url`, `is_fullscreen`, `is_reserved`) VALUES ( {$domainId}, 'getting-started', 'Getting Started', 'civicrm/dashlet/getting-started?reset=1&snippet=5', 'access CiviCRM', NULL, 0, 0, 1, 0, 'civicrm/dashlet/getting-started?reset=1&snippet=5&context=dashletFullscreen', 1, 1)"; CRM_Core_DAO::executeQuery($sql); // Add default position for Getting Started Dashlet ( left column) $sql = "INSERT INTO `civicrm_dashboard_contact` (dashboard_id, contact_id, column_no, is_active) SELECT (SELECT MAX(id) FROM `civicrm_dashboard`), contact_id, 0, IF (SUM(is_active) > 0, 1, 0) FROM `civicrm_dashboard_contact` JOIN `civicrm_contact` WHERE civicrm_dashboard_contact.contact_id = civicrm_contact.id GROUP BY contact_id"; CRM_Core_DAO::executeQuery($sql); } return TRUE; } /** * Migrate on-behalf information to uf_join.module_data as on-behalf columns will be dropped * on DB upgrade * * @param CRM_Queue_TaskContext $ctx * * @return bool * TRUE for success */ public static function migrateOnBehalfOfInfo(CRM_Queue_TaskContext $ctx) { $domain = new CRM_Core_DAO_Domain(); $domain->find(TRUE); // fetch onBehalf entry in UFJoin table $ufGroupDAO = new CRM_Core_DAO_UFJoin(); $ufGroupDAO->module = 'OnBehalf'; $ufGroupDAO->find(TRUE); $forOrgColums = array(); if ($domain->locales) { $locales = explode(CRM_Core_DAO::VALUE_SEPARATOR, $domain->locales); foreach ($locales as $locale) { $forOrgColums[] = "for_organization_{$locale}"; } } else { $forOrgColums[] = "for_organization"; } $query = " SELECT " . implode(", ", $forOrgColums) . ", uj.id as join_id, uj.uf_group_id as uf_group_id FROM civicrm_contribution_page cp INNER JOIN civicrm_uf_join uj ON uj.entity_id = cp.id AND uj.module = 'OnBehalf'"; $dao = CRM_Core_DAO::executeQuery($query, array(), TRUE, NULL, FALSE, FALSE); if ($dao->N) { while ($dao->fetch()) { $onBehalfParams['on_behalf'] = array('is_for_organization' => $dao->is_for_organization); if ($domain->locales) { foreach ($locales as $locale) { $for_organization = "for_organization_{$locale}"; $onBehalfParams['on_behalf'] += array( $locale => array( 'for_organization' => $dao->$for_organization, ), ); } } else { $onBehalfParams['on_behalf'] += array( 'default' => array( 'for_organization' => $dao->for_organization, ), ); } $ufJoinParam = array( 'id' => $dao->join_id, 'module' => 'on_behalf', 'uf_group_id' => $dao->uf_group_id, 'module_data' => json_encode($onBehalfParams), ); CRM_Core_BAO_UFJoin::create($ufJoinParam); } } return TRUE; } /** * CRM-11782 - Get rid of VALUE_SEPARATOR character in saved search form values * * @param \CRM_Queue_TaskContext $ctx * * @return bool */ public function fixContactTypeInSmartGroups(CRM_Queue_TaskContext $ctx) { $sep = CRM_Core_DAO::VALUE_SEPARATOR; $dao = CRM_Core_DAO::executeQuery("SELECT id, form_values FROM civicrm_saved_search WHERE form_values LIKE '%$sep%'"); while ($dao->fetch()) { $formValues = unserialize($dao->form_values); if (isset($formValues['contact_type']) && is_array($formValues['contact_type'])) { $newVals = array(); foreach ($formValues['contact_type'] as $key => $val) { $newVals[str_replace($sep, '__', $key)] = is_string($val) ? str_replace($sep, '__', $val) : $val; } $formValues['contact_type'] = $newVals; } CRM_Core_DAO::executeQuery("UPDATE civicrm_saved_search SET form_values = %1 WHERE id = {$dao->id}", array(1 => array(serialize($formValues), 'String'))); } return TRUE; } /** * CRM-17637 - Ths file location has been moved; delete the old one * * @param \CRM_Queue_TaskContext $ctx * * @return bool */ public function deleteVersionCheckCacheFile(CRM_Queue_TaskContext $ctx) { $config = CRM_Core_Config::singleton(); $cacheFile = $config->uploadDir . 'version-info-cache.json'; if (file_exists($cacheFile)) { unlink($cacheFile); } return TRUE; } /** * CRM-17669 and CRM-17686, make scheduled jobs more flexible, disable the 4.6 extension if installed * * @param \CRM_Queue_TaskContext $ctx * * @return bool */ public function disableFlexibleJobsExtension(CRM_Queue_TaskContext $ctx) { try { civicrm_api3('Extension', 'disable', array('key' => 'com.klangsoft.flexiblejobs')); } catch (CiviCRM_API3_Exception $e) { // just ignore if the extension isn't installed } return TRUE; } /** * CRM-17752 add index to civicrm_financial_trxn.trxn_id (deliberately non-unique). * * @param \CRM_Queue_TaskContext $ctx * * @return bool */ public function addIndexFinancialTrxnTrxnID(CRM_Queue_TaskContext $ctx) { $tables = array('civicrm_financial_trxn' => array('trxn_id')); CRM_Core_BAO_SchemaHandler::createIndexes($tables); return TRUE; } /** * CRM-17882 Add index to civicrm_contribution.credit_note_id. * * @param \CRM_Queue_TaskContext $ctx * * @return bool */ public function addIndexContributionCreditNoteID(CRM_Queue_TaskContext $ctx) { $tables = array('civicrm_contribution' => array('creditnote_id')); CRM_Core_BAO_SchemaHandler::createIndexes($tables); return TRUE; } /** * CRM-17775 Add correct index for table civicrm_financial_item. * * Note that the entity ID should always precede the entity_table as * it is more unique. This is better for performance and does not cause fallback * to no index if table it omitted. * * @return bool */ public function addCombinedIndexFinancialItemEntityIDEntityType() { CRM_Core_BAO_SchemaHandler::dropIndexIfExists('civicrm_financial_item', 'UI_id'); CRM_Core_BAO_SchemaHandler::dropIndexIfExists('civicrm_financial_item', 'IX_Entity'); CRM_Core_BAO_SchemaHandler::createIndexes(array( 'civicrm_financial_item' => array(array('entity_id', 'entity_table')), )); return TRUE; } /** * CRM-17951 Add accounts option values for refund and chargeback. * * Add Chargeback contribution status and Chargeback and Contra account relationships, * checking first if one exists. */ public function addRefundAndChargeBackAccountsIfNotExist() { // First we enable and edit the record for Credit contra - this exists but is disabled for most sites. // Using the ensure function (below) will not enabled a disabled option (by design). CRM_Core_DAO::executeQuery("UPDATE civicrm_option_value v INNER JOIN civicrm_option_group g on v.option_group_id=g.id and g.name='account_relationship' SET v.is_active=1, v.label='Credit/Contra Revenue Account is', v.name='Credit/Contra Revenue Account is', v.description='Credit/Contra Revenue Account is' WHERE v.name = 'Credit/Contra Account is';"); CRM_Core_BAO_OptionValue::ensureOptionValueExists(array( 'option_group_id' => 'account_relationship', 'name' => 'Chargeback Account is', 'label' => ts('Chargeback Account is'), 'is_active' => TRUE, 'component_id' => 'CiviContribute', )); CRM_Core_BAO_OptionValue::ensureOptionValueExists(array( 'option_group_id' => 'contribution_status', 'name' => 'Chargeback', 'label' => ts('Chargeback'), 'is_active' => TRUE, 'component_id' => 'CiviContribute', )); return TRUE; } /** * CRM-17999 Add index to civicrm_contribution.source. * * @param \CRM_Queue_TaskContext $ctx * * @return bool */ public function addIndexContributionSource(CRM_Queue_TaskContext $ctx) { CRM_Core_BAO_SchemaHandler::createIndexes(array('civicrm_contribution' => array('source'))); return TRUE; } /** * CRM-18124 Add index to civicrm_contribution.total_amount. * * Note that I made this a combined index with receive_date because the issue included * both criteria and they seemed likely to be used in conjunction to me in other cases. * * @param \CRM_Queue_TaskContext $ctx * * @return bool */ public function addIndexContributionAmount(CRM_Queue_TaskContext $ctx) { CRM_Core_BAO_SchemaHandler::createIndexes(array( 'civicrm_contribution' => array(array('total_amount', 'receive_date')), )); return TRUE; } /** * CRM-18124 Add index to civicrm_contribution.total_amount. * * Note that I made this a combined index with receive_date because the issue included * both criteria and they seemed likely to be used in conjunction to me in other cases. * * @param \CRM_Queue_TaskContext $ctx * * @return bool */ public function addDeletedByMergeActivityType(CRM_Queue_TaskContext $ctx) { CRM_Core_BAO_OptionValue::ensureOptionValueExists(array( 'option_group_id' => 'activity_type', 'name' => 'Contact Deleted by Merge', 'label' => ts('Contact Deleted by Merge'), 'description' => ts('Contact was merged into another contact'), 'is_active' => TRUE, 'filter' => 1, )); return TRUE; } /** * Remove a foreign key from a table if it exists * * @param $table_name * @param $constraint_name */ public function safeRemoveFK($table_name, $constraint_name) { $config = CRM_Core_Config::singleton(); $dbUf = DB::parseDSN($config->dsn); $query = " SELECT CONSTRAINT_NAME FROM INFORMATION_SCHEMA.TABLE_CONSTRAINTS WHERE TABLE_SCHEMA = %1 AND TABLE_NAME = %2 AND CONSTRAINT_NAME = %3 AND CONSTRAINT_TYPE = 'FOREIGN KEY' "; $params = array( 1 => array($dbUf['database'], 'String'), 2 => array($table_name, 'String'), 3 => array($constraint_name, 'String'), ); $dao = CRM_Core_DAO::executeQuery($query, $params); if ($dao->fetch()) { CRM_Core_DAO::executeQuery("ALTER TABLE {$table_name} DROP FOREIGN KEY {$constraint_name}", array()); } } /** * CRM-18345 Don't delete mailing data on email/phone deletion * Implemented here in CRM-18526 * * @param \CRM_Queue_TaskContext $ctx * * @return bool */ public function upgradeMailingFKs(CRM_Queue_TaskContext $ctx) { // Safely drop the foreign keys self::safeRemoveFK('civicrm_mailing_event_queue', 'FK_civicrm_mailing_event_queue_email_id'); self::safeRemoveFK('civicrm_mailing_event_queue', 'FK_civicrm_mailing_event_queue_phone_id'); self::safeRemoveFK('civicrm_mailing_recipients', 'FK_civicrm_mailing_recipients_email_id'); self::safeRemoveFK('civicrm_mailing_recipients', 'FK_civicrm_mailing_recipients_phone_id'); // Set up the new foreign keys CRM_Core_DAO::executeQuery("SET FOREIGN_KEY_CHECKS = 0;"); CRM_Core_DAO::executeQuery(" ALTER TABLE `civicrm_mailing_event_queue` ADD CONSTRAINT `FK_civicrm_mailing_event_queue_email_id` FOREIGN KEY (`email_id`) REFERENCES `civicrm_email`(`id`) ON DELETE SET NULL ON UPDATE RESTRICT; "); CRM_Core_DAO::executeQuery(" ALTER TABLE `civicrm_mailing_event_queue` ADD CONSTRAINT `FK_civicrm_mailing_event_queue_phone_id` FOREIGN KEY (`phone_id`) REFERENCES `civicrm_phone`(`id`) ON DELETE SET NULL ON UPDATE RESTRICT; "); CRM_Core_DAO::executeQuery(" ALTER TABLE `civicrm_mailing_recipients` ADD CONSTRAINT `FK_civicrm_mailing_recipients_email_id` FOREIGN KEY (`email_id`) REFERENCES `civicrm_email`(`id`) ON DELETE SET NULL ON UPDATE RESTRICT; "); CRM_Core_DAO::executeQuery(" ALTER TABLE `civicrm_mailing_recipients` ADD CONSTRAINT `FK_civicrm_mailing_recipients_phone_id` FOREIGN KEY (`phone_id`) REFERENCES `civicrm_phone`(`id`) ON DELETE SET NULL ON UPDATE RESTRICT; "); CRM_Core_DAO::executeQuery("SET FOREIGN_KEY_CHECKS = 1;"); return TRUE; } }