Attachment 39751 Details for Bug 14310 – Bug 14310 - Suspend and resume indvidual holds from patron holds table

[patch] Bug 14310 - Suspend and resume indvidual holds from patron holds table

Bug-14310---Suspend-and-resume-indvidual-holds-fro.patch (text/plain), 12.38 KB, created by Kyle M Hall (khall) on 2015-06-01 16:04:45 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Kyle M Hall (khall)

Created: 2015-06-01 16:04:45 UTC

Size: 12.38 KB

patch

obsolete

>From ad58f57c93435d9c217afe7d083a5bbe10109e66 Mon Sep 17 00:00:00 2001
>From: Kyle M Hall <kyle@bywatersolutions.com>
>Date: Mon, 1 Jun 2015 09:02:21 -0400
>Subject: [PATCH] Bug 14310 - Suspend and resume indvidual holds from patron holds table
>
>This enhancment adds the ability to suspend and resume individual holds
>from the holds table on circulation.pl and moremember.pl.
>
>The interface is inspired/cribbed from the same feature already
>available in the opac.
>
>Test Plan:
>1) Apply this patch
>2) Find a patron with holds
>3) Suspend a hold with no resume date
>4) Resume the suspended hold
>5) Suspend a hold with a resume date
>6) Resume the suspended hold
>---
> Koha/Hold.pm                                       |   42 ++++++++++-
> koha-tmpl/intranet-tmpl/prog/en/js/holds.js        |   85 ++++++++++++++++++--
> .../prog/en/modules/circ/circulation.tt            |    1 +
> .../prog/en/modules/members/moremember.tt          |    1 +
> svc/hold/resume                                    |   48 +++++++++++
> svc/hold/suspend                                   |   51 ++++++++++++
> 6 files changed, 219 insertions(+), 9 deletions(-)
> create mode 100755 svc/hold/resume
> create mode 100755 svc/hold/suspend
>
>diff --git a/Koha/Hold.pm b/Koha/Hold.pm
>index 1b743e8..0879837 100644
>--- a/Koha/Hold.pm
>+++ b/Koha/Hold.pm
>@@ -41,6 +41,46 @@ Koha::Hold - Koha Hold object class
> 
> =cut
> 
>+=head3 suspend_hold
>+
>+my $hold = $hold->suspend_hold( $suspend_until_dt );
>+
>+=cut
>+
>+sub suspend_hold {
>+    my ( $self, $dt ) = @_;
>+
>+    if ( $self->is_waiting ) {    # We can't suspend waiting holds
>+        carp "Unable to suspend waiting hold!";
>+        return $self;
>+    }
>+
>+    $self->suspend(1);
>+
>+    $self->suspend_until( $dt ) if $dt;
>+
>+    $self->store();
>+
>+    return $self;
>+}
>+
>+=head3 resume
>+
>+my $hold = $hold->resume();
>+
>+=cut
>+
>+sub resume {
>+    my ( $self, $dt ) = @_;
>+
>+    $self->suspend(0);
>+    $self->suspend_until( undef );
>+
>+    $self->store();
>+
>+    return $self;
>+}
>+
> =head3 waiting_expires_on
> 
> Returns a DateTime for the date a waiting holds expires on.
>@@ -52,7 +92,7 @@ Returns undef if the hold is not waiting ( found = 'W' ).
> sub waiting_expires_on {
>     my ($self) = @_;
> 
>-    return unless $self->found() eq 'W';
>+    return unless $self->found() && $self->found() eq 'W';
> 
>     my $ReservesMaxPickUpDelay = C4::Context->preference('ReservesMaxPickUpDelay');
>     return unless $ReservesMaxPickUpDelay;
>diff --git a/koha-tmpl/intranet-tmpl/prog/en/js/holds.js b/koha-tmpl/intranet-tmpl/prog/en/js/holds.js
>index 077b3b6..55f0e75 100644
>--- a/koha-tmpl/intranet-tmpl/prog/en/js/holds.js
>+++ b/koha-tmpl/intranet-tmpl/prog/en/js/holds.js
>@@ -8,11 +8,12 @@ $(document).ready(function() {
>     if ( $("#holds-tab").parent().hasClass('ui-state-active') ) { load_holds_table() }
> 
>     function load_holds_table() {
>+        var holds = new Array();
>         if ( ! holdsTable ) {
>             holdsTable = $("#holds-table").dataTable({
>                 "bAutoWidth": false,
>                 "sDom": "rt",
>-                "aoColumns": [
>+                "columns": [
>                     {
>                         "mDataProp": "reservedate_formatted"
>                     },
>@@ -119,21 +120,51 @@ $(document).ready(function() {
>                                  + "<input type='hidden' name='borrowernumber' value='" + borrowernumber + "'>"
>                                  + "<input type='hidden' name='reserve_id' value='" + oObj.reserve_id + "'>";
>                         }
>+                    },
>+                    {
>+                        "bSortable": false,
>+                        "mDataProp": function( oObj ) {
>+                            holds[oObj.reserve_id] = oObj; //Store holds for later use
>+
>+                            if ( oObj.suspend == 1 ) {
>+                                return "<a class='hold-resume btn btn-link' id='resume" + oObj.reserve_id + "' style='display: inline; white-space: nowrap;'>"
>+                                     + "<i class='icon-play'></i> Resume</a>";
>+                            } else {
>+                                return "<a class='hold-suspend btn btn-link' id='suspend" + oObj.reserve_id + "' style='display: inline; white-space: nowrap;'>"
>+                                     + "<i class='icon-pause'></i> Suspend</a>";
>+                            }
>+                        }
>                     }
>                 ],
>                 "bPaginate": false,
>                 "bProcessing": true,
>                 "bServerSide": false,
>-                "sAjaxSource": '/cgi-bin/koha/svc/holds',
>-                "fnServerData": function ( sSource, aoData, fnCallback ) {
>-                    aoData.push( { "name": "borrowernumber", "value": borrowernumber } );
>-
>-                    $.getJSON( sSource, aoData, function (json) {
>-                        fnCallback(json)
>-                    } );
>+                "ajax": {
>+                    "url": '/cgi-bin/koha/svc/holds',
>+                    "data": function ( d ) {
>+                        d.borrowernumber = borrowernumber;
>+                    }
>                 },
>             });
> 
>+            $('#holds-table').on( 'draw.dt', function () {
>+                $(".hold-suspend").on( "click", function() {
>+                    var id = $(this).attr("id").replace("suspend", "");
>+                    var hold = holds[id];
>+                    $("#suspend-modal-title").html( hold.title );
>+                    $("#suspend-modal-reserve_id").val( hold.reserve_id );
>+                    $('#suspend-modal').modal('show');
>+                });
>+
>+                $(".hold-resume").on( "click", function() {
>+                    var id = $(this).attr("id").replace("resume", "");
>+                    var hold = holds[id];
>+                    $.post('/cgi-bin/koha/svc/hold/resume', { "reserve_id": hold.reserve_id }, function( data ){
>+                      holdsTable.api().ajax.reload();
>+                    });
>+                });
>+            });
>+
>             if ( $("#holds-table").length ) {
>                 $("#holds-table_processing").position({
>                     of: $( "#holds-table" ),
>@@ -142,4 +173,42 @@ $(document).ready(function() {
>             }
>         }
>     }
>+
>+    $("body").append("\
>+        <div id='suspend-modal' class='modal hide fade' tabindex='-1' role='dialog' aria-hidden='true'>\
>+            <form id='suspend-modal-form' class='form-inline'>\
>+                <div class='modal-header'>\
>+                    <button type='button' class='closebtn' data-dismiss='modal' aria-hidden='true'>Ã</button>\
>+                    <h3 id='suspend-modal-label'>" + _("Suspend hold on") + " <i><span id='suspend-modal-title'></span></i></h3>\
>+                </div>\
>+\
>+                <div class='modal-body'>\
>+                    <input type='hidden' id='suspend-modal-reserve_id' name='reserve_id' />\
>+\
>+                    <label for='suspend-modal-until'>Suspend until:</label>\
>+                    <input name='suspend_until' id='suspend-modal-until' class='suspend-until' size='10' />\
>+\
>+                    <p/><a class='btn btn-link' id='suspend-modal-clear-date' >" + _("Clear date to suspend indefinitely") + "</a></p>\
>+\
>+                </div>\
>+\
>+                <div class='modal-footer'>\
>+                    <button id='suspend-modal-submit' class='btn btn-primary' type='submit' name='submit'>" + _("Suspend") + "</button>\
>+                    <a href='#' data-dismiss='modal' aria-hidden='true' class='cancel'>" + _("Cancel") + "</a>\
>+                </div>\
>+            </form>\
>+        </div>\
>+    ");
>+
>+    $("#suspend-modal-until").datepicker({ minDate: 1 }); // Require that "until date" be in the future
>+    $("#suspend-modal-clear-date").on( "click", function() { $("#suspend-modal-until").val(""); } );
>+
>+    $("#suspend-modal-submit").on( "click", function( e ) {
>+        e.preventDefault();
>+        $.post('/cgi-bin/koha/svc/hold/suspend', $('#suspend-modal-form').serialize(), function( data ){
>+          $('#suspend-modal').modal('hide');
>+          holdsTable.api().ajax.reload();
>+        });
>+    });
>+
> });
>diff --git a/koha-tmpl/intranet-tmpl/prog/en/modules/circ/circulation.tt b/koha-tmpl/intranet-tmpl/prog/en/modules/circ/circulation.tt
>index 4a87c89..a06a8ea 100644
>--- a/koha-tmpl/intranet-tmpl/prog/en/modules/circ/circulation.tt
>+++ b/koha-tmpl/intranet-tmpl/prog/en/modules/circ/circulation.tt
>@@ -888,6 +888,7 @@ No patron matched <span class="ex">[% message %]</span>
>                     <th>Expiration</th>
>                     <th>Priority</th>
>                     <th>Delete?</th>
>+                    <th>Suspend?</th>
>                 </tr>
>             </thead>
>         </table>
>diff --git a/koha-tmpl/intranet-tmpl/prog/en/modules/members/moremember.tt b/koha-tmpl/intranet-tmpl/prog/en/modules/members/moremember.tt
>index 8ddb526..ecce9c7 100644
>--- a/koha-tmpl/intranet-tmpl/prog/en/modules/members/moremember.tt
>+++ b/koha-tmpl/intranet-tmpl/prog/en/modules/members/moremember.tt
>@@ -484,6 +484,7 @@ function validate1(date) {
>                     <th>Expiration</th>
>                     <th>Priority</th>
>                     <th>Delete?</th>
>+                    <th>Suspend?</th>
>                 </tr>
>             </thead>
>         </table>
>diff --git a/svc/hold/resume b/svc/hold/resume
>new file mode 100755
>index 0000000..b2e2962
>--- /dev/null
>+++ b/svc/hold/resume
>@@ -0,0 +1,48 @@
>+#!/usr/bin/perl
>+
>+# Copyright 2014 ByWater Solutions
>+#
>+# 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 CGI;
>+use JSON qw(to_json);
>+
>+use C4::Context;
>+use C4::Auth qw(check_cookie_auth);
>+use Koha::DateUtils qw(dt_from_string);
>+use Koha::Holds;
>+
>+my $input = new CGI;
>+
>+my ( $auth_status, $sessionID ) =
>+  check_cookie_auth( $input->cookie('CGISESSID'),
>+    { circulate => 'circulate_remaining_permissions' } );
>+
>+if ( $auth_status ne "ok" ) {
>+    exit 0;
>+}
>+
>+binmode STDOUT, ":encoding(UTF-8)";
>+print $input->header( -type => 'text/plain', -charset => 'UTF-8' );
>+
>+my $reserve_id = $input->param('reserve_id');
>+
>+my $hold = Koha::Holds->find( $reserve_id );
>+$hold->resume();
>+
>+print to_json( { success => !$hold->suspend() } );
>diff --git a/svc/hold/suspend b/svc/hold/suspend
>new file mode 100755
>index 0000000..0cc50b2
>--- /dev/null
>+++ b/svc/hold/suspend
>@@ -0,0 +1,51 @@
>+#!/usr/bin/perl
>+
>+# Copyright 2014 ByWater Solutions
>+#
>+# 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 CGI;
>+use JSON qw(to_json);
>+
>+use C4::Context;
>+use C4::Auth qw(check_cookie_auth);
>+use Koha::DateUtils qw(dt_from_string);
>+use Koha::Holds;
>+
>+my $input = new CGI;
>+
>+my ( $auth_status, $sessionID ) =
>+  check_cookie_auth( $input->cookie('CGISESSID'),
>+    { circulate => 'circulate_remaining_permissions' } );
>+
>+if ( $auth_status ne "ok" ) {
>+    exit 0;
>+}
>+
>+binmode STDOUT, ":encoding(UTF-8)";
>+print $input->header( -type => 'text/plain', -charset => 'UTF-8' );
>+
>+my $reserve_id = $input->param('reserve_id');
>+
>+my $suspend_until = $input->param('suspend_until');
>+$suspend_until = dt_from_string( $suspend_until ) if $suspend_until;
>+
>+my $hold = Koha::Holds->find( $reserve_id );
>+$hold->suspend_hold( $suspend_until );
>+
>+print to_json( { success => $hold->suspend() } );
>-- 
>1.7.2.5

Actions: View | Diff | Splinter Review

Attachments on bug 14310: 39750 | 39751 | 39752 | 39753 | 39754 | 40024 | 40030 | 40031 | 40034 | 43525 | 43526 | 43830 | 43831 | 43832 | 43978 | 44203 | 44204 | 44205 | 44206 | 44207 | 46857 | 46858 | 46859 | 46860 | 46861 | 46862 | 46870 | 46871 | 46872 | 46873 | 46874 | 46875 | 46876