[open-ils-commits] [GIT] Evergreen ILS branch master updated. 34cc6d301c8e078a06736c48fc13591aaf3f0955

[Evergreen Git]

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  34cc6d301c8e078a06736c48fc13591aaf3f0955 (commit)
      from  df7e392a980645f22a220c66147cb1b7537d0314 (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 34cc6d301c8e078a06736c48fc13591aaf3f0955
Author: Eva Cerninakova <cerninakova at jabok.cz>
Date:   Tue Sep 20 10:36:30 2016 -0700

    Docs: improving documentation for catalog searching widgets
    
    Signed-off-by: Jane Sandberg <sandbej at linnbenton.edu>

diff --git a/docs/opac/search_form.txt b/docs/opac/search_form.txt
index b16e537..f1561da 100644
--- a/docs/opac/search_form.txt
+++ b/docs/opac/search_form.txt
@@ -6,10 +6,12 @@ simple search form to any HTML page. The following code demonstrates
 how to create a quick search box suitable for the header of your web
 site:
 
-.Sample search form
+Simple search form
+------------------
+
 [source,html]
 ------------------------------------------------------------------------------
-<form action="http://example.com/eg/opac/results" method="get">    <!-- <1> -->
+<form action="http://example.com/eg/opac/results" method="get" accept-charset="UTF-8">    <!-- <1> -->
     <input type="search" alt="Catalog Search" maxlength="200"
             size="20" name="query"
             placeholder="Search catalog for..." />
@@ -26,3 +28,68 @@ site:
 <3> Replace ''4'' with the ID number of the organizational unit at which you
     wish to anchor your search. This is the value of the ''locg'' parameter in
     your normal search.
+
+Advanced search form
+--------------------
+
+[source,html]
+--------------------------------------------------------------------------------
+<form role="search" id="searchForm" method="get" class="searchform" action="http://your_catalog/eg/opac/results" accept-charset="UTF-8">
+     <label id="searchLabel" for="search"><b>Search the Catalog: </b></label>
+     <input type="search" value="" name="query" id="search" size="30">   
+     <label id="search_qtype_label"><b>Type:</b> 
+     <select name="qtype" id="qtype"    aria-label="Select query type:">
+        <option value='keyword' selected="selected">Keyword</option>
+        <option value='title'>Title</option>
+        <option value='jtitle'>Journal Title</option>
+        <option value='author'>Author</option>
+        <option value='subject'>Subject</option>
+        <option value='series'>Series</option>
+     </select>
+     </label>    
+   
+     <label id="search_itype_label"><b>Format: </b> 
+     <select id='item_type_selector' name='fi:item_type' aria-label="Select item type:">
+       <option value=''>All Formats</option>
+       <option value='a'>Books and Journals</option>
+       <option value='i'>Nonmusical Sound Recording</option>
+       <option value='j'>Musical Sound Recording</option>
+       <option value='g'>Video</option>
+       </select>    
+     </label> 
+    
+    <label id="search_locg_label"><b>Library: </b>
+    <select aria-label='Select search library'   name='locg'>
+            <option value='1' class="org_unit"> 
+                All Libraries 
+            </option> 
+            <option value='2' selected="selected" class="org_unit"> 
+                 Central Library
+            </option> 
+             <option value='10'   class="org_unit"> 
+                    Little Library
+            </option> 
+     </select>        
+     </label>
+          <input class="searchbutton" type="submit" value="SEarch" />                  
+</form>
+--------------------------------------------------------------------------------
+
+Encoding
+--------
+
+For non English characters it is vital to set the attribute `accept-charset="UTF-8"`  in the form tag (as in the examples above). If the parameter is  not set, records with non English characters will not be retrieved.
+
+Setting the document type
+-------------------------
+
+You can set the document types to be searched using the attribute `option value=` in the form. For the value use MARC 21 code defining the type of record (i.e. https://www.loc.gov/marc/bibliographic/bdleader.html[Leader, position 06]).
+
+For example, for musical recordings you could use `<option value='j'>Musical Sound Recording</option>`
+
+Setting the library
+-------------------
+
+Instead of searching the entire consortium, you can set the Library to be searched in using the attribute `option value=` in the form. For the value use Evergreen database.organization unit ID. 
+
+

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

Summary of changes:
 docs/opac/search_form.txt |   71 +++++++++++++++++++++++++++++++++++++++++++-
 1 files changed, 69 insertions(+), 2 deletions(-)


hooks/post-receive
-- 
Evergreen ILS