Koha/Template/Plugin/Koha.pm

   1 package Koha::Template::Plugin::Koha;
   2
   3 # Copyright ByWater Solutions 2013
   4
   5 # This file is part of Koha.
   6 #
   7 # Koha is free software; you can redistribute it and/or modify it under the
   8 # terms of the GNU General Public License as published by the Free Software
   9 # Foundation; either version 2 of the License, or (at your option) any later
  10 # version.
  11 #
  12 # Koha is distributed in the hope that it will be useful, but WITHOUT ANY
  13 # WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
  14 # A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
  15 #
  16 # You should have received a copy of the GNU General Public License along
  17 # with Koha; if not, write to the Free Software Foundation, Inc.,
  18 # 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  19
  20 use Modern::Perl;
  21 use Encode qw( encode );
  22
  23 use base qw( Template::Plugin );
  24
  25 use C4::Context;
  26
  27 =pod
  28
  29 This plugin contains various Koha replated Template Toolkit functions
  30 to help streamline Koha and to move logic from the Perl code into the
  31 Templates when it makes sense to do so.
  32
  33 To use, first, include the line '[% USE Koha %]' at the top
  34 of the template to enable the plugin.
  35
  36 For example: [% IF Koha.Preference( 'MyPreference ) == 'SettingA' %]
  37 removes the necessity of setting a template variable in Perl code for
  38 each and every system preference, even if no evaluation of the setting
  39 is necessary.
  40
  41 =cut
  42
  43 sub Preference {
  44     my ( $self, $pref ) = @_;
  45     return encode('UTF-8', C4::Context->preference( $pref ) );
  46 }
  47
  48 sub Version {
  49     my $version_string = C4::Context::KOHAVERSION;
  50     my ($major,$minor,$maintenance,$development) = split('\.',$version_string);
  51
  52     return {
  53         major       => $major,
  54         release     => $major . "." . $minor,
  55         maintenance => $major . "." . $minor . "." . $maintenance,
  56         development => ( $development ne '000' )
  57                             ? $development
  58                             : undef
  59     };
  60 }
  61
  62 1;