Label Printing
You can find label printing under Articles → Labels → Label Printing. Use the tabs to select which type of label you want to print. Please also note the following table:
Label type | Required plugin |
Article labels | ERP |
Storage bin labels | ERP |
Customer cards | POS |
Picking box labels | WMS |
If articles, storage bins, or customers have been flagged for label printing, they will be displayed here in the corresponding tab. Articles can be flagged, for example, as part of a new supplier order, in the article overview using the Flag all for label printing or Flag selected for label printing button, or within the article details via the barcode icon next to the Article number field.
Otherwise, you can use the search field to add further articles, storage bins, or customers, then select the desired label template on the right side and make additional settings for the print.
Label Configurator
In the label configurator, you can create new templates for label printing and edit existing templates. You can find it under Articles → Labels → Template Configurator.
Tab Layout - Here you can select a suitable layout and page format for your label. If you're using a label printer, select Single label and then define the page dimensions individually under Label size. The templates automatically adapt to the size of the labels. You can check every change to your template at any time using the preview with any article in the top right corner. For storage bin and box labels, you can also edit the label size and print margin if you select the Single label page format.
Tab Content - Here you can define the content of the individual fields on the label. Under Barcode, you select whether the EAN number or the Shopware article number should be encoded in the barcode. The available text fields are shown on the right. Click the clipboard icon to copy the text block to your clipboard, and you can then paste it into any area on the label. Using the free text fields, found under the labels {$articleAttributes['attr1']} through {$articleAttributes['attr20']}, you can also add individual information to the label, such as ingredients.
Note: The default font size is set to 12pt. For smaller formats, you should adjust the font size accordingly.
Further Options for Editing Article Labels
If you want to customize the templates for article labels even further, you'll find
/Shopware/Plugins/Community/Core/ShopwarePickwareERP/Views/documents/barcode_label_templates/
our pre-configured templates, along with a description in the first 17 lines of the .tpl file explaining how and, most importantly, where your own templates should be stored:
- Custom templates may be added to the Shopware root in folder /themes/Frontend/Bare/documents/viison_pickware_barcode_label_templates/.
- Add a preview image by adding a PNG file to the custom labels directory with the same name as the custom label.
e.g. my-custom-template.tpl and my-custom-template.png
Configurable text elements:
- To add a configurable element just add a block with the name barcode-label-content-box--my-name.
- To add a barcode the name has to be barcode-label-content-box--barcode.
- Configurable blocks in comments are also parsed and shown!
Template names:
To give the template a name, please add a snippet with the name template/file_name_without_tpl_extension/name in the namespace backend/viison_pickware_common_barcode_label_presets/barcode_label_templates
Note on Updates
When our apps are updated, changes you've made may be overwritten. To prevent this, follow these steps:
Copy the .tpl file to the folder /themes/Frontend/Bare/documents/viison_pickware_barcode_label_templates/ and make the desired changes to the template there.
Assign a unique file name.
In the database, find the corresponding entry in the pickware_erp_barcode_label_presets table based on the type (for example, bin_location for storage bin labels) and enter the new file name in the templateIdentifier field.
This way, your changes will be preserved even after an update.