How to add and customize visitor badges

Table of content

• Where to find your badge files
• Which Badge refers to which file
• Printing different badges depending on company
• How to edit the badges with HTML

Where to find your badge files

Using the Print agent

The badges can be edited via the XML in %programdata%/Pronestor Visitor on the machine where the print agent is installed.

Restart the visitor print agent for the badge changes to take effect.

 

Using the locally installed version of Pronestor Visitor

All badges are located on each PC running Pronestor Visitor. The files are located in the program data folder:

Windows XP c:\program and documents\all users\application files\Pronestor visitor

Windows 7/8/10
c:\programdata\Pronestor visitor

 

Which Badge refers to which file

In the folder you will find 5 badge files.

badge_1.xml refers to the badge layout Standard

badge_2.xml refers to the badge layout Anonymous

badge_3.xml refers to the badge layout Incl. time

badge_4.xml refers to the badge layout Period

badge_5.xml refers to an additional badge connected to Parking.

Printing different badges depending on company

 

Multi companies and badge layouts

If multiple companies and different badges are to be printed -  company-specific design folders should be created in %programdata%/Pronestor Visitor

Create a folder for each company - and label each folder "company_x" where "x" is matching the company id. Ex. "company_1".   

(the company id can be found within administration->Organization, hover a company and look for the URL which contains the company-id)

Copy from %programdata%/Pronestor Visitor all the badge_1.xml to badge_5.xml to all the company_x folders. Customize the design within each company folder, with a logo, etc.

 

How to edit the badges with HTML

Each badge design consists of a series of elements. An element can be either an image (imageelement), an input field (inputelement), a text field (textelement) or a barcode tag (barcodeelement).

>Each element will be positioned according to an x- and y-coordinate.

ImageElement / Logos

Images/logos of type bmp or png can be added to your badge.

A default company logo has been added by default - this logo can be changed by overwriting it with your company logo instead.

The logo - customer_logo.bmp - is to be found in the program data folder as described above. To fit in the default design, the logo should not be more than 480x180px (Width x Height)

If Zebra printer is used please ensure an image resolution of minimum 300 dpi and in white/black only (not gray).

You can add several images to the same badge. If two images are overlaps, then the element added last in the badge design will be on top.

 

Tags:

<path> Image file name – file must be stored in the same folder as the badge. The picture cannot be scaled, so make sure the picture has the right resolution.

Ex.
<element xsi:type="ImageElement">
<x>150</x>
<y>7</y>
<path>customer_logo.bmp</path>
</element>

 

Input Element

A badge can show a set of fields for the corresponding registration ex. name of visitor, visitor category etc.

Beside a predefined set of fields, for the advanced setup you can also point to specific database fields.

NOTE - the inputname must be in capital letters

 

HOSTNAME
Full name of the visitor’s host (ex. Michael Scofield)

 

HOSTNAME_RESVERSE
Host’s full name reversed (ex. Scofield, Michael)

 

GUESTNAME
Visitor’s full name (ex. Sara Tancredi)

 

GUESTNAME_REVERSE
Visitor’s full name reversed (ex. Tancredi, Sara)

 

GUESTCOMPANY
Visitor category (ex. Visitor, Service, VIP)

 

STARTDATE
Badge start date (ex. 24/12-2010 13:00)

 

ENDDATE
Badge end date (ex. 24/12-2010 17:00)

 

SHORTSTARTDATE
Badge short start date (ex. 24/12-2010)

 

SHORTENDDATE
Badge short end date (ex. 24/12-2010)

 

BADGEID
Unique auto generated ID for the badge (ex. 42)

 

Tags:
<inputname> Field name – accordingly to the above mention fields
<fontname> Windows font name
<maxcharacters> Maximum number of characters rendered
<fontsize> Size in points

 

Ex.
<element xsi:type="InputElement">
<x>10</x>
<y>20</y>      
<inputname>GUESTCATEGORY</inputname>
<fontname>Arial Black</fontname>
<maxcharacters>15</maxcharacters>
<fontsize>14</fontsize>      
</element>    

 

CUSTOMFIELD
A specific database column from either Badge, participant or appuser table. (ex. CUSTOMFIELD:badge.wifi_user or CUSTOMFIELD.badge.wifi_password)

 

Ex.
<element xsi:type="InputElement">
<x>10</x>
<y>20</y>      
<inputname>CUSTOMFIELD:badge.wifi_user</inputname>
<fontname>Arial Black</fontname>
<maxcharacters>15</maxcharacters>
<fontsize>14</fontsize>      
</element>      

 

TextElement

 

Tags:
<textvalue> Text to be inserted
<fontname> Windows font name
<fontsize> Size in points

 

Ex.             
<element xsi:type="TextElement">
<x>200</x>
<y>100</y>      
<textvalue>Passwd:</textvalue>
<fontname>Arial</fontname>
<fontsize>8</fontsize>
</element>

 

BarcodeElement

 

Ex.             
<element xsi:type="BarcodeElement"> 
<x>150</x>
<y>140</y>      
<shrink>0</shrink>            
<height>50</height>                     
<angle>0</angle>
<dpi>200</dpi>
</element>