Ir para conteúdo principal

Como personalizar o Seletor de opções

Personalize a forma como as opções do produto e os idiomas dos comentários da viagem são apresentados.

Atualizado esta semana

A funcionalidade Seletor de opções, juntamente com as respetivas subfuncionalidades, permite personalizar a forma como as opções do produto e os idiomas dos comentários da viagem são apresentados. Com várias configurações, pode criar um esquema altamente personalizado. Enquanto os estados por defeito forneçam uma apresentação base, recomendamos a utilização conjunta de todas as subfuncionalidades ao efetuar alterações, de modo a garantir uma personalização ideal.

Lista de funcionalidades do Seletor de opções

A funcionalidade Seletor de opções contém várias subfuncionalidades. Adicione o código abaixo ao seu checkout da Ventrata fazendo uma das duas seguintes coisas:

Para poder personalizar a forma como as opções são exibidas, siga esta sintaxe:

  • a funcionalidade optionSelector é colocada dentro do objeto features

  • todas as suas subfuncionalidades são depois definidas no objeto optionSelector

  • Atualizar o atributo Data-Config - adicionando o código abaixo no atributo data-config do seu script de checkout, veja o Guia de Implementação para mais informações.

    "features": {
    "optionSelector": {
    "preselectFirstOption": true / false, (default: true)
    "placement": "above-tickets" / "separate-step", (default: "separate-step")
    "type": "expandable" / "fixed" (default: "fixed")
    }
    }

📒 NOTA

Adicionar a funcionalidade ao data-config ativa-a para todos os produtos no checkout. Recomendamos limitar esta funcionalidade a produtos específicos, especificando o ID do produto no atributo data-config.

  • Adicionar funcionalidade ao Script ou Botão - adicione a funcionalidade à sua configuração de dados para script ou botão no seguinte formato:

    <script 
    src="https://cdn.checkout.ventrata.com/v3/production/ventrata-checkout.min.js" type="module" data-config='{"apiKey":"<YOUR_API_TOKEN>", "features":{"optionSelector": {"preselectFirstOption": true, "placement": "above-tickets", "type": "expandable" }}}'></script>

📒 NOTA

As alterações ao Seletor de opções não serão apresentadas se um ID de opção for especificado no data-config, uma vez que uma opção já foi selecionada.

A funcionalidade Seletor de opções suporta as seguintes sub-funcionalidades:

Sub-funcionalidade

Por defeito

Valores disponíveis

Descrição

preselectFirstOption

true

true / false

quando ativada, se o produto contiver várias opções, a primeira da lista é pré-selecionada

placement

"separate-step"

"above-tickets" / "separate-step"

por defeito, as opções são selecionadas numa etapa separada, ou seja, página; quando as opções são colocadas acima dos bilhetes, são selecionadas na mesma página dos bilhetes e datas da viagem

type

"fixed"

"expandable" / "fixed"

a definição fixa por defeito aplica-se a ambas as colocações exibindo todas as opções disponíveis; o tipo expansível pode ser usado apenas acima dos bilhetes, onde as opções estão recolhidas e apenas a opção selecionada é visível


Fluxo do Seletor de opções

O cliente seleciona um produto. Consoante as definições do Seletor de opções, podem ocorrer os seguintes cenários.

Definições por defeito

Os idiomas dos comentários da viagem e as opções são apresentados numa página separada. Os comentários estão recolhidos e todas as opções de produto disponíveis estão listadas na página.

📗 DICA

Todas as definições por defeito correspondem a comportamentos de seleção de opções por defeito e, por isso, não precisam de ser indicadas no data-config.

Configurações por defeito


Definições alternativas de funcionalidade

É possível utilizar variações das definições.

  • As línguas dos comentários da viagem e todas as opções de produto disponíveis estão listadas na página de Tickets (Bilhetes) acima da seleção de bilhetes. A primeira opção da lista é pré-selecionada.

Sub-função

Configuração

preselectFirstOption

true

placement

"above-tickets"

type

"fixed"

Preselect Option, Above Tickets, Fixed

Opção pré-selecionada, acima dos bilhetes, fixa


  • As línguas dos comentários da viagem e todas as opções de produto disponíveis estão listadas na página de Tickets (Bilhetes) acima da seleção de bilhetes. Nenhuma opção é pré-selecionada.

Sub-função

Configuração

preselectFirstOption

false

placement

"above-tickets"

type

"fixed"

Preselect False, Above Tickets, Fixed

Pré-seleção falsa, acima dos bilhetes, fixa


  • As línguas dos comentários da viagem e todas as opções de produto disponíveis estão listadas na página de Tickets (Bilhetes) acima da seleção de bilhetes. A primeira opção é pré-selecionada, enquanto as outras opções disponíveis permanecem ocultas. Para ver e selecionar opções diferentes, altere a opção atualmente selecionada.

Sub-função

Configuração

preselectFirstOption

true

placement

"above-tickets"

type

"expandable"

Preselect Option, Above Tickets, Expandable

Opção pré-selecionada, acima dos bilhetes, expansível


Aplicação não intencional

Se um ID do produto não for especificado na data-config, as configurações do Seletor de opções são aplicadas a todos os produtos, mesmo aqueles sem opções. Para evitar a aplicação indesejada dessas configurações, certifique-se de incluir o ID do(s) produto(s) específico(s).

Default Settings (left) &amp; Above-Ticket, Expandable (right)

Configurações por defeito (à esquerda) e Acima do bilhete, expansível (à direita)

Isto respondeu à sua pergunta?