Azioni UI

Usa ui.actions per collegare i pulsanti di call-to-action della piattaforma (login, abbonamento, condivisione...) ai modali o ai flussi del tuo sito.

---

MindtrainingPlatform.init('mindtraining', {
  ui: {
    mode: 'web', // 'web' (predefinito) | 'app'
    actions: {
      openLogin: function () {
        // apri il tuo modale di login
      },
      openRegister: function () {
        // apri il tuo modale di registrazione
      },
      openSubscribe: function () {
        // apri la tua pagina o il tuo modale di abbonamento
      },
      openUrl: function (url) {
        window.open(url, '_blank')
      },
      share: function (payload) {
        // payload: { url?: string, title?: string }
        navigator.share({ url: payload.url, title: payload.title })
      },
    },
  },
})

Imposta ui.mode su 'app' quando incorpori la piattaforma dentro una WebView mobile nativa, così da adattare alcuni comportamenti dell'interfaccia.

Navigazione indietro

showBackNavigation è un valore booleano facoltativo di primo livello che controlla la visibilità dei pulsanti di navigazione indietro della piattaforma. Il valore predefinito è true.

Impostalo su false quando l’applicazione ospitante fornisce la propria navigazione indietro e avanti:

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

Questa opzione nasconde i pulsanti per tornare indietro nel gioco, nella sotto-home, nell’archivio, nelle statistiche e nei pannelli di gioco visualizzati come pagine. Non disabilita la cronologia del browser e non modifica gli eventi di navigazione, le regole di accesso o i controlli per chiudere le finestre di dialogo e i pannelli laterali.

L’applicazione ospitante deve offrire un modo per tornare indietro da queste schermate. Per mostrare nuovamente i pulsanti senza rimontare la piattaforma:

MindtrainingPlatform.updateConfig({ showBackNavigation: true })

Le chiamate a updateConfig() che modificano altre opzioni mantengono il valore attuale. setConfig() sostituisce la configurazione: omettendo questa opzione, il suo valore torna a true.

Schema di colori

ui.colorScheme seleziona la palette di colori nei siti in cui questa funzionalità è abilitata. I siti supportati includono Entrenamentes e Le Monde.

• 'light' (valore predefinito): imposta la palette chiara.
• 'dark': imposta la palette scura.
• 'system': segue la preferenza del dispositivo tramite prefers-color-scheme e risponde ai suoi cambiamenti mentre la piattaforma è montata.

Imposta la preferenza iniziale quando monti la piattaforma:

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

L’applicazione ospitante può modificarla durante l’esecuzione senza rimontare la piattaforma:

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

La piattaforma non aggiunge pulsanti o selettori del tema; l’applicazione ospitante controlla la preferenza e l’eventuale interfaccia per modificarla. Questa proprietà è indipendente da ui.mode ('web' / 'app'). I siti senza supporto per gli schemi di colori mantengono la presentazione attuale.

Le chiamate a updateConfig() che modificano altre opzioni mantengono la preferenza selezionata. setConfig() sostituisce la configurazione, quindi omettere ui.colorScheme ripristina 'light'.

Le palette chiara e scura si modificano separatamente nel pannello di amministrazione. Le configurazioni esistenti partono dagli stessi colori per entrambe le modalità: selezionare la modalità scura non scurisce automaticamente la palette; personalizzane i colori nel pannello di amministrazione.

Visibilità della schermata di gioco

Questi booleani facoltativi di primo livello hanno valore predefinito true nei layout di gioco compatibili.

showMobileGameHeader: false nasconde la barra mobile con titolo e data sotto i controlli. Il titolo desktop e i controlli restano visibili.

showOtherGames: false nasconde la sezione degli altri giochi sotto la griglia a qualsiasi larghezza del contenitore, compreso lo spazio riservato. Gli elenchi nelle altre schermate e i suggerimenti di fine partita non cambiano.

Entrambe le opzioni sono indipendenti da ui.mode e dai permessi di accesso. I layout non compatibili mantengono la presentazione attuale.

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

Usa updateConfig() per cambiare ogni opzione senza rimontare la piattaforma. Gli aggiornamenti non correlati conservano entrambi i valori. setConfig() sostituisce la configurazione; le opzioni omesse tornano a true.

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

I siti figli ereditano queste opzioni dal layout di gioco del sito padre, salvo una modifica esplicita di questo comportamento.

Intercettazione della navigazione

Tutti i siti ereditano il callback facoltativo ui.actions.navigate, che riceve una richiesta serializzabile prima della navigazione SDK, nelle modalità web e app. Intercettazione della navigazione.