| Lines 1-62
          
      
      
        Link Here | 
        
          | 1 | [% INCLUDE 'help-top.inc' %] | 1 | [% INCLUDE 'help-top.inc' %] | 
        
          | 2 |  | 2 |  | 
          
            
              | 3 | <h1>Notices</h1> | 3 | <h1>Notices & Slips</h1> | 
        
          | 4 |  | 4 |  | 
          
            
              | 5 | <p>All notices sent by Koha can be customized using the Notices Tool. The system comes with several predefined templates that will appear when you first visit the Notices Tool</p> | 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> | 
        
          | 6 |  | 6 |  | 
          
            
              | 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.</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> | 
        
          | 8 |  | 8 |  | 
          
            
              | 9 | <h2>Adding Notices</h2> | 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> | 
        
          | 10 |  | 10 |  | 
          
            
              | 11 | <p>To add a new notice</p> | 11 | <h3>Adding Notices & Slips</h3> | 
            
              |  |  | 12 |  | 
            
              | 13 | <p>To add a new notice or slip | 
        
          | 12 |  | 14 |  | 
        
          | 13 | <ul> | 15 | <ul> | 
        
          | 14 | 	<li>Click 'New Notice'</li> | 16 | 	<li>Click 'New Notice'</li> | 
            
              |  |  | 17 | 	<li>Choose which library this notice or slip is for</li> | 
        
          | 15 | 	<li>Choose the module this notice is related to</li> | 18 | 	<li>Choose the module this notice is related to</li> | 
        
          | 16 | 	<li>The Code is limited to 20 characters</li> | 19 | 	<li>The Code is limited to 20 characters</li> | 
        
          | 17 | 	<li>Use the name field to expand on your Code</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> | 
        
          | 18 | 	<li>Message Subject is what will appear in the subject line of the email</li> | 22 | 	<li>Message Subject is what will appear in the subject line of the email</li> | 
        
          | 19 | 	<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. | 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. | 
        
          | 20 | <ul> | 24 | <ul> | 
          
            
              | 21 | 	<li style="color: #990000;">Important: On overdue notices make sure to use <<items.content>> to print out the data related to all items that are overdue. The other option is to use the <item></item> tags to span the line so that it will print out multiple lines</li> | 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> | 
            
              | 22 | 	<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> | 26 | <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> | 
            
              | 28 | </ul> | 
            
              | 29 | <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: <fine>USD</fine> Due date: <<issues.date_due>> </item></li> | 
            
              | 31 | </ul> | 
        
          | 23 | </ul> | 32 | </ul> | 
        
          | 24 | </li> | 33 | </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> | 
        
          | 25 | </ul> | 35 | </ul> | 
        
          | 26 |  | 36 |  | 
          
            
              | 27 | <h3>Notice Markup</h3> | 37 | <h4>Overdue Notice Markup</h4> | 
        
          | 28 |  | 38 |  | 
        
          | 29 | <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> | 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> | 
        
          | 30 |  | 40 |  | 
          
            
              | 31 | <p style="color: #990000;">Important: These new tags only work on the overdue notices, not other circulation related notices at this time.</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> | 
        
          | 32 |  | 42 |  | 
        
          | 33 | <ul> | 43 | <ul> | 
        
          | 34 | 	<li><item></item> which should enclose all fields from the biblio, biblioitems, and items tables.</li> | 44 | 	<li><item></item> which should enclose all fields from the biblio, biblioitems, and items tables.</li> | 
        
          | 35 | 	<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. | 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. | 
        
          | 36 | <ul> | 46 | <ul> | 
          
            
              | 37 | 	<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> | 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> | 
        
          | 38 | </ul> | 48 | </ul> | 
        
          | 39 | </li> | 49 | </li> | 
        
          | 40 | </ul> | 50 | </ul> | 
        
          | 41 |  | 51 |  | 
          
            
              | 42 | <p>An example of using these two tags in a notice template might be like: | 52 | <p>An example of using these two tags in a notice template might be like:</p> | 
        
          | 43 |  | 53 |  | 
          
            
              | 44 | <blockquote> | 54 | <pre class="programlisting">   The following item(s) is/are currently overdue: | 
            
              | 45 | <pre>The following item(s) is/are currently overdue: |  |  | 
            
              | 46 |    <item>"<<biblio.title>>" by <<biblio.author>>, <<items.itemcallnumber>>, Barcode: <<items.barcode>> Fine: <fine>GBP</fine></item></pre> | 
            
              | 47 | </blockquote> | 
        
          | 48 |  | 55 |  | 
          
            
              | 49 | <p>Which, assuming two items were overdue, would result in a notice like:</p> | 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: | 
        
          | 50 |  | 59 |  | 
          
            
              | 51 | <blockquote> | 60 |    "A Short History of Western Civilization" by Harrison, John B, 909.09821 H2451, Barcode: 08030003 Fine: £3.50 | 
            
              | 52 | <pre>The following item(s) is/are currently overdue: | 61 |    "History of Western Civilization" by Hayes, Carlton Joseph Huntley, 909.09821 H3261 v.1, Barcode: 08030004 Fine: £3.50</pre> | 
            
              | 53 | "A Short History of Western Civilization" by Harrison, John B, 909.09821 H2451, Barcode: 08030003 Fine: £3.50  |  |  | 
            
              | 54 | "History of Western Civilization" by Hayes, Carlton Joseph Huntley, 909.09821 H3261 v.1, Barcode: 08030004 Fine: £3.50</pre> | 
            
              | 55 | </blockquote> | 
        
          | 56 |  | 62 |  | 
          
            
              | 57 | <h2>Existing Notices</h2> | 63 | <h3>Existing Notices & Slips</h3> | 
        
          | 58 |  | 64 |  | 
          
            
              | 59 | <p>Among the default notices are notices for several common actions within Koha, here are some of what those notices do</p> | 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> | 
        
          | 60 |  | 66 |  | 
        
          | 61 | <ul> | 67 | <ul> | 
        
          | 62 | 	<li>ACCTDETAILS | 68 | 	<li>ACCTDETAILS | 
  
    | Lines 67-119
          
      
      
        Link Here | 
        
          | 67 | 	<li>ACQCLAIM (Acquisition Claim) | 73 | 	<li>ACQCLAIM (Acquisition Claim) | 
        
          | 68 | <ul> | 74 | <ul> | 
        
          | 69 | 	<li>Used in the claim acquisition module</li> | 75 | 	<li>Used in the claim acquisition module</li> | 
          
            
              | 70 | 	<li>Get there: More > Acquisitions > Late issues</li> | 76 | 	<li><span class="emphasis"><em>Get there:</em></span> More > Acquisitions > Late issues</li> | 
        
          | 71 | </ul> | 77 | </ul> | 
        
          | 72 | </li> | 78 | </li> | 
        
          | 73 | 	<li>HOLD (Hold Available for Pickup) | 79 | 	<li>HOLD (Hold Available for Pickup) | 
        
          | 74 | <ul> | 80 | <ul> | 
        
          | 75 | 	<li>This notice is used if two criteria are met: | 81 | 	<li>This notice is used if two criteria are met: | 
          
            
              | 76 | <ul> | 82 | <div class="orderedlist"> | 
            
              | 77 | 	<li>The EnhancedMessagingPreferences is set to 'Allow'</li> | 83 | <ol type="1"> | 
            
              |  |  | 84 | 	<li>The <span class="link">EnhancedMessagingPreferences</span> is set to 'Allow'</li> | 
        
          | 78 | 	<li>The patron has requested to receive this notice | 85 | 	<li>The patron has requested to receive this notice | 
        
          | 79 | <ul> | 86 | <ul> | 
          
            
              | 80 | 	<li>Get there: OPAC > Login > my messaging</li> | 87 | 	<li><span class="emphasis"><em>Get there: </em></span>OPAC > Login > my messaging</li> | 
            
              | 81 | 	<li>Get there: Staff Client > Patron Record > Notices</li> | 88 | 	<li><span class="emphasis"><em>Get there: </em></span>Staff Client > Patron Record > Notices</li> | 
            
              | 82 | </ul> |  |  | 
            
              | 83 | </li> | 
        
          | 84 | </ul> | 89 | </ul> | 
        
          | 85 | </li> | 90 | </li> | 
            
              |  |  | 91 | </ol> | 
            
              | 92 | </div></li> | 
            
              | 93 | 	<li>When this notice references the branches table it is referring to the pickup branch information.</li> | 
        
          | 86 | </ul> | 94 | </ul> | 
        
          | 87 | </li> | 95 | </li> | 
        
          | 88 | 	<li>HOLDPLACED (a notice to the library staff that a hold has been placed) | 96 | 	<li>HOLDPLACED (a notice to the library staff that a hold has been placed) | 
        
          | 89 | <ul> | 97 | <ul> | 
        
          | 90 | 	<li>This notice requires the emailLibrarianWhenHoldIsPlaced system preference to be set to 'Enable'</li> | 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> | 
        
          | 91 | </ul> | 100 | </ul> | 
        
          | 92 | </li> | 101 | </li> | 
        
          | 93 | 	<li>HOLD_PRINT (Printed notice when hold available for pickup) | 102 | 	<li>HOLD_PRINT (Printed notice when hold available for pickup) | 
        
          | 94 | <ul> | 103 | <ul> | 
        
          | 95 | 	<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> | 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> | 
        
          | 96 | </ul> | 106 | </ul> | 
        
          | 97 | </li> | 107 | </li> | 
        
          | 98 | 	<li>ODUE (Overdue Notice) | 108 | 	<li>ODUE (Overdue Notice) | 
        
          | 99 | <ul> | 109 | <ul> | 
        
          | 100 | 	<li>This notice is used to send Overdue Notices to Patrons</li> | 110 | 	<li>This notice is used to send Overdue Notices to Patrons</li> | 
          
            
              | 101 | 	<li>Requires that you set Overdue Notice/Status Triggers</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> | 
        
          | 102 | </ul> | 113 | </ul> | 
        
          | 103 | </li> | 114 | </li> | 
        
          | 104 | 	<li>RLIST (Routing List) | 115 | 	<li>RLIST (Routing List) | 
        
          | 105 | <ul> | 116 | <ul> | 
        
          | 106 | 	<li>Used in the serials module to notify patrons/staff of new issues of a serial | 117 | 	<li>Used in the serials module to notify patrons/staff of new issues of a serial | 
        
          | 107 | <ul> | 118 | <ul> | 
          
            
              | 108 | 	<li>Get there: More > Serials > New Subscription</li> | 119 | 	<li><span class="emphasis"><em>Get there:</em></span> More > Serials > <span class="link">New Subscription</span></li> | 
        
          | 109 | </ul> | 120 | </ul> | 
        
          | 110 | </li> | 121 | </li> | 
        
          | 111 | 	<li>You have the option to select the 'Routing List' notice when creating a new subscription (Choose from the 'Patron notification' drop down).</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> | 
          
            
              | 112 | 	<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> | 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> | 
            
              |  |  | 124 | </ul> | 
            
              | 125 | </li> | 
            
              | 126 | </ul> | 
            
              | 127 |  | 
            
              | 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> | 
            
              | 129 |  | 
            
              | 130 | <p>Here is what those slips are used for:</p> | 
            
              | 131 |  | 
            
              | 132 | <ul> | 
            
              | 133 | 	<li>ISSUEQSLIP | 
            
              | 134 | <ul> | 
            
              | 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> | 
            
              | 137 | </ul> | 
            
              | 138 | </li> | 
            
              | 139 | 	<li>ISSUESLIP | 
            
              | 140 | <ul> | 
            
              | 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> | 
            
              | 143 | </ul> | 
            
              | 144 | </li> | 
            
              | 145 | 	<li>RESERVESLIP | 
            
              | 146 | <ul> | 
            
              | 147 | 	<li>Used to print a holds slip</li> | 
            
              | 148 | 	<li>The holds slip is generated when a hold is confirmed</li> | 
            
              | 149 | </ul> | 
            
              | 150 | </li> | 
            
              | 151 | 	<li>TRANSFERSLIP | 
            
              | 152 | <ul> | 
            
              | 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> | 
        
          | 113 | </ul> | 155 | </ul> | 
        
          | 114 | </li> | 156 | </li> | 
        
          | 115 | </ul> | 157 | </ul> | 
        
          | 116 |  | 158 |  | 
          
            
              | 117 | <p><strong>See the full documentation for Notices in the <a href="http://manual.koha-community.org/3.6/en/notices.html">manual</a> (online).</strong></p> | 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> | 
        
          | 118 |  | 160 |  | 
        
          | 119 | [% INCLUDE 'help-bottom.inc' %] | 161 | [% INCLUDE 'help-bottom.inc' %] |