'edit user-driven message templates', 2 => 'edit system workflow message templates', 3 => 'edit message templates', ); $preUpgradeMessage .= '

' . ts('New granular permissions called %1 and %2 have been added for %3 permission. These permissions help to limit user access per template', $params) . '

'; } // Example: Generate a pre-upgrade message. // if ($rev == '5.12.34') { // $preUpgradeMessage .= '

' . ts('A new permission, "%1", has been added. This permission is now used to control access to the Manage Tags screen.', array(1 => ts('manage tags'))) . '

'; // } } /** * 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) { // Example: Generate a post-upgrade message. // if ($rev == '5.12.34') { // $postUpgradeMessage .= '

' . ts("By default, CiviCRM now disables the ability to import directly from SQL. To use this feature, you must explicitly grant permission 'import SQL datasource'."); // } } /** * Upgrade function. * * @param string $rev */ public function upgrade_5_3_alpha1($rev) { $this->addTask(ts('Upgrade DB to %1: SQL', array(1 => $rev)), 'runSql', $rev); $this->addTask('CRM-19948 - Add created_id column to civicrm_file', 'addFileCreatedIdColumn'); } public static function addFileCreatedIdColumn(CRM_Queue_TaskContext $ctx) { self::addColumn($ctx, 'civicrm_file', 'created_id', "int unsigned COMMENT 'FK to civicrm_contact, who uploaded this file'"); CRM_Core_BAO_SchemaHandler::safeRemoveFK('civicrm_file', 'FK_civicrm_file_created_id'); CRM_Core_DAO::executeQuery(" ALTER TABLE `civicrm_file` ADD CONSTRAINT `FK_civicrm_file_created_id` FOREIGN KEY (`created_id`) REFERENCES `civicrm_contact`(`id`) ON DELETE SET NULL ON UPDATE CASCADE; "); return TRUE; } /* * Important! All upgrade functions MUST add a '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_5_0_x($rev) { // $this->addTask(ts('Upgrade DB to %1: SQL', array(1 => $rev)), 'runSql', $rev); // $this->addTask('Do the foo change', 'taskFoo', ...); // // Additional tasks here... // // Note: do not use ts() in the addTask description because it adds unnecessary strings to transifex. // // The above is an exception because 'Upgrade DB to %1: SQL' is generic & reusable. // } // public static function taskFoo(CRM_Queue_TaskContext $ctx, ...) { // return TRUE; // } }