Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
stylenone

...

Snippet attribute

Attribute example

URL parameter

URL parameter example

Code Block
data-viovendi-locale

Locale used for the booking process (translations, dates, numbers, currency…)

doo_locale

de-de, en-us

Code Block
data-viovendi-organizer

doo Organization ID

(minus)

Code Block
data-viovendi-widget-config-name

doo Widget Config Name

(minus)

Code Block
data-viovendi-buyer-prefill

see Details about prefilling booker and attendee data

doo_buyer_prefill

JSON stringify + encodeURIComponent

Code Block
var prefill = { first_name: 'John' };
encodeURIComponent(JSON.stringify(prefill))

{ first_name: 'John' }%7B"first_name"%3A"John"%7D

Code Block
data-viovendi-first-attendee-prefill

see Details about prefilling booker and attendee data

doo_first_attendee_prefill

JSON stringify + encodeURIComponent

Code Block
data-viovendi-code-prefill

for single-use codes: 

Code Block
languagejs
'<XXXX-XXXX-XXXX>'

for multi-use codes:

Code Block
languagejs
'<THE-CODE-YOU-DEFINED>'


doo_code

Code Block
data-viovendi-mode

Widget bootstrap mode,

for starting with booking-edit login screen:

Code Block
booker-login

for autologin into self service booking edit (used together with data-viovendi-booking and data-viovendi-email):

Code Block
booking-details

doo_mode

For autologin into booking self service edit:

https://event_url.com?doo_mode=booking-details&doo_booking=TX-00000-000&doo_email=email@example.com

Note

Even though prefilling the email address is supported, we do not recommend to use this and better have the booker enter his data manually. Basically anybody with the link can see personal identifiable information. Since the link is cached, it is easily retrievable for abuse.

Info

If you use the email as URL parameter, we recommend to use URL encoding, i.e. replacing the “@” sign with “%40”. Otherwise some browsers might have problems when loading the widget.

For entering booking-edit login page:

https://event_url.com?doo_mode=booker-login

Additional parameters &doo_booking=TX-00000-000&doo_email=email@example.com can be used for login form prefill

Code Block
data-viovendi-booking

Booking invoice number TX-... (used with data-viovendi-mode)

doo_booking

Code Block
data-viovendi-email

Booker email (used with data-viovendi-mode)

doo_email

Code Block
data-viovendi-path-keys

holds path keys to resolve provided payment options, the parameter can include one or several path keys

single: 

Code Block
languagejs
'<path_key>'

multiple:

Code Block
languagejs
'<path_key_1>,<path_key_2>,<path_key_3>'

doo_path_keys

Code Block
data-viovendi-tickets-prefill

Tickets prefill

Code Block
data-viovendi-tickets-prefill='{
  "{{ticket_category_id}}": {{amount}},
  ...
}'

// example
data-viovendi-tickets-prefill='{
  "123": 1,
  "124": 3
}'

doo_tickets_prefill

JSON stringify + encodeURIComponent

'{"123": 1,"124": 3}'

'%7B%22123%22%3A%201%2C%22124%22%3A%203%7D'

Code Block
data-viovendi-ticket-selection-step-behavior

Autosubmit ticket-selection step

Code Block
data-viovendi-ticket-selection-step-behavior="autosubmit"

doo_ticket_selection_step_behavior

Code Block
data-viovendi-attendee-data-step-behavior

Autosubmit information step

Code Block
data-viovendi-attendee-data-step-behavior="autosubmit"

doo_information_step_behavior

Code Block
data-viovendi-payment-option

Payment option prefill

Code Block
data-viovendi-payment-option="{{ payment_option_internal_name }}"

// example
data-viovendi-payment-option="paypal"

doo_payment_option

Code Block
data-viovendi-terms-accepted

Auto-accept terms & conditions

Code Block
data-viovendi-terms-accepted="true"

doo_terms_accepted

Code Block
data-viovendi-payment-step-behavior

Autosubmit information step

Code Block
data-viovendi-payment-step-behavior="autosubmit"

doo_payment_step_behavior

Code Block
data-viovendi-logging

Configure logging of the user journey, resources requests, HTTP requests with AWS RUM

Code Block
data-viovendi-logging='{
  "sessionTracking": true,
  "resourceRequests": true,
  "httpRequests": "all"
}'
Expand
titleOptions description

sessionTracking

Defines if cookies are allowed for tracking user journey (requests, pages through sessions).

Options: true, false

Default: false

httpRequests

Defines if all http requests are recorded or only failed

Type: string

Options: “all”, “failed”

Default: “failed”

 

resourceRequests

Defines if requests for resources (images, documents…) are tracked.

Type: boolean

Options: true, false

Default: true

Performance metrics and JS errors are logged by default if logging enabled and their options are not configurable from our side at the moment

doo_logging (will be added with

Jira Legacy
serverSystem JIRA
serverIdbfcf7822-d39f-3344-984e-4fb18921ae4b
keyDOO-23320
)

doo_logging=%7B"sessionTracking"%3Atrue%2C"resourceRequests"%3Atrue%2C"httpRequests"%3A"all"%7D

Code Block
data-viovendi-access-code-field

Hide the access code field or directly show the access code entry field

Code Block
data-viovendi-access-code-field="active"
data-viovendi-access-code-field="hidden"

doo_access_code_field

Code Block
?doo_access_code_field=active
?doo_access_code_field=hidden
Code Block
data-viovendi-promo-code-field

Hide the promotion code field or directly show the promotion code entry field

Options: hidden, active

doo_promo_code_field

Code Block
?doo_promo_code_field=active
?doo_promo_code_field=hidden

Booking Widgets

Booking-widget specific parameters

...

Value

Code Block
languagejs
'{ 
    # default questions
	"salutation": 1, 
	"title": 1, 
	"first_name": "Hans", 
	"last_name": "Maier", 
	"company_name": "doo GmbH", 
	"country": "DE", 
	"street_name": "Hultschiner Str.", 
	"street_number": "8", 
	"zip": "81677", 
	"city": "München", 
	"email": "hans.maier@doo.net",
	
	# additional questions (text, paragraph, dropdown, date, phone, simple selection),
	"<question_name>": "<value>" 
	
	# additional questions (multiple selection),
	"<question_name>": ["1","2","4"],
	
	# additional questions (file)
    "<question_name>": {
      "file_name": "file-name.jpg",
      "file_path": "https://file-path"
    }
    
    # product,
	"<product_name>": 1
}'
  • Salutation can be 1 (Herr/Mr.) or 2 (Frau/Mrs.);

    • don't add if you don't want a salutation

  • Title can be 1 (Dr.) or 2 (Prof. Dr.);

    • don't add if you don't want a title

  • NOTE: If you want to use custom values for Salutation and Title, please contact our doo Support Team under support@doo.net 

  • Country needs to be a 2-letter ISO country code

  • To prefill an external customer ID in a hidden field (for example an ID of an external CRM), include external_customer_id into the JSON object. For example:

    Code Block
    languagejs
    '{
    	..., 
    	"external_customer_id": "0123456789",
    	...
    }'
  • To define attendee type, include attendee_type into the JSON object. For example:

    Code Block
    languagejs
    '{
    	..., 
    	"attendee_type": "Press",
    	...
    }'
    • NOTE: If the value passed does not match any attendee type registration configured for the event, the attendee type information from the widget will be ignored (eg. system behaves as if no attendee type information was passed onto the widget). 

Prefill complex data structure through URL parameter

...