library/appointments.inc.php

   1 <?php
   2
   3  // Copyright (C) 2011 Ken Chapple
   4  //
   5  // This program is free software; you can redistribute it and/or
   6  // modify it under the terms of the GNU General Public License
   7  // as published by the Free Software Foundation; either version 2
   8  // of the License, or (at your option) any later version.
   9
  10  // Holds library functions (and hashes) used by the appointment reporting module
  11
  12
  13
  14 require_once(dirname(__FILE__)."/encounter_events.inc.php");
  15 require_once(dirname(__FILE__)."/../interface/main/calendar/modules/PostCalendar/pnincludes/Date/Calc.php");
  16
  17
  18 $COMPARE_FUNCTION_HASH = array(
  19     'doctor' => 'compareAppointmentsByDoctorName',
  20     'patient' => 'compareAppointmentsByPatientName',
  21     'pubpid' => 'compareAppointmentsByPatientId',
  22     'date' => 'compareAppointmentsByDate',
  23     'time' => 'compareAppointmentsByTime',
  24     'type' => 'compareAppointmentsByType',
  25     'comment' => 'compareAppointmentsByComment',
  26     'status' => 'compareAppointmentsByStatus',
  27     'completed' => 'compareAppointmentsByCompletedDrugScreen',
  28     'trackerstatus' => 'compareAppointmentsByTrackerStatus'
  29 );
  30
  31 $ORDERHASH = array(
  32     'doctor' => array( 'doctor', 'date', 'time' ),
  33     'patient' => array( 'patient', 'date', 'time' ),
  34     'pubpid' => array( 'pubpid', 'date', 'time' ),
  35     'date' => array( 'date', 'time', 'type', 'patient' ),
  36     'time' => array( 'time', 'date', 'patient' ),
  37     'type' => array( 'type', 'date', 'time', 'patient' ),
  38     'comment' => array( 'comment', 'date', 'time', 'patient' ),
  39     'status' => array( 'status', 'date', 'time', 'patient' ),
  40     'completed' => array( 'completed', 'date', 'time', 'patient' ),
  41     'trackerstatus' => array( 'trackerstatus', 'date', 'time', 'patient' ),
  42 );
  43
  44 /*Arrays for the interpretation of recurrence patterns.*/
  45 $REPEAT_FREQ = array(
  46     '1' => xl('Every'),
  47     '2' => xl('Every 2nd'),
  48     '3' => xl('Every 3rd'),
  49     '4' => xl('Every 4th'),
  50     '5' => xl('Every 5th'),
  51     '6' => xl('Every 6th')
  52 );
  53
  54 $REPEAT_FREQ_TYPE = array(
  55     '0' => xl('day'),
  56     '1' => xl('week'),
  57     '2' => xl('month'),
  58     '3' => xl('year'),
  59     '4' => xl('workday')
  60 );
  61
  62 $REPEAT_ON_NUM = array(
  63     '1' => xl('1st'),
  64     '2' => xl('2nd'),
  65     '3' => xl('3rd'),
  66     '4' => xl('4th'),
  67     '5' => xl('Last')
  68 );
  69
  70 $REPEAT_ON_DAY = array(
  71     '0' => xl('Sunday'),
  72     '1' => xl('Monday'),
  73     '2' => xl('Tuesday'),
  74     '3' => xl('Wednesday'),
  75     '4' => xl('Thursday'),
  76     '5' => xl('Friday'),
  77     '6' => xl('Saturday')
  78 );
  79
  80 function fetchEvents($from_date, $to_date, $where_param = null, $orderby_param = null, $tracker_board = false, $nextX = 0, $bind_param = null, $query_param = null)
  81 {
  82
  83     $sqlBindArray = array();
  84
  85     if ($query_param) {
  86         $query = $query_param;
  87
  88         if ($bind_param) {
  89             $sqlBindArray = $bind_param;
  90         }
  91     } else {
  92         //////
  93         if ($nextX) {
  94             $where =
  95             "((e.pc_endDate >= ? AND e.pc_recurrtype > '0') OR " .
  96             "(e.pc_eventDate >= ?))";
  97
  98             array_push($sqlBindArray, $from_date, $from_date);
  99         } else {
 100           //////
 101             $where =
 102             "((e.pc_endDate >= ? AND e.pc_eventDate <= ? AND e.pc_recurrtype > '0') OR " .
 103             "(e.pc_eventDate >= ? AND e.pc_eventDate <= ?))";
 104
 105             array_push($sqlBindArray, $from_date, $to_date, $from_date, $to_date);
 106         }
 107
 108         if ($where_param) {
 109             $where .= $where_param;
 110         }
 111
 112         $order_by = "e.pc_eventDate, e.pc_startTime";
 113         if ($orderby_param) {
 114              $order_by = $orderby_param;
 115         }
 116
 117         // Tracker Board specific stuff
 118         $tracker_fields = '';
 119         $tracker_joins = '';
 120         if ($tracker_board) {
 121             $tracker_fields = "e.pc_room, e.pc_pid, t.id, t.date, t.apptdate, t.appttime, t.eid, t.pid, t.original_user, t.encounter, t.lastseq, t.random_drug_test, t.drug_screen_completed, " .
 122             "q.pt_tracker_id, q.start_datetime, q.room, q.status, q.seq, q.user, " .
 123             "s.toggle_setting_1, s.toggle_setting_2, s.option_id, ";
 124             $tracker_joins = "LEFT OUTER JOIN patient_tracker AS t ON t.pid = e.pc_pid AND t.apptdate = e.pc_eventDate AND t.appttime = e.pc_starttime AND t.eid = e.pc_eid " .
 125             "LEFT OUTER JOIN patient_tracker_element AS q ON q.pt_tracker_id = t.id AND q.seq = t.lastseq " .
 126             "LEFT OUTER JOIN list_options AS s ON s.list_id = 'apptstat' AND s.option_id = q.status AND s.activity = 1 " ;
 127         }
 128
 129         $query = "SELECT " .
 130         "e.pc_eventDate, e.pc_endDate, e.pc_startTime, e.pc_endTime, e.pc_duration, e.pc_recurrtype, e.pc_recurrspec, e.pc_recurrfreq, e.pc_catid, e.pc_eid, e.pc_gid, " .
 131         "e.pc_title, e.pc_hometext, e.pc_apptstatus, " .
 132         "p.fname, p.mname, p.lname, p.pid, p.pubpid, p.phone_home, p.phone_cell, " .
 133         "u.fname AS ufname, u.mname AS umname, u.lname AS ulname, u.id AS uprovider_id, " .
 134         "f.name, " .
 135         "$tracker_fields" .
 136         "c.pc_catname, c.pc_catid " .
 137         "FROM openemr_postcalendar_events AS e " .
 138         "$tracker_joins" .
 139         "LEFT OUTER JOIN facility AS f ON e.pc_facility = f.id " .
 140         "LEFT OUTER JOIN patient_data AS p ON p.pid = e.pc_pid " .
 141         "LEFT OUTER JOIN users AS u ON u.id = e.pc_aid " .
 142         "LEFT OUTER JOIN openemr_postcalendar_categories AS c ON c.pc_catid = e.pc_catid " .
 143         "WHERE $where " .
 144         "ORDER BY $order_by";
 145
 146         if ($bind_param) {
 147             $sqlBindArray = array_merge($sqlBindArray, $bind_param);
 148         }
 149     }
 150
 151
 152   ///////////////////////////////////////////////////////////////////////
 153   // The following code is from the calculateEvents function in the    //
 154   // PostCalendar Module modified and inserted here by epsdky          //
 155   ///////////////////////////////////////////////////////////////////////
 156
 157     $events2 = array();
 158
 159     $res = sqlStatement($query, $sqlBindArray);
 160
 161   ////////
 162     if ($nextX) {
 163         global $resNotNull;
 164         $resNotNull = (isset($res) && $res != null);
 165     }
 166
 167     while ($event = sqlFetchArray($res)) {
 168         ///////
 169         if ($nextX) {
 170             $stopDate = $event['pc_endDate'];
 171         } else {
 172             $stopDate = ($event['pc_endDate'] <= $to_date) ? $event['pc_endDate'] : $to_date;
 173         }
 174
 175         ///////
 176         $incX = 0;
 177         switch ($event['pc_recurrtype']) {
 178             case '0':
 179                 $events2[] = $event;
 180
 181                 break;
 182       //////
 183             case '1':
 184             case '3':
 185                 $event_recurrspec = @unserialize($event['pc_recurrspec']);
 186
 187                 $rfreq = $event_recurrspec['event_repeat_freq'];
 188                 $rtype = $event_recurrspec['event_repeat_freq_type'];
 189                 $exdate = $event_recurrspec['exdate'];
 190
 191                 list($ny,$nm,$nd) = explode('-', $event['pc_eventDate']);
 192         //        $occurance = Date_Calc::dateFormat($nd,$nm,$ny,'%Y-%m-%d');
 193                 $occurance = $event['pc_eventDate'];
 194
 195                 while ($occurance < $from_date) {
 196                     $occurance =& __increment($nd, $nm, $ny, $rfreq, $rtype);
 197                     list($ny,$nm,$nd) = explode('-', $occurance);
 198                 }
 199
 200                 while ($occurance <= $stopDate) {
 201                     $excluded = false;
 202                     if (isset($exdate)) {
 203                         foreach (explode(",", $exdate) as $exception) {
 204                             // occurrance format == yyyy-mm-dd
 205                             // exception format == yyyymmdd
 206                             if (preg_replace("/-/", "", $occurance) == $exception) {
 207                                 $excluded = true;
 208                             }
 209                         }
 210                     }
 211
 212                     if ($excluded == false) {
 213                         $event['pc_eventDate'] = $occurance;
 214                         $event['pc_endDate'] = '0000-00-00';
 215                         $events2[] = $event;
 216                       //////
 217                         if ($nextX) {
 218                             ++$incX;
 219                             if ($incX == $nextX) {
 220                                 break;
 221                             }
 222                         }
 223
 224                       //////
 225                     }
 226
 227                     $occurance =& __increment($nd, $nm, $ny, $rfreq, $rtype);
 228                     list($ny,$nm,$nd) = explode('-', $occurance);
 229                 }
 230                 break;
 231
 232       //////
 233             case '2':
 234                 $event_recurrspec = @unserialize($event['pc_recurrspec']);
 235
 236                 $rfreq = $event_recurrspec['event_repeat_on_freq'];
 237                 $rnum  = $event_recurrspec['event_repeat_on_num'];
 238                 $rday  = $event_recurrspec['event_repeat_on_day'];
 239                 $exdate = $event_recurrspec['exdate'];
 240
 241                 list($ny,$nm,$nd) = explode('-', $event['pc_eventDate']);
 242
 243                 if (isset($event_recurrspec['rt2_pf_flag']) && $event_recurrspec['rt2_pf_flag']) {
 244                     $nd = 1;
 245                 }
 246
 247                 $occuranceYm = "$ny-$nm"; // YYYY-mm
 248                 $from_dateYm = substr($from_date, 0, 7); // YYYY-mm
 249                 $stopDateYm = substr($stopDate, 0, 7); // YYYY-mm
 250
 251                 // $nd will sometimes be 29, 30 or 31 and if used in the mktime functions below
 252                 // a problem with overflow will occur so it is set to 1 to avoid this (for rt2
 253                 // appointments set prior to fix $nd remains unchanged). This can be done since
 254                 // $nd has no influence past the mktime functions.
 255                 while ($occuranceYm < $from_dateYm) {
 256                     $occuranceYmX = date('Y-m-d', mktime(0, 0, 0, $nm+$rfreq, $nd, $ny));
 257                     list($ny,$nm,$nd) = explode('-', $occuranceYmX);
 258                     $occuranceYm = "$ny-$nm";
 259                 }
 260
 261                 while ($occuranceYm <= $stopDateYm) {
 262                     // (YYYY-mm)-dd
 263                     $dnum = $rnum;
 264                     do {
 265                         $occurance = Date_Calc::NWeekdayOfMonth($dnum--, $rday, $nm, $ny, $format = "%Y-%m-%d");
 266                     } while ($occurance === -1);
 267
 268                     if ($occurance >= $from_date && $occurance <= $stopDate) {
 269                         $excluded = false;
 270                         if (isset($exdate)) {
 271                             foreach (explode(",", $exdate) as $exception) {
 272                                 // occurrance format == yyyy-mm-dd
 273                                 // exception format == yyyymmdd
 274                                 if (preg_replace("/-/", "", $occurance) == $exception) {
 275                                     $excluded = true;
 276                                 }
 277                             }
 278                         }
 279
 280                         if ($excluded == false) {
 281                             $event['pc_eventDate'] = $occurance;
 282                             $event['pc_endDate'] = '0000-00-00';
 283                             $events2[] = $event;
 284                             //////
 285                             if ($nextX) {
 286                                 ++$incX;
 287                                 if ($incX == $nextX) {
 288                                     break;
 289                                 }
 290                             }
 291
 292                             //////
 293                         }
 294                     }
 295
 296                     $occuranceYmX = date('Y-m-d', mktime(0, 0, 0, $nm+$rfreq, $nd, $ny));
 297                     list($ny,$nm,$nd) = explode('-', $occuranceYmX);
 298                     $occuranceYm = "$ny-$nm";
 299                 }
 300                 break;
 301         }
 302     }
 303
 304     return $events2;
 305 ////////////////////// End of code inserted by epsdky
 306 }
 307
 308 function fetchAllEvents($from_date, $to_date, $provider_id = null, $facility_id = null)
 309 {
 310     $sqlBindArray = array();
 311
 312     $where = "";
 313
 314     if ($provider_id) {
 315         $where .= " AND e.pc_aid = ?";
 316         array_push($sqlBindArray, $provider_id);
 317     }
 318
 319     if ($facility_id) {
 320         $where .= " AND e.pc_facility = ? AND u.facility_id = ?";
 321         array_push($sqlBindArray, $facility_id, $facility_id);
 322     }
 323
 324     $appointments = fetchEvents($from_date, $to_date, $where, null, false, 0, $sqlBindArray);
 325     return $appointments;
 326 }
 327
 328 //Support for therapy group appointments added by shachar z.
 329 function fetchAppointments($from_date, $to_date, $patient_id = null, $provider_id = null, $facility_id = null, $pc_appstatus = null, $with_out_provider = null, $with_out_facility = null, $pc_catid = null, $tracker_board = false, $nextX = 0, $group_id = null, $patient_name = null)
 330 {
 331     $sqlBindArray = array();
 332
 333     $where = "";
 334
 335     if ($provider_id) {
 336         $where .= " AND e.pc_aid = ?";
 337         array_push($sqlBindArray, $provider_id);
 338     }
 339
 340     if ($patient_id) {
 341         $where .= " AND e.pc_pid = ?";
 342         array_push($sqlBindArray, $patient_id);
 343     } elseif ($group_id) {
 344         //if $group_id this means we want only the group events
 345         $where .= " AND e.pc_gid = ? AND e.pc_pid = ''";
 346         array_push($sqlBindArray, $group_id);
 347     } else {
 348         $where .= " AND e.pc_pid != ''";
 349     }
 350
 351     if ($facility_id) {
 352         $where .= " AND e.pc_facility = ?";
 353         array_push($sqlBindArray, $facility_id);
 354     }
 355
 356     //Appointment Status Checking
 357     if ($pc_appstatus != '') {
 358         $where .= " AND e.pc_apptstatus = ?";
 359         array_push($sqlBindArray, $pc_appstatus);
 360     }
 361
 362     if ($pc_catid != null) {
 363         $where .= " AND e.pc_catid = ?";
 364         array_push($sqlBindArray, $pc_catid);
 365     }
 366
 367     if ($patient_name != null) {
 368         $where .= " AND (p.fname LIKE CONCAT('%',?,'%') OR p.lname LIKE CONCAT('%',?,'%'))";
 369         array_push($sqlBindArray, $patient_name, $patient_name);
 370     }
 371
 372     //Without Provider checking
 373     if ($with_out_provider != '') {
 374         $where .= " AND e.pc_aid = ''";
 375     }
 376
 377     //Without Facility checking
 378     if ($with_out_facility != '') {
 379         $where .= " AND e.pc_facility = 0";
 380     }
 381
 382     $appointments = fetchEvents($from_date, $to_date, $where, '', $tracker_board, $nextX, $sqlBindArray);
 383     return $appointments;
 384 }
 385
 386 //Support for therapy group appointments added by shachar z.
 387 function fetchNextXAppts($from_date, $patient_id, $nextX = 1, $group_id = null)
 388 {
 389
 390     $appts = array();
 391     $nextXAppts = array();
 392     $appts = fetchAppointments($from_date, null, $patient_id, null, null, null, null, null, null, false, $nextX, $group_id);
 393     if ($appts) {
 394         $appts = sortAppointments($appts);
 395         $nextXAppts = array_slice($appts, 0, $nextX);
 396     }
 397
 398     return $nextXAppts;
 399 }
 400
 401 // get the event slot size in seconds
 402 function getSlotSize()
 403 {
 404     if (isset($GLOBALS['calendar_interval'])) {
 405         return $GLOBALS['calendar_interval'] * 60;
 406     }
 407
 408     return 15 * 60;
 409 }
 410
 411 function getAvailableSlots($from_date, $to_date, $provider_id = null, $facility_id = null)
 412 {
 413     $appointments = fetchAllEvents($from_date, $to_date, $provider_id, $facility_id);
 414     $appointments = sortAppointments($appointments, "date");
 415     $from_datetime = strtotime($from_date." 00:00:00");
 416     $to_datetime = strtotime($to_date." 23:59:59");
 417     $availableSlots = array();
 418     $start_time = 0;
 419     $date = 0;
 420     for ($i = 0; $i < count($appointments); ++$i) {
 421         if ($appointments[$i]['pc_catid'] == 2) { // 2 == In Office
 422             $start_time = $appointments[$i]['pc_startTime'];
 423             $date = $appointments[$i]['pc_eventDate'];
 424             $provider_id = $appointments[$i]['uprovider_id'];
 425         } else if ($appointments[$i]['pc_catid'] == 3) { // 3 == Out Of Office
 426             continue;
 427         } else {
 428             $start_time = $appointments[$i]['pc_endTime'];
 429             $date = $appointments[$i]['pc_eventDate'];
 430             $provider_id = $appointments[$i]['uprovider_id'];
 431         }
 432
 433         // find next appointment with the same provider
 434         $next_appointment_date = 0;
 435         $next_appointment_time = 0;
 436         for ($j = $i+1; $j < count($appointments); ++$j) {
 437             if ($appointments[$j]['uprovider_id'] == $provider_id) {
 438                 $next_appointment_date = $appointments[$j]['pc_eventDate'];
 439                 $next_appointment_time = $appointments[$j]['pc_startTime'];
 440                 break;
 441             }
 442         }
 443
 444         $same_day = ( strtotime($next_appointment_date) == strtotime($date) ) ? true : false;
 445
 446         if ($next_appointment_time && $same_day) {
 447             // check the start time of the next appointment
 448
 449             $start_datetime = strtotime($date." ".$start_time);
 450             $next_appointment_datetime = strtotime($next_appointment_date." ".$next_appointment_time);
 451             $curr_time = $start_datetime;
 452             while ($curr_time < $next_appointment_datetime - (getSlotSize() / 2)) {
 453                 //create a new appointment ever 15 minutes
 454                 $time = date("H:i:s", $curr_time);
 455                 $available_slot = createAvailableSlot(
 456                     $appointments[$i]['pc_eventDate'],
 457                     $time,
 458                     $appointments[$i]['ufname'],
 459                     $appointments[$i]['ulname'],
 460                     $appointments[$i]['umname']
 461                 );
 462                 $availableSlots []= $available_slot;
 463                 $curr_time += getSlotSize(); // add a 15-minute slot
 464             }
 465         }
 466     }
 467
 468     return $availableSlots;
 469 }
 470
 471 function createAvailableSlot($event_date, $start_time, $provider_fname, $provider_lname, $provider_mname = "", $cat_name = "Available")
 472 {
 473     $newSlot = array();
 474     $newSlot['ulname'] = $provider_lname;
 475     $newSlot['ufname'] = $provider_fname;
 476     $newSlot['umname'] = $provider_mname;
 477     $newSlot['pc_eventDate'] = $event_date;
 478     $newSlot['pc_startTime'] = $start_time;
 479     $newSlot['pc_endTime'] = $start_time;
 480     $newSlot['pc_catname'] = $cat_name;
 481     return $newSlot;
 482 }
 483
 484 function getCompareFunction($code)
 485 {
 486     global $COMPARE_FUNCTION_HASH;
 487     return $COMPARE_FUNCTION_HASH[$code];
 488 }
 489
 490 function getComparisonOrder($code)
 491 {
 492     global $ORDERHASH;
 493     return $ORDERHASH[$code];
 494 }
 495
 496
 497 function sortAppointments(array $appointments, $orderBy = 'date')
 498 {
 499     global $appointment_sort_order;
 500     $appointment_sort_order = $orderBy;
 501     usort($appointments, "compareAppointments");
 502     return $appointments;
 503 }
 504
 505 // cmp_function for usort
 506 // The comparison function must return an integer less than, equal to,
 507 // or greater than zero if the first argument is considered to be respectively less than, equal to, or greater than the second.
 508 function compareAppointments($appointment1, $appointment2)
 509 {
 510     global $appointment_sort_order;
 511     $comparisonOrder = getComparisonOrder($appointment_sort_order);
 512     foreach ($comparisonOrder as $comparison) {
 513         $cmp_function = getCompareFunction($comparison);
 514         $result = $cmp_function($appointment1, $appointment2);
 515         if (0 != $result) {
 516             return $result;
 517         }
 518     }
 519
 520     return 0;
 521 }
 522
 523 function compareBasic($e1, $e2)
 524 {
 525     if ($e1 < $e2) {
 526         return -1;
 527     } else if ($e1 > $e2) {
 528         return 1;
 529     }
 530
 531     return 0;
 532 }
 533
 534 function compareAppointmentsByDate($appointment1, $appointment2)
 535 {
 536     $date1 = strtotime($appointment1['pc_eventDate']);
 537     $date2 = strtotime($appointment2['pc_eventDate']);
 538
 539     return compareBasic($date1, $date2);
 540 }
 541
 542 function compareAppointmentsByTime($appointment1, $appointment2)
 543 {
 544     $time1 = strtotime($appointment1['pc_startTime']);
 545     $time2 = strtotime($appointment2['pc_startTime']);
 546
 547     return compareBasic($time1, $time2);
 548 }
 549
 550 function compareAppointmentsByDoctorName($appointment1, $appointment2)
 551 {
 552     $name1 = $appointment1['ulname'];
 553     $name2 = $appointment2['ulname'];
 554     $cmp = compareBasic($name1, $name2);
 555     if ($cmp == 0) {
 556         $name1 = $appointment1['ufname'];
 557         $name2 = $appointment2['ufname'];
 558         return compareBasic($name1, $name2);
 559     }
 560
 561     return $cmp;
 562 }
 563
 564 function compareAppointmentsByPatientName($appointment1, $appointment2)
 565 {
 566     $name1 = $appointment1['lname'];
 567     $name2 = $appointment2['lname'];
 568     $cmp = compareBasic($name1, $name2);
 569     if ($cmp == 0) {
 570         $name1 = $appointment1['fname'];
 571         $name2 = $appointment2['fname'];
 572         return compareBasic($name1, $name2);
 573     }
 574
 575     return $cmp;
 576 }
 577
 578 function compareAppointmentsByType($appointment1, $appointment2)
 579 {
 580     $type1 = $appointment1['pc_catid'];
 581     $type2 = $appointment2['pc_catid'];
 582     return compareBasic($type1, $type2);
 583 }
 584
 585 function compareAppointmentsByPatientId($appointment1, $appointment2)
 586 {
 587     $id1 = $appointment1['pubpid'];
 588     $id2 = $appointment2['pubpid'];
 589     return compareBasic($id1, $id2);
 590 }
 591
 592 function compareAppointmentsByComment($appointment1, $appointment2)
 593 {
 594     $comment1 = $appointment1['pc_hometext'];
 595     $comment2 = $appointment2['pc_hometext'];
 596     return compareBasic($comment1, $comment2);
 597 }
 598
 599 function compareAppointmentsByStatus($appointment1, $appointment2)
 600 {
 601     $status1 = $appointment1['pc_apptstatus'];
 602     $status2 = $appointment2['pc_apptstatus'];
 603     return compareBasic($status1, $status2);
 604 }
 605
 606 function compareAppointmentsByTrackerStatus($appointment1, $appointment2)
 607 {
 608     $trackerstatus1 = $appointment1['status'];
 609     $trackerstatus2 = $appointment2['status'];
 610     return compareBasic($trackerstatus1, $trackerstatus2);
 611 }
 612
 613 function compareAppointmentsByCompletedDrugScreen($appointment1, $appointment2)
 614 {
 615     $completed1 = $appointment1['drug_screen_completed'];
 616     $completed2 = $appointment2['drug_screen_completed'];
 617     return compareBasic($completed1, $completed2);
 618 }
 619
 620 function fetchAppointmentCategories()
 621 {
 622      $catSQL= " SELECT pc_catid as id, pc_catname as category "
 623             . " FROM openemr_postcalendar_categories WHERE pc_recurrtype=0 and pc_cattype=0";
 624     if ($GLOBALS['enable_group_therapy']) {
 625         $catSQL .= " OR pc_cattype=3";
 626     }
 627
 628     $catSQL .= "  ORDER BY category";
 629      return sqlStatement($catSQL);
 630 }
 631
 632 function interpretRecurrence($recurr_freq, $recurr_type)
 633 {
 634     global $REPEAT_FREQ, $REPEAT_FREQ_TYPE, $REPEAT_ON_NUM, $REPEAT_ON_DAY;
 635     $interpreted = "";
 636     $recurr_freq = unserialize($recurr_freq);
 637     if ($recurr_type == 1) {
 638         $interpreted = $REPEAT_FREQ[$recurr_freq['event_repeat_freq']];
 639         $interpreted .= " " . $REPEAT_FREQ_TYPE[$recurr_freq['event_repeat_freq_type']];
 640     } elseif ($recurr_type == 2) {
 641         $interpreted = $REPEAT_FREQ[$recurr_freq['event_repeat_on_freq']];
 642         $interpreted .= " " . $REPEAT_ON_NUM[$recurr_freq['event_repeat_on_num']];
 643         $interpreted .= " " . $REPEAT_ON_DAY[$recurr_freq['event_repeat_on_day']];
 644     } elseif ($recurr_type == 3) {
 645         $interpreted = $REPEAT_FREQ[1];
 646         $comma = "";
 647         $day_arr = explode(",", $recurr_freq['event_repeat_freq']);
 648         foreach ($day_arr as $day) {
 649             $interpreted .= $comma . " " . $REPEAT_ON_DAY[$day - 1];
 650             $comma = ",";
 651         }
 652     }
 653
 654     return $interpreted;
 655 }
 656
 657 function fetchRecurrences($pid)
 658 {
 659     $query = "SELECT pe.pc_title, pe.pc_endDate, pe.pc_recurrtype, pe.pc_recurrspec, pc.pc_catname FROM openemr_postcalendar_events AS pe "
 660                     . "JOIN openemr_postcalendar_categories AS pc ON pe.pc_catid=pc.pc_catid "
 661                     . "WHERE pe.pc_pid = ?  AND pe.pc_recurrtype > 0;";
 662     $sqlBindArray = array();
 663     array_push($sqlBindArray, $pid);
 664     $res = sqlStatement($query, $sqlBindArray);
 665     $row = 0;
 666     while ($res_arr[$row] = sqlFetchArray($res)) {
 667         $res_arr[$row]['pc_recurrspec'] = interpretRecurrence($res_arr[$row]['pc_recurrspec'], $res_arr[$row]['pc_recurrtype']);
 668         $row++;
 669     }
 670
 671     return $res_arr;
 672 }
 673
 674 function ends_in_a_week($end_date)
 675 {
 676     $timestamp_in_a_week = strtotime('+7 day');
 677     $timestamp_end_date = strtotime($end_date);
 678     if ($timestamp_in_a_week > $timestamp_end_date) {
 679         return true; //ends in a week
 680     }
 681
 682     return false; // ends in more than a week
 683 }
 684
 685 //Checks if recurrence is current (didn't end yet).
 686 function recurrence_is_current($end_date)
 687 {
 688     $end_date_timestamp = strtotime($end_date);
 689     $current_timestamp = time();
 690     if ($current_timestamp <= $end_date_timestamp) {
 691         return true; //recurrence is current
 692     }
 693
 694     return false;
 695 }