How to set up multilingual for an event

Injection configuration

Add the custom parameter sendMultilingualAsJsonObject=true in the General tab when you configure an External printing interface.

Set up multilingual event fields in the ticket template

Prepare your ticket template and use this template when scheduling a Tickets external printing function
Example: event.name = ${Performance_hostTeam} - ${Performance_opposingTeam}

Other available multilingual fields:

TIXNGO name	S-360 Ticket template config name	S-360 usually uses variables	Translated values come from
Event group name	event.group.name	${Product_externalName}	Organisation > Catalogue > Ordinary admissions > Competition
Event group image	event.group.image	Static URL	Multilingual value has not been supported in S-360 yet but can update this value in TIXNGO
Event name	event.name	${Performance_hostTeam} - ${Performance_opposingTeam}	Organisation > Initialisation > Organisation parameters > Teams
Event website	event.website	Static URL	Multilingual value has not been supported in S-360 yet but can update this value in TIXNGO
Event address site	event.address.site	${Space_externalName}	Institution > Venue > Venue parameters > Space
Event address city	event.address.city	${Site_externalName}	Institution > Venue > Venue parameters > Sites (General)
Event address line1	event.address.line1	${Site_street1}	Institution > Venue > Venue parameters > Sites (Address) Multilingual value has not been supported in S-360 yet but can update this value in TIXNGO
Event address line2	event.address.line2	${Site_street2}
Event address line3	event.address.line3	${Site_street3}

Set up multilingual ticket detail values in the ticket template

TIXNGO name	S-360 Ticket template config name	S-360 usually uses variables	Translated values come from
Ticket details main	ticketDetails.main.<sequence>.key	Static values Hospitality, Entrance, Gate, Block, Row, Seat,...	Multilingual value has not been supported in S-360 yet but can update this value in TIXNGO
Ticket details main	ticketDetails.main.<sequence>.value	${Hospitality_seatRoomName}, ${External_Entrance_externalName}, ${Entrance_externalName}, ${Seat_block}, ${Seat_row}, ${Seat_nb},...
Ticket details extra	ticketDetails.extra.<sequence>.key	Static values Category, Order number, ticket number, target group, No re-entry,...	Multilingual value has not been supported in S-360 yet but can update this value in TIXNGO
Ticket details extra	ticketDetails.extra.<sequence>.value	${LogicalSeatCategory_externalName}, ${Operation_field}, ${Ticket_taxnumber}, ${Amount_currency} ${Amount_baseUnitAmount}, ${Contingent_externalName}
Ticket details hidden (Not displayed in the mobile ticket app)	ticketDetails.hidden.<sequence>.key	Static values	Multilingual value has not been supported in S-360 and TIXNGO yet
	ticketDetails.hidden.<sequence>.value	Any values

*sequence: the order of information will be displayed on TIXNGO, the sequence is started from 0 and is independent in each section.

Initialize an S360 event and ticket detail label in TIXNGO Back Office

Prepare sample ticket per each kind of ticket for each event, and inject those tickets to TIXNGO system

All available labels will be displayed in the Edit event screen on TIXNGO Back Office

Can choose a language on the top right of Edit event screen to view and edit the event fields and ticket labels in multilingual

Download CSV template file

Please download the CSV template file here.
Download

Using the CSV template file to prepare your data

To get more understanding of TIXNGO ticket's fields, you can check out this documentation Understanding TIXNGO Ticket Injection

Supported multilingual fields:

event.group.name
event.group.image
event.name
event.name2(not in use)
event.website
event.address.site
event.address.city
event.address.line1
event.address.line2
event.address.line3
ticketDetails.main (values)
ticketDetails.extra (values)
ticketDetails.hidden (values)

For further information, please consult the Sample Multilingual Ticket. If you wish to inject the tickets directly into TIXNGO via API, you can also refer to this format.

Sample Multilingual Ticket

"tickets": [
    {
    …
    "event": { 
        "id": "TIXNGO-102285",
        "address": {
          "site": { "en":"site", "fr":"fr_site", "de":"de_site", "es":"es_site" },
          "line1": { "en":"line1", "fr":"fr_line1", "de":"de_line1", "es":"es_line1" },
          "line2": { "en":"line2", "fr":"fr_line2", "de":"de_line2", "es":"es_line2" },
          "line3": { "en":"line3", "fr":"fr_line3", "de":"de_line3", "es":"es_line3" },
          "city": { "en":"city", "fr":"fr_city", "de":"de_city", "es":"es_city" },
          "countryCode": "string",
          "region": "string",
          "zip": "string",
          "longitude": 0,
          "latitude": 0
        },
        "name": { "en":"name", "fr":"fr_name", "de":"de_name", "es":"es_name" },
        "name2": { "en":"name2", "fr":"fr_name2", "de":"de_name2", "es":"es_name2" },
        "website": { "en":"https://en.url.co/", "fr":"https://fr.url.co/", "de":"https://de.url.co/", "es":"https://es.url.co/" },
        "startTime": "string",
        "expirationDate": "string",
        "bluetoothPreparationRibbonDisplayTime": "string",
        "bluetoothPreparationRibbonEndTime": "string",
        "metadata": [
          {
            "key": "string",
            "value": "string"
          }
        ],
        "group": {
          "id": "TIXNGO-1022",
          "name": { "en":"name", "fr":"fr_name", "de":"de_name", "es":"es_name" },
          "image": { "en":"image", "fr":"fr_image", "de":"de_image", "es":"es_image" }
        }
      },
    …
      "ticketDetails": {
        "main": [
          {
            "key": "key1",
            "value": { "en":"value1", "fr":"fr_value1", "de":"de_value1", "es":"es_value1" }
          }
        ],
        "extra": [
          {
            "key": "key2",
            "value": { "en":"value2", "fr":"fr_value2", "de":"de_value2", "es":"es_value2" }
          }
        ],
        "hidden": [
          {
            "key": "key3",
            "value": { "en":"value3", "fr":"fr_value3", "de":"de_value3", "es":"es_value3" }
          }
        ]
      },
    …
      "ticketId": "TIXNGO-10228511187604",
    …
    }

Inject the prepared CSV file to TIXNGO

To begin, ensure that the naming of your CSV file adheres to the following convention: "<your free text>multilingual.csv". If the file name does not conform to this convention, errors may occur.

Go to CSV Injection screen on TIXNGO Back Office
Select your prepared CSV file and upload it to TIXNGO by clicking the submit button
The result of this action is displayed in the list below

Set up multilingual ticket detail labels in TIXNGO Back Office

Please choose the language you want to update the ticket details label

Example:

Language	Section	Setting on TIXNGO Back Office	Displayed on mobile ticket app
English	Main Data (ticketDetails.main)
English	Extra Data (ticketDetails.extra)
German	Main Data (ticketDetails.main)
German	Extra Data (ticketDetails.extra)
Hungarian	Main Data (ticketDetails.main)
Hungarian	Extra Data (ticketDetails.extra)

Update the translation in TIXNGO Back Office

The details for the event consist of the following fields to be able to update in multilingual:
the name and image URL of the event group, the name and website URL of the event, the address information includes the site, city, and three address lines.

Limitation

At present, TIXNGO supports only the languages listed below, and not all languages.

Language	Code (ISO 639-1:2023)
Arabic	ar
Catalan, Valencian	ca
Czech	cs
Dutch, Flemish	nl
English	en
French	fr
German	de
Greek, Modern (1453–)	el
Hungarian	hu
Italian	it
Norwegian	no
Polish	pl
Portuguese	pt
Spanish, Castilian	es
Turkish	tr

Reference: https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes

Page tree