Barcode

Introduction

The console 8.3 and later offers the possibility to generate a bar code and associate it with a field of the console. This function is useful when you want to put in a newsletter a barcode such as a discount or a promotion tied to a product.

This frontend page will render and print out a barcode image, starting from a numeric/alpha numeric sequence dynamically retrieved upon "IdOptin" and "Hash" arguments passed to the page.
This page requires the numeric sequence to be previously stored in one of the personal information fields in order to run. This requirement was introduced in order to prevent fraud URL usage or any kind of exploitation of the service.

Barcode.aspx resides in the "frontend" root of each 8.3 console or later version and does not store or save any of the rendered barcode images on the "console" storage disk so that the server burden will be kept at its lowest.

How to generate the URL

It can be referenced straight away from the "src" property of a HTML IMG tag using a pattern:
Base URL
http://<consoleurl>/frontend/Barcode.aspx
Complete Url With Params
<img src=http://<ConsoleHost>/frontend/Barcode.aspx?idoptin=[_idoptin]&hash=[_hash]&BarcodeHeight=60&SymbologyId=14&NarrowBarWidth=2&bearerbarsmode=0&BitmapTargetFormat=1&Ratio=0&TargetDynField=[LatestShippedOrderID]&FontHeight=0,2 />
Note : the above sample requests a i2of5 formatted barcode ( SymbologyId = 14 ), sets height to 60 pixels with 0,2 points font. Each symbology has its own specific set of requirements ( starting from the length of the numeric sequence it will be built on )
Don't' forget to replace <consolehost> with the actual URL of you MailUp console and fill the recipient field LatestShippedOrderID with a real barcode numeric value ( for symbology 14 in the above snippet you can fill it using any number of even length ).

Output sample

Below a sample of Interleaved 2 of 5 rendered from a 14 digits sequence

Request parameters ( Table 1)

Symbology format Id reference (Table 2)

How to build your Barcode URL

Since there's no built in functionality helping you to display a barcode inside the markup, you'll need to build yourself the URL.
No panic, it takes two minutes.
Please follow the brief guide prepared to build your own Barcode Image URL :

1. Open any text editor you're comfortable to work with ( we recommend Notepad++ but Windows Notepad will be fine either way)
2. Paste in the editable window the following snippet : http://<ConsoleHost>/frontend/Barcode.aspx?idoptin=[_idoptin]&hash=[_hash]&BarcodeHeight=60&SymbologyId=14&NarrowBarWidth=2&bearerbarsmode=0&BitmapTargetFormat=1&Ratio=0&TargetDynField=[LatestShippedOrderID]&FontHeight=0,2
3. Now replace those parts of the query string marked in red with actual information : <consolehost> must be replace with your console URL ( for instance a8g5c.mailup.com ) and LatestShippedOrderId with the Dynamic Field you've defined holding ( and filled in with ) the barcode numeric number.
4. Select it entirely ( CTRL + A ) and copy it to clipboard ( CTRL +C )
5. Now open your web browser and Log into your MailUp console
6. Click on Messages > Email > New > Create New Email as below

7. Type in subject textbox and jump to the HTML editor area, then click on the HTML tab at the bottom of it and click on the "<> HTML" tab as shown in the below screen shot

8. Write a plain and empty HTML Img tag such as <img src="" /> in the writable area of the editor as below

9. Now it's time to fill the Image tag "src "property with the actual barcode module path : barcode image path must always display an absolute path : <img src="PASTE HERE YOUR BARCODE URL PREVIOUSLY COPIED FROM NOTEPAD" />

10. Click on Save. Now you should be seeing the barcode rendered in the preview window as below

Rendering failure