[open-ils-commits] [GIT] Evergreen ILS branch master updated. 40605b36c190714723322862eb89fe39c24228ca

Evergreen Git git at git.evergreen-ils.org
Thu Jun 25 11:42:18 EDT 2015


This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "Evergreen ILS".

The branch, master has been updated
       via  40605b36c190714723322862eb89fe39c24228ca (commit)
      from  747df0541dbcd691a437d52d87c1e138c5eb4fd6 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit 40605b36c190714723322862eb89fe39c24228ca
Author: Angela Kilsdonk <akilsdonk at esilibrary.com>
Date:   Thu Jun 25 10:42:14 2015 -0500

    Docs: 2.8 Patron Message Center
    
    Documentation for Patron Message Center development in 2.8
    
    Signed-off-by: Angela Kilsdonk <akilsdonk at esilibrary.com>

diff --git a/docs/circulation/circulation_patron_records.txt b/docs/circulation/circulation_patron_records.txt
index ac2c671..a11e95f 100644
--- a/docs/circulation/circulation_patron_records.txt
+++ b/docs/circulation/circulation_patron_records.txt
@@ -394,6 +394,8 @@ There are several types of messages available for staff to leave notes on patron
 
 *Staff-Generated Penalties/Messages*: These messages are added via the _Messages_ button in the patron record. They can be a note, alert or block. Staff initials can be required. (See the section <<staff_generated_penalties,Staff-Generated Penalties/Messages>> for more.)
 
+*Patron Message Center*: The Patron Message Center provides a way for libraries to communicate with patrons through messages that can be accessed through the patron's OPAC account.  Library staff can create messages manually by adding an OPAC visible Patron Note to an account.  Messages can also be automatically generated through an Action Trigger event.  Patrons can access and manage messages within their OPAC account.  (See the section <<patron_message_center>> for more.)
+
 Patron Alerts 
 ~~~~~~~~~~~~~~
 
@@ -569,6 +571,76 @@ image::media/staff-penalties-4.jpg[Actions menu]
 
 Click to select the message to be removed, then click _Actions for these Penalties/Messages_ -> _Remove Penalty/Message_. This menu can also be accessed by right-clicking in the message area.
 
+Patron Message Center
+~~~~~~~~~~~~~~~~~~~~~
+
+[[patron_message_center]]
+
+Creating a Patron Message in the Patron Account
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+1. Retrieve a patron account in the staff client.
+2. Within the account, go to *Other -> Notes*.
+3. In the Notes interface, click on *Add New Note*.  A new window will pop up that allows you to create a note on the patron account.
+
+image::media/message_center1.PNG[Message Center 1]
+
+4. Check the box next to *Patron Visible?*  This will make the message appear in the patron's OPAC account.
+5. Enter a subject for the message in the *Title* field.
+6. Enter the body of the message in the *Note* field.
+7. Enter *Initials* if staff are required to add initials to notes.
+8. Click, *Add Note*.  The note will now appear as a Patron Visible note in the staff client and as a Message in the patron's OPAC Account.
+
+image::media/message_center2.PNG[Message Center 2]
+
+9.The patron visible note will also create a message in the patron account in the staff client in *Other -> Message Center*.  See *Managing Patron Messages in the Staff Client* below.
+
+Creating a Patron Message using Action Triggers
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Messages can be automatically added to a patron's OPAC account by an Action Trigger event.  For example, when a hold is cancelled by a library staff member, a message can be added to the patron's OPAC account to inform them of the cancellation.
+
+Action Trigger Messages are set up in *Admin -> Local Administration -> Notifications/Action Triggers*.  There are several new fields in the Trigger Event Definition that allow the configuration of Patron Messages:
+
+* Message Library Path: identifies the sending library for the message.  This is the patron's home library (usr.home_ou) in the stock Hold Cancellation message.
+* Message Template: contains the content of the message.
+* Message Title: appears as the subject line in the OPAC message.
+* Message User Path: determines how to identify the user the message is sent to.
+
+NOTE: If you want to send patrons a notification email and an OPAC message when their hold is cancelled, use two separate Action Triggers: one for the email notification and one for the message.
+
+Managing Patron Messages in the Staff Client
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Patron messages can be viewed and managed in the staff client within the patron account.
+
+. Retrieve a patron account in the staff client.
+. Within the account, go to *Other -> Message Center*.
+. Double click on a message to view the full title and content as well as the date and time the message was created and the date and time that the message was read.  Staff can also see if a patron has deleted the message from their OPAC account (Deleted?) and can manually delete a message by marking it as Deleted.
+
+NOTE: When a message is marked deleted, the message will remain in Other -> Message Center as a record that the patron received it.
+
+NOTE: Deleting a patron visible note in Other -> Notes will not delete the patron message from the Other -> Message Center.
+
+image::media/message_center9.PNG[Message Center 9]
+
+Viewing Patron Messages in the OPAC
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Patrons will see a new tab for *Messages* in their OPAC account, as well as a notification of *Unread Messages* in the account summary.
+
+image::media/message_center11.PNG[Message Center 11]
+
+Patrons will see a list of the messages from the library by clicking on the *Messages* tab.
+
+image::media/message_center10.PNG[Message Center 10]
+
+Patrons can click on a message *Subject* to view the message.  After viewing the message, it will automatically be marked as read.  Patrons have the options to mark the message as unread and to delete the message.
+
+image::media/message_center12.PNG[Message Center 12]
+
+NOTE: Patron deleted messages will still appear in the patron's account in the staff client under Other -> Message Center.
+
 Merging Patron Records 
 ~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/docs/media/message_center 11.PNG b/docs/media/message_center 11.PNG
new file mode 100644
index 0000000..a2b3ed7
Binary files /dev/null and b/docs/media/message_center 11.PNG differ
diff --git a/docs/media/message_center1.PNG b/docs/media/message_center1.PNG
new file mode 100644
index 0000000..da32329
Binary files /dev/null and b/docs/media/message_center1.PNG differ
diff --git a/docs/media/message_center10.PNG b/docs/media/message_center10.PNG
new file mode 100644
index 0000000..9a25289
Binary files /dev/null and b/docs/media/message_center10.PNG differ
diff --git a/docs/media/message_center12.PNG b/docs/media/message_center12.PNG
new file mode 100644
index 0000000..d81efdc
Binary files /dev/null and b/docs/media/message_center12.PNG differ
diff --git a/docs/media/message_center2.PNG b/docs/media/message_center2.PNG
new file mode 100644
index 0000000..909c3d8
Binary files /dev/null and b/docs/media/message_center2.PNG differ
diff --git a/docs/media/message_center9.PNG b/docs/media/message_center9.PNG
new file mode 100644
index 0000000..f53e9d9
Binary files /dev/null and b/docs/media/message_center9.PNG differ
diff --git a/docs/opac/using_the_public_access_catalog.txt b/docs/opac/using_the_public_access_catalog.txt
index 485198d..2b43762 100644
--- a/docs/opac/using_the_public_access_catalog.txt
+++ b/docs/opac/using_the_public_access_catalog.txt
@@ -593,3 +593,24 @@ After changing any of these settings, you must click _Save_ to store your prefer
 
 
 indexterm:[holds, preferred pickup location]
+
+Patron Messages
+^^^^^^^^^^^^^^^
+
+The Patron Message Center provides a way for libraries to communicate with patrons through messages that can be accessed through the patron's OPAC account.  Library staff can create messages manually by adding an OPAC visible Patron Note to an account.  Messages can also be automatically generated through an Action Trigger event.  Patrons can access and manage messages within their OPAC account.  See Circulation - Patron Record - Patron Message Center for more information on adding messages to patron accounts.
+
+*Viewing Patron Messages in the OPAC*
+
+Patrons will see a new tab for *Messages* in their OPAC account, as well as a notification of *Unread Messages* in the account summary.
+
+image::media/message_center11.PNG[Message Center 11]
+
+Patrons will see a list of the messages from the library by clicking on the *Messages* tab.
+
+image::media/message_center10.PNG[Message Center 10]
+
+Patrons can click on a message *Subject* to view the message.  After viewing the message, it will automatically be marked as read.  Patrons have the options to mark the message as unread and to delete the message.
+
+image::media/message_center12.PNG[Message Center 12]
+
+NOTE: Patron deleted messages will still appear in the patron's account in the staff client under Other -> Message Center.

-----------------------------------------------------------------------

Summary of changes:
 docs/circulation/circulation_patron_records.txt |   72 +++++++++++++++++++++++
 docs/media/message_center 11.PNG                |  Bin 0 -> 66205 bytes
 docs/media/message_center1.PNG                  |  Bin 0 -> 43118 bytes
 docs/media/message_center10.PNG                 |  Bin 0 -> 43879 bytes
 docs/media/message_center12.PNG                 |  Bin 0 -> 42828 bytes
 docs/media/message_center2.PNG                  |  Bin 0 -> 35787 bytes
 docs/media/message_center9.PNG                  |  Bin 0 -> 48722 bytes
 docs/opac/using_the_public_access_catalog.txt   |   21 +++++++
 8 files changed, 93 insertions(+), 0 deletions(-)
 create mode 100644 docs/media/message_center 11.PNG
 create mode 100644 docs/media/message_center1.PNG
 create mode 100644 docs/media/message_center10.PNG
 create mode 100644 docs/media/message_center12.PNG
 create mode 100644 docs/media/message_center2.PNG
 create mode 100644 docs/media/message_center9.PNG


hooks/post-receive
-- 
Evergreen ILS


More information about the open-ils-commits mailing list