1 [% INCLUDE 'help-top.inc' %]
3 <h1>Notices & Slips</h1>
5 <p>All notices and circulation receipts (or slips) generated by Koha can be customized using the Notices & Slips Tool. The system comes with several predefined templates that will appear when you first visit this tool.</p>
7 <p>Each notice can be edited, but only a few can be deleted, this is to prevent system errors should a message try to send without a template. Each notice and slip can be edited on a per library basis, by default you will see the notices for all libraries.</p>
9 <p>If you have a style you'd like applied to all slips you can point the SlipCSS preference to a stylesheet. The same is true for notices, using the NoticeCSS preference to define a stylesheet.</p>
11 <h3>Adding Notices & Slips</h3>
13 <p>To add a new notice or slip
16 <li>Click 'New Notice'</li>
17 <li>Choose which library this notice or slip is for</li>
18 <li>Choose the module this notice is related to</li>
19 <li>The Code is limited to 20 characters</li>
20 <li>Use the name field to expand on your Code</li>
21 <li>If you plan on writing the notice or slip in HTML check the 'HTML Message' box, otherwise the content will be generated as plain text</li>
22 <li>Message Subject is what will appear in the subject line of the email</li>
23 <li>In the message body feel free to type whatever message you feel is best, use the fields on the left hand side to enter individualized data from the from database.
25 <li style="color: #990000;">Important: Overdue notices can use <<items.content>> tags by themselves, or use <item></item> to span all of the tags. Learn more about the Overdue Notice Markup</li>
27 <li>On overdue notices make sure to use <<items.content>> tags to print out the data related to all items that are overdue.</li>
30 <li>The other option, only for overdue notices, is to use the <item></item> tags to span the line so that it will print out multiple lines One example for the <item></item> tag option is:<item>"<<biblio.title>>" by <<biblio.author>>, <<items.itemcallnumber>>, Barcode: <<items.barcode>> , Checkout date: <<issues.issuedate>>, Due date: <<issues.date_due>> Fine: <fine>USD</fine> Due date: <<issues.date_due>> </item></li>
34 <li style="color: #990000;">Important: Only the overdue notices take advantage of the <item></item> tags, all other notices referencing items need to use <<items.content>></li>
37 <h4>Overdue Notice Markup</h4>
39 <p>When creating your overdue notices there are two tags in addition to the various database fields that you can use in your notices.</p>
41 <p style="color: #990000;">Important These new tags only work on the overdue notices, not other circulation related notices at this time.</p>
44 <li><item></item> which should enclose all fields from the biblio, biblioitems, and items tables.</li>
45 <li><fine></fine> which should be enclosed by the item tag and should enclose a currency identifier per ISO 4217. If this tag is present with a proper identifier, the fine for that item will be displayed in the proper currency format.
47 <li>Note: ISO 4217 changes from time to time therefore all currencies may not be supported. If you find one that is not supported, please file a bug with the Locale::Currency::Format author Tan D Nguyen <tnguyen at cpan doe org></li>
52 <p>An example of using these two tags in a notice template might be like:</p>
54 <pre class="programlisting"> The following item(s) is/are currently overdue:
56 <item>"<<biblio.title>>" by <<biblio.author>>, <<items.itemcallnumber>>, Barcode: <<items.barcode>> Fine: <fine>GBP</fine></item></pre>
57 Which, assuming two items were overdue, would result in a notice like:
58 <pre class="programlisting"> The following item(s) is/are currently overdue:
60 "A Short History of Western Civilization" by Harrison, John B, 909.09821 H2451, Barcode: 08030003 Fine: £3.50
61 "History of Western Civilization" by Hayes, Carlton Joseph Huntley, 909.09821 H3261 v.1, Barcode: 08030004 Fine: £3.50</pre>
63 <h3>Existing Notices & Slips</h3>
65 <p>Among the default notices are notices for several common actions within Koha. All of these notices can be customized by altering their text via the Notices & Slips tool and their style using the NoticeCSS preference to define a stylesheet. Here are some of what those notices do</p>
70 <li>Sent to patrons when their account is set up if the AutoEmailOPACUser preference is set to 'Send'</li>
73 <li>ACQCLAIM (Acquisition Claim)
75 <li>Used in the claim acquisition module</li>
76 <li><span class="emphasis"><em>Get there:</em></span> More > Acquisitions > Late issues</li>
79 <li>HOLD (Hold Available for Pickup)
81 <li>This notice is used if two criteria are met:
82 <div class="orderedlist">
84 <li>The <span class="link">EnhancedMessagingPreferences</span> is set to 'Allow'</li>
85 <li>The patron has requested to receive this notice
87 <li><span class="emphasis"><em>Get there: </em></span>OPAC > Login > my messaging</li>
88 <li><span class="emphasis"><em>Get there: </em></span>Staff Client > Patron Record > Notices</li>
93 <li>When this notice references the branches table it is referring to the pickup branch information.</li>
96 <li>HOLDPLACED (a notice to the library staff that a hold has been placed)
98 <li>This notice requires the emailLibrarianWhenHoldIsPlaced system preference to be set to 'Enable'</li>
99 <li>When this notice references the branches table it is referring to the pickup branch information.</li>
102 <li>HOLD_PRINT (Printed notice when hold available for pickup)
104 <li>This notice is used for hold confirmation notices that are sent out in print format. This will not effect what the email notice looks like.</li>
105 <li>When this notice references the branches table it is referring to the pickup branch information.</li>
108 <li>ODUE (Overdue Notice)
110 <li>This notice is used to send Overdue Notices to Patrons</li>
111 <li>See a <span class="link">Sample Overdue Notice</span></li>
112 <li>Requires that you set <span class="link">Overdue Notice/Status Triggers</span></li>
115 <li>RLIST (Routing List)
117 <li>Used in the serials module to notify patrons/staff of new issues of a serial
119 <li><span class="emphasis"><em>Get there:</em></span> More > Serials > <span class="link">New Subscription</span></li>
122 <li>You have the option to select the 'Routing List' notice when creating a new subscription (Choose from the 'Patron notification' drop down).</li>
123 <li style="background-color: #ffe599;">Tip: Notice also that if you'd like to notify patrons of new serial issues, you can click on 'define a notice' which will take you to the 'Notices' tool</li>
128 <p>There are also a set of predefined slips (or receipts) listed on this page. All of these slips can be customized by altering their text via the Notices & Slips tool and their style using the <span class="link">SlipCSS</span> preference to define a stylesheet.</p>
130 <p>Here is what those slips are used for:</p>
135 <li>Used to print the quick slip in circulation</li>
136 <li>The quick slip only includes items that were checked out today</li>
141 <li>Used to print a full slip in circulation</li>
142 <li>The slip or receipt will show items checked out today as well as items that are still checked out</li>
147 <li>Used to print a holds slip</li>
148 <li>The holds slip is generated when a hold is confirmed</li>
153 <li>Used to print a transfer slip</li>
154 <li>The transfer sliip is printed when you confirm a transfer from one branch to another in your system</li>
159 <p><strong>See the full documentation for Notices in the <a href="http://manual.koha-community.org/3.8/en/notices.html">manual</a> (online).</strong></p>
161 [% INCLUDE 'help-bottom.inc' %]