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);
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 logaction( 'HOLDS', 'DELETE', $self->reserve_id, Dumper($self->unblessed) )
103 if C4::Context->preference('HoldsLog');
105 return $self->SUPER::delete($self);
108 =head3 waiting_expires_on
110 Returns a DateTime for the date a waiting holds expires on.
111 Returns undef if the system peference ReservesMaxPickUpDelay is not set.
112 Returns undef if the hold is not waiting ( found = 'W' ).
116 sub waiting_expires_on {
119 my $found = $self->found;
120 return unless $found && $found eq 'W';
122 my $ReservesMaxPickUpDelay = C4::Context->preference('ReservesMaxPickUpDelay');
123 return unless $ReservesMaxPickUpDelay;
125 my $dt = dt_from_string( $self->waitingdate() );
127 $dt->add( days => $ReservesMaxPickUpDelay );
134 Returns true if hold is a waiting or in transit
141 return 0 unless $self->found();
142 return 1 if $self->found() eq 'W';
143 return 1 if $self->found() eq 'T';
148 Returns true if hold is a waiting hold
155 my $found = $self->found;
156 return $found && $found eq 'W';
161 Returns true if hold is a in_transit hold
168 return 0 unless $self->found();
169 return $self->found() eq 'T';
174 Returns true if hold is a cancelable hold
176 Holds may be canceled if they not found, or
177 are found and waiting. A hold found but in
178 transit cannot be canceled.
185 return 1 unless $self->is_found();
186 return 0 if $self->is_in_transit();
187 return 1 if $self->is_waiting();
191 =head3 is_at_destination
193 Returns true if hold is waiting
194 and the hold's pickup branch matches
195 the hold item's holding branch
199 sub is_at_destination {
202 return $self->is_waiting() && ( $self->branchcode() eq $self->item()->holdingbranch() );
207 Returns the related Koha::Biblio object for this hold
214 $self->{_biblio} ||= Koha::Biblios->find( $self->biblionumber() );
216 return $self->{_biblio};
221 Returns the related Koha::Item object for this Hold
228 $self->{_item} ||= Koha::Items->find( $self->itemnumber() );
230 return $self->{_item};
235 Returns the related Koha::Library object for this Hold
242 $self->{_branch} ||= Koha::Libraries->find( $self->branchcode() );
244 return $self->{_branch};
249 Returns the related Koha::Patron object for this Hold
256 $self->{_borrower} ||= Koha::Patrons->find( $self->borrowernumber() );
258 return $self->{_borrower};
263 my $bool = $hold->is_suspended();
270 return $self->suspend();
283 Kyle M Hall <kyle@bywatersolutions.com>