Page History
In 3AMK libraries, we are using special printers for printing spine labels. Our printer models are Datamax E-4203, Datamax E-4204, Attune Delta A2 and TSC TA310.
The label sizes are 38mm x 25mm (Haaga-Helia, Laurea) and 36mm x 23mm (Metropolia)
<Here's our documentation as a Word document.> / I'll add this tomorrow 26.11., Johanna /
1. Need for different layouts
Label 1. All information is taken from itemcallnumber 
The label should look like this. 
On the first line there is shelf number
On the second line main word (VEAL) is printed.
- The challenge: If the main word is long, it is splitted to the third/fourth line. In Koha-Suomi version, we manually fix these by putting a shorter word to Koha at first, and after printing, we change it back to normal.
Label 2. All information is taken from itemcallnumber
...
2. How to get labels libraries need?
Option 1. Koha's Tools > Catalog: Quick spine label creator
- Suitable for libraries which use only one-type of label
Option 2. Koha's Tools > Catalog: Label creator
https://koha3-kktest.lib.helsinki.fi/cgi-bin/koha/labels/label-home.pl
- To test this, I've created a template and a label layout (both are named as Finn-ID 38mm x 25mm), and printer profile (Datamax/Attune) for testing purposeson Koha3 test server.
- I manage to print labels for Haaga campus. So this method works in some libraries!
- If you need labels where call number is splitted to the second line and to 3-letters/characters, use option 23.
Option
...
3. Label maker plugin by ByWater Solutions
- Label Creator plugin blog and video instructions:
- Part 1: https://bywatersolutions.com/education/label-creator-plugin
- Part 1, video: Label Maker Koha Plugin Part 1
- Part 2: https://bywatersolutions.com/education/using-the-label-plugin-in-koha-part-2
- Part 2, video: Label Maker Plugin Koha Part 2
- Github: https://github.com/bywatersolutions/koha-plugin-label-maker
The plugin is installed in Koha3 test server, and can be used:
https://koha3-kktest.lib.helsinki.fi/cgi-bin/koha/plugins/plugins-home.pl
- In your own Koha, go to Administrator > Manage plugins > Plugins
- Install latest KPZ-file from Github
- Click button Actions > Run tool
- Plugin can also be found via Tools > Tool plugins > Label Maker
- Default templates are: Avery Standard Labels and Basix 55-459-007 (do not delete those)
- Additional templates Copy additional templates and layouts from here, or from Koha3 test server, for Datamax and Attune printers (do not delete, copy if you want to create your own templates; below):
Template for Finn-ID 38mm x 25mm (Itemcallnumber, Pääsana kokonaan)
...
[% FOREACH item IN items %]
[% IF loop.index % 1 == 0 %]
[% SET label_index = 1 %]
[% UNLESS loop.first %]
</span>
[% END %]
<span class="page">
[% END %]
<div class="label label[% label_index %]">
[% item.itemcallnumber.replace('^(\S+)\s+(\S{0,3}).*', '$1<br>$2') %]
</div>
[% IF loop.last %]</span>[% END %]
[% SET label_index = label_index + 1 %]
[% END %]Layout for Finn-ID 38mm x 25mm (Arial
...
12)
- Basic layout that you can easily modify for your own purposes
- padding-top: 3-6mm (In Haaga-Helia, we use value 3mm here)
- margin-left; 5-6mm (In Haaga-Helia, we use value 6mm here)
html, body, div, span, h1 {
margin: 0;
padding: 01;
border: 0;
}
body {
width: 8.5in 43mm; /* Width of label page */
height: 30mm; /* Height of label page */
font-family: Arial;
}
.page {
padding-top: 6mm; /* Height from top of page to top of first label row */
margin-left: 6mm; /* Width of gap from left of page to left edge of first label column */
page-break-after: always;
clear: left;
display: block;
}
.label {
width: 38mm; /* Width of actual label */
height: 25mm; /* Height of actual label */
margin-right: 0in; /* Distance between each column of labels */
float: left;
text-align: left;
font-weight: bold;
font-size: 12px;
overflow: hidden;
}
/* Uncomment for testing and debugging */
/* outline: 1px dotted; */
}
.page-break {
clear: left;
display: block;
page-break-after: always;
} |
Layout for Finn-ID KAPEAMPI 36mm x 23mm (Arial 12)
html, body, div, span, h1 { margin: 0; padding: 1.18in ; border: 0; } body { width: 38mm; /* Width of label page */ height: 28mm; /* Height of label page */ font-family: Arial; } .page { padding-top: 6mm; /* Height from top of page to top of first label row */ margin-left:0.098in 5mm; /* Width of gap from left of page to left edge of first label column */ page-break-after: always; clear: left; display: block; } .label { width:1.5in 36mm; /* Width of actual label */ height:0.98in 23mm; /* Height of actual label */ margin-right: 0in; /* Distance between each column of labels */ float: left; text-align: left; font-weight: bold; font-size: 12px; overflow: hidden; } /* Uncomment for testing and debugging */ /* outline: 1px dotted; */ } .page-break { clear: left; display: block; page-break-after: always; } |
Layout for Finn-ID 38mm x 25mm (Arial 16)
html, body, div, span, h1 { margin: 0; padding: 1; border: 0; } body { width: 43mm; /* Width of label page */ height: 30mm; /* Height of label page */ font-family: Arial; |
- On Koha3 - test server, there are batches with several items, and you can use those to test printing.
...
- There are no examples on how to set Printer profiles / 31.10.2020 jmiettunen
3. How to print labels using plugin
...
<Detailed Word document is added later this week!>
- Go to Tools - Tool plugins > Label Maker
- Click New - Label batch
- It will take you Koha's own tool "Label creator". Add barcodes you want to print (NB! this can be done in several ways in Koha).
- Go back to Label Maker plugin and click Print labels
- Select the batch that includes barcodes you needwant to print to labels (batch number)
- Select the template
- Select layout
- No need to select printer profile (since we don't have one yet, - because we dpndon't know how to create one by coding)
- Click Print labels
5. In Browser preview window (Firefox
...
), select Print
- This phase is to be tested....
from right-side menu
6. Print Setup - Format & Options (landscape, scale 130, %, uncross Shrink to fit Page Width)
7. Print Setup Margins & Header/Footer - 0 margins to all, blank to all
8. Then click Print
9. Choose Microsoft Print to PDF, and create pdf. Save pdf to e.g. Desktop, use separate folder that is easy to locate.
10. Print pdf by choosing the label printer like Datamax, Attune, TSC. Check that Page sizing and Handling you have Actual fit; and orientation is here Portrait.
<See attached document about settings in Datamax and Attune printers > / I will add the Word document later this week, Johanna /
4. Managing label batches
- Label batches can be managed in Koha's own tool (Label creator)
- Home › Tools › Label creator › Batches
Comments about information related to plugin
...
Helpful links when modifying layouts
Conversion of Measurement Units
CSS Tutorial (for padding, margins etc.)
CSS Web Safe Fonts
Font families
- There seems to be mistakes/errors on documentation. Their code shown below should do the splitting part. But is it correct? / 12.6.2020 jmiettunen
$(document).ready(function () {
$('.label').each(function() {
let theText = $(this).text();
let theNewText = theText.trim().replace(/\s+/g, '
').replace('.' , '
.');
$(this).html(theNewText);
})
});
Perl split functions (no idea if this is useful...) / 19.10.2020 jmiettunen
see: https://www.geeksforgeeks.org/perl-split-function/