Koha/C4/Category.pm
Jonathan Druart acbfe26c9e Bug 7919 : Display of values depending on the connexion library
In a librairies network, we would like to declare specific values just
for one (or more) library.
Here we implement the ability to associate categories, patron attributes
types and/or authorised_values with librairies (branches).

This patch adds 3 new association tables:
- categories_branches ( association table between categories and branches )
- authorised_values_branches ( association table between
  authorised_values and branches )
- borrower_attribute_types_branches (association table between
  borrower_attribute_types and branches )

Plan test:
  - Create (or modify) categories, patron attributes and
    authorised_values and link it with one (or more) library.
  - Set one of these librairies
  - Go to one of the multiple pages where this specific value must be displayed
    and check that it does appear.
  - Set a library not concerned.
  - Check on the same pages this value is doest not appear.

A page list:
cataloguing/addbiblio.pl
cataloguing/additems.pl
members/members-home.pl
members/memberentry.pl
acqui/neworderempty.pl
tools/modborrowers.pl
and others :)

Please say me if filters don't work on some pages.

Signed-off-by: Delaye Stephane <stephane.delaye@biblibre.com>
Signed-off-by: Koha Team Lyon 3 <koha@univ-lyon3.fr>
Signed-off-by: Paul Poulain <paul.poulain@biblibre.com>
Signed-off-by: Melia Meggs <melia@bywatersolutions.com>
Signed-off-by: Jared Camins-Esakov <jcamins@cpbibliography.com>
2012-12-05 10:10:57 -05:00

181 lines
3.3 KiB
Perl

package C4::Category;
# Copyright 2009 Liblime
# Parts Copyright 2011 Tamil
#
# 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.
use strict;
use warnings;
use C4::Context;
our $AUTOLOAD;
=head1 NAME
C4::Category - objects from the categories table
=head1 SYNOPSIS
use C4::Category;
my @categories = C4::Category->all;
print join("\n", map { $_->description } @categories), "\n";
=head1 DESCRIPTION
Objects of this class represent a row in the C<categories> table.
Currently, the bare minimum for using this as a read-only data source has
been implemented. The API was designed to make it easy to transition to
an ORM later on.
=head1 API
=head2 Class Methods
=cut
=head3 C4::Category->new(\%opts)
Given a hashref, a new (in-memory) C4::Category object will be instantiated.
The database is not touched.
=cut
sub new {
my ($class, $opts) = @_;
bless $opts => $class;
}
=head3 C4::Category->all
This returns all the categories as objects. By default they're ordered by
C<description>.
=cut
sub all {
my ( $class ) = @_;
my $branch_limit = C4::Context->userenv ? C4::Context->userenv->{"branch"} : "";
my $dbh = C4::Context->dbh;
# The categories table is small enough for
# `SELECT *` to be harmless.
my $query = "SELECT * FROM categories";
$query .= qq{
LEFT JOIN categories_branches ON categories_branches.categorycode = categories.categorycode
WHERE categories_branches.branchcode = ? OR categories_branches.branchcode IS NULL
} if $branch_limit;
$query .= " ORDER BY description";
return map { $class->new($_) } @{
$dbh->selectall_arrayref(
$query,
{ Slice => {} },
$branch_limit ? $branch_limit : ()
)
};
}
=head2 Object Methods
These are read-only accessors for attributes of a C4::Category object.
=head3 $category->categorycode
=cut
=head3 $category->description
=cut
=head3 $category->enrolmentperiod
=cut
=head3 $category->upperagelimit
=cut
=head3 $category->dateofbirthrequired
=cut
=head3 $category->finetype
=cut
=head3 $category->bulk
=cut
=head3 $category->enrolmentfee
=cut
=head3 $category->overduenoticerequired
=cut
=head3 $category->issuelimit
=cut
=head3 $category->reservefee
=cut
=head3 $category->category_type
=cut
sub AUTOLOAD {
my $self = shift;
my $attr = $AUTOLOAD;
$attr =~ s/.*://;
if (exists $self->{$attr}) {
return $self->{$attr};
} else {
return undef;
}
}
sub DESTROY { }
=head1 SEE ALSO
The following modules make reference to the C<categories> table.
L<C4::Members>, L<C4::Overdues>, L<C4::Reserves>
=head1 AUTHOR
John Beppu <john.beppu@liblime.com>
=cut
1;