3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.7 |
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2015 |
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-2015
35 class CRM_Event_BAO_Query
{
40 public static function &getFields() {
42 $fields = array_merge($fields, CRM_Event_DAO_Event
::import());
43 $fields = array_merge($fields, self
::getParticipantFields());
44 $fields = array_merge($fields, CRM_Core_DAO_Discount
::export());
52 public static function &getParticipantFields() {
53 $fields = CRM_Event_BAO_Participant
::importableFields('Individual', TRUE, TRUE);
58 * Build select for CiviEvent.
64 public static function select(&$query) {
65 if (($query->_mode
& CRM_Contact_BAO_Query
::MODE_EVENT
) ||
66 CRM_Contact_BAO_Query
::componentPresent($query->_returnProperties
, 'participant_')
68 $query->_select
['participant_id'] = "civicrm_participant.id as participant_id";
69 $query->_element
['participant_id'] = 1;
70 $query->_tables
['civicrm_participant'] = $query->_whereTables
['civicrm_participant'] = 1;
73 if (!empty($query->_returnProperties
['participant_fee_level'])) {
74 $query->_select
['participant_fee_level'] = "civicrm_participant.fee_level as participant_fee_level";
75 $query->_element
['participant_fee_level'] = 1;
78 //add participant contact ID
79 if (!empty($query->_returnProperties
['participant_contact_id'])) {
80 $query->_select
['participant_contact_id'] = "civicrm_participant.contact_id as participant_contact_id";
81 $query->_element
['participant_contact_id'] = 1;
85 if (!empty($query->_returnProperties
['participant_fee_amount'])) {
86 $query->_select
['participant_fee_amount'] = "civicrm_participant.fee_amount as participant_fee_amount";
87 $query->_element
['participant_fee_amount'] = 1;
91 if (!empty($query->_returnProperties
['participant_fee_currency'])) {
92 $query->_select
['participant_fee_currency'] = "civicrm_participant.fee_currency as participant_fee_currency";
93 $query->_element
['participant_fee_currency'] = 1;
96 //add event title also if event id is select
97 if (!empty($query->_returnProperties
['event_id']) ||
!empty($query->_returnProperties
['event_title'])) {
98 $query->_select
['event_id'] = "civicrm_event.id as event_id";
99 $query->_select
['event_title'] = "civicrm_event.title as event_title";
100 $query->_element
['event_id'] = 1;
101 $query->_element
['event_title'] = 1;
102 $query->_tables
['civicrm_event'] = 1;
103 $query->_whereTables
['civicrm_event'] = 1;
106 //add start date / end date
107 if (!empty($query->_returnProperties
['event_start_date'])) {
108 $query->_select
['event_start_date'] = "civicrm_event.start_date as event_start_date";
109 $query->_element
['event_start_date'] = 1;
112 if (!empty($query->_returnProperties
['event_end_date'])) {
113 $query->_select
['event_end_date'] = "civicrm_event.end_date as event_end_date";
114 $query->_element
['event_end_date'] = 1;
118 if (!empty($query->_returnProperties
['event_type'])) {
119 $query->_select
['event_type'] = "event_type.label as event_type";
120 $query->_element
['event_type'] = 1;
121 $query->_tables
['event_type'] = 1;
122 $query->_whereTables
['event_type'] = 1;
125 if (!empty($query->_returnProperties
['event_type_id'])) {
126 $query->_select
['event_type_id'] = "event_type.id as event_type_id";
127 $query->_element
['event_type_id'] = 1;
128 $query->_tables
['event_type'] = 1;
129 $query->_whereTables
['event_type'] = 1;
133 if (!empty($query->_returnProperties
['participant_status_id'])) {
134 $query->_select
['participant_status_id'] = "civicrm_participant.status_id as participant_status_id";
135 $query->_element
['participant_status_id'] = 1;
136 $query->_tables
['civicrm_participant'] = 1;
137 $query->_whereTables
['civicrm_participant'] = 1;
140 // get particupant_status label
141 if (!empty($query->_returnProperties
['participant_status'])) {
142 $query->_select
['participant_status'] = "participant_status.label as participant_status";
143 $query->_element
['participant_status'] = 1;
144 $query->_tables
['participant_status'] = 1;
145 $query->_whereTables
['civicrm_participant'] = 1;
148 //add participant_role_id
149 if (!empty($query->_returnProperties
['participant_role_id'])) {
150 $query->_select
['participant_role_id'] = "civicrm_participant.role_id as participant_role_id";
151 $query->_element
['participant_role_id'] = 1;
152 $query->_tables
['civicrm_participant'] = 1;
153 $query->_whereTables
['civicrm_participant'] = 1;
154 $query->_pseudoConstantsSelect
['participant_role_id'] = array(
155 'pseudoField' => 'participant_role_id',
156 'idCol' => 'participant_role_id',
160 //add participant_role
161 if (!empty($query->_returnProperties
['participant_role'])) {
162 $query->_select
['participant_role'] = "civicrm_participant.role_id as participant_role";
163 $query->_element
['participant_role'] = 1;
164 $query->_tables
['participant_role'] = 1;
165 $query->_whereTables
['civicrm_participant'] = 1;
166 $query->_pseudoConstantsSelect
['participant_role'] = array(
167 'pseudoField' => 'participant_role',
168 'idCol' => 'participant_role',
173 if (!empty($query->_returnProperties
['participant_register_date'])) {
174 $query->_select
['participant_register_date'] = "civicrm_participant.register_date as participant_register_date";
175 $query->_element
['participant_register_date'] = 1;
179 if (!empty($query->_returnProperties
['participant_source'])) {
180 $query->_select
['participant_source'] = "civicrm_participant.source as participant_source";
181 $query->_element
['participant_source'] = 1;
182 $query->_tables
['civicrm_participant'] = $query->_whereTables
['civicrm_participant'] = 1;
186 if (!empty($query->_returnProperties
['participant_note'])) {
187 $query->_select
['participant_note'] = "civicrm_note.note as participant_note";
188 $query->_element
['participant_note'] = 1;
189 $query->_tables
['participant_note'] = 1;
190 $query->_whereTables
['civicrm_note'] = 1;
193 if (!empty($query->_returnProperties
['participant_is_pay_later'])) {
194 $query->_select
['participant_is_pay_later'] = "civicrm_participant.is_pay_later as participant_is_pay_later";
195 $query->_element
['participant_is_pay_later'] = 1;
198 if (!empty($query->_returnProperties
['participant_is_test'])) {
199 $query->_select
['participant_is_test'] = "civicrm_participant.is_test as participant_is_test";
200 $query->_element
['participant_is_test'] = 1;
203 if (!empty($query->_returnProperties
['participant_registered_by_id'])) {
204 $query->_select
['participant_registered_by_id'] = "civicrm_participant.registered_by_id as participant_registered_by_id";
205 $query->_element
['participant_registered_by_id'] = 1;
209 if (!empty($query->_returnProperties
['participant_discount_name'])) {
210 $query->_select
['participant_discount_name'] = "discount_name.title as participant_discount_name";
211 $query->_element
['participant_discount_name'] = 1;
212 $query->_tables
['civicrm_discount'] = 1;
213 $query->_tables
['participant_discount_name'] = 1;
214 $query->_whereTables
['civicrm_discount'] = 1;
215 $query->_whereTables
['participant_discount_name'] = 1;
218 //carry campaign id to selectors.
219 if (!empty($query->_returnProperties
['participant_campaign_id'])) {
220 $query->_select
['participant_campaign_id'] = 'civicrm_participant.campaign_id as participant_campaign_id';
221 $query->_element
['participant_campaign_id'] = 1;
230 public static function where(&$query) {
232 foreach (array_keys($query->_params
) as $id) {
233 if (empty($query->_params
[$id][0])) {
236 if (substr($query->_params
[$id][0], 0, 6) == 'event_' ||
237 substr($query->_params
[$id][0], 0, 12) == 'participant_'
239 if ($query->_mode
== CRM_Contact_BAO_QUERY
::MODE_CONTACTS
) {
240 $query->_useDistinct
= TRUE;
242 $grouping = $query->_params
[$id][3];
243 self
::whereClauseSingle($query->_params
[$id], $query);
252 public static function whereClauseSingle(&$values, &$query) {
253 list($name, $op, $value, $grouping, $wildcard) = $values;
254 $fields = array_merge(CRM_Event_BAO_Event
::fields(), CRM_Event_BAO_Participant
::exportableFields());
257 case 'event_start_date_low':
258 case 'event_start_date_high':
259 $query->dateQueryBuilder($values,
260 'civicrm_event', 'event_start_date', 'start_date', 'Start Date'
264 case 'event_end_date_low':
265 case 'event_end_date_high':
266 $query->dateQueryBuilder($values,
267 'civicrm_event', 'event_end_date', 'end_date', 'End Date'
271 case 'event_include_repeating_events':
273 * Include Repeating Events
275 //Get parent of this event
277 if ($query->_where
[$grouping]) {
278 foreach ($query->_where
[$grouping] as $key => $val) {
279 if (strstr($val, 'civicrm_event.id =')) {
281 $extractEventId = explode(" ", $val);
282 $value = $extractEventId[2];
283 unset($query->_where
[$grouping][$key]);
286 $extractEventId = explode(" ", $exEventId);
287 $value = $extractEventId[2];
288 unset($query->_where
[$grouping][$key]);
290 $thisEventHasParent = CRM_Core_BAO_RecurringEntity
::getParentFor($value, 'civicrm_event');
291 if ($thisEventHasParent) {
292 $getAllConnections = CRM_Core_BAO_RecurringEntity
::getEntitiesForParent($thisEventHasParent, 'civicrm_event');
293 $allEventIds = array();
294 foreach ($getAllConnections as $key => $val) {
295 $allEventIds[] = $val['id'];
297 if (!empty($allEventIds)) {
299 $value = "(" . implode(",", $allEventIds) . ")";
302 $query->_where
[$grouping][] = "civicrm_event.id $op {$value}";
303 $query->_qill
[$grouping][] = ts('Include Repeating Events');
304 $query->_tables
['civicrm_event'] = $query->_whereTables
['civicrm_event'] = 1;
307 case 'participant_is_test':
308 $key = array_search('civicrm_participant.is_test = 0', $query->_where
[$grouping]);
310 unset($query->_where
[$grouping][$key]);
312 case 'participant_test':
313 // We dont want to include all tests for sql OR CRM-7827
314 if (!$value ||
$query->getOperator() != 'OR') {
315 $query->_where
[$grouping][] = CRM_Contact_BAO_Query
::buildClause("civicrm_participant.is_test",
321 $isTest = $value ?
'a Test' : 'not a Test';
322 $query->_qill
[$grouping][] = ts("Participant is %1", array(1 => $isTest));
323 $query->_tables
['civicrm_participant'] = $query->_whereTables
['civicrm_participant'] = 1;
327 case 'participant_fee_id':
328 $feeLabel = CRM_Core_DAO
::getFieldValue('CRM_Price_DAO_PriceFieldValue', $value, 'label');
329 $feeLabel = CRM_Core_DAO
::escapeString(trim($feeLabel));
331 $query->_where
[$grouping][] = "civicrm_participant.fee_level LIKE '%$feeLabel%'";
332 $query->_qill
[$grouping][] = ts("Fee level") . " contains $feeLabel";
334 $query->_tables
['civicrm_participant'] = $query->_whereTables
['civicrm_participant'] = 1;
337 case 'participant_fee_amount_high':
338 case 'participant_fee_amount_low':
339 $query->numberRangeBuilder($values,
340 'civicrm_participant', 'participant_fee_amount', 'fee_amount', 'Fee Amount'
344 case 'participant_status_id':
345 if ($value && is_array($value) && strpos($op, 'IN') === FALSE) {
348 case 'participant_status':
349 case 'participant_source':
350 case 'participant_id':
351 case 'participant_contact_id':
352 case 'participant_is_pay_later':
353 case 'participant_fee_amount':
354 case 'participant_fee_level':
355 case 'participant_campaign_id':
358 if (in_array($name, array(
359 'participant_status_id',
360 'participant_source',
362 'participant_contact_id',
363 'participant_fee_amount',
364 'participant_fee_level',
365 'participant_is_pay_later',
366 'participant_campaign_id',
368 $name = str_replace('participant_', '', $name);
369 if ($name == 'is_pay_later') {
373 elseif ($name == 'participant_status') {
377 $dataType = !empty($fields[$qillName]['type']) ? CRM_Utils_Type
::typeToString($fields[$qillName]['type']) : 'String';
378 $tableName = empty($tableName) ?
'civicrm_participant' : $tableName;
380 $query->_where
[$grouping][] = CRM_Contact_BAO_Query
::buildClause("$tableName.$name", $op, $value, $dataType);
382 list($op, $value) = CRM_Contact_BAO_Query
::buildQillForFieldValue('CRM_Event_DAO_Participant', $name, $value, $op);
383 $query->_qill
[$grouping][] = ts('%1 %2 %3', array(1 => $fields[$qillName]['title'], 2 => $op, 3 => $value));
384 $query->_tables
['civicrm_participant'] = $query->_whereTables
['civicrm_participant'] = 1;
387 case 'participant_role':
388 case 'participant_role_id':
392 if (is_array($value) && in_array(key($value), CRM_Core_DAO
::acceptedSQLOperators(), TRUE)) {
394 $value = $value[$op];
396 if (!strstr($op, 'NULL') && !strstr($op, 'EMPTY') && !strstr($op, 'LIKE')) {
397 $regexOp = (strstr($op, '!') ||
strstr($op, 'NOT')) ?
'NOT REGEXP' : 'REGEXP';
398 $regexp = "[[:cntrl:]]*" . implode('[[:>:]]*|[[:<:]]*', (array) $value) . "[[:cntrl:]]*";
399 $query->_where
[$grouping][] = CRM_Contact_BAO_Query
::buildClause("civicrm_participant.$name", $regexOp, $regexp, 'String');
402 $query->_where
[$grouping][] = CRM_Contact_BAO_Query
::buildClause("$tableName.$name", $op, $value, $dataType);
405 list($op, $value) = CRM_Contact_BAO_Query
::buildQillForFieldValue('CRM_Event_DAO_Participant', $name, $value, $op);
406 $query->_qill
[$grouping][] = ts('%1 %2 %3', array(1 => $fields[$qillName]['title'], 2 => $op, 3 => $value));
407 $query->_tables
['civicrm_participant'] = $query->_whereTables
['civicrm_participant'] = 1;
410 case 'participant_register_date':
411 $query->dateQueryBuilder($values,
412 'civicrm_participant', 'participant_register_date', 'register_date', 'Register Date'
417 case 'participant_event_id':
418 $name = str_replace('participant_', '', $name);
419 case 'event_is_public':
420 case 'event_type_id':
423 if (in_array($name, array(
429 $name = str_replace('event_', '', $name);
431 $dataType = !empty($fields[$qillName]['type']) ? CRM_Utils_Type
::typeToString($fields[$qillName]['type']) : 'String';
433 $query->_where
[$grouping][] = CRM_Contact_BAO_Query
::buildClause("civicrm_event.$name", $op, $value, $dataType);
434 $query->_tables
['civicrm_event'] = $query->_whereTables
['civicrm_event'] = 1;
435 if (!array_key_exists($qillName, $fields)) {
438 list($op, $value) = CRM_Contact_BAO_Query
::buildQillForFieldValue('CRM_Event_DAO_Event', $name, $value, $op);
439 $query->_qill
[$grouping][] = ts('%1 %2 %3', array(1 => $fields[$qillName]['title'], 2 => $op, 3 => $value));
445 * @param string $name
449 * @return null|string
451 public static function from($name, $mode, $side) {
454 case 'civicrm_participant':
455 $from = " LEFT JOIN civicrm_participant ON civicrm_participant.contact_id = contact_a.id ";
458 case 'civicrm_event':
459 $from = " INNER JOIN civicrm_event ON civicrm_participant.event_id = civicrm_event.id ";
463 $from = " $side JOIN civicrm_option_group option_group_event_type ON (option_group_event_type.name = 'event_type')";
464 $from .= " $side JOIN civicrm_option_value event_type ON (civicrm_event.event_type_id = event_type.value AND option_group_event_type.id = event_type.option_group_id ) ";
467 case 'participant_note':
468 $from .= " $side JOIN civicrm_note ON ( civicrm_note.entity_table = 'civicrm_participant' AND
469 civicrm_participant.id = civicrm_note.entity_id )";
472 case 'participant_status':
473 $from .= " $side JOIN civicrm_participant_status_type participant_status ON (civicrm_participant.status_id = participant_status.id) ";
476 case 'participant_role':
477 $from = " $side JOIN civicrm_option_group option_group_participant_role ON (option_group_participant_role.name = 'participant_role')";
478 $from .= " $side JOIN civicrm_option_value participant_role ON ((civicrm_participant.role_id = participant_role.value OR SUBSTRING_INDEX(role_id,'\ 1', 1) = participant_role.value)
479 AND option_group_participant_role.id = participant_role.option_group_id ) ";
482 case 'participant_discount_name':
483 $from = " $side JOIN civicrm_discount discount ON ( civicrm_participant.discount_id = discount.id )";
484 $from .= " $side JOIN civicrm_option_group discount_name ON ( discount_name.id = discount.price_set_id ) ";
491 * Getter for the qill object.
495 public function qill() {
496 return (isset($this->_qill
)) ?
$this->_qill
: "";
501 * @param bool $includeCustomFields
505 public static function defaultReturnProperties(
507 $includeCustomFields = TRUE
510 if ($mode & CRM_Contact_BAO_Query
::MODE_EVENT
) {
513 'contact_sub_type' => 1,
518 'event_start_date' => 1,
519 'event_end_date' => 1,
521 'participant_id' => 1,
522 'participant_status' => 1,
523 'participant_status_id' => 1,
524 'participant_role' => 1,
525 'participant_role_id' => 1,
526 'participant_note' => 1,
527 'participant_register_date' => 1,
528 'participant_source' => 1,
529 'participant_fee_level' => 1,
530 'participant_is_test' => 1,
531 'participant_is_pay_later' => 1,
532 'participant_fee_amount' => 1,
533 'participant_discount_name' => 1,
534 'participant_fee_currency' => 1,
535 'participant_registered_by_id' => 1,
536 'participant_campaign_id' => 1,
539 if ($includeCustomFields) {
540 // also get all the custom participant properties
541 $fields = CRM_Core_BAO_CustomField
::getFieldsForImport('Participant');
542 if (!empty($fields)) {
543 foreach ($fields as $name => $dontCare) {
544 $properties[$name] = 1;
554 * @param CRM_Core_Form $form
556 public static function buildSearchForm(&$form) {
557 $dataURLEventFee = CRM_Utils_System
::url('civicrm/ajax/eventFee',
562 $form->assign('dataURLEventFee', $dataURLEventFee);
564 $form->addEntityRef('event_id', ts('Event Name'), array(
566 'placeholder' => ts('- any -'),
567 'select' => array('minimumInputLength' => 0),
570 $form->addEntityRef('event_type_id', ts('Event Type'), array(
571 'entity' => 'option_value',
572 'placeholder' => ts('- any -'),
573 'select' => array('minimumInputLength' => 0),
575 'params' => array('option_group_id' => 'event_type'),
579 $form->add('text', 'participant_fee_id', ts('Fee Level'), array('class' => 'big crm-ajax-select'));
581 CRM_Core_Form_Date
::buildDateRange($form, 'event', 1, '_start_date_low', '_end_date_high', ts('From'), FALSE);
583 $form->addElement('checkbox', "event_include_repeating_events", NULL, ts('Include participants from all events in the %1 series', array(1 => '<em>%1</em>')));
585 $form->addSelect('participant_status_id',
586 array('entity' => 'participant', 'label' => ts('Participant Status'), 'multiple' => 'multiple', 'option_url' => NULL, 'placeholder' => ts('- any -'))
589 $form->addSelect('participant_role_id',
590 array('entity' => 'participant', 'label' => ts('Participant Role'), 'multiple' => 'multiple', 'option_url' => NULL, 'placeholder' => ts('- any -'))
593 $form->addYesNo('participant_test', ts('Participant is a Test?'), TRUE);
594 $form->addYesNo('participant_is_pay_later', ts('Participant is Pay Later?'), TRUE);
595 $form->addElement('text', 'participant_fee_amount_low', ts('From'), array('size' => 8, 'maxlength' => 8));
596 $form->addElement('text', 'participant_fee_amount_high', ts('To'), array('size' => 8, 'maxlength' => 8));
598 $form->addRule('participant_fee_amount_low', ts('Please enter a valid money value.'), 'money');
599 $form->addRule('participant_fee_amount_high', ts('Please enter a valid money value.'), 'money');
600 // add all the custom searchable fields
601 $extends = array('Participant', 'Event');
602 $groupDetails = CRM_Core_BAO_CustomGroup
::getGroupDetail(NULL, TRUE, $extends);
604 $form->assign('participantGroupTree', $groupDetails);
605 foreach ($groupDetails as $group) {
606 foreach ($group['fields'] as $field) {
607 $fieldId = $field['id'];
608 $elementName = 'custom_' . $fieldId;
609 CRM_Core_BAO_CustomField
::addQuickFormElement($form,
618 CRM_Campaign_BAO_Campaign
::addCampaignInComponentSearch($form, 'participant_campaign_id');
620 $form->assign('validCiviEvent', TRUE);
621 $form->setDefaults(array('participant_test' => 0));
628 public static function searchAction(&$row, $id) {
634 public static function tableNames(&$tables) {
635 //add participant table
636 if (!empty($tables['civicrm_event'])) {
637 $tables = array_merge(array('civicrm_participant' => 1), $tables);