# Evidence Explorer — intégrer l'outil sur votre site / embedding the tool on your site

[Français](#français) · [English](#english)

---

## Français

L'Evidence Explorer présente, pour chaque indication et tranche d'âge, le niveau de preuve publié par l'AAPB (Evidence-Based Practice in Biofeedback and Neurofeedback, 4e éd., 2023) à côté de l'évaluation datée de NeuroLogic sur la même échelle. Vous pouvez l'afficher sur votre propre site en quelques lignes. Les données sont mises à jour chaque semaine par NeuroLogic ; votre page se met à jour toute seule.

### 0. Le plus simple

**<https://evidence.neurologic.fr/integration>** (EN : <https://evidence.neurologic.academy/integration>) génère votre code d'intégration : vous remplissez votre nom, votre logo et vos liens, vous copiez, vous collez. Le reste de ce document est la référence détaillée.

### 1. Intégration recommandée : iframe avec le script d'aide

Collez ceci là où l'outil doit apparaître (bloc HTML personnalisé sous WordPress, Wix, Squarespace, Webflow, HTML statique…) :

```html
<div id="evidence-explorer"
     data-lang="fr"
     data-publisher-name="Cabinet Exemple"
     data-publisher-url="https://www.cabinet-exemple.fr"
     data-contact-email="contact@cabinet-exemple.fr"></div>
<script src="https://evidence.neurologic.fr/evidence-explorer-embed.js" async></script>
```

Le script crée l'iframe, ajuste sa hauteur au contenu (pas de barre de défilement interne), remonte la page en haut de l'outil quand le visiteur ouvre une indication, et reporte l'état de l'outil dans l'adresse de votre page (`?c=adhd&age=child`) pour que vos liens profonds fonctionnent.

Attributs disponibles (tous facultatifs) — cette table est générée à partir de `build/src/embed-options.mjs`, le contrat public :

<!-- OPTIONS:fr -->
| Attribut | Effet | Paramètre d'URL | Défaut |
|---|---|---|---|
| `data-lang` | Langue — `fr`, `en`, `de`, `it` ou `es`. Les versions allemande, italienne et espagnole sont traduites automatiquement depuis l'anglais et signalées comme telles dans l'outil. | `lang` | `fr` |
| `data-mode` | Lecture — `patient` (lecture simple) ou `pro` (lecture clinique). | `mode` | `patient` |
| `data-land-on` | Page d'ouverture — Identifiant d'indication (`adhd`, `anxiety`, `insomnia`…) ou vide pour l'accueil. | `landOn` | — |
| `data-age` | Tranche d'âge à l'ouverture — `child`, `teen` ou `adult`. | `age` | — |
| `data-mod` | Modalité à l'ouverture — `all`, `nf` (neurofeedback) ou `bf` (biofeedback). | `mod` | — |
| `data-publisher-name` | Votre nom — Affiché sous « Présenté par », en plus de NeuroLogic — jamais à sa place. | `pub` | — |
| `data-publisher-url` | Adresse de votre site — Destination de votre nom et de votre logo ; `data-publisher-url-en` pour la version anglaise. | `pubUrl` | — |
| `data-publisher-url-en` | Adresse du site (version anglaise) — Facultatif : sans elle, l'adresse française sert dans les deux langues. | `pubUrlEn` | — |
| `data-contact-email` | Adresse de contact — Affichée si l'envoi d'une demande d'analyse échoue (les demandes sont traitées par NeuroLogic, qui produit les analyses). | `contact` | — |
| `data-publisher-logo` | Votre logo — version foncée — URL https d'un PNG ou SVG. Affiché à côté du logo NeuroLogic, jamais à sa place. | `logo` | — |
| `data-publisher-logo-light` | Votre logo — version claire (sur fond marine) — URL https d'un PNG ou SVG. C'est celle-ci qui s'affiche dans l'en-tête. | `logoLight` | — |
| `data-min-height` | Hauteur avant le premier calcul — Ex. `900px`. La hauteur s'ajuste ensuite au contenu. | — | `900px` |
| `data-title` | Titre de l'iframe — Lu par les lecteurs d'écran. Défaut : « Evidence Explorer ». | — | — |
| `data-url-state` | État dans l'adresse de votre page — `false` : ne pas modifier l'adresse de votre page (vos liens profonds cessent de fonctionner). | — | `true` |
| `data-set-title` | Titre de la page suit l'indication — `true` : le titre de votre page change avec l'indication ouverte. | — | `false` |
| `data-src` | Origine de l'outil — Par défaut, l'origine du script d'aide. | — | — |
<!-- /OPTIONS -->

Si votre éditeur supprime les balises `<script>` des blocs de contenu (Wix, Squarespace, certains réglages WordPress), séparez les deux : l'iframe dans la page, le script **une seule fois** dans le pied de page du site (champ « code personnalisé » / « scripts d'en-tête et de pied de page »). Le script trouve l'iframe et prend en charge sa hauteur, sans rien d'autre à changer :

```html
<!-- dans la page -->
<iframe src="https://evidence.neurologic.fr/?lang=fr&pub=Cabinet%20Exemple"
        title="Evidence Explorer" style="width:100%;min-height:900px;border:0"></iframe>

<!-- une seule fois, dans le pied de page du site -->
<script src="https://evidence.neurologic.fr/evidence-explorer-embed.js" async></script>
```

Ajoutez `data-url-state="true"` sur l'iframe si vous voulez aussi l'état dans l'adresse de votre page (désactivé par défaut dans ce mode).

Sans le script nulle part, l'iframe seule fonctionne quand même : l'outil défile à l'intérieur du cadre — rien n'est coupé — mais la hauteur reste celle que vous avez fixée (hauteur fixe, pas de lien profond) :

```html
<iframe src="https://evidence.neurologic.fr/index.html?lang=fr&pub=Cabinet%20Exemple"
        title="Evidence Explorer" style="width:100%;height:1400px;border:0"></iframe>
```
Paramètres d'URL : `lang`, `mode`, `c`, `age`, `mod`, `landOn`, `pub`, `pubUrl`, `pubUrlEn`, `contact`, `logo`, `logoLight` (valeurs encodées).

### 2. Alternative : héberger le bundle vous-même

Téléchargez `evidence-explorer-dist.zip`, déposez le dossier tel quel sur votre serveur (par exemple `/evidence-explorer/`) en gardant l'arborescence (`evidence-explorer.js`, `data/`, `assets/`), puis :

```html
<div id="evidence-explorer" data-default-lang="fr" data-publisher-name="Cabinet Exemple"
     data-src="https://evidence.neurologic.fr/data/evidence.v2.json"></div>
<script src="/evidence-explorer/evidence-explorer.js" defer></script>
```

`data-src` pointant vers les données NeuroLogic, vous recevez les mises à jour hebdomadaires sans rien faire ; sans `data-src`, l'outil lit votre copie locale `data/evidence.v2.json` (figée à la date du téléchargement). Le bundle ne charge rien d'autre que la police Montserrat (Google Fonts, désactivable avec `data-fonts="none"`). Hébergement direct = vos feuilles de style s'appliquent aussi au contenu de l'outil ; l'iframe (§1) l'en protège.

### 3. Conditions

- Les niveaux AAPB, l'évaluation NeuroLogic, les textes, les références et la lecture recommandée (Parsons, 2026) font partie des données et s'affichent intégralement ; ils ne doivent être ni modifiés ni tronqués. L'attribution AAPB et la mention de l'éditeur restent visibles.
- Votre nom et votre logo s'ajoutent à ceux de NeuroLogic, sous « Présenté par » (en-tête et pied de page) — ils ne les remplacent pas. Le nom NeuroLogic, son logo et le libellé « Note NeuroLogic » restent affichés : les évaluations sont les nôtres et restent attribuées à NeuroLogic.
- Le bouton « Voir la carte du réseau » pointe toujours vers la carte du réseau NeuroLogic ; il n'est pas paramétrable.
- L'outil est un outil d'information scientifique : ni avis médical, ni diagnostic, ni recommandation de traitement.
- Questions, demande d'une autre indication, signalement d'erreur : contact@neurologic.fr.

---

## English

The Evidence Explorer shows, for each indication and age group, the evidence level published by AAPB (Evidence-Based Practice in Biofeedback and Neurofeedback, 4th ed., 2023) next to NeuroLogic's dated assessment on the same scale. You can display it on your own website with a few lines. NeuroLogic updates the data weekly; your page updates itself.

### 0. The short way

**<https://evidence.neurologic.academy/integration>** (FR: <https://evidence.neurologic.fr/integration>) generates your embed code: fill in your name, logo and links, copy, paste. The rest of this document is the detailed reference.

### 1. Recommended: iframe with the helper script

Paste this where the tool should appear (Custom HTML block in WordPress, Wix, Squarespace, Webflow, static HTML…):

```html
<div id="evidence-explorer"
     data-lang="en"
     data-publisher-name="Example Clinic"
     data-publisher-url="https://www.example-clinic.com"
     data-contact-email="hello@example-clinic.com"></div>
<script src="https://evidence.neurologic.fr/evidence-explorer-embed.js" async></script>
```

The script creates the iframe, keeps it exactly as tall as the content (no inner scrollbar), scrolls to the top of the tool when a visitor opens an indication, and mirrors the tool's state into your page URL (`?c=adhd&age=child`) so your deep links work.

Attributes (all optional) — this table is generated from `build/src/embed-options.mjs`, the public contract:

<!-- OPTIONS:en -->
| Attribute | Effect | URL parameter | Default |
|---|---|---|---|
| `data-lang` | Language — `fr`, `en`, `de`, `it` or `es`. The German, Italian and Spanish versions are machine-translated from the English and are labelled as such inside the tool. | `lang` | `fr` |
| `data-mode` | Reading — `patient` (plain language) or `pro` (clinical reading). | `mode` | `patient` |
| `data-land-on` | Opens on — Indication id (`adhd`, `anxiety`, `insomnia`…) or empty for the home screen. | `landOn` | — |
| `data-age` | Age band on open — `child`, `teen` or `adult`. | `age` | — |
| `data-mod` | Modality on open — `all`, `nf` (neurofeedback) or `bf` (biofeedback). | `mod` | — |
| `data-publisher-name` | Your name — Shown under "Presented by", in addition to NeuroLogic — never in its place. | `pub` | — |
| `data-publisher-url` | Your site address — Where your name and logo link to; `data-publisher-url-en` for the English version. | `pubUrl` | — |
| `data-publisher-url-en` | Site address (English version) — Optional: without it the French address is used in both languages. | `pubUrlEn` | — |
| `data-contact-email` | Contact address — Shown if sending a review request fails (requests are handled by NeuroLogic, which produces the reviews). | `contact` | — |
| `data-publisher-logo` | Your logo — dark version — https URL of a PNG or SVG. Shown next to the NeuroLogic logo, never in its place. | `logo` | — |
| `data-publisher-logo-light` | Your logo — light version (on navy) — https URL of a PNG or SVG. This is the one shown in the header. | `logoLight` | — |
| `data-min-height` | Height before the first measurement — E.g. `900px`. The height then follows the content. | — | `900px` |
| `data-title` | iframe title — Read by screen readers. Default: "Evidence Explorer". | — | — |
| `data-url-state` | State in your page's address — `false`: leave your page URL untouched (your deep links stop working). | — | `true` |
| `data-set-title` | Page title follows the indication — `true`: your page title changes with the open indication. | — | `false` |
| `data-src` | Tool origin — Defaults to the helper script's own origin. | — | — |
<!-- /OPTIONS -->

If your editor strips `<script>` tags from content blocks (Wix, Squarespace, some WordPress settings), split the two: the iframe goes in the page, the script goes **once** in the site footer (a "custom code" / "header and footer scripts" field). The script finds the iframe and takes over its height, with nothing else to change:

```html
<!-- in the page -->
<iframe src="https://evidence.neurologic.academy/?lang=en&pub=Example%20Clinic"
        title="Evidence Explorer" style="width:100%;min-height:900px;border:0"></iframe>

<!-- once, in the site footer -->
<script src="https://evidence.neurologic.academy/evidence-explorer-embed.js" async></script>
```

Add `data-url-state="true"` on the iframe if you also want the state in your page's address (off by default in this mode).

With no script anywhere a plain iframe still works on its own: the tool scrolls inside the frame — nothing is cut off — but the height stays the one you set (fixed height, no deep links):

```html
<iframe src="https://evidence.neurologic.fr/index.html?lang=en&pub=Example%20Clinic"
        title="Evidence Explorer" style="width:100%;height:1400px;border:0"></iframe>
```
URL parameters: `lang`, `mode`, `c`, `age`, `mod`, `landOn`, `pub`, `pubUrl`, `pubUrlEn`, `contact`, `logo`, `logoLight` (URL-encoded values).

### 2. Alternative: host the bundle yourself

Download `evidence-explorer-dist.zip`, upload the folder as is (for instance to `/evidence-explorer/`) keeping its structure (`evidence-explorer.js`, `data/`, `assets/`), then:

```html
<div id="evidence-explorer" data-default-lang="en" data-publisher-name="Example Clinic"
     data-src="https://evidence.neurologic.fr/data/evidence.v2.json"></div>
<script src="/evidence-explorer/evidence-explorer.js" defer></script>
```

With `data-src` pointing at NeuroLogic's data you receive the weekly updates automatically; without it the tool reads your local copy `data/evidence.v2.json` (frozen at download time). The bundle loads nothing else but the Montserrat font (Google Fonts; `data-fonts="none"` disables it). Direct hosting means your site's stylesheets also apply to the tool; the iframe (§1) shields it from that.

### 3. Terms

- The AAPB levels, the NeuroLogic assessment, texts, references and the recommended reading (Parsons, 2026) are part of the data and are displayed in full; they must not be modified or truncated. The AAPB attribution and the publisher note stay visible.
- Your name and logo are added to NeuroLogic's, under "Presented by" (header and footer) — they do not replace them. The NeuroLogic name, logo and the "NeuroLogic rating" label stay visible: the assessments are ours and stay attributed to NeuroLogic.
- The "Open the network map" button always points at the NeuroLogic network map; it is not configurable.
- The tool is a scientific information tool: not medical advice, not a diagnosis, not a treatment recommendation.
- Questions, requests for another indication, error reports: contact@neurologic.fr.