--- /dev/null
+package Koha::Plugins::Tab;
+
+# 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 3 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 Modern::Perl;
+
+use Koha::Exceptions;
+
+use base qw(Class::Accessor);
+
+__PACKAGE__->mk_accessors(qw( title content id ));
+
+=head1 NAME
+
+Koha::Plugins::Tab - Simple base to abstract tabs to be generated by plugins
+
+=head1 DESCRIPTION
+
+Object-oriented class that represents tabs generated by plugins. Error handling on
+mandatory fields is handled here.
+
+=head1 API
+
+=head2 Class methods
+
+=head3 new
+
+ my $tab = Koha::Plugins::Tab->new(
+ {
+ title => 'A title',
+ content => 'Some content'
+ }
+ );
+
+Returns a Koha::Plugins::Tab object representing a plugin-generated tab.
+
+=cut
+
+sub new {
+
+ my ( $class, $params ) = @_;
+
+ Koha::Exceptions::MissingParameter->throw( "Mandatory parameter 'title' missing" )
+ unless defined $params->{ title };
+
+ Koha::Exceptions::MissingParameter->throw( "Mandatory parameter 'content' missing")
+ unless defined $params->{content};
+
+ my $self = {
+ title => $params->{title},
+ content => $params->{content}
+ };
+
+ bless $self, $class;
+ return $self;
+}
+
+1;
});
my @tabs;
foreach my $tab_plugin (@tab_plugins) {
- my @biblio_tabs = $tab_plugin->intranet_catalog_biblio_tab();
- foreach my $tab (@biblio_tabs) {
- $tab->{id} = 'tab-' . $tab->{title};
- $tab->{id} =~ s/[^0-9A-Za-z]+/-/g;
- push @tabs, $tab,
+ my @biblio_tabs;
+
+ try {
+ @biblio_tabs = $tab_plugin->intranet_catalog_biblio_tab();
+ foreach my $tab (@biblio_tabs) {
+ my $tab_id = 'tab-' . $tab->title;
+ $tab_id =~ s/[^0-9A-Za-z]+/-/g;
+ $tab->id( $tab_id );
+ push @tabs, $tab,
+ }
}
+ catch {
+ warn "Error calling 'intranet_catalog_biblio_tab' on the " . $tab_plugin->{class} . "plugin ($_)";
+ };
}
$template->param(
--- /dev/null
+#!/usr/bin/perl
+
+# 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 3 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, see <http://www.gnu.org/licenses>.
+
+use Modern::Perl;
+
+use Test::More tests => 1;
+use Test::Exception;
+
+use Koha::Plugins::Tab;
+
+subtest 'new() tests' => sub {
+ plan tests => 7;
+
+ throws_ok { Koha::Plugins::Tab->new( { title => 'A title' } ); }
+ 'Koha::Exceptions::MissingParameter',
+ 'Exception is thrown on missing content';
+
+ is(
+ "$@",
+ "Mandatory parameter 'content' missing",
+ 'Exception message is correct'
+ );
+
+ throws_ok { Koha::Plugins::Tab->new( { content => 'Some content' } ); }
+ 'Koha::Exceptions::MissingParameter',
+ 'Exception is thrown on missing title';
+
+ is(
+ "$@",
+ "Mandatory parameter 'title' missing",
+ 'Exception message is correct'
+ );
+
+ my $tab = Koha::Plugins::Tab->new(
+ {
+ title => 'A title',
+ content => 'Some content'
+ }
+ );
+
+ is( $tab->title, 'A title', 'title accessor is correct' );
+ is( $tab->content, 'Some content', 'content accessor is correct' );
+
+ my $id = 'calculated-id';
+ $tab->id($id);
+
+ is( $tab->id, $id, 'The id can be calculated and set on runtime' );
+};
use Modern::Perl;
use Koha::Exceptions::Exception;
+use Koha::Plugins::Tab;
+
use Mojo::JSON qw(decode_json);
## Required for all plugins
}
}
-
sub after_item_action {
my ( $self, $params ) = @_;
my $action = $params->{action} // '';
}
}
+sub intranet_catalog_biblio_tab {
+ my @tabs;
+ push @tabs,
+ Koha::Plugins::Tab->new(
+ {
+ title => 'Tab 1',
+ content => 'This is content for tab 1'
+ }
+ );
+
+ push @tabs,
+ Koha::Plugins::Tab->new(
+ {
+ title => 'Tab 2',
+ content => 'This is content for tab 2'
+ }
+ );
+
+ return @tabs;
+}
+
sub _private_sub {
return "";
}