Bug 25954: (follow-up) Correct label "for" attribute
[koha-ffzg.git] / ill / ill-requests.pl
index f6572e4..dfc27ef 100755 (executable)
@@ -4,18 +4,18 @@
 # Copyright 2014 PTFS-Europe Ltd
 #
 # 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 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.
+# 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.
+# 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;
 
@@ -23,9 +23,17 @@ use CGI;
 
 use C4::Auth;
 use C4::Output;
+use Koha::Notice::Templates;
 use Koha::AuthorisedValues;
+use Koha::Illcomment;
 use Koha::Illrequests;
+use Koha::Illrequest::Availability;
 use Koha::Libraries;
+use Koha::Token;
+
+use Try::Tiny;
+use URI::Escape;
+use JSON;
 
 our $cgi = CGI->new;
 my $illRequests = Koha::Illrequests->new;
@@ -50,203 +58,409 @@ my ( $template, $patronnumber, $cookie ) = get_template_and_user( {
     flagsrequired => { ill => '*' },
 } );
 
-if ( $op eq 'illview' ) {
-    # View the details of an ILL
-    my $request = Koha::Illrequests->find($params->{illrequest_id});
-
-    $template->param(
-        request => $request
-    );
-
-} elsif ( $op eq 'create' ) {
-    # We're in the process of creating a request
-    my $request = Koha::Illrequest->new
-        ->load_backend($params->{backend});
-    my $backend_result = $request->backend_create($params);
-    $template->param(
-        whole   => $backend_result,
-        request => $request
-    );
-    handle_commit_maybe($backend_result, $request);
-
-} elsif ( $op eq 'confirm' ) {
-    # Backend 'confirm' method
-    # confirm requires a specific request, so first, find it.
-    my $request = Koha::Illrequests->find($params->{illrequest_id});
-    my $backend_result = $request->backend_confirm($params);
-    $template->param(
-        whole   => $backend_result,
-        request => $request,
-    );
-
-    # handle special commit rules & update type
-    handle_commit_maybe($backend_result, $request);
-
-} elsif ( $op eq 'cancel' ) {
-    # Backend 'cancel' method
-    # cancel requires a specific request, so first, find it.
-    my $request = Koha::Illrequests->find($params->{illrequest_id});
-    my $backend_result = $request->backend_cancel($params);
-    $template->param(
-        whole   => $backend_result,
-        request => $request,
-    );
-
-    # handle special commit rules & update type
-    handle_commit_maybe($backend_result, $request);
-
-} elsif ( $op eq 'edit_action' ) {
-    # Handle edits to the Illrequest object.
-    # (not the Illrequestattributes)
-    # We simulate the API for backend requests for uniformity.
-    # So, init:
-    my $request = Koha::Illrequests->find($params->{illrequest_id});
-    if ( !$params->{stage} ) {
-        my $backend_result = {
-            error   => 0,
-            status  => '',
-            message => '',
-            method  => 'edit_action',
-            stage   => 'init',
-            next    => '',
-            value   => {}
-        };
+# Are we able to actually work?
+my $cfg = Koha::Illrequest::Config->new;
+my $backends = $cfg->available_backends;
+my $has_branch = $cfg->has_branch;
+my $backends_available = ( scalar @{$backends} > 0 );
+$template->param(
+    backends_available => $backends_available,
+    has_branch         => $has_branch
+);
+
+if ( $backends_available ) {
+    if ( $op eq 'illview' ) {
+        # View the details of an ILL
+        my $request = Koha::Illrequests->find($params->{illrequest_id});
+
+        # Get the details for notices that can be sent from here
+        my $notices = Koha::Notice::Templates->search(
+            {
+                module => 'ill',
+                code => { -in => [ 'ILL_PICKUP_READY' ,'ILL_REQUEST_UNAVAIL' ] },
+            },
+            {
+                columns => [ qw/code name/ ],
+                distinct => 1
+            }
+        )->unblessed;
+
+        $template->param(
+            notices    => $notices,
+            request    => $request,
+            csrf_token => Koha::Token->new->generate_csrf({
+                session_id => scalar $cgi->cookie('CGISESSID'),
+            }),
+            ( $params->{tran_error} ?
+                ( tran_error => $params->{tran_error} ) : () ),
+            ( $params->{tran_success} ?
+                ( tran_success => $params->{tran_success} ) : () ),
+        );
+
+    } elsif ( $op eq 'create' ) {
+        # We're in the process of creating a request
+        my $request = Koha::Illrequest->new->load_backend( $params->{backend} );
+        # Does this backend enable us to insert an availability stage and should
+        # we? If not, proceed as normal.
+        if (
+            # If the user has elected to continue with the request despite
+            # having viewed availability info, this flag will be set
+            C4::Context->preference("ILLCheckAvailability")
+              && !$params->{checked_availability}
+              && $request->_backend_capability( 'should_display_availability', $params )
+        ) {
+            # Establish which of the installed availability providers
+            # can service our metadata
+            my $availability = Koha::Illrequest::Availability->new($params);
+            my $services = $availability->get_services({
+                ui_context => 'staff'
+            });
+            if (scalar @{$services} > 0) {
+                # Modify our method so we use the correct part of the
+                # template
+                $op = 'availability';
+                $params->{method} = 'availability';
+                delete $params->{stage};
+                # Prepare the metadata we're sending them
+                my $metadata = $availability->prep_metadata($params);
+                $template->param(
+                    whole         => $params,
+                    metadata      => $metadata,
+                    services_json => scalar encode_json($services),
+                    services      => $services
+                );
+            } else {
+                # No services can process this metadata, so continue as normal
+                my $backend_result = $request->backend_create($params);
+                $template->param(
+                    whole   => $backend_result,
+                    request => $request
+                );
+                handle_commit_maybe($backend_result, $request);
+            }
+        } else {
+            my $backend_result = $request->backend_create($params);
+            $template->param(
+                whole   => $backend_result,
+                request => $request
+            );
+            handle_commit_maybe($backend_result, $request);
+        }
+
+    } elsif ( $op eq 'migrate' ) {
+        # We're in the process of migrating a request
+        my $request = Koha::Illrequests->find($params->{illrequest_id});
+        my $backend_result;
+        if ( $params->{backend} ) {
+            my $new_request = Koha::Illrequest->new->load_backend( $params->{backend} );
+            $backend_result = $new_request->backend_migrate($params);
+            if ($backend_result) {
+                $template->param(
+                    whole   => $backend_result,
+                    request => $new_request
+                );
+                $request = $new_request;
+            } else {
+                # Backend failure, redirect back to illview
+                print $cgi->redirect( '/cgi-bin/koha/ill/ill-requests.pl'
+                      . '?method=illview'
+                      . '&illrequest_id='
+                      . $request->id
+                      . '&error=migrate_target' );
+                exit;
+            }
+        }
+        else {
+            $backend_result = $request->backend_migrate($params);
+            $template->param(
+                whole   => $backend_result,
+                request => $request
+            );
+        }
+        handle_commit_maybe( $backend_result, $request );
+
+    } elsif ( $op eq 'confirm' ) {
+        # Backend 'confirm' method
+        # confirm requires a specific request, so first, find it.
+        my $request = Koha::Illrequests->find($params->{illrequest_id});
+        my $backend_result = $request->backend_confirm($params);
         $template->param(
             whole   => $backend_result,
-            request => $request
+            request => $request,
         );
-    } else {
-        # Commit:
-        # Save the changes
-        $request->borrowernumber($params->{borrowernumber});
-        $request->biblio_id($params->{biblio_id});
-        $request->branchcode($params->{branchcode});
-        $request->notesopac($params->{notesopac});
-        $request->notesstaff($params->{notesstaff});
-        $request->store;
-        my $backend_result = {
-            error   => 0,
-            status  => '',
-            message => '',
-            method  => 'edit_action',
-            stage   => 'commit',
-            next    => 'illlist',
-            value   => {}
-        };
-        handle_commit_maybe($backend_result, $request);
-    }
 
-} elsif ( $op eq 'moderate_action' ) {
-    # Moderate action is required for an ILL submodule / syspref.
-    # Currently still needs to be implemented.
-    redirect_to_list();
+        # handle special commit rules & update type
+        handle_commit_maybe($backend_result, $request);
 
-} elsif ( $op eq 'delete_confirm') {
-    my $request = Koha::Illrequests->find($params->{illrequest_id});
+    } elsif ( $op eq 'cancel' ) {
+        # Backend 'cancel' method
+        # cancel requires a specific request, so first, find it.
+        my $request = Koha::Illrequests->find($params->{illrequest_id});
+        my $backend_result = $request->backend_cancel($params);
+        $template->param(
+            whole   => $backend_result,
+            request => $request,
+        );
 
-    $template->param(
-        request => $request
-    );
+        # handle special commit rules & update type
+        handle_commit_maybe($backend_result, $request);
 
-} elsif ( $op eq 'delete' ) {
+    } elsif ( $op eq 'edit_action' ) {
+        # Handle edits to the Illrequest object.
+        # (not the Illrequestattributes)
+        # We simulate the API for backend requests for uniformity.
+        # So, init:
+        my $request = Koha::Illrequests->find($params->{illrequest_id});
+        if ( !$params->{stage} ) {
+            my $backend_result = {
+                error   => 0,
+                status  => '',
+                message => '',
+                method  => 'edit_action',
+                stage   => 'init',
+                next    => '',
+                value   => {}
+            };
+            $template->param(
+                whole          => $backend_result,
+                request        => $request
+            );
+        } else {
+            # Commit:
+            # Save the changes
+            $request->borrowernumber($params->{borrowernumber});
+            $request->biblio_id($params->{biblio_id});
+            $request->branchcode($params->{branchcode});
+            $request->price_paid($params->{price_paid});
+            $request->notesopac($params->{notesopac});
+            $request->notesstaff($params->{notesstaff});
+            my $alias = (length $params->{status_alias} > 0) ?
+                $params->{status_alias} :
+                "-1";
+            $request->status_alias($alias);
+            $request->store;
+            my $backend_result = {
+                error   => 0,
+                status  => '',
+                message => '',
+                method  => 'edit_action',
+                stage   => 'commit',
+                next    => 'illlist',
+                value   => {}
+            };
+            handle_commit_maybe($backend_result, $request);
+        }
 
-    # Check if the request is confirmed, if not, redirect
-    # to the confirmation view
-    if ($params->{confirmed} == 1) {
-        # We simply delete the request...
-        my $request = Koha::Illrequests->find(
-            $params->{illrequest_id}
-        )->delete;
-        # ... then return to list view.
+    } elsif ( $op eq 'moderate_action' ) {
+        # Moderate action is required for an ILL submodule / syspref.
+        # Currently still needs to be implemented.
         redirect_to_list();
-    } else {
-        print $cgi->redirect(
-            "/cgi-bin/koha/ill/ill-requests.pl?" .
-            "method=delete_confirm&illrequest_id=" .
-            $params->{illrequest_id});
-    }
 
-} elsif ( $op eq 'mark_completed' ) {
-    my $request = Koha::Illrequests->find($params->{illrequest_id});
-    my $backend_result = $request->mark_completed($params);
-    $template->param(
-        whole => $backend_result,
-        request => $request,
-    );
-
-    # handle special commit rules & update type
-    handle_commit_maybe($backend_result, $request);
-
-} elsif ( $op eq 'generic_confirm' ) {
-    my $request = Koha::Illrequests->find($params->{illrequest_id});
-    $params->{current_branchcode} = C4::Context->mybranch;
-    my $backend_result = $request->generic_confirm($params);
-    $template->param(
-        whole => $backend_result,
-        request => $request,
-    );
-
-    # handle special commit rules & update type
-    handle_commit_maybe($backend_result, $request);
-
-} elsif ( $op eq 'illlist') {
-    # Display all current ILLs
-    my $requests = $illRequests->search();
-
-    $template->param(
-        requests => $requests
-    );
-
-    # If we receive a pre-filter, make it available to the template
-    my $possible_filters = ['borrowernumber'];
-    my $active_filters = [];
-    foreach my $filter(@{$possible_filters}) {
-        if ($params->{$filter}) {
-            push @{$active_filters},
-                { name => $filter, value => $params->{$filter}};
+    } elsif ( $op eq 'delete_confirm') {
+        my $request = Koha::Illrequests->find($params->{illrequest_id});
+
+        $template->param(
+            request => $request
+        );
+
+    } elsif ( $op eq 'delete' ) {
+
+        # Check if the request is confirmed, if not, redirect
+        # to the confirmation view
+        if ($params->{confirmed}) {
+            # We simply delete the request...
+            Koha::Illrequests->find( $params->{illrequest_id} )->delete;
+            # ... then return to list view.
+            redirect_to_list();
+        } else {
+            print $cgi->redirect(
+                "/cgi-bin/koha/ill/ill-requests.pl?" .
+                "method=delete_confirm&illrequest_id=" .
+                $params->{illrequest_id});
+            exit;
         }
-    }
-    if (scalar @{$active_filters} > 0) {
+
+    } elsif ( $op eq 'mark_completed' ) {
+        my $request = Koha::Illrequests->find($params->{illrequest_id});
+        my $backend_result = $request->mark_completed($params);
         $template->param(
-            prefilters => $active_filters
+            whole => $backend_result,
+            request => $request,
+        );
+
+        # handle special commit rules & update type
+        handle_commit_maybe($backend_result, $request);
+
+    } elsif ( $op eq 'generic_confirm' ) {
+        my $backend_result;
+        my $request;
+        try {
+            $request = Koha::Illrequests->find($params->{illrequest_id});
+            $params->{current_branchcode} = C4::Context->mybranch;
+            $backend_result = $request->generic_confirm($params);
+
+            $template->param(
+                whole => $backend_result,
+                request => $request,
+            );
+
+            # Prepare availability searching, if required
+            # Get the definition for the z39.50 plugin
+            if ( C4::Context->preference('ILLCheckAvailability') ) {
+                my $availability = Koha::Illrequest::Availability->new($request->metadata);
+                my $services = $availability->get_services({
+                    ui_context => 'partners',
+                    metadata => {
+                        name => 'ILL availability - z39.50'
+                    }
+                });
+                # Only pass availability searching stuff to the template if
+                # appropriate
+                if ( scalar @{$services} > 0 ) {
+                    my $metadata = $availability->prep_metadata($request->metadata);
+                    $template->param( metadata => $metadata );
+                    $template->param(
+                        services_json => scalar encode_json($services)
+                    );
+                    $template->param( services => $services );
+                }
+            }
+
+            $template->param( error => $params->{error} )
+                if $params->{error};
+        }
+        catch {
+            my $error;
+            if ( ref($_) eq 'Koha::Exceptions::Ill::NoTargetEmail' ) {
+                $error = 'no_target_email';
+            }
+            elsif ( ref($_) eq 'Koha::Exceptions::Ill::NoLibraryEmail' ) {
+                $error = 'no_library_email';
+            }
+            else {
+                $error = 'unknown_error';
+            }
+            print $cgi->redirect(
+                "/cgi-bin/koha/ill/ill-requests.pl?" .
+                "method=generic_confirm&illrequest_id=" .
+                $params->{illrequest_id} .
+                "&error=$error" );
+            exit;
+        };
+
+        # handle special commit rules & update type
+        handle_commit_maybe($backend_result, $request);
+    } elsif ( $op eq 'check_out') {
+        my $request = Koha::Illrequests->find($params->{illrequest_id});
+        my $backend_result = $request->check_out($params);
+        $template->param(
+            params  => $params,
+            whole   => $backend_result,
+            request => $request
+        );
+    } elsif ( $op eq 'illlist') {
+
+        # If we receive a pre-filter, make it available to the template
+        my $possible_filters = ['borrowernumber'];
+        my $active_filters = {};
+        foreach my $filter(@{$possible_filters}) {
+            if ($params->{$filter}) {
+                # We shouldn't need to escape $filter here since we're using
+                # a whitelist, but just to be sure...
+                $active_filters->{uri_escape_utf8($filter)} =
+                    uri_escape_utf8(scalar $params->{$filter});
+            }
+        }
+        my @tpl_arr = ();
+        if (keys %{$active_filters}) {
+            foreach my $key (keys %{$active_filters}) {
+                push @tpl_arr, $key . "=" . $active_filters->{$key};
+            }
+        }
+        $template->param(
+            prefilters => join("&", @tpl_arr)
+        );
+    } elsif ( $op eq "save_comment" ) {
+        die "Wrong CSRF token" unless Koha::Token->new->check_csrf({
+           session_id => scalar $cgi->cookie('CGISESSID'),
+           token      => scalar $cgi->param('csrf_token'),
+        });
+        my $comment = Koha::Illcomment->new({
+            illrequest_id  => scalar $params->{illrequest_id},
+            borrowernumber => $patronnumber,
+            comment        => scalar $params->{comment},
+        });
+        $comment->store();
+        # Redirect to view the whole request
+        print $cgi->redirect("/cgi-bin/koha/ill/ill-requests.pl?method=illview&illrequest_id=".
+            scalar $params->{illrequest_id}
         );
+        exit;
+
+    } elsif ( $op eq "send_notice" ) {
+        my $illrequest_id = $params->{illrequest_id};
+        my $request = Koha::Illrequests->find($illrequest_id);
+        my $ret = $request->send_patron_notice($params->{notice_code});
+        my $append = '';
+        if ($ret->{result} && scalar @{$ret->{result}->{success}} > 0) {
+            $append .= '&tran_success=' . join(',', @{$ret->{result}->{success}});
+        }
+        if ($ret->{result} && scalar @{$ret->{result}->{fail}} > 0) {
+            $append .= '&tran_fail=' . join(',', @{$ret->{result}->{fail}}.join(','));
+        }
+        # Redirect to view the whole request
+        print $cgi->redirect(
+            "/cgi-bin/koha/ill/ill-requests.pl?method=illview&illrequest_id=".
+            scalar $params->{illrequest_id} . $append
+        );
+        exit;
+    } else {
+        my $request = Koha::Illrequests->find($params->{illrequest_id});
+        my $backend_result = $request->custom_capability($op, $params);
+        $template->param(
+            whole => $backend_result,
+            request => $request,
+        );
+
+        # handle special commit rules & update type
+        handle_commit_maybe($backend_result, $request);
     }
-} else {
-    my $request = Koha::Illrequests->find($params->{illrequest_id});
-    my $backend_result = $request->custom_capability($op, $params);
-    $template->param(
-        whole => $backend_result,
-        request => $request,
-    );
-
-    # handle special commit rules & update type
-    handle_commit_maybe($backend_result, $request);
 }
 
-# Get a list of backends
-my $ir = Koha::Illrequest->new;
-
 $template->param(
-    backends    => $ir->available_backends,
-    media       => [ "Book", "Article", "Journal" ],
-    query_type  => $op,
-    branches    => Koha::Libraries->search->unblessed,
-    here_link   => "/cgi-bin/koha/ill/ill-requests.pl"
+    backends   => $backends,
+    types      => [ "Book", "Article", "Journal" ],
+    query_type => $op,
+    branches   => scalar Koha::Libraries->search,
 );
 
 output_html_with_http_headers( $cgi, $cookie, $template->output );
 
 sub handle_commit_maybe {
     my ( $backend_result, $request ) = @_;
+
     # We need to special case 'commit'
     if ( $backend_result->{stage} eq 'commit' ) {
         if ( $backend_result->{next} eq 'illview' ) {
+
             # Redirect to a view of the newly created request
-            print $cgi->redirect(
-                '/cgi-bin/koha/ill/ill-requests.pl?method=illview&illrequest_id='.
-                $request->id
-            );
-        } else {
+            print $cgi->redirect( '/cgi-bin/koha/ill/ill-requests.pl'
+                  . '?method=illview'
+                  . '&illrequest_id='
+                  . $request->id );
+            exit;
+        }
+        elsif ( $backend_result->{next} eq 'emigrate' ) {
+
+            # Redirect to a view of the newly created request
+            print $cgi->redirect( '/cgi-bin/koha/ill/ill-requests.pl'
+                  . '?method=migrate'
+                  . '&stage=emigrate'
+                  . '&illrequest_id='
+                  . $request->id );
+            exit;
+        }
+        else {
             # Redirect to a requests list view
             redirect_to_list();
         }
@@ -255,4 +469,5 @@ sub handle_commit_maybe {
 
 sub redirect_to_list {
     print $cgi->redirect('/cgi-bin/koha/ill/ill-requests.pl');
+    exit;
 }