Koha/Koha/Illrequests.pm
Tomas Cohen Arazi 1a186826e4
Bug 22440: Add Koha::Illrequests->filter_by_visible
This patch introduces a method for filtering out requests that match the
statuses specified on the *ILLHiddenRequestStatuses* system preference.

To test:
1. Apply this patch
2. Run:
   $ kshell
  k$ prove t/db_dependent/Koha/Illrequests.t
=> SUCCESS: Tests pass!
3. Sign off :-D

Signed-off-by: Martin Renvoize <martin.renvoize@ptfs-europe.com>
Signed-off-by: Tomas Cohen Arazi <tomascohen@theke.io>
2023-05-05 09:13:40 -03:00

133 lines
2.8 KiB
Perl

package Koha::Illrequests;
# Copyright PTFS Europe 2016
#
# 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 Koha::Database;
use Koha::Illrequest;
use Koha::Illrequest::Config;
use base qw(Koha::Objects);
=head1 NAME
Koha::Illrequests - Koha Illrequests Object class
=head1 API
=head2 Class methods
##### To be implemented Facade
=head3 new
my $illRequests = Koha::Illrequests->new();
Create an ILLREQUESTS object, a singleton through which we can interact with
ILLREQUEST objects stored in the database or search for ILL candidates at API
backends.
=cut
sub new {
my ( $class, $attributes ) = @_;
my $self = $class->SUPER::new($class, $attributes);
my $config = Koha::Illrequest::Config->new; # <- Necessary
$self->{_config} = $config; # <- Necessary
return $self;
}
=head3 filter_by_visible
my $visible_requests = $requests->filter_by_visible;
Returns a I<Koha::Illrequests> resultset, filtered by statuses that are not listed
as hidden in the I<ILLHiddenRequestStatuses> system preference.
=cut
sub filter_by_visible {
my ($self) = @_;
my $hidden_statuses_string = C4::Context->preference('ILLHiddenRequestStatuses') // q{};
my $hidden_statuses = [ split '\|', $hidden_statuses_string ];
if ( scalar @{$hidden_statuses} ) {
return $self->search(
{
-and => {
status => { 'not in' => $hidden_statuses },
status_alias => [ -or =>
{ 'not in' => $hidden_statuses },
{ '=' => undef }
]
}
}
);
}
return $self;
}
=head3 search_incomplete
my $requests = $illRequests->search_incomplete;
A specialised version of `search`, returning all requests currently
not considered completed.
=cut
sub search_incomplete {
my ( $self ) = @_;
$self->search( {
status => [
-and => { '!=', 'COMP' }, { '!=', 'GENCOMP' }
]
} );
}
=head2 Internal methods
=head3 _type
=cut
sub _type {
return 'Illrequest';
}
=head3 object_class
=cut
sub object_class {
return 'Koha::Illrequest';
}
=head1 AUTHOR
Alex Sassmannshausen <alex.sassmannshausen@ptfs-europe.com>
=cut
1;