Actions d'interface

Utilisez ui.actions pour connecter les boutons d'appel à l'action de la plateforme (connexion, abonnement, partage...) aux modales ou parcours de votre propre site.

---

MindtrainingPlatform.init('mindtraining', {
  ui: {
    mode: 'web', // 'web' (par défaut) | 'app'
    actions: {
      openLogin: function () {
        // ouvrir votre modale de connexion
      },
      openRegister: function () {
        // ouvrir votre modale d'inscription
      },
      openSubscribe: function () {
        // ouvrir votre page ou modale d'abonnement
      },
      openUrl: function (url) {
        window.open(url, '_blank')
      },
      share: function (payload) {
        // payload : { url?: string, title?: string }
        navigator.share({ url: payload.url, title: payload.title })
      },
    },
  },
})

Définissez ui.mode sur 'app' lorsque vous intégrez la plateforme dans une WebView mobile native afin d'ajuster certains comportements d'interface.

Navigation de retour

showBackNavigation est un booléen facultatif de premier niveau qui contrôle la visibilité des boutons de retour de la plateforme. Sa valeur par défaut est true.

Définissez-le sur false lorsque l’application hôte fournit sa propre navigation vers les pages précédentes et suivantes :

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

Cette option masque les boutons de retour du jeu, de la sous-page d’accueil, des archives, des statistiques et des panneaux de jeu présentés sous forme de pages. Elle ne désactive pas l’historique du navigateur et ne modifie ni les événements de navigation, ni les règles d’accès, ni les commandes de fermeture des boîtes de dialogue et des panneaux latéraux.

L’application hôte doit permettre de revenir depuis ces écrans. Pour afficher à nouveau les boutons sans remonter la plateforme :

MindtrainingPlatform.updateConfig({ showBackNavigation: true })

Les appels à updateConfig() qui modifient d’autres options conservent la valeur actuelle. setConfig() remplace la configuration : si cette option est omise, sa valeur revient à true.

Thème de couleur

ui.colorScheme sélectionne la palette de couleurs sur les sites où cette fonctionnalité est activée. Les sites compatibles incluent Entrenamentes et Le Monde.

• 'light' (valeur par défaut) : impose la palette claire.
• 'dark' : impose la palette sombre.
• 'system' : suit la préférence de l’appareil via prefers-color-scheme et réagit à ses changements tant que la plateforme est montée.

Définissez la préférence initiale lors du montage de la plateforme :

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

L’application hôte peut la modifier pendant l’exécution sans remonter la plateforme :

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

La plateforme n’ajoute aucun bouton ni sélecteur de thème ; l’application hôte contrôle la préférence et l’interface permettant de la modifier. Cette propriété est indépendante de ui.mode ('web' / 'app'). Les sites ne prenant pas en charge les thèmes de couleur conservent leur présentation actuelle.

Les appels à updateConfig() qui modifient d’autres options conservent la préférence sélectionnée. setConfig() remplace la configuration ; omettre ui.colorScheme rétablit donc 'light'.

Les palettes claire et sombre se modifient séparément dans l’administration. Les configurations existantes utilisent initialement les mêmes couleurs pour les deux modes : sélectionner le mode sombre n’assombrit pas automatiquement la palette ; personnalisez ses couleurs dans l’administration.

Visibilité de l’écran de jeu

Ces booléens facultatifs de premier niveau valent true par défaut dans les dispositions de jeu compatibles.

showMobileGameHeader: false masque la barre mobile du titre et de la date sous les commandes. Le titre sur ordinateur et les commandes restent visibles.

showOtherGames: false masque la section des autres jeux sous la grille, quelle que soit la largeur du conteneur, ainsi que son espace réservé. Les répertoires des autres écrans et les recommandations de fin de partie ne sont pas affectés.

Les deux options sont indépendantes de ui.mode et des droits d’accès. Les dispositions non compatibles conservent leur présentation actuelle.

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

Utilisez updateConfig() pour changer chaque option sans remonter la plateforme. Les mises à jour sans rapport conservent les deux valeurs. setConfig() remplace la configuration ; les options omises reviennent à true.

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

Les sites enfants héritent de ces options depuis la disposition de jeu du site parent, sauf s’ils remplacent explicitement ce comportement.

Interception de navigation

Tous les sites héritent du callback facultatif ui.actions.navigate. Il reçoit une requête sérialisable avant la navigation du SDK, en mode web ou app. Interception de navigation.