3 # Copyright 2015 Koha Development team
5 # This file is part of Koha
7 # Koha is free software; you can redistribute it and/or modify it
8 # under the terms of the GNU General Public License as published by
9 # the Free Software Foundation; either version 3 of the License, or
10 # (at your option) any later version.
12 # Koha is distributed in the hope that it will be useful, but
13 # WITHOUT ANY WARRANTY; without even the implied warranty of
14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 # GNU General Public License for more details.
17 # You should have received a copy of the GNU General Public License
18 # along with Koha; if not, see <http://www.gnu.org/licenses>.
22 use Test::More tests => 33;
31 use C4::Auth qw(checkpw_hash);
35 use Koha::Patron::Categories;
38 use Koha::Virtualshelves;
40 use t::lib::TestBuilder;
43 my $schema = Koha::Database->new->schema;
44 $schema->storage->txn_begin;
46 my $builder = t::lib::TestBuilder->new;
47 my $library = $builder->build({source => 'Branch' });
48 my $category = $builder->build({source => 'Category' });
49 my $nb_of_patrons = Koha::Patrons->search->count;
50 my $new_patron_1 = Koha::Patron->new(
51 { cardnumber => 'test_cn_1',
52 branchcode => $library->{branchcode},
53 categorycode => $category->{categorycode},
54 surname => 'surname for patron1',
55 firstname => 'firstname for patron1',
56 userid => 'a_nonexistent_userid_1',
57 flags => 1, # Is superlibrarian
60 my $new_patron_2 = Koha::Patron->new(
61 { cardnumber => 'test_cn_2',
62 branchcode => $library->{branchcode},
63 categorycode => $category->{categorycode},
64 surname => 'surname for patron2',
65 firstname => 'firstname for patron2',
66 userid => 'a_nonexistent_userid_2',
70 C4::Context->_new_userenv('xxx');
71 set_logged_in_user( $new_patron_1 );
73 is( Koha::Patrons->search->count, $nb_of_patrons + 2, 'The 2 patrons should have been added' );
75 my $retrieved_patron_1 = Koha::Patrons->find( $new_patron_1->borrowernumber );
76 is( $retrieved_patron_1->cardnumber, $new_patron_1->cardnumber, 'Find a patron by borrowernumber should return the correct patron' );
78 subtest 'library' => sub {
80 is( $retrieved_patron_1->library->branchcode, $library->{branchcode}, 'Koha::Patron->library should return the correct library' );
81 is( ref($retrieved_patron_1->library), 'Koha::Library', 'Koha::Patron->library should return a Koha::Library object' );
84 subtest 'guarantees' => sub {
86 my $guarantees = $new_patron_1->guarantees;
87 is( ref($guarantees), 'Koha::Patrons', 'Koha::Patron->guarantees should return a Koha::Patrons result set in a scalar context' );
88 is( $guarantees->count, 0, 'new_patron_1 should have 0 guarantee' );
89 my @guarantees = $new_patron_1->guarantees;
90 is( ref(\@guarantees), 'ARRAY', 'Koha::Patron->guarantees should return an array in a list context' );
91 is( scalar(@guarantees), 0, 'new_patron_1 should have 0 guarantee' );
93 my $guarantee_1 = $builder->build({ source => 'Borrower', value => { guarantorid => $new_patron_1->borrowernumber }});
94 my $guarantee_2 = $builder->build({ source => 'Borrower', value => { guarantorid => $new_patron_1->borrowernumber }});
96 $guarantees = $new_patron_1->guarantees;
97 is( ref($guarantees), 'Koha::Patrons', 'Koha::Patron->guarantees should return a Koha::Patrons result set in a scalar context' );
98 is( $guarantees->count, 2, 'new_patron_1 should have 2 guarantees' );
99 @guarantees = $new_patron_1->guarantees;
100 is( ref(\@guarantees), 'ARRAY', 'Koha::Patron->guarantees should return an array in a list context' );
101 is( scalar(@guarantees), 2, 'new_patron_1 should have 2 guarantees' );
102 $_->delete for @guarantees;
104 #Test return order of guarantees BZ 18635
105 my $categorycode = $builder->build({ source => 'Category' })->{categorycode};
106 my $branchcode = $builder->build({ source => 'Branch' })->{branchcode};
108 my $guarantor = $builder->build_object( { class => 'Koha::Patrons' } );
110 my $order_guarantee1 = $builder->build_object( { class => 'Koha::Patrons' , value => {
112 guarantorid => $guarantor->borrowernumber
116 my $order_guarantee2 = $builder->build_object( { class => 'Koha::Patrons' , value => {
118 guarantorid => $guarantor->borrowernumber
122 my $order_guarantee3 = $builder->build_object( { class => 'Koha::Patrons' , value => {
124 firstname => 'Walrus',
125 guarantorid => $guarantor->borrowernumber
129 my $order_guarantee4 = $builder->build_object( { class => 'Koha::Patrons' , value => {
131 firstname => 'Vulture',
132 guarantorid => $guarantor->borrowernumber
136 my $order_guarantee5 = $builder->build_object( { class => 'Koha::Patrons' , value => {
138 firstname => 'Unicorn',
139 guarantorid => $guarantor->borrowernumber
143 $guarantees = $guarantor->guarantees();
145 is( $guarantees->next()->borrowernumber, $order_guarantee5, "Return first guarantor alphabetically" );
146 is( $guarantees->next()->borrowernumber, $order_guarantee4, "Return second guarantor alphabetically" );
147 is( $guarantees->next()->borrowernumber, $order_guarantee3, "Return third guarantor alphabetically" );
148 is( $guarantees->next()->borrowernumber, $order_guarantee2, "Return fourth guarantor alphabetically" );
149 is( $guarantees->next()->borrowernumber, $order_guarantee1, "Return fifth guarantor alphabetically" );
152 subtest 'category' => sub {
154 my $patron_category = $new_patron_1->category;
155 is( ref( $patron_category), 'Koha::Patron::Category', );
156 is( $patron_category->categorycode, $category->{categorycode}, );
159 subtest 'siblings' => sub {
161 my $siblings = $new_patron_1->siblings;
162 is( $siblings, undef, 'Koha::Patron->siblings should not crashed if the patron has no guarantor' );
163 my $guarantee_1 = $builder->build( { source => 'Borrower', value => { guarantorid => $new_patron_1->borrowernumber } } );
164 my $retrieved_guarantee_1 = Koha::Patrons->find($guarantee_1);
165 $siblings = $retrieved_guarantee_1->siblings;
166 is( ref($siblings), 'Koha::Patrons', 'Koha::Patron->siblings should return a Koha::Patrons result set in a scalar context' );
167 my @siblings = $retrieved_guarantee_1->siblings;
168 is( ref( \@siblings ), 'ARRAY', 'Koha::Patron->siblings should return an array in a list context' );
169 is( $siblings->count, 0, 'guarantee_1 should not have siblings yet' );
170 my $guarantee_2 = $builder->build( { source => 'Borrower', value => { guarantorid => $new_patron_1->borrowernumber } } );
171 my $guarantee_3 = $builder->build( { source => 'Borrower', value => { guarantorid => $new_patron_1->borrowernumber } } );
172 $siblings = $retrieved_guarantee_1->siblings;
173 is( $siblings->count, 2, 'guarantee_1 should have 2 siblings' );
174 is( $guarantee_2->{borrowernumber}, $siblings->next->borrowernumber, 'guarantee_2 should exist in the guarantees' );
175 is( $guarantee_3->{borrowernumber}, $siblings->next->borrowernumber, 'guarantee_3 should exist in the guarantees' );
176 $_->delete for $retrieved_guarantee_1->siblings;
177 $retrieved_guarantee_1->delete;
180 subtest 'has_overdues' => sub {
183 my $biblioitem_1 = $builder->build( { source => 'Biblioitem' } );
184 my $item_1 = $builder->build(
187 homebranch => $library->{branchcode},
188 holdingbranch => $library->{branchcode},
192 biblionumber => $biblioitem_1->{biblionumber}
196 my $retrieved_patron = Koha::Patrons->find( $new_patron_1->borrowernumber );
197 is( $retrieved_patron->has_overdues, 0, );
199 my $tomorrow = DateTime->today( time_zone => C4::Context->tz() )->add( days => 1 );
200 my $issue = Koha::Checkout->new({ borrowernumber => $new_patron_1->id, itemnumber => $item_1->{itemnumber}, date_due => $tomorrow, branchcode => $library->{branchcode} })->store();
201 is( $retrieved_patron->has_overdues, 0, );
203 my $yesterday = DateTime->today(time_zone => C4::Context->tz())->add( days => -1 );
204 $issue = Koha::Checkout->new({ borrowernumber => $new_patron_1->id, itemnumber => $item_1->{itemnumber}, date_due => $yesterday, branchcode => $library->{branchcode} })->store();
205 $retrieved_patron = Koha::Patrons->find( $new_patron_1->borrowernumber );
206 is( $retrieved_patron->has_overdues, 1, );
210 subtest 'update_password' => sub {
213 t::lib::Mocks::mock_preference( 'BorrowersLog', 1 );
214 my $original_userid = $new_patron_1->userid;
215 my $original_password = $new_patron_1->password;
216 warning_like { $retrieved_patron_1->update_password( $new_patron_2->userid, 'another_password' ) }
218 'Koha::Patron->update_password should warn if the userid is already used by another patron';
219 is( Koha::Patrons->find( $new_patron_1->borrowernumber )->userid, $original_userid, 'Koha::Patron->update_password should not have updated the userid' );
220 is( Koha::Patrons->find( $new_patron_1->borrowernumber )->password, $original_password, 'Koha::Patron->update_password should not have updated the userid' );
222 my $digest = $retrieved_patron_1->update_password( 'another_nonexistent_userid_1', 'another_password' );
223 is( Koha::Patrons->find( $new_patron_1->borrowernumber )->userid, 'another_nonexistent_userid_1', 'Koha::Patron->update_password should have updated the userid' );
224 is( Koha::Patrons->find( $new_patron_1->borrowernumber )->password, $digest, 'Koha::Patron->update_password should have updated the password' );
226 my $number_of_logs = $schema->resultset('ActionLog')->search( { module => 'MEMBERS', action => 'CHANGE PASS', object => $new_patron_1->borrowernumber } )->count;
227 is( $number_of_logs, 1, 'With BorrowerLogs, Koha::Patron->update_password should have logged' );
229 t::lib::Mocks::mock_preference( 'BorrowersLog', 0 );
230 $retrieved_patron_1->update_password( 'yet_another_nonexistent_userid_1', 'another_password' );
231 $number_of_logs = $schema->resultset('ActionLog')->search( { module => 'MEMBERS', action => 'CHANGE PASS', object => $new_patron_1->borrowernumber } )->count;
232 is( $number_of_logs, 1, 'With BorrowerLogs, Koha::Patron->update_password should not have logged' );
235 subtest 'is_expired' => sub {
237 my $patron = $builder->build({ source => 'Borrower' });
238 $patron = Koha::Patrons->find( $patron->{borrowernumber} );
239 $patron->dateexpiry( undef )->store->discard_changes;
240 is( $patron->is_expired, 0, 'Patron should not be considered expired if dateexpiry is not set');
241 $patron->dateexpiry( dt_from_string )->store->discard_changes;
242 is( $patron->is_expired, 0, 'Patron should not be considered expired if dateexpiry is today');
243 $patron->dateexpiry( dt_from_string->add( days => 1 ) )->store->discard_changes;
244 is( $patron->is_expired, 0, 'Patron should not be considered expired if dateexpiry is tomorrow');
245 $patron->dateexpiry( dt_from_string->add( days => -1 ) )->store->discard_changes;
246 is( $patron->is_expired, 1, 'Patron should be considered expired if dateexpiry is yesterday');
251 subtest 'is_going_to_expire' => sub {
253 my $patron = $builder->build({ source => 'Borrower' });
254 $patron = Koha::Patrons->find( $patron->{borrowernumber} );
255 $patron->dateexpiry( undef )->store->discard_changes;
256 is( $patron->is_going_to_expire, 0, 'Patron should not be considered going to expire if dateexpiry is not set');
258 t::lib::Mocks::mock_preference('NotifyBorrowerDeparture', 0);
259 $patron->dateexpiry( dt_from_string )->store->discard_changes;
260 is( $patron->is_going_to_expire, 0, 'Patron should not be considered going to expire if dateexpiry is today');
262 $patron->dateexpiry( dt_from_string )->store->discard_changes;
263 is( $patron->is_going_to_expire, 0, 'Patron should not be considered going to expire if dateexpiry is today and pref is 0');
265 t::lib::Mocks::mock_preference('NotifyBorrowerDeparture', 10);
266 $patron->dateexpiry( dt_from_string->add( days => 11 ) )->store->discard_changes;
267 is( $patron->is_going_to_expire, 0, 'Patron should not be considered going to expire if dateexpiry is 11 days ahead and pref is 10');
269 t::lib::Mocks::mock_preference('NotifyBorrowerDeparture', 0);
270 $patron->dateexpiry( dt_from_string->add( days => 10 ) )->store->discard_changes;
271 is( $patron->is_going_to_expire, 0, 'Patron should not be considered going to expire if dateexpiry is 10 days ahead and pref is 0');
273 t::lib::Mocks::mock_preference('NotifyBorrowerDeparture', 10);
274 $patron->dateexpiry( dt_from_string->add( days => 10 ) )->store->discard_changes;
275 is( $patron->is_going_to_expire, 0, 'Patron should not be considered going to expire if dateexpiry is 10 days ahead and pref is 10');
278 t::lib::Mocks::mock_preference('NotifyBorrowerDeparture', 10);
279 $patron->dateexpiry( dt_from_string->add( days => 20 ) )->store->discard_changes;
280 is( $patron->is_going_to_expire, 0, 'Patron should not be considered going to expire if dateexpiry is 20 days ahead and pref is 10');
282 t::lib::Mocks::mock_preference('NotifyBorrowerDeparture', 20);
283 $patron->dateexpiry( dt_from_string->add( days => 10 ) )->store->discard_changes;
284 is( $patron->is_going_to_expire, 1, 'Patron should be considered going to expire if dateexpiry is 10 days ahead and pref is 20');
290 subtest 'renew_account' => sub {
293 for my $date ( '2016-03-31', '2016-11-30', dt_from_string() ) {
294 my $dt = dt_from_string( $date, 'iso' );
295 Time::Fake->offset( $dt->epoch );
296 my $a_month_ago = $dt->clone->subtract( months => 1, end_of_month => 'limit' )->truncate( to => 'day' );
297 my $a_year_later = $dt->clone->add( months => 12, end_of_month => 'limit' )->truncate( to => 'day' );
298 my $a_year_later_minus_a_month = $dt->clone->add( months => 11, end_of_month => 'limit' )->truncate( to => 'day' );
299 my $a_month_later = $dt->clone->add( months => 1 , end_of_month => 'limit' )->truncate( to => 'day' );
300 my $a_year_later_plus_a_month = $dt->clone->add( months => 13, end_of_month => 'limit' )->truncate( to => 'day' );
301 my $patron_category = $builder->build(
302 { source => 'Category',
304 enrolmentperiod => 12,
305 enrolmentperioddate => undef,
309 my $patron = $builder->build(
310 { source => 'Borrower',
312 dateexpiry => $a_month_ago,
313 categorycode => $patron_category->{categorycode},
314 date_renewed => undef, # Force builder to not populate the column for new patron
318 my $patron_2 = $builder->build(
319 { source => 'Borrower',
321 dateexpiry => $a_month_ago,
322 categorycode => $patron_category->{categorycode},
326 my $patron_3 = $builder->build(
327 { source => 'Borrower',
329 dateexpiry => $a_month_later,
330 categorycode => $patron_category->{categorycode},
334 my $retrieved_patron = Koha::Patrons->find( $patron->{borrowernumber} );
335 my $retrieved_patron_2 = Koha::Patrons->find( $patron_2->{borrowernumber} );
336 my $retrieved_patron_3 = Koha::Patrons->find( $patron_3->{borrowernumber} );
338 is( $retrieved_patron->date_renewed, undef, "Date renewed is not set for patrons that have never been renewed" );
340 t::lib::Mocks::mock_preference( 'BorrowerRenewalPeriodBase', 'dateexpiry' );
341 t::lib::Mocks::mock_preference( 'BorrowersLog', 1 );
342 my $expiry_date = $retrieved_patron->renew_account;
343 is( $expiry_date, $a_year_later_minus_a_month, "$a_month_ago + 12 months must be $a_year_later_minus_a_month" );
344 my $retrieved_expiry_date = Koha::Patrons->find( $patron->{borrowernumber} )->dateexpiry;
345 is( dt_from_string($retrieved_expiry_date), $a_year_later_minus_a_month, "$a_month_ago + 12 months must be $a_year_later_minus_a_month" );
346 my $number_of_logs = $schema->resultset('ActionLog')->search( { module => 'MEMBERS', action => 'RENEW', object => $retrieved_patron->borrowernumber } )->count;
347 is( $number_of_logs, 1, 'With BorrowerLogs, Koha::Patron->renew_account should have logged' );
349 t::lib::Mocks::mock_preference( 'BorrowerRenewalPeriodBase', 'now' );
350 t::lib::Mocks::mock_preference( 'BorrowersLog', 0 );
351 $expiry_date = $retrieved_patron->renew_account;
352 is( $expiry_date, $a_year_later, "today + 12 months must be $a_year_later" );
353 $retrieved_patron = Koha::Patrons->find( $patron->{borrowernumber} );
354 is( $retrieved_patron->date_renewed, output_pref({ dt => $dt, dateformat => 'iso', dateonly => 1 }), "Date renewed is set when calling renew_account" );
355 $retrieved_expiry_date = $retrieved_patron->dateexpiry;
356 is( dt_from_string($retrieved_expiry_date), $a_year_later, "today + 12 months must be $a_year_later" );
357 $number_of_logs = $schema->resultset('ActionLog')->search( { module => 'MEMBERS', action => 'RENEW', object => $retrieved_patron->borrowernumber } )->count;
358 is( $number_of_logs, 1, 'Without BorrowerLogs, Koha::Patron->renew_account should not have logged' );
360 t::lib::Mocks::mock_preference( 'BorrowerRenewalPeriodBase', 'combination' );
361 $expiry_date = $retrieved_patron_2->renew_account;
362 is( $expiry_date, $a_year_later, "today + 12 months must be $a_year_later" );
363 $retrieved_expiry_date = Koha::Patrons->find( $patron_2->{borrowernumber} )->dateexpiry;
364 is( dt_from_string($retrieved_expiry_date), $a_year_later, "today + 12 months must be $a_year_later" );
366 $expiry_date = $retrieved_patron_3->renew_account;
367 is( $expiry_date, $a_year_later_plus_a_month, "$a_month_later + 12 months must be $a_year_later_plus_a_month" );
368 $retrieved_expiry_date = Koha::Patrons->find( $patron_3->{borrowernumber} )->dateexpiry;
369 is( dt_from_string($retrieved_expiry_date), $a_year_later_plus_a_month, "$a_month_later + 12 months must be $a_year_later_plus_a_month" );
371 $retrieved_patron->delete;
372 $retrieved_patron_2->delete;
373 $retrieved_patron_3->delete;
378 subtest "move_to_deleted" => sub {
380 my $originally_updated_on = '2016-01-01 12:12:12';
381 my $patron = $builder->build( { source => 'Borrower',value => { updated_on => $originally_updated_on } } );
382 my $retrieved_patron = Koha::Patrons->find( $patron->{borrowernumber} );
383 is( ref( $retrieved_patron->move_to_deleted ), 'Koha::Schema::Result::Deletedborrower', 'Koha::Patron->move_to_deleted should return the Deleted patron' )
384 ; # FIXME This should be Koha::Deleted::Patron
385 my $deleted_patron = $schema->resultset('Deletedborrower')
386 ->search( { borrowernumber => $patron->{borrowernumber} }, { result_class => 'DBIx::Class::ResultClass::HashRefInflator' } )
388 ok( $retrieved_patron->updated_on, 'updated_on should be set for borrowers table' );
389 ok( $deleted_patron->{updated_on}, 'updated_on should be set for deleted_borrowers table' );
390 isnt( $deleted_patron->{updated_on}, $retrieved_patron->updated_on, 'Koha::Patron->move_to_deleted should have correctly updated the updated_on column');
391 $deleted_patron->{updated_on} = $originally_updated_on; #reset for simplicity in comparing all other fields
392 is_deeply( $deleted_patron, $patron, 'Koha::Patron->move_to_deleted should have correctly moved the patron to the deleted table' );
393 $retrieved_patron->delete( $patron->{borrowernumber} ); # Cleanup
396 subtest "delete" => sub {
398 t::lib::Mocks::mock_preference( 'BorrowersLog', 1 );
399 my $patron = $builder->build( { source => 'Borrower' } );
400 my $retrieved_patron = Koha::Patrons->find( $patron->{borrowernumber} );
401 my $hold = $builder->build(
402 { source => 'Reserve',
403 value => { borrowernumber => $patron->{borrowernumber} }
406 my $list = $builder->build(
407 { source => 'Virtualshelve',
408 value => { owner => $patron->{borrowernumber} }
412 my $deleted = $retrieved_patron->delete;
413 is( $deleted, 1, 'Koha::Patron->delete should return 1 if the patron has been correctly deleted' );
415 is( Koha::Patrons->find( $patron->{borrowernumber} ), undef, 'Koha::Patron->delete should have deleted the patron' );
417 is( Koha::Holds->search( { borrowernumber => $patron->{borrowernumber} } )->count, 0, q|Koha::Patron->delete should have deleted patron's holds| );
419 is( Koha::Virtualshelves->search( { owner => $patron->{borrowernumber} } )->count, 0, q|Koha::Patron->delete should have deleted patron's lists| );
421 my $number_of_logs = $schema->resultset('ActionLog')->search( { module => 'MEMBERS', action => 'DELETE', object => $retrieved_patron->borrowernumber } )->count;
422 is( $number_of_logs, 1, 'With BorrowerLogs, Koha::Patron->delete should have logged' );
425 subtest 'add_enrolment_fee_if_needed' => sub {
428 my $enrolmentfees = { K => 5, J => 10, YA => 20 };
429 foreach( keys %{$enrolmentfees} ) {
430 ( Koha::Patron::Categories->find( $_ ) // $builder->build_object({ class => 'Koha::Patron::Categories', value => { categorycode => $_ } }) )->enrolmentfee( $enrolmentfees->{$_} )->store;
432 my $enrolmentfee_K = $enrolmentfees->{K};
433 my $enrolmentfee_J = $enrolmentfees->{J};
434 my $enrolmentfee_YA = $enrolmentfees->{YA};
436 my %borrower_data = (
437 firstname => 'my firstname',
438 surname => 'my surname',
440 branchcode => $library->{branchcode},
443 my $borrowernumber = Koha::Patron->new(\%borrower_data)->store->borrowernumber;
444 $borrower_data{borrowernumber} = $borrowernumber;
446 my $patron = Koha::Patrons->find( $borrowernumber );
447 my $total = $patron->account->balance;
448 is( int($total), int($enrolmentfee_K), "New kid pay $enrolmentfee_K" );
450 t::lib::Mocks::mock_preference( 'FeeOnChangePatronCategory', 0 );
451 $borrower_data{categorycode} = 'J';
452 $patron->set(\%borrower_data)->store;
453 $total = $patron->account->balance;
454 is( int($total), int($enrolmentfee_K), "Kid growing and become a juvenile, but shouldn't pay for the upgrade " );
456 $borrower_data{categorycode} = 'K';
457 $patron->set(\%borrower_data)->store;
458 t::lib::Mocks::mock_preference( 'FeeOnChangePatronCategory', 1 );
460 $borrower_data{categorycode} = 'J';
461 $patron->set(\%borrower_data)->store;
462 $total = $patron->account->balance;
463 is( int($total), int($enrolmentfee_K + $enrolmentfee_J), "Kid growing and become a juvenile, they should pay " . ( $enrolmentfee_K + $enrolmentfee_J ) );
465 # Check with calling directly Koha::Patron->get_enrolment_fee_if_needed
466 $patron->categorycode('YA')->store;
467 $total = $patron->account->balance;
469 int($enrolmentfee_K + $enrolmentfee_J + $enrolmentfee_YA),
470 "Juvenile growing and become an young adult, they should pay " . ( $enrolmentfee_K + $enrolmentfee_J + $enrolmentfee_YA )
476 subtest 'checkouts + pending_checkouts + get_overdues + old_checkouts' => sub {
479 my $library = $builder->build( { source => 'Branch' } );
480 my ($biblionumber_1) = AddBiblio( MARC::Record->new, '' );
481 my $item_1 = $builder->build(
485 homebranch => $library->{branchcode},
486 holdingbranch => $library->{branchcode},
487 biblionumber => $biblionumber_1,
493 my $item_2 = $builder->build(
497 homebranch => $library->{branchcode},
498 holdingbranch => $library->{branchcode},
499 biblionumber => $biblionumber_1,
505 my ($biblionumber_2) = AddBiblio( MARC::Record->new, '' );
506 my $item_3 = $builder->build(
510 homebranch => $library->{branchcode},
511 holdingbranch => $library->{branchcode},
512 biblionumber => $biblionumber_2,
518 my $patron = $builder->build(
520 source => 'Borrower',
521 value => { branchcode => $library->{branchcode} }
525 $patron = Koha::Patrons->find( $patron->{borrowernumber} );
526 my $checkouts = $patron->checkouts;
527 is( $checkouts->count, 0, 'checkouts should not return any issues for that patron' );
528 is( ref($checkouts), 'Koha::Checkouts', 'checkouts should return a Koha::Checkouts object' );
529 my $pending_checkouts = $patron->pending_checkouts;
530 is( $pending_checkouts->count, 0, 'pending_checkouts should not return any issues for that patron' );
531 is( ref($pending_checkouts), 'Koha::Checkouts', 'pending_checkouts should return a Koha::Checkouts object' );
532 my $old_checkouts = $patron->old_checkouts;
533 is( $old_checkouts->count, 0, 'old_checkouts should not return any issues for that patron' );
534 is( ref($old_checkouts), 'Koha::Old::Checkouts', 'old_checkouts should return a Koha::Old::Checkouts object' );
536 # Not sure how this is useful, but AddIssue pass this variable to different other subroutines
537 $patron = Koha::Patrons->find( $patron->borrowernumber )->unblessed;
539 my $module = new Test::MockModule('C4::Context');
540 $module->mock( 'userenv', sub { { branch => $library->{branchcode} } } );
542 AddIssue( $patron, $item_1->{barcode}, DateTime->now->subtract( days => 1 ) );
543 AddIssue( $patron, $item_2->{barcode}, DateTime->now->subtract( days => 5 ) );
544 AddIssue( $patron, $item_3->{barcode} );
546 $patron = Koha::Patrons->find( $patron->{borrowernumber} );
547 $checkouts = $patron->checkouts;
548 is( $checkouts->count, 3, 'checkouts should return 3 issues for that patron' );
549 is( ref($checkouts), 'Koha::Checkouts', 'checkouts should return a Koha::Checkouts object' );
550 $pending_checkouts = $patron->pending_checkouts;
551 is( $pending_checkouts->count, 3, 'pending_checkouts should return 3 issues for that patron' );
552 is( ref($pending_checkouts), 'Koha::Checkouts', 'pending_checkouts should return a Koha::Checkouts object' );
554 my $first_checkout = $pending_checkouts->next;
555 is( $first_checkout->unblessed_all_relateds->{biblionumber}, $item_3->{biblionumber}, 'pending_checkouts should prefetch values from other tables (here biblio)' );
557 my $overdues = $patron->get_overdues;
558 is( $overdues->count, 2, 'Patron should have 2 overdues');
559 is( ref($overdues), 'Koha::Checkouts', 'Koha::Patron->get_overdues should return Koha::Checkouts' );
560 is( $overdues->next->itemnumber, $item_1->{itemnumber}, 'The issue should be returned in the same order as they have been done, first is correct' );
561 is( $overdues->next->itemnumber, $item_2->{itemnumber}, 'The issue should be returned in the same order as they have been done, second is correct' );
564 C4::Circulation::AddReturn( $item_1->{barcode} );
565 C4::Circulation::AddReturn( $item_2->{barcode} );
566 $old_checkouts = $patron->old_checkouts;
567 is( $old_checkouts->count, 2, 'old_checkouts should return 2 old checkouts that patron' );
568 is( ref($old_checkouts), 'Koha::Old::Checkouts', 'old_checkouts should return a Koha::Old::Checkouts object' );
571 Koha::Checkouts->search( { borrowernumber => $patron->borrowernumber } )->delete;
573 $module->unmock('userenv');
576 subtest 'get_routing_lists' => sub {
579 my $biblio = Koha::Biblio->new()->store();
580 my $subscription = Koha::Subscription->new({
581 biblionumber => $biblio->biblionumber,
585 my $patron = $builder->build( { source => 'Borrower' } );
586 $patron = Koha::Patrons->find( $patron->{borrowernumber} );
588 is( $patron->get_routing_lists->count, 0, 'Retrieves correct number of routing lists: 0' );
590 my $routinglist_count = Koha::Subscription::Routinglists->count;
591 my $routinglist = Koha::Subscription::Routinglist->new({
592 borrowernumber => $patron->borrowernumber,
594 subscriptionid => $subscription->subscriptionid
597 is ($patron->get_routing_lists->count, 1, "Retrieves correct number of routing lists: 1");
599 my $routinglists = $patron->get_routing_lists;
600 is ($routinglists->next->ranking, 5, "Retrieves ranking: 5");
601 is( ref($routinglists), 'Koha::Subscription::Routinglists', 'get_routing_lists returns Koha::Subscription::Routinglists' );
603 my $subscription2 = Koha::Subscription->new({
604 biblionumber => $biblio->biblionumber,
607 my $routinglist2 = Koha::Subscription::Routinglist->new({
608 borrowernumber => $patron->borrowernumber,
610 subscriptionid => $subscription2->subscriptionid
613 is ($patron->get_routing_lists->count, 2, "Retrieves correct number of routing lists: 2");
615 $patron->delete; # Clean up for later tests
619 subtest 'get_age' => sub {
622 my $patron = $builder->build( { source => 'Borrower' } );
623 $patron = Koha::Patrons->find( $patron->{borrowernumber} );
625 my $today = dt_from_string;
627 $patron->dateofbirth( undef );
628 is( $patron->get_age, undef, 'get_age should return undef if no dateofbirth is defined' );
629 $patron->dateofbirth( $today->clone->add( years => -12, months => -6, days => -1, end_of_month => 'limit' ) );
630 is( $patron->get_age, 12, 'Patron should be 12' );
631 $patron->dateofbirth( $today->clone->add( years => -18, months => 0, days => 1, end_of_month => 'limit' ) );
632 is( $patron->get_age, 17, 'Patron should be 17, happy birthday tomorrow!' );
633 $patron->dateofbirth( $today->clone->add( years => -18, months => 0, days => 0, end_of_month => 'limit' ) );
634 is( $patron->get_age, 18, 'Patron should be 18' );
635 $patron->dateofbirth( $today->clone->add( years => -18, months => -12, days => -31, end_of_month => 'limit' ) );
636 is( $patron->get_age, 19, 'Patron should be 19' );
637 $patron->dateofbirth( $today->clone->add( years => -18, months => -12, days => -30, end_of_month => 'limit' ) );
638 is( $patron->get_age, 19, 'Patron should be 19 again' );
639 $patron->dateofbirth( $today->clone->add( years => 0, months => -1, days => -1, end_of_month => 'limit' ) );
640 is( $patron->get_age, 0, 'Patron is a newborn child' );
645 subtest 'account' => sub {
648 my $patron = $builder->build({source => 'Borrower'});
650 $patron = Koha::Patrons->find( $patron->{borrowernumber} );
651 my $account = $patron->account;
652 is( ref($account), 'Koha::Account', 'account should return a Koha::Account object' );
657 subtest 'search_upcoming_membership_expires' => sub {
660 my $expiry_days = 15;
661 t::lib::Mocks::mock_preference( 'MembershipExpiryDaysNotice', $expiry_days );
662 my $nb_of_days_before = 1;
663 my $nb_of_days_after = 2;
665 my $builder = t::lib::TestBuilder->new();
667 my $library = $builder->build({ source => 'Branch' });
669 # before we add borrowers to this branch, add the expires we have now
670 # note that this pertains to the current mocked setting of the pref
671 # for this reason we add the new branchcode to most of the tests
672 my $nb_of_expires = Koha::Patrons->search_upcoming_membership_expires->count;
674 my $patron_1 = $builder->build({
675 source => 'Borrower',
677 branchcode => $library->{branchcode},
678 dateexpiry => dt_from_string->add( days => $expiry_days )
682 my $patron_2 = $builder->build({
683 source => 'Borrower',
685 branchcode => $library->{branchcode},
686 dateexpiry => dt_from_string->add( days => $expiry_days - $nb_of_days_before )
690 my $patron_3 = $builder->build({
691 source => 'Borrower',
693 branchcode => $library->{branchcode},
694 dateexpiry => dt_from_string->add( days => $expiry_days + $nb_of_days_after )
698 # Test without extra parameters
699 my $upcoming_mem_expires = Koha::Patrons->search_upcoming_membership_expires();
700 is( $upcoming_mem_expires->count, $nb_of_expires + 1, 'Get upcoming membership expires should return one new borrower.' );
703 $upcoming_mem_expires = Koha::Patrons->search_upcoming_membership_expires({ 'me.branchcode' => $library->{branchcode} });
704 is( $upcoming_mem_expires->count, 1, 'Test with branch parameter' );
705 my $expired = $upcoming_mem_expires->next;
706 is( $expired->surname, $patron_1->{surname}, 'Get upcoming membership expires should return the correct patron.' );
707 is( $expired->library->branchemail, $library->{branchemail}, 'Get upcoming membership expires should return the correct patron.' );
708 is( $expired->branchcode, $patron_1->{branchcode}, 'Get upcoming membership expires should return the correct patron.' );
710 t::lib::Mocks::mock_preference( 'MembershipExpiryDaysNotice', 0 );
711 $upcoming_mem_expires = Koha::Patrons->search_upcoming_membership_expires({ 'me.branchcode' => $library->{branchcode} });
712 is( $upcoming_mem_expires->count, 0, 'Get upcoming membership expires with MembershipExpiryDaysNotice==0 should not return new records.' );
714 # Test MembershipExpiryDaysNotice == undef
715 t::lib::Mocks::mock_preference( 'MembershipExpiryDaysNotice', undef );
716 $upcoming_mem_expires = Koha::Patrons->search_upcoming_membership_expires({ 'me.branchcode' => $library->{branchcode} });
717 is( $upcoming_mem_expires->count, 0, 'Get upcoming membership expires without MembershipExpiryDaysNotice should not return new records.' );
719 # Test the before parameter
720 t::lib::Mocks::mock_preference( 'MembershipExpiryDaysNotice', 15 );
721 $upcoming_mem_expires = Koha::Patrons->search_upcoming_membership_expires({ 'me.branchcode' => $library->{branchcode}, before => $nb_of_days_before });
722 is( $upcoming_mem_expires->count, 2, 'Expect two results for before');
723 # Test after parameter also
724 $upcoming_mem_expires = Koha::Patrons->search_upcoming_membership_expires({ 'me.branchcode' => $library->{branchcode}, before => $nb_of_days_before, after => $nb_of_days_after });
725 is( $upcoming_mem_expires->count, 3, 'Expect three results when adding after' );
726 Koha::Patrons->search({ borrowernumber => { in => [ $patron_1->{borrowernumber}, $patron_2->{borrowernumber}, $patron_3->{borrowernumber} ] } })->delete;
729 subtest 'holds and old_holds' => sub {
732 my $library = $builder->build( { source => 'Branch' } );
733 my ($biblionumber_1) = AddBiblio( MARC::Record->new, '' );
734 my $item_1 = $builder->build(
738 homebranch => $library->{branchcode},
739 holdingbranch => $library->{branchcode},
740 biblionumber => $biblionumber_1
744 my $item_2 = $builder->build(
748 homebranch => $library->{branchcode},
749 holdingbranch => $library->{branchcode},
750 biblionumber => $biblionumber_1
754 my ($biblionumber_2) = AddBiblio( MARC::Record->new, '' );
755 my $item_3 = $builder->build(
759 homebranch => $library->{branchcode},
760 holdingbranch => $library->{branchcode},
761 biblionumber => $biblionumber_2
765 my $patron = $builder->build(
767 source => 'Borrower',
768 value => { branchcode => $library->{branchcode} }
772 $patron = Koha::Patrons->find( $patron->{borrowernumber} );
773 my $holds = $patron->holds;
774 is( ref($holds), 'Koha::Holds',
775 'Koha::Patron->holds should return a Koha::Holds objects' );
776 is( $holds->count, 0, 'There should not be holds placed by this patron yet' );
778 C4::Reserves::AddReserve( $library->{branchcode},
779 $patron->borrowernumber, $biblionumber_1 );
781 C4::Reserves::AddReserve( $library->{branchcode},
782 $patron->borrowernumber, $biblionumber_2, undef, undef, dt_from_string->add( days => 2 ) );
784 $holds = $patron->holds;
785 is( $holds->count, 2, 'There should be 2 holds placed by this patron' );
787 my $old_holds = $patron->old_holds;
788 is( ref($old_holds), 'Koha::Old::Holds',
789 'Koha::Patron->old_holds should return a Koha::Old::Holds objects' );
790 is( $old_holds->count, 0, 'There should not be any old holds yet');
792 my $hold = $holds->next;
795 $old_holds = $patron->old_holds;
796 is( $old_holds->count, 1, 'There should be 1 old (cancelled) hold');
803 subtest 'notice_email_address' => sub {
806 my $patron = $builder->build_object({ class => 'Koha::Patrons' });
808 t::lib::Mocks::mock_preference( 'AutoEmailPrimaryAddress', 'OFF' );
809 is ($patron->notice_email_address, $patron->email, "Koha::Patron->notice_email_address returns correct value when AutoEmailPrimaryAddress is off");
811 t::lib::Mocks::mock_preference( 'AutoEmailPrimaryAddress', 'emailpro' );
812 is ($patron->notice_email_address, $patron->emailpro, "Koha::Patron->notice_email_address returns correct value when AutoEmailPrimaryAddress is emailpro");
817 subtest 'search_patrons_to_anonymise & anonymise_issue_history' => sub {
820 # TODO create a subroutine in t::lib::Mocks
821 my $branch = $builder->build({ source => 'Branch' });
822 my $userenv_patron = $builder->build({
823 source => 'Borrower',
824 value => { branchcode => $branch->{branchcode} },
826 C4::Context->_new_userenv('DUMMY SESSION');
827 C4::Context->set_userenv(
828 $userenv_patron->{borrowernumber},
829 $userenv_patron->{userid},
830 'usercnum', 'First name', 'Surname',
831 $branch->{branchcode},
832 $branch->{branchname},
835 my $anonymous = $builder->build( { source => 'Borrower', }, );
837 t::lib::Mocks::mock_preference( 'AnonymousPatron', $anonymous->{borrowernumber} );
839 subtest 'patron privacy is 1 (default)' => sub {
842 t::lib::Mocks::mock_preference('IndependentBranches', 0);
843 my $patron = $builder->build(
844 { source => 'Borrower',
845 value => { privacy => 1, }
848 my $item_1 = $builder->build(
856 my $issue_1 = $builder->build(
859 borrowernumber => $patron->{borrowernumber},
860 itemnumber => $item_1->{itemnumber},
864 my $item_2 = $builder->build(
872 my $issue_2 = $builder->build(
875 borrowernumber => $patron->{borrowernumber},
876 itemnumber => $item_2->{itemnumber},
881 my ( $returned_1, undef, undef ) = C4::Circulation::AddReturn( $item_1->{barcode}, undef, undef, undef, '2010-10-10' );
882 my ( $returned_2, undef, undef ) = C4::Circulation::AddReturn( $item_2->{barcode}, undef, undef, undef, '2011-11-11' );
883 is( $returned_1 && $returned_2, 1, 'The items should have been returned' );
885 my $patrons_to_anonymise = Koha::Patrons->search_patrons_to_anonymise( { before => '2010-10-11' } )->search( { 'me.borrowernumber' => $patron->{borrowernumber} } );
886 is( ref($patrons_to_anonymise), 'Koha::Patrons', 'search_patrons_to_anonymise should return Koha::Patrons' );
888 my $rows_affected = Koha::Patrons->search_patrons_to_anonymise( { before => '2011-11-12' } )->anonymise_issue_history( { before => '2010-10-11' } );
889 ok( $rows_affected > 0, 'AnonymiseIssueHistory should affect at least 1 row' );
891 my $dbh = C4::Context->dbh;
892 my $sth = $dbh->prepare(q|SELECT borrowernumber FROM old_issues where itemnumber = ?|);
893 $sth->execute($item_1->{itemnumber});
894 my ($borrowernumber_used_to_anonymised) = $sth->fetchrow_array;
895 is( $borrowernumber_used_to_anonymised, $anonymous->{borrowernumber}, 'With privacy=1, the issue should have been anonymised' );
896 $sth->execute($item_2->{itemnumber});
897 ($borrowernumber_used_to_anonymised) = $sth->fetchrow_array;
898 is( $borrowernumber_used_to_anonymised, $patron->{borrowernumber}, 'The issue should not have been anonymised, the returned date is later' );
900 $rows_affected = Koha::Patrons->search_patrons_to_anonymise( { before => '2011-11-12' } )->anonymise_issue_history;
901 $sth->execute($item_2->{itemnumber});
902 ($borrowernumber_used_to_anonymised) = $sth->fetchrow_array;
903 is( $borrowernumber_used_to_anonymised, $anonymous->{borrowernumber}, 'The issue should have been anonymised, the returned date is before' );
905 my $sth_reset = $dbh->prepare(q|UPDATE old_issues SET borrowernumber = ? WHERE itemnumber = ?|);
906 $sth_reset->execute( $patron->{borrowernumber}, $item_1->{itemnumber} );
907 $sth_reset->execute( $patron->{borrowernumber}, $item_2->{itemnumber} );
908 $rows_affected = Koha::Patrons->search_patrons_to_anonymise->anonymise_issue_history;
909 $sth->execute($item_1->{itemnumber});
910 ($borrowernumber_used_to_anonymised) = $sth->fetchrow_array;
911 is( $borrowernumber_used_to_anonymised, $anonymous->{borrowernumber}, 'The issue 1 should have been anonymised, before parameter was not passed' );
912 $sth->execute($item_2->{itemnumber});
913 ($borrowernumber_used_to_anonymised) = $sth->fetchrow_array;
914 is( $borrowernumber_used_to_anonymised, $anonymous->{borrowernumber}, 'The issue 2 should have been anonymised, before parameter was not passed' );
916 Koha::Patrons->find( $patron->{borrowernumber})->delete;
919 subtest 'patron privacy is 0 (forever)' => sub {
922 t::lib::Mocks::mock_preference('IndependentBranches', 0);
923 my $patron = $builder->build(
924 { source => 'Borrower',
925 value => { privacy => 0, }
928 my $item = $builder->build(
936 my $issue = $builder->build(
939 borrowernumber => $patron->{borrowernumber},
940 itemnumber => $item->{itemnumber},
945 my ( $returned, undef, undef ) = C4::Circulation::AddReturn( $item->{barcode}, undef, undef, undef, '2010-10-10' );
946 is( $returned, 1, 'The item should have been returned' );
947 my $rows_affected = Koha::Patrons->search_patrons_to_anonymise( { before => '2010-10-11' } )->anonymise_issue_history( { before => '2010-10-11' } );
948 ok( $rows_affected > 0, 'AnonymiseIssueHistory should not return any error if success' );
950 my $dbh = C4::Context->dbh;
951 my ($borrowernumber_used_to_anonymised) = $dbh->selectrow_array(q|
952 SELECT borrowernumber FROM old_issues where itemnumber = ?
953 |, undef, $item->{itemnumber});
954 is( $borrowernumber_used_to_anonymised, $patron->{borrowernumber}, 'With privacy=0, the issue should not be anonymised' );
955 Koha::Patrons->find( $patron->{borrowernumber})->delete;
958 t::lib::Mocks::mock_preference( 'AnonymousPatron', '' );
960 subtest 'AnonymousPatron is not defined' => sub {
963 t::lib::Mocks::mock_preference('IndependentBranches', 0);
964 my $patron = $builder->build(
965 { source => 'Borrower',
966 value => { privacy => 1, }
969 my $item = $builder->build(
977 my $issue = $builder->build(
980 borrowernumber => $patron->{borrowernumber},
981 itemnumber => $item->{itemnumber},
986 my ( $returned, undef, undef ) = C4::Circulation::AddReturn( $item->{barcode}, undef, undef, undef, '2010-10-10' );
987 is( $returned, 1, 'The item should have been returned' );
988 my $rows_affected = Koha::Patrons->search_patrons_to_anonymise( { before => '2010-10-11' } )->anonymise_issue_history( { before => '2010-10-11' } );
989 ok( $rows_affected > 0, 'AnonymiseIssueHistory should affect at least 1 row' );
991 my $dbh = C4::Context->dbh;
992 my ($borrowernumber_used_to_anonymised) = $dbh->selectrow_array(q|
993 SELECT borrowernumber FROM old_issues where itemnumber = ?
994 |, undef, $item->{itemnumber});
995 is( $borrowernumber_used_to_anonymised, undef, 'With AnonymousPatron is not defined, the issue should have been anonymised anyway' );
996 Koha::Patrons->find( $patron->{borrowernumber})->delete;
999 subtest 'Logged in librarian is not superlibrarian & IndependentBranches' => sub {
1001 t::lib::Mocks::mock_preference( 'IndependentBranches', 1 );
1002 my $patron = $builder->build(
1003 { source => 'Borrower',
1004 value => { privacy => 1 } # Another branchcode than the logged in librarian
1007 my $item = $builder->build(
1015 my $issue = $builder->build(
1016 { source => 'Issue',
1018 borrowernumber => $patron->{borrowernumber},
1019 itemnumber => $item->{itemnumber},
1024 my ( $returned, undef, undef ) = C4::Circulation::AddReturn( $item->{barcode}, undef, undef, undef, '2010-10-10' );
1025 is( Koha::Patrons->search_patrons_to_anonymise( { before => '2010-10-11' } )->count, 0 );
1026 Koha::Patrons->find( $patron->{borrowernumber})->delete;
1029 Koha::Patrons->find( $anonymous->{borrowernumber})->delete;
1030 Koha::Patrons->find( $userenv_patron->{borrowernumber})->delete;
1032 # Reset IndependentBranches for further tests
1033 t::lib::Mocks::mock_preference('IndependentBranches', 0);
1036 subtest 'libraries_where_can_see_patrons + can_see_patron_infos + search_limited' => sub {
1044 $nb_of_patrons = Koha::Patrons->search->count;
1045 my $group_1 = Koha::Library::Group->new( { title => 'TEST Group 1', ft_hide_patron_info => 1 } )->store;
1046 my $group_2 = Koha::Library::Group->new( { title => 'TEST Group 2', ft_hide_patron_info => 1 } )->store;
1047 my $library_11 = $builder->build( { source => 'Branch' } );
1048 my $library_12 = $builder->build( { source => 'Branch' } );
1049 my $library_21 = $builder->build( { source => 'Branch' } );
1050 $library_11 = Koha::Libraries->find( $library_11->{branchcode} );
1051 $library_12 = Koha::Libraries->find( $library_12->{branchcode} );
1052 $library_21 = Koha::Libraries->find( $library_21->{branchcode} );
1053 Koha::Library::Group->new(
1054 { branchcode => $library_11->branchcode, parent_id => $group_1->id } )->store;
1055 Koha::Library::Group->new(
1056 { branchcode => $library_12->branchcode, parent_id => $group_1->id } )->store;
1057 Koha::Library::Group->new(
1058 { branchcode => $library_21->branchcode, parent_id => $group_2->id } )->store;
1060 my $sth = C4::Context->dbh->prepare(q|INSERT INTO user_permissions( borrowernumber, module_bit, code ) VALUES (?, 4, ?)|); # 4 for borrowers
1061 # 2 patrons from library_11 (group1)
1062 # patron_11_1 see patron's infos from outside its group
1063 # Setting flags => undef to not be considered as superlibrarian
1064 my $patron_11_1 = $builder->build({ source => 'Borrower', value => { branchcode => $library_11->branchcode, flags => undef, }});
1065 $patron_11_1 = Koha::Patrons->find( $patron_11_1->{borrowernumber} );
1066 $sth->execute( $patron_11_1->borrowernumber, 'edit_borrowers' );
1067 $sth->execute( $patron_11_1->borrowernumber, 'view_borrower_infos_from_any_libraries' );
1068 # patron_11_2 can only see patron's info from its group
1069 my $patron_11_2 = $builder->build({ source => 'Borrower', value => { branchcode => $library_11->branchcode, flags => undef, }});
1070 $patron_11_2 = Koha::Patrons->find( $patron_11_2->{borrowernumber} );
1071 $sth->execute( $patron_11_2->borrowernumber, 'edit_borrowers' );
1072 # 1 patron from library_12 (group1)
1073 my $patron_12 = $builder->build({ source => 'Borrower', value => { branchcode => $library_12->branchcode, flags => undef, }});
1074 $patron_12 = Koha::Patrons->find( $patron_12->{borrowernumber} );
1075 # 1 patron from library_21 (group2) can only see patron's info from its group
1076 my $patron_21 = $builder->build({ source => 'Borrower', value => { branchcode => $library_21->branchcode, flags => undef, }});
1077 $patron_21 = Koha::Patrons->find( $patron_21->{borrowernumber} );
1078 $sth->execute( $patron_21->borrowernumber, 'edit_borrowers' );
1080 # Pfiou, we can start now!
1081 subtest 'libraries_where_can_see_patrons' => sub {
1086 set_logged_in_user( $patron_11_1 );
1087 @branchcodes = $patron_11_1->libraries_where_can_see_patrons;
1088 is_deeply( \@branchcodes, [], q|patron_11_1 has view_borrower_infos_from_any_libraries => No restriction| );
1090 set_logged_in_user( $patron_11_2 );
1091 @branchcodes = $patron_11_2->libraries_where_can_see_patrons;
1092 is_deeply( \@branchcodes, [ sort ( $library_11->branchcode, $library_12->branchcode ) ], q|patron_11_2 has not view_borrower_infos_from_any_libraries => Can only see patron's from its group| );
1094 set_logged_in_user( $patron_21 );
1095 @branchcodes = $patron_21->libraries_where_can_see_patrons;
1096 is_deeply( \@branchcodes, [$library_21->branchcode], q|patron_21 has not view_borrower_infos_from_any_libraries => Can only see patron's from its group| );
1098 subtest 'can_see_patron_infos' => sub {
1101 set_logged_in_user( $patron_11_1 );
1102 is( $patron_11_1->can_see_patron_infos( $patron_11_2 ), 1, q|patron_11_1 can see patron_11_2, from its library| );
1103 is( $patron_11_1->can_see_patron_infos( $patron_12 ), 1, q|patron_11_1 can see patron_12, from its group| );
1104 is( $patron_11_1->can_see_patron_infos( $patron_21 ), 1, q|patron_11_1 can see patron_11_2, from another group| );
1106 set_logged_in_user( $patron_11_2 );
1107 is( $patron_11_2->can_see_patron_infos( $patron_11_1 ), 1, q|patron_11_2 can see patron_11_1, from its library| );
1108 is( $patron_11_2->can_see_patron_infos( $patron_12 ), 1, q|patron_11_2 can see patron_12, from its group| );
1109 is( $patron_11_2->can_see_patron_infos( $patron_21 ), 0, q|patron_11_2 can NOT see patron_21, from another group| );
1111 subtest 'search_limited' => sub {
1114 set_logged_in_user( $patron_11_1 );
1115 my $total_number_of_patrons = $nb_of_patrons + 4; #we added four in these tests
1116 is( Koha::Patrons->search->count, $total_number_of_patrons, 'Non-limited search should return all patrons' );
1117 is( Koha::Patrons->search_limited->count, $total_number_of_patrons, 'patron_11_1 is allowed to see all patrons' );
1119 set_logged_in_user( $patron_11_2 );
1120 is( Koha::Patrons->search->count, $total_number_of_patrons, 'Non-limited search should return all patrons');
1121 is( Koha::Patrons->search_limited->count, 3, 'patron_12_1 is not allowed to see patrons from other groups, only patron_11_1, patron_11_2 and patron_12' );
1123 set_logged_in_user( $patron_21 );
1124 is( Koha::Patrons->search->count, $total_number_of_patrons, 'Non-limited search should return all patrons');
1125 is( Koha::Patrons->search_limited->count, 1, 'patron_21 is not allowed to see patrons from other groups, only himself' );
1127 $patron_11_1->delete;
1128 $patron_11_2->delete;
1133 subtest 'account_locked' => sub {
1135 my $patron = $builder->build({ source => 'Borrower', value => { login_attempts => 0 } });
1136 $patron = Koha::Patrons->find( $patron->{borrowernumber} );
1137 for my $value ( undef, '', 0 ) {
1138 t::lib::Mocks::mock_preference('FailedloginAttempts', $value);
1139 is( $patron->account_locked, 0, 'Feature is disabled, patron account should not be considered locked' );
1140 $patron->login_attempts(1)->store;
1141 is( $patron->account_locked, 0, 'Feature is disabled, patron account should not be considered locked' );
1144 t::lib::Mocks::mock_preference('FailedloginAttempts', 3);
1145 $patron->login_attempts(2)->store;
1146 is( $patron->account_locked, 0, 'Patron has 2 failed attempts, account should not be considered locked yet' );
1147 $patron->login_attempts(3)->store;
1148 is( $patron->account_locked, 1, 'Patron has 3 failed attempts, account should be considered locked yet' );
1153 subtest 'is_child | is_adult' => sub {
1155 my $category = $builder->build_object(
1157 class => 'Koha::Patron::Categories',
1158 value => { category_type => 'A' }
1161 my $patron_adult = $builder->build_object(
1163 class => 'Koha::Patrons',
1164 value => { categorycode => $category->categorycode }
1167 $category = $builder->build_object(
1169 class => 'Koha::Patron::Categories',
1170 value => { category_type => 'I' }
1173 my $patron_adult_i = $builder->build_object(
1175 class => 'Koha::Patrons',
1176 value => { categorycode => $category->categorycode }
1179 $category = $builder->build_object(
1181 class => 'Koha::Patron::Categories',
1182 value => { category_type => 'C' }
1185 my $patron_child = $builder->build_object(
1187 class => 'Koha::Patrons',
1188 value => { categorycode => $category->categorycode }
1191 $category = $builder->build_object(
1193 class => 'Koha::Patron::Categories',
1194 value => { category_type => 'O' }
1197 my $patron_other = $builder->build_object(
1199 class => 'Koha::Patrons',
1200 value => { categorycode => $category->categorycode }
1203 is( $patron_adult->is_adult, 1, 'Patron from category A should be considered adult' );
1204 is( $patron_adult_i->is_adult, 1, 'Patron from category I should be considered adult' );
1205 is( $patron_child->is_adult, 0, 'Patron from category C should not be considered adult' );
1206 is( $patron_other->is_adult, 0, 'Patron from category O should not be considered adult' );
1208 is( $patron_adult->is_child, 0, 'Patron from category A should be considered child' );
1209 is( $patron_adult_i->is_child, 0, 'Patron from category I should be considered child' );
1210 is( $patron_child->is_child, 1, 'Patron from category C should not be considered child' );
1211 is( $patron_other->is_child, 0, 'Patron from category O should not be considered child' );
1214 $patron_adult->delete;
1215 $patron_adult_i->delete;
1216 $patron_child->delete;
1217 $patron_other->delete;
1220 subtest 'get_overdues' => sub {
1223 my $library = $builder->build( { source => 'Branch' } );
1224 my ($biblionumber_1) = AddBiblio( MARC::Record->new, '' );
1225 my $item_1 = $builder->build(
1229 homebranch => $library->{branchcode},
1230 holdingbranch => $library->{branchcode},
1231 biblionumber => $biblionumber_1
1235 my $item_2 = $builder->build(
1239 homebranch => $library->{branchcode},
1240 holdingbranch => $library->{branchcode},
1241 biblionumber => $biblionumber_1
1245 my ($biblionumber_2) = AddBiblio( MARC::Record->new, '' );
1246 my $item_3 = $builder->build(
1250 homebranch => $library->{branchcode},
1251 holdingbranch => $library->{branchcode},
1252 biblionumber => $biblionumber_2
1256 my $patron = $builder->build(
1258 source => 'Borrower',
1259 value => { branchcode => $library->{branchcode} }
1263 my $module = new Test::MockModule('C4::Context');
1264 $module->mock( 'userenv', sub { { branch => $library->{branchcode} } } );
1266 AddIssue( $patron, $item_1->{barcode}, DateTime->now->subtract( days => 1 ) );
1267 AddIssue( $patron, $item_2->{barcode}, DateTime->now->subtract( days => 5 ) );
1268 AddIssue( $patron, $item_3->{barcode} );
1270 $patron = Koha::Patrons->find( $patron->{borrowernumber} );
1271 my $overdues = $patron->get_overdues;
1272 is( $overdues->count, 2, 'Patron should have 2 overdues');
1273 is( $overdues->next->itemnumber, $item_1->{itemnumber}, 'The issue should be returned in the same order as they have been done, first is correct' );
1274 is( $overdues->next->itemnumber, $item_2->{itemnumber}, 'The issue should be returned in the same order as they have been done, second is correct' );
1276 my $o = $overdues->reset->next;
1277 my $unblessed_overdue = $o->unblessed_all_relateds;
1278 is( exists( $unblessed_overdue->{issuedate} ), 1, 'Fields from the issues table should be filled' );
1279 is( exists( $unblessed_overdue->{itemcallnumber} ), 1, 'Fields from the items table should be filled' );
1280 is( exists( $unblessed_overdue->{title} ), 1, 'Fields from the biblio table should be filled' );
1281 is( exists( $unblessed_overdue->{itemtype} ), 1, 'Fields from the biblioitems table should be filled' );
1284 $patron->checkouts->delete;
1288 subtest 'userid_is_valid' => sub {
1291 my $library = $builder->build_object( { class => 'Koha::Libraries' } );
1292 my $patron_category = $builder->build_object(
1294 class => 'Koha::Patron::Categories',
1295 value => { category_type => 'P', enrolmentfee => 0 }
1299 cardnumber => "123456789",
1300 firstname => "Tomasito",
1302 categorycode => $patron_category->categorycode,
1303 branchcode => $library->branchcode,
1306 my $expected_userid_patron_1 = 'tomasito.none';
1307 my $borrowernumber = Koha::Patron->new(\%data)->store->borrowernumber;
1308 my $patron_1 = Koha::Patrons->find($borrowernumber);
1309 is ( $patron_1->userid, $expected_userid_patron_1, 'The userid generated should be the one we expect' );
1311 $patron_1->userid( 'tomasito.non' );
1312 is( $patron_1->has_valid_userid, # FIXME Joubu: What is the difference with the next test?
1313 1, 'recently created userid -> unique (borrowernumber passed)' );
1315 $patron_1->userid( 'tomasitoxxx' );
1316 is( $patron_1->has_valid_userid,
1317 1, 'non-existent userid -> unique (borrowernumber passed)' );
1318 $patron_1->discard_changes; # We compare with the original userid later
1320 my $patron_not_in_storage = Koha::Patron->new( { userid => '' } );
1321 is( $patron_not_in_storage->has_valid_userid,
1322 0, 'userid exists for another patron, patron is not in storage yet' );
1324 $patron_not_in_storage = Koha::Patron->new( { userid => 'tomasitoxxx' } );
1325 is( $patron_not_in_storage->has_valid_userid,
1326 1, 'non-existent userid, patron is not in storage yet' );
1328 # Regression tests for BZ12226
1329 my $db_patron = Koha::Patron->new( { userid => C4::Context->config('user') } );
1330 is( $db_patron->has_valid_userid,
1331 0, 'Koha::Patron->has_valid_userid should return 0 for the DB user (Bug 12226)' );
1333 # Add a new borrower with the same userid but different cardnumber
1334 $data{cardnumber} = "987654321";
1335 my $new_borrowernumber = Koha::Patron->new(\%data)->store->borrowernumber;
1336 my $patron_2 = Koha::Patrons->find($new_borrowernumber);
1337 $patron_2->userid($patron_1->userid);
1338 is( $patron_2->has_valid_userid,
1339 0, 'The userid is already in used, it cannot be used for another patron' );
1341 my $new_userid = 'a_user_id';
1342 $data{cardnumber} = "234567890";
1343 $data{userid} = 'a_user_id';
1344 $borrowernumber = Koha::Patron->new(\%data)->store->borrowernumber;
1345 my $patron_3 = Koha::Patrons->find($borrowernumber);
1346 is( $patron_3->userid, $new_userid,
1347 'Koha::Patron->store should insert the given userid' );
1355 subtest 'generate_userid' => sub {
1358 my $library = $builder->build_object( { class => 'Koha::Libraries' } );
1359 my $patron_category = $builder->build_object(
1361 class => 'Koha::Patron::Categories',
1362 value => { category_type => 'P', enrolmentfee => 0 }
1366 cardnumber => "123456789",
1367 firstname => "Tomasito",
1369 categorycode => $patron_category->categorycode,
1370 branchcode => $library->branchcode,
1373 my $expected_userid_patron_1 = 'tomasito.none';
1374 my $new_patron = Koha::Patron->new({ firstname => $data{firstname}, surname => $data{surname} } );
1375 $new_patron->generate_userid;
1376 my $userid = $new_patron->userid;
1377 is( $userid, $expected_userid_patron_1, 'generate_userid should generate the userid we expect' );
1378 my $borrowernumber = Koha::Patron->new(\%data)->store->borrowernumber;
1379 my $patron_1 = Koha::Patrons->find($borrowernumber);
1380 is ( $patron_1->userid, $expected_userid_patron_1, 'The userid generated should be the one we expect' );
1382 $new_patron->generate_userid;
1383 $userid = $new_patron->userid;
1384 is( $userid, $expected_userid_patron_1 . '1', 'generate_userid should generate the userid we expect' );
1385 $data{cardnumber} = '987654321';
1386 my $new_borrowernumber = Koha::Patron->new(\%data)->store->borrowernumber;
1387 my $patron_2 = Koha::Patrons->find($new_borrowernumber);
1388 isnt( $patron_2->userid, 'tomasito',
1389 "Patron with duplicate userid has new userid generated" );
1390 is( $patron_2->userid, $expected_userid_patron_1 . '1', # TODO we could make that configurable
1391 "Patron with duplicate userid has new userid generated (1 is appened" );
1393 $new_patron->generate_userid;
1394 $userid = $new_patron->userid;
1395 is( $userid, $expected_userid_patron_1 . '2', 'generate_userid should generate the userid we expect' );
1397 $patron_1 = Koha::Patrons->find($borrowernumber);
1398 $patron_1->userid(undef);
1399 $patron_1->generate_userid;
1400 $userid = $patron_1->userid;
1401 is( $userid, $expected_userid_patron_1, 'generate_userid should generate the userid we expect' );
1408 $nb_of_patrons = Koha::Patrons->search->count;
1409 $retrieved_patron_1->delete;
1410 is( Koha::Patrons->search->count, $nb_of_patrons - 1, 'Delete should have deleted the patron' );
1412 subtest 'Log cardnumber change' => sub {
1415 t::lib::Mocks::mock_preference( 'BorrowersLog', 1 );
1416 my $patron = $builder->build_object( { class => 'Koha::Patrons' } );
1418 my $cardnumber = $patron->cardnumber;
1419 $patron->set( { cardnumber => 'TESTCARDNUMBER' });
1422 my @logs = $schema->resultset('ActionLog')->search( { module => 'MEMBERS', action => 'MODIFY', object => $patron->borrowernumber } );
1423 my $log_info = from_json( $logs[0]->info );
1424 is( $log_info->{cardnumber_replaced}->{new_cardnumber}, 'TESTCARDNUMBER', 'Got correct new cardnumber' );
1425 is( $log_info->{cardnumber_replaced}->{previous_cardnumber}, $cardnumber, 'Got correct old cardnumber' );
1426 is( scalar @logs, 2, 'With BorrowerLogs, Change in cardnumber should be logged, as well as general alert of patron mod.' );
1429 $schema->storage->txn_rollback;
1431 subtest 'Test Koha::Patrons::merge' => sub {
1434 my $schema = Koha::Database->new()->schema();
1436 my $resultsets = $Koha::Patron::RESULTSET_PATRON_ID_MAPPING;
1438 $schema->storage->txn_begin;
1440 my $keeper = $builder->build_object({ class => 'Koha::Patrons' });
1441 my $loser_1 = $builder->build({ source => 'Borrower' })->{borrowernumber};
1442 my $loser_2 = $builder->build({ source => 'Borrower' })->{borrowernumber};
1444 while (my ($r, $field) = each(%$resultsets)) {
1445 $builder->build({ source => $r, value => { $field => $keeper->id } });
1446 $builder->build({ source => $r, value => { $field => $loser_1 } });
1447 $builder->build({ source => $r, value => { $field => $loser_2 } });
1450 $schema->resultset($r)->search( { $field => $keeper->id } );
1451 is( $keeper_rs->count(), 1, "Found 1 $r rows for keeper" );
1454 $schema->resultset($r)->search( { $field => $loser_1 } );
1455 is( $loser_1_rs->count(), 1, "Found 1 $r rows for loser_1" );
1458 $schema->resultset($r)->search( { $field => $loser_2 } );
1459 is( $loser_2_rs->count(), 1, "Found 1 $r rows for loser_2" );
1462 my $results = $keeper->merge_with([ $loser_1, $loser_2 ]);
1464 while (my ($r, $field) = each(%$resultsets)) {
1466 $schema->resultset($r)->search( {$field => $keeper->id } );
1467 is( $keeper_rs->count(), 3, "Found 2 $r rows for keeper" );
1470 is( Koha::Patrons->find($loser_1), undef, 'Loser 1 has been deleted' );
1471 is( Koha::Patrons->find($loser_2), undef, 'Loser 2 has been deleted' );
1473 $schema->storage->txn_rollback;
1476 subtest '->store' => sub {
1478 my $schema = Koha::Database->new->schema;
1479 $schema->storage->txn_begin;
1481 my $print_error = $schema->storage->dbh->{PrintError};
1482 $schema->storage->dbh->{PrintError} = 0; ; # FIXME This does not longer work - because of the transaction in Koha::Patron->store?
1484 my $patron_1 = $builder->build_object({class=> 'Koha::Patrons'});
1485 my $patron_2 = $builder->build_object({class=> 'Koha::Patrons'});
1488 { $patron_2->userid($patron_1->userid)->store; }
1489 'Koha::Exceptions::Object::DuplicateID',
1490 'Koha::Patron->store raises an exception on duplicate ID';
1493 my $password = 'password';
1494 $patron_1->update_password($patron_1->userid, $password);
1495 like( $patron_1->password, qr|^\$2|, 'Password should be hashed using bcrypt (start with $2)' );
1496 my $digest = $patron_1->password;
1497 $patron_1->surname('xxx')->store;
1498 is( $patron_1->password, $digest, 'Password should not have changed on ->store');
1500 $schema->storage->dbh->{PrintError} = $print_error;
1501 $schema->storage->txn_rollback;
1504 subtest '->set_password' => sub {
1508 $schema->storage->txn_begin;
1510 my $patron = $builder->build_object( { class => 'Koha::Patrons', value => { login_attempts => 3 } } );
1512 # Disable logging password changes for this tests
1513 t::lib::Mocks::mock_preference( 'BorrowersLog', 0 );
1515 # Password-length tests
1516 t::lib::Mocks::mock_preference( 'minPasswordLength', undef );
1517 throws_ok { $patron->set_password('ab'); }
1518 'Koha::Exceptions::Password::TooShort',
1519 'minPasswordLength is undef, fall back to 3, fail test';
1521 t::lib::Mocks::mock_preference( 'minPasswordLength', 2 );
1522 throws_ok { $patron->set_password('ab'); }
1523 'Koha::Exceptions::Password::TooShort',
1524 'minPasswordLength is 2, fall back to 3, fail test';
1526 t::lib::Mocks::mock_preference( 'minPasswordLength', 5 );
1527 throws_ok { $patron->set_password('abcb'); }
1528 'Koha::Exceptions::Password::TooShort',
1529 'minPasswordLength is 5, fail test';
1531 # Trailing spaces tests
1532 throws_ok { $patron->set_password('abcD12d '); }
1533 'Koha::Exceptions::Password::WhitespaceCharacters',
1534 'Password contains trailing spaces, exception is thrown';
1536 # Require strong password tests
1537 t::lib::Mocks::mock_preference( 'RequireStrongPassword', 1 );
1538 throws_ok { $patron->set_password('abcd a'); }
1539 'Koha::Exceptions::Password::TooWeak',
1540 'Password is too weak, exception is thrown';
1542 # Refresh patron from DB, just to make sure
1543 $patron->discard_changes;
1544 is( $patron->login_attempts, 3, 'Previous tests kept login attemps count' );
1546 $patron->set_password('abcD12 34');
1547 $patron->discard_changes;
1549 is( $patron->login_attempts, 0, 'Changing the password resets the login attempts count' );
1552 t::lib::Mocks::mock_preference( 'RequireStrongPassword', 0 );
1553 $patron->login_attempts(3)->store;
1554 my $old_digest = $patron->password;
1555 $patron->set_password('abcd a');
1556 $patron->discard_changes;
1558 isnt( $patron->password, $old_digest, 'Password has been updated' );
1559 ok( checkpw_hash('abcd a', $patron->password), 'Password hash is correct' );
1560 is( $patron->login_attempts, 0, 'Login attemps have been reset' );
1562 my $number_of_logs = $schema->resultset('ActionLog')->search( { module => 'MEMBERS', action => 'CHANGE PASS', object => $patron->borrowernumber } )->count;
1563 is( $number_of_logs, 0, 'Without BorrowerLogs, Koha::Patron->set_password doesn\'t log password changes' );
1565 # Enable logging password changes
1566 t::lib::Mocks::mock_preference( 'BorrowersLog', 1 );
1567 $patron->set_password('abcd b');
1569 $number_of_logs = $schema->resultset('ActionLog')->search( { module => 'MEMBERS', action => 'CHANGE PASS', object => $patron->borrowernumber } )->count;
1570 is( $number_of_logs, 1, 'With BorrowerLogs, Koha::Patron->set_password does log password changes' );
1572 $schema->storage->txn_rollback;
1577 # TODO Move to t::lib::Mocks and reuse it!
1578 sub set_logged_in_user {
1580 C4::Context->set_userenv(
1581 $patron->borrowernumber, $patron->userid,
1582 $patron->cardnumber, 'firstname',
1583 'surname', $patron->library->branchcode,
1584 'Midway Public Library', $patron->flags,