|
Lines 10-71
Link Here
|
| 10 |
|
10 |
|
| 11 |
<h3>Adding Notices & Slips</h3> |
11 |
<h3>Adding Notices & Slips</h3> |
| 12 |
|
12 |
|
| 13 |
<p>To add a new notice or slip |
13 |
<p>To add a new notice or slip</p> |
| 14 |
|
14 |
|
| 15 |
<ul> |
15 |
<ul> |
| 16 |
<li>Click 'New Notice'</li> |
16 |
<li>Click 'New Notice'</li> |
| 17 |
<li>Choose which library this notice or slip is for</li> |
17 |
<li>Choose which library this notice or slip is for</li> |
| 18 |
<li>Choose the module this notice is related to</li> |
18 |
<li>Choose the module this notice is related to</li> |
| 19 |
<li>The Code is limited to 20 characters</li> |
19 |
<li>The Code is limited to 20 characters |
| 20 |
<li>Use the name field to expand on your Code</li> |
20 |
<ul> |
| 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> |
21 |
<li style="color: #990000;">Important: When working with the overdue notices you want each notice at each branch to have a unique code. Think about using the branch code in front of the notice code for each branch.</li> |
|
|
22 |
</ul> |
| 23 |
</li> |
| 24 |
<li>Use the name field to expand on your Code |
| 25 |
<ul> |
| 26 |
<li style="background-color: #ffe599;">Tip: With overdue notices, be sure to put your branch name in the description as well so that it will be visible when setting up your triggers.</li> |
| 27 |
</ul> |
| 28 |
</li> |
| 29 |
<li>Next you can customize the notice for every possible delivery method |
| 30 |
<ul> |
| 31 |
<li>Every notice should have an Email template set for it</li> |
| 32 |
<li>Next, you can set up a Feed template</li> |
| 33 |
<li>If you're using the TalkingTechItivaPhoneNotification service you can set up a Phone notification</li> |
| 34 |
<li>If you plan on printing this notice you can set the Print template next</li> |
| 35 |
<li>If you have enabled SMS notices with the SMSSendDriver preference you can set the text for your SMS notices next</li> |
| 36 |
</ul> |
| 37 |
</li> |
| 38 |
<li>Each notice offers you the same options |
| 39 |
<ul> |
| 40 |
<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> |
41 |
<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. |
42 |
<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. |
| 24 |
<ul> |
43 |
<ul> |
| 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> |
44 |
<li><span style="color: #990000;">Important: Overdue notices can use <<items.content>> tags by themselves, or use <item></item> to span all of the tags.</span> |
| 26 |
<ul> |
45 |
<ul> |
| 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> |
46 |
<li>On overdue notices make sure to use <<items.content>> tags to print out the data related to all items that are overdue.</li> |
| 28 |
</ul> |
47 |
</ul> |
| 29 |
<ul> |
48 |
<ul> |
| 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: <<items.fine>> Due date: <<issues.date_due>> </item></li> |
49 |
<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 |
|
|
50 |
<<biblio.author>>, <<items.itemcallnumber>>, |
| 51 |
Barcode: <<items.barcode>> , Checkout date: |
| 52 |
<<issues.issuedate>>, Due date: |
| 53 |
<<issues.date_due>> Fine: <<items.fine>> Due date: |
| 54 |
<<issues.date_due>> </item></li> |
| 31 |
</ul> |
55 |
</ul> |
|
|
56 |
</li> |
| 57 |
<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> |
| 58 |
<li style="background-color: #ffe599;">Tip: To add today's date you can use the <<today>> syntax</li> |
| 59 |
</ul> |
| 60 |
</li> |
| 32 |
</ul> |
61 |
</ul> |
| 33 |
</li> |
62 |
</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> |
|
|
| 35 |
</ul> |
63 |
</ul> |
| 36 |
|
64 |
|
| 37 |
<h4>Overdue Notice Markup</h4> |
65 |
<h5>Overdue Notice Markup</h5> |
| 38 |
|
66 |
|
| 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> |
67 |
<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> |
| 40 |
|
68 |
|
| 41 |
<p style="color: #990000;">Important These new tags only work on the overdue notices, not other circulation related notices at this time.</p> |
69 |
<p style="color: #990000;">Important: These new tags only work on the overdue notices, not other circulation related notices at this time.</p> |
| 42 |
|
70 |
|
| 43 |
<ul> |
71 |
<p>These tags are <item> and </item> which should enclose all fields from the biblio, biblioitems, and items tables.</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. |
| 46 |
<ul> |
| 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> |
| 48 |
</ul> |
| 49 |
</li> |
| 50 |
</ul> |
| 51 |
|
72 |
|
| 52 |
<p>An example of using these two tags in a notice template might be like:</p> |
73 |
<p>An example of using these tags in a notice template might be like:</p> |
| 53 |
|
74 |
|
| 54 |
<pre>The following item(s) is/are currently overdue: |
75 |
<p>The following item(s) is/are currently overdue:</p> |
| 55 |
|
76 |
|
| 56 |
<item>"<<biblio.title>>" by <<biblio.author>>, <<items.itemcallnumber>>, Barcode: <<items.barcode>> Fine: <<items.fine>> </item></pre> |
77 |
<p> <item>"<<biblio.title>>" by <<biblio.author>>, <<items.itemcallnumber>>, Barcode: <<items.barcode>> Fine: <<items.fine>></item></p> |
| 57 |
|
78 |
|
| 58 |
<p>Which, assuming two items were overdue, would result in a notice like:</p> |
79 |
<p>Which, assuming two items were overdue, would result in a notice like:</p> |
| 59 |
|
80 |
|
| 60 |
<pre>The following item(s) is/are currently overdue: |
81 |
<p>The following item(s) is/are currently overdue:</p> |
| 61 |
|
|
|
| 62 |
"A Short History of Western Civilization" by Harrison, John B, 909.09821 H2451, Barcode: 08030003 Fine: £3.50 |
| 63 |
"History of Western Civilization" by Hayes, Carlton Joseph Huntley, 909.09821 H3261 v.1, Barcode: 08030004 Fine: £3.50</pre> |
| 64 |
|
82 |
|
| 65 |
<h3>Existing Notices & Slips</h3> |
83 |
<p> "A Short History of Western Civilization" by Harrison, John B, 909.09821 H2451, Barcode: 08030003 Fine: 3.50<br /> |
|
|
84 |
"History of Western Civilization" by Hayes, Carlton Joseph Huntley, 909.09821 H3261 v.1, Barcode: 08030004 Fine: 3.50</p> |
| 85 |
|
| 86 |
<h4>Existing Notices & Slips</h4> |
| 66 |
|
87 |
|
| 67 |
<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> |
88 |
<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> |
| 68 |
|
|
|
| 69 |
<ul> |
89 |
<ul> |
| 70 |
<li>ACCTDETAILS |
90 |
<li>ACCTDETAILS |
| 71 |
<ul> |
91 |
<ul> |
|
Lines 75-152
Link Here
|
| 75 |
<li>ACQCLAIM (Acquisition Claim) |
95 |
<li>ACQCLAIM (Acquisition Claim) |
| 76 |
<ul> |
96 |
<ul> |
| 77 |
<li>Used in the claim acquisition module</li> |
97 |
<li>Used in the claim acquisition module</li> |
| 78 |
<li><em>Get there:</em> More > Acquisitions > Late issues</li> |
98 |
<li><em>Get there:</em> More > Acquisitions > Late issues</li> |
|
|
99 |
</ul> |
| 100 |
</li> |
| 101 |
<li>CHECKIN |
| 102 |
<ul> |
| 103 |
<li>This notice is sent as the 'Check in' notice for all items that are checked in</li> |
| 104 |
<li>This notice is used if two criteria are met: |
| 105 |
<ol> |
| 106 |
<li>The EnhancedMessagingPreferences is set to 'Allow'</li> |
| 107 |
<li>The patron has requested to receive this notice |
| 108 |
<ul> |
| 109 |
<li><em>Get there: </em>OPAC > Login > my messaging</li> |
| 110 |
<li><em>Get there: </em>Staff Client > Patron Record > Notices</li> |
| 111 |
</ul> |
| 112 |
</li> |
| 113 |
</ol> |
| 114 |
</li> |
| 115 |
</ul> |
| 116 |
</li> |
| 117 |
<li>CHECKOUT |
| 118 |
<ul> |
| 119 |
<li>This notice is sent as the 'Check out' notice for all items that are checked out</li> |
| 120 |
<li>This notice is used if two criteria are met: |
| 121 |
<ol> |
| 122 |
<li>The EnhancedMessagingPreferences is set to 'Allow'</li> |
| 123 |
<li>The patron has requested to receive this notice |
| 124 |
<ul> |
| 125 |
<li><em>Get there: </em>OPAC > Login > my messaging</li> |
| 126 |
<li><em>Get there: </em>Staff Client > Patron Record > Notices</li> |
| 127 |
</ul> |
| 128 |
</li> |
| 129 |
</ol> |
| 130 |
</li> |
| 131 |
</ul> |
| 132 |
</li> |
| 133 |
<li>DUE |
| 134 |
<ul> |
| 135 |
<li>This notice is sent as the 'Item due' for an item is due</li> |
| 136 |
<li>This notice is used if two criteria are met: |
| 137 |
<ol> |
| 138 |
<li>The EnhancedMessagingPreferences is set to 'Allow'</li> |
| 139 |
<li>The patron has requested to receive this notice |
| 140 |
<ul> |
| 141 |
<li><em>Get there: </em>OPAC > Login > my messaging</li> |
| 142 |
<li><em>Get there: </em>Staff Client > Patron Record > Notices</li> |
| 143 |
</ul> |
| 144 |
</li> |
| 145 |
</ol> |
| 146 |
</li> |
| 147 |
</ul> |
| 148 |
</li> |
| 149 |
<li>DUEDGST |
| 150 |
<ul> |
| 151 |
<li>This notice is sent as the 'Item due' for all items that are due</li> |
| 152 |
<li>This notice is used if two criteria are met: |
| 153 |
<ol> |
| 154 |
<li>The EnhancedMessagingPreferences is set to 'Allow'</li> |
| 155 |
<li>The patron has requested to receive this notice as a digest |
| 156 |
<ul> |
| 157 |
<li><em>Get there: </em>OPAC > Login > my messaging</li> |
| 158 |
<li><em>Get there: </em>Staff Client > Patron Record > Notices</li> |
| 159 |
</ul> |
| 160 |
</li> |
| 161 |
</ol> |
| 162 |
</li> |
| 79 |
</ul> |
163 |
</ul> |
| 80 |
</li> |
164 |
</li> |
| 81 |
<li>HOLD (Hold Available for Pickup) |
165 |
<li>HOLD (Hold Available for Pickup) |
| 82 |
<ul> |
166 |
<ul> |
| 83 |
<li>This notice is used if two criteria are met: |
167 |
<li>This notice is used if two criteria are met: |
| 84 |
<ol> |
168 |
<ol> |
| 85 |
<li>The EnhancedMessagingPreferences is set to 'Allow'</li> |
169 |
<li>The EnhancedMessagingPreferences is set to 'Allow'</li> |
| 86 |
<li>The patron has requested to receive this notice |
170 |
<li>The patron has requested to receive this notice |
| 87 |
<ul> |
171 |
<ul> |
| 88 |
<li><em>Get there: </em>OPAC > Login > my messaging</li> |
172 |
<li><em>Get there: </em>OPAC > Login > my messaging</li> |
| 89 |
<li><em>Get there: </em>Staff Client > Patron Record > Notices</li> |
173 |
<li><em>Get there: </em>Staff Client > Patron Record > Notices</li> |
| 90 |
</ul> |
174 |
</ul> |
| 91 |
</li> |
175 |
</li> |
| 92 |
</ol> |
176 |
</ol> |
| 93 |
</li> |
177 |
</li> |
| 94 |
<li>When this notice references the branches table it is referring to the pickup library information.</li> |
178 |
<li>When this notice references the branches table it is referring to the pickup branch information.</li> |
| 95 |
</ul> |
179 |
</ul> |
| 96 |
</li> |
180 |
</li> |
| 97 |
<li>HOLDPLACED (a notice to the library staff that a hold has been placed) |
181 |
<li>HOLDPLACED (a notice to the library staff that a hold has been placed) |
| 98 |
<ul> |
182 |
<ul> |
| 99 |
<li>This notice requires the emailLibrarianWhenHoldIsPlaced system preference to be set to 'Enable'</li> |
183 |
<li>This notice requires the emailLibrarianWhenHoldIsPlaced system preference to be set to 'Enable'</li> |
| 100 |
<li>When this notice references the branches table it is referring to the pickup library information.</li> |
184 |
<li>When this notice references the branches table it is referring to the pickup branch information.</li> |
| 101 |
</ul> |
185 |
</ul> |
| 102 |
</li> |
186 |
</li> |
| 103 |
<li>ODUE (Overdue Notice) |
187 |
<li>ODUE (Overdue Notice) |
| 104 |
<ul> |
188 |
<ul> |
| 105 |
<li>This notice is used to send Overdue Notices to Patrons</li> |
189 |
<li>This notice is used to send Overdue Notices to Patrons</li> |
| 106 |
<li>See a Sample Overdue Notice</li> |
190 |
<li>Requires that you set Overdue Notice/Status Triggers</li> |
| 107 |
<li>Requires that you set Overdue Notice/Status Triggers</li> |
191 |
</ul> |
|
|
192 |
</li> |
| 193 |
<li>PREDUE |
| 194 |
<ul> |
| 195 |
<li>This notice is sent as the 'Advanced notice' for an item is due</li> |
| 196 |
<li>This notice is used if two criteria are met: |
| 197 |
<ol> |
| 198 |
<li>The EnhancedMessagingPreferences is set to 'Allow'</li> |
| 199 |
<li>The patron has requested to receive this notice |
| 200 |
<ul> |
| 201 |
<li><em>Get there: </em>OPAC > Login > my messaging</li> |
| 202 |
<li><em>Get there: </em>Staff Client > Patron Record > Notices</li> |
| 203 |
</ul> |
| 204 |
</li> |
| 205 |
</ol> |
| 206 |
</li> |
| 207 |
</ul> |
| 208 |
</li> |
| 209 |
<li>PREDUEDGST |
| 210 |
<ul> |
| 211 |
<li>This notice is sent as the 'Advanced notice' for all items that are due</li> |
| 212 |
<li>This notice is used if two criteria are met: |
| 213 |
<ol> |
| 214 |
<li>The EnhancedMessagingPreferences is set to 'Allow'</li> |
| 215 |
<li>The patron has requested to receive this notice as a digest |
| 216 |
<ul> |
| 217 |
<li><em>Get there: </em>OPAC > Login > my messaging</li> |
| 218 |
<li><em>Get there: </em>Staff Client > Patron Record > Notices</li> |
| 219 |
</ul> |
| 220 |
</li> |
| 221 |
</ol> |
| 222 |
</li> |
| 223 |
</ul> |
| 224 |
</li> |
| 225 |
<li>RENEWAL |
| 226 |
<ul> |
| 227 |
<li>This notice is sent as the 'Check out' notice for all items that are renewed</li> |
| 228 |
<li>This notice is used if three criteria are met: |
| 229 |
<ol> |
| 230 |
<li>The EnhancedMessagingPreferences is set to 'Allow'</li> |
| 231 |
<li>The RenewalSendNotice preference is set to 'Send'</li> |
| 232 |
<li>The patron has requested to receive the checkout notice |
| 233 |
<ul> |
| 234 |
<li><em>Get there: </em>OPAC > Login > my messaging</li> |
| 235 |
<li><em>Get there: </em>Staff Client > Patron Record > Notices</li> |
| 236 |
</ul> |
| 237 |
</li> |
| 238 |
</ol> |
| 239 |
</li> |
| 108 |
</ul> |
240 |
</ul> |
| 109 |
</li> |
241 |
</li> |
| 110 |
<li>RLIST (Routing List) |
242 |
<li>RLIST (Routing List) |
| 111 |
<ul> |
243 |
<ul> |
| 112 |
<li>Used in the serials module to notify patrons/staff of new issues of a serial |
244 |
<li>Used in the serials module to notify patrons/staff of new issues of a serial |
| 113 |
<ul> |
245 |
<ul> |
| 114 |
<li><em>Get there:</em> More > Serials > New Subscription</li> |
246 |
<li><em>Get there:</em> More > Serials > New Subscription</li> |
| 115 |
</ul> |
247 |
</ul> |
| 116 |
</li> |
248 |
</li> |
| 117 |
<li>You have the option to select the 'Routing List' notice when creating a new subscription (Choose from the 'Patron notification' drop down).</li> |
249 |
<li>You have the option to select the 'Routing List' notice when creating a new subscription (Choose from the 'Patron notification' drop down).</li> |
| 118 |
<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> |
250 |
<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> |
|
|
251 |
</ul> |
| 252 |
</li> |
| 253 |
<li>SHARE_ACCEPT |
| 254 |
<ul> |
| 255 |
<li>Used to notify a patron when another patron has accepted their shared list.</li> |
| 256 |
<li>Requires that you set OpacAllowSharingPrivateLists to 'Allow'</li> |
| 257 |
</ul> |
| 258 |
</li> |
| 259 |
<li>SHARE_INVITE |
| 260 |
<ul> |
| 261 |
<li>Used to notify a patron that another patron would like to share a list with them.</li> |
| 262 |
<li>Requires that you set OpacAllowSharingPrivateLists to 'Allow'</li> |
| 119 |
</ul> |
263 |
</ul> |
| 120 |
</li> |
264 |
</li> |
| 121 |
</ul> |
265 |
</ul> |
| 122 |
|
266 |
|
| 123 |
<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 SlipCSS preference to define a stylesheet.</p> |
267 |
<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 SlipCSS preference to define a stylesheet. Here is what those slips are used for:</p> |
| 124 |
|
|
|
| 125 |
<p>Here is what those slips are used for:</p> |
| 126 |
|
268 |
|
| 127 |
<ul> |
269 |
<ul> |
| 128 |
<li>ISSUEQSLIP |
270 |
<li>ISSUEQSLIP |
| 129 |
<ul> |
271 |
<ul> |
| 130 |
<li>Used to print the quick slip in circulation</li> |
272 |
<li>Used to print the quick slip in circulation</li> |
| 131 |
<li>The quick slip only includes items that were checked out today</li> |
273 |
<li>The quick slip only includes items that were checked out today</li> |
| 132 |
</ul> |
274 |
</ul> |
| 133 |
</li> |
275 |
</li> |
| 134 |
<li>ISSUESLIP |
276 |
<li>ISSUESLIP |
| 135 |
<ul> |
277 |
<ul> |
| 136 |
<li>Used to print a full slip in circulation</li> |
278 |
<li>Used to print a full slip in circulation</li> |
| 137 |
<li>The slip or receipt will show items checked out today as well as items that are still checked out</li> |
279 |
<li>The slip or receipt will show items checked out today as well as items that are still checked out</li> |
| 138 |
</ul> |
280 |
</ul> |
| 139 |
</li> |
281 |
</li> |
| 140 |
<li>RESERVESLIP |
282 |
<li>RESERVESLIP |
| 141 |
<ul> |
283 |
<ul> |
| 142 |
<li>Used to print a holds slip</li> |
284 |
<li>Used to print a holds slip</li> |
| 143 |
<li>The holds slip is generated when a hold is confirmed</li> |
285 |
<li>The holds slip is generated when a hold is confirmed</li> |
| 144 |
</ul> |
286 |
</ul> |
| 145 |
</li> |
287 |
</li> |
| 146 |
<li>TRANSFERSLIP |
288 |
<li>TRANSFERSLIP |
| 147 |
<ul> |
289 |
<ul> |
| 148 |
<li>Used to print a transfer slip</li> |
290 |
<li>Used to print a transfer slip</li> |
| 149 |
<li>The transfer slip is printed when you confirm a transfer from one library to another in your system</li> |
291 |
<li>The transfer slip is printed when you confirm a transfer from one branch to another in your system</li> |
| 150 |
</ul> |
292 |
</ul> |
| 151 |
</li> |
293 |
</li> |
| 152 |
</ul> |
294 |
</ul> |