[Koha-patches] [PATCH] Bug 5490: Update Lists and About Help Files for 3.4

Ian Walls ian.walls at bywatersolutions.com
Fri Mar 25 16:55:01 CET 2011


From: Nicole C. Engard <nengard at bywatersolutions.com>

Signed-off-by: Nicole C. Engard <nengard at bywatersolutions.com>
Signed-off-by: Ian Walls <ian.walls at bywatersolutions.com>
---
 .../intranet-tmpl/prog/en/modules/help/about.tmpl  |   20 +++-
 .../en/modules/help/virtualshelves/shelves.tmpl    |  108 ++++++++-----------
 2 files changed, 62 insertions(+), 66 deletions(-)

diff --git a/koha-tmpl/intranet-tmpl/prog/en/modules/help/about.tmpl b/koha-tmpl/intranet-tmpl/prog/en/modules/help/about.tmpl
index c90aa29..8b356c7 100644
--- a/koha-tmpl/intranet-tmpl/prog/en/modules/help/about.tmpl
+++ b/koha-tmpl/intranet-tmpl/prog/en/modules/help/about.tmpl
@@ -1,17 +1,29 @@
 <!-- TMPL_INCLUDE NAME="help-top.inc" -->
 
-<h1>About Koha</h1><p>This section provides information about your Koha installation. It is useful for developers and if you wish to report bugs or issues to the Koha community.</p>
+<h1>About Koha</h1>
+
+<p>This section provides information about your Koha installation. It is useful for developers and if you wish to report bugs or issues to the Koha community.</p>
 
 <h2>Server Information</h2>
 
-<p>This section tells you which version of Koha and supporting software you are using. If possible, when reporting issues to the Koha community, always give details of which version of Koha you are using. Koha is under active development and it is highly likely that an upgrade to a more recent version will provide patches and bug fixes you require.</p>
+<p>Under the 'Server Information' tab you will find information about the Koha version and the machine you have installed Koha on. This information is very important for debugging problems. When reporting issues to your support provider or to the various other support avenues (mailing lists, chat room, etc), it's always good to give the information from this screen.</p>
 
 <h2>Perl Modules</h2>
 
-<p>This tab lists all the dependant Perl Modules for Koha and whether or not you have them installed, and the version number. If you are reporting an issue, the developer may ask what is the state of the Perl modules you have installed.</p>
+<p>In order to take advantage of all of the functionalities of Koha, you will need to keep your Perl modules up to date. The 'Perl Modules' tab will show you all of the modules required by Koha, the version you have installed and whether you need to upgrade certain modules.</p>
+
+<p>Items listed in bold are required by Koha, items highlighed in red are missing completely and items highlighted in yellow simply need to be upgraded.</p>
 
 <h2>Koha Team</h2>
 
-<p>Koha is developed and supported by a large number of developers around the world. Thanks to all the developers and libraries who support Koha</p>
+<p>Koha is developed and supported by a large number of developers around the world. Thanks to all the developers and libraries who support Koha.</p>
+
+<h2>Licenses</h2>
+
+<p>Koha uses several bits of open source and this tab lists the license info for those sections of code.</p>
+
+<h2>Translations</h2>
+
+<p>Koha is translated in to several languages and this tab will list for you all of the languages that Koha is available in.</p>
 
 <!-- TMPL_INCLUDE name="help-bottom.inc" -->
\ No newline at end of file
diff --git a/koha-tmpl/intranet-tmpl/prog/en/modules/help/virtualshelves/shelves.tmpl b/koha-tmpl/intranet-tmpl/prog/en/modules/help/virtualshelves/shelves.tmpl
index 0341f8c..f5036d9 100644
--- a/koha-tmpl/intranet-tmpl/prog/en/modules/help/virtualshelves/shelves.tmpl
+++ b/koha-tmpl/intranet-tmpl/prog/en/modules/help/virtualshelves/shelves.tmpl
@@ -1,88 +1,72 @@
 <!-- TMPL_INCLUDE NAME="help-top.inc" -->
 
 <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>There are three kinds of 'lists'</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>
+<p>Lists are a way to save a collection of content on a specific topic or for a specific purpose. The Cart is a session specific storage space.</p>
+
+<h2>Create a List</h2>
 
-<h2>To add (create) a new list</h2>
+<p>A list can be created by visiting the Lists page and clicking 'New List'</p>
+
+<p>The new list form offers several options for creating your list:</p>
+<ul>
+	<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>
+</li>
+</ul>
+<p>A list can also be created from the catalog search results</p>
+<ul>
+	<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 '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>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>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>
+<h3>Add to a List</h3>
+<p>To add titles to an existing list click on the list name from the page of lists</p>
 
-<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>
+<p>From the List page you can add titles by scanning barcodes into the box at the bottom of the page</p>
 
-<h2>Placing Holds from Lists</h2>
+<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>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>Viewing Lists</h2>
 
-<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>To see the contents of a list, visit the Lists page on the staff client</p>
 
-<p><strong>Can I add items to a staff list right from the 'Lists' module?</strong></p>
+<p>Clicking on the 'List Name' will show the contents of the list</p>
 
-<p>Yes! To add an item to a list from the 'Lists' management module...</p>
+<h2>Merging Bibliographic Records Via Lists</h2>
 
-<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>
-</ul>
-
-<p><strong>Can I add items to the list from the detail page?</strong></p>
+<p style="color: #990000;">Important: Merging will only work with two items that use the same bibliographic framework.</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>
+<p>The easiest way to merge together duplicate bibliographic records is to add them to a list and use the Merge Tool from there.</p>
 
-<p><strong>Why can I add items to other users' 'private' lists when I'm logged in as staff?</strong></p>
+<p>From the list, check the two items you want to merge. If you choose more than or fewer than 2, you will be presented with an error</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>Once you have selected the records you want to merge, click the 'Merge selected items' button. You will be asked which of the two records you would like to keep as your primary record and which will be deleted after the merge.</p>
 
-<p><strong>Can I see what lists a bib record is in?</strong></p>
+<p>You will be presented with the MARC for both of the records (each accessible by tabs labeled with the bib numbers for those records). By default the entire first record will be selected, uncheck the fields you don't want in the final (destination) record and then move on to the second tab to choose which fields should be in the final (destination) record.</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>
+<p>Should you try to add a field that is not repeatable two times (like choosing the 245 field from both record #1 and #2) you will be presented with an error</p>
 
-<p><strong>As a staff member, what can I do with public lists created by patrons?</strong></p>
+<p>Most importantly you want to make sure that all of the items from the two records are attached to the new record. To do this you want to make sure that all 952 files are selected before completing the merge.</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>Once you have completed your selections click the 'merge' button. The primary record will now show the data you chose for it, and the second record will be deleted.</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 style="color: #990000;">Important: It is important to rebuild your zebra index immediately after merging records. If a search is performed for a record which has been deleted Koha will present the patrons with an error in the OPAC.</p>
 
 <!-- TMPL_INCLUDE NAME="help-bottom.inc" -->
\ No newline at end of file
-- 
1.5.6.5



More information about the Koha-patches mailing list