Check Reservation

public function onCheckReservationCancellation( object $reservation ) : bool

Fires while checking whether the cancellation is allowed for the specified reservation.

Description

This filter can be used to apply additional conditions to the cancellation restrictions. Applies only for restaurant reservations.

When this hook is triggered, the system already validated the standard conditions and the cancellation has been approved for the usage.

In case of allowed cancellation, the page containing the reservation details will report a button to cancel the reservation.

Parameters

$reservation

(VREOrderRestaurant)  An object containing the details of the reservation that is going to be cancelled.

Return Value

Boolean. Use false to deny the cancellation.

Example

The example below prevents the cancellation for those customers that never booked a table. In summary, the cancellation will be allowed starting from the second table booking.

/**
 * This filter can be used to apply additional conditions to the 
 * cancellation restrictions. When this hook is triggered, the
 * system already validated the standard conditions and the
 * cancellation has been approved for the usage.
 *
 * @param   object  $reservation  The restaurant reservation to check.
 *
 * @return  bool    Use false to deny the cancellation.
 */
public function onCheckReservationCancellation($reservation)
{
    if ($reservation->id_user <= 0) {
        // only registered user can request a cancellation
        return false;
    }

    $dbo = JFactory::getDbo();

    $q = $dbo->getQuery(true)
        ->select(1)
        ->from($dbo->qn('#__vikrestaurants_reservation'))
        ->where($dbo->qn('status') . ' IN ("C", "P")')
        ->where($dbo->qn('id') . ' <> ' . $reservation->id)
        ->where($dbo->qn('id_parent') . ' <> ' . $reservation->id)
        ->andWhere(array(
            $dbo->qn('id_user') . ' = ' . $reservation->id_user,
            $dbo->qn('created_by') . ' = ' . $reservation->id_user,
        ), 'OR');

    $dbo->setQuery($q, 0, 1);
    $dbo->execute();

    // prevent cancellation in case of no existing reservations
    // assigned to this customer
    return $dbo->getNumRows() ? true : false;
}

Changelog