View | Details | Raw Unified | Return to bug 12244
Collapse All | Expand All

(-)a/koha-tmpl/intranet-tmpl/prog/en/modules/help/tools/letter.tt (-52 / +194 lines)
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 &lt;&lt;items.content&gt;&gt; tags by themselves, or use &lt;item&gt;&lt;/item&gt; 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 &lt;&lt;items.content&gt;&gt; tags by themselves, or use &lt;item&gt;&lt;/item&gt; to span all of the tags.</span>
26
<ul>
45
<ul>
27
    <li>On overdue notices make sure to use &lt;&lt;items.content&gt;&gt; tags to print out the data related to all items that are overdue.</li>
46
	<li>On overdue notices make sure to use &lt;&lt;items.content&gt;&gt; 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 &lt;item&gt;&lt;/item&gt; tags to span the line so that it will print out multiple lines One example for the &lt;item&gt;&lt;/item&gt; tag option is:&lt;item&gt;"&lt;&lt;biblio.title&gt;&gt;" by &lt;&lt;biblio.author&gt;&gt;, &lt;&lt;items.itemcallnumber&gt;&gt;, Barcode: &lt;&lt;items.barcode&gt;&gt; , Checkout date: &lt;&lt;issues.issuedate&gt;&gt;, Due date: &lt;&lt;issues.date_due&gt;&gt; Fine: &lt;&lt;items.fine&gt;&gt; Due date: &lt;&lt;issues.date_due&gt;&gt; &lt;/item&gt;</li>
49
	<li>The other option, only for overdue notices, is to use the &lt;item&gt;&lt;/item&gt; tags to span the line so that it will print out multiple lines. One example for the &lt;item&gt;&lt;/item&gt; tag option is:&lt;item&gt;"&lt;&lt;biblio.title&gt;&gt;" by
50
&lt;&lt;biblio.author&gt;&gt;, &lt;&lt;items.itemcallnumber&gt;&gt;,
51
Barcode: &lt;&lt;items.barcode&gt;&gt; , Checkout date:
52
&lt;&lt;issues.issuedate&gt;&gt;, Due date:
53
&lt;&lt;issues.date_due&gt;&gt; Fine: &lt;&lt;items.fine&gt;&gt; Due date:
54
&lt;&lt;issues.date_due&gt;&gt; &lt;/item&gt;</li>
31
</ul>
55
</ul>
56
</li>
57
	<li style="color: #990000;">Important: Only the overdue notices take advantage of the &lt;item&gt;&lt;/item&gt; tags, all other notices referencing items need to use &lt;&lt;items.content&gt;&gt;</li>
58
	<li style="background-color: #ffe599;">Tip: To add today's date you can use the &lt;&lt;today&gt;&gt; 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 &lt;item&gt;&lt;/item&gt; tags, all other notices referencing items need to use &lt;&lt;items.content&gt;&gt;</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 &lt;item&gt; and &lt;/item&gt; which should enclose all fields from the biblio, biblioitems, and items tables.</p>
44
	<li>&lt;item&gt;&lt;/item&gt; which should enclose all fields from the biblio, biblioitems, and items tables.</li>
45
	<li>&lt;fine&gt;&lt;/fine&gt; 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 &lt;tnguyen at cpan doe org&gt;</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
   &lt;item&gt;"&lt;&lt;biblio.title&gt;&gt;" by &lt;&lt;biblio.author&gt;&gt;, &lt;&lt;items.itemcallnumber&gt;&gt;, Barcode: &lt;&lt;items.barcode&gt;&gt; Fine: &lt;&lt;items.fine&gt;&gt; &lt;/item&gt;</pre>
77
<p>   &lt;item&gt;"&lt;&lt;biblio.title&gt;&gt;" by &lt;&lt;biblio.author&gt;&gt;, &lt;&lt;items.itemcallnumber&gt;&gt;, Barcode: &lt;&lt;items.barcode&gt;&gt; Fine: &lt;&lt;items.fine&gt;&gt;&lt;/item&gt;</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
82
62
   "A Short History of Western Civilization" by Harrison, John B, 909.09821 H2451, Barcode: 08030003 Fine: £3.50
83
<p>   "A Short History of Western Civilization" by Harrison, John B, 909.09821 H2451, Barcode: 08030003 Fine: 3.50<br />
63
   "History of Western Civilization" by Hayes, Carlton Joseph Huntley, 909.09821 H3261 v.1, Barcode: 08030004 Fine: £3.50</pre>
84
   "History of Western Civilization" by Hayes, Carlton Joseph Huntley, 909.09821 H3261 v.1, Barcode: 08030004 Fine: 3.50</p>
64
85
65
<h3>Existing Notices & Slips</h3>
86
<h4>Existing Notices &amp; 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 &amp; 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 &amp; 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 &gt; Acquisitions &gt; Late issues</li>
98
	<li><em>Get there:</em> More &gt; Acquisitions &gt; 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 &gt; Login &gt; my messaging</li>
110
	<li><em>Get there: </em>Staff Client &gt; Patron Record &gt; 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 &gt; Login &gt; my messaging</li>
126
	<li><em>Get there: </em>Staff Client &gt; Patron Record &gt; 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 &gt; Login &gt; my messaging</li>
142
	<li><em>Get there: </em>Staff Client &gt; Patron Record &gt; 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 &gt; Login &gt; my messaging</li>
158
	<li><em>Get there: </em>Staff Client &gt; Patron Record &gt; 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 &gt; Login &gt; my messaging</li>
172
	<li><em>Get there: </em>OPAC &gt; Login &gt; my messaging</li>
89
    <li><em>Get there: </em>Staff Client &gt; Patron Record &gt; Notices</li>
173
	<li><em>Get there: </em>Staff Client &gt; Patron Record &gt; 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 &gt; Login &gt; my messaging</li>
202
	<li><em>Get there: </em>Staff Client &gt; Patron Record &gt; 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 &gt; Login &gt; my messaging</li>
218
	<li><em>Get there: </em>Staff Client &gt; Patron Record &gt; 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 &gt; Login &gt; my messaging</li>
235
	<li><em>Get there: </em>Staff Client &gt; Patron Record &gt; 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 &gt; Serials &gt; New Subscription</li>
246
	<li><em>Get there:</em> More &gt; Serials &gt; 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 &amp; 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 &amp; 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>
(-)a/koha-tmpl/intranet-tmpl/prog/en/modules/help/tools/overduerules.tt (-2 / +5 lines)
Lines 15-21 Link Here
15
</ul>
15
</ul>
16
</li>
16
</li>
17
	<li>To send additional notices, click on the tabs for 'Second' and 'Third' notice</li>
17
	<li>To send additional notices, click on the tabs for 'Second' and 'Third' notice</li>
18
	<li>If you would like to prevent a patron from checking items out because of their overdue items, check the 'Restrict' box, this will put a notice on the patron's record at checkout informing the librarian that the patron cannot check out due to overdue items.</li>
18
	<li>If you would like to prevent a patron from checking items out because of their overdue items, check the 'Restrict' box, this will put a notice on the patron's record at checkout informing the librarian that the patron cannot check out due to overdue items.
19
	<ul>
20
	<li>    If you choose to restrict a patron in this way you can also have Koha automatically remove that restriction with the AutoRemoveOverduesRestrictions preference.</li>
21
	</ul></li>
22
	<li>Next you can choose the delivery method for the overdue notice. You can choose from Email, Feed, Phone (if you are using the iTiva Talking Tech service), Print and SMS (if you have set your SMSSendDriver). </li>
19
	<li>See a Sample Overdue Notice</li>
23
	<li>See a Sample Overdue Notice</li>
20
</ul>
24
</ul>
21
25
22
- 

Return to bug 12244