[Koha-patches] [PATCH] Bug 6966 Lists help file

[Nicole C. Engard]

This updates the lists help file.
---
 .../prog/en/modules/help/virtualshelves/shelves.tt |   92 +++++++-------------
 1 files changed, 30 insertions(+), 62 deletions(-)

diff --git a/koha-tmpl/intranet-tmpl/prog/en/modules/help/virtualshelves/shelves.tt b/koha-tmpl/intranet-tmpl/prog/en/modules/help/virtualshelves/shelves.tt
index 6f2d68b..0bd79ab 100644
--- a/koha-tmpl/intranet-tmpl/prog/en/modules/help/virtualshelves/shelves.tt
+++ b/koha-tmpl/intranet-tmpl/prog/en/modules/help/virtualshelves/shelves.tt
@@ -2,87 +2,55 @@
 
 <h1>Lists</h1>
    
-<p>Lists are permanent lists of items, similar to 'favorites'. Lists can be used to keep track of 'favorites' or to create reading lists as a readers' advisory tool. Items in a list link directly to your catalog.</p>
+<p>A list can be created by visiting the Lists page and clicking 'New List'</p>
 
-<p>There are three kinds of 'lists'</p>
+<p>The new list form offers several options for creating your list:</p>
 
-<ul><li>'private': private lists can only be viewed and edited by the user who created the list.</li>
-       <ul><li style="background-color: #ffe599">TIP: Any logged in patron can create a private list</li></ul>
-<li>'public': public lists can be viewed by the public (anyone) but only edited by the user who created the list.</li>
-         <ul><li style="background-color: #ffe599">TIP: Any logged in patron can create a public list</li></ul>
-<li>'free': free lists can be viewed or edited by any user</li>
-         <ul><li style="background-color: #ffe599">TIP: Only staff can create free lists, but any patron can edit them via the OPAC once created</li>
-          <li style="color: #990000">IMPORTANT: Keep in mind that any visitors to your OPAC can alter this list.</li></ul>
-</ul>
-
-<p style="color: #990000">IMPORTANT: To use lists this function must be enabled in your system preferences</p>
 <ul>
-<li><em>Get there:</em> Administration > System Preferences > OPAC > virtualshelves</li></ul>
-
-<h2>To add (create) a new list</h2>
+	<li>The name is what will appear on the list of Lists</li>
+	<li>You can also choose how to sort the list</li>
+	<li>Finally there are three types of lists you can choose from
 <ul>
-<li>Click on 'New List'</li>
-<li>Enter a 'Name' for your list in the field provided</li>
-<li>The 'Owner' should automatically be the individual logged into the Koha staff interface</li>
-<li>Choose a 'Category' for your new list (options are 'private', 'public' or 'free' as explained above)</li>
-<li>Click 'Save'</li>
+	<li>A Private List is managed by you and can be seen only by you</li>
+	<li>A Public List can be seen by everybody, but managed only by you</li>
+	<li>A Open List can be seen and managed by everybody</li>
 </ul>
-
-<h2>Edit Lists</h2>
-<ul>
-<li>Click on 'edit' next to the list you wish to edit OR click on the name of the list and then click 'Edit List'</li>
-<li>Edit details</li>
-<li>Click 'Save'</li>
+</li>
 </ul>
 
-<p style="background-color: #ffe599">TIP: For instance, let's say you were putting together a reading list. You could make that list 'private' until items had been added, then 'edit' the list to change the 'category' to public when you were ready for the list to be seen by other users.</p>
-
-<h2>Placing Holds from Lists</h2>
+<p>A list can also be created from the catalog search results</p>
 
-<p>You can easily place a hold on multiple items from a list simply by clicking the checkboxes and then the 'Place Hold' button</p>
-
-<h2>Deleting a List</h2>
 <ul>
-<li>Click on 'Delete' next to the list you wish to delete OR click on the name of the list and then click 'Delete List'</li>
-<li>You will be asked "Are you sure you want to delete this List?"</li>
-<li>If yes, click 'OK'. If no, click 'Cancel'</li>
-<li>If your list is populated, you will be prompted one more time to confirm whether you want to delete the list</li>
-<li>Click 'Confirm' next to the list you want to delete to delete it permanently</li>
-</ul>
-<h2>Questions</h2>
-
-<p><strong>Can I add items to a staff list right from the 'Lists' module?</strong></p>
-
-<p>Yes! To add an item to a list from the 'Lists' management module...</p>
-
+	<li>Check the box to the left of the titles you want to add to the new list</li>
+	<li>Choose [New List] from the 'Add to:' pull down menu
+<ul>
+	<li>Name the list and choose what type of list this is
 <ul>
-<li>Click on the name of the list you wish to add items to</li>
-<li>Scan or paste the barcode/s of the item you wish to add</li>
-<li>Click 'Add'</li>
+	<li>A Private List is managed by you and can be seen only by you</li>
+	<li>A Public List can be seen by everybody, but managed only by you</li>
+	<li>A Open List can be seen and managed by everybody</li>
+</ul>
+</li>
+</ul>
+</li>
 </ul>
 
-<p><strong>Can I add items to the list from the detail page?</strong></p>
+<p>Once the list is saved it will accessible from the Lists page and from the 'Add to' menu at the top of the search results.</p>
 
-<ul>
-<li>Click on 'Search the catalog' in your search bar'</li>
-<li>Perform a search</li>
-<li>Click on the title of the item you wish to add to a list</li>
-<li>From the details page, click 'Add to List'</li>
-</ul>
+<h2>Add to a List</h2>
 
-<p><strong>Why can I add items to other users' 'private' lists when I'm logged in as staff?</strong></p>
+<p>To add titles to an existing list click on the list name from the page of lists</p>
 
-<p>No, private lists will remain private.  You can see your own private lists from the staff client by clicking on the 'Your Lists' tab.</p>
+<p>From the List page you can add titles by scanning barcodes into the box at the bottom of the page</p>
 
-<p><strong>Can I see what lists a bib record is in?</strong></p>
+<p>A title can also be added to a list by selecting titles on the search results page and choosing the list from the 'Add to' menu</p>
 
-<p>Yes, on the detail page you will see a list of the lists that the title is in on the right hand side of the page</p>
+<h2>Viewing Lists</h2>
 
-<p><strong>As a staff member, what can I do with public lists created by patrons?</strong></p>
+<p>To see the contents of a list, visit the Lists page on the staff client</p>
 
-<p>Anyone with superlibrarian permission to edit/delete public patron lists.  Editing is limited to editing the title or sorting order.
-I have the 'virtualshelves' setting 'disabled' why can I still see the 'lists' menu in my staff client</p>
+<p>Clicking on the 'List Name' will show the contents of the list</p>
 
-<p>Even if lists are 'disabled' for the OPAC, staff users still have access to them from the staff side. The 'virtualshelves' preference only affects whether or not the feature is available from the OPAC.</p>
+<p><strong>See the full documentation for Lists in the <a href="http://manual.koha-community.org/3.6/en/stafflists.html#lists">manual</a> (online).</strong></p>
 
 [% INCLUDE 'help-bottom.inc' %]
\ No newline at end of file
-- 
1.7.2.3