From 2a1b4243fa808158fa30ddb7dda6ab591e18779f Mon Sep 17 00:00:00 2001
From: Bill Erickson <berick@esilibrary.com>
Date: Fri, 9 Dec 2011 15:52:32 -0500
Subject: [PATCH] Alert addresses for patron registration : UI

Add support for comparing user addresses to alert addresses.  When an
address is found, the address in question is styled (the header row
turns red) and the configured alert message is shown along the
top-right, where other warnings appear.

Signed-off-by: Bill Erickson <berick@esilibrary.com>
---
 Open-ILS/src/templates/actor/user/register.tt2    |   5 +
 Open-ILS/web/css/skin/default/register.css        |  21 ++++
 Open-ILS/web/js/ui/default/actor/user/register.js | 146 ++++++++++++++++------
 3 files changed, 134 insertions(+), 38 deletions(-)

diff --git a/Open-ILS/src/templates/actor/user/register.tt2 b/Open-ILS/src/templates/actor/user/register.tt2
index 379405fc5c..4e7c7fef20 100644
--- a/Open-ILS/src/templates/actor/user/register.tt2
+++ b/Open-ILS/src/templates/actor/user/register.tt2
@@ -40,6 +40,11 @@
     <div><a href='javascript:void(0);' id='uedit-dupe-address-link'></a></div>
 </div>
 
+<div id='uedit-address-alert' class='hidden'>
+    <div id='uedit-address-alert-header'>[% l('Address Alert') %]</div>
+    <div id='uedit-address-alert-message'></div>
+</div>
+
 <div class='hidden'>
     <span id='true' style='color:green;'>&#x2713;</span>
     <span id='false' style='color:red;'>&#x2717;</span>
diff --git a/Open-ILS/web/css/skin/default/register.css b/Open-ILS/web/css/skin/default/register.css
index 2868ef4578..b6f032ffee 100644
--- a/Open-ILS/web/css/skin/default/register.css
+++ b/Open-ILS/web/css/skin/default/register.css
@@ -43,6 +43,27 @@
     padding: 20px;
 }
 
+#uedit-address-alert {
+    position: fixed;
+    top:124px;
+    right:30px;
+    width:300px;
+    border:2px dashed #d9e8f9;
+    -moz-border-radius: 10px;
+    font-weight: bold;
+    padding: 10px;
+    text-align: center;
+}
+#uedit-address-alert-header { 
+    color: red; 
+    text-decoration: italic
+    text-align: center;
+}
+
+.uedit-address-alert-divider  {
+    border: 2px dashed red;
+}
+
 .uedit-help {
     width: 25px;
     border:1px solid #e0e0e0;
diff --git a/Open-ILS/web/js/ui/default/actor/user/register.js b/Open-ILS/web/js/ui/default/actor/user/register.js
index 56b726128e..2d3e7454d0 100644
--- a/Open-ILS/web/js/ui/default/actor/user/register.js
+++ b/Open-ILS/web/js/ui/default/actor/user/register.js
@@ -52,6 +52,11 @@ var editCard;
 var dupeUsrname = false;
 var dupeBarcode = false;
 
+// allow for a pause after typing before sending address alert queries
+var addressAlertTimeout = 2000; 
+var addressAlertFields = 
+    ['street1', 'street2', 'city', 'state', 'county', 'country', 'post_code'];
+
 if(!window.xulG) var xulG = null;
 var lock_ready = false;
 var already_locked = false;
@@ -1261,50 +1266,113 @@ function attachWidgetEvents(fmcls, fmfield, widget) {
     }
 
     if(fmclass = 'aua') {
-        switch(fmfield) {
-            case 'post_code':
-                dojo.connect(widget.widget, 'onChange',
-                    function(e) { 
-                        fieldmapper.standardRequest(
-                            ['open-ils.search', 'open-ils.search.zip'],
-                            {   async: true,
-                                params: [e],
-                                oncomplete : function(r) {
-                                    var res = openils.Util.readResponse(r);
-                                    if(!res) return;
-                                    var callback = function(w) { return w._addr == widget._addr; };
-                                    if(res.city) findWidget('aua', 'city', callback).widget.attr('value', res.city);
-                                    if(res.state) findWidget('aua', 'state', callback).widget.attr('value', res.state);
-                                    if(res.county) findWidget('aua', 'county', callback).widget.attr('value', res.county);
-                                    if(res.alert) alert(res.alert);
-                                }
+
+        // map post code to city, state, and county
+        if (fmfield == 'post_code') {
+            dojo.connect(widget.widget, 'onChange',
+                function(e) { 
+                    fieldmapper.standardRequest(
+                        ['open-ils.search', 'open-ils.search.zip'],
+                        {   async: true,
+                            params: [e],
+                            oncomplete : function(r) {
+                                var res = openils.Util.readResponse(r);
+                                if(!res) return;
+                                var callback = function(w) { return w._addr == widget._addr; };
+                                if(res.city) findWidget('aua', 'city', callback).widget.attr('value', res.city);
+                                if(res.state) findWidget('aua', 'state', callback).widget.attr('value', res.state);
+                                if(res.county) findWidget('aua', 'county', callback).widget.attr('value', res.county);
+                                if(res.alert) alert(res.alert);
                             }
-                        );
-                    }
-                );
-                return;
+                        }
+                    );
+                }
+            );
+        }
 
-            case 'street1':
-            case 'street2':
-            case 'city':
-                dojo.connect(widget.widget, 'onChange',
-                    function(e) {
-                        var callback = function(w) { return w._addr == widget._addr; };
-                        var args = {
-                            street1 : findWidget('aua', 'street1', callback).widget.attr('value'),
-                            street2 : findWidget('aua', 'street2', callback).widget.attr('value'),
-                            city : findWidget('aua', 'city', callback).widget.attr('value'),
-                            post_code : findWidget('aua', 'post_code', callback).widget.attr('value')
-                        };
-                        if(args.street1 && args.city && args.post_code)
-                            uEditDupeSearch('address', args); 
-                    }
-                );
-                return;
+        // duplicate address search
+        if (['street1', 'street2', 'city'].indexOf(fmfield) > -1) {
+            dojo.connect(widget.widget, 'onChange',
+                function(e) {
+                    var callback = function(w) { return w._addr == widget._addr; };
+                    var args = {
+                        street1 : findWidget('aua', 'street1', callback).widget.attr('value'),
+                        street2 : findWidget('aua', 'street2', callback).widget.attr('value'),
+                        city : findWidget('aua', 'city', callback).widget.attr('value'),
+                        post_code : findWidget('aua', 'post_code', callback).widget.attr('value')
+                    };
+                    if(args.street1 && args.city && args.post_code)
+                        uEditDupeSearch('address', args); 
+                }
+            ); 
+        }
+
+        if (addressAlertFields.indexOf(fmfield) > -1) {
+            dojo.connect(widget.widget, 'onChange',
+                function(e) {
+                    var callback = function(w) { return w._addr == widget._addr; };
+                    var args = {};
+                    dojo.forEach(addressAlertFields,
+                        function(field) {
+                            args[field] = findWidget('aua', field).widget.attr('value')
+                        }
+                    );
+                    uEditAddressAlertSearch(args, widget._addr);
+                }
+            ); 
         }
     }
 }
 
+var _addrAlertTimeout;
+function uEditAddressAlertSearch(args, addrId) {
+
+    _addrAlertTimeout = setTimeout(
+        function() {
+            if (_addrAlertTimeout) 
+                clearTimeout(_addrAlertTimeout);
+
+            fieldmapper.standardRequest(
+                ['open-ils.actor', 'open-ils.actor.address_alert.test'],
+                {   async: true,
+                    params: [openils.User.authtoken, staff.ws_ou(), args],
+                    oncomplete : function(r) {
+                        var alerts = openils.Util.readResponse(r);
+                        var msgNode = dojo.byId('uedit-address-alert-message');
+                        var headerRow = dojo.filter(
+                            dojo.query('[name=uedit-addr-divider]'),
+                            function(row) { return row.getAttribute('addr') == addrId })[0]
+
+                        msgNode.innerHTML = '';
+
+                        if (alerts.length) {
+
+                            // show the alert box
+                            openils.Util.hide('uedit-help-div');
+                            openils.Util.hide('uedit-dupe-div');
+                            openils.Util.show('uedit-address-alert');
+
+                            // style the address header row
+                            openils.Util.addCSSClass(headerRow, 'uedit-address-alert-divider');
+
+                            dojo.forEach(alerts,
+                                function(addr) {
+                                    msgNode.innerHTML += addr.alert_message() + '<br/>';
+                                }
+                            );
+
+                        } else { 
+                            openils.Util.hide('uedit-address-alert');
+                            openils.Util.removeCSSClass(headerRow, 'uedit-address-alert-divider');
+                        }
+                    }
+                }
+            );
+        }, 
+        addressAlertTimeout
+    );
+}
+
 function uEditDupeSearch(type, value) {
     if(!value) return;
     var search;
@@ -1360,6 +1428,7 @@ function uEditDupeSearch(type, value) {
                 if(resp && resp.length > 0) {
 
                     openils.Util.hide('uedit-help-div');
+                    openils.Util.hide('uedit-address-alert');
                     openils.Util.show('uedit-dupe-div');
                     var link;
 
@@ -1407,6 +1476,7 @@ function getByName(node, name) {
 
 function ueLoadContextHelp(fmcls, fmfield) {
     openils.Util.hide('uedit-dupe-div');
+    openils.Util.hide('uedit-dupe-div');
     openils.Util.show('uedit-help-div');
     dojo.byId('uedit-help-field').innerHTML = fieldmapper.IDL.fmclasses[fmcls].field_map[fmfield].label;
     dojo.byId('uedit-help-text').innerHTML = fieldDoc[fmcls][fmfield].string();
-- 
2.11.0