dcd1f5d48c
Here we go, next step then. As we did not fix the performance issue when autofiltering the variables (see bug 20975), the only solution we have is to add the filters explicitely. This patch has been autogenerated (using add_html_filters.pl, see next pathces) and add the html filter to all the variables displayed in the template. Exceptions are made (using the new 'raw' TT filter) to the variable we already listed in the previous versions of this patch. To test: - Use t/db_dependent/Koha/Patrons.t to populate your DB with autogenerated data which contain <script> tags - Remove them from borrower_debarments.comments (there are allowed here) update borrower_debarments set comment="html tags possible here"; - From the interface hit page and try to catch alert box. If you find one it means you find a possible XSS. To know where it comes from: * note the exact URL where you found it * note the alert box content * Dump your DB and search for the string in the dump to identify its location (for instance table.field) Next: * Ideally we would like to use the raw filter when it is not necessary to HTML escape the variables (in big loop for instance) * Provide a QA script to catch missing filters (we want html, uri, url or raw, certainly others that I am forgetting now) * Replace the html filters with uri when needed (!) Signed-off-by: Owen Leonard <oleonard@myacpl.org> Signed-off-by: Martin Renvoize <martin.renvoize@ptfs-europe.com> Signed-off-by: Nick Clemens <nick@bywatersolutions.com>
164 lines
11 KiB
Text
164 lines
11 KiB
Text
[% INCLUDE 'help-top.inc' %]
|
|
|
|
<h1>Circulation and Fines Rules</h1>
|
|
|
|
<p>These rules define how your items are circulated, how/when fines are calculated and how holds are handled.</p>
|
|
|
|
<p>The rules are applied from most specific to less specific, using the first found in this order:</p>
|
|
|
|
<ul>
|
|
<li>same library, same patron category, same item type</li>
|
|
<li>same library, same patron category, all item type</li>
|
|
<li>same library, all patron categories, same item type</li>
|
|
<li>same library, all patron categories, all item types</li>
|
|
<li>all libraries, same patron category, same item type</li>
|
|
<li>all libraries, same patron category, all item types</li>
|
|
<li>all libraries, all patron categories, same item type</li>
|
|
<li>all libraries, all patron categories, all item types</li>
|
|
</ul>
|
|
|
|
<p>The CircControl and HomeOrHoldingBranch also come in to play when figuring out which circulation rule to follow.</p>
|
|
|
|
<ul>
|
|
<li>If CircControl is set to "the library you are logged in at" circ rules will be selected based on the library you are logged in at</li>
|
|
<li>If CircControl is set to "the library the patron is from" circ rules will be selected based on the patron's library</li>
|
|
<li>If CircControl is set to "the library the item is from" circ rules will be selected based on the item's library where HomeOrHoldingBranch chooses if item's home library is used or holding library is used.</li>
|
|
<li>If IndependentBranches is set to 'Prevent' then the value of HomeOrHoldingBranch is used in figuring out if the item can be checked out. If the item's home library does not match the logged in library, the item cannot be checked out unless you are a superlibrarian.</li>
|
|
</ul>
|
|
|
|
<p>If you are a single library system choose your branch name before creating rules (sometimes having only rules for the 'all libraries' option can cause issues with holds)</p>
|
|
|
|
<p style="color: #990000;">Important: At the very least you will need to set a default circulation rule. This rule should be set for all item types, all libraries and all patron categories. That will catch all instances that do not match a specific rule. When checking out if you do not have a rule for all libraries, all item types and all patron categories then you may see patrons getting blocked from placing holds. You will also want a rule for your specific library set for all item types and all patron categories to avoid this holds issue. Koha needs to know what rule to fall back on.</p>
|
|
|
|
<h4>Default Circulation Rules</h4>
|
|
|
|
<p>Using the circulation and fine rules matrix you can define rules that depend on patron/item type combinations. To set your rules, choose a library from the pull down (or 'all libraries' if you want to apply these rules to all libraries)</p>
|
|
|
|
<p>From the matrix you can choose any combination of patron categories and item types to apply the rules to</p>
|
|
|
|
<ul>
|
|
<li>First choose which patron category you'd like the rule to be applied to. If you leave this to 'All' it will apply to all patron categories</li>
|
|
<li>Choose the 'Item Type' you would like this rule to apply to. If you leave this to 'All' it will apply to all item types</li>
|
|
<li>Limit the number of items a patron can have checked out at the same time by entering a number in the 'Current Checkouts Allowed' field</li>
|
|
<li>Define the period of time an item can be checked out to a patron by entering the number of units (days or hours) in the 'Loan Period' box.</li>
|
|
<li>Choose which unit of time, Days or Hours, that the loan period and fines will be calculate in</li>
|
|
<li>You can also define a hard due date for a specific patron category and item type. A hard due date ignores your usual circulation rules and makes it so that all items of the type defined are due on, before or after the date you specify.</li>
|
|
<li>'Fine Amount' should have the amount you would like to charge for overdue items
|
|
<ul>
|
|
<li style="color: #990000;">Important: Enter only numbers and decimal points (no currency symbols).</li>
|
|
</ul>
|
|
</li>
|
|
<li>Enter the 'Fine Charging Interval' in the unit you set (ex. charge fines every 1 day, or every 2 hours)</li>
|
|
<li>The 'Fine Grace Period' is the period of time an item can be overdue before you start charging fines.
|
|
<ul>
|
|
<li style="color: #990000;">Important: This can only be set for the Day unit, not in Hours</li>
|
|
</ul>
|
|
</li>
|
|
<li>The 'Overdue Fines Cap' is the maximum fine for this patron and item combination
|
|
<ul>
|
|
<li style="color: #990000;">Important: If this field is left blank then Koha will not put a limit on the fines this item will accrue. A maximum fine amount can be set using the MaxFine system preference.</li>
|
|
</ul>
|
|
</li>
|
|
<li>If your library 'fines' patrons by suspending their account you can enter the number of days their fine should be suspended in the 'Suspension in Days' field
|
|
<ul>
|
|
<li style="color: #990000;">Important: This can only be set for the Day unit, not in Hours</li>
|
|
</ul>
|
|
</li>
|
|
<li>You can also define the maximum number of days a patron will be suspended in the 'Max suspension duration' setting</li>
|
|
<li>Next decide if the patron can renew this item type and if so, enter how many times they can renew it in the 'Renewals Allowed' box</li>
|
|
<li>If you're allowing renewals you can control how long the renewal loan period will be (in the units you have chosen) in the 'Renewal period' box</li>
|
|
<li>If you're allowing renewals you can control how soon before the due date patrons can renew their materials with the 'No renewals before' box.
|
|
<ul><li>Items can be renewed at any time if this value is left blank. Otherwise items can only be renewed if the item is before the number in units (days/hours) entered in this box.</li></ul></li>
|
|
<li>You can enable automatic renewals for certain items/patrons if you'd like. This will renew automatically following your circulation rules unless there is a hold on the item
|
|
<ul>
|
|
<li style="color: #990000;">Important: You will need to enable the automatic renewal cron job for this to work.</li>
|
|
<li style="color: #990000;">Important: This feature needs to have the "no renewal before" column filled in or it will auto renew everyday after the due date.</li>
|
|
</ul>
|
|
</li>
|
|
<li>If the patron can place holds on this item type, enter the total numbers of items (of this type) that can be put on hold in the 'Holds Allowed' field</li>
|
|
<li>Next you can decide if this patron/item combo are allowed to place holds on items that are on the shelf (or available in the library) or not. If you choose 'no' then items can only be placed on hold if checked out</li>
|
|
<li>You can also decide if patrons are allowed to place item specific holds on the item type in question. The options are:
|
|
<ul>
|
|
<li>Allow: Will allow patrons the option to choose next available or item specific</li>
|
|
<li>Don't allow: Will only allow patrons to choose next available</li>
|
|
<li>Force: Will only allow patrons to choose an specific item</li>
|
|
</ul></li>
|
|
<li>Finally, if you charge a rental fee for the item type and want to give a specific patron category a discount on that fee, enter the percentage discount (without the % symbol) in the 'Rental Discount' field</li>
|
|
</ul>
|
|
|
|
<p>When finished, click 'Add' to save your changes. To modify a rule, create a new one with the same patron category and item type. If you would like to delete your rule, simply click the 'Delete' link to the right of the rule.</p>
|
|
|
|
<p>To save time you can clone rules from one library to another by choosing the clone option above the rules matrix.</p>
|
|
|
|
<p>After choosing to clone you will be presented with a confirmation message.</p>
|
|
|
|
<h4>Default Checkouts and Hold Policy</h4>
|
|
|
|
<p>You can set a default maximum number of checkouts and hold policy that will be used if none is defined below for a particular item type or category.</p>
|
|
|
|
<p>From this menu you can set a default to apply to all item types and patrons in the library.</p>
|
|
|
|
<ul>
|
|
<li>In 'Total Current Checkouts Allowed' enter the total number of items patrons can have checked out at one time</li>
|
|
<li>Control where patrons can place holds from using the 'Hold Policy' menu
|
|
<ul>
|
|
<li>From Any Library: Patrons from any library may put this item on hold. (default if none is defined)</li>
|
|
<li>From Home Library: Only patrons from the item's home library may put this book on hold.</li>
|
|
<li>No Holds Allowed: No patron may put this book on hold.</li>
|
|
</ul>
|
|
</li>
|
|
<li>Control where the item returns to once it is checked in
|
|
<ul>
|
|
<li>Item returns home</li>
|
|
<li>Item returns to issuing library</li>
|
|
<li>Item floats
|
|
<ul>
|
|
<li>When an item floats it stays where it was checked in and does not ever return 'home'</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li>Once your policy is set, you can unset it by clicking the 'Unset' link to the right of the rule</li>
|
|
</ul>
|
|
|
|
<h4>Checkouts Per Patron</h4>
|
|
|
|
<p>For this library, you can specify the maximum number of loans that a patron of a given category can make, regardless of the item type.</p>
|
|
|
|
<p>Tip: If the total amount loanable for a given patron category is left blank, no limit applies, except possibly for a limit you define for a specific item type.</p>
|
|
|
|
<h4>Item Hold Policies</h4>
|
|
|
|
<p>For this library, you can edit rules for given itemtypes, regardless of the patron's category. Currently, this means hold policies.</p>
|
|
|
|
<p>The various Hold Policies have the following effects:</p>
|
|
|
|
<ul>
|
|
<li>From Any Library: Patrons from any library may put this item on hold. (default if none is defined)</li>
|
|
<li>From Home Library: Only patrons from the item's home library may put this book on hold.</li>
|
|
<li>No Holds Allowed: No patron may put this book on hold.</li>
|
|
</ul>
|
|
|
|
<p style="color: #990000;">Important: Note that if the system preference AllowHoldPolicyOverrideset to 'allow', these policies can be overridden by your circulation staff.</p>
|
|
|
|
<p style="color: #990000;">Important: These policies are based on the patron's home library, not the library that the reserving staff member is from.</p>
|
|
|
|
<p>The various Return Policies have the following effects:</p>
|
|
|
|
<ul>
|
|
<li>Item returns home: The item will prompt the librarian to transfer the item to its home library
|
|
<ul>
|
|
<li style="color: #990000;">Important: If the AutomaticItemReturnpreference is set to automatically transfer the items home, then a prompt will not appear</li>
|
|
</ul>
|
|
</li>
|
|
<li>Item returns to issuing library: The item will prompt the librarian to transfer the item back to the library where it was checked out
|
|
<ul>
|
|
<li style="color: #990000;">Important: If the AutomaticItemReturnpreference is set to automatically transfer the items home, then a prompt will not appear</li>
|
|
</ul>
|
|
</li>
|
|
<li>Item floats: The item will not be transferred from the library it was checked in at, instead it will remain there until transferred manually or checked in at another library</li>
|
|
</ul>
|
|
|
|
<p><strong>See the full documentation for Circulation and Fine Rules in the <a href="http://koha-community.org/manual/[% helpVersion | html %]/en/html/administration.html#circulation-and-fine-rules">manual</a> (online).</strong></p>
|
|
|
|
[% INCLUDE 'help-bottom.inc' %]
|