4 # A Class for hiding the ILS's concept of the patron from the OpenSIP
15 use Sys::Syslog qw(syslog);
24 use C4::Branch qw(GetBranchName);
25 use Digest::MD5 qw(md5_base64);
27 use vars qw($VERSION @ISA @EXPORT @EXPORT_OK);
32 @EXPORT_OK = qw(invalid_patron);
35 our $kp; # koha patron
38 my ($class, $patron_id) = @_;
39 my $type = ref($class) || $class;
41 $kp = GetMember(cardnumber=>$patron_id);
42 $debug and warn "new Patron (GetMember): " . Dumper($kp);
43 unless (defined $kp) {
44 syslog("LOG_DEBUG", "new ILS::Patron(%s): no such patron", $patron_id);
47 $kp = GetMemberDetails(undef,$patron_id);
48 $debug and warn "new Patron (GetMemberDetails): " . Dumper($kp);
49 my $pw = $kp->{password}; ### FIXME - md5hash -- deal with .
50 my $flags = $kp->{flags}; # or warn "Warning: No flags from patron object for '$patron_id'";
51 my $debarred = $kp->{debarred}; # 1 if ($kp->{flags}->{DBARRED}->{noissues});
52 $debug and warn sprintf("Debarred = %s : ", ($debarred||'undef')) . Dumper(%{$kp->{flags}});
53 my ($day, $month, $year) = (localtime)[3,4,5];
54 my $today = sprintf '%04d-%02d-%02d', $year+1900, $month+1, $day;
55 my $expired = ($today gt $kp->{dateexpiry}) ? 1 : 0;
57 if ($kp->{opacnote} ) {
58 $kp->{opacnote} .= q{ };
60 $kp->{opacnote} .= 'PATRON EXPIRED';
63 my $adr = $kp->{streetnumber} || '';
64 my $address = $kp->{address} || '';
65 my $dob = $kp->{dateofbirth};
66 $dob and $dob =~ s/-//g; # YYYYMMDD
67 my $dexpiry = $kp->{dateexpiry};
68 $dexpiry and $dexpiry =~ s/-//g; # YYYYMMDD
69 $adr .= ($adr && $address) ? " $address" : $address;
70 my $fines_amount = $flags->{CHARGES}->{amount};
71 $fines_amount = ($fines_amount and $fines_amount > 0) ? $fines_amount : 0;
73 no warnings; # any of these $kp->{fields} being concat'd could be undef
75 getmemberdetails_object => $kp,
76 name => $kp->{firstname} . " " . $kp->{surname},
77 id => $kp->{cardnumber}, # to SIP, the id is the BARCODE, not userid
79 ptype => $kp->{categorycode}, # 'A'dult. Whatever.
80 dateexpiry => $dexpiry,
81 dateexpiry_iso => $kp->{dateexpiry},
83 birthdate_iso => $kp->{dateofbirth},
84 branchcode => $kp->{branchcode},
85 library_name => "", # only populated if needed, cached here
86 borrowernumber => $kp->{borrowernumber},
88 home_phone => $kp->{phone},
89 email_addr => $kp->{email},
90 charge_ok => ( !$debarred && !$expired ),
91 renew_ok => ( !$debarred && !$expired ),
92 recall_ok => ( !$debarred && !$expired ),
93 hold_ok => ( !$debarred && !$expired ),
94 card_lost => ( $kp->{lost} || $kp->{gonenoaddress} || $flags->{LOST} ),
96 fines => $fines_amount, # GetMemberAccountRecords($kp->{borrowernumber})
97 fees => 0, # currently not distinct from fines
100 screen_msg => 'Greetings from Koha. ' . $kp->{opacnote},
103 hold_items => $flags->{WAITING}{itemlist},
104 overdue_items => $flags->{ODUES}{itemlist},
108 inet => ( !$debarred && !$expired ),
112 $debug and warn "patron fines: $ilspatron{fines} ... amountoutstanding: $kp->{amountoutstanding} ... CHARGES->amount: $flags->{CHARGES}->{amount}";
113 for (qw(EXPIRED CHARGES CREDITS GNA LOST DEBARRED NOTES)) {
114 ($flags->{$_}) or next;
115 if ($_ ne 'NOTES' and $flags->{$_}->{message}) {
116 $ilspatron{screen_msg} .= " -- " . $flags->{$_}->{message}; # show all but internal NOTES
118 if ($flags->{$_}->{noissues}) {
119 foreach my $toggle (qw(charge_ok renew_ok recall_ok hold_ok inet)) {
120 $ilspatron{$toggle} = 0; # if we get noissues, disable everything
125 # FIXME: populate fine_items recall_items
126 # $ilspatron{hold_items} = (GetReservesFromBorrowernumber($kp->{borrowernumber},'F'));
127 $ilspatron{unavail_holds} = [(GetReservesFromBorrowernumber($kp->{borrowernumber}))];
128 $ilspatron{items} = GetPendingIssues($kp->{borrowernumber});
130 $debug and warn Dumper($self);
131 syslog("LOG_DEBUG", "new ILS::Patron(%s): found patron '%s'", $patron_id,$self->{id});
151 charge_ok => 0, # for patron_status[0] (inverted)
152 renew_ok => 0, # for patron_status[1] (inverted)
153 recall_ok => 0, # for patron_status[2] (inverted)
154 hold_ok => 0, # for patron_status[3] (inverted)
155 card_lost => 0, # for patron_status[4]
161 too_many_charged => 0, # for patron_status[5]
162 too_many_overdue => 0, # for patron_status[6]
163 too_many_renewal => 0, # for patron_status[7]
164 too_many_claim_return => 0, # for patron_status[8]
165 too_many_lost => 0, # for patron_status[9]
166 # excessive_fines => 0, # for patron_status[10]
167 # excessive_fees => 0, # for patron_status[11]
168 recall_overdue => 0, # for patron_status[12]
169 too_many_billed => 0, # for patron_status[13]
170 inet => 0, # EnvisionWare extension
171 getmemberdetails_object => 0,
177 # be cool. needed for AUTOLOAD(?)
182 my $class = ref($self) or croak "$self is not an object";
183 my $name = $AUTOLOAD;
187 unless (exists $fields{$name}) {
188 croak "Cannot access '$name' field of class '$class'";
192 $fields{$name} or croak "Field '$name' of class '$class' is READ ONLY.";
193 return $self->{$name} = shift;
195 return $self->{$name};
200 my ($self, $pwd) = @_;
201 my $md5pwd = $self->{password};
202 # warn sprintf "check_password for %s: '%s' vs. '%s'",($self->{name}||''),($self->{password}||''),($pwd||'');
203 (defined $pwd ) or return 0; # you gotta give me something (at least ''), or no deal
204 (defined $md5pwd) or return($pwd eq ''); # if the record has a NULL password, accept '' as match
205 return (md5_base64($pwd) eq $md5pwd);
208 # A few special cases, not in AUTOLOADed %fields
211 return $self->{fines} || undef;
216 return $self->fee_amount;
221 return $self->{language} || '000'; # Unspecified
226 return $self->{expired};
230 # remove the hold on item item_id from my hold queue.
231 # return true if I was holding the item, false otherwise.
234 my ($self, $item_id) = @_;
235 $item_id or return undef;
237 foreach (qw(hold_items unavail_holds)) {
239 for (my $i = 0; $i < scalar @{$self->{$_}}; $i++) {
240 my $held_item = $self->{$_}[$i]->{item_id} or next;
241 if ($held_item eq $item_id) {
242 splice @{$self->{$_}}, $i, 1;
250 # Accessor method for array_ref values, designed to get the "start" and "end" values
251 # from the SIP request. Note those incoming values are 1-indexed, not 0-indexed.
254 my $self = shift or return;
255 my $array_var = shift or return;
256 my ($start, $end) = @_;
257 $self->{$array_var} or return [];
258 $start = 1 unless defined($start);
259 $end = scalar @{$self->{$array_var}} unless defined($end);
260 # syslog("LOG_DEBUG", "$array_var: start = %d, end = %d; items(%s)", $start, $end, join(', ', @{$self->{items}}));
262 return [@{$self->{$array_var}}[$start-1 .. $end-1]];
266 # List of outstanding holds placed
269 my $self = shift or return;
270 return $self->x_items('hold_items', @_);
274 my $self = shift or return;
275 return $self->x_items('overdue_items', @_);
278 my $self = shift or return;
279 return $self->x_items('items', @_);
282 my $self = shift or return;
283 return $self->x_items('fine_items', @_);
286 my $self = shift or return;
287 return $self->x_items('recall_items', @_);
290 my $self = shift or return;
291 return $self->x_items('unavail_holds', @_);
295 my ($self, $card_retained, $blocked_card_msg) = @_;
296 foreach my $field ('charge_ok', 'renew_ok', 'recall_ok', 'hold_ok', 'inet') {
299 $self->{screen_msg} = "Block feature not implemented"; # $blocked_card_msg || "Card Blocked. Please contact library staff";
300 # TODO: not really affecting patron record
306 foreach my $field ('charge_ok', 'renew_ok', 'recall_ok', 'hold_ok', 'inet') {
309 syslog("LOG_DEBUG", "Patron(%s)->enable: charge: %s, renew:%s, recall:%s, hold:%s",
310 $self->{id}, $self->{charge_ok}, $self->{renew_ok},
311 $self->{recall_ok}, $self->{hold_ok});
312 $self->{screen_msg} = "Enable feature not implemented."; # "All privileges restored."; # TODO: not really affecting patron record
316 sub inet_privileges {
318 return $self->{inet} ? 'Y' : 'N';
323 return C4::Context->preference("noissuescharge") || 5;
327 my $self = shift or return;
328 return ($self->fee_amount and $self->fee_amount > $self->fee_limit);
330 sub excessive_fines {
331 my $self = shift or return;
332 return $self->excessive_fees; # excessive_fines is the same thing as excessive_fees for Koha
337 unless ($self->{library_name}) {
338 $self->{library_name} = GetBranchName($self->{branchcode});
340 return $self->{library_name};
347 return "Please contact library staff";
351 return "Please contact library staff";
359 our %patron_example = (
361 name => "David J. Fiander",
364 ptype => 'A', # 'A'dult. Whatever.
365 birthdate => '19640925',
366 address => '2 Meadowvale Dr. St Thomas, ON',
367 home_phone => '(519) 555 1234',
368 email_addr => 'djfiander@hotmail.com',
374 claims_returned => 0,
384 fine_items => ['Computer Time'],
391 From borrowers table:
392 +---------------------+--------------+------+-----+
393 | Field | Type | Null | Key |
394 +---------------------+--------------+------+-----+
395 | borrowernumber | int(11) | NO | PRI |
396 | cardnumber | varchar(16) | YES | UNI |
397 | surname | mediumtext | NO | |
398 | firstname | text | YES | |
399 | title | mediumtext | YES | |
400 | othernames | mediumtext | YES | |
401 | initials | text | YES | |
402 | streetnumber | varchar(10) | YES | |
403 | streettype | varchar(50) | YES | |
404 | address | mediumtext | NO | |
405 | address2 | text | YES | |
406 | city | mediumtext | NO | |
407 | zipcode | varchar(25) | YES | |
408 | country | text | YES | |
409 | email | mediumtext | YES | |
410 | phone | text | YES | |
411 | mobile | varchar(50) | YES | |
412 | fax | mediumtext | YES | |
413 | emailpro | text | YES | |
414 | phonepro | text | YES | |
415 | B_streetnumber | varchar(10) | YES | |
416 | B_streettype | varchar(50) | YES | |
417 | B_address | varchar(100) | YES | |
418 | B_address2 | text | YES | |
419 | B_city | mediumtext | YES | |
420 | B_zipcode | varchar(25) | YES | |
421 | B_country | text | YES | |
422 | B_email | text | YES | |
423 | B_phone | mediumtext | YES | |
424 | dateofbirth | date | YES | |
425 | branchcode | varchar(10) | NO | MUL |
426 | categorycode | varchar(10) | NO | MUL |
427 | dateenrolled | date | YES | |
428 | dateexpiry | date | YES | |
429 | gonenoaddress | tinyint(1) | YES | |
430 | lost | tinyint(1) | YES | |
431 | debarred | tinyint(1) | YES | |
432 | contactname | mediumtext | YES | |
433 | contactfirstname | text | YES | |
434 | contacttitle | text | YES | |
435 | guarantorid | int(11) | YES | |
436 | borrowernotes | mediumtext | YES | |
437 | relationship | varchar(100) | YES | |
438 | ethnicity | varchar(50) | YES | |
439 | ethnotes | varchar(255) | YES | |
440 | sex | varchar(1) | YES | |
441 | password | varchar(30) | YES | |
442 | flags | int(11) | YES | |
443 | userid | varchar(30) | YES | MUL |
444 | opacnote | mediumtext | YES | |
445 | contactnote | varchar(255) | YES | |
446 | sort1 | varchar(80) | YES | |
447 | sort2 | varchar(80) | YES | |
448 | altcontactfirstname | varchar(255) | YES | |
449 | altcontactsurname | varchar(255) | YES | |
450 | altcontactaddress1 | varchar(255) | YES | |
451 | altcontactaddress2 | varchar(255) | YES | |
452 | altcontactaddress3 | varchar(255) | YES | |
453 | altcontactzipcode | varchar(50) | YES | |
454 | altcontactcountry | text | YES | |
455 | altcontactphone | varchar(50) | YES | |
456 | smsalertnumber | varchar(50) | YES | |
457 +---------------------+--------------+------+-----+
463 {message} Message showing patron's credit or debt
464 {noissues} Set if patron owes >$5.00
465 {GNA} Set if patron gone w/o address
466 {message} "Borrower has no valid address"
468 {LOST} Set if patron's card reported lost
469 {message} Message to this effect
471 {DBARRED} Set if patron is debarred
472 {message} Message to this effect
474 {NOTES} Set if patron has notes
475 {message} Notes about patron
476 {ODUES} Set if patron has overdue books
478 {itemlist} ref-to-array: list of overdue books
479 {itemlisttext} Text list of overdue items
480 {WAITING} Set if there are items available that the patron reserved
481 {message} Message to this effect
482 {itemlist} ref-to-array: list of available items