Ações de UI

Use ui.actions para ligar os botões de call-to-action da plataforma (login, subscrição, partilha...) aos modais ou fluxos do seu próprio site.

---

MindtrainingPlatform.init('mindtraining', {
  ui: {
    mode: 'web', // 'web' (predefinido) | 'app'
    actions: {
      openLogin: function () {
        // abre o seu modal de login
      },
      openRegister: function () {
        // abre o seu modal de registo
      },
      openSubscribe: function () {
        // abre a sua página ou modal de subscrição
      },
      openUrl: function (url) {
        window.open(url, '_blank')
      },
      share: function (payload) {
        // payload: { url?: string, title?: string }
        navigator.share({ url: payload.url, title: payload.title })
      },
    },
  },
})

Defina ui.mode como 'app' quando integrar a plataforma numa WebView móvel nativa, para ajustar determinados comportamentos de UI.

Navegação para trás

showBackNavigation é um booleano opcional de nível superior que controla a visibilidade dos botões de navegação para trás da plataforma. O valor predefinido é true.

Defina-o como false quando a aplicação anfitriã fornecer a sua própria navegação para trás e para a frente:

MindtrainingPlatform.init('mindtraining', {
  showBackNavigation: false,
})

Esta opção oculta os botões de voltar no jogo, na subpágina inicial, no arquivo, nas estatísticas e nos painéis de jogo apresentados como páginas. Não desativa o histórico do navegador nem altera os eventos de navegação, as regras de acesso ou os controlos para fechar caixas de diálogo e painéis laterais.

A aplicação anfitriã deve disponibilizar uma forma de voltar a partir destes ecrãs. Para mostrar novamente os botões sem voltar a montar a plataforma:

MindtrainingPlatform.updateConfig({ showBackNavigation: true })

As chamadas a updateConfig() que alteram outras opções preservam o valor atual. setConfig() substitui a configuração; por isso, omitir esta opção repõe o seu valor em true.

Esquema de cores

ui.colorScheme seleciona a paleta de cores nos sites em que esta funcionalidade está ativada. Os sites compatíveis incluem Entrenamentes e Le Monde.

• 'light' (predefinição): força a paleta clara.
• 'dark': força a paleta escura.
• 'system': segue a preferência do dispositivo através de prefers-color-scheme e reage às alterações enquanto a plataforma está montada.

Configure a preferência inicial ao montar a plataforma:

MindtrainingPlatform.init('mindtraining', {
  ui: { colorScheme: 'system' },
})

A aplicação anfitriã pode alterá-la durante a execução sem voltar a montar a plataforma:

MindtrainingPlatform.updateConfig({ ui: { colorScheme: 'dark' } })
MindtrainingPlatform.updateConfig({ ui: { colorScheme: 'light' } })
MindtrainingPlatform.updateConfig({ ui: { colorScheme: 'system' } })

A plataforma não adiciona botões nem seletores de tema; a aplicação anfitriã controla a preferência e qualquer interface utilizada para a alterar. Esta propriedade é independente de ui.mode ('web' / 'app'). Os sites sem suporte para esquemas de cores mantêm a apresentação atual.

As chamadas a updateConfig() que modificam outras opções preservam a preferência selecionada. setConfig() substitui a configuração, pelo que omitir ui.colorScheme repõe 'light'.

As paletas clara e escura são editadas separadamente no painel de administração. As configurações existentes começam com as mesmas cores nos dois modos: selecionar o modo escuro não escurece automaticamente a paleta; personalize as suas cores no painel de administração.

Visibilidade do ecrã de jogo

Estes booleanos opcionais de nível superior têm o valor predefinido true nos layouts de jogo compatíveis.

showMobileGameHeader: false oculta a barra móvel de título e data abaixo dos controlos. O título no computador e os controlos permanecem visíveis.

showOtherGames: false oculta a secção de outros jogos abaixo do tabuleiro em qualquer largura do contentor, incluindo o espaço reservado. Os diretórios noutros ecrãs e as recomendações de fim de partida não são afetados.

As duas opções são independentes de ui.mode e das permissões de acesso. Os layouts sem suporte mantêm a apresentação atual.

MindtrainingPlatform.init('mindtraining', {
  showMobileGameHeader: false,
  showOtherGames: false,
})

Use updateConfig() para alterar cada opção sem voltar a montar a plataforma. As atualizações não relacionadas preservam os dois valores. setConfig() substitui a configuração; as opções omitidas voltam a true.

MindtrainingPlatform.updateConfig({
  showMobileGameHeader: true,
  showOtherGames: true,
})

Os sites filhos herdam estas opções do layout de jogo do site pai, salvo quando substituem explicitamente esse comportamento.

Interceção de navegação

Todos os sites herdam o callback opcional ui.actions.navigate, que recebe um pedido serializável antes da navegação do SDK, nos modos web e app. Interceção de navegação.