Koha/Template/Plugin/AuthorisedValues.pm

   1 package Koha::Template::Plugin::AuthorisedValues;
   2
   3 # Copyright 2012 ByWater Solutions
   4 # Copyright 2013-2014 BibLibre
   5 #
   6 # Koha is free software; you can redistribute it and/or modify it
   7 # under the terms of the GNU General Public License as published by
   8 # the Free Software Foundation; either version 3 of the License, or
   9 # (at your option) any later version.
  10 #
  11 # Koha is distributed in the hope that it will be useful, but
  12 # WITHOUT ANY WARRANTY; without even the implied warranty of
  13 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  14 # GNU General Public License for more details.
  15 #
  16 # You should have received a copy of the GNU General Public License
  17 # along with Koha; if not, see <http://www.gnu.org/licenses>.
  18
  19 use Modern::Perl;
  20
  21 use Template::Plugin;
  22 use base qw( Template::Plugin );
  23
  24 use C4::Koha;
  25 use Koha::AuthorisedValues;
  26
  27 sub GetByCode {
  28     my ( $self, $category, $code, $opac ) = @_;
  29     my $av = Koha::AuthorisedValues->search({ category => $category, authorised_value => $code });
  30     return $av->count
  31             ? $opac
  32                 ? $av->next->opac_description
  33                 : $av->next->lib
  34             : '';
  35 }
  36
  37 sub Get {
  38     my ( $self, $category, $opac ) = @_;
  39     return GetAuthorisedValues( $category, $opac );
  40 }
  41
  42 sub GetAuthValueDropbox {
  43     my ( $self, $category, $default ) = @_;
  44     return C4::Koha::GetAuthvalueDropbox($category, $default);
  45 }
  46
  47 sub GetCategories {
  48     my ( $self, $params ) = @_;
  49     my $selected = $params->{selected};
  50     my @categories = Koha::AuthorisedValues->new->categories;
  51     return [
  52         map {
  53             {
  54                 category => $_,
  55                 ( ( $selected and $selected eq $_ ) ? ( selected => 1 ) : () ),
  56             }
  57         } @categories
  58     ];
  59 }
  60
  61 1;
  62
  63 =head1 NAME
  64
  65 Koha::Template::Plugin::AuthorisedValues - TT Plugin for authorised values
  66
  67 =head1 SYNOPSIS
  68
  69 [% USE AuthorisedValues %]
  70
  71 [% AuthorisedValues.GetByCode( 'CATEGORY', 'AUTHORISED_VALUE_CODE', 'IS_OPAC' ) %]
  72
  73 [% AuthorisedValues.GetAuthValueDropbox( $category, $default ) %]
  74
  75 =head1 ROUTINES
  76
  77 =head2 GetByCode
  78
  79 In a template, you can get the description for an authorised value with
  80 the following TT code: [% AuthorisedValues.GetByCode( 'CATEGORY', 'AUTHORISED_VALUE_CODE', 'IS_OPAC' ) %]
  81
  82 =head2 GetAuthValueDropbox
  83
  84 The parameters are identical to those used by the subroutine C4::Koha::GetAuthValueDropbox
  85
  86 =head1 AUTHOR
  87
  88 Kyle M Hall <kyle@bywatersolutions.com>
  89
  90 Jonathan Druart <jonathan.druart@biblibre.com>
  91
  92 =cut