'. t('The CiviCRM module stores information on the universe of people associated with a community and on their interactions such as emails, donations, petitions, events, etc. It can act as a stand alone contact management system or it can be integrated with mass mailer, volunteer management, petition, and event finding. CiviCRM enables organizations to maintain all these activities in a single database, creating efficiencies and new opportunities for communities to better communicate and benefit from relationships with their community members.') .'
'; $output .= ''. t('The CiviCRM module allows you to create contacts, or import them from other sources. You can record relationships between contacts, such as indicating they live in the same household. There are two types of groups of contacts. You can create static groups which have a set list of contacts. You can also create dynamic (smart) groups based on characteristics that contacts have in common. For example, you could create a group of all contacts who live in California AND who have volunteered for your organization within the past year. The CiviCRM module also allows for tagging for less formal categorization of contacts or groups. You can easily extend CiviCRM to record community member information which is specific to your community or organization using custom fields. For example, you can create a set of fields to track volunteer skills and preferences. CiviCRM profile gives you a way to allow community members (\'users\') to update their own information, as well as share some of that information with others. Finally, you can configure custom activity types such as volunteering or attending events.') .'
'; $output .= '' . t('You can:') . '
'; $output .= ''. t('For more information please refer to the CiviCRM web-site which includes project information, documentation and support resources and more.', array('!1' => 'http://civicrm.org')) .'
'; return $output; case 'admin/modules#description': // This description is shown in the listing at admin/modules. return t('Constituent Relationship Management (CiviCRM !1). Allows sites to manage contacts, relationships and groups, and track contact activities, contributions, memberships and events. For more information please refer to the CiviCRM web-site which includes project information, documentation and support resources and more.', array('!1' => '2.2', '!2' => 'http://civicrm.org/')); } } /** * Implementation of hook_perm(). * * Since the access to our new custom pages will be granted based on * special permissions, we need to define what those permissions are here. * This ensures that they are available to enable on the user role * administration pages. */ function civicrm_perm() { // make sure the system is initialized if ( ! civicrm_initialize( ) ) { return; } $config =& CRM_Core_Config::singleton(); require_once 'CRM/Core/Permission.php'; $permissions =& CRM_Core_Permission::basicPermissions( ); return array_keys( $permissions ); } /** * Implementation of hook_block(). * * This hook both declares to Drupal what blocks are provided by the module, and * generates the contents of the blocks themselves. */ function civicrm_block($op='list', $delta='0') { if ( $op == 'configure' ) { return; } if ( ! civicrm_initialize( ) ) { return; } // The $op parameter determines what piece of information is being requested. require_once 'CRM/Core/Block.php'; // CRM_Core_Error::backtrace( "$op, $delta" ); if ($op == 'list') { $block = CRM_Core_Block::getInfo(); } else { $block = CRM_Core_Block::getContent ($delta); } return $block; } /** * Implementation of hook_menu(). * * You must implement hook_menu() to emit items to place in the main menu. * This is a required step for modules wishing to display their own pages, * because the process of creating the links also tells Drupal what * callback function to use for a given URL. The menu items returned * here provide this information to the menu system. * * With the below menu definitions, URLs will be interpreted as follows: * * If the user accesses http://example.com/?q=foo, then the menu system * will first look for a menu item with that path. In this case it will * find a match, and execute civicrm_foo(). * */ function civicrm_menu( ) { if ( ! civicrm_initialize( ) ) { return; } return array( 'civicrm' => array( 'title' => 'CiviCRM', 'access callback' => true, 'page callback' => 'civicrm_invoke', 'type' => 4, 'weight' => 0, ) ); } /** * Initialize CiviCRM. Call this function from other modules too if * they use the CiviCRM API. * */ function civicrm_initialize( ) { // Check for php version and ensure its greater than 5. // do a fatal exit if if ( (int ) substr( PHP_VERSION, 0, 1 ) < 5 ) { echo "CiviCRM requires PHP Version 5.2 or greater. You are running PHP Version " . PHP_VERSION . ""; exit( ); } static $initialized = false; static $failure = false; if ( $failure ) { return false; } if ( ! $initialized ) { if ( function_exists( 'conf_path' ) ) { $settingsFile = conf_path( ) . '/civicrm.settings.php'; } else { $settingsFile = conf_init( ) . '/civicrm.settings.php'; } $error = include_once( $settingsFile ); // get ready for problems $docLinkInstall = "http://wiki.civicrm.org/confluence/display/CRMDOC/Drupal+Installation+Guide"; $docLinkTrouble = "http://wiki.civicrm.org/confluence/display/CRMDOC/Installation+and+Configuration+Trouble-shooting"; $forumLink = "http://forum.civicrm.org/index.php/board,6.0.html"; $errorMsgAdd = t("Please review the Drupal Installation Guide and the Trouble-shooting page for assistance. If you still need help installing, you can often find solutions to your issue by searching for the error message in the installation support section of the community forum.
", array('!1' => $docLinkInstall, '!2' => $docLinkTrouble, '!3' => $forumLink ) ); if ( $error == false ) { $failure = true; drupal_set_message( "" . t("Oops! - The CiviCRM settings file (civicrm.settings.php) was not found in the expected location ") . "(" . $settingsFile . ").
" . $errorMsgAdd . '
' ); return false; } // this does pretty much all of the civicrm initialization $error = include_once( 'CRM/Core/Config.php' ); if ( $error == false ) { $failure = true; drupal_set_message( "" . t("Oops! - The path for including CiviCRM code files is not set properly. Most likely there is an error in the civicrm_root setting in your CiviCRM settings file (!1).", array( '!1' => $settingsFile ) ) . "
» " . t("civicrm_root is currently set to: !1.", array( '!1' => $civicrm_root ) ) . "
" . $errorMsgAdd . "
" ); return false; } $initialized = true; // initialize the system by creating a config object $config =& CRM_Core_Config::singleton(); // Add module-specific header elements drupal_set_html_head(civicrm_html_head()); } return true; } /** * Function to get the contact type * @param string $default contact type * * @return $ctype contact type */ function civicrm_get_ctype( $default = null ) { // here we are creating a new contact // get the contact type from the POST variables if any if ( isset( $_REQUEST['ctype'] ) ) { $ctype = $_REQUEST['ctype']; } else if ( isset( $_REQUEST['edit'] ) && isset( $_REQUEST['edit']['ctype'] ) ) { $ctype = $_REQUEST['edit']['ctype']; } else { $ctype = $default; } if ( $ctype != 'Individual' && $ctype != 'Organization' && $ctype != 'Household' ) { $ctype = $default; } return $ctype; } /** * This is the main function that is called on any civicrm click * */ function civicrm_invoke( ) { // make sure the system is initialized if ( ! civicrm_initialize( ) ) { return drupal_not_found( ); } civicrm_cache_disable( ); require_once 'CRM/Core/Error.php'; $args = explode( '/', $_GET['q'] ); // synchronize the drupal uid with the contacts db global $user; /* FIXME: hack to bypass synchronize if running upgrade to avoid any serious non-recoverable error which might hinder the upgrade process. */ if ( !isset($args[1]) or $args[1] != 'upgrade' ) { require_once 'CRM/Core/BAO/UFMatch.php'; CRM_Core_BAO_UFMatch::synchronize( $user, false, 'Drupal', civicrm_get_ctype( 'Individual' ) ); } require_once 'CRM/Core/Invoke.php'; return CRM_Core_Invoke::invoke( $args ); } /** * User hook for civicrm module * * Note that we ignore the edit field and do not follow the drupal protocol * of extracting values from the edit field. We extract the fields directly * from $_POST. This is because the underlying form package that we use * (HTML_QuickForm) does the form value extraction and validation. * * @param string $type Type of operation being performed * @param array $edit The array of form values submitted by the user. * @param object $user The user object on which the operation is being performed. * @param object $category The active category of user information being edited. * * @return mixed depends on the operation being performed */ function civicrm_user( $type, &$edit, &$user, $category = NULL ) { if ( $type == 'load' ) { return; } if ( ! civicrm_initialize( ) ) { return; } switch ( $type ) { case 'login': require_once 'CRM/Core/BAO/UFMatch.php'; return CRM_Core_BAO_UFMatch::synchronize( $user, false, 'Drupal', civicrm_get_ctype( 'Individual' ) ); case 'register': $config =& CRM_Core_Config::singleton( ); if ( $config->inCiviCRM ) { return; } if ( empty( $_POST ) ) { return civicrm_register_data($edit, $user, $category, true, false ); } else { return civicrm_register_data( $edit, $user, $category, false, true ); } break; case 'insert': $config =& CRM_Core_Config::singleton( ); if ( $config->inCiviCRM ) { return; } // did civicrm generate this page, or is it via a user hook? if ( civicrm_on_user_page( ) ) { return civicrm_register_data($edit, $user, $category, false); } else { require_once 'CRM/Core/BAO/UFMatch.php'; CRM_Core_BAO_UFMatch::synchronize( $user, false, 'Drupal', civicrm_get_ctype( 'Individual' ) ); } break; case 'view': return civicrm_view_data($user); case 'update': // this always comes in via user hook, so udpate email only if it has changed if ( isset( $edit['mail'] ) && trim( $edit['mail'] ) != trim( $user->mail ) ) { require_once 'CRM/Core/BAO/UFMatch.php'; $contactID = CRM_Core_BAO_UFMatch::getContactId( $user->uid ); // cant find the contactID, so lets skip if ( ! $contactID ) { return; } CRM_Core_BAO_UFMatch::updateContactEmail( $contactID, trim( $edit['mail'] ) ); } break; case 'form': $inCategory = true; if ( $category ) { $inCategory = false; $categories = civicrm_categories( $account ); foreach ( $categories as $cat ) { if ( $category == $cat['name'] ) { $inCategory = true; break; } } } // only return a form to drupal my account page if ( $inCategory && arg(0) == 'user' && arg(2) == 'edit' && arg(3) ) { if ( empty( $_POST ) ) { return civicrm_form_data($edit, $user, $category, true, false ); } else { return civicrm_form_data($edit, $user, $category, true, true ); } } break; case 'validate': return civicrm_validate_data($edit, $user, $category); case 'categories': return civicrm_categories( $user ); case 'delete': require_once 'CRM/Core/BAO/UFMatch.php'; return CRM_Core_BAO_UFMatch::deleteUser( $user->uid ); } } /** * Determine if the user is on a CiviCRM generated page, i.e. the form has some civicrm unique token */ function civicrm_on_user_page() { return isset( $_POST['_qf_default'] ); } function civicrm_categories( &$user ) { if ( ! civicrm_initialize( ) ) { return; } require_once 'CRM/Core/BAO/UFGroup.php'; require_once 'CRM/Core/BAO/UFField.php'; $allUFGroups =& CRM_Core_BAO_UFGroup::getModuleUFGroup('User Account'); $ufGroups = array( ); $weight = 100; foreach ($allUFGroups as $key => $value) { if ( $value['is_active'] ) { $ufGroups[] = array( 'name' => $value['name'], 'title' => $value['name'], 'weight' => $weight ); $weight += 10; } } return $ufGroups; } function civicrm_register_data($edit, &$user, $category, $reset, $doNotProcess = false ) { require_once 'CRM/Core/BAO/UFMatch.php'; require_once 'CRM/Core/BAO/UFGroup.php'; require_once 'CRM/Core/Action.php'; // lets suppress key generation for all registration forms civicrm_key_disable( ); $ctype = civicrm_get_ctype( 'Individual' ); if ( $user->uid ) { // Happens on $type == 'insert' // $reset == false always // $doNotProcess == false always CRM_Core_BAO_UFMatch::synchronize( $user, true, 'Drupal', $ctype ); $userID = CRM_Core_BAO_UFMatch::getContactId( $user->uid ); $html = CRM_Core_BAO_UFGroup::getEditHTML( $userID, '', 2, true, $reset, null, $doNotProcess, $ctype ); } else { // Happens on $type == 'register' $html = CRM_Core_BAO_UFGroup::getEditHTML( $userID, '', 1, true, $reset, null, $doNotProcess, $ctype ); } $output = array( ); if ( $html ) { $html = civicrm_add_jquery( $html ); $index = empty( $category ) ? 'civicrm-profile-register' : $category; $output[$index] = array( '#title' => $category, '#value' => $html, '#weight' => 1 ); } return $output; } function civicrm_form_data($edit, &$user, $category, $reset, $doNotProcess = false) { require_once 'CRM/Core/BAO/UFMatch.php'; require_once 'CRM/Core/BAO/UFGroup.php'; // lets suppress key generation for all CMS forms civicrm_key_disable( ); $output = array( ); $userID = CRM_Core_BAO_UFMatch::getContactId( $user->uid ); if ( ! $userID ) { $ctype = civicrm_get_ctype( 'Individual' ); CRM_Core_BAO_UFMatch::synchronize( $user, false, 'Drupal', $ctype ); $userID = CRM_Core_BAO_UFMatch::getContactId( $user->uid ); } // at this point we better have a valid userID if ( ! $userID ) { // we get into this scenario if we do not like the email address supplied by the user return; } $ctype = CRM_Core_DAO::getFieldValue( 'CRM_Contact_DAO_Contact', $userID, 'contact_type' ); //to allow Edit any profile if user have permission $profileID = CRM_Core_DAO::getFieldValue( "CRM_Core_DAO_UFGroup", $category, 'id', 'title' ); require_once 'CRM/Core/Permission.php'; $ufGroupIDs = CRM_Core_Permission::ufGroupClause( CRM_Core_Permission::EDIT, null, true ); if ( in_array($profileID, $ufGroupIDs) ) { // get all the data for this specific category $html = CRM_Core_BAO_UFGroup::getEditHTML( $userID, $category, null, false, $reset, null, $doNotProcess, $ctype ); } else { CRM_Core_Error::fatal( ts( 'The requested Profile (gid=%1) is disabled OR it is not configured to be used for \'Profile\' listings in its Settings OR there is no Profile with that ID OR you do not have permission to access this profile. Please contact the site administrator if you need assistance.', array( 1 => $profileID ))); } if ( $html ) { $html = civicrm_add_jquery( $html ); $index = empty( $category ) ? 'civicrm-profile-my-account' : $category; $output[$index][] = array( '#title' => $category, '#value' => $html, '#weight' => 1 ); } return $output; } function civicrm_view_data( &$user ) { require_once 'CRM/Core/BAO/UFMatch.php'; $userID = CRM_Core_BAO_UFMatch::getContactId( $user->uid ); if ( $userID ) { // make sure user has permission to view the record require_once 'CRM/Contact/BAO/Contact.php'; require_once 'CRM/Contact/BAO/Contact/Permission.php'; $contactURL = null; if ( CRM_Core_Permission::check( 'access CiviCRM' ) && CRM_Contact_BAO_Contact_Permission::allow( $userID ) ) { $url = CRM_Utils_System::url( 'civicrm/contact/view', "reset=1&cid=$userID" ); $contactURL = '» ' .t("View Contact Record") . ''; } if ( CRM_Core_Permission::check( 'access Contact Dashboard' ) ) { $url = CRM_Utils_System::url( 'civicrm/user', "reset=1&id=$userID" ); if ( ! empty( $contactURL ) ) { $contactURL .= '