&AutoUnsuspendReserves
&IsAvailableForItemLevelRequest
+ ItemsAnyAvailableForHold
&AlterPriority
&ToggleLowestPriority
=head2 AddReserve
- AddReserve($branch,$borrowernumber,$biblionumber,$bibitems,$priority,$resdate,$expdate,$notes,$title,$checkitem,$found)
+ AddReserve(
+ {
+ branchcode => $branchcode,
+ borrowernumber => $borrowernumber,
+ biblionumber => $biblionumber,
+ priority => $priority,
+ reservation_date => $reservation_date,
+ expiration_date => $expiration_date,
+ notes => $notes,
+ title => $title,
+ itemnumber => $itemnumber,
+ found => $found,
+ itemtype => $itemtype,
+ }
+ );
Adds reserve and generates HOLDPLACED message.
=cut
sub AddReserve {
- my (
- $branch, $borrowernumber, $biblionumber, $bibitems,
- $priority, $resdate, $expdate, $notes,
- $title, $checkitem, $found, $itemtype
- ) = @_;
+ my ($params) = @_;
+ my $branch = $params->{branchcode};
+ my $borrowernumber = $params->{borrowernumber};
+ my $biblionumber = $params->{biblionumber};
+ my $priority = $params->{priority};
+ my $resdate = $params->{reservation_date};
+ my $expdate = $params->{expiration_date};
+ my $notes = $params->{notes};
+ my $title = $params->{title};
+ my $checkitem = $params->{itemnumber};
+ my $found = $params->{found};
+ my $itemtype = $params->{itemtype};
$resdate = output_pref( { str => dt_from_string( $resdate ), dateonly => 1, dateformat => 'iso' })
or output_pref({ dt => dt_from_string, dateonly => 1, dateformat => 'iso' });
},
) ) {
- my $admin_email_address = $library->branchemail || C4::Context->preference('KohaAdminEmailAddress');
+ my $branch_email_address = $library->inbound_email_address;
C4::Letters::EnqueueLetter(
- { letter => $letter,
+ {
+ letter => $letter,
borrowernumber => $borrowernumber,
message_transport_type => 'email',
- from_address => $admin_email_address,
- to_address => $admin_email_address,
+ to_address => $branch_email_address,
}
);
}
# we retrieve rights
if ( my $rights = GetHoldRule( $borrower->{'categorycode'}, $item->effective_itemtype, $branchcode ) ) {
$ruleitemtype = $rights->{itemtype};
- $allowedreserves = $rights->{reservesallowed};
- $holds_per_record = $rights->{holds_per_record};
+ $allowedreserves = $rights->{reservesallowed} // $allowedreserves;
+ $holds_per_record = $rights->{holds_per_record} // $holds_per_record;
$holds_per_day = $rights->{holds_per_day};
}
else {
- $ruleitemtype = '*';
+ $ruleitemtype = undef;
}
my $holds = Koha::Holds->search(
biblionumber => $item->biblionumber,
}
);
- if ( $holds->count() >= $holds_per_record ) {
+ if ( defined $holds_per_record && $holds_per_record ne ''
+ && $holds->count() >= $holds_per_record ) {
return { status => "tooManyHoldsForThisRecord", limit => $holds_per_record };
}
reservedate => dt_from_string->date
});
- if ( defined $holds_per_day &&
- ( ( $holds_per_day > 0 && $today_holds->count() >= $holds_per_day )
- or ( $holds_per_day == 0 ) )
- ) {
+ if ( defined $holds_per_day && $holds_per_day ne ''
+ && $today_holds->count() >= $holds_per_day )
+ {
return { status => 'tooManyReservesToday', limit => $holds_per_day };
}
C4::Context->preference('item-level_itypes')
? " AND COALESCE( items.itype, biblioitems.itemtype ) = ?"
: " AND biblioitems.itemtype = ?"
- if ( $ruleitemtype ne "*" );
+ if defined $ruleitemtype;
my $sthcount = $dbh->prepare($querycount);
- if ( $ruleitemtype eq "*" ) {
- $sthcount->execute( $borrowernumber, $branchcode );
+ if ( defined $ruleitemtype ) {
+ $sthcount->execute( $borrowernumber, $branchcode, $ruleitemtype );
}
else {
- $sthcount->execute( $borrowernumber, $branchcode, $ruleitemtype );
+ $sthcount->execute( $borrowernumber, $branchcode );
}
my $reservecount = "0";
}
# we check if it's ok or not
- if ( $reservecount >= $allowedreserves ) {
+ if ( defined $allowedreserves && $allowedreserves ne ''
+ && $reservecount >= $allowedreserves ) {
return { status => 'tooManyReserves', limit => $allowedreserves };
}
C4::Items::ModItemTransfer(
$itemnumber,
$item->holdingbranch,
- $checkreserves->{'branchcode'}
+ $checkreserves->{'branchcode'},
+ 'Reserve'
),
;
}
ModReserveStatus($itemnumber,'W');
}
- $nextreservinfo = $checkreserves->{'borrowernumber'};
+ $nextreservinfo = $checkreserves;
}
return ( $messages, $nextreservinfo );
return 'Finished' if $found eq 'F';
}
- return 'Reserved' if $priority > 0;
+ return 'Reserved' if defined $priority && $priority > 0;
return ''; # empty string here will remove need for checking undef, or less log lines
}
return unless $itemnumber; # bail if we got nothing.
# if item is not for loan it cannot be reserved either.....
# except where items.notforloan < 0 : This indicates the item is holdable.
- return if ( $notforloan_per_item > 0 ) or $notforloan_per_itemtype;
+
+ my $dont_trap = C4::Context->preference('TrapHoldsOnOrder') ? ($notforloan_per_item > 0) : ($notforloan_per_item && 1 );
+ return if $dont_trap or $notforloan_per_itemtype;
# Find this item in the reserves
my @reserves = _Findgroupreserve( $bibitem, $biblio, $itemnumber, $lookahead_days, $ignore_borrowers);
# the more important the item.)
# $highest is the most important item we've seen so far.
my $highest;
+
if (scalar @reserves) {
my $LocalHoldsPriority = C4::Context->preference('LocalHoldsPriority');
my $LocalHoldsPriorityPatronControl = C4::Context->preference('LocalHoldsPriorityPatronControl');
my $priority = 10000000;
foreach my $res (@reserves) {
- if ( $res->{'itemnumber'} == $itemnumber && $res->{'priority'} == 0) {
+ if ( $res->{'itemnumber'} && $res->{'itemnumber'} == $itemnumber && $res->{'priority'} == 0) {
if ($res->{'found'} eq 'W') {
return ( "Waiting", $res, \@reserves ); # Found it, it is waiting
} else {
}
);
+ logaction( 'HOLDS', 'MODIFY', $hold->reserve_id, Dumper($hold->unblessed) )
+ if C4::Context->preference('HoldsLog');
+
# FIXME Must call Koha::Hold->cancel ? => No, should call ->filled and add the correct log
Koha::Old::Hold->new( $hold->unblessed() )->store();
$hold->itemnumber($itemnumber);
$hold->set_waiting($transferToDo);
- _koha_notify_reserve( $hold->reserve_id )
- if ( !$transferToDo && !$already_on_shelf );
+ if( !$transferToDo ){
+ _koha_notify_reserve( $hold->reserve_id ) unless $already_on_shelf;
+ my $transfers = Koha::Item::Transfers->search({
+ itemnumber => $itemnumber,
+ datearrived => undef
+ });
+ while( my $transfer = $transfers->next ){
+ $transfer->datearrived( dt_from_string() )->store;
+ };
+ }
+
_FixPriority( { biblionumber => $biblionumber } );
my $item = Koha::Items->find($itemnumber);
CartToShelf( $itemnumber );
}
+ logaction( 'HOLDS', 'MODIFY', $hold->reserve_id, Dumper($hold->unblessed) )
+ if C4::Context->preference('HoldsLog');
+
return;
}
#step 2 launch the subroutine of the others reserves
( $messages, $nextreservinfo ) = GetOtherReserves($itemnumber);
- return ( $messages, $nextreservinfo );
+ return ( $messages, $nextreservinfo->{borrowernumber} );
}
=head2 ModReserveMinusPriority
=cut
sub IsAvailableForItemLevelRequest {
- my ( $item, $patron, $pickup_branchcode ) = @_;
+ my $item = shift;
+ my $patron = shift;
+ my $pickup_branchcode = shift;
+ # items_any_available is precalculated status passed from request.pl when set of items
+ # looped outside of IsAvailableForItemLevelRequest to avoid nested loops:
+ my $items_any_available = shift;
my $dbh = C4::Context->dbh;
# must check the notforloan setting of the itemtype
$item->withdrawn ||
($item->damaged && !C4::Context->preference('AllowHoldsOnDamagedItems'));
- my $on_shelf_holds = Koha::IssuingRules->get_onshelfholds_policy( { item => $item, patron => $patron } );
-
if ($pickup_branchcode) {
my $destination = Koha::Libraries->find($pickup_branchcode);
return 0 unless $destination;
return 0 unless $branchitemrule->{hold_fulfillment_policy} ne 'holdgroup' || $home_library->validate_hold_sibling( {branchcode => $pickup_branchcode} );
}
+ my $on_shelf_holds = Koha::CirculationRules->get_onshelfholds_policy( { item => $item, patron => $patron } );
+
if ( $on_shelf_holds == 1 ) {
return 1;
} elsif ( $on_shelf_holds == 2 ) {
- my @items =
- Koha::Items->search( { biblionumber => $item->biblionumber } );
-
- my $any_available = 0;
-
- foreach my $i (@items) {
- my $reserves_control_branch = GetReservesControlBranch( $i->unblessed(), $patron->unblessed );
- my $branchitemrule = C4::Circulation::GetBranchItemRule( $reserves_control_branch, $i->itype );
- my $item_library = Koha::Libraries->find( {branchcode => $i->homebranch} );
-
-
- $any_available = 1
- unless $i->itemlost
- || $i->notforloan > 0
- || $i->withdrawn
- || $i->onloan
- || IsItemOnHoldAndFound( $i->id )
- || ( $i->damaged
- && !C4::Context->preference('AllowHoldsOnDamagedItems') )
- || Koha::ItemTypes->find( $i->effective_itemtype() )->notforloan
- || $branchitemrule->{holdallowed} == 1 && $patron->branchcode ne $i->homebranch
- || $branchitemrule->{holdallowed} == 3 && !$item_library->validate_hold_sibling( {branchcode => $patron->branchcode} );
- }
+ # if we have this param predefined from outer caller sub, we just need
+ # to return it, so we saving from having loop inside other loop:
+ return $items_any_available ? 0 : 1
+ if defined $items_any_available;
+
+ my $any_available = ItemsAnyAvailableForHold( { biblionumber => $item->biblionumber, patron => $patron });
return $any_available ? 0 : 1;
} else { # on_shelf_holds == 0 "If any unavailable" (the description is rather cryptic and could still be improved)
return $item->onloan || IsItemOnHoldAndFound( $item->itemnumber );
}
}
-sub _get_itype {
- my $item = shift;
+=head2 ItemsAnyAvailableForHold
- my $itype;
- if (C4::Context->preference('item-level_itypes')) {
- # We can't trust GetItem to honour the syspref, so safest to do it ourselves
- # When GetItem is fixed, we can remove this
- $itype = $item->{itype};
- }
- else {
- # XXX This is a bit dodgy. It relies on biblio itemtype column having different name.
- # So if we already have a biblioitems join when calling this function,
- # we don't need to access the database again
- $itype = $item->{itemtype};
- }
- unless ($itype) {
- my $dbh = C4::Context->dbh;
- my $query = "SELECT itemtype FROM biblioitems WHERE biblioitemnumber = ? ";
- my $sth = $dbh->prepare($query);
- $sth->execute($item->{biblioitemnumber});
- if (my $data = $sth->fetchrow_hashref()){
- $itype = $data->{itemtype};
- }
- }
- return $itype;
+ ItemsAnyAvailableForHold( { biblionumber => $biblionumber, patron => $patron });
+
+This function checks all items for specified biblionumber (num) / patron (object)
+and returns true (1) or false (0) depending if any of rules allows at least of
+one item to be available for hold including lots of parameters/logic
+
+=cut
+
+sub ItemsAnyAvailableForHold {
+ my $param = shift;
+
+ my @items = Koha::Items->search( { biblionumber => $param->{biblionumber} } );
+
+ my $any_available = 0;
+
+ foreach my $i (@items) {
+ my $reserves_control_branch =
+ GetReservesControlBranch( $i->unblessed(), $param->{patron}->unblessed );
+ my $branchitemrule =
+ C4::Circulation::GetBranchItemRule( $reserves_control_branch, $i->itype );
+ my $item_library = Koha::Libraries->find( { branchcode => $i->homebranch } );
+
+ $any_available = 1
+ unless $i->itemlost
+ || $i->notforloan > 0
+ || $i->withdrawn
+ || $i->onloan
+ || IsItemOnHoldAndFound( $i->id )
+ || ( $i->damaged
+ && ! C4::Context->preference('AllowHoldsOnDamagedItems') )
+ || Koha::ItemTypes->find( $i->effective_itemtype() )->notforloan
+ || $branchitemrule->{holdallowed} == 1 && $param->{patron}->branchcode ne $i->homebranch
+ || $branchitemrule->{holdallowed} == 3 && ! $item_library->validate_hold_sibling( { branchcode => $param->{patron}->branchcode } );
+ }
+
+ return $any_available;
}
=head2 AlterPriority
my $hold;
if ( $reserve_id ) {
$hold = Koha::Holds->find( $reserve_id );
+ if (!defined $hold){
+ # may have already been checked out and hold fulfilled
+ $hold = Koha::Old::Holds->find( $reserve_id );
+ }
return unless $hold;
}
sub MoveReserve {
my ( $itemnumber, $borrowernumber, $cancelreserve ) = @_;
+ $cancelreserve //= 0;
+
my $lookahead = C4::Context->preference('ConfirmFutureHolds'); #number of days to look for future holds
my ( $restype, $res, undef ) = CheckReserves( $itemnumber, undef, $lookahead );
return unless $res;
$sth = $dbh->prepare( $query );
$sth->execute( $reserve->{'biblionumber'} );
- ## Fix up the currently waiting reserve
- $query = "
- UPDATE reserves
- SET
- priority = 1,
- found = NULL,
- waitingdate = NULL
- WHERE
- reserve_id = ?
- ";
- $sth = $dbh->prepare( $query );
- $sth->execute( $reserve->{'reserve_id'} );
-
- unless ( $hold->item_level_hold ) {
- $hold->itemnumber(undef)->store;
- }
+ $hold->set(
+ {
+ priority => 1,
+ found => undef,
+ waitingdate => undef,
+ itemnumber => $hold->item_level_hold ? $hold->itemnumber : undef,
+ }
+ )->store();
_FixPriority( { biblionumber => $reserve->{biblionumber} } );
+
+ return $hold;
}
=head2 ReserveSlip
sub ReserveSlip {
my ($args) = @_;
my $branchcode = $args->{branchcode};
- my $borrowernumber = $args->{borrowernumber};
- my $biblionumber = $args->{biblionumber};
- my $itemnumber = $args->{itemnumber};
- my $barcode = $args->{barcode};
-
-
- my $patron = Koha::Patrons->find($borrowernumber);
-
- my $hold;
- if ($itemnumber || $barcode ) {
- $itemnumber ||= Koha::Items->find( { barcode => $barcode } )->itemnumber;
-
- $hold = Koha::Holds->search(
- {
- biblionumber => $biblionumber,
- borrowernumber => $borrowernumber,
- itemnumber => $itemnumber
- }
- )->next;
- }
- else {
- $hold = Koha::Holds->search(
- {
- biblionumber => $biblionumber,
- borrowernumber => $borrowernumber
- }
- )->next;
- }
+ my $reserve_id = $args->{reserve_id};
+ my $hold = Koha::Holds->find($reserve_id);
return unless $hold;
+
+ my $patron = $hold->borrower;
my $reserve = $hold->unblessed;
return C4::Letters::GetPreparedLetter (
}
}
);
- return unless $reservesallowed;;
my $rules;
- $rules->{reservesallowed} = $reservesallowed->rule_value;
- $rules->{itemtype} = $reservesallowed->itemtype;
- $rules->{categorycode} = $reservesallowed->categorycode;
- $rules->{branchcode} = $reservesallowed->branchcode;
+ if ( $reservesallowed ) {
+ $rules->{reservesallowed} = $reservesallowed->rule_value;
+ $rules->{itemtype} = $reservesallowed->itemtype;
+ $rules->{categorycode} = $reservesallowed->categorycode;
+ $rules->{branchcode} = $reservesallowed->branchcode;
+ }
my $holds_per_x_rules = Koha::CirculationRules->get_effective_rules(
{