Koha/C4/Linker.pm
Jared Camins-Esakov fa0eb5afd5 Bug 7284: Fix unit test broken by erroneous POD
Signed-off-by: Paul Poulain <paul.poulain@biblibre.com>
2012-03-08 15:24:18 +01:00

121 lines
3 KiB
Perl

package C4::Linker;
# Copyright 2011 C & P Bibliography Services
#
# 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 2 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, write to the Free Software Foundation, Inc.,
# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
=head1 NAME
C4::Linker - Base class for linking authorities to bibliographic records
=head1 SYNOPSIS
use C4::Linker (%params );
=head1 DESCRIPTION
Base class for C4::Linker::X. Subclasses need to provide the following methods
B<get_link ($field)> - return the authid for the authority that should be
linked to the provided MARC::Field object, and a boolean to indicate whether
the match is "fuzzy" (the semantics of "fuzzy" are up to the individual plugin).
In order to handle authority limits, get_link should always end with:
return $self->SUPER::_handle_auth_limit($authid), $fuzzy;
B<flip_heading ($field)> - return a MARC::Field object with the heading flipped
to the preferred form.
=head1 FUNCTIONS
=cut
use strict;
use warnings;
use Carp;
use C4::Context;
use base qw(Class::Accessor);
__PACKAGE__->mk_accessors(qw( ));
sub new {
my $class = shift;
my $param = shift;
my $self = {};
while ( my ( $key, $value ) = each %$param ) {
if ( $key eq 'auth_limit' && $value ) {
my $dbh = C4::Context->dbh;
my $sql =
"SELECT authid FROM auth_header WHERE $value ORDER BY authid ASC";
my $sth = $dbh->prepare($sql);
$sth->execute();
while ( my ($authid) = $sth->fetchrow_array() ) {
push @{ $self->{'auths_to_link'} }, $authid;
}
}
elsif ( $key eq 'options' && $value ) {
foreach my $opt ( split( /\|/, $value ) ) {
$self->{$opt} = 1;
}
}
elsif ($value) {
$self->{$key} = $value;
}
}
bless $self, $class;
return $self;
}
=head2 _handle_auth_limit
return $self->SUPER::_handle_auth_limit($authid), $fuzzy;
Function to be called by subclasses to handle authority record limits.
=cut
sub _handle_auth_limit {
my $self = shift;
my $authid = shift;
if ( defined $self->{'auths_to_link'} && defined $authid && !grep { $_ == $authid }
@{ $self->{'auths_to_link'} } )
{
undef $authid;
}
return $authid;
}
=head2 EXPORT
None by default.
=head1 SEE ALSO
C4::Linker::Default
=head1 AUTHOR
Jared Camins-Esakov, C & P Bibliography Services, E<lt>jcamins@cpbibliography.comE<gt>
=cut
1;
__END__