C4/ItemType.pm

   1 package C4::ItemType;
   2
   3 # Copyright Liblime 2009
   4 # Parts Copyright Tamil 2011
   5 #
   6 # This file is part of Koha.
   7 #
   8 # Koha is free software; you can redistribute it and/or modify it
   9 # under the terms of the GNU General Public License as published by
  10 # the Free Software Foundation; either version 3 of the License, or
  11 # (at your option) any later version.
  12 #
  13 # Koha is distributed in the hope that it will be useful, but
  14 # WITHOUT ANY WARRANTY; without even the implied warranty of
  15 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  16 # GNU General Public License for more details.
  17 #
  18 # You should have received a copy of the GNU General Public License
  19 # along with Koha; if not, see <http://www.gnu.org/licenses>.
  20
  21 use strict;
  22 use warnings;
  23 use C4::Context;
  24 use C4::Languages;
  25 use Encode qw( encode );
  26
  27 our $AUTOLOAD;
  28
  29
  30
  31
  32 =head1 NAME
  33
  34 C4::ItemType - objects from the itemtypes table
  35
  36 =head1 SYNOPSIS
  37
  38     use C4::ItemType;
  39     my @itemtypes = C4::ItemType->all;
  40     print join("\n", map { $_->description } @itemtypes), "\n";
  41
  42 =head1 DESCRIPTION
  43
  44 Objects of this class represent a row in the C<itemtypes> table.
  45
  46 Currently, the bare minimum for using this as a read-only data source has
  47 been implemented.  The API was designed to make it easy to transition to
  48 an ORM later on.
  49
  50 =head1 API
  51
  52 =head2 Class Methods
  53
  54 =cut
  55
  56 =head3 C4::ItemType->new(\%opts)
  57
  58 Given a hashref, a new (in-memory) C4::ItemType object will be instantiated.
  59 The database is not touched.
  60
  61 =cut
  62
  63 sub new {
  64     my ($class, $opts) = @_;
  65     bless $opts => $class;
  66 }
  67
  68
  69
  70
  71 =head3 C4::ItemType->all
  72
  73 This returns all the itemtypes as objects.  By default they're ordered by
  74 C<description>.
  75
  76 =cut
  77
  78 sub all {
  79     my ($class) = @_;
  80     my $dbh = C4::Context->dbh;
  81
  82     my $language = C4::Languages::getlanguage();
  83     my @itypes;
  84     for ( @{$dbh->selectall_arrayref(q|
  85         SELECT *,
  86             COALESCE( localization.translation, itemtypes.description ) AS translated_description
  87         FROM itemtypes
  88         LEFT JOIN localization ON itemtypes.itemtype = localization.code
  89             AND localization.entity = 'itemtypes'
  90             AND localization.lang = ?
  91         ORDER BY description
  92     |, { Slice => {} }, $language)} )
  93     {
  94         push @itypes, $class->new($_);
  95     }
  96     return @itypes;
  97 }
  98
  99
 100
 101
 102 =head3 C4::ItemType->get
 103
 104 Return the itemtype indicated by the itemtype given as argument, as
 105 an object.
 106
 107 =cut
 108
 109 sub get {
 110     my ($class, $itemtype) = @_;
 111
 112     return unless defined $itemtype;
 113
 114     my $dbh = C4::Context->dbh;
 115
 116     my $data = $dbh->selectrow_hashref(
 117         "SELECT * FROM itemtypes WHERE itemtype = ?", undef, $itemtype
 118     );
 119     return unless defined $data;
 120     return $class->new($data);
 121 }
 122
 123
 124
 125
 126 =head2 Object Methods
 127
 128 These are read-only accessors for attributes of a C4::ItemType object.
 129
 130 =head3 $itemtype->itemtype
 131
 132 =cut
 133
 134 =head3 $itemtype->description
 135
 136 =cut
 137
 138 =head3 $itemtype->renewalsallowed
 139
 140 =cut
 141
 142 =head3 $itemtype->rentalcharge
 143
 144 =cut
 145
 146 =head3 $itemtype->notforloan
 147
 148 =cut
 149
 150 =head3 $itemtype->imageurl
 151
 152 =cut
 153
 154 =head3 $itemtype->checkinmsg
 155
 156 =cut
 157
 158 =head3 $itemtype->summary
 159
 160 =cut
 161
 162 sub AUTOLOAD {
 163     my $self = shift;
 164     my $attr = $AUTOLOAD;
 165     $attr =~ s/.*://;
 166     if (exists $self->{$attr}) {
 167         return $self->{$attr};
 168     } else {
 169         return undef;
 170     }
 171 }
 172
 173 sub DESTROY { }
 174
 175
 176
 177 # ack itemtypes | grep '\.pm' | awk '{ print $1 }' | sed 's/:.*$//' | sort | uniq | sed -e 's,/,::,g' -e 's/\.pm//' -e 's/^/L<C4::/' -e 's/$/>,/'
 178
 179 =head1 SEE ALSO
 180
 181 The following modules make reference to the C<itemtypes> table.
 182
 183 L<C4::Biblio>,
 184 L<C4::Circulation>,
 185 L<C4::Context>,
 186 L<C4::Items>,
 187 L<C4::Koha>,
 188 L<C4::Labels>,
 189 L<C4::Overdues>,
 190 L<C4::Reserves>,
 191 L<C4::Search>,
 192 L<C4::XSLT>
 193
 194
 195
 196 =head1 AUTHOR
 197
 198 John Beppu <john.beppu@liblime.com>
 199
 200 =cut
 201
 202 1;