3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.4 |
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2013 |
7 +--------------------------------------------------------------------+
8 | This file is a part of CiviCRM. |
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. |
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. |
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 +--------------------------------------------------------------------+
31 * @copyright CiviCRM LLC (c) 2004-2013
35 class CRM_Member_Page_Tab
extends CRM_Core_Page
{
38 * The action links that we need to display for the browse screen
43 static $_links = NULL;
44 static $_membershipTypesLinks = NULL;
46 public $_permission = NULL;
47 public $_contactId = NULL;
50 * This function is called when action is browse
56 $links = self
::links('all', $this->_isPaymentProcessor
, $this->_accessContribution
);
58 $membership = array();
59 $dao = new CRM_Member_DAO_Membership();
60 $dao->contact_id
= $this->_contactId
;
62 //$dao->orderBy('name');
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
;
70 if (CRM_Core_Permission
::check('delete in CiviMember')) {
71 $permissions[] = CRM_Core_Permission
::DELETE
;
73 $mask = CRM_Core_Action
::mask($permissions);
75 // get deceased status id
76 $allStatus = CRM_Member_PseudoConstant
::membershipStatus();
77 $deceasedStatusId = array_search('Deceased', $allStatus);
80 $allCampaigns = CRM_Campaign_BAO_Campaign
::getCampaigns(NULL, NULL, FALSE, FALSE, FALSE, TRUE);
82 //checks membership of contact itself
83 while ($dao->fetch()) {
84 $membership[$dao->id
] = array();
85 CRM_Core_DAO
::storeValues($dao, $membership[$dao->id
]);
88 $membership[$dao->id
]['campaign'] = CRM_Utils_Array
::value($dao->campaign_id
, $allCampaigns);
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
]);
95 if (CRM_Utils_Array
::value('is_current_member', $statusANDType[$dao->id
])) {
96 $membership[$dao->id
]['active'] = TRUE;
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
;
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');
112 $isCancelSupported = CRM_Member_BAO_Membership
::isCancelSubscriptionSupported(
113 $membership[$dao->id
]['membership_id']);
115 $membership[$dao->id
]['action'] = CRM_Core_Action
::formLink(self
::links('all',
124 'cid' => $this->_contactId
,
128 'membership.tab.row',
134 $membership[$dao->id
]['action'] = CRM_Core_Action
::formLink(self
::links('view'),
138 'cid' => $this->_contactId
,
142 'membership.tab.row',
148 //does membership have auto renew CRM-7137.
149 if (CRM_Utils_Array
::value('contribution_recur_id', $membership[$dao->id
]) &&
150 !CRM_Member_BAO_Membership
::isSubscriptionCancelled($membership[$dao->id
]['membership_id'])
152 $membership[$dao->id
]['auto_renew'] = 1;
155 $membership[$dao->id
]['auto_renew'] = 0;
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
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))
177 $membership[$dao->id
]['related_count'] = ts('N/A');
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(),
188 'id' => $value['id'],
189 'cid' => $this->_contactId
,
193 'membershipType.organization.action',
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);
205 if ($this->_contactId
) {
206 $displayName = CRM_Contact_BAO_Contact
::displayName($this->_contactId
);
207 $this->assign('displayName', $displayName);
212 * This function is called when action is view
218 $controller = new CRM_Core_Controller_Simple(
219 'CRM_Member_Form_MembershipView',
220 ts('View Membership'),
223 $controller->setEmbedded(TRUE);
224 $controller->set('id', $this->_id
);
225 $controller->set('cid', $this->_contactId
);
227 return $controller->run();
231 * This function is called when action is update or new
237 // set https for offline cc transaction
238 $mode = CRM_Utils_Request
::retrieve('mode', 'String', $this);
239 if ($mode == 'test' ||
$mode == 'live') {
240 CRM_Utils_System
::redirectToSSL();
243 // build associated contributions ( note: this is called to show associated contributions in edit mode )
244 if ($this->_action
& CRM_Core_Action
::UPDATE
) {
245 $this->assign('accessContribution', FALSE);
246 if (CRM_Core_Permission
::access('CiviContribute')) {
247 $this->assign('accessContribution', TRUE);
248 CRM_Member_Page_Tab
::associatedContribution($this->_contactId
, $this->_id
);
252 if ($this->_action
& CRM_Core_Action
::RENEW
) {
253 $path = 'CRM_Member_Form_MembershipRenewal';
254 $title = ts('Renew Membership');
257 $path = 'CRM_Member_Form_Membership';
258 $title = ts('Create Membership');
261 $controller = new CRM_Core_Controller_Simple($path, $title, $this->_action
);
262 $controller->setEmbedded(TRUE);
263 $controller->set('BAOName', $this->getBAOName());
264 $controller->set('id', $this->_id
);
265 $controller->set('cid', $this->_contactId
);
266 return $controller->run();
269 function preProcess() {
270 $context = CRM_Utils_Request
::retrieve('context', 'String', $this);
271 $this->_action
= CRM_Utils_Request
::retrieve('action', 'String', $this, FALSE, 'browse');
272 $this->_id
= CRM_Utils_Request
::retrieve('id', 'Positive', $this);
274 if ($context == 'standalone') {
275 $this->_action
= CRM_Core_Action
::ADD
;
278 $this->_contactId
= CRM_Utils_Request
::retrieve('cid', 'Positive', $this, TRUE);
279 $this->assign('contactId', $this->_contactId
);
281 // check logged in url permission
282 CRM_Contact_Page_View
::checkUserPermission($this);
285 CRM_Contact_Page_View
::setTitle($this->_contactId
);
288 $this->assign('action', $this->_action
);
290 if ($this->_permission
== CRM_Core_Permission
::EDIT
&& !CRM_Core_Permission
::check('edit memberships')) {
291 // demote to view since user does not have edit membership rights
292 $this->_permission
= CRM_Core_Permission
::VIEW
;
293 $this->assign('permission', 'view');
298 * 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 // check if we can process credit card membership
307 $newCredit = CRM_Core_Payment
::allowBackofficeCreditCard($this);
309 $this->_isPaymentProcessor
= TRUE;
312 $this->_isPaymentProcessor
= FALSE;
315 // Only show credit card membership signup if user has CiviContribute permission
316 if (CRM_Core_Permission
::access('CiviContribute')) {
317 $this->_accessContribution
= TRUE;
318 $this->assign('accessContribution', TRUE);
321 $this->_accessContribution
= FALSE;
322 $this->assign('accessContribution', FALSE);
325 if ($this->_action
& CRM_Core_Action
::VIEW
) {
328 elseif ($this->_action
& (CRM_Core_Action
::UPDATE | CRM_Core_Action
::ADD | CRM_Core_Action
::DELETE
329 | CRM_Core_Action
::RENEW
)) {
330 self
::setContext($this);
334 self
::setContext($this);
338 return parent
::run();
341 public static function setContext(&$form, $contactId = NULL) {
342 $context = CRM_Utils_Request
::retrieve('context', 'String', $form, FALSE, 'search' );
344 $qfKey = CRM_Utils_Request
::retrieve('key', 'String', $form);
346 if (!CRM_Utils_Rule
::qfKey($qfKey)) {
351 $contactId = $form->_contactId
;
356 $url = CRM_Utils_System
::url('civicrm/member', 'reset=1');
360 $url = CRM_Utils_System
::url('civicrm/contact/view', "reset=1&force=1&cid={$contactId}&selectedChild=member");
364 $urlParams = 'force=1';
366 $urlParams .= "&qfKey=$qfKey";
368 $form->assign('searchKey', $qfKey);
370 $url = CRM_Utils_System
::url('civicrm/member/search', $urlParams);
374 $url = CRM_Utils_System
::url('civicrm/dashboard', 'reset=1');
378 $url = CRM_Utils_System
::url('civicrm/contact/view',
379 "reset=1&force=1&cid={$contactId}&selectedChild=activity"
384 $url = CRM_Utils_System
::url('civicrm/dashboard', 'reset=1');
388 $action = CRM_Utils_Request
::retrieve('action', 'String', $form);
390 $urlParams = 'force=1';
391 $urlString = 'civicrm/contact/search/custom';
392 if ($action == CRM_Core_Action
::UPDATE
) {
393 if ($form->_contactId
) {
394 $urlParams .= '&cid=' . $this->_contactId
;
397 $urlParams .= '&context=fulltext&action=view';
398 $urlString = 'civicrm/contact/view/membership';
401 $urlParams .= "$keyName=$qfKey";
403 $form->assign('searchKey', $qfKey);
404 $url = CRM_Utils_System
::url($urlString, $urlParams);
410 $cid = '&cid=' . $contactId;
412 $url = CRM_Utils_System
::url('civicrm/member/search', 'force=1' . $cid);
416 $session = CRM_Core_Session
::singleton();
417 $session->pushUserContext($url);
423 * @return array (reference) of action links
426 static function &links($status = 'all',
427 $isPaymentProcessor = NULL,
428 $accessContribution = NULL,
429 $isCancelSupported = FALSE,
430 $isUpdateBilling = FALSE
432 if (!CRM_Utils_Array
::value('view', self
::$_links)) {
433 self
::$_links['view'] = array(
434 CRM_Core_Action
::VIEW
=> array(
435 'name' => ts('View'),
436 'url' => 'civicrm/contact/view/membership',
437 'qs' => 'action=view&reset=1&cid=%%cid%%&id=%%id%%&context=membership&selectedChild=member',
438 'title' => ts('View Membership'),
443 if (!CRM_Utils_Array
::value('all', self
::$_links)) {
445 CRM_Core_Action
::UPDATE
=> array(
446 'name' => ts('Edit'),
447 'url' => 'civicrm/contact/view/membership',
448 'qs' => 'action=update&reset=1&cid=%%cid%%&id=%%id%%&context=membership&selectedChild=member',
449 'title' => ts('Edit Membership'),
451 CRM_Core_Action
::RENEW
=> array(
452 'name' => ts('Renew'),
453 'url' => 'civicrm/contact/view/membership',
454 'qs' => 'action=renew&reset=1&cid=%%cid%%&id=%%id%%&context=membership&selectedChild=member',
455 'title' => ts('Renew Membership'),
457 CRM_Core_Action
::FOLLOWUP
=> array(
458 'name' => ts('Renew-Credit Card'),
459 'url' => 'civicrm/contact/view/membership',
460 'qs' => 'action=renew&reset=1&cid=%%cid%%&id=%%id%%&context=membership&selectedChild=member&mode=live',
461 'title' => ts('Renew Membership Using Credit Card'),
463 CRM_Core_Action
::DELETE
=> array(
464 'name' => ts('Delete'),
465 'url' => 'civicrm/contact/view/membership',
466 'qs' => 'action=delete&reset=1&cid=%%cid%%&id=%%id%%&context=membership&selectedChild=member',
467 'title' => ts('Delete Membership'),
470 if (!$isPaymentProcessor ||
!$accessContribution) {
471 //unset the renew with credit card when payment
472 //processor is not available or user is not permitted to create contributions
473 unset($extraLinks[CRM_Core_Action
::FOLLOWUP
]);
475 self
::$_links['all'] = self
::$_links['view'] +
$extraLinks;
479 if ($isCancelSupported) {
480 $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.');
481 self
::$_links['all'][CRM_Core_Action
::DISABLE
] = array(
482 'name' => ts('Cancel Auto-renewal'),
483 'url' => 'civicrm/contribute/unsubscribe',
484 'qs' => 'reset=1&cid=%%cid%%&mid=%%id%%&context=membership&selectedChild=member',
485 'title' => ts('Cancel Auto Renew Subscription'),
486 'extra' => 'onclick = "if (confirm(\'' . $cancelMessage . '\') ) { return true; else return false;}"',
489 elseif (isset(self
::$_links['all'][CRM_Core_Action
::DISABLE
])) {
490 unset(self
::$_links['all'][CRM_Core_Action
::DISABLE
]);
493 if ($isUpdateBilling) {
494 self
::$_links['all'][CRM_Core_Action
::MAP
] = array(
495 'name' => ts('Change Billing Details'),
496 'url' => 'civicrm/contribute/updatebilling',
497 'qs' => 'reset=1&cid=%%cid%%&mid=%%id%%&context=membership&selectedChild=member',
498 'title' => ts('Change Billing Details'),
501 elseif (isset(self
::$_links['all'][CRM_Core_Action
::MAP
])) {
502 unset(self
::$_links['all'][CRM_Core_Action
::MAP
]);
504 return self
::$_links[$status];
508 * Function to define action links for membership types of related organization
510 * @return array self::$_membershipTypesLinks array of action links
513 static function &membershipTypesLinks() {
514 if (!self
::$_membershipTypesLinks) {
515 self
::$_membershipTypesLinks = array(
516 CRM_Core_Action
::VIEW
=> array(
517 'name' => ts('Members'),
518 'url' => 'civicrm/member/search/',
519 'qs' => 'reset=1&force=1&type=%%id%%',
520 'title' => ts('Search'),
522 CRM_Core_Action
::UPDATE
=> array(
523 'name' => ts('Edit'),
524 'url' => 'civicrm/admin/member/membershipType',
525 'qs' => 'action=update&id=%%id%%&reset=1',
526 'title' => ts('Edit Membership Type'),
530 return self
::$_membershipTypesLinks;
534 * This function is used for the to show the associated
535 * contribution for the membership
536 * @form array $form (ref.) an assoc array of name/value pairs
540 public static function associatedContribution($contactId = NULL, $membershipId = NULL) {
541 $controller = new CRM_Core_Controller_Simple(
542 'CRM_Contribute_Form_Search',
547 $controller->setEmbedded(TRUE);
548 $controller->reset();
549 $controller->set('force', 1);
550 $controller->set('cid', $contactId);
551 $controller->set('memberId', $membershipId);
552 $controller->set('context', 'contribution');
553 $controller->process();
560 * @return string Classname of BAO.
562 function getBAOName() {
563 return 'CRM_Member_BAO_Membership';