CRM/Member/Page/Tab.php

   1 <?php
   2 /*
   3  +--------------------------------------------------------------------+
   4  | CiviCRM version 4.5                                                |
   5  +--------------------------------------------------------------------+
   6  | Copyright CiviCRM LLC (c) 2004-2014                                |
   7  +--------------------------------------------------------------------+
   8  | This file is a part of CiviCRM.                                    |
   9  |                                                                    |
  10  | CiviCRM is free software; you can copy, modify, and distribute it  |
  11  | under the terms of the GNU Affero General Public License           |
  12  | Version 3, 19 November 2007 and the CiviCRM Licensing Exception.   |
  13  |                                                                    |
  14  | CiviCRM is distributed in the hope that it will be useful, but     |
  15  | WITHOUT ANY WARRANTY; without even the implied warranty of         |
  16  | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.               |
  17  | See the GNU Affero General Public License for more details.        |
  18  |                                                                    |
  19  | You should have received a copy of the GNU Affero General Public   |
  20  | License and the CiviCRM Licensing Exception along                  |
  21  | with this program; if not, contact CiviCRM LLC                     |
  22  | at info[AT]civicrm[DOT]org. If you have questions about the        |
  23  | GNU Affero General Public License or the licensing of CiviCRM,     |
  24  | see the CiviCRM license FAQ at http://civicrm.org/licensing        |
  25  +--------------------------------------------------------------------+
  26 */
  27
  28 /**
  29  *
  30  * @package CRM
  31  * @copyright CiviCRM LLC (c) 2004-2014
  32  * $Id$
  33  *
  34  */
  35 class CRM_Member_Page_Tab extends CRM_Core_Page {
  36
  37   /**
  38    * The action links that we need to display for the browse screen
  39    *
  40    * @var array
  41    * @static
  42    */
  43   static $_links = NULL;
  44   static $_membershipTypesLinks = NULL;
  45
  46   public $_permission = NULL;
  47   public $_contactId = NULL;
  48
  49   /**
  50    * This function is called when action is browse
  51    *
  52    * return null
  53    * @access public
  54    */
  55   function browse() {
  56     $links = self::links('all', $this->_isPaymentProcessor, $this->_accessContribution);
  57
  58     $membership = array();
  59     $dao = new CRM_Member_DAO_Membership();
  60     $dao->contact_id = $this->_contactId;
  61     $dao->is_test = 0;
  62     //$dao->orderBy('name');
  63     $dao->find();
  64
  65     //CRM--4418, check for view, edit, delete
  66     $permissions = array(CRM_Core_Permission::VIEW);
  67     if (CRM_Core_Permission::check('edit memberships')) {
  68       $permissions[] = CRM_Core_Permission::EDIT;
  69     }
  70     if (CRM_Core_Permission::check('delete in CiviMember')) {
  71       $permissions[] = CRM_Core_Permission::DELETE;
  72     }
  73     $mask = CRM_Core_Action::mask($permissions);
  74
  75     // get deceased status id
  76     $allStatus = CRM_Member_PseudoConstant::membershipStatus();
  77     $deceasedStatusId = array_search('Deceased', $allStatus);
  78
  79     //get all campaigns.
  80     $allCampaigns = CRM_Campaign_BAO_Campaign::getCampaigns(NULL, NULL, FALSE, FALSE, FALSE, TRUE);
  81
  82     //checks membership of contact itself
  83     while ($dao->fetch()) {
  84       $membership[$dao->id] = array();
  85       CRM_Core_DAO::storeValues($dao, $membership[$dao->id]);
  86
  87       //carry campaign.
  88       $membership[$dao->id]['campaign'] = CRM_Utils_Array::value($dao->campaign_id, $allCampaigns);
  89
  90       //get the membership status and type values.
  91       $statusANDType = CRM_Member_BAO_Membership::getStatusANDTypeValues($dao->id);
  92       foreach (array('status', 'membership_type') as $fld) {
  93         $membership[$dao->id][$fld] = CRM_Utils_Array::value($fld, $statusANDType[$dao->id]);
  94       }
  95       if (!empty($statusANDType[$dao->id]['is_current_member'])) {
  96         $membership[$dao->id]['active'] = TRUE;
  97       }
  98       if (empty($dao->owner_membership_id)) {
  99         // unset renew and followup link for deceased membership
 100         $currentMask = $mask;
 101         if ($dao->status_id == $deceasedStatusId) {
 102           $currentMask = $currentMask & ~CRM_Core_Action::RENEW & ~CRM_Core_Action::FOLLOWUP;
 103         }
 104
 105         $isUpdateBilling = FALSE;
 106         $paymentObject = CRM_Financial_BAO_PaymentProcessor::getProcessorForEntity(
 107           $membership[$dao->id]['membership_id'], 'membership', 'obj');
 108         if (!empty($paymentObject)) {
 109           $isUpdateBilling = $paymentObject->isSupported('updateSubscriptionBillingInfo');
 110         }
 111
 112         $isCancelSupported = CRM_Member_BAO_Membership::isCancelSubscriptionSupported(
 113           $membership[$dao->id]['membership_id']);
 114
 115         $membership[$dao->id]['action'] = CRM_Core_Action::formLink(self::links('all',
 116             NULL,
 117             NULL,
 118             $isCancelSupported,
 119             $isUpdateBilling
 120           ),
 121           $currentMask,
 122           array(
 123             'id' => $dao->id,
 124             'cid' => $this->_contactId,
 125           ),
 126           ts('more'),
 127           FALSE,
 128           'membership.tab.row',
 129           'Membership',
 130           $dao->id
 131         );
 132       }
 133       else {
 134         $membership[$dao->id]['action'] = CRM_Core_Action::formLink(self::links('view'),
 135           $mask,
 136           array(
 137             'id' => $dao->id,
 138             'cid' => $this->_contactId,
 139           ),
 140           ts('more'),
 141           FALSE,
 142           'membership.tab.row',
 143           'Membership',
 144           $dao->id
 145         );
 146       }
 147
 148       //does membership have auto renew CRM-7137.
 149       if (!empty($membership[$dao->id]['contribution_recur_id']) &&
 150         !CRM_Member_BAO_Membership::isSubscriptionCancelled($membership[$dao->id]['membership_id'])
 151       ) {
 152         $membership[$dao->id]['auto_renew'] = 1;
 153       }
 154       else {
 155         $membership[$dao->id]['auto_renew'] = 0;
 156       }
 157
 158       // if relevant, count related memberships
 159       if (CRM_Utils_Array::value('is_current_member', $statusANDType[$dao->id]) // membership is active
 160         && CRM_Utils_Array::value('relationship_type_id', $statusANDType[$dao->id]) // membership type allows inheritance
 161         && empty($dao->owner_membership_id)
 162       ) { // not an related membership
 163         $query = "
 164  SELECT COUNT(m.id)
 165    FROM civicrm_membership m
 166      LEFT JOIN civicrm_membership_status ms ON ms.id = m.status_id
 167      LEFT JOIN civicrm_contact ct ON ct.id = m.contact_id
 168   WHERE m.owner_membership_id = {$dao->id} AND m.is_test = 0 AND ms.is_current_member = 1 AND ct.is_deleted = 0";
 169         $num_related = CRM_Core_DAO::singleValueQuery($query);
 170         $max_related = CRM_Utils_Array::value('max_related', $membership[$dao->id]);
 171         $membership[$dao->id]['related_count'] = ($max_related == '' ?
 172           ts('%1 created', array(1 => $num_related)) :
 173           ts('%1 out of %2', array(1 => $num_related, 2 => $max_related))
 174         );
 175       }
 176       else {
 177         $membership[$dao->id]['related_count'] = ts('N/A');
 178       }
 179     }
 180
 181     //Below code gives list of all Membership Types associated
 182     //with an Organization(CRM-2016)
 183     $membershipTypes = CRM_Member_BAO_MembershipType::getMembershipTypesByOrg($this->_contactId);
 184     foreach ($membershipTypes as $key => $value) {
 185       $membershipTypes[$key]['action'] = CRM_Core_Action::formLink(self::membershipTypeslinks(),
 186         $mask,
 187         array(
 188           'id' => $value['id'],
 189           'cid' => $this->_contactId,
 190         ),
 191         ts('more'),
 192         FALSE,
 193         'membershipType.organization.action',
 194         'MembershipType',
 195         $value['id']
 196       );
 197     }
 198
 199     $activeMembers = CRM_Member_BAO_Membership::activeMembers($membership);
 200     $inActiveMembers = CRM_Member_BAO_Membership::activeMembers($membership, 'inactive');
 201     $this->assign('activeMembers', $activeMembers);
 202     $this->assign('inActiveMembers', $inActiveMembers);
 203     $this->assign('membershipTypes', $membershipTypes);
 204
 205     if ($this->_contactId) {
 206       $displayName = CRM_Contact_BAO_Contact::displayName($this->_contactId);
 207       $this->assign('displayName', $displayName);
 208       $this->ajaxResponse['tabCount'] = CRM_Contact_BAO_Contact::getCountComponent('membership', $this->_contactId);
 209       // Refresh other tabs with related data
 210       $this->ajaxResponse['updateTabs'] = array(
 211         '#tab_contribute' => CRM_Contact_BAO_Contact::getCountComponent('contribution', $this->_contactId),
 212         '#tab_activity' => CRM_Contact_BAO_Contact::getCountComponent('activity', $this->_contactId),
 213         '#tab_rel' => CRM_Contact_BAO_Contact::getCountComponent('rel', $this->_contactId),
 214       );
 215     }
 216   }
 217
 218   /**
 219    * This function is called when action is view
 220    *
 221    * return null
 222    * @access public
 223    */
 224   function view() {
 225     $controller = new CRM_Core_Controller_Simple(
 226       'CRM_Member_Form_MembershipView',
 227       ts('View Membership'),
 228       $this->_action
 229     );
 230     $controller->setEmbedded(TRUE);
 231     $controller->set('id', $this->_id);
 232     $controller->set('cid', $this->_contactId);
 233
 234     return $controller->run();
 235   }
 236
 237   /**
 238    * This function is called when action is update or new
 239    *
 240    * return null
 241    * @access public
 242    */
 243   function edit() {
 244     // set https for offline cc transaction
 245     $mode = CRM_Utils_Request::retrieve('mode', 'String', $this);
 246     if ($mode == 'test' || $mode == 'live') {
 247       CRM_Utils_System::redirectToSSL();
 248     }
 249
 250     // build associated contributions ( note: this is called to show associated contributions in edit mode )
 251     if ($this->_action & CRM_Core_Action::UPDATE) {
 252       $this->assign('accessContribution', FALSE);
 253       if (CRM_Core_Permission::access('CiviContribute')) {
 254         $this->assign('accessContribution', TRUE);
 255         CRM_Member_Page_Tab::associatedContribution($this->_contactId, $this->_id);
 256       }
 257     }
 258
 259     if ($this->_action & CRM_Core_Action::RENEW) {
 260       $path = 'CRM_Member_Form_MembershipRenewal';
 261       $title = ts('Renew Membership');
 262     }
 263     else {
 264       $path = 'CRM_Member_Form_Membership';
 265       $title = ts('Create Membership');
 266     }
 267
 268     $controller = new CRM_Core_Controller_Simple($path, $title, $this->_action);
 269     $controller->setEmbedded(TRUE);
 270     $controller->set('BAOName', $this->getBAOName());
 271     $controller->set('id', $this->_id);
 272     $controller->set('cid', $this->_contactId);
 273     return $controller->run();
 274   }
 275
 276   function preProcess() {
 277     $context = CRM_Utils_Request::retrieve('context', 'String', $this);
 278     $this->_action = CRM_Utils_Request::retrieve('action', 'String', $this, FALSE, 'browse');
 279     $this->_id = CRM_Utils_Request::retrieve('id', 'Positive', $this);
 280
 281     if ($context == 'standalone') {
 282       $this->_action = CRM_Core_Action::ADD;
 283     }
 284     else {
 285       $this->_contactId = CRM_Utils_Request::retrieve('cid', 'Positive', $this, TRUE);
 286       $this->assign('contactId', $this->_contactId);
 287
 288       // check logged in url permission
 289       CRM_Contact_Page_View::checkUserPermission($this);
 290
 291       // set page title
 292       CRM_Contact_Page_View::setTitle($this->_contactId);
 293     }
 294
 295     $this->assign('action', $this->_action);
 296
 297     if ($this->_permission == CRM_Core_Permission::EDIT && !CRM_Core_Permission::check('edit memberships')) {
 298       // demote to view since user does not have edit membership rights
 299       $this->_permission = CRM_Core_Permission::VIEW;
 300       $this->assign('permission', 'view');
 301     }
 302   }
 303
 304   /**
 305    * This function is the main function that is called when the page loads, it decides the which action has to be taken for the page.
 306    *
 307    * return null
 308    * @access public
 309    */
 310   function run() {
 311     $this->preProcess();
 312
 313     // check if we can process credit card membership
 314     $newCredit = CRM_Core_Payment::allowBackofficeCreditCard($this);
 315     if ($newCredit) {
 316       $this->_isPaymentProcessor = TRUE;
 317     }
 318     else {
 319       $this->_isPaymentProcessor = FALSE;
 320     }
 321
 322     // Only show credit card membership signup if user has CiviContribute permission
 323     if (CRM_Core_Permission::access('CiviContribute')) {
 324       $this->_accessContribution = TRUE;
 325       $this->assign('accessContribution', TRUE);
 326     }
 327     else {
 328       $this->_accessContribution = FALSE;
 329       $this->assign('accessContribution', FALSE);
 330     }
 331
 332     if ($this->_action & CRM_Core_Action::VIEW) {
 333       $this->view();
 334     }
 335     elseif ($this->_action & (CRM_Core_Action::UPDATE | CRM_Core_Action::ADD | CRM_Core_Action::DELETE
 336         | CRM_Core_Action::RENEW)) {
 337       self::setContext($this);
 338       $this->edit();
 339     }
 340     else {
 341       self::setContext($this);
 342       $this->browse();
 343     }
 344
 345     return parent::run();
 346   }
 347
 348   public static function setContext(&$form, $contactId = NULL) {
 349     $context = CRM_Utils_Request::retrieve('context', 'String', $form, FALSE, 'search' );
 350
 351     $qfKey = CRM_Utils_Request::retrieve('key', 'String', $form);
 352
 353     $searchContext = CRM_Utils_Request::retrieve('searchContext', 'String', $this);
 354
 355     //validate the qfKey
 356     if (!CRM_Utils_Rule::qfKey($qfKey)) {
 357       $qfKey = NULL;
 358     }
 359
 360     if (!$contactId) {
 361       $contactId = $form->_contactId;
 362     }
 363
 364     switch ($context) {
 365       case 'dashboard':
 366         $url = CRM_Utils_System::url('civicrm/member', 'reset=1');
 367         break;
 368
 369       case 'membership':
 370         $url = CRM_Utils_System::url('civicrm/contact/view', "reset=1&force=1&cid={$contactId}&selectedChild=member");
 371         break;
 372
 373       case 'search':
 374         $urlParams = 'force=1';
 375         if ($qfKey) {
 376           $urlParams .= "&qfKey=$qfKey";
 377         }
 378         $form->assign('searchKey', $qfKey);
 379
 380         if ($searchContext) {
 381           $url = CRM_Utils_System::url("civicrm/$searchContext/search", $urlParams);
 382         }
 383         else {
 384           $url = CRM_Utils_System::url('civicrm/member/search', $urlParams);
 385         }
 386         break;
 387
 388       case 'home':
 389         $url = CRM_Utils_System::url('civicrm/dashboard', 'reset=1');
 390         break;
 391
 392       case 'activity':
 393         $url = CRM_Utils_System::url('civicrm/contact/view',
 394           "reset=1&force=1&cid={$contactId}&selectedChild=activity"
 395         );
 396         break;
 397
 398       case 'standalone':
 399         $url = CRM_Utils_System::url('civicrm/dashboard', 'reset=1');
 400         break;
 401
 402       case 'fulltext':
 403         $action = CRM_Utils_Request::retrieve('action', 'String', $form);
 404         $keyName = '&qfKey';
 405         $urlParams = 'force=1';
 406         $urlString = 'civicrm/contact/search/custom';
 407         if ($action == CRM_Core_Action::UPDATE) {
 408           if ($form->_contactId) {
 409             $urlParams .= '&cid=' . $form->_contactId;
 410           }
 411           $keyName = '&key';
 412           $urlParams .= '&context=fulltext&action=view';
 413           $urlString = 'civicrm/contact/view/membership';
 414         }
 415         if ($qfKey) {
 416           $urlParams .= "$keyName=$qfKey";
 417         }
 418         $form->assign('searchKey', $qfKey);
 419         $url = CRM_Utils_System::url($urlString, $urlParams);
 420         break;
 421
 422       default:
 423         $cid = NULL;
 424         if ($contactId) {
 425           $cid = '&cid=' . $contactId;
 426         }
 427         $url = CRM_Utils_System::url('civicrm/member/search', 'force=1' . $cid);
 428         break;
 429     }
 430
 431     $session = CRM_Core_Session::singleton();
 432     $session->pushUserContext($url);
 433   }
 434
 435   /**
 436    * Get action links
 437    *
 438    * @return array (reference) of action links
 439    * @static
 440    */
 441   static function &links($status = 'all',
 442                          $isPaymentProcessor = NULL,
 443                          $accessContribution = NULL,
 444                          $isCancelSupported = FALSE,
 445                          $isUpdateBilling = FALSE
 446   ) {
 447     if (!CRM_Utils_Array::value('view', self::$_links)) {
 448       self::$_links['view'] = array(
 449         CRM_Core_Action::VIEW => array(
 450           'name' => ts('View'),
 451           'url' => 'civicrm/contact/view/membership',
 452           'qs' => 'action=view&reset=1&cid=%%cid%%&id=%%id%%&context=membership&selectedChild=member',
 453           'title' => ts('View Membership'),
 454         ),
 455       );
 456     }
 457
 458     if (!CRM_Utils_Array::value('all', self::$_links)) {
 459       $extraLinks = array(
 460         CRM_Core_Action::UPDATE => array(
 461           'name' => ts('Edit'),
 462           'url' => 'civicrm/contact/view/membership',
 463           'qs' => 'action=update&reset=1&cid=%%cid%%&id=%%id%%&context=membership&selectedChild=member',
 464           'title' => ts('Edit Membership'),
 465         ),
 466         CRM_Core_Action::RENEW => array(
 467           'name' => ts('Renew'),
 468           'url' => 'civicrm/contact/view/membership',
 469           'qs' => 'action=renew&reset=1&cid=%%cid%%&id=%%id%%&context=membership&selectedChild=member',
 470           'title' => ts('Renew Membership'),
 471         ),
 472         CRM_Core_Action::FOLLOWUP => array(
 473           'name' => ts('Renew-Credit Card'),
 474           'url' => 'civicrm/contact/view/membership',
 475           'qs' => 'action=renew&reset=1&cid=%%cid%%&id=%%id%%&context=membership&selectedChild=member&mode=live',
 476           'title' => ts('Renew Membership Using Credit Card'),
 477         ),
 478         CRM_Core_Action::DELETE => array(
 479           'name' => ts('Delete'),
 480           'url' => 'civicrm/contact/view/membership',
 481           'qs' => 'action=delete&reset=1&cid=%%cid%%&id=%%id%%&context=membership&selectedChild=member',
 482           'title' => ts('Delete Membership'),
 483         ),
 484       );
 485       if (!$isPaymentProcessor || !$accessContribution) {
 486         //unset the renew with credit card when payment
 487         //processor is not available or user is not permitted to create contributions
 488         unset($extraLinks[CRM_Core_Action::FOLLOWUP]);
 489       }
 490       self::$_links['all'] = self::$_links['view'] + $extraLinks;
 491     }
 492
 493
 494     if ($isCancelSupported) {
 495       $cancelMessage = ts('WARNING: If you cancel the recurring contribution associated with this membership, the membership will no longer be renewed automatically. However, the current membership status will not be affected.');
 496       self::$_links['all'][CRM_Core_Action::DISABLE] = array(
 497         'name' => ts('Cancel Auto-renewal'),
 498         'url' => 'civicrm/contribute/unsubscribe',
 499         'qs' => 'reset=1&cid=%%cid%%&mid=%%id%%&context=membership&selectedChild=member',
 500         'title' => ts('Cancel Auto Renew Subscription'),
 501         'extra' => 'onclick = "if (confirm(\'' . $cancelMessage . '\') ) {  return true; else return false;}"',
 502       );
 503     }
 504     elseif (isset(self::$_links['all'][CRM_Core_Action::DISABLE])) {
 505       unset(self::$_links['all'][CRM_Core_Action::DISABLE]);
 506     }
 507
 508     if ($isUpdateBilling) {
 509       self::$_links['all'][CRM_Core_Action::MAP] = array(
 510         'name' => ts('Change Billing Details'),
 511         'url' => 'civicrm/contribute/updatebilling',
 512         'qs' => 'reset=1&cid=%%cid%%&mid=%%id%%&context=membership&selectedChild=member',
 513         'title' => ts('Change Billing Details'),
 514       );
 515     }
 516     elseif (isset(self::$_links['all'][CRM_Core_Action::MAP])) {
 517       unset(self::$_links['all'][CRM_Core_Action::MAP]);
 518     }
 519     return self::$_links[$status];
 520   }
 521
 522   /**
 523    * Function to define action links for membership types of related organization
 524    *
 525    * @return array self::$_membershipTypesLinks array of action links
 526    * @access public
 527    */
 528   static function &membershipTypesLinks() {
 529     if (!self::$_membershipTypesLinks) {
 530       self::$_membershipTypesLinks = array(
 531         CRM_Core_Action::VIEW => array(
 532           'name' => ts('Members'),
 533           'url' => 'civicrm/member/search/',
 534           'qs' => 'reset=1&force=1&type=%%id%%',
 535           'title' => ts('Search'),
 536         ),
 537         CRM_Core_Action::UPDATE => array(
 538           'name' => ts('Edit'),
 539           'url' => 'civicrm/admin/member/membershipType',
 540           'qs' => 'action=update&id=%%id%%&reset=1',
 541           'title' => ts('Edit Membership Type'),
 542         ),
 543       );
 544     }
 545     return self::$_membershipTypesLinks;
 546   }
 547
 548   /**
 549    * This function is used for the to show the associated
 550    * contribution for the membership
 551    * @form array $form (ref.) an assoc array of name/value pairs
 552    * return null
 553    * @access public
 554    */
 555   public static function associatedContribution($contactId = NULL, $membershipId = NULL) {
 556     $controller = new CRM_Core_Controller_Simple(
 557       'CRM_Contribute_Form_Search',
 558       ts('Contributions'),
 559       NULL,
 560       FALSE, FALSE, TRUE
 561     );
 562     $controller->setEmbedded(TRUE);
 563     $controller->reset();
 564     $controller->set('force', 1);
 565     $controller->set('cid', $contactId);
 566     $controller->set('memberId', $membershipId);
 567     $controller->set('context', 'contribution');
 568     $controller->process();
 569     $controller->run();
 570   }
 571
 572   /**
 573    * Get BAO Name
 574    *
 575    * @return string Classname of BAO.
 576    */
 577   function getBAOName() {
 578     return 'CRM_Member_BAO_Membership';
 579   }
 580 }
 581