[open-ils-commits] [GIT] Evergreen ILS branch master updated. 3db63ee4835600f3938549a2df4bd1e09cd1fd4d

Tue May 2 13:55:08 EDT 2017

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  3db63ee4835600f3938549a2df4bd1e09cd1fd4d (commit)
       via  71c259932defeda7b2e066ade89f1ad3d23f1e3a (commit)
      from  3e78c58976f5e635cb52fa14b0a6f01f47e1b599 (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 3db63ee4835600f3938549a2df4bd1e09cd1fd4d
Author: Kathy Lussier <klussier at masslnc.org>
Date:   Tue May 2 13:46:31 2017 -0400

    Docs: Reducing line size to 80 characters
    
    Reducing the line size in a couple of docs to 80 character. Makes for easier
    editing for those who are working from a command line editor.
    
    Signed-off-by: Kathy Lussier <klussier at masslnc.org>

diff --git a/docs/opac/new_skin_customizations.adoc b/docs/opac/new_skin_customizations.adoc
index 7ad5e79..0d31cfa 100644
--- a/docs/opac/new_skin_customizations.adoc
+++ b/docs/opac/new_skin_customizations.adoc
@@ -52,11 +52,18 @@ NOTE: All paths are relative to `/openils/var/templates/opac`
   ** controlling the size of cover art on the record details page
   ** defining which facets to display, and in which order
   ** controlling basic and advanced search options
-  ** controlling if the "Show More Details" button is visible or activated by default in OPAC search results
-  ** hiding phone notification options (useful for libraries that do not do phone notifications)
-  ** disallowing password or e-mail changes (useful for libraries that use centralized authentication or single sign-on systems)
-  ** displaying a maintenance message in the public catalog and KPAC (this is controlled by the _ctx.maintenance_message_ variable)
-  ** displaying previews of books when available from Google Books.  This is controlled by the _ctx.google_books_preview_ variable, which is set to 0 by default to protect the privacy of users who might not want to share their browsing behavior with Google.
+  ** controlling if the "Show More Details" button is visible or activated by
+default in OPAC search results
+  ** hiding phone notification options (useful for libraries that do not do
+phone notifications)
+  ** disallowing password or e-mail changes (useful for libraries that use
+centralized authentication or single sign-on systems)
+  ** displaying a maintenance message in the public catalog and KPAC (this is
+controlled by the _ctx.maintenance_message_ variable)
+  ** displaying previews of books when available from Google Books.  This is
+controlled by the _ctx.google_books_preview_ variable, which is set to 0 by
+default to protect the privacy of users who might not want to share their
+browsing behavior with Google.
   ** disabling the "Group Formats and Editions" search. This is controlled by 
 setting the metarecords.disabled variable to 1.
   ** setting the default search to a 'Group Formats and Editions' search. This
@@ -102,9 +109,13 @@ is done by setting the search.metarecord_default variable to 1.
   a few colors and everything will work, but in practice you will need to
   experiment to avoid light-gray-on-white low-contrast combinations.
 
-The following are templates that are less frequently overridden, but some libraries benefit from the added customization options.
+The following are templates that are less frequently overridden, but some
+libraries benefit from the added customization options.
 
-* `parts/advanced/numeric.tt2`: defines the search options of the Advanced Search > Numeric search. If you wanted to add a bib call number search option, which is different from the item copy call number; you would add the following code to `numeric.tt2`.
+* `parts/advanced/numeric.tt2`: defines the search options of the Advanced
+Search > Numeric search. If you wanted to add a bib call number search option,
+which is different from the item copy call number; you would add the following
+code to `numeric.tt2`.
 +
 ------------------------------------------------------------------------------
 <option value="identifier|bibcn">[% l('Bib Call Number') %]</option>  
diff --git a/docs/opac/tpac_meta_record_holds.adoc b/docs/opac/tpac_meta_record_holds.adoc
index d20e3da..09fb088 100644
--- a/docs/opac/tpac_meta_record_holds.adoc
+++ b/docs/opac/tpac_meta_record_holds.adoc
@@ -1,12 +1,16 @@
 TPAC Metarecord Search and Metarecord Level Holds
 -------------------------------------------------
 
-Metarecords are compilations of individual bibliographic records that represent the same work. This compilation allows for several records to be represented on a single line on the TPAC search results page, which can help to reduce result duplications.
+Metarecords are compilations of individual bibliographic records that represent
+the same work. This compilation allows for several records to be represented on
+a single line on the TPAC search results page, which can help to reduce result
+duplications.
 
 
 *Advanced Search Page*
 
-Selecting the *Group Formats and Editions* checkbox on the Advanced Search page allows the user to perform a metarecord search.
+Selecting the *Group Formats and Editions* checkbox on the Advanced Search page
+allows the user to perform a metarecord search.
 
 image::media/advsrchpg_1.jpg[]
 
@@ -19,43 +23,65 @@ will revert to the default search behavior.
 
 *Search Results Page*
 
-Within the Search Results page, users can also refine their searches and filter on metarecord search results by selecting the *Group Formats and Editions* checkbox.
+Within the Search Results page, users can also refine their searches and filter
+on metarecord search results by selecting the *Group Formats and Editions*
+checkbox.
 
 image::media/srchresultpg_2.jpg[]
 
-The metarecord search results will display both the representative metarecord bibliographic data and the combined metarecord holdings data (if the holdings data is OPAC visible).
+The metarecord search results will display both the representative metarecord
+bibliographic data and the combined metarecord holdings data (if the holdings
+data is OPAC visible).
 
-The number of records represented by the metarecord are displayed in parenthesis next to the title.
+The number of records represented by the metarecord are displayed in parenthesis
+next to the title.
 
 The formats contained within the metarecord are displayed under the title.
 
 image::media/srchresultpg2_3.jpg[]
 
-For the metarecord search result, the *Place Hold* link defaults to a metarecord level hold.
+For the metarecord search result, the *Place Hold* link defaults to a metarecord
+level hold.
 
 image::media/srchresultpg3_4.jpg[]
 
 To place a metarecord level hold:
 
 . Click the *Place Hold* link.
-. Users who are not logged into their accounts will be directed to the *Log in to Your Account* screen, where they will enter their username and password. Users who are already logged into their accounts will be directed to the *Place Hold* screen.
-. Within the *Place Hold* screen, users can select the multiple formats and/or languages that are available.
+. Users who are not logged into their accounts will be directed to the *Log in
+to Your Account* screen, where they will enter their username and password.
+Users who are already logged into their accounts will be directed to the *Place
+Hold* screen.
+. Within the *Place Hold* screen, users can select the multiple formats and/or
+languages that are available.
 . Continue to enter any additional hold information (such as Pickup Location), if needed.
 . Click *Submit*.
 
 image::media/placehold_5.jpg[]
 
-Selecting multiple formats will not place all of these formats on hold for the user. For example, a user cannot select CD Audiobook and Book and expect to place both the CD and book on hold at the same time. Instead, the user is implying that either the CD format or the book format is the acceptable format to fill the hold. If no format is selected, then any of the available formats may be used to fill the hold. The same holds true for selecting multiple languages.
+Selecting multiple formats will not place all of these formats on hold for the
+user. For example, a user cannot select CD Audiobook and Book and expect to
+place both the CD and book on hold at the same time. Instead, the user is
+implying that either the CD format or the book format is the acceptable format
+to fill the hold. If no format is selected, then any of the available formats
+may be used to fill the hold. The same holds true for selecting multiple
+languages.
 
 *Advanced Hold Options*
 
-When users place a hold on an individual bibliographic record they will see an *Advanced Hold Options* link within the Place Hold screen. Clicking the *Advanced Hold Options* link will take the users into the metarecord level hold feature, enabling them to select multiple formats and/or languages.
+When users place a hold on an individual bibliographic record they will see an
+*Advanced Hold Options* link within the Place Hold screen. Clicking the
+*Advanced Hold Options* link will take the users into the metarecord level hold
+feature, enabling them to select multiple formats and/or languages.
 
 image::media/advholdoption_6.jpg[]
 
 *Metarecord Constituent Records Page*
 
-The TPAC now includes a Metarecord Constituent Records page, which displays a listing of the individual bibliographic records grouped within the metarecord. Access the Metarecord Constituent Records page by clicking on the metarecord title on the Search Results page.
+The TPAC now includes a Metarecord Constituent Records page, which displays a
+listing of the individual bibliographic records grouped within the metarecord.
+Access the Metarecord Constituent Records page by clicking on the metarecord
+title on the Search Results page.
 
 image::media/srchresultpg4_7.jpg[]
 
@@ -65,11 +91,14 @@ image::media/recorddetailpg_8.jpg[]
 
 *Show Holds on Bib*
 
-Within the staff client, *Show Holds on Bib* for a metarecord level hold will take the staff member into the Metarecord Constituent Records page.
+Within the staff client, *Show Holds on Bib* for a metarecord level hold will
+take the staff member into the Metarecord Constituent Records page.
 
 *Global Flag: OPAC Metarecord Hold Formats Attribute*
 
-To utilize the metarecord level hold feature, the Global Flag: OPAC Metarecord Hold Formats Attribute must be enabled and its value set at mr_hold_format, which is the system's default configuration.
+To utilize the metarecord level hold feature, the Global Flag: OPAC Metarecord
+Hold Formats Attribute must be enabled and its value set at mr_hold_format,
+which is the system's default configuration.
 
 image::media/mrholdgf_9.jpg[]
 

commit 71c259932defeda7b2e066ade89f1ad3d23f1e3a
Author: Kathy Lussier <klussier at masslnc.org>
Date:   Tue May 2 13:33:54 2017 -0400

    Docs: Documentation for default metarecord search
    
    Adding documentation on how to configure a default metarecord search in the
    admin section. The catalog section also containts a tip about this option with
    a link to the admin section for further details on how to configure it.
    
    Signed-off-by: Kathy Lussier <klussier at masslnc.org>

diff --git a/docs/opac/new_skin_customizations.adoc b/docs/opac/new_skin_customizations.adoc
index 28d9b19..7ad5e79 100644
--- a/docs/opac/new_skin_customizations.adoc
+++ b/docs/opac/new_skin_customizations.adoc
@@ -40,6 +40,8 @@ that include placeholder images, text, or links that you should override.
 
 NOTE: All paths are relative to `/openils/var/templates/opac`
 
+[[configtt2]]
+
 * `parts/config.tt2`: contains many configuration settings that affect the
   behavior of the TPAC, including:
   ** hiding the *Place Hold* button for available items
@@ -55,6 +57,10 @@ NOTE: All paths are relative to `/openils/var/templates/opac`
   ** disallowing password or e-mail changes (useful for libraries that use centralized authentication or single sign-on systems)
   ** displaying a maintenance message in the public catalog and KPAC (this is controlled by the _ctx.maintenance_message_ variable)
   ** displaying previews of books when available from Google Books.  This is controlled by the _ctx.google_books_preview_ variable, which is set to 0 by default to protect the privacy of users who might not want to share their browsing behavior with Google.
+  ** disabling the "Group Formats and Editions" search. This is controlled by 
+setting the metarecords.disabled variable to 1.
+  ** setting the default search to a 'Group Formats and Editions' search. This
+is done by setting the search.metarecord_default variable to 1.
 * `parts/footer.tt2` and `parts/topnav_links.tt2`: contains customizable
   links. Defaults like 'Link 1' will not mean much to your users!
 * `parts/homesearch.tt2`: holds the large Evergreen logo on the home page
diff --git a/docs/opac/tpac_meta_record_holds.adoc b/docs/opac/tpac_meta_record_holds.adoc
index 6d89551..d20e3da 100644
--- a/docs/opac/tpac_meta_record_holds.adoc
+++ b/docs/opac/tpac_meta_record_holds.adoc
@@ -3,12 +3,20 @@ TPAC Metarecord Search and Metarecord Level Holds
 
 Metarecords are compilations of individual bibliographic records that represent the same work. This compilation allows for several records to be represented on a single line on the TPAC search results page, which can help to reduce result duplications.
 
+
 *Advanced Search Page*
 
 Selecting the *Group Formats and Editions* checkbox on the Advanced Search page allows the user to perform a metarecord search.
 
 image::media/advsrchpg_1.jpg[]
 
+[TIP]
+Administrators can also configure the catalog to default to a *Group Formats and
+Editions* search by enabling the <<configtt2, relevant config.tt2 setting>> on
+the server. Setting this option will pre-select the checkbox on the Advanced 
+Search and Search Result Pages. Users can remove the checkmark, but new searches
+will revert to the default search behavior.
+
 *Search Results Page*
 
 Within the Search Results page, users can also refine their searches and filter on metarecord search results by selecting the *Group Formats and Editions* checkbox.

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

Summary of changes:
 docs/opac/new_skin_customizations.adoc |   31 ++++++++++++----
 docs/opac/tpac_meta_record_holds.adoc  |   63 +++++++++++++++++++++++++-------
 2 files changed, 74 insertions(+), 20 deletions(-)


hooks/post-receive
-- 
Evergreen ILS
