3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.5 |
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2014 |
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-2014
35 class CRM_Member_BAO_MembershipType
extends CRM_Member_DAO_MembershipType
{
38 * static holder for the default LT
40 static $_defaultMembershipType = NULL;
42 static $_membershipTypeInfo = array();
47 function __construct() {
48 parent
::__construct();
52 * Takes a bunch of params that are needed to match certain criteria and
53 * retrieves the relevant objects. Typically the valid params are only
54 * contact_id. We'll tweak this function to be more full featured over a period
55 * of time. This is the inverse function of create. It also stores all the retrieved
56 * values in the default array
58 * @param array $params (reference ) an assoc array of name/value pairs
59 * @param array $defaults (reference ) an assoc array to hold the flattened values
61 * @return object CRM_Member_BAO_MembershipType object
65 static function retrieve(&$params, &$defaults) {
66 $membershipType = new CRM_Member_DAO_MembershipType();
67 $membershipType->copyValues($params);
68 if ($membershipType->find(TRUE)) {
69 CRM_Core_DAO
::storeValues($membershipType, $defaults);
70 return $membershipType;
76 * update the is_active flag in the db
78 * @param int $id id of the database record
79 * @param boolean $is_active value we want to set the is_active field
81 * @return Object DAO object on sucess, null otherwise
84 static function setIsActive($id, $is_active) {
85 return CRM_Core_DAO
::setFieldValue('CRM_Member_DAO_MembershipType', $id, 'is_active', $is_active);
89 * function to add the membership types
91 * @param array $params reference array contains the values submitted by the form
92 * @param array $ids reference array contains the id
99 static function add(&$params, &$ids) {
100 $params['is_active'] = CRM_Utils_Array
::value('is_active', $params, FALSE);
102 // action is taken depending upon the mode
103 $membershipType = new CRM_Member_DAO_MembershipType();
105 $membershipType->copyValues($params);
107 $membershipType->domain_id
= CRM_Core_Config
::domainID();
109 $membershipType->id
= CRM_Utils_Array
::value('membershipType', $ids);
111 // $previousID is the old organization id for membership type i.e 'member_of_contact_id'. This is used when an oganization is changed.
113 if ($membershipType->id
) {
114 $previousID = CRM_Core_DAO
::getFieldValue('CRM_Member_DAO_MembershipType', $membershipType->id
, 'member_of_contact_id');
117 $membershipType->save();
119 self
::createMembershipPriceField($params, $ids, $previousID, $membershipType->id
);
120 // update all price field value for quick config when membership type is set CRM-11718
121 if (!empty($ids['membershipType'])) {
122 self
::updateAllPriceFieldValue($ids['membershipType'], $params);
125 return $membershipType;
129 * Function to delete membership Types
131 * @param int $membershipTypeId
133 * @throws CRM_Core_Exception
137 static function del($membershipTypeId) {
142 'Membership' => 'membership_type_id',
143 'MembershipBlock' => 'membership_type_default',
146 foreach ($dependancy as $name => $field) {
147 $baoString = 'CRM_Member_BAO_' . $name;
148 $dao = new $baoString();
149 $dao->$field = $membershipTypeId;
150 if ($dao->find(TRUE)) {
157 $message = ts('This membership type cannot be deleted due to following reason(s):');
158 if (in_array('Membership', $status)) {
159 $findMembersURL = CRM_Utils_System
::url('civicrm/member/search', 'reset=1');
160 $deleteURL = CRM_Utils_System
::url('civicrm/contact/search/advanced', 'reset=1');
161 $message .= '<br/>' . ts('%3. There are some contacts who have this membership type assigned to them. Search for contacts with this membership type from <a href=\'%1\'>Find Members</a>. If you are still getting this message after deleting these memberships, there may be contacts in the Trash (deleted) with this membership type. Try using <a href="%2">Advanced Search</a> and checking "Search in Trash".', array(1 => $findMembersURL, 2 => $deleteURL, 3 => $cnt));
165 if (in_array('MembershipBlock', $status)) {
166 $deleteURL = CRM_Utils_System
::url('civicrm/admin/contribute', 'reset=1');
167 $message .= ts('%2. This Membership Type is used in an <a href=\'%1\'>Online Contribution page</a>. Uncheck this membership type in the Memberships tab.', array(1 => $deleteURL, 2 => $cnt));
168 throw new CRM_Core_Exception($message);
171 CRM_Utils_Weight
::delWeight('CRM_Member_DAO_MembershipType', $membershipTypeId);
172 //delete from membership Type table
173 $membershipType = new CRM_Member_DAO_MembershipType();
174 $membershipType->id
= $membershipTypeId;
176 //fix for membership type delete api
178 if ($membershipType->find(TRUE)) {
179 return $membershipType->delete();
186 * Function to convert membership Type's 'start day' & 'rollover day' to human readable formats.
188 * @param array $membershipType an array of membershipType-details.
191 static function convertDayFormat(&$membershipType) {
193 'fixed_period_start_day',
194 'fixed_period_rollover_day',
196 foreach ($membershipType as $id => $details) {
197 foreach ($periodDays as $pDay) {
198 if (!empty($details[$pDay])) {
199 if ($details[$pDay] > 31) {
200 $month = substr($details[$pDay], 0, strlen($details[$pDay]) - 2);
201 $day = substr($details[$pDay], -2);
216 $membershipType[$id][$pDay] = $monthMap[$month] . ' ' . $day;
219 $membershipType[$id][$pDay] = $details[$pDay];
227 * Function to get membership Types
229 * @param bool $public
232 * @internal param int $membershipTypeId
235 static function getMembershipTypes($public = TRUE) {
236 $membershipTypes = array();
237 $membershipType = new CRM_Member_DAO_MembershipType();
238 $membershipType->is_active
= 1;
240 $membershipType->visibility
= 'Public';
242 $membershipType->orderBy(' weight');
243 $membershipType->find();
244 while ($membershipType->fetch()) {
245 $membershipTypes[$membershipType->id
] = $membershipType->name
;
247 $membershipType->free();
248 return $membershipTypes;
252 * Function to get membership Type Details
254 * @param int $membershipTypeId
259 static function getMembershipTypeDetails($membershipTypeId) {
260 $membershipTypeDetails = array();
262 $membershipType = new CRM_Member_DAO_MembershipType();
263 $membershipType->is_active
= 1;
264 $membershipType->id
= $membershipTypeId;
265 if ($membershipType->find(TRUE)) {
266 CRM_Core_DAO
::storeValues($membershipType, $membershipTypeDetails);
267 $membershipType->free();
268 return $membershipTypeDetails;
276 * Function to calculate start date and end date for new membership
278 * @param int $membershipTypeId membership type id
279 * @param date $joinDate member since ( in mysql date format )
280 * @param date $startDate start date ( in mysql date format )
281 * @param null $endDate
282 * @param int $numRenewTerms how many membership terms are being added to end date (default is 1)
284 * @return array associated array with start date, end date and join date for the membership
287 public static function getDatesForMembershipType($membershipTypeId, $joinDate = NULL, $startDate = NULL, $endDate = NULL, $numRenewTerms = 1) {
288 $membershipTypeDetails = self
::getMembershipTypeDetails($membershipTypeId);
290 // convert all dates to 'Y-m-d' format.
292 'joinDate', 'startDate', 'endDate') as $dateParam) {
293 if (!empty($
$dateParam)) {
294 $
$dateParam = CRM_Utils_Date
::processDate($
$dateParam, NULL, FALSE, 'Y-m-d');
298 $joinDate = date('Y-m-d');
300 $actualStartDate = $joinDate;
302 $actualStartDate = $startDate;
305 $fixed_period_rollover = FALSE;
306 if (CRM_Utils_Array
::value('period_type', $membershipTypeDetails) == 'rolling') {
308 $startDate = $joinDate;
310 $actualStartDate = $startDate;
312 elseif (CRM_Utils_Array
::value('period_type', $membershipTypeDetails) == 'fixed') {
313 // calculate start date
314 // if !$startDate then use $joinDate
315 $toDay = explode('-', (empty($startDate) ?
$joinDate : $startDate));
320 if ($membershipTypeDetails['duration_unit'] == 'year') {
322 //get start fixed day
323 $startMonth = substr($membershipTypeDetails['fixed_period_start_day'], 0,
324 strlen($membershipTypeDetails['fixed_period_start_day']) - 2
326 $startDay = substr($membershipTypeDetails['fixed_period_start_day'], -2);
328 if (date('Y-m-d', mktime(0, 0, 0, $startMonth, $startDay, $year)) <= date('Y-m-d', mktime(0, 0, 0, $month, $day, $year))) {
329 $fixedStartDate = date('Y-m-d', mktime(0, 0, 0, $startMonth, $startDay, $year));
332 $fixedStartDate = date('Y-m-d', mktime(0, 0, 0, $startMonth, $startDay, $year - 1));
335 //get start rollover day
336 $rolloverMonth = substr($membershipTypeDetails['fixed_period_rollover_day'], 0,
337 strlen($membershipTypeDetails['fixed_period_rollover_day']) - 2
339 $rolloverDay = substr($membershipTypeDetails['fixed_period_rollover_day'], -2);
341 $fixedRolloverDate = date('Y-m-d', mktime(0, 0, 0, $rolloverMonth, $rolloverDay, $year));
343 //CRM-7825 -membership date rules are :
344 //1. Membership should not be start in future.
345 //2. rollover window should be subset of membership window.
347 //store original fixed start date as per current year.
348 $actualStartDate = $fixedStartDate;
350 //store original fixed rollover date as per current year.
351 $actualRolloverDate = $fixedRolloverDate;
353 //get the fixed end date here.
354 $dateParts = explode('-', $actualStartDate);
355 $fixedEndDate = date('Y-m-d', mktime(0, 0, 0,
358 $dateParts[0] +
($numRenewTerms * $membershipTypeDetails['duration_interval'])
361 //make sure rollover window should be
362 //subset of membership period window.
363 if ($fixedEndDate < $actualRolloverDate) {
364 $actualRolloverDate = date('Y-m-d', mktime(0, 0, 0, $rolloverMonth, $rolloverDay, $year - 1));
366 if ($actualRolloverDate < $actualStartDate) {
367 $actualRolloverDate = date('Y-m-d', mktime(0, 0, 0, $rolloverMonth, $rolloverDay, $year +
1));
370 //do check signup is in rollover window.
371 if ($actualRolloverDate <= $joinDate) {
372 $fixed_period_rollover = TRUE;
376 $startDate = $actualStartDate;
379 elseif ($membershipTypeDetails['duration_unit'] == 'month') {
380 // Check if we are on or after rollover day of the month - CRM-10585
381 // If so, set fixed_period_rollover TRUE so we increment end_date month below.
382 $dateParts = explode('-', $actualStartDate);
383 if ($dateParts[2] >= $membershipTypeDetails['fixed_period_rollover_day']){
384 $fixed_period_rollover = True;
387 // Start date is always first day of actualStartDate month
389 $actualStartDate = $startDate = $year . '-' . $month . '-01';
394 //calculate end date if it is not passed by user
396 //end date calculation
397 $date = explode('-', $actualStartDate);
402 switch ($membershipTypeDetails['duration_unit']) {
404 $year = $year +
($numRenewTerms * $membershipTypeDetails['duration_interval']);
405 //extend membership date by duration interval.
406 if ($fixed_period_rollover) {
412 $month = $month +
($numRenewTerms * $membershipTypeDetails['duration_interval']);
413 //duration interval is month
414 if ($fixed_period_rollover) {
421 $day = $day +
($numRenewTerms * $membershipTypeDetails['duration_interval']);
423 if ($fixed_period_rollover) {
424 //Fix Me: Currently we don't allow rollover if
425 //duration interval is day
430 if ($membershipTypeDetails['duration_unit'] == 'lifetime') {
434 $endDate = date('Y-m-d', mktime(0, 0, 0, $month, $day - 1, $year));
438 $membershipDates = array();
441 'start_date' => 'startDate',
442 'end_date' => 'endDate',
443 'join_date' => 'joinDate',
445 foreach ($dates as $varName => $valName) {
446 $membershipDates[$varName] = CRM_Utils_Date
::customFormat($
$valName, '%Y%m%d');
449 return $membershipDates;
453 * Function to calculate start date and end date for renewal membership
455 * @param int $membershipId
456 * @param $changeToday
457 * @param int $membershipTypeID - if provided, overrides the membership type of the $membershipID membership
458 * @param int $numRenewTerms how many membership terms are being added to end date (default is 1)
460 * CRM-7297 Membership Upsell - Added $membershipTypeID param to facilitate calculations of dates when membership type changes
462 * @return Array array fo the start date, end date and join date of the membership
465 public static function getRenewalDatesForMembershipType($membershipId, $changeToday = NULL, $membershipTypeID = NULL, $numRenewTerms = 1) {
466 $params = array('id' => $membershipId);
467 $membershipDetails = CRM_Member_BAO_Membership
::getValues($params, $values);
468 $statusID = $membershipDetails[$membershipId]->status_id
;
469 $membershipDates = array(
470 'join_date' => CRM_Utils_Date
::customFormat($membershipDetails[$membershipId]->join_date
, '%Y%m%d'),
473 $oldPeriodType = CRM_Core_DAO
::getFieldValue('CRM_Member_DAO_MembershipType',
474 CRM_Core_DAO
::getFieldValue('CRM_Member_DAO_Membership', $membershipId, 'membership_type_id'), 'period_type');
476 // CRM-7297 Membership Upsell
477 if (is_null($membershipTypeID)) {
478 $membershipTypeDetails = self
::getMembershipTypeDetails($membershipDetails[$membershipId]->membership_type_id
);
481 $membershipTypeDetails = self
::getMembershipTypeDetails($membershipTypeID);
483 $statusDetails = CRM_Member_BAO_MembershipStatus
::getMembershipStatus($statusID);
485 if ($statusDetails['is_current_member'] == 1) {
486 $startDate = $membershipDetails[$membershipId]->start_date
;
487 // CRM=7297 Membership Upsell: we need to handle null end_date in case we are switching
488 // from a lifetime to a different membership type
489 if (is_null($membershipDetails[$membershipId]->end_date
)) {
490 $date = date('Y-m-d');
493 $date = $membershipDetails[$membershipId]->end_date
;
495 $date = explode('-', $date);
496 $logStartDate = date('Y-m-d', mktime(0, 0, 0,
498 (double)($date[2] +
1),
502 $date = explode('-', $logStartDate);
507 switch ($membershipTypeDetails['duration_unit']) {
509 //need to check if the upsell is from rolling to fixed and adjust accordingly
510 if ($membershipTypeDetails['period_type'] == 'fixed' && $oldPeriodType == 'rolling' ) {
511 $month = substr($membershipTypeDetails['fixed_period_start_day'], 0, strlen($membershipTypeDetails['fixed_period_start_day']) - 2);
512 $day = substr($membershipTypeDetails['fixed_period_start_day'], -2);
515 $year = $year +
($numRenewTerms * $membershipTypeDetails['duration_interval']);
520 $month = $month +
($numRenewTerms * $membershipTypeDetails['duration_interval']);
524 $day = $day +
($numRenewTerms * $membershipTypeDetails['duration_interval']);
527 if ($membershipTypeDetails['duration_unit'] == 'lifetime') {
531 $endDate = date('Y-m-d', mktime(0, 0, 0,
537 $today = date('Y-m-d');
538 $membershipDates['today'] = CRM_Utils_Date
::customFormat($today, '%Y%m%d');
539 $membershipDates['start_date'] = CRM_Utils_Date
::customFormat($startDate, '%Y%m%d');
540 $membershipDates['end_date'] = CRM_Utils_Date
::customFormat($endDate, '%Y%m%d');
541 $membershipDates['log_start_date'] = CRM_Utils_Date
::customFormat($logStartDate, '%Y%m%d');
544 $today = date('Y-m-d');
546 $today = CRM_Utils_Date
::processDate($changeToday, NULL, FALSE, 'Y-m-d');
548 // Calculate new start/end dates when join date is today
549 $renewalDates = self
::getDatesForMembershipType($membershipTypeDetails['id'],
550 $today, NULL, NULL, $numRenewTerms
552 $membershipDates['today'] = CRM_Utils_Date
::customFormat($today, '%Y%m%d');
553 $membershipDates['start_date'] = $renewalDates['start_date'];
554 $membershipDates['end_date'] = $renewalDates['end_date'];
555 $membershipDates['log_start_date'] = $renewalDates['start_date'];
558 return $membershipDates;
562 * Function to retrieve all Membership Types associated
563 * with an Organization
565 * @param int $orgID Id of Organization
567 * @return Array array of the details of membership types
570 static function getMembershipTypesByOrg($orgID) {
571 $membershipTypes = array();
572 $dao = new CRM_Member_DAO_MembershipType();
573 $dao->member_of_contact_id
= $orgID;
575 while ($dao->fetch()) {
576 $membershipTypes[$dao->id
] = array();
577 CRM_Core_DAO
::storeValues($dao, $membershipTypes[$dao->id
]);
579 return $membershipTypes;
583 * Function to retrieve all Membership Types with Member of Contact id
585 * @param array membership types
587 * @return Array array of the details of membership types with Member of Contact id
590 static function getMemberOfContactByMemTypes($membershipTypes) {
591 $memTypeOrgs = array();
592 if (empty($membershipTypes)) {
596 $result = CRM_Core_DAO
::executeQuery("SELECT id, member_of_contact_id FROM civicrm_membership_type WHERE id IN (" . implode(',', $membershipTypes) . ")");
597 while ($result->fetch()) {
598 $memTypeOrgs[$result->id
] = $result->member_of_contact_id
;
605 * The function returns all the Organization for all membershiptypes .
607 * @param null $membershipTypeId
610 * @internal param array $allmembershipTypes array of allMembershipTypes
611 * with organization id Key - value pairs.
613 static function getMembershipTypeOrganization($membershipTypeId = NULL) {
614 $allmembershipTypes = array();
616 $membershipType = new CRM_Member_DAO_MembershipType();
618 if (isset($membershipTypeId)) {
619 $membershipType->id
= $membershipTypeId;
621 $membershipType->find();
623 while ($membershipType->fetch()) {
624 $allmembershipTypes[$membershipType->id
] = $membershipType->member_of_contact_id
;
626 return $allmembershipTypes;
630 * Funtion to retrieve organization and associated membership
633 * @return array arrays of organization and membership types
638 static function getMembershipTypeInfo() {
639 if (!self
::$_membershipTypeInfo) {
640 $orgs = $types = array();
642 $query = 'SELECT memType.id, memType.name, memType.member_of_contact_id, c.sort_name
643 FROM civicrm_membership_type memType INNER JOIN civicrm_contact c ON c.id = memType.member_of_contact_id
644 WHERE memType.is_active = 1 ';
645 $dao = CRM_Core_DAO
::executeQuery( $query );
646 while ($dao->fetch()) {
647 $orgs[$dao->member_of_contact_id
] = $dao->sort_name
;
648 $types[$dao->member_of_contact_id
][$dao->id
] = $dao->name
;
651 self
::$_membershipTypeInfo = array($orgs, $types);
653 return self
::$_membershipTypeInfo;
661 * @param $membershipTypeId
663 public static function createMembershipPriceField($params, $ids, $previousID, $membershipTypeId) {
665 $priceSetId = CRM_Core_DAO
::getFieldValue('CRM_Price_DAO_PriceSet', 'default_membership_type_amount', 'id', 'name');
667 if (!empty($params['member_of_contact_id'])) {
668 $fieldName = $params['member_of_contact_id'];
671 $fieldName = $previousID;
673 $fieldLabel = 'Membership Amount';
675 $fieldParams = array(
676 'price_set_id ' => $priceSetId,
677 'name' => $fieldName,
680 CRM_Price_BAO_PriceField
::retrieve($fieldParams, $results);
681 if (empty($results)) {
682 $fieldParams = array();
683 $fieldParams['label'] = $fieldLabel;
684 $fieldParams['name'] = $fieldName;
685 $fieldParams['price_set_id'] = $priceSetId;
686 $fieldParams['html_type'] = 'Radio';
687 $fieldParams['is_display_amounts'] = $fieldParams['is_required'] = 0;
688 $fieldParams['weight'] = $fieldParams['option_weight'][1] = 1;
689 $fieldParams['option_label'][1] = $params['name'];
690 $fieldParams['option_description'][1] = CRM_Utils_Array
::value('description', $params);
692 $fieldParams['membership_type_id'][1] = $membershipTypeId;
693 $fieldParams['option_amount'][1] = empty($params['minimum_fee']) ?
0 : $params['minimum_fee'];
694 $fieldParams['financial_type_id'] = CRM_Utils_Array
::value('financial_type_id', $params);
697 CRM_Member_Form_MembershipType
::checkPreviousPriceField($previousID, $priceSetId, $membershipTypeId, $optionsIds);
698 $fieldParams['option_id'] = CRM_Utils_Array
::value('option_id', $optionsIds);
700 $priceField = CRM_Price_BAO_PriceField
::create($fieldParams);
703 $fieldID = $results['id'];
704 $fieldValueParams = array(
705 'price_field_id' => $fieldID,
706 'membership_type_id' => $membershipTypeId,
709 CRM_Price_BAO_PriceFieldValue
::retrieve($fieldValueParams, $results);
710 if (!empty($results)) {
711 $results['label'] = $results['name'] = $params['name'];
712 $results['amount'] = empty($params['minimum_fee']) ?
0 : $params['minimum_fee'];
713 $optionsIds['id'] = $results['id'];
717 'price_field_id' => $fieldID,
718 'name' => $params['name'],
719 'label' => $params['name'],
720 'amount' => empty($params['minimum_fee']) ?
0 : $params['minimum_fee'],
721 'membership_type_id' => $membershipTypeId,
727 CRM_Member_Form_MembershipType
::checkPreviousPriceField($previousID, $priceSetId, $membershipTypeId, $optionsIds);
728 if (!empty($optionsIds['option_id'])) {
729 $optionsIds['id'] = current(CRM_Utils_Array
::value('option_id', $optionsIds));
732 $results['financial_type_id'] = CRM_Utils_Array
::value('financial_type_id', $params);
733 $results['description'] = CRM_Utils_Array
::value('description', $params);
734 CRM_Price_BAO_PriceFieldValue
::add($results, $optionsIds);
738 /** This function updates all price field value for quick config
739 * price set which has membership type
741 * @param integer membership type id
743 * @param integer financial type id
745 static function updateAllPriceFieldValue($membershipTypeId, $params) {
746 if (!empty($params['minimum_fee'])){
747 $amount = $params['minimum_fee'];
753 $updateValues = array(
754 2 => array('financial_type_id', 'financial_type_id', 'Integer'),
755 3 => array('label', 'name', 'String'),
756 4 => array('amount', 'minimum_fee', 'Float'),
757 5 => array('description', 'description', 'String'),
760 $queryParams = array(1 => array($membershipTypeId, 'Integer'));
761 foreach ($updateValues as $key => $value) {
762 if (array_key_exists($value[1], $params)) {
763 $updateFields[] = "cpfv." . $value[0] . " = %$key";
764 if ($value[1] == 'minimum_fee') {
765 $fieldValue = $amount;
768 $fieldValue = $params[$value[1]];
770 $queryParams[$key] = array($fieldValue, $value[2]);
774 $query = "UPDATE `civicrm_price_field_value` cpfv
775 INNER JOIN civicrm_price_field cpf on cpf.id = cpfv.price_field_id
776 INNER JOIN civicrm_price_set cps on cps.id = cpf.price_set_id
777 SET " . implode(' , ', $updateFields) . " WHERE cpfv.membership_type_id = %1
778 AND cps.is_quick_config = 1 AND cps.name != 'default_membership_type_amount'";
779 CRM_Core_DAO
::executeQuery($query, $queryParams);