Source for file book.php

Documentation is available at book.php

  1. <?php
  2. /**
  3. * Make, edit and delete bookings
  4. *
  5. * @author     Stuart Prescott
  6. * @copyright  Copyright Stuart Prescott
  7. * @license    http://opensource.org/licenses/gpl-license.php GNU Public License
  8. * @version    $Id: book.php,v 1.16 2007/02/05 23:36:50 themill Exp $
  9. * @package    Bumblebee
  10. * @subpackage Actions
  11. *
  12. *  path (bumblebee root)/inc/actions/book.php
  13. */
  14.  
  15. /** Load ancillary functions */
  16. require_once 'inc/typeinfo.php';
  17. checkValidInclude();
  18.  
  19. /** calendar object */
  20. require_once 'inc/bb/calendar.php';
  21. /** generic booking entry object */
  22. require_once 'inc/bb/bookingentry.php';
  23. /** read-only booking entry object */
  24. require_once 'inc/bb/bookingentryro.php';
  25. /** list of choices object */
  26. require_once 'inc/formslib/anchortablelist.php';
  27. /** date maniuplation objects */
  28. require_once 'inc/date.php';
  29. /** parent object */
  30. require_once 'inc/actions/viewbase.php';
  31.  
  32. /**
  33. * Make edit or delete a booking
  34. * @package    Bumblebee
  35. * @subpackage Actions
  36. */
  37. class ActionBook extends ActionViewBase {
  38.   /**
  39.   * booking is for the logged in user
  40.   * @var boolean 
  41.   */
  42.   var $_isOwnBooking    = false;
  43.   /**
  44.   * logged in user can modify booking
  45.   * @var boolean 
  46.   */
  47.   var $_haveWriteAccess = false;
  48.  
  49.  
  50.   /**
  51.   * Initialising the class
  52.   *
  53.   * @param  BumblebeeAuth $auth  Authorisation object
  54.   * @param  array $pdata   extra state data from the call path
  55.   * @return void nothing
  56.   */
  57.   function ActionBook($auth, $PDATA) {
  58.     parent::ActionViewBase($auth, $PDATA);
  59.     $this->mungeInputData();
  60.   }
  61.  
  62.   function go() {
  63.     if (! isset($this->PD['bookid'])
  64.         && ( ! isset($this->PD['instrid'])
  65.               || $this->PD['instrid'] < 1
  66.               || $this->PD['instrid'] == '')) {
  67.       $err = 'Invalid action specification in actions/book.php::go(): no instrument specified';
  68.       $this->log($err);
  69.       trigger_error($err, E_USER_WARNING);
  70.       return;
  71.     }
  72.  
  73.     if (isset($this->PD['bookid'])
  74.         && ( ! isset($this->PD['instrid'])
  75.               || $this->PD['instrid'] < 1
  76.               || $this->PD['instrid'] == '')) {
  77.        $booking = quickSQLSelect('bookings', 'id', $this->PD['bookid']);
  78.        if (! isset($booking['id'])) return $this->_UnknownBooking();
  79.        $this->instrument = $booking['instrument'];
  80.        $start = new SimpleDate($booking['bookwhen']);
  81.        $this->PD['isodate'] = $start->dateString();
  82.     }
  83.  
  84.     $this->row = quickSQLSelect('instruments', 'id', $this->instrument);
  85.     foreach ($this->instrument as $i) {
  86.       $this->row[$i] = quickSQLSelect('instruments', 'id', $i);
  87.     }
  88.  
  89.     if (isset($this->PD['delete']) && isset($this->PD['bookid']) && ! $this->readOnly) {
  90.       $this->deleteBooking();
  91.       echo $this->_calendarViewLink($this->instrument);
  92.     } elseif (isset($this->PD['bookid']) && isset($this->PD['edit']) && ! $this->readOnly) {
  93.       $this->editBooking(true);
  94.       echo $this->_calendarViewLink($this->instrument);
  95.     } elseif (isset($this->PD['bookid']) && isset($this->PD['editform'])) {
  96.       $this->editBooking(false);
  97.       echo $this->_calendarViewLink($this->instrument);
  98.     } elseif (isset($this->PD['bookid'])) {
  99.       $this->viewBooking();
  100.       echo $this->_calendarViewLink($this->instrument);
  101.     } elseif ( (isset($this->PD['startticks']) && isset($this->PD['stopticks']))
  102.                || (isset($this->PD['bookwhen-time']) && isset($this->PD['bookwhen-date']) && isset($this->PD['duration']) ) ) {
  103.       $this->createBooking();
  104.       echo $this->_calendarViewLink($this->instrument);
  105.     } else {
  106.       # shouldn't get here
  107.       $err = 'Invalid action specification in action/book.php::go()';
  108.       $this->log($err);
  109.       trigger_error($err, E_USER_WARNING);
  110.       return;
  111.     }
  112.   }
  113.  
  114.   function mungeInputData() {
  115.     parent::mungeInputData();
  116.     if (strpos($this->instrument, ',')) {
  117.       $this->instrument = explode(',', $this->instrument);
  118.     } else {
  119.       $this->instrument = array($this->instrument);
  120.     }
  121.     echoData($this->PD, 0);
  122.   }
  123.  
  124.   /**
  125.   * Make a new booking
  126.   */
  127.   function createBooking() {
  128.     $start = new SimpleDate(issetSet($this->PD, 'startticks'));
  129.     $stop  = new SimpleDate(issetSet($this->PD, 'stopticks'));
  130.     $duration = new SimpleTime($stop->subtract($start));
  131.     $this->log($start->dateTimeString().', '.$duration->timeString().', '.$start->dow());
  132.  
  133.     if ($this->MakeBookingPermitted($start)) {
  134.       $this->_editCreateBooking(-1, $start->dateTimeString(), $duration->timeString());
  135.     } else {
  136.       $this->_createBookingForbidden();
  137.     }
  138.   }
  139.  
  140.   /**
  141.   * Editing an existing booking
  142.   */
  143.   function editBooking($doSync) {
  144.     $start = new SimpleDate(issetSet($this->PD, 'startticks'));
  145.     $this->_editCreateBooking($this->PD['bookid'], $start->dateTimeString(), -1, $doSync);
  146.   }
  147.  
  148.   /**
  149.   * Do the hard work to edit or create the booking
  150.   */
  151.   function _editCreateBooking($bookid, $start, $duration, $doSync=false) {
  152.     $ip = $this->auth->getRemoteIP();
  153.     //echo $ip;
  154.     $booking = new BookingEntry($bookid, $this->auth, $this->instrument, $this->row['mindatechange'],$ip,
  155.                                 $start, $duration, $this->row['timeslotpicture']);
  156.     $this->_checkBookingAuth($booking->fields['userid']->getValue());
  157.     if (! $this->_haveWriteAccess) {
  158.       return $this->_forbiddenError(T_('Edit booking'));
  159.     }
  160.     $booking->update($this->PD);
  161.     $booking->checkValid();
  162.     echo $this->displayInstrumentHeader();
  163.  
  164.     if ($doSync) {
  165.       echo $this->reportAction($booking->sync(),
  166.                 array(
  167.                     STATUS_OK =>   ($bookid < 0 ? T_('Booking made') : T_('Booking updated')),
  168.                     STATUS_ERR =>  T_('Booking could not be made:').'<br/><br/>'.$booking->errorMessage
  169.                 )
  170.               );
  171.     }
  172.     echo $booking->display();
  173.     $submit = ($booking->id < 0) ? T_('Make booking') : T_('Update booking');
  174.     $delete = ($booking->id >= 0 && $booking->deletable) ? T_('Delete booking') : '';
  175.     echo "<input type='submit' name='submit' value='$submit' />";
  176.     if ($delete) echo "<input type='submit' name='delete' value='$delete' />";
  177.     echo $this->displayInstrumentFooter();
  178.   }
  179.  
  180.   /**
  181.   * Display a booking in read-only format (i.e. not in a form to allow it to be edited)
  182.   */
  183.   function viewBooking() {
  184.     $booking = new BookingEntryRO($this->PD['bookid']);
  185.     $this->_checkBookingAuth($booking->data->userid);
  186.     echo $this->displayInstrumentHeader();
  187.     $adminView = $this->auth->permitted(BBROLE_VIEW_BOOKINGS_DETAILS, $this->instrument);
  188.     echo $booking->display($adminView, $this->_isOwnBooking);
  189.     $adminEdit = $this->auth->permitted(BBROLE_EDIT_ALL, $this->instrument);
  190.     if ($this->_isOwnBooking || $adminEdit) {
  191.       echo "<p><a href='"
  192.             .makeURL('book',
  193.                 array('instrid'  => $this->instrument,
  194.                       'bookid'   => $this->PD['bookid'],
  195.                       'editform' => 1,
  196.                       'isodate'  => $this->PD['isodate']))
  197.             ."'>". T_('Edit booking') ."</a></p>\n";
  198.     }
  199.   }
  200.  
  201.   /**
  202.   * Delete a booking
  203.   */
  204.   function deleteBooking() {
  205.     $booking = new BookingEntry($this->PD['bookid'], $this->auth, $this->instrument, $this->row['mindatechange']);
  206.     $this->_checkBookingAuth($booking->fields['userid']->getValue());
  207.     if (! $this->_haveWriteAccess) {
  208.       return $this->_forbiddenError(T_('Delete booking'));
  209.     }
  210.     echo $this->displayInstrumentHeader();
  211.     echo $this->reportAction($booking->delete(),
  212.               array(
  213.                   STATUS_OK =>   T_('Booking deleted'),
  214.                   STATUS_ERR =>  T_('Booking could not be deleted:').'<br/><br/>'.$booking->errorMessage
  215.               )
  216.             );
  217.   }
  218.  
  219.   function _createBookingForbidden() {
  220.     $this->_Forbidden(T_('Sorry, making bookings at that time is not permitted.'));
  221.   }
  222.  
  223. } // class ActionBook
  224. ?>

Documentation generated on Tue, 06 Mar 2007 10:00:46 +0000 by phpDocumentor 1.3.0