CRM/Utils/System/Drupal.php

   1 <?php
   2 /*
   3  +--------------------------------------------------------------------+
   4  | Copyright CiviCRM LLC. All rights reserved.                        |
   5  |                                                                    |
   6  | This work is published under the GNU AGPLv3 license with some      |
   7  | permitted exceptions and without any warranty. For full license    |
   8  | and copyright information, see https://civicrm.org/licensing       |
   9  +--------------------------------------------------------------------+
  10  */
  11
  12 /**
  13  *
  14  * @package CRM
  15  * @copyright CiviCRM LLC https://civicrm.org/licensing
  16  */
  17
  18 /**
  19  * Drupal specific stuff goes here
  20  */
  21 class CRM_Utils_System_Drupal extends CRM_Utils_System_DrupalBase {
  22
  23   /**
  24    * @inheritDoc
  25    */
  26   public function createUser(&$params, $mail) {
  27     $form_state = form_state_defaults();
  28
  29     $form_state['input'] = [
  30       'name' => $params['cms_name'],
  31       'mail' => $params[$mail],
  32       'op' => 'Create new account',
  33     ];
  34
  35     $admin = user_access('administer users');
  36     if (!variable_get('user_email_verification', TRUE) || $admin) {
  37       $form_state['input']['pass'] = ['pass1' => $params['cms_pass'], 'pass2' => $params['cms_pass']];
  38     }
  39
  40     if (!empty($params['notify'])) {
  41       $form_state['input']['notify'] = $params['notify'];
  42     }
  43
  44     $form_state['rebuild'] = FALSE;
  45     $form_state['programmed'] = TRUE;
  46     $form_state['complete form'] = FALSE;
  47     $form_state['method'] = 'post';
  48     $form_state['build_info']['args'] = [];
  49     /*
  50      * if we want to submit this form more than once in a process (e.g. create more than one user)
  51      * we must force it to validate each time for this form. Otherwise it will not validate
  52      * subsequent submissions and the manner in which the password is passed in will be invalid
  53      */
  54     $form_state['must_validate'] = TRUE;
  55     $config = CRM_Core_Config::singleton();
  56
  57     // we also need to redirect b
  58     $config->inCiviCRM = TRUE;
  59
  60     $form = drupal_retrieve_form('user_register_form', $form_state);
  61     $form_state['process_input'] = 1;
  62     $form_state['submitted'] = 1;
  63     $form['#array_parents'] = [];
  64     $form['#tree'] = FALSE;
  65     drupal_process_form('user_register_form', $form, $form_state);
  66
  67     $config->inCiviCRM = FALSE;
  68
  69     if (form_get_errors()) {
  70       return FALSE;
  71     }
  72     return $form_state['user']->uid;
  73   }
  74
  75   /**
  76    * Appends a Drupal 7 Javascript file when the CRM Menubar Javascript file has
  77    * been included. The file is added before the menu bar so we can properly listen
  78    * for the menu bar ready event.
  79    */
  80   public function appendCoreResources(\Civi\Core\Event\GenericHookEvent $event) {
  81     $menuBarFileIndex = array_search('js/crm.menubar.js', $event->list);
  82
  83     if ($menuBarFileIndex !== FALSE) {
  84       array_splice($event->list, $menuBarFileIndex, 0, ['js/crm.drupal7.js']);
  85     }
  86   }
  87
  88   /**
  89    * @inheritDoc
  90    */
  91   public function updateCMSName($ufID, $ufName) {
  92     // CRM-5555
  93     if (function_exists('user_load')) {
  94       $user = user_load($ufID);
  95       if ($user->mail != $ufName) {
  96         user_save($user, ['mail' => $ufName]);
  97         $user = user_load($ufID);
  98       }
  99     }
 100   }
 101
 102   /**
 103    * Check if username and email exists in the drupal db.
 104    *
 105    * @param array $params
 106    *   Array of name and mail values.
 107    * @param array $errors
 108    *   Array of errors.
 109    * @param string $emailName
 110    *   Field label for the 'email'.
 111    */
 112   public static function checkUserNameEmailExists(&$params, &$errors, $emailName = 'email') {
 113     $config = CRM_Core_Config::singleton();
 114
 115     $dao = new CRM_Core_DAO();
 116     $name = $dao->escape(CRM_Utils_Array::value('name', $params));
 117     $email = $dao->escape(CRM_Utils_Array::value('mail', $params));
 118     $errors = form_get_errors();
 119     if ($errors) {
 120       // unset drupal messages to avoid twice display of errors
 121       unset($_SESSION['messages']);
 122     }
 123
 124     if (!empty($params['name'])) {
 125       if ($nameError = user_validate_name($params['name'])) {
 126         $errors['cms_name'] = $nameError;
 127       }
 128       else {
 129         $uid = db_query(
 130           "SELECT uid FROM {users} WHERE name = :name",
 131           [':name' => $params['name']]
 132         )->fetchField();
 133         if ((bool) $uid) {
 134           $errors['cms_name'] = ts('The username %1 is already taken. Please select another username.', [1 => $params['name']]);
 135         }
 136       }
 137     }
 138
 139     if (!empty($params['mail'])) {
 140       if ($emailError = user_validate_mail($params['mail'])) {
 141         $errors[$emailName] = $emailError;
 142       }
 143       else {
 144         $uid = db_query(
 145           "SELECT uid FROM {users} WHERE mail = :mail",
 146           [':mail' => $params['mail']]
 147         )->fetchField();
 148         if ((bool) $uid) {
 149           $resetUrl = url('user/password');
 150           $errors[$emailName] = ts('The email address %1 already has an account associated with it. <a href="%2">Have you forgotten your password?</a>',
 151             [1 => $params['mail'], 2 => $resetUrl]
 152           );
 153         }
 154       }
 155     }
 156   }
 157
 158   /**
 159    * @inheritDoc
 160    */
 161   public function getLoginURL($destination = '') {
 162     $query = $destination ? ['destination' => $destination] : NULL;
 163     return CRM_Utils_System::url('user', $query, TRUE);
 164   }
 165
 166   /**
 167    * @inheritDoc
 168    */
 169   public function setTitle($title, $pageTitle = NULL) {
 170     if (arg(0) == 'civicrm') {
 171       if (!$pageTitle) {
 172         $pageTitle = $title;
 173       }
 174
 175       drupal_set_title($pageTitle, PASS_THROUGH);
 176     }
 177   }
 178
 179   /**
 180    * @inheritDoc
 181    */
 182   public function appendBreadCrumb($breadCrumbs) {
 183     $breadCrumb = drupal_get_breadcrumb();
 184
 185     if (is_array($breadCrumbs)) {
 186       foreach ($breadCrumbs as $crumbs) {
 187         if (stripos($crumbs['url'], 'id%%')) {
 188           $args = ['cid', 'mid'];
 189           foreach ($args as $a) {
 190             $val = CRM_Utils_Request::retrieve($a, 'Positive', CRM_Core_DAO::$_nullObject,
 191               FALSE, NULL, $_GET
 192             );
 193             if ($val) {
 194               $crumbs['url'] = str_ireplace("%%{$a}%%", $val, $crumbs['url']);
 195             }
 196           }
 197         }
 198         $breadCrumb[] = "<a href=\"{$crumbs['url']}\">{$crumbs['title']}</a>";
 199       }
 200     }
 201     drupal_set_breadcrumb($breadCrumb);
 202   }
 203
 204   /**
 205    * @inheritDoc
 206    */
 207   public function resetBreadCrumb() {
 208     $bc = [];
 209     drupal_set_breadcrumb($bc);
 210   }
 211
 212   /**
 213    * @inheritDoc
 214    */
 215   public function addHTMLHead($header) {
 216     static $count = 0;
 217     if (!empty($header)) {
 218       $key = 'civi_' . ++$count;
 219       $data = [
 220         '#type' => 'markup',
 221         '#markup' => $header,
 222       ];
 223       drupal_add_html_head($data, $key);
 224     }
 225   }
 226
 227   /**
 228    * @inheritDoc
 229    */
 230   public function addScriptUrl($url, $region) {
 231     $params = ['group' => JS_LIBRARY, 'weight' => 10];
 232     switch ($region) {
 233       case 'html-header':
 234       case 'page-footer':
 235         $params['scope'] = substr($region, 5);
 236         break;
 237
 238       default:
 239         return FALSE;
 240     }
 241     // If the path is within the drupal directory we can use the more efficient 'file' setting
 242     $params['type'] = $this->formatResourceUrl($url) ? 'file' : 'external';
 243     drupal_add_js($url, $params);
 244     return TRUE;
 245   }
 246
 247   /**
 248    * @inheritDoc
 249    */
 250   public function addScript($code, $region) {
 251     $params = ['type' => 'inline', 'group' => JS_LIBRARY, 'weight' => 10];
 252     switch ($region) {
 253       case 'html-header':
 254       case 'page-footer':
 255         $params['scope'] = substr($region, 5);
 256         break;
 257
 258       default:
 259         return FALSE;
 260     }
 261     drupal_add_js($code, $params);
 262     return TRUE;
 263   }
 264
 265   /**
 266    * @inheritDoc
 267    */
 268   public function addStyleUrl($url, $region) {
 269     if ($region != 'html-header') {
 270       return FALSE;
 271     }
 272     $params = [];
 273     // If the path is within the drupal directory we can use the more efficient 'file' setting
 274     $params['type'] = $this->formatResourceUrl($url) ? 'file' : 'external';
 275     drupal_add_css($url, $params);
 276     return TRUE;
 277   }
 278
 279   /**
 280    * @inheritDoc
 281    */
 282   public function addStyle($code, $region) {
 283     if ($region != 'html-header') {
 284       return FALSE;
 285     }
 286     $params = ['type' => 'inline'];
 287     drupal_add_css($code, $params);
 288     return TRUE;
 289   }
 290
 291   /**
 292    * @inheritDoc
 293    */
 294   public function mapConfigToSSL() {
 295     global $base_url;
 296     $base_url = str_replace('http://', 'https://', $base_url);
 297   }
 298
 299   /**
 300    * Get the name of the users table.
 301    *
 302    * @return string
 303    */
 304   protected function getUsersTableName() {
 305     $userFrameworkUsersTableName = Civi::settings()->get('userFrameworkUsersTableName');
 306     if (empty($userFrameworkUsersTableName)) {
 307       $userFrameworkUsersTableName = 'users';
 308     }
 309     return $userFrameworkUsersTableName;
 310   }
 311
 312   /**
 313    * @inheritDoc
 314    */
 315   public function authenticate($name, $password, $loadCMSBootstrap = FALSE, $realPath = NULL) {
 316     require_once 'DB.php';
 317
 318     $config = CRM_Core_Config::singleton();
 319
 320     $ufDSN = CRM_Utils_SQL::autoSwitchDSN($config->userFrameworkDSN);
 321     try {
 322       $dbDrupal = DB::connect($ufDSN);
 323     }
 324     catch (Exception $e) {
 325       throw new CRM_Core_Exception("Cannot connect to drupal db via $ufDSN, " . $e->getMessage());
 326     }
 327
 328     $account = $userUid = $userMail = NULL;
 329     if ($loadCMSBootstrap) {
 330       $bootStrapParams = [];
 331       if ($name && $password) {
 332         $bootStrapParams = [
 333           'name' => $name,
 334           'pass' => $password,
 335         ];
 336       }
 337       CRM_Utils_System::loadBootStrap($bootStrapParams, TRUE, TRUE, $realPath);
 338
 339       global $user;
 340       if ($user) {
 341         $userUid = $user->uid;
 342         $userMail = $user->mail;
 343       }
 344     }
 345     else {
 346       // CRM-8638
 347       // SOAP cannot load drupal bootstrap and hence we do it the old way
 348       // Contact CiviSMTP folks if we run into issues with this :)
 349       $cmsPath = $config->userSystem->cmsRootPath($realPath);
 350
 351       require_once "$cmsPath/includes/bootstrap.inc";
 352       require_once "$cmsPath/includes/password.inc";
 353
 354       $strtolower = function_exists('mb_strtolower') ? 'mb_strtolower' : 'strtolower';
 355       $name = $dbDrupal->escapeSimple($strtolower($name));
 356       $userFrameworkUsersTableName = $this->getUsersTableName();
 357
 358       // LOWER in query below roughly translates to 'hurt my database without deriving any benefit' See CRM-19811.
 359       $sql = "
 360 SELECT u.*
 361 FROM   {$userFrameworkUsersTableName} u
 362 WHERE  LOWER(u.name) = '$name'
 363 AND    u.status = 1
 364 ";
 365
 366       $query = $dbDrupal->query($sql);
 367       $row = $query->fetchRow(DB_FETCHMODE_ASSOC);
 368
 369       if ($row) {
 370         $fakeDrupalAccount = drupal_anonymous_user();
 371         $fakeDrupalAccount->name = $name;
 372         $fakeDrupalAccount->pass = $row['pass'];
 373         $passwordCheck = user_check_password($password, $fakeDrupalAccount);
 374         if ($passwordCheck) {
 375           $userUid = $row['uid'];
 376           $userMail = $row['mail'];
 377         }
 378       }
 379     }
 380
 381     if ($userUid && $userMail) {
 382       CRM_Core_BAO_UFMatch::synchronizeUFMatch($account, $userUid, $userMail, 'Drupal');
 383       $contactID = CRM_Core_BAO_UFMatch::getContactId($userUid);
 384       if (!$contactID) {
 385         return FALSE;
 386       }
 387       return [$contactID, $userUid, mt_rand()];
 388     }
 389     return FALSE;
 390   }
 391
 392   /**
 393    * @inheritDoc
 394    */
 395   public function loadUser($username) {
 396     global $user;
 397
 398     $user = user_load_by_name($username);
 399
 400     if (empty($user->uid)) {
 401       return FALSE;
 402     }
 403
 404     $uid = $user->uid;
 405     $contact_id = CRM_Core_BAO_UFMatch::getContactId($uid);
 406
 407     // lets store contact id and user id in session
 408     $session = CRM_Core_Session::singleton();
 409     $session->set('ufID', $uid);
 410     $session->set('userID', $contact_id);
 411     return TRUE;
 412   }
 413
 414   /**
 415    * Perform any post login activities required by the UF -
 416    * e.g. for drupal: records a watchdog message about the new session, saves the login timestamp,
 417    * calls hook_user op 'login' and generates a new session.
 418    *
 419    * @param array $params
 420    *
 421    * FIXME: Document values accepted/required by $params
 422    */
 423   public function userLoginFinalize($params = []) {
 424     user_login_finalize($params);
 425   }
 426
 427   /**
 428    * Determine the native ID of the CMS user.
 429    *
 430    * @param string $username
 431    * @return int|null
 432    */
 433   public function getUfId($username) {
 434     $user = user_load_by_name($username);
 435     if (empty($user->uid)) {
 436       return NULL;
 437     }
 438     return $user->uid;
 439   }
 440
 441   /**
 442    * @inheritDoc
 443    */
 444   public function logout() {
 445     module_load_include('inc', 'user', 'user.pages');
 446     return user_logout();
 447   }
 448
 449   /**
 450    * Get the default location for CiviCRM blocks.
 451    *
 452    * @return string
 453    */
 454   public function getDefaultBlockLocation() {
 455     return 'sidebar_first';
 456   }
 457
 458   /**
 459    * Load drupal bootstrap.
 460    *
 461    * @param array $params
 462    *   Either uid, or name & pass.
 463    * @param bool $loadUser
 464    *   Boolean Require CMS user load.
 465    * @param bool $throwError
 466    *   If true, print error on failure and exit.
 467    * @param bool|string $realPath path to script
 468    *
 469    * @return bool
 470    */
 471   public function loadBootStrap($params = [], $loadUser = TRUE, $throwError = TRUE, $realPath = NULL) {
 472     //take the cms root path.
 473     $cmsPath = $this->cmsRootPath($realPath);
 474
 475     if (!file_exists("$cmsPath/includes/bootstrap.inc")) {
 476       if ($throwError) {
 477         throw new Exception('Sorry, could not locate bootstrap.inc');
 478       }
 479       return FALSE;
 480     }
 481     // load drupal bootstrap
 482     chdir($cmsPath);
 483     define('DRUPAL_ROOT', $cmsPath);
 484
 485     // For drupal multi-site CRM-11313
 486     if ($realPath && strpos($realPath, 'sites/all/modules/') === FALSE) {
 487       preg_match('@sites/([^/]*)/modules@s', $realPath, $matches);
 488       if (!empty($matches[1])) {
 489         $_SERVER['HTTP_HOST'] = $matches[1];
 490       }
 491     }
 492     require_once 'includes/bootstrap.inc';
 493     // @ to suppress notices eg 'DRUPALFOO already defined'.
 494     @drupal_bootstrap(DRUPAL_BOOTSTRAP_FULL);
 495
 496     // explicitly setting error reporting, since we cannot handle drupal related notices
 497     // @todo 1 = E_ERROR, but more to the point setting error reporting deep in code
 498     // causes grief with debugging scripts
 499     error_reporting(1);
 500     if (!function_exists('module_exists')) {
 501       if ($throwError) {
 502         throw new Exception('Sorry, could not load drupal bootstrap.');
 503       }
 504       return FALSE;
 505     }
 506     if (!module_exists('civicrm')) {
 507       if ($throwError) {
 508         throw new Exception('Sorry, drupal cannot find CiviCRM');
 509       }
 510       return FALSE;
 511     }
 512
 513     // seems like we've bootstrapped drupal
 514     $config = CRM_Core_Config::singleton();
 515
 516     // lets also fix the clean url setting
 517     // CRM-6948
 518     $config->cleanURL = (int) variable_get('clean_url', '0');
 519
 520     // we need to call the config hook again, since we now know
 521     // all the modules that are listening on it, does not apply
 522     // to J! and WP as yet
 523     // CRM-8655
 524     CRM_Utils_Hook::config($config);
 525
 526     if (!$loadUser) {
 527       return TRUE;
 528     }
 529
 530     $uid = $params['uid'] ?? NULL;
 531     if (!$uid) {
 532       //load user, we need to check drupal permissions.
 533       $name = CRM_Utils_Array::value('name', $params, FALSE) ? $params['name'] : trim(CRM_Utils_Array::value('name', $_REQUEST));
 534       $pass = CRM_Utils_Array::value('pass', $params, FALSE) ? $params['pass'] : trim(CRM_Utils_Array::value('pass', $_REQUEST));
 535
 536       if ($name) {
 537         $uid = user_authenticate($name, $pass);
 538         if (!$uid) {
 539           if ($throwError) {
 540             throw new Exception('Sorry, unrecognized username or password.');
 541           }
 542           return FALSE;
 543         }
 544       }
 545     }
 546
 547     if ($uid) {
 548       $account = user_load($uid);
 549       if ($account && $account->uid) {
 550         global $user;
 551         $user = $account;
 552         return TRUE;
 553       }
 554     }
 555
 556     if ($throwError) {
 557       throw new Exception('Sorry, can not load CMS user account.');
 558     }
 559
 560     // CRM-6948: When using loadBootStrap, it's implicit that CiviCRM has already loaded its settings
 561     // which means that define(CIVICRM_CLEANURL) was correctly set.
 562     // So we correct it
 563     $config = CRM_Core_Config::singleton();
 564     $config->cleanURL = (int) variable_get('clean_url', '0');
 565
 566     // CRM-8655: Drupal wasn't available during bootstrap, so hook_civicrm_config never executes
 567     CRM_Utils_Hook::config($config);
 568
 569     return FALSE;
 570   }
 571
 572   /**
 573    * Get CMS root path.
 574    *
 575    * @param string $scriptFilename
 576    *
 577    * @return null|string
 578    */
 579   public function cmsRootPath($scriptFilename = NULL) {
 580     $cmsRoot = $valid = NULL;
 581
 582     if (!is_null($scriptFilename)) {
 583       $path = $scriptFilename;
 584     }
 585     else {
 586       $path = $_SERVER['SCRIPT_FILENAME'];
 587     }
 588
 589     if (function_exists('drush_get_context')) {
 590       // drush anyway takes care of multisite install etc
 591       return drush_get_context('DRUSH_DRUPAL_ROOT');
 592     }
 593
 594     global $civicrm_paths;
 595     if (!empty($civicrm_paths['cms.root']['path'])) {
 596       return $civicrm_paths['cms.root']['path'];
 597     }
 598
 599     // CRM-7582
 600     $pathVars = explode('/',
 601       str_replace('//', '/',
 602         str_replace('\\', '/', $path)
 603       )
 604     );
 605
 606     //lets store first var,
 607     //need to get back for windows.
 608     $firstVar = array_shift($pathVars);
 609
 610     // Remove the script name to remove an necessary iteration of the loop.
 611     array_pop($pathVars);
 612
 613     // CRM-7429 -- do check for uppermost 'includes' dir, which would
 614     // work for multisite installation.
 615     do {
 616       $cmsRoot = $firstVar . '/' . implode('/', $pathVars);
 617       $cmsIncludePath = "$cmsRoot/includes";
 618       // Stop if we find bootstrap.
 619       if (file_exists("$cmsIncludePath/bootstrap.inc")) {
 620         $valid = TRUE;
 621         break;
 622       }
 623       //remove one directory level.
 624       array_pop($pathVars);
 625     } while (count($pathVars));
 626
 627     return ($valid) ? $cmsRoot : NULL;
 628   }
 629
 630   /**
 631    * @inheritDoc
 632    */
 633   public function isUserLoggedIn() {
 634     $isloggedIn = FALSE;
 635     if (function_exists('user_is_logged_in')) {
 636       $isloggedIn = user_is_logged_in();
 637     }
 638
 639     return $isloggedIn;
 640   }
 641
 642   /**
 643    * @inheritDoc
 644    */
 645   public function getLoggedInUfID() {
 646     $ufID = NULL;
 647     if (function_exists('user_is_logged_in') &&
 648       user_is_logged_in() &&
 649       function_exists('user_uid_optional_to_arg')
 650     ) {
 651       $ufID = user_uid_optional_to_arg([]);
 652     }
 653
 654     return $ufID;
 655   }
 656
 657   /**
 658    * @inheritDoc
 659    */
 660   public function languageNegotiationURL($url, $addLanguagePart = TRUE, $removeLanguagePart = FALSE) {
 661     if (empty($url)) {
 662       return $url;
 663     }
 664
 665     //CRM-7803 -from d7 onward.
 666     $config = CRM_Core_Config::singleton();
 667     if (function_exists('variable_get') &&
 668       module_exists('locale') &&
 669       function_exists('language_negotiation_get')
 670     ) {
 671       global $language;
 672
 673       //does user configuration allow language
 674       //support from the URL (Path prefix or domain)
 675       if (language_negotiation_get('language') == 'locale-url') {
 676         $urlType = variable_get('locale_language_negotiation_url_part');
 677
 678         //url prefix
 679         if ($urlType == LOCALE_LANGUAGE_NEGOTIATION_URL_PREFIX) {
 680           if (isset($language->prefix) && $language->prefix) {
 681             if ($addLanguagePart) {
 682               $url .= $language->prefix . '/';
 683             }
 684             if ($removeLanguagePart) {
 685               $url = str_replace("/{$language->prefix}/", '/', $url);
 686             }
 687           }
 688         }
 689         //domain
 690         if ($urlType == LOCALE_LANGUAGE_NEGOTIATION_URL_DOMAIN) {
 691           if (isset($language->domain) && $language->domain) {
 692             if ($addLanguagePart) {
 693               $cleanedUrl = preg_replace('#^https?://#', '', $language->domain);
 694               // drupal function base_path() adds a "/" to the beginning and end of the returned path
 695               if (substr($cleanedUrl, -1) == '/') {
 696                 $cleanedUrl = substr($cleanedUrl, 0, -1);
 697               }
 698               $url = (CRM_Utils_System::isSSL() ? 'https' : 'http') . '://' . $cleanedUrl . base_path();
 699             }
 700             if ($removeLanguagePart && defined('CIVICRM_UF_BASEURL')) {
 701               $url = str_replace('\\', '/', $url);
 702               $parseUrl = parse_url($url);
 703
 704               //kinda hackish but not sure how to do it right
 705               //hope http_build_url() will help at some point.
 706               if (is_array($parseUrl) && !empty($parseUrl)) {
 707                 $urlParts = explode('/', $url);
 708                 $hostKey = array_search($parseUrl['host'], $urlParts);
 709                 $ufUrlParts = parse_url(CIVICRM_UF_BASEURL);
 710                 $urlParts[$hostKey] = $ufUrlParts['host'];
 711                 $url = implode('/', $urlParts);
 712               }
 713             }
 714           }
 715         }
 716       }
 717     }
 718
 719     return $url;
 720   }
 721
 722   /**
 723    * Find any users/roles/security-principals with the given permission
 724    * and replace it with one or more permissions.
 725    *
 726    * @param string $oldPerm
 727    * @param array $newPerms
 728    *   Array, strings.
 729    */
 730   public function replacePermission($oldPerm, $newPerms) {
 731     $roles = user_roles(FALSE, $oldPerm);
 732     if (!empty($roles)) {
 733       foreach (array_keys($roles) as $rid) {
 734         user_role_revoke_permissions($rid, [$oldPerm]);
 735         user_role_grant_permissions($rid, $newPerms);
 736       }
 737     }
 738   }
 739
 740   /**
 741    * Wrapper for og_membership creation.
 742    *
 743    * @param int $ogID
 744    *   Organic Group ID.
 745    * @param int $drupalID
 746    *   Drupal User ID.
 747    */
 748   public function og_membership_create($ogID, $drupalID) {
 749     if (function_exists('og_entity_query_alter')) {
 750       // sort-of-randomly chose a function that only exists in the // 7.x-2.x branch
 751       //
 752       // @TODO Find more solid way to check - try system_get_info('module', 'og').
 753       //
 754       // Also, since we don't know how to get the entity type of the // group, we'll assume it's 'node'
 755       og_group('node', $ogID, ['entity' => user_load($drupalID)]);
 756     }
 757     else {
 758       // Works for the OG 7.x-1.x branch
 759       og_group($ogID, ['entity' => user_load($drupalID)]);
 760     }
 761   }
 762
 763   /**
 764    * Wrapper for og_membership deletion.
 765    *
 766    * @param int $ogID
 767    *   Organic Group ID.
 768    * @param int $drupalID
 769    *   Drupal User ID.
 770    */
 771   public function og_membership_delete($ogID, $drupalID) {
 772     if (function_exists('og_entity_query_alter')) {
 773       // sort-of-randomly chose a function that only exists in the 7.x-2.x branch
 774       // TODO: Find a more solid way to make this test
 775       // Also, since we don't know how to get the entity type of the group, we'll assume it's 'node'
 776       og_ungroup('node', $ogID, 'user', user_load($drupalID));
 777     }
 778     else {
 779       // Works for the OG 7.x-1.x branch
 780       og_ungroup($ogID, 'user', user_load($drupalID));
 781     }
 782   }
 783
 784   /**
 785    * @inheritDoc
 786    */
 787   public function getTimeZoneString() {
 788     global $user;
 789     // Note that 0 is a valid timezone (GMT) so we use strlen not empty to check.
 790     if (variable_get('configurable_timezones', 1) && $user->uid && isset($user->timezone) && strlen($user->timezone)) {
 791       $timezone = $user->timezone;
 792     }
 793     else {
 794       $timezone = variable_get('date_default_timezone', NULL);
 795     }
 796     if (!$timezone) {
 797       $timezone = parent::getTimeZoneString();
 798     }
 799     return $timezone;
 800   }
 801
 802   /**
 803    * @inheritDoc
 804    */
 805   public function setHttpHeader($name, $value) {
 806     drupal_add_http_header($name, $value);
 807   }
 808
 809   /**
 810    * @inheritDoc
 811    */
 812   public function synchronizeUsers() {
 813     $config = CRM_Core_Config::singleton();
 814     if (PHP_SAPI != 'cli') {
 815       set_time_limit(300);
 816     }
 817     $id = 'uid';
 818     $mail = 'mail';
 819     $name = 'name';
 820
 821     $result = db_query("SELECT uid, mail, name FROM {users} where mail != ''");
 822
 823     $user = new StdClass();
 824     $uf = $config->userFramework;
 825     $contactCount = 0;
 826     $contactCreated = 0;
 827     $contactMatching = 0;
 828     foreach ($result as $row) {
 829       $user->$id = $row->$id;
 830       $user->$mail = $row->$mail;
 831       $user->$name = $row->$name;
 832       $contactCount++;
 833       if ($match = CRM_Core_BAO_UFMatch::synchronizeUFMatch($user, $row->$id, $row->$mail, $uf, 1, 'Individual', TRUE)) {
 834         $contactCreated++;
 835       }
 836       else {
 837         $contactMatching++;
 838       }
 839     }
 840
 841     return [
 842       'contactCount' => $contactCount,
 843       'contactMatching' => $contactMatching,
 844       'contactCreated' => $contactCreated,
 845     ];
 846   }
 847
 848   /**
 849    * Commit the session before exiting.
 850    * Similar to drupal_exit().
 851    */
 852   public function onCiviExit() {
 853     if (function_exists('module_invoke_all')) {
 854       if (!defined('MAINTENANCE_MODE') || MAINTENANCE_MODE != 'update') {
 855         module_invoke_all('exit');
 856       }
 857       drupal_session_commit();
 858     }
 859   }
 860
 861 }