3 # Copyright ByWater Solutions 2014
5 # This file is part of Koha.
7 # Koha is free software; you can redistribute it and/or modify it under the
8 # terms of the GNU General Public License as published by the Free Software
9 # Foundation; either version 3 of the License, or (at your option) any later
12 # Koha is distributed in the hope that it will be useful, but WITHOUT ANY
13 # WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
14 # A PARTICULAR PURPOSE. See the GNU General Public License for more details.
16 # You should have received a copy of the GNU General Public License along
17 # with Koha; if not, write to the Free Software Foundation, Inc.,
18 # 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
23 use Data::Dumper qw(Dumper);
25 use C4::Context qw(preference);
28 use Koha::DateUtils qw(dt_from_string output_pref);
34 use base qw(Koha::Object);
38 Koha::Hold - Koha Hold object class
48 my $hold = $hold->suspend_hold( $suspend_until_dt );
53 my ( $self, $dt ) = @_;
55 $dt = $dt ? $dt->clone()->truncate( to => 'day' ) : undef;
57 if ( $self->is_waiting ) { # We can't suspend waiting holds
58 carp "Unable to suspend waiting hold!";
63 $self->suspend_until( $dt );
67 logaction( 'HOLDS', 'SUSPEND', $self->reserve_id, Dumper($self->unblessed) )
68 if C4::Context->preference('HoldsLog');
75 my $hold = $hold->resume();
83 $self->suspend_until( undef );
87 logaction( 'HOLDS', 'RESUME', $self->reserve_id, Dumper($self->unblessed) )
88 if C4::Context->preference('HoldsLog');
102 my $deleted = $self->SUPER::delete($self);
104 logaction( 'HOLDS', 'DELETE', $self->reserve_id, Dumper($self->unblessed) )
105 if C4::Context->preference('HoldsLog');
115 my ( $self, $transferToDo ) = @_;
120 $self->found('T')->store();
124 my $today = dt_from_string();
127 waitingdate => $today->ymd,
130 my $requested_expiration;
131 if ($self->expirationdate) {
132 $requested_expiration = dt_from_string($self->expirationdate);
135 if ( C4::Context->preference("ExpireReservesMaxPickUpDelay") ) {
136 my $max_pickup_delay = C4::Context->preference("ReservesMaxPickUpDelay");
137 my $cancel_on_holidays = C4::Context->preference('ExpireReservesOnHolidays');
138 my $calendar = Koha::Calendar->new( branchcode => $self->branchcode );
140 my $expirationdate = $today->clone;
141 $expirationdate->add(days => $max_pickup_delay);
143 if ( C4::Context->preference("ExcludeHolidaysFromMaxPickUpDelay") ) {
144 $expirationdate = $calendar->days_forward( dt_from_string($self->waitingdate), $max_pickup_delay );
147 # If patron's requested expiration date is prior to the
148 # calculated one, we keep the patron's one.
149 my $cmp = $requested_expiration ? DateTime->compare($requested_expiration, $expirationdate) : 0;
150 $values->{expirationdate} = $cmp == -1 ? $requested_expiration->ymd : $expirationdate->ymd;
153 $self->set($values)->store();
160 Returns true if hold is a waiting or in transit
167 return 0 unless $self->found();
168 return 1 if $self->found() eq 'W';
169 return 1 if $self->found() eq 'T';
174 Returns true if hold is a waiting hold
181 my $found = $self->found;
182 return $found && $found eq 'W';
187 Returns true if hold is a in_transit hold
194 return 0 unless $self->found();
195 return $self->found() eq 'T';
200 Returns true if hold is a cancelable hold
202 Holds may be canceled if they not found, or
203 are found and waiting. A hold found but in
204 transit cannot be canceled.
211 return 1 unless $self->is_found();
212 return 0 if $self->is_in_transit();
213 return 1 if $self->is_waiting();
217 =head3 is_at_destination
219 Returns true if hold is waiting
220 and the hold's pickup branch matches
221 the hold item's holding branch
225 sub is_at_destination {
228 return $self->is_waiting() && ( $self->branchcode() eq $self->item()->holdingbranch() );
233 Returns the related Koha::Biblio object for this hold
240 $self->{_biblio} ||= Koha::Biblios->find( $self->biblionumber() );
242 return $self->{_biblio};
247 Returns the related Koha::Item object for this Hold
254 $self->{_item} ||= Koha::Items->find( $self->itemnumber() );
256 return $self->{_item};
261 Returns the related Koha::Library object for this Hold
268 $self->{_branch} ||= Koha::Libraries->find( $self->branchcode() );
270 return $self->{_branch};
275 Returns the related Koha::Patron object for this Hold
282 $self->{_borrower} ||= Koha::Patrons->find( $self->borrowernumber() );
284 return $self->{_borrower};
289 my $bool = $hold->is_suspended();
296 return $self->suspend();
309 Kyle M Hall <kyle@bywatersolutions.com>