Koha-clms/t/db_dependent/Koha/Patron.t

4065 lines
154 KiB
Perl
Executable File

#!/usr/bin/perl
# Copyright 2019 Koha Development team
#
# This file is part of Koha
#
# Koha is free software; you can redistribute it and/or modify it
# under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 3 of the License, or
# (at your option) any later version.
#
# Koha is distributed in the hope that it will be useful, but
# WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with Koha; if not, see <https://www.gnu.org/licenses>.
use Modern::Perl;
use Test::More tests => 52;
use Test::NoWarnings;
use Test::Exception;
use Test::Warn;
use Time::Fake;
use Koha::ArticleRequests;
use Koha::AuthUtils;
use Koha::CirculationRules;
use Koha::Database;
use Koha::DateUtils qw(dt_from_string);
use Koha::List::Patron qw(AddPatronList AddPatronsToList);
use Koha::Notice::Templates;
use Koha::Patron::Debarments qw(AddDebarment);
use Koha::Patron::Relationships;
use Koha::Patrons;
use C4::Auth;
use C4::Circulation qw( AddIssue AddReturn );
use t::lib::TestBuilder;
use t::lib::Mocks;
use Test::MockModule;
my $schema = Koha::Database->new->schema;
my $builder = t::lib::TestBuilder->new;
subtest 'Accessor tests' => sub {
plan tests => 9;
$schema->storage->txn_begin;
my $object = Koha::Patron->new( { surname => 'Test Patron' } );
is( $object->surname(), 'Test Patron', "Accessor returns correct value" );
$object->surname('Test Patron Surname');
is( $object->surname(), 'Test Patron Surname', "Accessor returns correct value after set" );
my $object2 = Koha::Patron->new( { surname => 'Test Patron 2' } );
is( $object2->surname(), 'Test Patron 2', "Accessor returns correct value" );
$object2->surname('Test Patron Surname 2');
is( $object2->surname(), 'Test Patron Surname 2', "Accessor returns correct value after set" );
my $ret;
$ret = $object2->set( { surname => "Test Patron Surname 3", firstname => "Test Firstname" } );
ok( ref($ret) eq 'Koha::Patron', "Set returns object on success" );
is( $object2->surname(), "Test Patron Surname 3", "Set sets first field correctly" );
is( $object2->firstname(), "Test Firstname", "Set sets second field correctly" );
our $patron = Koha::Patron->new(
{
borrowernumber => '12345',
cardnumber => '1234567890',
surname => 'mySurname',
firstname => 'myFirstname',
title => 'Mr.',
othernames => 'myOthernames',
initials => 'MM',
streetnumber => '100',
streettype => 'Blvd',
address => 'my personal address',
address2 => 'my adress2',
city => 'Marseille',
state => 'mystate',
zipcode => '13006',
country => 'France',
email => 'mySurname.myFirstname@email.com',
phone => '0402872934',
mobile => '0627884632',
fax => '0402872935',
emailpro => 'myEmailPro@email.com',
phonepro => '0402873334',
B_streetnumber => '101',
B_streettype => 'myB_streettype',
B_address => 'myB_address',
B_address2 => 'myB_address2',
B_city => 'myB_city',
B_state => 'myB_state',
B_zipcode => '23456',
B_country => 'myB_country',
B_email => 'myB_email',
B_phone => '0678353935',
dateofbirth => '1990-07-16',
branchcode => 'myBranCode',
categorycode => 'myCatCode',
dateenrolled => '2015-03-19',
dateexpiry => '2016-03-19',
gonenoaddress => '0',
lost => '0',
debarred => '2015-04-19',
debarredcomment => 'You are debarred',
borrowernotes => 'borrowernotes',
sex => 'M',
password => 'hfkurhfe976634èj!',
flags => '55555',
userid => '87987',
opacnote => 'myOpacnote',
contactnote => 'myContactnote',
sort1 => 'mySort1',
sort2 => 'mySort2',
altcontactfirstname => 'myAltcontactfirstname',
altcontactsurname => 'myAltcontactsurname',
altcontactaddress1 => 'myAltcontactaddress1',
altcontactaddress2 => 'myAltcontactaddress2',
altcontactaddress3 => 'myAltcontactaddress3',
altcontactstate => 'myAltcontactstate',
altcontactzipcode => '465843',
altcontactcountry => 'myOtherCountry',
altcontactphone => 'myOtherphone',
smsalertnumber => '0683027346',
privacy => '667788',
}
);
subtest 'Accessor tests after new' => sub {
plan tests => 60;
is( $patron->borrowernumber, '12345', 'borrowernumber accessor returns correct value' );
is( $patron->cardnumber, '1234567890', 'cardnumber accessor returns correct value' );
is( $patron->surname, 'mySurname', 'surname accessor returns correct value' );
is( $patron->firstname, 'myFirstname', 'firstname accessor returns correct value' );
is( $patron->title, 'Mr.', 'title accessor returns correct value' );
is( $patron->othernames, 'myOthernames', 'othernames accessor returns correct value' );
is( $patron->initials, 'MM', 'initials accessor returns correct value' );
is( $patron->streetnumber, '100', 'streetnumber accessor returns correct value' );
is( $patron->streettype, 'Blvd', 'streettype accessor returns correct value' );
is( $patron->address, 'my personal address', 'address accessor returns correct value' );
is( $patron->address2, 'my adress2', 'address2 accessor returns correct value' );
is( $patron->city, 'Marseille', 'city accessor returns correct value' );
is( $patron->state, 'mystate', 'state accessor returns correct value' );
is( $patron->zipcode, '13006', 'zipcode accessor returns correct value' );
is( $patron->country, 'France', 'country accessor returns correct value' );
is( $patron->email, 'mySurname.myFirstname@email.com', 'email accessor returns correct value' );
is( $patron->phone, '0402872934', 'phone accessor returns correct value' );
is( $patron->mobile, '0627884632', 'mobile accessor returns correct value' );
is( $patron->fax, '0402872935', 'fax accessor returns correct value' );
is( $patron->emailpro, 'myEmailPro@email.com', 'emailpro accessor returns correct value' );
is( $patron->phonepro, '0402873334', 'phonepro accessor returns correct value' );
is( $patron->B_streetnumber, '101', 'B_streetnumber accessor returns correct value' );
is( $patron->B_streettype, 'myB_streettype', 'B_streettype accessor returns correct value' );
is( $patron->B_address, 'myB_address', 'B_address accessor returns correct value' );
is( $patron->B_address2, 'myB_address2', 'B_address2 accessor returns correct value' );
is( $patron->B_city, 'myB_city', 'B_city accessor returns correct value' );
is( $patron->B_state, 'myB_state', 'B_state accessor returns correct value' );
is( $patron->B_zipcode, '23456', 'B_zipcode accessor returns correct value' );
is( $patron->B_country, 'myB_country', 'B_country accessor returns correct value' );
is( $patron->B_email, 'myB_email', 'B_email accessor returns correct value' );
is( $patron->B_phone, '0678353935', 'B_phone accessor returns correct value' );
is( $patron->dateofbirth, '1990-07-16', 'dateofbirth accessor returns correct value' );
is( $patron->branchcode, 'myBranCode', 'branchcode accessor returns correct value' );
is( $patron->categorycode, 'myCatCode', 'categorycode accessor returns correct value' );
is( $patron->dateenrolled, '2015-03-19', 'dateenrolled accessor returns correct value' );
is( $patron->dateexpiry, '2016-03-19', 'dateexpiry accessor returns correct value' );
is( $patron->gonenoaddress, '0', 'gonenoaddress accessor returns correct value' );
is( $patron->lost, '0', 'lost accessor returns correct value' );
is( $patron->debarred, '2015-04-19', 'debarred accessor returns correct value' );
is( $patron->debarredcomment, 'You are debarred', 'debarredcomment accessor returns correct value' );
is( $patron->borrowernotes, 'borrowernotes', 'borrowernotes accessor returns correct value' );
is( $patron->sex, 'M', 'sex accessor returns correct value' );
is( $patron->password, 'hfkurhfe976634èj!', 'password accessor returns correct value' );
is( $patron->flags, '55555', 'flags accessor returns correct value' );
is( $patron->userid, '87987', 'userid accessor returns correct value' );
is( $patron->opacnote, 'myOpacnote', 'opacnote accessor returns correct value' );
is( $patron->contactnote, 'myContactnote', 'contactnote accessor returns correct value' );
is( $patron->sort1, 'mySort1', 'sort1 accessor returns correct value' );
is( $patron->sort2, 'mySort2', 'sort2 accessor returns correct value' );
is(
$patron->altcontactfirstname, 'myAltcontactfirstname',
'altcontactfirstname accessor returns correct value'
);
is( $patron->altcontactsurname, 'myAltcontactsurname', 'altcontactsurname accessor returns correct value' );
is( $patron->altcontactaddress1, 'myAltcontactaddress1', 'altcontactaddress1 accessor returns correct value' );
is( $patron->altcontactaddress2, 'myAltcontactaddress2', 'altcontactaddress2 accessor returns correct value' );
is( $patron->altcontactaddress3, 'myAltcontactaddress3', 'altcontactaddress3 accessor returns correct value' );
is( $patron->altcontactstate, 'myAltcontactstate', 'altcontactstate accessor returns correct value' );
is( $patron->altcontactzipcode, '465843', 'altcontactzipcode accessor returns correct value' );
is( $patron->altcontactcountry, 'myOtherCountry', 'altcontactcountry accessor returns correct value' );
is( $patron->altcontactphone, 'myOtherphone', 'altcontactphone accessor returns correct value' );
is( $patron->smsalertnumber, '0683027346', 'smsalertnumber accessor returns correct value' );
is( $patron->privacy, '667788', 'privacy accessor returns correct value' );
};
subtest 'Accessor tests after set' => sub {
plan tests => 60;
$patron->set(
{
borrowernumber => '12346',
cardnumber => '1234567891',
surname => 'SmySurname',
firstname => 'SmyFirstname',
title => 'Mme.',
othernames => 'SmyOthernames',
initials => 'SS',
streetnumber => '200',
streettype => 'Rue',
address => 'Smy personal address',
address2 => 'Smy adress2',
city => 'Lyon',
state => 'Smystate',
zipcode => '69000',
country => 'France',
email => 'SmySurname.myFirstname@email.com',
phone => '0402872935',
mobile => '0627884633',
fax => '0402872936',
emailpro => 'SmyEmailPro@email.com',
phonepro => '0402873335',
B_streetnumber => '102',
B_streettype => 'SmyB_streettype',
B_address => 'SmyB_address',
B_address2 => 'SmyB_address2',
B_city => 'SmyB_city',
B_state => 'SmyB_state',
B_zipcode => '12333',
B_country => 'SmyB_country',
B_email => 'SmyB_email',
B_phone => '0678353936',
dateofbirth => '1991-07-16',
branchcode => 'SmyBranCode',
categorycode => 'SmyCatCode',
dateenrolled => '2014-03-19',
dateexpiry => '2017-03-19',
gonenoaddress => '1',
lost => '1',
debarred => '2016-04-19',
debarredcomment => 'You are still debarred',
borrowernotes => 'Sborrowernotes',
sex => 'F',
password => 'zerzerzer#',
flags => '666666',
userid => '98233',
opacnote => 'SmyOpacnote',
contactnote => 'SmyContactnote',
sort1 => 'SmySort1',
sort2 => 'SmySort2',
altcontactfirstname => 'SmyAltcontactfirstname',
altcontactsurname => 'SmyAltcontactsurname',
altcontactaddress1 => 'SmyAltcontactaddress1',
altcontactaddress2 => 'SmyAltcontactaddress2',
altcontactaddress3 => 'SmyAltcontactaddress3',
altcontactstate => 'SmyAltcontactstate',
altcontactzipcode => '565843',
altcontactcountry => 'SmyOtherCountry',
altcontactphone => 'SmyOtherphone',
smsalertnumber => '0683027347',
privacy => '667789'
}
);
is( $patron->borrowernumber, '12346', 'borrowernumber field set ok' );
is( $patron->cardnumber, '1234567891', 'cardnumber field set ok' );
is( $patron->surname, 'SmySurname', 'surname field set ok' );
is( $patron->firstname, 'SmyFirstname', 'firstname field set ok' );
is( $patron->title, 'Mme.', 'title field set ok' );
is( $patron->othernames, 'SmyOthernames', 'othernames field set ok' );
is( $patron->initials, 'SS', 'initials field set ok' );
is( $patron->streetnumber, '200', 'streetnumber field set ok' );
is( $patron->streettype, 'Rue', 'streettype field set ok' );
is( $patron->address, 'Smy personal address', 'address field set ok' );
is( $patron->address2, 'Smy adress2', 'address2 field set ok' );
is( $patron->city, 'Lyon', 'city field set ok' );
is( $patron->state, 'Smystate', 'state field set ok' );
is( $patron->zipcode, '69000', 'zipcode field set ok' );
is( $patron->country, 'France', 'country field set ok' );
is( $patron->email, 'SmySurname.myFirstname@email.com', 'email field set ok' );
is( $patron->phone, '0402872935', 'phone field set ok' );
is( $patron->mobile, '0627884633', 'mobile field set ok' );
is( $patron->fax, '0402872936', 'fax field set ok' );
is( $patron->emailpro, 'SmyEmailPro@email.com', 'emailpro field set ok' );
is( $patron->phonepro, '0402873335', 'phonepro field set ok' );
is( $patron->B_streetnumber, '102', 'B_streetnumber field set ok' );
is( $patron->B_streettype, 'SmyB_streettype', 'B_streettype field set ok' );
is( $patron->B_address, 'SmyB_address', 'B_address field set ok' );
is( $patron->B_address2, 'SmyB_address2', 'B_address2 field set ok' );
is( $patron->B_city, 'SmyB_city', 'B_city field set ok' );
is( $patron->B_state, 'SmyB_state', 'B_state field set ok' );
is( $patron->B_zipcode, '12333', 'B_zipcode field set ok' );
is( $patron->B_country, 'SmyB_country', 'B_country field set ok' );
is( $patron->B_email, 'SmyB_email', 'B_email field set ok' );
is( $patron->B_phone, '0678353936', 'B_phone field set ok' );
is( $patron->dateofbirth, '1991-07-16', 'dateofbirth field set ok' );
is( $patron->branchcode, 'SmyBranCode', 'branchcode field set ok' );
is( $patron->categorycode, 'SmyCatCode', 'categorycode field set ok' );
is( $patron->dateenrolled, '2014-03-19', 'dateenrolled field set ok' );
is( $patron->dateexpiry, '2017-03-19', 'dateexpiry field set ok' );
is( $patron->gonenoaddress, '1', 'gonenoaddress field set ok' );
is( $patron->lost, '1', 'lost field set ok' );
is( $patron->debarred, '2016-04-19', 'debarred field set ok' );
is( $patron->debarredcomment, 'You are still debarred', 'debarredcomment field set ok' );
is( $patron->borrowernotes, 'Sborrowernotes', 'borrowernotes field set ok' );
is( $patron->sex, 'F', 'sex field set ok' );
is( $patron->password, 'zerzerzer#', 'password field set ok' );
is( $patron->flags, '666666', 'flags field set ok' );
is( $patron->userid, '98233', 'userid field set ok' );
is( $patron->opacnote, 'SmyOpacnote', 'opacnote field set ok' );
is( $patron->contactnote, 'SmyContactnote', 'contactnote field set ok' );
is( $patron->sort1, 'SmySort1', 'sort1 field set ok' );
is( $patron->sort2, 'SmySort2', 'sort2 field set ok' );
is( $patron->altcontactfirstname, 'SmyAltcontactfirstname', 'altcontactfirstname field set ok' );
is( $patron->altcontactsurname, 'SmyAltcontactsurname', 'altcontactsurname field set ok' );
is( $patron->altcontactaddress1, 'SmyAltcontactaddress1', 'altcontactaddress1 field set ok' );
is( $patron->altcontactaddress2, 'SmyAltcontactaddress2', 'altcontactaddress2 field set ok' );
is( $patron->altcontactaddress3, 'SmyAltcontactaddress3', 'altcontactaddress3 field set ok' );
is( $patron->altcontactstate, 'SmyAltcontactstate', 'altcontactstate field set ok' );
is( $patron->altcontactzipcode, '565843', 'altcontactzipcode field set ok' );
is( $patron->altcontactcountry, 'SmyOtherCountry', 'altcontactcountry field set ok' );
is( $patron->altcontactphone, 'SmyOtherphone', 'altcontactphone field set ok' );
is( $patron->smsalertnumber, '0683027347', 'smsalertnumber field set ok' );
is( $patron->privacy, '667789', 'privacy field set ok' );
};
};
subtest 'is_active' => sub {
plan tests => 12;
$schema->storage->txn_begin;
my $patron = $builder->build_object( { class => 'Koha::Patrons' } );
throws_ok { $patron->is_active } 'Koha::Exceptions::MissingParameter', 'Called without params';
# Check expiry
$patron->dateexpiry( dt_from_string->subtract( days => 1 ) )->lastseen(undef)->store;
is( $patron->is_active( { days => 1 } ), 0, 'Expired patron is not active' );
$patron->dateexpiry(undef)->store;
is( $patron->is_active( { days => 1 } ), 1, 'Expiry date removed' );
# Check anonymized
$patron->anonymized(1)->store;
is( $patron->is_active( { days => 1 } ), 0, 'Anonymized patron is not active' );
$patron->anonymized(0)->store;
# Change enrolled date now
$patron->dateenrolled('2020-01-01')->store;
is( $patron->is_active( { days => 1 } ), 0, 'No recent enrollment and lastseen still empty: not active' );
$patron->dateenrolled( dt_from_string() )->store;
is( $patron->is_active( { days => 1 } ), 1, 'Enrolled today: active' );
# Check lastseen, test days parameter
t::lib::Mocks::mock_preference( 'TrackLastPatronActivityTriggers', 'login' );
$patron->dateenrolled('2020-01-01')->store;
$patron->update_lastseen('login');
is( $patron->is_active( { days => 1 } ), 1, 'Just logged in' );
my $ago = dt_from_string->subtract( days => 2 );
$patron->lastseen($ago)->store;
is( $patron->is_active( { days => 1 } ), 0, 'Not active since yesterday' );
is( $patron->is_active( { days => 3 } ), 1, 'Active within last 3 days' );
# test since parameter
my $dt = $ago->clone->add( hours => 1 );
is( $patron->is_active( { since => $dt } ), 0, 'Inactive since ago + 1 hour' );
$dt = $ago->clone->subtract( hours => 1 );
is( $patron->is_active( { since => $dt } ), 1, 'Active since ago - 1 hour' );
# test weeks parameter
is( $patron->is_active( { weeks => 1 } ), 1, 'Active within last week' );
$schema->storage->txn_rollback;
};
subtest 'add_guarantor() tests' => sub {
plan tests => 7;
$schema->storage->txn_begin;
t::lib::Mocks::mock_preference( 'borrowerRelationship', 'father1|father2' );
my $patron_1 = $builder->build_object( { class => 'Koha::Patrons' } );
my $patron_2 = $builder->build_object( { class => 'Koha::Patrons' } );
throws_ok { $patron_1->add_guarantor( { guarantor_id => $patron_2->borrowernumber } ); }
'Koha::Exceptions::Patron::Relationship::InvalidRelationship',
'Exception is thrown as no relationship passed';
is( $patron_1->guarantee_relationships->count, 0, 'No guarantors added' );
throws_ok { $patron_1->add_guarantor( { guarantor_id => $patron_2->borrowernumber, relationship => 'father' } ); }
'Koha::Exceptions::Patron::Relationship::InvalidRelationship',
'Exception is thrown as a wrong relationship was passed';
is( $patron_1->guarantee_relationships->count, 0, 'No guarantors added' );
$patron_1->add_guarantor( { guarantor_id => $patron_2->borrowernumber, relationship => 'father1' } );
my $guarantors = $patron_1->guarantor_relationships;
is( $guarantors->count, 1, 'No guarantors added' );
warning_like(
sub {
throws_ok {
$patron_1->add_guarantor( { guarantor_id => $patron_2->borrowernumber, relationship => 'father2' } );
}
'Koha::Exceptions::Patron::Relationship::DuplicateRelationship',
'Exception is thrown for duplicated relationship';
},
qr{Duplicate entry.* for key '(borrower_relationships\.)?guarantor_guarantee_idx'}
);
$schema->storage->txn_rollback;
};
subtest 'guarantor checks on patron creation / update tests' => sub {
plan tests => 2;
$schema->storage->txn_begin;
t::lib::Mocks::mock_preference( 'borrowerRelationship', 'guarantor' );
my $category = $builder->build_object(
{ class => 'Koha::Patron::Categories', value => { can_be_guarantee => 1, category_type => 'A' } } );
my $guarantor =
$builder->build_object( { class => 'Koha::Patrons', value => { categorycode => $category->categorycode } } );
my $guarantee =
$builder->build_object( { class => 'Koha::Patrons', value => { categorycode => $category->categorycode } } );
subtest 'patron update tests' => sub {
plan tests => 7;
ok(
$guarantee->add_guarantor( { guarantor_id => $guarantor->borrowernumber, relationship => 'guarantor' } ),
"Relationship is added, no problem"
);
is( $guarantor->is_guarantor, 1, 'Is a guarantor' );
is( $guarantor->is_guarantee, 0, 'Is no guarantee' );
is( $guarantee->is_guarantor, 0, 'Is no guarantor' );
is( $guarantee->is_guarantee, 1, 'Is a guarantee' );
ok( $guarantor->surname("Duck")->store(), "Updating guarantor is okay" );
ok( $guarantee->surname("Duck")->store(), "Updating guarantee is okay" );
};
subtest 'patron creation tests' => sub {
plan tests => 1;
my $new_guarantee = $builder->build_object(
{ class => 'Koha::Patrons', value => { categorycode => $category->categorycode } } );
my $new_guarantee_hash = $new_guarantee->unblessed;
$new_guarantee->delete();
delete $new_guarantee_hash->{borrowernumber};
ok(
Koha::Patron->new($new_guarantee_hash)->store( { guarantors => [$guarantor] } ),
"We can add the new patron and indicate guarantor"
);
};
$schema->storage->txn_rollback;
};
subtest 'relationships_debt() tests' => sub {
plan tests => 168;
$schema->storage->txn_begin;
t::lib::Mocks::mock_preference( 'borrowerRelationship', 'parent' );
my $parent_1 = $builder->build_object( { class => 'Koha::Patrons', value => { firstname => "Parent 1" } } );
my $parent_2 = $builder->build_object( { class => 'Koha::Patrons', value => { firstname => "Parent 2" } } );
my $child_1 = $builder->build_object( { class => 'Koha::Patrons', value => { firstname => " Child 1" } } );
my $child_2 = $builder->build_object( { class => 'Koha::Patrons', value => { firstname => " Child 2" } } );
$child_1->add_guarantor( { guarantor_id => $parent_1->borrowernumber, relationship => 'parent' } );
$child_1->add_guarantor( { guarantor_id => $parent_2->borrowernumber, relationship => 'parent' } );
$child_2->add_guarantor( { guarantor_id => $parent_1->borrowernumber, relationship => 'parent' } );
$child_2->add_guarantor( { guarantor_id => $parent_2->borrowernumber, relationship => 'parent' } );
is( $child_1->guarantor_relationships->guarantors->count, 2, 'Child 1 has correct number of guarantors' );
is( $child_2->guarantor_relationships->guarantors->count, 2, 'Child 2 has correct number of guarantors' );
is( $parent_1->guarantee_relationships->guarantees->count, 2, 'Parent 1 has correct number of guarantees' );
is( $parent_2->guarantee_relationships->guarantees->count, 2, 'Parent 2 has correct number of guarantees' );
my $patrons = [ $parent_1, $parent_2, $child_1, $child_2 ];
# First test: No debt
my ( $parent1_debt, $parent2_debt, $child1_debt, $child2_debt ) = ( 0, 0, 0, 0 );
_test_combinations( $patrons, $parent1_debt, $parent2_debt, $child1_debt, $child2_debt );
# Add debt to child_2
$child2_debt = 2;
$child_2->account->add_debit( { type => 'ACCOUNT', amount => $child2_debt, interface => 'commandline' } );
is( $child_2->account->non_issues_charges, $child2_debt, 'Debt added to Child 2' );
_test_combinations( $patrons, $parent1_debt, $parent2_debt, $child1_debt, $child2_debt );
$parent1_debt = 3;
$parent_1->account->add_debit( { type => 'ACCOUNT', amount => $parent1_debt, interface => 'commandline' } );
is( $parent_1->account->non_issues_charges, $parent1_debt, 'Debt added to Parent 1' );
_test_combinations( $patrons, $parent1_debt, $parent2_debt, $child1_debt, $child2_debt );
$parent2_debt = 5;
$parent_2->account->add_debit( { type => 'ACCOUNT', amount => $parent2_debt, interface => 'commandline' } );
is( $parent_2->account->non_issues_charges, $parent2_debt, 'Parent 2 owes correct amount' );
_test_combinations( $patrons, $parent1_debt, $parent2_debt, $child1_debt, $child2_debt );
$child1_debt = 7;
$child_1->account->add_debit( { type => 'ACCOUNT', amount => $child1_debt, interface => 'commandline' } );
is( $child_1->account->non_issues_charges, $child1_debt, 'Child 1 owes correct amount' );
_test_combinations( $patrons, $parent1_debt, $parent2_debt, $child1_debt, $child2_debt );
$schema->storage->txn_rollback;
};
sub _test_combinations {
my ( $patrons, $parent1_debt, $parent2_debt, $child1_debt, $child2_debt ) = @_;
note(
"Testing with parent 1 debt $parent1_debt | Parent 2 debt $parent2_debt | Child 1 debt $child1_debt | Child 2 debt $child2_debt"
);
# Options
# P1 => P1 + C1 + C2 ( - P1 ) ( + P2 )
# P2 => P2 + C1 + C2 ( - P2 ) ( + P1 )
# C1 => P1 + P2 + C1 + C2 ( - C1 )
# C2 => P1 + P2 + C1 + C2 ( - C2 )
# 3 params, count from 0 to 7 in binary ( 3 places ) to get the set of switches, then do that 4 times, one for each parent and child
for my $i ( 0 .. 7 ) {
my ( $only_this_guarantor, $include_guarantors, $include_this_patron ) = split '', sprintf( "%03b", $i );
note("---------------------");
for my $patron (@$patrons) {
if ( $only_this_guarantor
&& !$patron->guarantee_relationships->count )
{
throws_ok {
$patron->relationships_debt(
{
only_this_guarantor => $only_this_guarantor,
include_guarantors => $include_guarantors,
include_this_patron => $include_this_patron
}
);
}
'Koha::Exceptions::BadParameter',
'Exception is thrown as patron is not a guarantor';
} else {
my $debt = 0;
if ( $patron->firstname eq 'Parent 1' ) {
$debt += $parent1_debt if ( $include_this_patron && $include_guarantors );
$debt += $child1_debt + $child2_debt;
$debt += $parent2_debt unless ( $only_this_guarantor || !$include_guarantors );
} elsif ( $patron->firstname eq 'Parent 2' ) {
$debt += $parent2_debt if ( $include_this_patron & $include_guarantors );
$debt += $child1_debt + $child2_debt;
$debt += $parent1_debt unless ( $only_this_guarantor || !$include_guarantors );
} elsif ( $patron->firstname eq ' Child 1' ) {
$debt += $child1_debt if ($include_this_patron);
$debt += $child2_debt;
$debt += $parent1_debt + $parent2_debt if ($include_guarantors);
} else {
$debt += $child2_debt if ($include_this_patron);
$debt += $child1_debt;
$debt += $parent1_debt + $parent2_debt if ($include_guarantors);
}
is(
$patron->relationships_debt(
{
only_this_guarantor => $only_this_guarantor,
include_guarantors => $include_guarantors,
include_this_patron => $include_this_patron
}
),
$debt,
$patron->firstname
. " debt of "
. sprintf( '%02d', $debt )
. " calculated correctly for ( only_this_guarantor: $only_this_guarantor, include_guarantors: $include_guarantors, include_this_patron: $include_this_patron)"
);
}
}
}
}
subtest 'add_enrolment_fee_if_needed() tests' => sub {
plan tests => 2;
subtest 'category has enrolment fee' => sub {
plan tests => 7;
$schema->storage->txn_begin;
my $category = $builder->build_object(
{
class => 'Koha::Patron::Categories',
value => { enrolmentfee => 20 }
}
);
my $patron = $builder->build_object(
{
class => 'Koha::Patrons',
value => { categorycode => $category->categorycode }
}
);
my $enrollment_fee = $patron->add_enrolment_fee_if_needed();
is( $enrollment_fee * 1, 20, 'Enrolment fee amount is correct' );
my $account = $patron->account;
is( $patron->account->balance * 1, 20, 'Patron charged the enrolment fee' );
# second enrolment fee, new
$enrollment_fee = $patron->add_enrolment_fee_if_needed(0);
# third enrolment fee, renewal
$enrollment_fee = $patron->add_enrolment_fee_if_needed(1);
is( $patron->account->balance * 1, 60, 'Patron charged the enrolment fees' );
my @debits = $account->outstanding_debits->as_list;
is( scalar @debits, 3, '3 enrolment fees' );
is( $debits[0]->debit_type_code, 'ACCOUNT', 'Account type set correctly' );
is( $debits[1]->debit_type_code, 'ACCOUNT', 'Account type set correctly' );
is( $debits[2]->debit_type_code, 'ACCOUNT_RENEW', 'Account type set correctly' );
$schema->storage->txn_rollback;
};
subtest 'no enrolment fee' => sub {
plan tests => 3;
$schema->storage->txn_begin;
my $category = $builder->build_object(
{
class => 'Koha::Patron::Categories',
value => { enrolmentfee => 0 }
}
);
my $patron = $builder->build_object(
{
class => 'Koha::Patrons',
value => { categorycode => $category->categorycode }
}
);
my $enrollment_fee = $patron->add_enrolment_fee_if_needed();
is( $enrollment_fee * 1, 0, 'No enrolment fee' );
my $account = $patron->account;
is( $patron->account->balance, 0, 'Patron not charged anything' );
my @debits = $account->outstanding_debits->as_list;
is( scalar @debits, 0, 'no debits' );
$schema->storage->txn_rollback;
};
};
subtest 'messaging_preferences() tests' => sub {
plan tests => 5;
$schema->storage->txn_begin;
my $mtt = $builder->build_object( { class => 'Koha::Patron::MessagePreference::Transport::Types' } );
my $attribute = $builder->build_object( { class => 'Koha::Patron::MessagePreference::Attributes' } );
my $branchcode = $builder->build( { source => 'Branch' } )->{branchcode};
my $letter = $builder->build_object(
{
class => 'Koha::Notice::Templates',
value => {
branchcode => '',
is_html => 0,
message_transport_type => $mtt->message_transport_type
}
}
);
Koha::Patron::MessagePreference::Transport->new(
{
message_attribute_id => $attribute->message_attribute_id,
message_transport_type => $mtt->message_transport_type,
is_digest => 0,
letter_module => $letter->module,
letter_code => $letter->code,
}
)->store;
my $patron = $builder->build_object( { class => 'Koha::Patrons' } );
my $preference = Koha::Patron::MessagePreference->new(
{
borrowernumber => $patron->borrowernumber,
message_attribute_id => $attribute->message_attribute_id,
wants_digest => 0,
days_in_advance => undef,
}
)->store;
my $messaging_preferences = $patron->messaging_preferences();
is( $messaging_preferences->count, 1, 'Found one preference' );
my $messaging_preference = $messaging_preferences->next;
is( $messaging_preference->borrowernumber, $patron->borrowernumber );
is( $messaging_preference->message_attribute_id, $attribute->message_attribute_id );
is( $messaging_preference->wants_digest, 0 );
is( $messaging_preference->days_in_advance, undef );
$schema->storage->txn_rollback;
};
subtest 'to_api() tests' => sub {
plan tests => 7;
$schema->storage->txn_begin;
my $patron_class = Test::MockModule->new('Koha::Patron');
$patron_class->mock(
'algo',
sub { return 'algo' }
);
my $patron = $builder->build_object(
{
class => 'Koha::Patrons',
value => { debarred => undef }
}
);
my $consumer = $builder->build_object(
{
class => 'Koha::Patrons',
}
);
t::lib::Mocks::mock_userenv( { patron => $consumer } );
my $restricted = $patron->to_api( { user => $consumer } )->{restricted};
ok( defined $restricted, 'restricted is defined' );
ok( !$restricted, 'debarred is undef, restricted evaluates to false' );
$patron->debarred( dt_from_string->add( days => 1 ) )->store->discard_changes;
$restricted = $patron->to_api( { user => $consumer } )->{restricted};
ok( defined $restricted, 'restricted is defined' );
ok( $restricted, 'debarred is defined, restricted evaluates to true' );
my $patron_json = $patron->to_api( { embed => { algo => {} }, user => $consumer } );
ok( exists $patron_json->{algo} );
is( $patron_json->{algo}, 'algo' );
my $patron_eligible = $patron->to_api( { user => $consumer } );
ok( exists $patron_eligible->{self_renewal_available} );
$schema->storage->txn_rollback;
};
subtest 'login_attempts tests' => sub {
plan tests => 1;
$schema->storage->txn_begin;
my $patron = $builder->build_object(
{
class => 'Koha::Patrons',
}
);
my $patron_info = $patron->unblessed;
$patron->delete;
delete $patron_info->{login_attempts};
my $new_patron = Koha::Patron->new($patron_info)->store;
is( $new_patron->discard_changes->login_attempts, 0, "login_attempts defaults to 0 as expected" );
$schema->storage->txn_rollback;
};
subtest 'is_superlibrarian() tests' => sub {
plan tests => 3;
$schema->storage->txn_begin;
my $patron = $builder->build_object(
{
class => 'Koha::Patrons',
value => { flags => 16 }
}
);
is( $patron->is_superlibrarian, 0, 'Patron is not a superlibrarian and the method returns the correct value' );
$patron->flags(1)->store->discard_changes;
is( $patron->is_superlibrarian, 1, 'Patron is a superlibrarian and the method returns the correct value' );
$patron->flags(0)->store->discard_changes;
is( $patron->is_superlibrarian, 0, 'Patron is not a superlibrarian and the method returns the correct value' );
$schema->storage->txn_rollback;
};
subtest 'permissions() tests' => sub {
plan tests => 12;
$schema->storage->txn_begin;
my $dbh = C4::Context->dbh;
# Test patron with single flag permission (catalogue = bit 2, value 4)
my $patron = $builder->build_object(
{
class => 'Koha::Patrons',
value => { flags => 4 }
}
);
my $permissions = $patron->permissions;
is( ref($permissions), 'HASH', "permissions() returns a hashref" );
ok( scalar keys %$permissions > 0, "permissions() returns all flags, not just granted ones" );
is( $permissions->{catalogue}, 1, "Patron has catalogue permission" );
is( $permissions->{superlibrarian}, 0, "Patron does not have superlibrarian (demonstrates all flags present)" );
# Test patron with no permissions
my $patron_no_perms = $builder->build_object(
{
class => 'Koha::Patrons',
value => { flags => 0 }
}
);
my $no_perms = $patron_no_perms->permissions;
ok( scalar keys %$no_perms > 0, "Patron with no flags still has hashref with all flags" );
is( $no_perms->{catalogue}, 0, "Patron does not have catalogue permission" );
is( $no_perms->{superlibrarian}, 0, "Patron does not have superlibrarian permission" );
# Test patron with multiple flags (catalogue=4 + circulate=2 = 6)
my $patron_multi = $builder->build_object(
{
class => 'Koha::Patrons',
value => { flags => 6 }
}
);
my $multi_perms = $patron_multi->permissions;
is( $multi_perms->{catalogue}, 1, "Multi-flag patron has catalogue permission" );
is( $multi_perms->{circulate}, 1, "Multi-flag patron has circulate permission" );
is( $multi_perms->{superlibrarian}, 0, "Multi-flag patron does not have superlibrarian" );
# Test patron with granular subpermissions
my $patron_subperm = $builder->build_object( { class => 'Koha::Patrons', value => { flags => 0 } } );
$dbh->do(
"INSERT INTO user_permissions (borrowernumber, module_bit, code) VALUES (?, ?, ?)",
undef, $patron_subperm->borrowernumber, 1, 'override_renewals'
);
my $subperms = $patron_subperm->get_from_storage->permissions;
is( ref( $subperms->{circulate} ), 'HASH', "Granular permissions stored as hashref" );
is( $subperms->{circulate}->{override_renewals}, 1, "Subpermission correctly detected" );
$schema->storage->txn_rollback;
};
subtest 'extended_attributes' => sub {
plan tests => 16;
my $schema = Koha::Database->new->schema;
$schema->storage->txn_begin;
Koha::Patron::Attribute::Types->search->delete;
my $patron_1 = $builder->build_object( { class => 'Koha::Patrons' } );
my $patron_2 = $builder->build_object( { class => 'Koha::Patrons' } );
t::lib::Mocks::mock_userenv( { patron => $patron_1 } );
my $attribute_type1 = Koha::Patron::Attribute::Type->new(
{
code => 'my code1',
description => 'my description1',
unique_id => 1
}
)->store;
my $attribute_type2 = Koha::Patron::Attribute::Type->new(
{
code => 'my code2',
description => 'my description2',
opac_display => 1,
staff_searchable => 1
}
)->store;
my $new_library = $builder->build( { source => 'Branch' } );
my $attribute_type_limited =
Koha::Patron::Attribute::Type->new( { code => 'my code3', description => 'my description3' } )->store;
$attribute_type_limited->library_limits( [ $new_library->{branchcode} ] );
my $attributes_for_1 = [
{
attribute => 'my attribute1',
code => $attribute_type1->code(),
},
{
attribute => 'my attribute2',
code => $attribute_type2->code(),
},
{
attribute => 'my attribute limited',
code => $attribute_type_limited->code(),
}
];
my $attributes_for_2 = [
{
attribute => 'my attribute12',
code => $attribute_type1->code(),
},
{
attribute => 'my attribute limited 2',
code => $attribute_type_limited->code(),
}
];
my $extended_attributes = $patron_1->extended_attributes;
is(
ref($extended_attributes), 'Koha::Patron::Attributes',
'Koha::Patron->extended_attributes must return a Koha::Patron::Attribute set'
);
is( $extended_attributes->count, 0, 'There should not be attribute yet' );
$patron_1->extended_attributes->filter_by_branch_limitations->delete;
$patron_2->extended_attributes->filter_by_branch_limitations->delete;
$patron_1->extended_attributes($attributes_for_1);
$patron_2->extended_attributes($attributes_for_2);
my $extended_attributes_for_1 = $patron_1->extended_attributes;
is( $extended_attributes_for_1->count, 3, 'There should be 3 attributes now for patron 1' );
my $extended_attributes_for_2 = $patron_2->extended_attributes;
is( $extended_attributes_for_2->count, 2, 'There should be 2 attributes now for patron 2' );
my $attribute_12 = $extended_attributes_for_2->search( { code => $attribute_type1->code } )->next;
is( $attribute_12->attribute, 'my attribute12', 'search by code should return the correct attribute' );
$attribute_12 = $patron_2->get_extended_attribute( $attribute_type1->code );
is(
$attribute_12->attribute, 'my attribute12',
'Koha::Patron->get_extended_attribute should return the correct attribute value'
);
my $expected_attributes_for_2 = [
{
code => $attribute_type1->code(),
attribute => 'my attribute12',
},
{
code => $attribute_type_limited->code(),
attribute => 'my attribute limited 2',
}
];
# Sorting them by code
$expected_attributes_for_2 = [ sort { $a->{code} cmp $b->{code} } @$expected_attributes_for_2 ];
my @extended_attributes_for_2 = $extended_attributes_for_2->as_list;
is_deeply(
[
{
code => $extended_attributes_for_2[0]->code,
attribute => $extended_attributes_for_2[0]->attribute
},
{
code => $extended_attributes_for_2[1]->code,
attribute => $extended_attributes_for_2[1]->attribute
}
],
$expected_attributes_for_2
);
# TODO - What about multiple? POD explains the problem
my $non_existent = $patron_2->get_extended_attribute('not_exist');
is(
$non_existent, undef,
'Koha::Patron->get_extended_attribute must return undef if the attribute does not exist'
);
# Test branch limitations
t::lib::Mocks::mock_userenv( { patron => $patron_2 } );
# Return all
$extended_attributes_for_1 = $patron_1->extended_attributes;
is(
$extended_attributes_for_1->count, 3,
'There should be 2 attributes for patron 1, the limited one should be returned'
);
# Return filtered
$extended_attributes_for_1 = $patron_1->extended_attributes->filter_by_branch_limitations;
is(
$extended_attributes_for_1->count, 2,
'There should be 2 attributes for patron 1, the limited one should be returned'
);
# Not filtered
my $limited_value = $patron_1->get_extended_attribute( $attribute_type_limited->code );
is( $limited_value->attribute, 'my attribute limited', );
## Do we need a filtered?
#$limited_value = $patron_1->get_extended_attribute( $attribute_type_limited->code );
#is( $limited_value, undef, );
$schema->storage->txn_rollback;
subtest 'non-repeatable attributes tests' => sub {
plan tests => 3;
$schema->storage->txn_begin;
Koha::Patron::Attribute::Types->search->delete;
my $patron = $builder->build_object( { class => 'Koha::Patrons' } );
my $attribute_type = $builder->build_object(
{
class => 'Koha::Patron::Attribute::Types',
value => { repeatable => 0 }
}
);
is( $patron->extended_attributes->count, 0, 'Patron has no extended attributes' );
throws_ok {
$patron->extended_attributes(
[
{ code => $attribute_type->code, attribute => 'a' },
{ code => $attribute_type->code, attribute => 'b' }
]
);
}
'Koha::Exceptions::Patron::Attribute::NonRepeatable',
'Exception thrown on non-repeatable attribute';
is( $patron->extended_attributes->count, 0, 'Extended attributes storing rolled back' );
$schema->storage->txn_rollback;
};
subtest 'unique attributes tests' => sub {
plan tests => 5;
$schema->storage->txn_begin;
Koha::Patron::Attribute::Types->search->delete;
my $patron_1 = $builder->build_object( { class => 'Koha::Patrons' } );
my $patron_2 = $builder->build_object( { class => 'Koha::Patrons' } );
my $attribute_type_1 = $builder->build_object(
{
class => 'Koha::Patron::Attribute::Types',
value => { unique_id => 1 }
}
);
my $attribute_type_2 = $builder->build_object(
{
class => 'Koha::Patron::Attribute::Types',
value => { unique_id => 0 }
}
);
is( $patron_1->extended_attributes->count, 0, 'patron_1 has no extended attributes' );
is( $patron_2->extended_attributes->count, 0, 'patron_2 has no extended attributes' );
$patron_1->extended_attributes(
[
{ code => $attribute_type_1->code, attribute => 'a' },
{ code => $attribute_type_2->code, attribute => 'a' }
]
);
throws_ok {
$patron_2->extended_attributes(
[
{ code => $attribute_type_1->code, attribute => 'a' },
{ code => $attribute_type_2->code, attribute => 'a' }
]
);
}
'Koha::Exceptions::Patron::Attribute::UniqueIDConstraint',
'Exception thrown on unique attribute';
is( $patron_1->extended_attributes->count, 2, 'Extended attributes stored' );
is( $patron_2->extended_attributes->count, 0, 'Extended attributes storing rolled back' );
$schema->storage->txn_rollback;
};
subtest 'invalid type attributes tests' => sub {
plan tests => 3;
$schema->storage->txn_begin;
Koha::Patron::Attribute::Types->search->delete;
my $patron = $builder->build_object( { class => 'Koha::Patrons' } );
my $attribute_type_1 = $builder->build_object(
{
class => 'Koha::Patron::Attribute::Types',
value => { repeatable => 0 }
}
);
my $attribute_type_2 = $builder->build_object( { class => 'Koha::Patron::Attribute::Types' } );
my $type_2 = $attribute_type_2->code;
$attribute_type_2->delete;
is( $patron->extended_attributes->count, 0, 'Patron has no extended attributes' );
throws_ok {
$patron->extended_attributes(
[
{ code => $attribute_type_1->code, attribute => 'a' },
{ code => $attribute_type_2->code, attribute => 'b' }
]
);
}
'Koha::Exceptions::Patron::Attribute::InvalidType',
'Exception thrown on invalid attribute type';
is( $patron->extended_attributes->count, 0, 'Extended attributes storing rolled back' );
$schema->storage->txn_rollback;
};
subtest 'globally mandatory attributes tests' => sub {
plan tests => 8;
$schema->storage->txn_begin;
Koha::Patron::Attribute::Types->search->delete;
my $context = Test::MockModule->new('C4::Context');
my $patron = $builder->build_object( { class => 'Koha::Patrons' } );
my $attribute_type_1 = $builder->build_object(
{
class => 'Koha::Patron::Attribute::Types',
value => { mandatory => 1, class => 'a', category_code => undef }
}
);
my $attribute_type_2 = $builder->build_object(
{
class => 'Koha::Patron::Attribute::Types',
value => { mandatory => 0, class => 'a', category_code => undef }
}
);
my $attribute_type_3 = $builder->build_object(
{
class => 'Koha::Patron::Attribute::Types',
value => { mandatory => 1, class => 'a', category_code => undef, opac_editable => 1 }
}
);
my $attribute_type_4 = $builder->build_object(
{
class => 'Koha::Patron::Attribute::Types',
value => { mandatory => 0, class => 'a', category_code => undef, opac_editable => 1 }
}
);
#Staff interface tests
$context->mock( 'interface', sub { return "intranet" } );
is( $patron->extended_attributes->count, 0, 'Patron has no extended attributes' );
throws_ok {
$patron->extended_attributes(
[
{ code => $attribute_type_2->code, attribute => 'b' },
{ code => $attribute_type_3->code, attribute => 'b' },
]
);
}
'Koha::Exceptions::Patron::MissingMandatoryExtendedAttribute',
'Exception thrown on missing mandatory attribute type';
is( $@->type, $attribute_type_1->code, 'Exception parameters are correct' );
is( $patron->extended_attributes->count, 0, 'Extended attributes storing rolled back' );
$patron->extended_attributes(
[
{ code => $attribute_type_1->code, attribute => 'b' },
{ code => $attribute_type_3->code, attribute => 'b' },
]
);
is( $patron->extended_attributes->count, 2, 'Extended attributes succeeded' );
# OPAC interface tests
$context->mock( 'interface', sub { return "opac" } );
is( $patron->extended_attributes->count, 2, 'Patron still has 2 extended attributes in OPAC' );
throws_ok {
$patron->extended_attributes(
[
{ code => $attribute_type_1->code, attribute => 'b' },
{ code => $attribute_type_2->code, attribute => 'b' },
]
);
}
'Koha::Exceptions::Patron::MissingMandatoryExtendedAttribute',
'Exception thrown on missing mandatory OPAC-editable attribute';
is( $@->type, $attribute_type_3->code, 'Exception parameters are correct for OPAC-editable attribute' );
$schema->storage->txn_rollback;
};
subtest 'limited category mandatory attributes tests' => sub {
plan tests => 2;
$schema->storage->txn_begin;
Koha::Patron::Attribute::Types->search->delete;
my $patron = $builder->build_object( { class => 'Koha::Patrons' } );
my $attribute_type_1 = $builder->build_object(
{
class => 'Koha::Patron::Attribute::Types',
value => { mandatory => 1, class => 'a', category_code => $patron->categorycode }
}
);
$patron->extended_attributes( [ { code => $attribute_type_1->code, attribute => 'a' } ] );
is( $patron->extended_attributes->count, 1, 'Extended attributes succeeded' );
$patron = $builder->build_object( { class => 'Koha::Patrons' } );
# new patron, new category - they shouldn't be required to have any attributes
ok(
$patron->extended_attributes( [] ),
"We can set no attributes, mandatory attribute for other category not required"
);
};
};
subtest 'can_log_into() tests' => sub {
plan tests => 5;
$schema->storage->txn_begin;
my $patron = $builder->build_object(
{
class => 'Koha::Patrons',
value => { flags => undef }
}
);
my $library = $builder->build_object( { class => 'Koha::Libraries' } );
t::lib::Mocks::mock_preference( 'IndependentBranches', 1 );
ok( $patron->can_log_into( $patron->library ), 'Patron can log into its own library' );
ok( !$patron->can_log_into($library), 'Patron cannot log into different library, IndependentBranches on' );
# make it a superlibrarian
$patron->set( { flags => 1 } )->store->discard_changes;
ok( $patron->can_log_into($library), 'Superlibrarian can log into different library, IndependentBranches on' );
t::lib::Mocks::mock_preference( 'IndependentBranches', 0 );
# No special permissions
$patron->set( { flags => undef } )->store->discard_changes;
ok( $patron->can_log_into( $patron->library ), 'Patron can log into its own library' );
ok( $patron->can_log_into($library), 'Patron can log into any library' );
$schema->storage->txn_rollback;
};
subtest 'can_request_article() tests' => sub {
plan tests => 4;
$schema->storage->txn_begin;
t::lib::Mocks::mock_preference( 'ArticleRequests', 1 );
my $item = $builder->build_sample_item;
my $library_1 = $builder->build_object( { class => 'Koha::Libraries' } );
my $library_2 = $builder->build_object( { class => 'Koha::Libraries' } );
my $patron = $builder->build_object( { class => 'Koha::Patrons' } );
t::lib::Mocks::mock_userenv( { branchcode => $library_2->id } );
Koha::CirculationRules->set_rule(
{
categorycode => undef,
branchcode => $library_1->id,
rule_name => 'open_article_requests_limit',
rule_value => 4,
}
);
$builder->build_object(
{
class => 'Koha::ArticleRequests',
value => { status => 'REQUESTED', borrowernumber => $patron->id }
}
);
$builder->build_object(
{
class => 'Koha::ArticleRequests',
value => { status => 'PENDING', borrowernumber => $patron->id }
}
);
$builder->build_object(
{
class => 'Koha::ArticleRequests',
value => { status => 'PROCESSING', borrowernumber => $patron->id }
}
);
$builder->build_object(
{
class => 'Koha::ArticleRequests',
value => { status => 'CANCELED', borrowernumber => $patron->id }
}
);
ok(
$patron->can_request_article( $library_1->id ),
'3 current requests, 4 is the limit: allowed'
);
# Completed request, same day
my $completed = $builder->build_object(
{
class => 'Koha::ArticleRequests',
value => {
status => 'COMPLETED',
borrowernumber => $patron->id
}
}
);
ok(
!$patron->can_request_article( $library_1->id ),
'3 current requests and a completed one the same day: denied'
);
$completed->updated_on(
dt_from_string->add( days => -1 )->set(
hour => 23,
minute => 59,
second => 59,
)
)->store;
ok(
$patron->can_request_article( $library_1->id ),
'3 current requests and a completed one the day before: allowed'
);
Koha::CirculationRules->set_rule(
{
categorycode => undef,
branchcode => $library_2->id,
rule_name => 'open_article_requests_limit',
rule_value => 3,
}
);
ok(
!$patron->can_request_article,
'Not passing the library_id param makes it fallback to userenv: denied'
);
$schema->storage->txn_rollback;
};
subtest 'article_requests() tests' => sub {
plan tests => 3;
$schema->storage->txn_begin;
my $library = $builder->build_object( { class => 'Koha::Libraries' } );
t::lib::Mocks::mock_userenv( { branchcode => $library->id } );
my $patron = $builder->build_object( { class => 'Koha::Patrons' } );
my $article_requests = $patron->article_requests;
is(
ref($article_requests), 'Koha::ArticleRequests',
'In scalar context, type is correct'
);
is( $article_requests->count, 0, 'No article requests' );
foreach my $i ( 0 .. 3 ) {
my $item = $builder->build_sample_item;
$builder->build_object(
{
class => 'Koha::ArticleRequests',
value => {
borrowernumber => $patron->id,
biblionumber => $item->biblionumber,
itemnumber => $item->id,
title => "Title",
}
}
)->request;
}
$article_requests = $patron->article_requests;
is( $article_requests->count, 4, '4 article requests' );
$schema->storage->txn_rollback;
};
subtest 'can_patron_change_staff_only_lists() tests' => sub {
plan tests => 3;
$schema->storage->txn_begin;
# make a user with no special permissions
my $patron = $builder->build_object(
{
class => 'Koha::Patrons',
value => { flags => undef }
}
);
is( $patron->can_patron_change_staff_only_lists(), 0, 'Patron without permissions cannot change staff only lists' );
# make it a 'Catalogue' permission
$patron->set( { flags => 4 } )->store->discard_changes;
is( $patron->can_patron_change_staff_only_lists(), 1, 'Catalogue patron can change staff only lists' );
# make it a superlibrarian
$patron->set( { flags => 1 } )->store->discard_changes;
is( $patron->can_patron_change_staff_only_lists(), 1, 'Superlibrarian patron can change staff only lists' );
$schema->storage->txn_rollback;
};
subtest 'can_patron_change_permitted_staff_lists() tests' => sub {
plan tests => 4;
$schema->storage->txn_begin;
# make a user with no special permissions
my $patron = $builder->build_object(
{
class => 'Koha::Patrons',
value => { flags => undef }
}
);
is(
$patron->can_patron_change_permitted_staff_lists(), 0,
'Patron without permissions cannot change permitted staff lists'
);
# make it a 'Catalogue' permission
$patron->set( { flags => 4 } )->store->discard_changes;
is( $patron->can_patron_change_permitted_staff_lists(), 0, 'Catalogue patron cannot change permitted staff lists' );
# make it a 'Catalogue' permission and 'edit_public_list_contents' sub-permission
$patron->set( { flags => 4 } )->store->discard_changes;
$builder->build(
{
source => 'UserPermission',
value => {
borrowernumber => $patron->borrowernumber,
module_bit => 20, # lists
code => 'edit_public_list_contents',
},
}
);
is(
$patron->can_patron_change_permitted_staff_lists(), 1,
'Catalogue and "edit_public_list_contents" patron can change permitted staff lists'
);
# make it a superlibrarian
$patron->set( { flags => 1 } )->store->discard_changes;
is(
$patron->can_patron_change_permitted_staff_lists(), 1,
'Superlibrarian patron can change permitted staff lists'
);
$schema->storage->txn_rollback;
};
subtest 'password expiration tests' => sub {
plan tests => 5;
$schema->storage->txn_begin;
my $date = dt_from_string();
my $category = $builder->build_object(
{
class => 'Koha::Patron::Categories',
value => {
password_expiry_days => 10,
require_strong_password => 0,
force_password_reset_when_set_by_staff => 0,
}
}
);
my $patron = $builder->build_object(
{
class => 'Koha::Patrons',
value => {
categorycode => $category->categorycode,
password => 'hats'
}
}
);
$patron->delete()->store()->discard_changes(); # Make sure we are storing a 'new' patron
is(
$patron->password_expiration_date(), $date->add( days => 10 )->ymd(),
"Password expiration date set correctly on patron creation"
);
$patron = $builder->build_object(
{
class => 'Koha::Patrons',
value => {
categorycode => $category->categorycode,
password => undef
}
}
);
$patron->delete()->store()->discard_changes();
is(
$patron->password_expiration_date(), undef,
"Password expiration date is not set if patron does not have a password"
);
$category->password_expiry_days(undef)->store();
$patron =
$builder->build_object( { class => 'Koha::Patrons', value => { categorycode => $category->categorycode } } );
$patron->delete()->store()->discard_changes();
is(
$patron->password_expiration_date(), undef,
"Password expiration date is not set if category does not have expiry days set"
);
$schema->storage->txn_rollback;
subtest 'password_expired' => sub {
plan tests => 3;
$schema->storage->txn_begin;
my $date = dt_from_string();
$patron =
$builder->build_object( { class => 'Koha::Patrons', value => { password_expiration_date => undef } } );
is( $patron->password_expired, 0, "Patron with no password expiration date, password not expired" );
$patron->password_expiration_date($date)->store;
$patron->discard_changes();
is( $patron->password_expired, 1, "Patron with password expiration date of today, password expired" );
$date->subtract( days => 1 );
$patron->password_expiration_date($date)->store;
$patron->discard_changes();
is( $patron->password_expired, 1, "Patron with password expiration date in past, password expired" );
$schema->storage->txn_rollback;
};
subtest 'set_password() tests' => sub {
plan tests => 7;
$schema->storage->txn_begin;
my $date = dt_from_string();
my $category =
$builder->build_object( { class => 'Koha::Patron::Categories', value => { password_expiry_days => 10 } } );
Koha::Notice::Templates->search( { code => 'PASSWORD_CHANGE', module => 'members' } )->delete;
my $patron = $builder->build_object(
{
class => 'Koha::Patrons',
value => {
categorycode => $category->categorycode,
password_expiration_date => $date->subtract( days => 1 )
}
}
);
# Create a PASSWORD_CHANGE letter template
$builder->build_object(
{
class => 'Koha::Notice::Templates',
value => {
module => 'members',
code => 'PASSWORD_CHANGE',
branchcode => '',
name => 'Password Change Notification',
is_html => 0,
title => 'Your password has been changed',
content => 'Dear [% borrower.firstname %], your password has been changed.',
message_transport_type => 'email',
lang => 'default'
}
}
);
is( $patron->password_expired, 1, "Patron password is expired" );
$date = dt_from_string();
$patron->set_password( { password => "kitten", skip_validation => 1 } )->discard_changes();
is( $patron->password_expired, 0, "Patron password no longer expired when new password set" );
is(
$patron->password_expiration_date(), $date->add( days => 10 )->ymd(),
"Password expiration date set correctly on patron creation"
);
$category->password_expiry_days(undef)->store();
$patron->set_password( { password => "puppies", skip_validation => 1 } )->discard_changes();
is(
$patron->password_expiration_date(), undef,
"Password expiration date is unset if category does not have expiry days"
);
# Test password change notification - missing letter template should not prevent password change
subtest 'Password change works even when PASSWORD_CHANGE letter is missing' => sub {
plan tests => 4;
# Enable NotifyPasswordChange preference
t::lib::Mocks::mock_preference( 'NotifyPasswordChange', 1 );
# Create a patron with a valid email address
my $patron = $builder->build_object(
{
class => 'Koha::Patrons',
value => {
email => 'patron@example.com',
password => Koha::AuthUtils::hash_password('OldPassword123!')
}
}
);
# Store the original password hash for comparison
my $original_password_hash = $patron->password;
# Ensure there is NO PASSWORD_CHANGE letter template
# (This was the bug condition - should not prevent password change)
Koha::Notice::Templates->search(
{
code => 'PASSWORD_CHANGE',
module => 'members'
}
)->delete;
# Attempt to set a new password
my $result;
warning_like { $result = $patron->set_password( { password => 'NewPassword123!', skip_validation => 1 } ); }
qr/No members PASSWORD_CHANGE letter transported by email/,
'No letter warning correctly printed';
# FIXED: The method should return the patron object even when letter is missing
isa_ok(
$result, 'Koha::Patron',
'set_password returns patron object even when PASSWORD_CHANGE letter is missing'
);
# Reload patron from database to check if password was actually changed
$patron->discard_changes;
# FIXED: Password should be changed even when letter template is missing
isnt(
$patron->password, $original_password_hash,
'Password was changed even though letter template is missing'
);
# Verify the new password works
my $new_auth_result = C4::Auth::checkpw_hash( 'NewPassword123!', $patron->password );
is( $new_auth_result, 1, 'New password authenticates correctly' );
};
subtest 'Password change works when NotifyPasswordChange is disabled' => sub {
plan tests => 3;
# Disable NotifyPasswordChange preference
t::lib::Mocks::mock_preference( 'NotifyPasswordChange', 0 );
# Create a patron with a valid email address
my $patron = $builder->build_object(
{
class => 'Koha::Patrons',
value => {
email => 'patron@example.com',
password => Koha::AuthUtils::hash_password('OldPassword123!')
}
}
);
# Store the original password hash for comparison
my $original_password_hash = $patron->password;
# Ensure there is NO PASSWORD_CHANGE letter template
Koha::Notice::Templates->search(
{
code => 'PASSWORD_CHANGE',
module => 'members'
}
)->delete;
# Attempt to set a new password
my $result = $patron->set_password( { password => 'NewPassword123!', skip_validation => 1 } );
# Should work fine when NotifyPasswordChange is disabled
isa_ok( $result, 'Koha::Patron', 'set_password returns patron object when notification disabled' );
# Reload patron from database to check if password was actually changed
$patron->discard_changes;
# Password should be changed
isnt( $patron->password, $original_password_hash, 'Password was changed when notification disabled' );
# Verify the new password works
my $auth_result = C4::Auth::checkpw_hash( 'NewPassword123!', $patron->password );
is( $auth_result, 1, 'New password authenticates correctly' );
};
subtest 'Password change works when PASSWORD_CHANGE letter exists' => sub {
plan tests => 3;
# Enable NotifyPasswordChange preference
t::lib::Mocks::mock_preference( 'NotifyPasswordChange', 1 );
# Create a patron with a valid email address
my $patron = $builder->build_object(
{
class => 'Koha::Patrons',
value => {
email => 'patron@example.com',
password => Koha::AuthUtils::hash_password('OldPassword123!')
}
}
);
# Store the original password hash for comparison
my $original_password_hash = $patron->password;
# Delete any existing PASSWORD_CHANGE letters to avoid constraint violations
Koha::Notice::Templates->search(
{
code => 'PASSWORD_CHANGE',
module => 'members'
}
)->delete;
# Create a PASSWORD_CHANGE letter template
$builder->build_object(
{
class => 'Koha::Notice::Templates',
value => {
module => 'members',
code => 'PASSWORD_CHANGE',
branchcode => '',
name => 'Password Change Notification',
is_html => 0,
title => 'Your password has been changed',
content => 'Dear [% borrower.firstname %], your password has been changed.',
message_transport_type => 'email',
lang => 'default'
}
}
);
# Attempt to set a new password
my $result = $patron->set_password( { password => 'NewPassword123!', skip_validation => 1 } );
# Should work fine when PASSWORD_CHANGE letter exists
isa_ok( $result, 'Koha::Patron', 'set_password returns patron object when letter template exists' );
# Reload patron from database to check if password was actually changed
$patron->discard_changes;
# Password should be changed
isnt( $patron->password, $original_password_hash, 'Password was changed when letter template exists' );
# Verify the new password works
my $auth_result = C4::Auth::checkpw_hash( 'NewPassword123!', $patron->password );
is( $auth_result, 1, 'New password authenticates correctly' );
};
$schema->storage->txn_rollback;
};
};
subtest 'force_password_reset_when_set_by_staff tests' => sub {
plan tests => 3;
$schema->storage->txn_begin;
my $category = $builder->build_object(
{
class => 'Koha::Patron::Categories',
value => {
force_password_reset_when_set_by_staff => 1,
require_strong_password => 0,
}
}
);
my $patron = $builder->build_object(
{
class => 'Koha::Patrons',
value => {
categorycode => $category->categorycode,
password => 'hats'
}
}
);
$patron->delete()->store()->discard_changes();
is( $patron->password_expired, 1, "Patron forced into changing password, password expired." );
$patron->category->force_password_reset_when_set_by_staff(0)->store();
$patron->delete()->store()->discard_changes();
is( $patron->password_expired, 0, "Patron not forced into changing password, password not expired." );
$patron->category->force_password_reset_when_set_by_staff(1)->store();
t::lib::Mocks::mock_preference( 'PatronSelfRegistrationDefaultCategory', $patron->categorycode );
$patron->delete()->store()->discard_changes();
is(
$patron->password_expired, 0,
"Patron forced into changing password but patron is self-registered, password not expired."
);
$schema->storage->txn_rollback;
};
subtest 'safe_to_delete() tests' => sub {
plan tests => 17;
$schema->storage->txn_begin;
my $patron = $builder->build_object( { class => 'Koha::Patrons' } );
## Make it the anonymous
t::lib::Mocks::mock_preference( 'AnonymousPatron', $patron->id );
ok( !$patron->safe_to_delete, 'Cannot delete, it is the anonymous patron' );
my $message = $patron->safe_to_delete->messages->[0];
is( $message->type, 'error', 'Type is error' );
is( $message->message, 'is_anonymous_patron', 'Cannot delete, it is the anonymous patron' );
# cleanup
t::lib::Mocks::mock_preference( 'AnonymousPatron', 0 );
## Make it have a checkout
my $checkout = $builder->build_object(
{
class => 'Koha::Checkouts',
value => { borrowernumber => $patron->id }
}
);
ok( !$patron->safe_to_delete, 'Cannot delete, has checkouts' );
$message = $patron->safe_to_delete->messages->[0];
is( $message->type, 'error', 'Type is error' );
is( $message->message, 'has_checkouts', 'Cannot delete, has checkouts' );
# cleanup
$checkout->delete;
## Make it have a guarantee
t::lib::Mocks::mock_preference( 'borrowerRelationship', 'parent' );
$builder->build_object( { class => 'Koha::Patrons' } )
->add_guarantor( { guarantor_id => $patron->id, relationship => 'parent' } );
ok( !$patron->safe_to_delete, 'Cannot delete, has guarantees' );
$message = $patron->safe_to_delete->messages->[0];
is( $message->type, 'error', 'Type is error' );
is( $message->message, 'has_guarantees', 'Cannot delete, has guarantees' );
# cleanup
$patron->guarantee_relationships->delete;
## Make it have debt
my $debit = $patron->account->add_debit( { amount => 10, interface => 'intranet', type => 'MANUAL' } );
ok( !$patron->safe_to_delete, 'Cannot delete, has debt' );
$message = $patron->safe_to_delete->messages->[0];
is( $message->type, 'error', 'Type is error' );
is( $message->message, 'has_debt', 'Cannot delete, has debt' );
# cleanup
my $manager = $builder->build_object( { class => 'Koha::Patrons' } );
t::lib::Mocks::mock_userenv( { borrowernumber => $manager->id } );
$patron->account->pay( { amount => 10, debits => [$debit] } );
## Make it protected
$patron->protected(1);
ok( !$patron->safe_to_delete, 'Cannot delete, is protected' );
$message = $patron->safe_to_delete->messages->[0];
is( $message->type, 'error', 'Type is error' );
is( $message->message, 'is_protected', 'Cannot delete, is protected' );
$patron->protected(0);
## Happy case :-D
ok( $patron->safe_to_delete, 'Can delete, all conditions met' );
my $messages = $patron->safe_to_delete->messages;
is_deeply( $messages, [], 'Patron can be deleted, no messages' );
$schema->storage->txn_rollback;
};
subtest 'article_request_fee() tests' => sub {
plan tests => 3;
$schema->storage->txn_begin;
# Cleanup, to avoid interference
Koha::CirculationRules->search( { rule_name => 'article_request_fee' } )->delete;
t::lib::Mocks::mock_preference( 'ArticleRequests', 1 );
my $item = $builder->build_sample_item;
my $library_1 = $builder->build_object( { class => 'Koha::Libraries' } );
my $library_2 = $builder->build_object( { class => 'Koha::Libraries' } );
my $patron = $builder->build_object( { class => 'Koha::Patrons' } );
# Rule that should never be picked, because the patron's category is always picked
Koha::CirculationRules->set_rule(
{
categorycode => undef,
branchcode => undef,
rule_name => 'article_request_fee',
rule_value => 1,
}
);
is( $patron->article_request_fee( { library_id => $library_2->id } ), 1, 'library_id used correctly' );
Koha::CirculationRules->set_rule(
{
categorycode => $patron->categorycode,
branchcode => undef,
rule_name => 'article_request_fee',
rule_value => 2,
}
);
Koha::CirculationRules->set_rule(
{
categorycode => $patron->categorycode,
branchcode => $library_1->id,
rule_name => 'article_request_fee',
rule_value => 3,
}
);
is( $patron->article_request_fee( { library_id => $library_2->id } ), 2, 'library_id used correctly' );
t::lib::Mocks::mock_userenv( { branchcode => $library_1->id } );
is( $patron->article_request_fee(), 3, 'env used correctly' );
$schema->storage->txn_rollback;
};
subtest 'add_article_request_fee_if_needed() tests' => sub {
plan tests => 12;
$schema->storage->txn_begin;
my $amount = 0;
my $patron_mock = Test::MockModule->new('Koha::Patron');
$patron_mock->mock( 'article_request_fee', sub { return $amount; } );
my $patron = $builder->build_object( { class => 'Koha::Patrons' } );
is( $patron->article_request_fee, $amount, 'article_request_fee mocked' );
my $library_1 = $builder->build_object( { class => 'Koha::Libraries' } );
my $library_2 = $builder->build_object( { class => 'Koha::Libraries' } );
my $staff = $builder->build_object( { class => 'Koha::Patrons' } );
my $item = $builder->build_sample_item;
t::lib::Mocks::mock_userenv( { branchcode => $library_1->id, patron => $staff } );
my $debit = $patron->add_article_request_fee_if_needed();
is( $debit, undef, 'No fee, no debit line' );
# positive value
$amount = 1;
$debit = $patron->add_article_request_fee_if_needed( { item_id => $item->id } );
is( ref($debit), 'Koha::Account::Line', 'Debit object type correct' );
is(
$debit->amount, $amount,
'amount set to $patron->article_request_fee value'
);
is(
$debit->manager_id, $staff->id,
'manager_id set to userenv session user'
);
is(
$debit->branchcode, $library_1->id,
'branchcode set to userenv session library'
);
is(
$debit->debit_type_code, 'ARTICLE_REQUEST',
'debit_type_code set correctly'
);
is(
$debit->itemnumber, $item->id,
'itemnumber set correctly'
);
$amount = 100;
$debit = $patron->add_article_request_fee_if_needed( { library_id => $library_2->id } );
is( ref($debit), 'Koha::Account::Line', 'Debit object type correct' );
is(
$debit->amount, $amount,
'amount set to $patron->article_request_fee value'
);
is(
$debit->branchcode, $library_2->id,
'branchcode set to userenv session library'
);
is(
$debit->itemnumber, undef,
'itemnumber set correctly to undef'
);
$schema->storage->txn_rollback;
};
subtest 'messages' => sub {
plan tests => 4;
$schema->storage->txn_begin;
my $patron = $builder->build_object( { class => 'Koha::Patrons' } );
my $messages = $patron->messages;
is( $messages->count, 0, "No message yet" );
my $message_1 = $builder->build_object(
{
class => 'Koha::Patron::Messages',
value => { borrowernumber => $patron->borrowernumber }
}
);
my $message_2 = $builder->build_object(
{
class => 'Koha::Patron::Messages',
value => { borrowernumber => $patron->borrowernumber }
}
);
$messages = $patron->messages;
is( $messages->count, 2, "There are two messages for this patron" );
is( $messages->next->message, $message_1->message );
is( $messages->next->message, $message_2->message );
$schema->storage->txn_rollback;
};
subtest 'recalls() tests' => sub {
plan tests => 3;
$schema->storage->txn_begin;
my $patron = $builder->build_object( { class => 'Koha::Patrons' } );
my $biblio1 = $builder->build_object( { class => 'Koha::Biblios' } );
my $item1 =
$builder->build_object( { class => 'Koha::Items' }, { value => { biblionumber => $biblio1->biblionumber } } );
my $biblio2 = $builder->build_object( { class => 'Koha::Biblios' } );
my $item2 =
$builder->build_object( { class => 'Koha::Items' }, { value => { biblionumber => $biblio2->biblionumber } } );
Koha::Recall->new(
{
biblio_id => $biblio1->biblionumber,
patron_id => $patron->borrowernumber,
item_id => $item1->itemnumber,
pickup_library_id => $patron->branchcode,
created_date => \'NOW()',
item_level => 1,
}
)->store;
Koha::Recall->new(
{
biblio_id => $biblio2->biblionumber,
patron_id => $patron->borrowernumber,
item_id => $item2->itemnumber,
pickup_library_id => $patron->branchcode,
created_date => \'NOW()',
item_level => 1,
}
)->store;
Koha::Recall->new(
{
biblio_id => $biblio1->biblionumber,
patron_id => $patron->borrowernumber,
item_id => undef,
pickup_library_id => $patron->branchcode,
created_date => \'NOW()',
item_level => 0,
}
)->store;
my $recall = Koha::Recall->new(
{
biblio_id => $biblio1->biblionumber,
patron_id => $patron->borrowernumber,
item_id => undef,
pickup_library_id => $patron->branchcode,
created_date => \'NOW()',
item_level => 0,
}
)->store;
$recall->set_cancelled;
is( $patron->recalls->count, 4, "Correctly gets this patron's recalls" );
is( $patron->recalls->filter_by_current->count, 3, "Correctly gets this patron's active recalls" );
is(
$patron->recalls->filter_by_current->search( { biblio_id => $biblio1->biblionumber } )->count, 2,
"Correctly gets this patron's active recalls on a specific biblio"
);
$schema->storage->txn_rollback;
};
subtest 'encode_secret and decoded_secret' => sub {
plan tests => 5;
$schema->storage->txn_begin;
t::lib::Mocks::mock_config( 'encryption_key', 't0P_secret' );
my $patron = $builder->build_object( { class => 'Koha::Patrons' } );
is( $patron->decoded_secret, undef, 'TestBuilder does not initialize it' );
$patron->secret(q{});
is( $patron->decoded_secret, q{}, 'Empty string case' );
$patron->encode_secret('encrypt_me'); # Note: lazy testing; should be base32 string normally.
is( length( $patron->secret ) > 0, 1, 'Secret length' );
isnt( $patron->secret, 'encrypt_me', 'Encrypted column' );
is( $patron->decoded_secret, 'encrypt_me', 'Decrypted column' );
$schema->storage->txn_rollback;
};
subtest 'notify_library_of_registration()' => sub {
plan tests => 6;
$schema->storage->txn_begin;
my $dbh = C4::Context->dbh;
my $library = $builder->build_object(
{
class => 'Koha::Libraries',
value => {
branchemail => 'from@mybranch.com',
branchreplyto => 'to@mybranch.com'
}
}
);
my $patron = $builder->build_object(
{
class => 'Koha::Patrons',
value => { branchcode => $library->branchcode }
}
);
t::lib::Mocks::mock_preference( 'KohaAdminEmailAddress', 'root@localhost' );
t::lib::Mocks::mock_preference( 'EmailAddressForPatronRegistrations', 'library@localhost' );
# Test when EmailPatronRegistrations equals BranchEmailAddress
t::lib::Mocks::mock_preference( 'EmailPatronRegistrations', 'BranchEmailAddress' );
is(
$patron->notify_library_of_registration( C4::Context->preference('EmailPatronRegistrations') ), 1,
'OPAC_REG email is queued if EmailPatronRegistration syspref equals BranchEmailAddress'
);
my $sth = $dbh->prepare("SELECT to_address FROM message_queue where borrowernumber = ?");
$sth->execute( $patron->borrowernumber );
my $to_address = $sth->fetchrow_array;
is(
$to_address, 'to@mybranch.com',
'OPAC_REG email queued to go to branchreplyto address when EmailPatronRegistration equals BranchEmailAddress'
);
$dbh->do(q|DELETE FROM message_queue|);
# Test when EmailPatronRegistrations equals EmailAddressForPatronRegistrations
t::lib::Mocks::mock_preference( 'EmailPatronRegistrations', 'EmailAddressForPatronRegistrations' );
is(
$patron->notify_library_of_registration( C4::Context->preference('EmailPatronRegistrations') ), 1,
'OPAC_REG email is queued if EmailPatronRegistration syspref equals EmailAddressForPatronRegistrations'
);
$sth->execute( $patron->borrowernumber );
$to_address = $sth->fetchrow_array;
is(
$to_address, 'library@localhost',
'OPAC_REG email queued to go to EmailAddressForPatronRegistrations syspref when EmailPatronRegistration equals EmailAddressForPatronRegistrations'
);
$dbh->do(q|DELETE FROM message_queue|);
# Test when EmailPatronRegistrations equals KohaAdminEmailAddress
t::lib::Mocks::mock_preference( 'EmailPatronRegistrations', 'KohaAdminEmailAddress' );
t::lib::Mocks::mock_preference( 'ReplyToDefault', 'root@localhost' ); # FIXME Remove localhost
is(
$patron->notify_library_of_registration( C4::Context->preference('EmailPatronRegistrations') ), 1,
'OPAC_REG email is queued if EmailPatronRegistration syspref equals KohaAdminEmailAddress'
);
$sth->execute( $patron->borrowernumber );
$to_address = $sth->fetchrow_array;
is(
$to_address, 'root@localhost',
'OPAC_REG email queued to go to KohaAdminEmailAddress syspref when EmailPatronRegistration equals KohaAdminEmailAddress'
);
$dbh->do(q|DELETE FROM message_queue|);
$schema->storage->txn_rollback;
};
subtest 'notice_email_address() tests' => sub {
plan tests => 5;
$schema->storage->txn_begin;
my $patron = $builder->build_object( { class => 'Koha::Patrons' } );
t::lib::Mocks::mock_preference( 'EmailFieldPrecedence', 'email|emailpro' );
t::lib::Mocks::mock_preference( 'EmailFieldPrimary', undef );
is(
$patron->notice_email_address, $patron->email,
"Koha::Patron->notice_email_address returns correct value when EmailFieldPrimary is not defined"
);
t::lib::Mocks::mock_preference( 'EmailFieldPrimary', 'emailpro' );
is(
$patron->notice_email_address, $patron->emailpro,
"Koha::Patron->notice_email_address returns correct value when EmailFieldPrimary is emailpro"
);
t::lib::Mocks::mock_preference( 'EmailFieldPrimary', 'MULTI' );
t::lib::Mocks::mock_preference( 'EmailFieldSelection', 'email,emailpro' );
is(
$patron->notice_email_address, $patron->email . "," . $patron->emailpro,
"Koha::Patron->notice_email_address returns correct value when EmailFieldPrimary is 'MULTI' and EmailFieldSelection is 'email,emailpro'"
);
my $invalid = 'potato';
t::lib::Mocks::mock_preference( 'EmailFieldPrecedence', 'email|emailpro' );
t::lib::Mocks::mock_preference( 'EmailFieldPrimary', $invalid );
my $email;
warning_is { $email = $patron->notice_email_address(); }
qq{Invalid value for EmailFieldPrimary ($invalid)},
'Warning correctly generated on invalid system preference';
is(
$email, $patron->email,
"Koha::Patron->notice_email_address falls back to correct value when EmailFieldPrimary is invalid"
);
$schema->storage->txn_rollback;
};
subtest 'first_valid_email_address' => sub {
plan tests => 1;
$schema->storage->txn_begin;
my $patron = $builder->build_object( { class => 'Koha::Patrons', value => { emailpro => '' } } );
t::lib::Mocks::mock_preference( 'EmailFieldPrecedence', 'emailpro|email' );
is(
$patron->first_valid_email_address, $patron->email,
"Koha::Patron->first_valid_email_address returns correct value when EmailFieldPrecedence is 'emailpro|email' and emailpro is empty"
);
$patron->delete;
$schema->storage->txn_rollback;
};
subtest 'get_savings tests' => sub {
plan tests => 4;
$schema->storage->txn_begin;
my $library = $builder->build_object( { class => 'Koha::Libraries' } );
my $patron =
$builder->build_object( { class => 'Koha::Patrons' }, { value => { branchcode => $library->branchcode } } );
t::lib::Mocks::mock_userenv( { patron => $patron, branchcode => $library->branchcode } );
my $biblio = $builder->build_sample_biblio;
my $item1 = $builder->build_sample_item(
{
biblionumber => $biblio->biblionumber,
library => $library->branchcode,
replacementprice => rand(20),
}
);
my $item2 = $builder->build_sample_item(
{
biblionumber => $biblio->biblionumber,
library => $library->branchcode,
replacementprice => rand(20),
}
);
is( $patron->get_savings, 0, 'No checkouts, no savings' );
# Add an old checkout with deleted itemnumber
$builder->build_object(
{ class => 'Koha::Old::Checkouts', value => { itemnumber => undef, borrowernumber => $patron->id } } );
is( $patron->get_savings, 0, 'No checkouts with itemnumber, no savings' );
AddIssue( $patron, $item1->barcode );
AddIssue( $patron, $item2->barcode );
my $savings = $patron->get_savings;
is(
$savings + 0, $item1->replacementprice + $item2->replacementprice,
"Savings correctly calculated from current issues"
);
AddReturn( $item2->barcode, $item2->homebranch );
$savings = $patron->get_savings;
is(
$savings + 0, $item1->replacementprice + $item2->replacementprice,
"Savings correctly calculated from current and old issues"
);
$schema->storage->txn_rollback;
};
subtest 'update privacy tests' => sub {
$schema->storage->txn_begin;
plan tests => 5;
$schema->storage->txn_begin;
my $patron = $builder->build_object( { class => 'Koha::Patrons', value => { privacy => 1 } } );
my $old_checkout =
$builder->build_object( { class => 'Koha::Old::Checkouts', value => { borrowernumber => $patron->id } } );
t::lib::Mocks::mock_preference( 'AnonymousPatron', '0' );
$patron->privacy(2); #set to never
throws_ok { $patron->store } 'Koha::Exceptions::Patron::FailedAnonymizing',
'We throw an exception when anonymizing fails';
$old_checkout->discard_changes; #refresh from db
$patron->discard_changes;
is( $old_checkout->borrowernumber, $patron->id, "When anonymizing fails, we don't clear the checkouts" );
is( $patron->privacy(), 1, "When anonymizing fails, we don't change the privacy" );
my $anon_patron = $builder->build_object( { class => 'Koha::Patrons' } );
t::lib::Mocks::mock_preference( 'AnonymousPatron', $anon_patron->id );
$patron->privacy(2)->store(); #set to never
$old_checkout->discard_changes; #refresh from db
$patron->discard_changes;
is( $old_checkout->borrowernumber, $anon_patron->id, "Checkout is successfully anonymized" );
is( $patron->privacy(), 2, "Patron privacy is successfully updated" );
$schema->storage->txn_rollback;
};
subtest 'alert_subscriptions tests' => sub {
plan tests => 3;
$schema->storage->txn_begin;
my $patron = $builder->build_object( { class => 'Koha::Patrons' } );
my $subscription1 = $builder->build_object(
{
class => 'Koha::Subscriptions',
value => {
librarian => $patron->borrowernumber,
}
}
);
$subscription1->add_subscriber($patron);
my $subscription2 = $builder->build_object(
{
class => 'Koha::Subscriptions',
value => {
librarian => $patron->borrowernumber,
}
}
);
$subscription2->add_subscriber($patron);
my @subscriptions = $patron->alert_subscriptions->as_list;
is( @subscriptions, 2, "Number of patron's subscribed alerts successfully fetched" );
is( $subscriptions[0]->subscriptionid, $subscription1->subscriptionid, "First subscribed alert is correct" );
is( $subscriptions[1]->subscriptionid, $subscription2->subscriptionid, "Second subscribed alert is correct" );
$patron->discard_changes;
$schema->storage->txn_rollback;
};
subtest 'test patron_consent' => sub {
plan tests => 4;
$schema->storage->txn_begin;
my $patron = $builder->build_object( { class => 'Koha::Patrons' } );
throws_ok { $patron->consent } 'Koha::Exceptions::MissingParameter', 'missing type';
my $consent = $patron->consent('GDPR_PROCESSING');
is( ref $consent, 'Koha::Patron::Consent', 'return type check' );
$consent->given_on('2021-02-03')->store;
undef $consent;
is( $patron->consent('GDPR_PROCESSING')->given_on, '2021-02-03 00:00:00', 'check date' );
is( $patron->consent('NOT_EXIST')->refused_on, undef, 'New empty object for new type' );
$schema->storage->txn_rollback;
};
subtest 'update_lastseen tests' => sub {
plan tests => 26;
$schema->storage->txn_begin;
my $mock_cache = Test::MockModule->new('Koha::Cache');
my %fake_cache;
$mock_cache->mock(
'set_in_cache',
sub {
my ( $self, $key, $value ) = @_;
$fake_cache{$key} = $value;
return;
}
);
$mock_cache->mock(
'get_from_cache',
sub {
my ( $self, $key ) = @_;
return $fake_cache{$key};
}
);
my $cache = Koha::Caches->get_instance();
t::lib::Mocks::mock_preference(
'TrackLastPatronActivityTriggers',
'creation,login,connection,check_in,check_out,renewal,hold,article'
);
my $patron = $builder->build_object( { class => 'Koha::Patrons' } );
my $patron_info = $patron->unblessed;
delete $patron_info->{borrowernumber};
$patron->delete();
$patron = Koha::Patron->new($patron_info)->store();
$patron->update_lastseen( { activity => 'creation' } );
$patron->discard_changes();
my $now = dt_from_string();
my $today = $now->ymd();
is(
dt_from_string( $patron->lastseen )->ymd(), $today,
'Patron should have last seen when newly created if requested'
);
my $cache_key = "track_activity_" . $patron->borrowernumber;
is( $cache->get_from_cache($cache_key), $today, "Cache was updated as expected" );
$patron->delete();
t::lib::Mocks::mock_preference(
'TrackLastPatronActivityTriggers',
''
);
my $patron_no_trigger = $builder->build_object( { class => 'Koha::Patrons' } );
$patron_no_trigger->lastseen(undef)->store();
$patron_no_trigger->update_lastseen( { activity => 'login' } );
$patron_no_trigger->discard_changes();
is(
$patron_no_trigger->lastseen, undef,
'Patron should have not last seen when newly created if trigger not set'
);
t::lib::Mocks::mock_preference(
'TrackLastPatronActivityTriggers',
'login,connection,check_in,check_out,renewal,hold,article'
);
$now = dt_from_string();
Time::Fake->offset( $now->epoch );
$patron->update_lastseen('login');
$patron->_result()->discard_changes();
isnt(
$patron->lastseen, undef,
'Patron should have last seen set when TrackLastPatronActivityTriggers contains values'
);
my $last_seen = $patron->lastseen;
Time::Fake->offset( $now->epoch + 5 );
# Test that lastseen isn't updated more than once in a day (regardless of activity passed)
$patron->update_lastseen('login');
$patron->_result()->discard_changes();
is( $patron->lastseen, $last_seen, 'Patron last seen should still be unchanged after a login' );
$patron->update_lastseen('connection');
$patron->_result()->discard_changes();
is( $patron->lastseen, $last_seen, 'Patron last seen should still be unchanged after a SIP/ILSDI connection' );
$patron->update_lastseen('check_out');
$patron->_result()->discard_changes();
is( $patron->lastseen, $last_seen, 'Patron last seen should still be unchanged after a check out' );
$patron->update_lastseen('check_in');
$patron->_result()->discard_changes();
is( $patron->lastseen, $last_seen, 'Patron last seen should still be unchanged after a check in' );
$patron->update_lastseen('renewal');
$patron->_result()->discard_changes();
is( $patron->lastseen, $last_seen, 'Patron last seen should still be unchanged after a renewal' );
$patron->update_lastseen('hold');
$patron->_result()->discard_changes();
is( $patron->lastseen, $last_seen, 'Patron last seen should still be unchanged after a hold' );
$patron->update_lastseen('article');
$patron->_result()->discard_changes();
is( $patron->lastseen, $last_seen, 'Patron last seen should still be unchanged after a article' );
# Check that tracking is disabled when the activity isn't listed
t::lib::Mocks::mock_preference( 'TrackLastPatronActivityTriggers', '' );
$cache->clear_from_cache($cache_key); # Rule out the more than once day prevention above
$patron->update_lastseen('login');
$patron->_result()->discard_changes();
is(
$patron->lastseen, $last_seen,
'Patron last seen should be unchanged after a login if login is not selected as an option and the cache has been cleared'
);
$patron->update_lastseen('connection');
$patron->_result()->discard_changes();
is(
$patron->lastseen, $last_seen,
'Patron last seen should be unchanged after a connection if connection is not selected as an option and the cache has been cleared'
);
$patron->update_lastseen('check_in');
$patron->_result()->discard_changes();
is(
$patron->lastseen, $last_seen,
'Patron last seen should be unchanged after a check_in if check_in is not selected as an option and the cache has been cleared'
);
$patron->update_lastseen('check_out');
$patron->_result()->discard_changes();
is(
$patron->lastseen, $last_seen,
'Patron last seen should be unchanged after a check_out if check_out is not selected as an option and the cache has been cleared'
);
$patron->update_lastseen('renewal');
$patron->_result()->discard_changes();
is(
$patron->lastseen, $last_seen,
'Patron last seen should be unchanged after a renewal if renewal is not selected as an option and the cache has been cleared'
);
$patron->update_lastseen('hold');
$patron->_result()->discard_changes();
is(
$patron->lastseen, $last_seen,
'Patron last seen should be unchanged after a hold if hold is not selected as an option and the cache has been cleared'
);
$patron->update_lastseen('article');
$patron->_result()->discard_changes();
is(
$patron->lastseen, $last_seen,
'Patron last seen should be unchanged after an article request if article is not selected as an option and the cache has been cleared'
);
# Check tracking for each activity
t::lib::Mocks::mock_preference(
'TrackLastPatronActivityTriggers',
'login,connection,check_in,check_out,renewal,hold,article'
);
%fake_cache = ();
$patron->update_lastseen('login');
$patron->_result()->discard_changes();
isnt( $patron->lastseen, $last_seen, 'Patron last seen should be changed after a login if we cleared the cache' );
%fake_cache = ();
$patron->update_lastseen('connection');
$patron->_result()->discard_changes();
isnt(
$patron->lastseen, $last_seen,
'Patron last seen should be changed after a connection if we cleared the cache'
);
%fake_cache = ();
$patron->update_lastseen('check_out');
$patron->_result()->discard_changes();
isnt(
$patron->lastseen, $last_seen,
'Patron last seen should be changed after a check_out if we cleared the cache'
);
%fake_cache = ();
$patron->update_lastseen('check_in');
$patron->_result()->discard_changes();
isnt(
$patron->lastseen, $last_seen,
'Patron last seen should be changed after a check_in if we cleared the cache'
);
%fake_cache = ();
$patron->update_lastseen('hold');
$patron->_result()->discard_changes();
isnt(
$patron->lastseen, $last_seen,
'Patron last seen should be changed after a hold if we cleared the cache'
);
%fake_cache = ();
$patron->update_lastseen('article');
$patron->_result()->discard_changes();
isnt(
$patron->lastseen, $last_seen,
'Patron last seen should be changed after a article if we cleared the cache'
);
%fake_cache = ();
$patron->update_lastseen('renewal');
$patron->_result()->discard_changes();
isnt( $patron->lastseen, $last_seen, 'Patron last seen should be changed after a renewal if we cleared the cache' );
# Check that the preference takes effect
t::lib::Mocks::mock_preference( 'TrackLastPatronActivityTriggers', '' );
$patron->lastseen(undef)->store;
%fake_cache = ();
$patron->update_lastseen('login');
$patron->_result()->discard_changes();
is(
$patron->lastseen, undef,
'Patron should still have last seen unchanged when TrackLastPatronActivityTriggers is unset'
);
Time::Fake->reset;
$schema->storage->txn_rollback;
};
subtest 'get_lists_with_patron() tests' => sub {
plan tests => 4;
$schema->storage->txn_begin;
my $owner = $builder->build_object( { class => 'Koha::Patrons' } );
my $list_1 = AddPatronList( { name => ' Ya', owner => $owner->id } );
my $list_2 = AddPatronList( { name => 'Hey!', owner => $owner->id } );
my $patron = $builder->build_object( { class => 'Koha::Patrons' } );
my @lists = $patron->get_lists_with_patron();
is( scalar @lists, 0, 'Patron not included in any list' );
AddPatronsToList( { list => $list_1, cardnumbers => [ $patron->cardnumber ] } );
AddPatronsToList( { list => $list_2, cardnumbers => [ $patron->cardnumber ] } );
@lists = $patron->get_lists_with_patron();
foreach my $list (@lists) {
is( ref($list), 'Koha::Schema::Result::PatronList', 'Type is correct' );
}
is( join( ' ', map { $_->name } @lists ), ' Ya Hey!', 'Lists are the correct ones, and sorted alphabetically' );
$schema->storage->txn_rollback;
};
subtest 'can_be_guaranteed_by() tests' => sub {
plan tests => 5;
$schema->storage->txn_begin;
my $branchcode = $builder->build( { source => 'Branch' } )->{branchcode};
my $guarantee_category =
$builder->build(
{ source => 'Category', value => { categorycode => "GUARANTEE", category_type => 'C', can_be_guarantee => 1 } }
);
my $guarantor_category =
$builder->build(
{ source => 'Category', value => { categorycode => "GUARANTOR", category_type => 'A', can_be_guarantee => 0 } }
);
my $child = Koha::Patron->new(
{
branchcode => $branchcode,
categorycode => $guarantee_category->{categorycode},
contactname => ''
}
);
my $child2 = $builder->build_object(
{
class => 'Koha::Patrons',
value => { categorycode => $guarantee_category->{categorycode} }
}
);
my $patron = $builder->build_object(
{
class => 'Koha::Patrons',
value => { categorycode => $guarantor_category->{categorycode} }
}
);
my $patron2 = $builder->build_object(
{
class => 'Koha::Patrons',
value => { categorycode => $guarantor_category->{categorycode} }
}
);
my @guarantors;
my $contactname = "";
my $category = Koha::Patron::Categories->find( $guarantee_category->{categorycode} );
t::lib::Mocks::mock_preference( 'ChildNeedsGuarantor', 0 );
lives_ok { $child->can_be_guaranteed_by( \@guarantors ); }
'Validation passes when ChildNeedsGuarantor syspref is disabled';
t::lib::Mocks::mock_preference( 'ChildNeedsGuarantor', 1 );
throws_ok { $child->can_be_guaranteed_by( \@guarantors ); }
'Koha::Exceptions::Patron::Relationship::NoGuarantor',
'Exception thrown when guarantor is required but not provided.';
@guarantors = ( $patron, $child2 );
throws_ok { $child->can_be_guaranteed_by( \@guarantors ); }
'Koha::Exceptions::Patron::Relationship::InvalidRelationship',
'Exception thrown when child patron is added as guarantor.';
t::lib::Mocks::mock_preference( 'borrowerRelationship', 'parent' );
$child2->add_guarantor( { guarantor_id => $patron->id, relationship => 'parent' } );
@guarantors = ($patron2);
throws_ok { $patron->can_be_guaranteed_by( \@guarantors ); }
'Koha::Exceptions::Patron::Relationship::InvalidRelationship',
'Exception thrown when trying to add a guarantor to a guarantor.';
@guarantors = ($patron);
lives_ok { $child->can_be_guaranteed_by( \@guarantors ); }
'Validation passes when valid guarantors are passed in array';
$schema->storage->txn_rollback;
};
subtest 'can_checkout() tests' => sub {
plan tests => 11;
$schema->storage->txn_begin;
t::lib::Mocks::mock_preference( 'borrowerRelationship', 'parent' );
my $patron_category = $builder->build(
{
source => 'Category',
value => {
categorycode => 'NOT_X', category_type => 'P', enrolmentfee => 0, noissueschargeguarantees => 0,
noissuescharge => 10, noissueschargeguarantorswithguarantees => 0
}
}
);
my $patron = $builder->build_object(
{
class => 'Koha::Patrons',
value => {
categorycode => $patron_category->{categorycode},
}
}
);
my $patron_borrowing_status;
$patron->debarred(1);
$patron_borrowing_status = $patron->can_checkout( { patron => $patron } );
is( $patron_borrowing_status->{can_checkout}, 0, 'Debarred patron blocked from borrowing' );
is( $patron_borrowing_status->{debarred}, 1, 'Blocker correctly identified and returned' );
$patron->debarred(0);
$patron->dateexpiry( dt_from_string->subtract( days => 1 ) );
$patron_borrowing_status = $patron->can_checkout( { patron => $patron } );
is( $patron_borrowing_status->{can_checkout}, 0, 'Expired patron blocked from borrowing' );
is( $patron_borrowing_status->{expired}, 1, 'Blocker correctly identified and returned' );
$patron->dateexpiry(undef);
my $child = $builder->build_object( { class => 'Koha::Patrons' } );
my $sibling = $builder->build_object( { class => 'Koha::Patrons' } );
$child->add_guarantor( { guarantor_id => $patron->borrowernumber, relationship => 'parent' } );
$sibling->add_guarantor( { guarantor_id => $patron->borrowernumber, relationship => 'parent' } );
t::lib::Mocks::mock_preference( 'noissuescharge', 50 );
my $fee1 = $builder->build_object(
{
class => 'Koha::Account::Lines',
value => {
borrowernumber => $patron->borrowernumber,
amountoutstanding => 11,
debit_type_code => 'OVERDUE',
}
}
)->store;
my $fee2 = $builder->build_object(
{
class => 'Koha::Account::Lines',
value => {
borrowernumber => $child->borrowernumber,
amountoutstanding => 0.11,
debit_type_code => 'OVERDUE',
}
}
)->store;
my $fee3 = $builder->build_object(
{
class => 'Koha::Account::Lines',
value => {
borrowernumber => $sibling->borrowernumber,
amountoutstanding => 11.11,
debit_type_code => 'OVERDUE',
}
}
)->store;
$patron_borrowing_status = $patron->can_checkout( { patron => $patron } );
is( $patron_borrowing_status->{noissuescharge}->{charge}, 11, "Only patron's fines are reported in total" );
is( $patron_borrowing_status->{noissuescharge}->{limit}, 10, "Limit correctly identified at category level" );
is( $patron_borrowing_status->{noissuescharge}->{overlimit}, 1, "Patron is over the charge limit" );
is( $patron_borrowing_status->{can_checkout}, 0, "Patron is over the charge limit and is blocked from borrowing" );
$patron->category->noissuescharge(undef);
$patron_borrowing_status = $patron->can_checkout( { patron => $patron } );
is( $patron_borrowing_status->{noissuescharge}->{limit}, 50, "Limit correctly identified at global syspref level" );
is( $patron_borrowing_status->{noissuescharge}->{overlimit}, 0, "Patron is within the charge limit" );
is( $patron_borrowing_status->{can_checkout}, 1, "Patron is within the charge limit and can borrow" );
$schema->storage->txn_rollback;
};
subtest 'is_patron_inside_charge_limits() tests' => sub {
plan tests => 21;
$schema->storage->txn_begin;
t::lib::Mocks::mock_preference( 'borrowerRelationship', 'parent' );
my $patron_category = $builder->build(
{
source => 'Category',
value => {
categorycode => 'NOT_X', category_type => 'P', enrolmentfee => 0, noissueschargeguarantees => 0,
noissuescharge => 10, noissueschargeguarantorswithguarantees => 0
}
}
);
my $patron = $builder->build_object(
{
class => 'Koha::Patrons',
value => {
categorycode => $patron_category->{categorycode},
}
}
);
my $child = $builder->build_object( { class => 'Koha::Patrons' } );
my $sibling = $builder->build_object( { class => 'Koha::Patrons' } );
$child->add_guarantor( { guarantor_id => $patron->borrowernumber, relationship => 'parent' } );
$sibling->add_guarantor( { guarantor_id => $patron->borrowernumber, relationship => 'parent' } );
t::lib::Mocks::mock_preference( 'noissuescharge', 50 );
t::lib::Mocks::mock_preference( 'NoIssuesChargeGuarantees', 11.01 );
t::lib::Mocks::mock_preference( 'NoIssuesChargeGuarantorsWithGuarantees', undef );
my $fee1 = $builder->build_object(
{
class => 'Koha::Account::Lines',
value => {
borrowernumber => $patron->borrowernumber,
amountoutstanding => 11,
debit_type_code => 'OVERDUE',
}
}
)->store;
my $fee2 = $builder->build_object(
{
class => 'Koha::Account::Lines',
value => {
borrowernumber => $child->borrowernumber,
amountoutstanding => 0.11,
debit_type_code => 'OVERDUE',
}
}
)->store;
my $fee3 = $builder->build_object(
{
class => 'Koha::Account::Lines',
value => {
borrowernumber => $sibling->borrowernumber,
amountoutstanding => 11.11,
debit_type_code => 'OVERDUE',
}
}
)->store;
my $patron_borrowing_status;
$patron_borrowing_status = $patron->is_patron_inside_charge_limits();
is( $patron_borrowing_status->{noissuescharge}->{charge}, 11, "Only patron's fines are reported in total" );
is( $patron_borrowing_status->{noissuescharge}->{limit}, 10, "Limit correctly identified at category level" );
is( $patron_borrowing_status->{noissuescharge}->{overlimit}, 1, "Patron is over the charge limit" );
$patron->category->noissuescharge(undef);
$patron_borrowing_status = $patron->is_patron_inside_charge_limits();
is( $patron_borrowing_status->{noissuescharge}->{limit}, 50, "Limit correctly identified at global syspref level" );
is( $patron_borrowing_status->{noissuescharge}->{charge}, 11, "Charges correctly identified" );
is( $patron_borrowing_status->{noissuescharge}->{overlimit}, 0, "Patron is within the charge limit" );
is(
$patron_borrowing_status->{NoIssuesChargeGuarantees}->{limit}, 11.01,
"Limit correctly identified at global syspref level"
);
is( $patron_borrowing_status->{NoIssuesChargeGuarantees}->{charge}, 11.22, "Charges correctly identified" );
is( $patron_borrowing_status->{NoIssuesChargeGuarantees}->{overlimit}, 1, "Patron is over the charge limit" );
$patron->category->noissueschargeguarantees(12);
$patron_borrowing_status = $patron->is_patron_inside_charge_limits();
is(
$patron_borrowing_status->{NoIssuesChargeGuarantees}->{limit}, 12,
"Limit correctly identified at patron category level"
);
is( $patron_borrowing_status->{NoIssuesChargeGuarantees}->{charge}, 11.22, "Charges correctly identified" );
is( $patron_borrowing_status->{NoIssuesChargeGuarantees}->{overlimit}, 0, "Patron is inside the charge limit" );
is(
$patron_borrowing_status->{NoIssuesChargeGuarantorsWithGuarantees}->{limit}, undef,
"Limit correctly identified as not set at either patron category or global syspref level"
);
is(
$patron_borrowing_status->{NoIssuesChargeGuarantorsWithGuarantees}->{charge}, 0,
"Charges ignored as there is no limit set at either patron category or global syspref level"
);
is(
$patron_borrowing_status->{NoIssuesChargeGuarantorsWithGuarantees}->{overlimit}, 0,
"Patron is inside the charge limit as no limit has been set"
);
$patron->category->noissueschargeguarantorswithguarantees(23);
t::lib::Mocks::mock_preference( 'NoIssuesChargeGuarantorsWithGuarantees', 20 );
$patron_borrowing_status = $patron->is_patron_inside_charge_limits();
is(
$patron_borrowing_status->{NoIssuesChargeGuarantorsWithGuarantees}->{limit}, 23,
"Limit correctly identified at patron category level"
);
is(
$patron_borrowing_status->{NoIssuesChargeGuarantorsWithGuarantees}->{charge}, 22.22,
"Charges correctly identified"
);
is(
$patron_borrowing_status->{NoIssuesChargeGuarantorsWithGuarantees}->{overlimit}, 0,
"Patron is inside the charge limit"
);
$patron->category->noissueschargeguarantorswithguarantees(undef);
$patron_borrowing_status = $patron->is_patron_inside_charge_limits();
is(
$patron_borrowing_status->{NoIssuesChargeGuarantorsWithGuarantees}->{limit}, 20,
"Limit correctly defaults to global syspref"
);
is(
$patron_borrowing_status->{NoIssuesChargeGuarantorsWithGuarantees}->{charge}, 22.22,
"Charges correctly identified"
);
is(
$patron_borrowing_status->{NoIssuesChargeGuarantorsWithGuarantees}->{overlimit}, 1,
"Patron is over the charge limit"
);
$schema->storage->txn_rollback;
};
subtest 'is_patron_inside_charge_limits - edge cases for empty string and zero' => sub {
plan tests => 14;
$schema->storage->txn_begin;
my $patron_category = $builder->build(
{
source => 'Category',
value => {
categorycode => 'TEST_CAT',
category_type => 'P',
enrolmentfee => 0,
noissuescharge => undef,
noissueschargeguarantees => undef,
noissueschargeguarantorswithguarantees => undef
}
}
);
my $patron = $builder->build_object(
{
class => 'Koha::Patrons',
value => { categorycode => $patron_category->{categorycode} }
}
);
my $child = $builder->build_object( { class => 'Koha::Patrons' } );
$child->add_guarantor( { guarantor_id => $patron->borrowernumber, relationship => 'parent' } );
# Add some charges to the child
my $fee = $builder->build_object(
{
class => 'Koha::Account::Lines',
value => {
borrowernumber => $child->borrowernumber,
amountoutstanding => 5.50,
debit_type_code => 'OVERDUE',
}
}
)->store;
# Test 1: Empty string values should be treated as "not set"
# Empty string is the default value in sysprefs for these preferences
t::lib::Mocks::mock_preference( 'NoIssuesChargeGuarantees', '' );
t::lib::Mocks::mock_preference( 'NoIssuesChargeGuarantorsWithGuarantees', '' );
my $patron_borrowing_status = $patron->is_patron_inside_charge_limits();
is(
$patron_borrowing_status->{NoIssuesChargeGuarantees}->{limit}, '',
"Empty string limit is preserved in return value"
);
is(
$patron_borrowing_status->{NoIssuesChargeGuarantees}->{charge}, 0,
"Charges should be 0 when limit is empty string (calculation skipped)"
);
is(
$patron_borrowing_status->{NoIssuesChargeGuarantees}->{overlimit}, 0,
"Patron should not be overlimit when preference is empty string"
);
is(
$patron_borrowing_status->{NoIssuesChargeGuarantorsWithGuarantees}->{limit}, '',
"Empty string limit is preserved for guarantors preference"
);
is(
$patron_borrowing_status->{NoIssuesChargeGuarantorsWithGuarantees}->{charge}, 0,
"Guarantors charges should be 0 when limit is empty string (calculation skipped)"
);
is(
$patron_borrowing_status->{NoIssuesChargeGuarantorsWithGuarantees}->{overlimit}, 0,
"Patron should not be overlimit when guarantors preference is empty string"
);
# Test 2: Zero values should trigger calculation but not block
t::lib::Mocks::mock_preference( 'NoIssuesChargeGuarantees', 0 );
t::lib::Mocks::mock_preference( 'NoIssuesChargeGuarantorsWithGuarantees', 0 );
$patron_borrowing_status = $patron->is_patron_inside_charge_limits();
is(
$patron_borrowing_status->{NoIssuesChargeGuarantees}->{limit}, 0,
"Zero limit is preserved in return value"
);
is(
$patron_borrowing_status->{NoIssuesChargeGuarantees}->{charge}, 5.50,
"Charges should be calculated when limit is 0 (valid number)"
);
is(
$patron_borrowing_status->{NoIssuesChargeGuarantees}->{overlimit}, 0,
"Patron should not be overlimit when limit is 0 (0 means no blocking)"
);
is(
$patron_borrowing_status->{NoIssuesChargeGuarantorsWithGuarantees}->{limit}, 0,
"Zero limit is preserved for guarantors preference"
);
# Note: This will be 5.50 because the child is included in guarantor debt calculation
ok(
$patron_borrowing_status->{NoIssuesChargeGuarantorsWithGuarantees}->{charge} > 0,
"Guarantors charges should be calculated when limit is 0 (valid number)"
);
is(
$patron_borrowing_status->{NoIssuesChargeGuarantorsWithGuarantees}->{overlimit}, 0,
"Patron should not be overlimit when guarantors limit is 0 (0 means no blocking)"
);
# Test 3: Verify that a small positive number triggers calculation and can block
t::lib::Mocks::mock_preference( 'NoIssuesChargeGuarantees', 5.00 );
$patron_borrowing_status = $patron->is_patron_inside_charge_limits();
is(
$patron_borrowing_status->{NoIssuesChargeGuarantees}->{charge}, 5.50,
"Charges are calculated with positive limit"
);
is(
$patron_borrowing_status->{NoIssuesChargeGuarantees}->{overlimit}, 1,
"Patron is correctly marked overlimit when charges exceed limit"
);
$schema->storage->txn_rollback;
};
subtest 'Scrub the note fields' => sub {
plan tests => 4;
$schema->storage->txn_begin;
my $bad_message = '<script>alert("booh!")</script><span>all</span><b>good</b>now';
my $cleaned_message = '<span>all</span><b>good</b>now';
my $tmp_patron = $builder->build_object( { class => 'Koha::Patrons' } );
my $patron_data = $tmp_patron->unblessed;
$tmp_patron->delete;
delete $tmp_patron->{borrowernumber};
my $patron = Koha::Patron->new(
{
%$patron_data,
borrowernotes => $bad_message, opacnote => $bad_message,
}
)->store;
is( $patron->get_from_storage->borrowernotes, $cleaned_message );
is( $patron->get_from_storage->opacnote, $cleaned_message );
$patron->borrowernotes($bad_message)->store;
$patron->opacnote($bad_message)->store;
is( $patron->get_from_storage->borrowernotes, $cleaned_message );
is( $patron->get_from_storage->opacnote, $cleaned_message );
$schema->storage->txn_rollback;
};
subtest 'preferred_name' => sub {
plan tests => 6;
$schema->storage->txn_begin;
my $tmp_patron = $builder->build_object( { class => 'Koha::Patrons' } );
my $patron_data = $tmp_patron->unblessed;
$tmp_patron->delete;
delete $patron_data->{borrowernumber};
delete $patron_data->{preferred_name};
my $patron = Koha::Patron->new(
{
%$patron_data,
}
)->store;
is( $patron->preferred_name, $patron->firstname, "Preferred name set to first name on creation when not defined" );
$patron->delete;
$patron_data->{preferred_name} = "";
$patron = Koha::Patron->new(
{
%$patron_data,
}
)->store;
is( $patron->preferred_name, $patron->firstname, "Preferred name set to first name on creation when empty string" );
$patron->delete;
$patron_data->{preferred_name} = "Preferred";
$patron_data->{firstname} = "Not Preferred";
$patron = Koha::Patron->new(
{
%$patron_data,
}
)->store;
is( $patron->preferred_name, "Preferred", "Preferred name set when passed on creation" );
$patron->preferred_name("")->store;
is( $patron->preferred_name, $patron->firstname, "Preferred name set to first name on update when empty string" );
$patron->preferred_name(undef)->store();
is( $patron->preferred_name, $patron->firstname, "Preferred name set to first name on update when undef" );
$patron->preferred_name("Preferred again")->store();
is( $patron->preferred_name, "Preferred again", "Preferred name set on update when passed" );
};
subtest 'ill_requests() tests' => sub {
plan tests => 3;
$schema->storage->txn_begin;
my $patron = $builder->build_object( { class => 'Koha::Patrons' } );
my $reqs_rs = $patron->ill_requests();
is( ref($reqs_rs), 'Koha::ILL::Requests', 'Returned object type is correct' );
is( $reqs_rs->count, 0, 'No linked ILL requests for the patron' );
# add two requests
$builder->build_object( { class => 'Koha::ILL::Requests', value => { borrowernumber => $patron->id } } );
$builder->build_object( { class => 'Koha::ILL::Requests', value => { borrowernumber => $patron->id } } );
$reqs_rs = $patron->ill_requests();
is( $reqs_rs->count, 2, 'Two linked ILL requests for the patron' );
$schema->storage->txn_rollback;
};
subtest 'can_place_holds() tests' => sub {
plan tests => 7;
subtest "'expired' tests" => sub {
plan tests => 4;
$schema->storage->txn_begin;
t::lib::Mocks::mock_preference( 'BlockExpiredPatronOpacActions', 'hold' );
my $patron = $builder->build_object(
{
class => 'Koha::Patrons',
value => { dateexpiry => \'DATE_ADD(NOW(), INTERVAL -1 DAY)' }
}
);
my $result = $patron->can_place_holds();
ok( !$result, 'expired, cannot place holds' );
my $messages = $result->messages();
is( $messages->[0]->type, 'error' );
is( $messages->[0]->message, 'expired' );
ok( $patron->can_place_holds( { overrides => { expired => 1 } } ), "Override works for 'expired'" );
$schema->storage->txn_rollback;
};
subtest "'debt_limit' tests" => sub {
plan tests => 7;
$schema->storage->txn_begin;
# Add a patron, making sure it is not (yet) expired
my $patron = $builder->build_object( { class => 'Koha::Patrons', } );
$patron->account->add_debit( { amount => 10, interface => 'opac', type => 'ACCOUNT' } );
t::lib::Mocks::mock_preference( 'maxoutstanding', undef );
ok( $patron->can_place_holds(), "No 'maxoutstanding', can place holds" );
t::lib::Mocks::mock_preference( 'maxoutstanding', '5' );
my $result = $patron->can_place_holds();
ok( !$result, 'debt, cannot place holds' );
my $messages = $result->messages();
is( $messages->[0]->type, 'error' );
is( $messages->[0]->message, 'debt_limit' );
is( $messages->[0]->payload->{total_outstanding}, 10 );
is( $messages->[0]->payload->{max_outstanding}, 5 );
ok( $patron->can_place_holds( { overrides => { debt_limit => 1 } } ), "Override works for 'debt_limit'" );
$schema->storage->txn_rollback;
};
subtest "'bad_address' tests" => sub {
plan tests => 4;
$schema->storage->txn_begin;
# Add a patron, making sure it is not (yet) expired
my $patron = $builder->build_object(
{
class => 'Koha::Patrons',
value => {
gonenoaddress => 1,
}
}
);
my $result = $patron->can_place_holds();
ok( !$result, 'flagged for bad address, cannot place holds' );
my $messages = $result->messages();
is( $messages->[0]->type, 'error' );
is( $messages->[0]->message, 'bad_address' );
ok( $patron->can_place_holds( { overrides => { bad_address => 1 } } ), "Override works for 'bad_address'" );
$schema->storage->txn_rollback;
};
subtest "'card_lost' tests" => sub {
plan tests => 4;
$schema->storage->txn_begin;
# Add a patron, making sure it is not (yet) expired
my $patron = $builder->build_object(
{
class => 'Koha::Patrons',
value => {
lost => 1,
}
}
);
my $result = $patron->can_place_holds();
ok( !$result, 'flagged for lost card, cannot place holds' );
my $messages = $result->messages();
is( $messages->[0]->type, 'error' );
is( $messages->[0]->message, 'card_lost' );
ok( $patron->can_place_holds( { overrides => { card_lost => 1 } } ), "Override works for 'card_lost'" );
$schema->storage->txn_rollback;
};
subtest "'restricted' tests" => sub {
plan tests => 4;
$schema->storage->txn_begin;
# Add a patron, making sure it is not (yet) expired
my $patron = $builder->build_object( { class => 'Koha::Patrons' } );
AddDebarment( { borrowernumber => $patron->borrowernumber } );
$patron->discard_changes();
my $result = $patron->can_place_holds();
ok( !$result, 'restricted, cannot place holds' );
my $messages = $result->messages();
is( $messages->[0]->type, 'error' );
is( $messages->[0]->message, 'restricted' );
ok( $patron->can_place_holds( { overrides => { restricted => 1 } } ), "Override works for 'restricted'" );
$schema->storage->txn_rollback;
};
subtest "'hold_limit' tests" => sub {
plan tests => 5;
$schema->storage->txn_begin;
# Add a patron, making sure it is not (yet) expired
my $patron = $builder->build_object( { class => 'Koha::Patrons' } );
# Add a hold
$builder->build_object( { class => 'Koha::Holds', value => { borrowernumber => $patron->borrowernumber } } );
t::lib::Mocks::mock_preference( 'maxreserves', undef );
ok( $patron->can_place_holds(), "No 'maxreserves', can place holds" );
t::lib::Mocks::mock_preference( 'maxreserves', 1 );
my $result = $patron->can_place_holds();
ok( !$result, 'hold limit reached, cannot place holds' );
my $messages = $result->messages();
is( $messages->[0]->type, 'error' );
is( $messages->[0]->message, 'hold_limit' );
ok( $patron->can_place_holds( { overrides => { hold_limit => 1 } } ), "Override works for 'hold_limit'" );
$schema->storage->txn_rollback;
};
subtest "'no_short_circuit' tests" => sub {
plan tests => 9;
$schema->storage->txn_begin;
# Create a patron with multiple issues
my $patron = $builder->build_object(
{
class => 'Koha::Patrons',
value => {
dateexpiry => \'DATE_ADD(NOW(), INTERVAL -1 DAY)', # expired
gonenoaddress => 1, # bad address
lost => 1, # card lost
}
}
);
# Add debt
$patron->account->add_debit( { amount => 10, interface => 'opac', type => 'ACCOUNT' } );
# Add restriction
AddDebarment( { borrowernumber => $patron->borrowernumber } );
$patron->discard_changes();
# Mock preferences
t::lib::Mocks::mock_preference( 'BlockExpiredPatronOpacActions', 'hold' );
t::lib::Mocks::mock_preference( 'maxoutstanding', '5' );
# Test short-circuit behavior (default)
my $result = $patron->can_place_holds();
ok( !$result, 'patron cannot place holds' );
my $messages = $result->messages();
is( scalar @$messages, 1, 'short-circuit: only one error message returned' );
# Test no_short_circuit behavior
$result = $patron->can_place_holds( { no_short_circuit => 1 } );
ok( !$result, 'patron still cannot place holds with no_short_circuit' );
$messages = $result->messages();
is( scalar @$messages, 5, 'no_short_circuit: all error messages collected' );
# Verify we got all expected error types
my %message_types = map { $_->message => 1 } @$messages;
ok( $message_types{expired}, "'expired' error included" );
ok( $message_types{debt_limit}, "'debt_limit' error included" );
ok( $message_types{bad_address}, "'bad_address' error included" );
ok( $message_types{card_lost}, "'card_lost' error included" );
ok( $message_types{restricted}, "'restricted' error included" );
$schema->storage->txn_rollback;
};
};
subtest 'is_anonymous' => sub {
plan tests => 3;
$schema->storage->txn_begin;
t::lib::Mocks::mock_preference( 'AnonymousPatron', '' );
my $patron = $builder->build_object( { class => 'Koha::Patrons' } );
is( $patron->is_anonymous, 0, 'is_anonymous returns 0 if pref is empty' );
t::lib::Mocks::mock_preference( 'AnonymousPatron', $patron->borrowernumber );
is( $patron->is_anonymous, 1, q{is_anonymous returns 1 if pref is equal to patron's id} );
t::lib::Mocks::mock_preference( 'AnonymousPatron', $patron->borrowernumber + 1 );
is( $patron->is_anonymous, 0, q{is_anonymous returns 0 if pref is not equal to patron's id} );
$schema->storage->txn_rollback;
};
subtest 'has_2fa_enabled() tests' => sub {
plan tests => 3;
$schema->storage->txn_begin;
my $patron = $builder->build_object( { class => 'Koha::Patrons' } );
# Test patron without 2FA
is( $patron->has_2fa_enabled, 0, 'has_2fa_enabled returns 0 when no secret is set' );
# Test patron with empty secret
$patron->secret('')->store;
is( $patron->has_2fa_enabled, 0, 'has_2fa_enabled returns 0 when secret is empty string' );
# Test patron with 2FA enabled
$patron->secret('some_secret_value')->store;
is( $patron->has_2fa_enabled, 1, 'has_2fa_enabled returns 1 when secret is set' );
$schema->storage->txn_rollback;
};
subtest 'reset_2fa() tests' => sub {
plan tests => 6;
$schema->storage->txn_begin;
my $patron = $builder->build_object( { class => 'Koha::Patrons' } );
# Set up patron with 2FA enabled
$patron->set(
{
secret => 'test_secret_123',
auth_method => 'two-factor',
}
)->store;
# Verify 2FA is enabled
is( $patron->has_2fa_enabled, 1, '2FA is enabled before reset' );
is( $patron->auth_method, 'two-factor', 'auth_method is two-factor before reset' );
# Test reset_2fa method
my $result = $patron->reset_2fa;
# Verify method returns patron object for chaining
isa_ok( $result, 'Koha::Patron', 'reset_2fa returns Koha::Patron object' );
is( $result->borrowernumber, $patron->borrowernumber, 'returned object is the same patron' );
# Verify 2FA has been reset
$patron->discard_changes;
is( $patron->has_2fa_enabled, 0, '2FA is disabled after reset' );
is( $patron->auth_method, 'password', 'auth_method is password after reset' );
$schema->storage->txn_rollback;
};
subtest "create_hold_group, hold_groups tests" => sub {
plan tests => 16;
$schema->storage->txn_begin;
my $patron = $builder->build_object( { class => 'Koha::Patrons' } );
my $hold1 = $builder->build_object(
{
class => 'Koha::Holds',
value => { hold_group_id => undef, found => undef, borrowernumber => $patron->borrowernumber }
}
);
my $hold2 = $builder->build_object(
{
class => 'Koha::Holds',
value => { hold_group_id => undef, found => undef, borrowernumber => $patron->borrowernumber }
}
);
my $hold3 = $builder->build_object(
{
class => 'Koha::Holds',
value => { hold_group_id => undef, found => undef, borrowernumber => $patron->borrowernumber }
}
);
my $hold4 = $builder->build_object(
{
class => 'Koha::Holds',
value => { hold_group_id => undef, found => undef, borrowernumber => $patron->borrowernumber }
}
);
my $hold5 = $builder->build_object(
{
class => 'Koha::Holds',
value => { hold_group_id => undef, found => undef, borrowernumber => $patron->borrowernumber }
}
);
my $hold6 = $builder->build_object(
{
class => 'Koha::Holds',
value => { hold_group_id => undef, found => undef, borrowernumber => $patron->borrowernumber }
}
);
my $patron_hold_groups = $patron->hold_groups;
is( $patron_hold_groups->count, 0, 'Patron does not have any hold groups' );
# Create 1st hold group
$patron->create_hold_group( [ $hold1->reserve_id, $hold2->reserve_id, $hold3->reserve_id ] );
is( $patron_hold_groups->count, 1, 'Patron has one hold group' );
my $hold_group = $patron->hold_groups->as_list->[0];
is( $hold_group->hold_group_id, $hold1->get_from_storage->hold_group_id, 'hold1 added to hold_group' );
is( $hold_group->hold_group_id, $hold2->get_from_storage->hold_group_id, 'hold2 added to hold_group' );
is( $hold_group->hold_group_id, $hold3->get_from_storage->hold_group_id, 'hold3 added to hold_group' );
# Create 2nd hold group
my $hg_to_be_kept = $patron->create_hold_group( [ $hold4->reserve_id, $hold5->reserve_id ] );
is( $patron_hold_groups->count, 2, 'Patron has two hold groups' );
my $second_hold_group = $patron->hold_groups->as_list->[1];
is(
$second_hold_group->hold_group_id, $hold4->get_from_storage->hold_group_id,
'hold4 added to second hold_group'
);
is(
$second_hold_group->hold_group_id, $hold5->get_from_storage->hold_group_id,
'hold5 added to second hold_group'
);
$hold3->get_from_storage->fill();
is( $patron->get_from_storage->hold_groups->count, 1, 'Patron only has one active hold group' );
is(
$patron->get_from_storage->hold_groups->next->hold_group_id, $hg_to_be_kept->hold_group_id,
'Patron only has one active hold group. The 2nd created'
);
$hold4->get_from_storage->cancel();
is( $patron->get_from_storage->hold_groups->count, 1, 'Patron only has one active hold group' );
is(
$patron->get_from_storage->hold_groups->next->hold_group_id, $hg_to_be_kept->hold_group_id,
'Patron only has one active hold group. The 2nd created. It was kept because one hold was cancelled and one hold remains.'
);
# Create 3rd hold group
$patron->create_hold_group( [ $hold5->reserve_id, $hold6->reserve_id ], 1 );
t::lib::Mocks::mock_preference( 'HoldsLog', 1 );
my $new_hg = $patron->create_hold_group( [ $hold6->reserve_id, $hold5->reserve_id ], 1 );
my $hg_id = $new_hg->hold_group_id;
my $create_log = $schema->resultset('ActionLog')->search(
{
module => 'HOLDS',
action => 'MODIFY',
object => $hold6->reserve_id,
},
{ order_by => { -desc => 'action_id' } }
)->first;
ok( $create_log, 'Log entry created for hold when added to a new group' );
like( $create_log->info, qr/'hold_group_id' => $hg_id/, 'Log info contains hold_group_id change' );
$new_hg->delete;
my $delete_log = $schema->resultset('ActionLog')->search(
{
module => 'HOLDS',
action => 'MODIFY',
object => $hold6->reserve_id,
},
{ order_by => { -desc => 'action_id' } }
)->first;
ok( $delete_log, 'Log entry created for hold when group was deleted' );
like( $delete_log->info, qr/'hold_group_id' => undef/, 'Log shows the old group ID was removed' );
$schema->storage->txn_rollback;
};
subtest 'fixup_cardnumber and autoMemberNumValue counter' => sub {
plan tests => 10;
$schema->storage->txn_begin;
t::lib::Mocks::mock_preference( 'autoMemberNum', 1 );
my $pref_rs = $schema->resultset('Systempreference');
my $set_counter = sub {
my $value = shift;
my $row = $pref_rs->find('autoMemberNumValue');
if ($row) { $row->update( { value => $value } ) }
else { $pref_rs->create( { variable => 'autoMemberNumValue', value => $value } ) }
};
my $get_counter = sub {
my $row = $pref_rs->find('autoMemberNumValue');
return $row ? $row->value : undef;
};
my $category = $builder->build_object( { class => 'Koha::Patron::Categories' } );
my $library = $builder->build_object( { class => 'Koha::Libraries' } );
my $new_patron = sub {
return Koha::Patron->new(
{
surname => 'fixup-test',
categorycode => $category->categorycode,
branchcode => $library->branchcode,
cardnumber => undef,
}
);
};
# Anchor well above any existing fixture cardnumbers for deterministic assertions.
my $baseline = Koha::Patrons->search(
{ cardnumber => { -regexp => '^-?[0-9]+$' } },
{
select => \'CAST(cardnumber AS SIGNED)',
as => ['m'],
}
)->_resultset->get_column('m')->max
|| 0;
my $start = $baseline + 1_000;
$set_counter->($start);
my $p1 = $new_patron->()->store;
is( $p1->cardnumber + 0, $start + 1, 'First auto-generated cardnumber is counter + 1' );
is( $get_counter->() + 0, $start + 1, 'Counter persisted after auto-generation' );
# The bug fix: renaming a patron's cardnumber must not free the old number.
my $original = $p1->cardnumber;
$p1->cardnumber('MANUAL-XYZ')->store;
my $p2 = $new_patron->()->store;
isnt( $p2->cardnumber, $original, q{Original auto-generated number not reused after rename} );
is( $p2->cardnumber + 0, $start + 2, 'Next patron uses counter + 1, skipping the freed slot' );
# Deleting a patron must not free their cardnumber either.
my $p2_cardnumber = $p2->cardnumber;
$p2->delete;
my $p3 = $new_patron->()->store;
isnt( $p3->cardnumber, $p2_cardnumber, q{Deleted patron's cardnumber not reused} );
# Counter ahead of DB max: counter wins.
$set_counter->( $start + 1_000_000 );
my $p4 = $new_patron->()->store;
is( $p4->cardnumber + 0, $start + 1_000_001, 'Counter ahead of DB max wins' );
# DB max ahead of counter (e.g. admin imported high numbers directly): DB max wins.
my $high = $start + 2_000_000;
$set_counter->(5);
Koha::Patron->new(
{
surname => 'manual-high',
categorycode => $category->categorycode,
branchcode => $library->branchcode,
cardnumber => "$high",
}
)->store;
my $p5 = $new_patron->()->store;
is( $p5->cardnumber + 0, $high + 1, 'DB max ahead of counter wins' );
is( $get_counter->() + 0, $high + 1, 'Counter catches up to DB max + 1' );
# Pre-upgrade fallback: syspref row absent -> behaves like pre-34000 code.
$pref_rs->find('autoMemberNumValue')->delete;
my $p6 = $new_patron->()->store;
is( $p6->cardnumber + 0, $high + 2, 'Legacy fallback when syspref row is absent' );
is(
$pref_rs->find('autoMemberNumValue'), undef,
'Syspref row stays absent when fallback path is taken'
);
$schema->storage->txn_rollback;
};
subtest "is_eligible_for_self_renewal" => sub {
plan tests => 8;
$schema->storage->txn_begin;
my $category = $builder->build_object(
{
class => 'Koha::Patron::Categories',
value => {
self_renewal_enabled => 0, self_renewal_availability_start => 10, self_renewal_if_expired => 10,
self_renewal_fines_block => 10, noissuescharge => 10
}
}
);
my $patron = $builder->build_object(
{
class => 'Koha::Patrons',
value => { categorycode => $category->categorycode, dateexpiry => dt_from_string(), debarred => undef }
}
);
is( $patron->is_eligible_for_self_renewal, 0, "Category not enabled" );
$category->self_renewal_enabled(1)->store();
$patron->delete()->store()->discard_changes();
is( $patron->is_eligible_for_self_renewal, 1, "Category now enabled" );
$patron->debarred('2026-01-01')->store;
is( $patron->is_eligible_for_self_renewal, 0, "Patron debarred" );
$patron->debarred(undef)->store;
$patron->delete()->store()->discard_changes();
# Move expiry date outside the window
$patron->dateexpiry( dt_from_string()->add( days => 11 ) )->store;
is( $patron->is_eligible_for_self_renewal, 0, "Patron not yet within the expiry window" );
# Shift the expiry window to cover new expiry date
$category->self_renewal_availability_start(12)->store();
$patron->delete()->store()->discard_changes();
is( $patron->is_eligible_for_self_renewal, 1, "Patron is back within the expiry window" );
# Shift the date to now already be expired
$patron->dateexpiry( dt_from_string()->subtract( days => 11 ) )->store;
is( $patron->is_eligible_for_self_renewal, 0, "Patron can only self renew within 10 days of expiry" );
# Expand the expiry window
$category->self_renewal_if_expired(12)->store();
$patron->delete()->store()->discard_changes();
is( $patron->is_eligible_for_self_renewal, 1, "Patron is back within the expiry window" );
t::lib::Mocks::mock_preference( 'noissuescharge', 10 );
my $fee1 = $builder->build_object(
{
class => 'Koha::Account::Lines',
value => {
borrowernumber => $patron->borrowernumber,
amountoutstanding => 11,
debit_type_code => 'OVERDUE',
}
}
)->store;
is( $patron->is_eligible_for_self_renewal, 0, "Patron is outside the charge limits" );
$schema->storage->txn_rollback;
};
subtest "request_modification" => sub {
plan tests => 5;
$schema->storage->txn_begin;
my $patron = $builder->build_object(
{
class => 'Koha::Patrons',
}
);
my $modification_data = { firstname => 'Newname', changed_fields => 'firstname' };
t::lib::Mocks::mock_preference( 'OPACPatronDetails', 1 );
t::lib::Mocks::mock_preference( 'AutoApprovePatronProfileSettings', 0 );
$patron->request_modification($modification_data);
my @modifications = Koha::Patron::Modifications->search( { borrowernumber => $patron->borrowernumber } )->as_list;
is( scalar(@modifications), 1, "New modification has replaced any existing mods" );
my $modification = $modifications[0];
is( $modification->changed_fields, 'firstname', 'Fields correctly set' );
is( $modification->firstname, $modification_data->{firstname}, 'Fields correctly set' );
t::lib::Mocks::mock_preference( 'AutoApprovePatronProfileSettings', 1 );
$patron->request_modification($modification_data);
@modifications = Koha::Patron::Modifications->search( { borrowernumber => $patron->borrowernumber } )->as_list;
is( scalar(@modifications), 0, "New modification has been approved and deleted" );
is( $patron->discard_changes()->firstname, $modification_data->{firstname}, 'Name updated' );
$schema->storage->txn_rollback;
};
subtest "create_expiry_notice_parameters" => sub {
plan tests => 1;
$schema->storage->txn_begin;
my $library = $builder->build_object( { class => 'Koha::Libraries' } );
my $patron = $builder->build_object(
{
class => 'Koha::Patrons',
value => { branchcode => $library->branchcode }
}
);
my $expected_return = {
'letter_params' => {
'borrowernumber' => $patron->borrowernumber,
'branchcode' => $library->branchcode,
'tables' => {
'borrowers' => $patron->borrowernumber,
'branches' => $library->branchcode
},
'module' => 'members',
'letter_code' => 'MEMBERSHIP_RENEWED',
'lang' => $patron->lang
},
'message_name' => 'Patron_Expiry',
'forceprint' => 0
};
my $letter_params = $patron->create_expiry_notice_parameters(
{ letter_code => 'MEMBERSHIP_RENEWED', forceprint => 0, is_notice_mandatory => 0 } );
is_deeply( $letter_params, $expected_return, 'Letter params generated correctly' );
$schema->storage->txn_rollback;
};
subtest "identify_updated_extended_attributes" => sub {
plan tests => 2;
$schema->storage->txn_begin;
my $patron = $builder->build_object(
{
class => 'Koha::Patrons',
}
);
my $unique_attribute_type = $builder->build_object(
{
class => 'Koha::Patron::Attribute::Types',
value => {
unique_id => 1,
repeatable => 0,
is_date => 0,
opac_editable => 1
}
}
);
my $repeatable_attribute_type = $builder->build_object(
{
class => 'Koha::Patron::Attribute::Types',
value => {
unique_id => 0,
repeatable => 1,
is_date => 0,
opac_editable => 1
}
}
);
my $normal_attribute_type = $builder->build_object(
{
class => 'Koha::Patron::Attribute::Types',
value => {
unique_id => 0,
repeatable => 0,
is_date => 0,
opac_editable => 1
}
}
);
my $attributes = [
{
attribute => 'my unique attribute 1',
code => $unique_attribute_type->code(),
},
{
attribute => 'my repeatable attribute 1',
code => $repeatable_attribute_type->code(),
},
{
attribute => 'my normal attribute 1',
code => $normal_attribute_type->code(),
}
];
$patron->extended_attributes($attributes);
my $changed_attributes = [
{
attribute => 'this is new',
code => $unique_attribute_type->code(),
},
{
attribute => 'my repeatable attribute 1',
code => $repeatable_attribute_type->code(),
},
{
attribute => 'my normal attribute 1',
code => $normal_attribute_type->code(),
}
];
my $updated_attributes = $patron->identify_updated_extended_attributes($changed_attributes);
is( scalar(@$updated_attributes), 1, "Only the first one was changed" );
$attributes = [
{
attribute => 'my unique attribute 1',
code => $unique_attribute_type->code(),
},
{
attribute => 'my repeatable attribute 1',
code => $repeatable_attribute_type->code(),
},
{
attribute => 'my repeatable attribute 2',
code => $repeatable_attribute_type->code(),
},
{
attribute => 'my normal attribute 1',
code => $normal_attribute_type->code(),
}
];
$patron->extended_attributes($attributes);
$changed_attributes = [
{
attribute => 'this is new',
code => $unique_attribute_type->code(),
},
{
attribute => 'this repeatable one is also new',
code => $repeatable_attribute_type->code(),
},
{
attribute => 'my repeatable attribute 2',
code => $repeatable_attribute_type->code(),
},
{
attribute => 'my normal attribute 1',
code => $normal_attribute_type->code(),
}
];
$updated_attributes = $patron->identify_updated_extended_attributes($changed_attributes);
is( scalar(@$updated_attributes), 3, "Two have now been updated, one of which is repeatable and has two values" );
$schema->storage->txn_rollback;
};