| GNU Affero General Public License or the licensing of CiviCRM, |
| see the CiviCRM license FAQ at http://civicrm.org/licensing |
+--------------------------------------------------------------------+
-*/
+ */
/**
*
* If we are using a theming system, invoke theme, else just print the
* content
*
- * @param string $content the content that will be themed
- * @param boolean $print are we displaying to the screen or bypassing theming?
- * @param boolean $maintenance for maintenance mode
+ * @param string $content
+ * The content that will be themed.
+ * @param bool $print
+ * Are we displaying to the screen or bypassing theming?.
+ * @param bool $maintenance
+ * For maintenance mode.
*
- * @return void prints content on stdout
+ * @return void
+ * prints content on stdout
*/
public function theme(&$content, $print = FALSE, $maintenance = FALSE) {
// TODO: Simplify; this was copied verbatim from CiviCRM 3.4's multi-UF theming function, but that's more complex than necessary
/**
* Create a user in Drupal.
*
- * @param array $params associated array
- * @param string $mail email id for cms user
- *
- * @return uid if user exists, false otherwise
+ * @param array $params
+ * @param string $mail
+ * Email id for cms user.
*
+ * @return int|bool
+ * uid if user exists, false otherwise
*/
public function createUser(&$params, $mail) {
$form_state = array();
return $form_state['user']->uid;
}
- /*
- * Change user name in host CMS
- *
- * @param integer $ufID User ID in CMS
- * @param string $ufName User name
- */
/**
- * @param int $ufID
- * @param string $ufName
+ * Change user name in host CMS
+ *
+ * @param int $ufID User ID in CMS
+ * @param string $ufName User name
*/
public function updateCMSName($ufID, $ufName) {
// CRM-5555
/**
* Check if username and email exists in the drupal db
*
- * @param array $params array of name and mail values
- * @param array $errors array of errors
- * @param string $emailName field label for the 'email'
+ * @param array $params
+ * Array of name and mail values.
+ * @param array $errors
+ * Array of errors.
+ * @param string $emailName
+ * Field label for the 'email'.
*
* @return void
*/
public function checkUserNameEmailExists(&$params, &$errors, $emailName = 'email') {
$config = CRM_Core_Config::singleton();
- $dao = new CRM_Core_DAO();
- $name = $dao->escape(CRM_Utils_Array::value('name', $params));
+ $dao = new CRM_Core_DAO();
+ $name = $dao->escape(CRM_Utils_Array::value('name', $params));
$email = $dao->escape(CRM_Utils_Array::value('mail', $params));
_user_edit_validate(NULL, $params);
$errors = form_get_errors();
);
}
if (strtolower($dbEmail) == strtolower($email)) {
- if(empty($email)) {
+ if (empty($email)) {
$errors[$emailName] = ts('You cannot create an email account for a contact with no email',
array(1 => $email)
);
}
- else{
+ else {
$errors[$emailName] = ts('This email %1 is already registered. Please select another email.',
array(1 => $email)
);
* Get the drupal destination string. When this is passed in the
* URL the user will be directed to it after filling in the drupal form
*
- * @param CRM_Core_Form $form Form object representing the 'current' form - to which the user will be returned
- * @return string $destination destination value for URL
- *
+ * @param CRM_Core_Form $form
+ * Form object representing the 'current' form - to which the user will be returned.
+ * @return string
+ * destination value for URL
*/
public function getLoginDestination(&$form) {
$args = NULL;
/**
* Append a string to the head of the html file
*
- * @param string $head the new string to be appended
+ * @param string $head
+ * The new string to be appended.
*
* @return void
*/
/**
* Add a script file
*
- * @param $url: string, absolute path to file
- * @param $region string, location within the document: 'html-header', 'page-header', 'page-footer'
+ * @param $url : string, absolute path to file
+ * @param string $region
+ * location within the document: 'html-header', 'page-header', 'page-footer'.
*
* Note: This function is not to be called directly
* @see CRM_Core_Region::render()
*
- * @return bool TRUE if we support this operation in this CMS, FALSE otherwise
+ * @return bool
+ * TRUE if we support this operation in this CMS, FALSE otherwise
*/
public function addScriptUrl($url, $region) {
// CRM-15450 - D6 doesn't order internal/external links correctly so we can't use drupal_add_js
/**
* Add an inline script
*
- * @param $code: string, javascript code
- * @param $region string, location within the document: 'html-header', 'page-header', 'page-footer'
+ * @param $code : string, javascript code
+ * @param string $region
+ * location within the document: 'html-header', 'page-header', 'page-footer'.
*
* Note: This function is not to be called directly
* @see CRM_Core_Region::render()
*
- * @return bool TRUE if we support this operation in this CMS, FALSE otherwise
+ * @return bool
+ * TRUE if we support this operation in this CMS, FALSE otherwise
*/
public function addScript($code, $region) {
// CRM-15450 - ensure scripts are in correct order
/**
* Add a css file
*
- * @param $url: string, absolute path to file
- * @param $region string, location within the document: 'html-header', 'page-header', 'page-footer'
+ * @param $url : string, absolute path to file
+ * @param string $region
+ * location within the document: 'html-header', 'page-header', 'page-footer'.
*
* Note: This function is not to be called directly
* @see CRM_Core_Region::render()
*
- * @return bool TRUE if we support this operation in this CMS, FALSE otherwise
+ * @return bool
+ * TRUE if we support this operation in this CMS, FALSE otherwise
*/
public function addStyleUrl($url, $region) {
if ($region != 'html-header' || !$this->formatResourceUrl($url)) {
/**
* Add an inline style
*
- * @param $code: string, css code
- * @param $region string, location within the document: 'html-header', 'page-header', 'page-footer'
+ * @param $code : string, css code
+ * @param string $region
+ * location within the document: 'html-header', 'page-header', 'page-footer'.
*
* Note: This function is not to be called directly
* @see CRM_Core_Region::render()
*
- * @return bool TRUE if we support this operation in this CMS, FALSE otherwise
+ * @return bool
+ * TRUE if we support this operation in this CMS, FALSE otherwise
*/
public function addStyle($code, $region) {
return FALSE;
/**
* Rewrite various system urls to https
- *
- * @param null
- *
- * @return void
*/
public function mapConfigToSSL() {
global $base_url;
/**
* Figure out the post url for the form
*
- * @param mix $action the default action if one is pre-specified
+ * @param mix $action
+ * The default action if one is pre-specified.
*
- * @return string the url to post the form
+ * @return string
+ * the url to post the form
*/
public function postURL($action) {
if (!empty($action)) {
/**
* Authenticate the user against the drupal db
*
- * @param string $name the user name
- * @param string $password the password for the above user name
- * @param boolean $loadCMSBootstrap load cms bootstrap?
+ * @param string $name
+ * The user name.
+ * @param string $password
+ * The password for the above user name.
+ * @param bool $loadCMSBootstrap
+ * Load cms bootstrap?.
* @param NULL|string $realPath filename of script
*
- * @return mixed false if no auth
- * array(
- * contactID, ufID, unique string ) if success
+ * @return array|bool
+ * [contactID, ufID, uniqueString] if success else false if no auth
*/
public function authenticate($name, $password, $loadCMSBootstrap = FALSE, $realPath = NULL) {
- //@todo this 'PEAR-y' stuff is only required when bookstrap is not being loaded which is rare
- // if ever now.
- // probably if bootstrap is loaded this call
- // CRM_Utils_System::loadBootStrap($bootStrapParams, TRUE, TRUE, $realPath); would be
- // sufficient to do what this fn does. It does exist as opposed to return which might need some hanky-panky to make
- // safe in the unknown situation where authenticate might be called & it is important that
- // false is returned
+ //@todo this 'PEAR-y' stuff is only required when bookstrap is not being loaded which is rare
+ // if ever now.
+ // probably if bootstrap is loaded this call
+ // CRM_Utils_System::loadBootStrap($bootStrapParams, TRUE, TRUE, $realPath); would be
+ // sufficient to do what this fn does. It does exist as opposed to return which might need some hanky-panky to make
+ // safe in the unknown situation where authenticate might be called & it is important that
+ // false is returned
require_once 'DB.php';
$config = CRM_Core_Config::singleton();
}
$strtolower = function_exists('mb_strtolower') ? 'mb_strtolower' : 'strtolower';
- $dbpassword = md5($password);
- $name = $dbDrupal->escapeSimple($strtolower($name));
- $sql = 'SELECT u.* FROM ' . $config->userFrameworkUsersTableName . " u WHERE LOWER(u.name) = '$name' AND u.pass = '$dbpassword' AND u.status = 1";
- $query = $dbDrupal->query($sql);
+ $dbpassword = md5($password);
+ $name = $dbDrupal->escapeSimple($strtolower($name));
+ $sql = 'SELECT u.* FROM ' . $config->userFrameworkUsersTableName . " u WHERE LOWER(u.name) = '$name' AND u.pass = '$dbpassword' AND u.status = 1";
+ $query = $dbDrupal->query($sql);
$user = NULL;
// need to change this to make sure we matched only one row
if (!$contactID) {
return FALSE;
}
- else{//success
+ else {
+ //success
if ($loadCMSBootstrap) {
$bootStrapParams = array();
if ($name && $password) {
$bootStrapParams = array(
- 'name' => $name,
- 'pass' => $password,
+ 'name' => $name,
+ 'pass' => $password,
);
}
CRM_Utils_System::loadBootStrap($bootStrapParams, TRUE, TRUE, $realPath);
* e.g. for drupal : records a watchdog message about the new session,
* saves the login timestamp, calls hook_user op 'login' and generates a new session.
*
- * @param array params
+ * @param array $params
*
* FIXME: Document values accepted/required by $params
*/
/**
* Set a message in the UF to display to a user
*
- * @param string $message the message to set
- *
+ * @param string $message
+ * The message to set.
*/
public function setMessage($message) {
drupal_set_message($message);
/**
* Get the locale set in the hosting CMS
*
- * @return string with the locale or null for none
+ * @return string
+ * with the locale or null for none
*/
public function getUFLocale() {
// return CiviCRM’s xx_YY locale that either matches Drupal’s Chinese locale
/**
* Load drupal bootstrap
*
- * @param array $params Either uid, or name & pass.
- * @param boolean $loadUser boolean Require CMS user load.
- * @param boolean $throwError If true, print error on failure and exit.
- * @param boolean|string $realPath path to script
+ * @param array $params
+ * Either uid, or name & pass.
+ * @param bool $loadUser
+ * Boolean Require CMS user load.
+ * @param bool $throwError
+ * If true, print error on failure and exit.
+ * @param bool|string $realPath path to script
*
* @return bool
*/
// which means that define(CIVICRM_CLEANURL) was correctly set.
// So we correct it
$config = CRM_Core_Config::singleton();
- $config->cleanURL = (int)variable_get('clean_url', '0');
+ $config->cleanURL = (int) variable_get('clean_url', '0');
// CRM-8655: Drupal wasn't available during bootstrap, so hook_civicrm_config never executes
CRM_Utils_Hook::config($config);
}
/**
- *
*/
public function cmsRootPath($scriptFilename = NULL) {
$cmsRoot = $valid = NULL;
do {
$cmsRoot = $firstVar . '/' . implode('/', $pathVars);
$cmsIncludePath = "$cmsRoot/includes";
- //stop as we found bootstrap.
- if (@opendir($cmsIncludePath) &&
- file_exists("$cmsIncludePath/bootstrap.inc")
- ) {
+ // Stop if we found bootstrap.
+ if (file_exists("$cmsIncludePath/bootstrap.inc")) {
$valid = TRUE;
break;
}
/**
* Check is user logged in.
*
- * @return boolean true/false.
+ * @return bool
*/
public function isUserLoggedIn() {
$isloggedIn = FALSE;
/**
* Get currently logged in user uf id.
*
- * @return int $userID logged in user uf id.
+ * @return int
+ * $userID logged in user uf id.
*/
public function getLoggedInUfID() {
$ufID = NULL;
* @param bool $addLanguagePart
* @param bool $removeLanguagePart
*
- * @return string $url, formatted url.
- * @static
+ * @return string
+ * , formatted url.
*/
public function languageNegotiationURL($url, $addLanguagePart = TRUE, $removeLanguagePart = FALSE) {
if (empty($url)) {
$language->prefix &&
in_array($mode, array(
LANGUAGE_NEGOTIATION_PATH,
- LANGUAGE_NEGOTIATION_PATH_DEFAULT,
- ))
+ LANGUAGE_NEGOTIATION_PATH_DEFAULT,
+ ))
) {
if ($addLanguagePart) {
//kinda hackish but not sure how to do it right
//hope http_build_url() will help at some point.
if (is_array($parseUrl) && !empty($parseUrl)) {
- $urlParts = explode('/', $url);
- $hostKey = array_search($parseUrl['host'], $urlParts);
- $ufUrlParts = parse_url(CIVICRM_UF_BASEURL);
+ $urlParts = explode('/', $url);
+ $hostKey = array_search($parseUrl['host'], $urlParts);
+ $ufUrlParts = parse_url(CIVICRM_UF_BASEURL);
$urlParts[$hostKey] = $ufUrlParts['host'];
- $url = implode('/', $urlParts);
+ $url = implode('/', $urlParts);
}
}
}
* Find any users/roles/security-principals with the given permission
* and replace it with one or more permissions.
*
- * @param $oldPerm string
- * @param $newPerms array, strings
+ * @param string $oldPerm
+ * @param array $newPerms
+ * Array, strings.
*
* @return void
*/
$perms = $perms + drupal_map_assoc($newPerms);
$permList = implode(', ', $perms);
db_query('UPDATE {permission} SET perm = "%s" WHERE rid = %d', $permList, $rid);
- /*
+ /* @codingStandardsIgnoreStart
if ( ! empty( $roles ) ) {
$rids = implode(',', array_keys($roles));
db_query( 'UPDATE {permission} SET perm = CONCAT( perm, \', edit all events\') WHERE rid IN (' . implode(',', array_keys($roles)) . ')' );
db_query( "UPDATE {permission} SET perm = REPLACE( perm, '%s', '%s' ) WHERE rid IN ($rids)",
- $oldPerm, implode(', ', $newPerms) );*/
+ $oldPerm, implode(', ', $newPerms) );
+ @codingStandardsIgnoreEnd */
}
}
/**
* Get a list of all installed modules, including enabled and disabled ones
*
- * @return array CRM_Core_Module
+ * @return array
+ * CRM_Core_Module
*/
public function getModules() {
$result = array();
/**
* Get user login URL for hosting CMS (method declared in each CMS system class)
*
- * @param string $destination - if present, add destination to querystring (works for Drupal only)
+ * @param string $destination
+ * If present, add destination to querystring (works for Drupal only).
*
- * @return string - loginURL for the current CMS
- * @static
+ * @return string
+ * loginURL for the current CMS
*/
public function getLoginURL($destination = '') {
$config = CRM_Core_Config::singleton();
/**
* Wrapper for og_membership creation
*
- * @param integer $ogID Organic Group ID
- * @param integer $drupalID drupal User ID
+ * @param int $ogID
+ * Organic Group ID.
+ * @param int $drupalID
+ * Drupal User ID.
*/
- public function og_membership_create($ogID, $drupalID){
- og_save_subscription( $ogID, $drupalID, array( 'is_active' => 1 ) );
+ public function og_membership_create($ogID, $drupalID) {
+ og_save_subscription($ogID, $drupalID, array('is_active' => 1));
}
/**
* Wrapper for og_membership deletion
*
- * @param integer $ogID Organic Group ID
- * @param integer $drupalID drupal User ID
+ * @param int $ogID
+ * Organic Group ID.
+ * @param int $drupalID
+ * Drupal User ID.
*/
public function og_membership_delete($ogID, $drupalID) {
- og_delete_subscription( $ogID, $drupalID );
+ og_delete_subscription($ogID, $drupalID);
}
/**
* Over-ridable function to get timezone as a string eg.
- * @return string Timezone e.g. 'America/Los_Angeles'
+ * @return string
+ * Timezone e.g. 'America/Los_Angeles'
*/
public function getTimeZoneString() {
global $user;
if (variable_get('configurable_timezones', 1) && $user->uid && strlen($user->timezone)) {
$timezone = $user->timezone;
- } else {
- $timezone = variable_get('date_default_timezone', null);
+ }
+ else {
+ $timezone = variable_get('date_default_timezone', NULL);
}
if (!$timezone) {
$timezone = parent::getTimeZoneString();
public function flush() {
drupal_flush_all_caches();
}
+
}