Merge branch 'master' of github.com:rsoulliere/Evergreen-DocBook
authorSteve Sheppard <ssheps@gmail.com>
Fri, 1 Oct 2010 20:03:59 +0000 (16:03 -0400)
committerSteve Sheppard <ssheps@gmail.com>
Fri, 1 Oct 2010 20:03:59 +0000 (16:03 -0400)
1.6/development/directoriesandFiles.xml [new file with mode: 0644]
1.6/media/passwordresetmessage.png [new file with mode: 0644]
1.6/opac/myaccount.xml
1.6/root.xml

diff --git a/1.6/development/directoriesandFiles.xml b/1.6/development/directoriesandFiles.xml
new file mode 100644 (file)
index 0000000..f0c04b8
--- /dev/null
@@ -0,0 +1,134 @@
+<?xml version="1.0" encoding="utf-8"?>\r
+<chapter xml:id="filesandvdirectories" xmlns="http://docbook.org/ns/docbook" version="5.0" xml:lang="EN"\r
+    xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink">\r
+       <info>\r
+               <title>Evergreen File Structure and Configuration Files</title>\r
+               <abstract><para>This section will describe tha basic file structure and cover key configuration files. Understanding the directory and file structure of Evergreen will allow you \r
+               to be able to customize your Evergreen software and take full advantage of many features.</para></abstract>\r
+       </info>\r
+       \r
+       <section xml:id="EvergreenDirectoryStructure">  \r
+               <title>Evergreen Directory Structure</title>\r
+               <para>This is the top level directory structure of Evergreen located in the default installation directory <filename class="directory">/openils</filename>:</para>\r
+               <table>\r
+                       <title xml:id="EvergreenDirectoryStructureTable">Evergreen Directory Structure</title>\r
+                       <tgroup align="left" cols="2" colsep="1" rowsep="1">\r
+                               <colspec colnum="1" colwidth="1.0*"/>\r
+                               <colspec colnum="2" colwidth="3.0*"/>\r
+                               <thead>\r
+                                       <row>\r
+                                               <entry>Directory</entry>\r
+                                               <entry>Description</entry>\r
+                                       </row>\r
+                               </thead>\r
+                               <tbody>\r
+                                       <row>\r
+                                               <entry><filename class="directory">bin</filename></entry>\r
+                                               <entry>Contains many critical Perl and shell scripts such as <filename class="directory">autogen.sh</filename> and \r
+                                               <filename class="directory">oils.ctl</filename>. </entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry><filename class="directory">conf</filename></entry>\r
+                                               <entry>Contains the configuration scripts including the 2 most important base configuration files <filename>opensrf_core.xml</filename> and                                                     <filename>opensrf.xml</filename>.</entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry><filename class="directory">include</filename></entry>\r
+                                               <entry>Contains the header files used by the scripts written in C.</entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry><filename class="directory">lib</filename></entry>\r
+                                               <entry>Contains the core code of Evergreen including the C code and perl modules. In particular, the perl modules in the \r
+                                               subdirectory<filename class="directory">perl5/OpenILS</filename>  \r
+                                               are of particular interest to developers. </entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry><filename class="directory">var</filename></entry>\r
+                                               <entry>Largest directory and includes the web directories (<filename class="directory">web</filename>), lock pid fies \r
+                                               (<filename class="directory">run</filename>), circ setting files (<filename class="directory">circ</filename>) templates \r
+                                               (<filename class="directory">templates</filename>) and log (<filename class="directory">templates</filename> and \r
+                                               <filename class="directory">data</filename>) files.</entry>\r
+                                       </row>\r
+                               </tbody>\r
+                       </tgroup>\r
+               </table>\r
+               <section xml:id="EvergreenFiles">       \r
+                       <title>Evergreen Configuration Files</title>\r
+                       \r
+                       <table>\r
+                       <title xml:id="EvergreenConfigurationFilesTable">Key Evergreen Configuration Files</title>\r
+                       <tgroup align="left" cols="2" colsep="1" rowsep="1">\r
+                               <colspec colnum="1" colwidth="1.0*"/>\r
+                               <colspec colnum="2" colwidth="3.0*"/>\r
+                               <thead>\r
+                                       <row>\r
+                                               <entry>File</entry>\r
+                                               <entry>Description</entry>\r
+                                       </row>\r
+                               </thead>\r
+                               <tbody>\r
+                                       <row>\r
+                                               <entry><filename>/openils/conf/opensrf_core.xml</filename></entry>\r
+                                               <entry>Files which controls which Evergreen services are run on the public and private routers. For a service to run, it must be registered in this file.                                                       This file also controls the loglevel and points to the log file for the srvices. An Evergreen restart is required for changes to take effect.</entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry><filename>/openils/conf/opensrf.xml</filename></entry>\r
+                                               <entry>Use this file to set directory locations, the default locale, default notice settings and settings for all Evergreen services. \r
+                                               It is critical for any administrator to understand the settings in this file. An Evergreen restart is required for changes to take effect.</entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry><filename>/openils/conf/fm_IDL.xml</filename></entry>\r
+                                               <entry>Used for linking the OpenSRF/Evergreen services to the Evergreen database tables. An Evergreen restart is required for changes to take \r
+                                               effect. Running autogen.sh is also required.</entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry>/etc/apache2/eg_vhost.conf</entry>\r
+                                               <entry>Controls the Evergreen virtual site. Allows to configure the skin for the OPAC or configure  various directories within the Apache webserver. \r
+                                               An Apache restart is requred for changes to this file to take effect.</entry>\r
+                                       </row>\r
+                               </tbody>\r
+                       </tgroup>\r
+               </table>\r
+               <table>\r
+                       <title xml:id="EvergreenScriptsTable">Useful Evergreen Scripts</title>\r
+                       <tgroup align="left" cols="2" colsep="1" rowsep="1">\r
+                               <colspec colnum="1" colwidth="1.0*"/>\r
+                               <colspec colnum="2" colwidth="3.0*"/>\r
+                               <thead>\r
+                                       <row>\r
+                                               <entry>File</entry>\r
+                                               <entry>Description</entry>\r
+                                       </row>\r
+                               </thead>\r
+                               <tbody>\r
+                                       <row>\r
+                                               <entry><filename>/openils/bin/autogen.sh</filename></entry>\r
+                                               <entry>Used to update changes to org units and the fm_IDL.xml file. Will generate web and staff client pages based on contents of files and \r
+                                               Evergreen database entries.</entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry><filename>/openils/bin/clark-kent.pl</filename></entry>\r
+                                               <entry>Perl script for starting the reporter.</entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry><filename>/openils/bin/action_trigger_runner.pl</filename></entry>\r
+                                               <entry>Perl script used to trigger the actions set up in the action trigger tool in the staff client.</entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry>/openils/bin/osrf_ctl.sh</entry>\r
+                                               <entry>The start up script for OpenSF and Evergreen. </entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry>/openils/bin/reshelving_complete.srfsh</entry>\r
+                                               <entry>Make items in <quote>reshelving</quote> mode for a certain amount of time become <quote>available</quote>. </entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry>/openils/bin/srfsh</entry>\r
+                                               <entry>Used to start the OpenSRF shell.</entry>\r
+                                       </row>\r
+                                       \r
+                               </tbody>\r
+                       </tgroup>\r
+               </table>\r
+               </section>\r
+       </section>\r
+</chapter>\r
diff --git a/1.6/media/passwordresetmessage.png b/1.6/media/passwordresetmessage.png
new file mode 100644 (file)
index 0000000..29a9cc6
Binary files /dev/null and b/1.6/media/passwordresetmessage.png differ
index f4f3e00..effcc38 100644 (file)
-<?xml version="1.0" encoding="UTF-8"?>
-<chapter version="5.0" xml:id="MyAccount" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xl="http://www.w3.org/1999/xlink">
-       <info>
-               <title>My Account</title>
-               <abstract>
-                       <para>This chapter will explain how users can use the My Account feature of the OPAC to manage their accounts.</para>
-               </abstract>
-       </info>
-       <simplesect xml:id="myaccountloginpasswordupdate">
-               
-                               <title>First Login Password Update</title>
-                       <para>Patrons are given temporary <emphasis>dummy</emphasis> barcodes when new accounts are created, or forgotten passwords are reset. Patrons MUST change their password to something more secure with their <emphasis role="bold">first ever</emphasis> OPAC login or <emphasis role="bold">first</emphasis> login after a password reset. Once the password is updated, they will not have to repeat this process for subsequent logins.</para>
-                       
-                               <procedure>
-                                       <step>
-                                               <para>Open a web browser and go to: [URL]</para>
-                                       </step>
-                                       <step>
-                                               <para>Click <emphasis>My Account</emphasis></para>
-                                       </step>
-                                       <step>
-                                               <para>Enter your <emphasis>Username</emphasis> and <emphasis>Password</emphasis></para>
-                                               <itemizedlist>
-                                                       <listitem>
-                                                               <para>By default, your username is your library card number.</para>
-                                                       </listitem>
-                                                       <listitem>
-                                                               <para>Your password is a 4 digit code provided when your account was created. If you have forgotten your password, contact your local library to have it reset.</para>
-                                                       </listitem>
-                                               </itemizedlist>
-                                       </step>
-                                       <step>
-                                               <para>Click <emphasis>Login</emphasis>; you will be prompted to change your password</para>
-                                               <substeps>
-                                                       <step>
-                                                               <para>Enter your current password</para>
-                                                       </step>
-                                                       <step>
-                                                               <para>Enter a new password</para>
-                                                       </step>
-                                                       <step>
-                                                               <para>Enter the new password again</para>
-                                                       </step>
-                                                       <step>
-                                                               <para>Click <emphasis>Update Password</emphasis></para>
-                                                       </step>
-                                                       <step>
-                                                               <para>At <emphasis role="bold">Password successfully updated</emphasis> pop-up click <emphasis>OK</emphasis>; you will be returned to the login screen</para>
-                                                       </step>
-                                               </substeps>
-                                       </step>
-                                       <step>
-                                               <para>Enter your <emphasis>Username</emphasis> and <emphasis role="bold">new</emphasis> <emphasis>Password</emphasis></para>
-                                       </step>
-                                       <step>
-                                               <para>Your <emphasis role="bold">Account Summary</emphasis> page displays.</para>
-                                       </step>
-                               </procedure>
-                               <para/>
-                               <para>To view your account details, click one of the <emphasis role="bold">My Account</emphasis> tabs</para>
-                               <para>To start a search, enter a term in the search box at the top of the page and click Go!</para>
-                               <caution><para>If using a public computer be sure to log out!
-                               </para></caution>
-                               <para/>
-               </simplesect>
-               <simplesect xml:id="myaccountlogin">
-                               <title>Logging In</title>
-                               <procedure>
-                               <title>Logging into your account from the  online catalog</title>       
-                                       <step>
-                                               <para>Open a web browser and go to: [URL]</para>
-                                       </step>
-                                       <step>
-                                               <para>Click <emphasis>My Account</emphasis></para>
-                                       </step>
-                                       <step>
-                                               <para>Enter your <emphasis>Username</emphasis> and <emphasis>Password</emphasis></para>
-                                               <itemizedlist>
-                                                       <listitem><para>By default, your username is your library card number.</para></listitem>
-                                                       <listitem><para>Your password is a 4 digit code provided when your account was created. If you have forgotten your password, contact your local 
-                                                       library to have it reset.</para></listitem>
-                                               </itemizedlist>
-                                       </step>
-                                       <step>
-                                               <para>Click <emphasis>Login</emphasis></para>
-                                               <itemizedlist>
-                                                       <listitem><para>At the first login, or following a password reset, you will be prompted to change your password.</para></listitem>
-                                                       <listitem><para>After updating the password, you must enter your Username and Password again</para></listitem>
-                                               </itemizedlist>
-                                       </step>
-                                       <step>
-                                               <para>Your <emphasis role="bold">Account Summary</emphasis> page displays</para>
-                                       </step>
-                               </procedure>
-                               <para>To view your account details, click one of the <emphasis role="bold">My Account</emphasis> tabs</para>
-                               <para>To start a search, enter a term in the search box at the top of the page and click <emphasis>Go!</emphasis></para>
-                               <para><emphasis role="bold">If using a public computer be sure to log out!</emphasis></para>
-               </simplesect>
-               <simplesect xml:id="myaccountsummary">
-                               <title>Account Summary</title>
-                                       <para>
-                                               <emphasis>Users can view Staff Notes, home library, address, and phone numbers. They can also change account username, password, and email.</emphasis>
-                                       </para>
-               </simplesect>
-               <simplesect xml:id="myaccountitemscheckedout">
-                               <title>Items Checked Out</title>
-                                       <para>
-                                               Users can manage items currently checked out and view overdue items and see renewals remaining.</para>
-                               
-               </simplesect>
-               <simplesect xml:id="myaccountitemsonhold">
-                               <title>Items On Hold</title>
-                                       <para>
-                                               <emphasis>Manage items currently being requested</emphasis>
-                                       </para>
-                               <para>From My Account patrons can manage items currently being requested.</para>
-                                       <para>Actions include:</para>
-                                       <itemizedlist>
-                                               <listitem>
-                                                       <para>Suspend ~ set a period of time during which the hold will not become active, such as during a vacation</para>
-                                               </listitem>
-                                               <listitem>
-                                                       <para>Activate ~ manually remove the suspension</para>
-                                               </listitem>
-                                               <listitem>
-                                                       <para>Set Active Date ~ specify a date at which the suspension will be lifted</para>
-                                               </listitem>
-                                               <listitem>
-                                                       <para>Cancel ~remove the hold request</para>
-                                               </listitem>
-                                       </itemizedlist>
-                               
-                                       <para>Edit options include:</para>
-
-                                       <itemizedlist>
-                                               <listitem>
-                                                       <para>Enable/disable phone notifications</para>
-                                               </listitem>
-                                               <listitem>
-                                                       <para>Change telephone number for notification</para>
-                                               </listitem>
-                                               <listitem>
-                                                       <para>Enable/disable email notification</para>
-                                               </listitem>
-                                               <listitem>
-                                                       <para>Change pick up library</para>
-                                               </listitem>
-                                               <listitem>
-                                                       <para>Change expiration date</para>
-                                               </listitem>
-                                               <listitem>
-                                                       <para>Suspend</para>
-                                               </listitem>
-                                               <listitem>
-                                                       <para>Activate date</para>
-                                               </listitem>
-                                       </itemizedlist>
-                               <procedure>
-                               <title>To edit items on hold:</title>
-                                       <step>
-                                               <para>Login to My Account, click the <emphasis>Items on Hold</emphasis> tab</para>
-                                       </step>
-                                       <step>
-                                               <para>Select the hold to modify</para>
-                                       </step>
-                                       <step>
-                                               <para>Click <emphasis>Edit</emphasis> or <emphasis>Actions for Selected Holds</emphasis>~</para>
-                                       </step>
-                                       <step>
-                                               <para>Select the change to make, follow the steps on the screen</para>
-                                       </step>
-                               </procedure>
-               </simplesect>
-               <simplesect xml:id="myaccountfines">
-                               <title>Fines</title>
-                                       <para>
-                                               <emphasis>Manage fines on items currently checked out</emphasis>
-                                       </para>
-               </simplesect>
-               <simplesect xml:id="myaccountpreferences">
-                               <title>Preferences</title>
-                                       <para>
-                                               <emphasis>Manage preferences for an account</emphasis>
-                                       </para>
-               </simplesect>
-               <simplesect xml:id="myaccountbookbags">
-                               <title>Bookbags</title>
-                               <para>My Bookbags is a feature that allows you to create lists of library materials (books, audiobooks, videos, etc.) These lists create links to records in the catalog, but are otherwise completely private and only accessible by you when logged in to your My Account.</para>
-                               <para>You have the option to share <emphasis role="bold">specific</emphasis> lists with people whom you choose (send them the direct URL), or more generally via RSS feed. Shared bookbags do <emphasis role="bold">NOT</emphasis> create a link to your personal library account information or private bookbags. You can share or un-share bookbags at any time.</para>
-                               <para>You can create as many bookbags and you want. Your bookbags will stay in your account until you delete them.</para>
-                               <para>Items remain in bookbags until you remove them. Even if the item record is removed from the catalog, the bookbag entry will remain (but there will be no link to the catalog.)</para>
-                               <procedure>
-                               <title>Create a new Bookbag</title>
-                                       <step>
-                                               <para>Login to <emphasis>My Account</emphasis> , click <emphasis>My Bookbags</emphasis></para>
-                                       </step>
-                                       <step>
-                                               <para>At <emphasis>Create a new Bookbag</emphasis>, enter the name of the new Bookbag</para>
-                                       </step>
-                                       <step>
-                                               <para>Share - yes or no</para>
-                                       </step>
-                                       <step>
-                                               <para>Click <emphasis>Submit</emphasis></para>
-                                       </step>
-                                       <step>
-                                               <para>Click <emphasis>OK</emphasis></para>
-                                       </step>
-                               </procedure>
-                               <procedure>
-                               <title>Add items to a Bookbag</title>
-                                       <step>
-                                               <para>Search for an item, open the Title Record</para>
-                                       </step>
-                                       <step>
-                                               <para>Open the <emphasis>More Actions...</emphasis> list; click the Bookbag name</para>
-                                       </step>
-                                       <step>
-                                               <para>Click <emphasis>OK</emphasis></para>
-                                       </step>
-                               </procedure>
-                               <procedure>
-                               <title>Share a Bookbag</title>
-                                       <step>
-                                               <para>Login to <emphasis>My Account</emphasis>, click <emphasis>My Bookbags</emphasis></para>
-                                       </step>
-                                       <step>
-                                               <para>Find the Bookbag to share, click <emphasis>Share this Bookbag</emphasis></para>
-                                       </step>
-                                       <step>
-                                               <para>Click <emphasis>OK</emphasis></para>
-                                       </step>
-                                       <step>
-                                               <para>Click <emphasis>OK</emphasis></para>
-                                       </step>
-                                       <step>
-                                               <para>Click <emphasis>View</emphasis> to open the list as a webpage - copy and send this URL to selected recipients or embed in another website</para>
-                                       </step>
-                                       <step>
-                                               <para>Click the RSS symbol add the list to an RSS reader</para>
-                                       </step>
-                               </procedure>
-               </simplesect>
-</chapter>
+<?xml version="1.0" encoding="UTF-8"?>\r
+<chapter version="5.0" xml:id="MyAccount" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xl="http://www.w3.org/1999/xlink">\r
+       <info>\r
+               <title>My Account</title>\r
+               <abstract>\r
+                       <para>This chapter will explain how users can use the My Account feature of the OPAC to manage their accounts.</para>\r
+               </abstract>\r
+       </info>\r
+       <simplesect xml:id="myaccountloginpasswordupdate">\r
+               \r
+                               <title>First Login Password Update</title>\r
+                       <para>Patrons are given temporary <emphasis>dummy</emphasis> barcodes when new accounts are created, or forgotten passwords are reset. Patrons MUST change their password to something more secure with their <emphasis role="bold">first ever</emphasis> OPAC login or <emphasis role="bold">first</emphasis> login after a password reset. Once the password is updated, they will not have to repeat this process for subsequent logins.</para>\r
+                       \r
+                               <procedure>\r
+                                       <step>\r
+                                               <para>Open a web browser and go to: [URL]</para>\r
+                                       </step>\r
+                                       <step>\r
+                                               <para>Click <emphasis>My Account</emphasis></para>\r
+                                       </step>\r
+                                       <step>\r
+                                               <para>Enter your <emphasis>Username</emphasis> and <emphasis>Password</emphasis></para>\r
+                                               <itemizedlist>\r
+                                                       <listitem>\r
+                                                               <para>By default, your username is your library card number.</para>\r
+                                                       </listitem>\r
+                                                       <listitem>\r
+                                                               <para>Your password is a 4 digit code provided when your account was created. If you have forgotten your password, contact your local library to have it reset.</para>\r
+                                                       </listitem>\r
+                                               </itemizedlist>\r
+                                       </step>\r
+                                       <step>\r
+                                               <para>Click <emphasis>Login</emphasis>; you will be prompted to change your password</para>\r
+                                               <substeps>\r
+                                                       <step>\r
+                                                               <para>Enter your current password</para>\r
+                                                       </step>\r
+                                                       <step>\r
+                                                               <para>Enter a new password</para>\r
+                                                       </step>\r
+                                                       <step>\r
+                                                               <para>Enter the new password again</para>\r
+                                                       </step>\r
+                                                       <step>\r
+                                                               <para>Click <emphasis>Update Password</emphasis></para>\r
+                                                       </step>\r
+                                                       <step>\r
+                                                               <para>At <emphasis role="bold">Password successfully updated</emphasis> pop-up click <emphasis>OK</emphasis>; you will be returned to the login screen</para>\r
+                                                       </step>\r
+                                               </substeps>\r
+                                       </step>\r
+                                       <step>\r
+                                               <para>Enter your <emphasis>Username</emphasis> and <emphasis role="bold">new</emphasis> <emphasis>Password</emphasis></para>\r
+                                       </step>\r
+                                       <step>\r
+                                               <para>Your <emphasis role="bold">Account Summary</emphasis> page displays.</para>\r
+                                       </step>\r
+                               </procedure>\r
+                               <para/>\r
+                               <para>To view your account details, click one of the <emphasis role="bold">My Account</emphasis> tabs</para>\r
+                               <para>To start a search, enter a term in the search box at the top of the page and click Go!</para>\r
+                               <caution><para>If using a public computer be sure to log out!\r
+                               </para></caution>\r
+                               <para/>\r
+               </simplesect>\r
+               <simplesect xml:id="myaccountlogin">\r
+                               <title>Logging In</title>\r
+                               <procedure>\r
+                               <title>Logging into your account from the  online catalog</title>       \r
+                                       <step>\r
+                                               <para>Open a web browser and go to: [URL]</para>\r
+                                       </step>\r
+                                       <step>\r
+                                               <para>Click <emphasis>My Account</emphasis></para>\r
+                                       </step>\r
+                                       <step>\r
+                                               <para>Enter your <emphasis>Username</emphasis> and <emphasis>Password</emphasis></para>\r
+                                               <itemizedlist>\r
+                                                       <listitem><para>By default, your username is your library card number.</para></listitem>\r
+                                                       <listitem><para>Your password is a 4 digit code provided when your account was created. If you have forgotten your password, contact your local \r
+                                                       library to have it reset.</para></listitem>\r
+                                               </itemizedlist>\r
+                                       </step>\r
+                                       <step>\r
+                                               <para>Click <emphasis>Login</emphasis></para>\r
+                                               <itemizedlist>\r
+                                                       <listitem><para>At the first login, or following a password reset, you will be prompted to change your password.</para></listitem>\r
+                                                       <listitem><para>After updating the password, you must enter your Username and Password again</para></listitem>\r
+                                               </itemizedlist>\r
+                                       </step>\r
+                                       <step>\r
+                                               <para>Your <emphasis role="bold">Account Summary</emphasis> page displays</para>\r
+                                       </step>\r
+                               </procedure>\r
+                               <para>To view your account details, click one of the <emphasis role="bold">My Account</emphasis> tabs</para>\r
+                               <para>To start a search, enter a term in the search box at the top of the page and click <emphasis>Go!</emphasis></para>\r
+                               <para><emphasis role="bold">If using a public computer be sure to log out!</emphasis></para>\r
+               </simplesect>\r
+               <simplesect xml:id="myaccountpasswordreset">\r
+                               <title>Password Reset</title>\r
+                                       <para>Evergreen 1.6.1 introduced a new feature to allow patrons to reset forgotten passwords from the My Account login screen.</para>  \r
+                                       <para>To reset your password:</para> \r
+                                       <Procedure>\r
+                                       <step>\r
+                                               <para>click on the the <guibutton>Forgot your password?</guibutton> link located under the <guibutton>login</guibutton> button</para>\r
+                                       </step>\r
+                                       <step>\r
+                                               <para>Fill in the <guilabel>Barcode</guilabel> and <guilabel>User name</guilabel> text boxes.</para>\r
+                                       </step>\r
+                                       <step>\r
+                                               <para>A message should appear similar to this:</para>\r
+                                                <para>\r
+                                                       <mediaobject>\r
+                                                               <imageobject>\r
+                                                                       <imagedata width="100%" scalefit="1" fileref="../media/passwordresetmessage.png"/>\r
+                                                               </imageobject>\r
+                                                       </mediaobject>\r
+                                               </para>\r
+\r
+                                       </step>\r
+                                       <step>\r
+                                               <para>An email will be sent to the email addressed you have registered with your Evergreen library. You should click on the link included in the email \r
+                                               to open the password reset page.</para>\r
+                                               <note><para>You will need to have an email account set up in Evergreen for this to work. Processing time may vary.</para></note>\r
+                                       </step>\r
+                                               <step>\r
+                                               <para>At the reset email page you should enter the new password in the <guilabel>New password</guilabel> field and re-enter it in the \r
+                                               <guilabel>Re-enter new password</guilabel> field.</para>\r
+                                               \r
+                                       </step>\r
+                                       <step>\r
+                                               <para>Click <guibutton>Submit</guibutton></para>\r
+                                       </step>\r
+                                       <step>\r
+                                               <para>A message should appear on the page indicating that your password has been reset.</para>\r
+                                       </step>\r
+                                       <step>\r
+                                               <para>Login to your account with your new password.</para>\r
+                                       </step>\r
+               </simplesect>\r
+               <simplesect xml:id="myaccountsummary">\r
+                               <title>Account Summary</title>\r
+                                       <para>\r
+                                               <emphasis>Users can view Staff Notes, home library, address, and phone numbers. They can also change account username, password, and email.</emphasis>\r
+                                       </para>\r
+               </simplesect>\r
+               <simplesect xml:id="myaccountitemscheckedout">\r
+                               <title>Items Checked Out</title>\r
+                                       <para>\r
+                                               Users can manage items currently checked out and view overdue items and see renewals remaining.</para>\r
+                               \r
+               </simplesect>\r
+               <simplesect xml:id="myaccountitemsonhold">\r
+                               <title>Items On Hold</title>\r
+                                       <para>\r
+                                               <emphasis>Manage items currently being requested</emphasis>\r
+                                       </para>\r
+                               <para>From My Account patrons can manage items currently being requested.</para>\r
+                                       <para>Actions include:</para>\r
+                                       <itemizedlist>\r
+                                               <listitem>\r
+                                                       <para>Suspend ~ set a period of time during which the hold will not become active, such as during a vacation</para>\r
+                                               </listitem>\r
+                                               <listitem>\r
+                                                       <para>Activate ~ manually remove the suspension</para>\r
+                                               </listitem>\r
+                                               <listitem>\r
+                                                       <para>Set Active Date ~ specify a date at which the suspension will be lifted</para>\r
+                                               </listitem>\r
+                                               <listitem>\r
+                                                       <para>Cancel ~remove the hold request</para>\r
+                                               </listitem>\r
+                                       </itemizedlist>\r
+                               \r
+                                       <para>Edit options include:</para>\r
+\r
+                                       <itemizedlist>\r
+                                               <listitem>\r
+                                                       <para>Enable/disable phone notifications</para>\r
+                                               </listitem>\r
+                                               <listitem>\r
+                                                       <para>Change telephone number for notification</para>\r
+                                               </listitem>\r
+                                               <listitem>\r
+                                                       <para>Enable/disable email notification</para>\r
+                                               </listitem>\r
+                                               <listitem>\r
+                                                       <para>Change pick up library</para>\r
+                                               </listitem>\r
+                                               <listitem>\r
+                                                       <para>Change expiration date</para>\r
+                                               </listitem>\r
+                                               <listitem>\r
+                                                       <para>Suspend</para>\r
+                                               </listitem>\r
+                                               <listitem>\r
+                                                       <para>Activate date</para>\r
+                                               </listitem>\r
+                                       </itemizedlist>\r
+                               <procedure>\r
+                               <title>To edit items on hold:</title>\r
+                                       <step>\r
+                                               <para>Login to My Account, click the <emphasis>Items on Hold</emphasis> tab</para>\r
+                                       </step>\r
+                                       <step>\r
+                                               <para>Select the hold to modify</para>\r
+                                       </step>\r
+                                       <step>\r
+                                               <para>Click <emphasis>Edit</emphasis> or <emphasis>Actions for Selected Holds</emphasis>~</para>\r
+                                       </step>\r
+                                       <step>\r
+                                               <para>Select the change to make, follow the steps on the screen</para>\r
+                                       </step>\r
+                               </procedure>\r
+               </simplesect>\r
+               <simplesect xml:id="myaccountfines">\r
+                               <title>Fines</title>\r
+                                       <para>\r
+                                               <emphasis>Manage fines on items currently checked out</emphasis>\r
+                                       </para>\r
+               </simplesect>\r
+               <simplesect xml:id="myaccountpreferences">\r
+                               <title>Preferences</title>\r
+                                       <para>\r
+                                               <emphasis>Manage preferences for an account</emphasis>\r
+                                       </para>\r
+               </simplesect>\r
+               <simplesect xml:id="myaccountbookbags">\r
+                               <title>Bookbags</title>\r
+                               <para>My Bookbags is a feature that allows you to create lists of library materials (books, audiobooks, videos, etc.) These lists create links to records in the catalog, but are otherwise completely private and only accessible by you when logged in to your My Account.</para>\r
+                               <para>You have the option to share <emphasis role="bold">specific</emphasis> lists with people whom you choose (send them the direct URL), or more generally via RSS feed. Shared bookbags do <emphasis role="bold">NOT</emphasis> create a link to your personal library account information or private bookbags. You can share or un-share bookbags at any time.</para>\r
+                               <para>You can create as many bookbags and you want. Your bookbags will stay in your account until you delete them.</para>\r
+                               <para>Items remain in bookbags until you remove them. Even if the item record is removed from the catalog, the bookbag entry will remain (but there will be no link to the catalog.)</para>\r
+                               <procedure>\r
+                               <title>Create a new Bookbag</title>\r
+                                       <step>\r
+                                               <para>Login to <emphasis>My Account</emphasis> , click <emphasis>My Bookbags</emphasis></para>\r
+                                       </step>\r
+                                       <step>\r
+                                               <para>At <emphasis>Create a new Bookbag</emphasis>, enter the name of the new Bookbag</para>\r
+                                       </step>\r
+                                       <step>\r
+                                               <para>Share - yes or no</para>\r
+                                       </step>\r
+                                       <step>\r
+                                               <para>Click <emphasis>Submit</emphasis></para>\r
+                                       </step>\r
+                                       <step>\r
+                                               <para>Click <emphasis>OK</emphasis></para>\r
+                                       </step>\r
+                               </procedure>\r
+                               <procedure>\r
+                               <title>Add items to a Bookbag</title>\r
+                                       <step>\r
+                                               <para>Search for an item, open the Title Record</para>\r
+                                       </step>\r
+                                       <step>\r
+                                               <para>Open the <emphasis>More Actions...</emphasis> list; click the Bookbag name</para>\r
+                                       </step>\r
+                                       <step>\r
+                                               <para>Click <emphasis>OK</emphasis></para>\r
+                                       </step>\r
+                               </procedure>\r
+                               <procedure>\r
+                               <title>Share a Bookbag</title>\r
+                                       <step>\r
+                                               <para>Login to <emphasis>My Account</emphasis>, click <emphasis>My Bookbags</emphasis></para>\r
+                                       </step>\r
+                                       <step>\r
+                                               <para>Find the Bookbag to share, click <emphasis>Share this Bookbag</emphasis></para>\r
+                                       </step>\r
+                                       <step>\r
+                                               <para>Click <emphasis>OK</emphasis></para>\r
+                                       </step>\r
+                                       <step>\r
+                                               <para>Click <emphasis>OK</emphasis></para>\r
+                                       </step>\r
+                                       <step>\r
+                                               <para>Click <emphasis>View</emphasis> to open the list as a webpage - copy and send this URL to selected recipients or embed in another website</para>\r
+                                       </step>\r
+                                       <step>\r
+                                               <para>Click the RSS symbol add the list to an RSS reader</para>\r
+                                       </step>\r
+                               </procedure>\r
+               </simplesect>\r
+</chapter>\r
index 1368c8f..389e819 100755 (executable)
                        <title>Development</title>\r
                </info>\r
                <xi:include href="development/development_intro.xml"/>\r
+               <xi:include href="development/directoriesandFiles.xml"/>        \r
                <xi:include href="development/customize_opac.xml"/>\r
                <xi:include href="development/OpenSRF_intro.xml"/>\r
                <xi:include href="development/datamodelsandaccess.xml"/>\r