From 34cc6d301c8e078a06736c48fc13591aaf3f0955 Mon Sep 17 00:00:00 2001
From: Eva Cerninakova <cerninakova@jabok.cz>
Date: Tue, 20 Sep 2016 10:36:30 -0700
Subject: [PATCH] Docs: improving documentation for catalog searching widgets

Signed-off-by: Jane Sandberg <sandbej@linnbenton.edu>
---
 docs/opac/search_form.txt | 71 +++++++++++++++++++++++++++++++++++++--
 1 file changed, 69 insertions(+), 2 deletions(-)

diff --git a/docs/opac/search_form.txt b/docs/opac/search_form.txt
index b16e5370cb..f1561da465 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>  &nbsp;&nbsp;
+   
+     <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>  &nbsp;&nbsp;
+     </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"> 
+               &nbsp;&nbsp;Central Library
+            </option> 
+             <option value='10'   class="org_unit"> 
+                &nbsp;&nbsp;&nbsp;&nbsp;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. 
+
+
-- 
2.43.2