Koha/ItemType.pm

   1 package Koha::ItemType;
   2
   3 # This file is part of Koha.
   4 #
   5 # Koha is free software; you can redistribute it and/or modify it under the
   6 # terms of the GNU General Public License as published by the Free Software
   7 # Foundation; either version 3 of the License, or (at your option) any later
   8 # version.
   9 #
  10 # Koha is distributed in the hope that it will be useful, but WITHOUT ANY
  11 # WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
  12 # A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
  13 #
  14 # You should have received a copy of the GNU General Public License along
  15 # with Koha; if not, write to the Free Software Foundation, Inc.,
  16 # 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  17
  18 use Modern::Perl;
  19
  20 use Carp;
  21
  22 use C4::Koha;
  23 use C4::Languages;
  24 use Koha::Database;
  25 use Koha::IssuingRules;
  26 use Koha::Localizations;
  27
  28 use base qw(Koha::Object);
  29
  30 =head1 NAME
  31
  32 Koha::ItemType - Koha Item type Object class
  33
  34 =head1 API
  35
  36 =head2 Class Methods
  37
  38 =cut
  39
  40 =head3 image_location
  41
  42 =cut
  43
  44 sub image_location {
  45     my ( $self, $interface ) = @_;
  46     return C4::Koha::getitemtypeimagelocation( $interface, $self->SUPER::imageurl );
  47 }
  48
  49 =head3 translated_description
  50
  51 =cut
  52
  53 sub translated_description {
  54     my ( $self, $lang ) = @_;
  55     if ( my $translated_description = eval { $self->get_column('translated_description') } ) {
  56         # If the value has already been fetched (eg. from sarch_with_localization),
  57         # do not search for it again
  58         # Note: This is a bit hacky but should be fast
  59         return $translated_description
  60              ? $translated_description
  61              : $self->description;
  62     }
  63     $lang ||= C4::Languages::getlanguage;
  64     my $translated_description = Koha::Localizations->search({
  65         code => $self->itemtype,
  66         entity => 'itemtypes',
  67         lang => $lang
  68     })->next;
  69     return $translated_description
  70          ? $translated_description->translation
  71          : $self->description;
  72 }
  73
  74 =head3 translated_descriptions
  75
  76 =cut
  77
  78 sub translated_descriptions {
  79     my ( $self ) = @_;
  80     my @translated_descriptions = Koha::Localizations->search(
  81         {   entity => 'itemtypes',
  82             code   => $self->itemtype,
  83         }
  84     );
  85     return [ map {
  86         {
  87             lang => $_->lang,
  88             translation => $_->translation,
  89         }
  90     } @translated_descriptions ];
  91 }
  92
  93
  94
  95 =head3 can_be_deleted
  96
  97 my $can_be_deleted = Koha::ItemType->can_be_deleted();
  98
  99 Counts up the number of biblioitems and items with itemtype (code) and hands back the combined number of biblioitems and items with the itemtype
 100
 101 =cut
 102
 103 sub can_be_deleted {
 104     my ($self) = @_;
 105     my $nb_items = Koha::Items->search( { itype => $self->itemtype } )->count;
 106     my $nb_biblioitems = Koha::Biblioitems->search( { itemtype => $self->itemtype } )->count;
 107     return $nb_items + $nb_biblioitems == 0 ? 1 : 0;
 108 }
 109
 110 =head3 may_article_request
 111
 112     Returns true if it is likely possible to make an article request for
 113     this item type.
 114     Optional parameter: categorycode (for patron).
 115
 116 =cut
 117
 118 sub may_article_request {
 119     my ( $self, $params ) = @_;
 120     return q{} if !C4::Context->preference('ArticleRequests');
 121     my $itemtype = $self->itemtype;
 122     my $category = $params->{categorycode};
 123
 124     my $guess = Koha::IssuingRules->guess_article_requestable_itemtypes({
 125         $category ? ( categorycode => $category ) : (),
 126     });
 127     return ( $guess->{ $itemtype // q{} } || $guess->{ '*' } ) ? 1 : q{};
 128 }
 129
 130 =head3 type
 131
 132 =cut
 133
 134 sub _type {
 135     return 'Itemtype';
 136 }
 137
 138 1;