ajoute section Installation et navigateurs (Firefox vs Chromium : install, mises à jour, stockage)
+74
-2
@@ -4,6 +4,7 @@ Ce guide couvre toutes les fonctionnalités de l'extension **Planification** au
|
|||||||
|
|
||||||
## Sommaire
|
## Sommaire
|
||||||
|
|
||||||
|
- [Installation et navigateurs](#installation-et-navigateurs)
|
||||||
- [Premier lancement](#premier-lancement)
|
- [Premier lancement](#premier-lancement)
|
||||||
- [La topbar (vue classique)](#la-topbar-vue-classique)
|
- [La topbar (vue classique)](#la-topbar-vue-classique)
|
||||||
- [Les cartes des techniciens](#les-cartes-des-techniciens)
|
- [Les cartes des techniciens](#les-cartes-des-techniciens)
|
||||||
@@ -17,9 +18,80 @@ Ce guide couvre toutes les fonctionnalités de l'extension **Planification** au
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
## Installation et navigateurs
|
||||||
|
|
||||||
|
L'extension fonctionne sur **Firefox** et sur les navigateurs **Chromium** (Chrome, Edge, Brave). Le code et les fonctionnalités sont identiques, mais l'installation, le stockage et les mises à jour diffèrent légèrement entre les deux familles.
|
||||||
|
|
||||||
|
### Firefox 🦊
|
||||||
|
|
||||||
|
**Installation** :
|
||||||
|
1. Télécharger le `.xpi` **signé Mozilla** depuis la [release courante](https://gitea.netaplaid.ch/FroSteel/Planification/releases) (fichier `planification-vX.Y.Z-firefox.xpi`).
|
||||||
|
2. Drag-and-drop le fichier dans `about:addons` de Firefox.
|
||||||
|
3. Cliquer "Ajouter" — Firefox vérifie la signature Mozilla, l'installe.
|
||||||
|
|
||||||
|
**Mises à jour** : **automatiques**. Firefox vérifie toutes les ~24 h le manifest d'update (`firefox-updates.json` à la racine du repo Gitea), détecte les nouvelles versions, télécharge le `.xpi` signé correspondant, vérifie son sha256 et l'installe silencieusement. Aucune action requise du technicien.
|
||||||
|
|
||||||
|
**Désinstallation** : `about:addons` → cliquer sur "Planification" → "Supprimer".
|
||||||
|
|
||||||
|
**Stockage local** :
|
||||||
|
- **Mac** : `~/Library/Application Support/Firefox/Profiles/<profile>/storage/default/moz-extension+++<extension-uuid>/`
|
||||||
|
- **Windows** : `%APPDATA%\Mozilla\Firefox\Profiles\<profile>\storage\default\moz-extension+++<extension-uuid>\`
|
||||||
|
- **Linux** : `~/.mozilla/firefox/<profile>/storage/default/moz-extension+++<extension-uuid>/`
|
||||||
|
|
||||||
|
Le contenu (cache des plannings + `admin_config`) **survit aux mises à jour de l'extension**. Pour réinitialiser : Paramètres → Diagnostics → "Réinitialiser la configuration" (méthode propre), ou supprimer manuellement le dossier ci-dessus.
|
||||||
|
|
||||||
|
### Chromium 🌐 (Chrome, Edge, Brave)
|
||||||
|
|
||||||
|
**Installation** (mode développeur) :
|
||||||
|
1. Télécharger le `.zip` depuis la [release courante](https://gitea.netaplaid.ch/FroSteel/Planification/releases) (fichier `planification-vX.Y.Z-chromium.zip`).
|
||||||
|
2. Décompresser dans un dossier permanent (ex: `~/Documents/Planification-extension/`).
|
||||||
|
3. Ouvrir `chrome://extensions/` (ou `edge://extensions/`).
|
||||||
|
4. Activer **"Mode développeur"** (toggle en haut à droite).
|
||||||
|
5. Cliquer **"Charger l'extension non empaquetée"** → sélectionner le dossier décompressé.
|
||||||
|
|
||||||
|
**Mises à jour** : **manuelles**. Chrome ne fait pas d'auto-update pour les extensions chargées en "non empaquetées". Quand une nouvelle version sort :
|
||||||
|
1. Re-télécharger le nouveau `.zip` depuis la release Gitea.
|
||||||
|
2. Remplacer le contenu du dossier d'installation.
|
||||||
|
3. Dans `chrome://extensions/` → cliquer le bouton "Recharger" ⟳ sur la carte Planification.
|
||||||
|
|
||||||
|
**Désinstallation** : `chrome://extensions/` → bouton "Supprimer" sur la carte Planification.
|
||||||
|
|
||||||
|
**Stockage local** :
|
||||||
|
- **Mac** : `~/Library/Application Support/Google/Chrome/Default/Extensions/<extension-id>/` (code) + `~/Library/Application Support/Google/Chrome/Default/Local Extension Settings/<extension-id>/` (données `chrome.storage.local`)
|
||||||
|
- **Windows** : `%LOCALAPPDATA%\Google\Chrome\User Data\Default\Extensions\<extension-id>\`
|
||||||
|
- **Linux** : `~/.config/google-chrome/Default/Extensions/<extension-id>/`
|
||||||
|
|
||||||
|
(Pour Edge, remplacer `Google/Chrome` par `Microsoft/Edge`. Pour Brave, par `BraveSoftware/Brave-Browser`.)
|
||||||
|
|
||||||
|
Le contenu (cache + `admin_config`) **survit aux rechargements** de l'extension par "Recharger ⟳", mais peut être perdu si tu **supprimes puis re-installes** l'extension (l'ID change).
|
||||||
|
|
||||||
|
### Tableau comparatif
|
||||||
|
|
||||||
|
| | **Firefox** | **Chromium** |
|
||||||
|
|---|---|---|
|
||||||
|
| Format de distribution | `.xpi` signé Mozilla | `.zip` non packagé |
|
||||||
|
| Mode d'installation | Drag-and-drop dans `about:addons` | Mode développeur + dossier décompressé |
|
||||||
|
| Signature requise | ✅ Mozilla (auto par Quentin pour chaque version) | ❌ Aucune |
|
||||||
|
| **Auto-update** | ✅ Natif (24h max) | ❌ Manuel (recharger ⟳) |
|
||||||
|
| Survit aux updates | ✅ | ✅ |
|
||||||
|
| Persistance du `admin_config` | ✅ | ✅ tant que l'extension n'est pas désinstallée |
|
||||||
|
| Compteur session EV | ✅ | ✅ |
|
||||||
|
| Auto-fetch périodique du planning | ✅ | ✅ |
|
||||||
|
|
||||||
|
### Choix recommandé pour les techniciens DGNSI
|
||||||
|
|
||||||
|
**Firefox est recommandé** pour la majorité des techniciens, car :
|
||||||
|
- L'auto-update évite de devoir re-télécharger à chaque correction
|
||||||
|
- Pas besoin d'activer le mode développeur (qui peut être bloqué par GPO)
|
||||||
|
- Installation 1-clic via `about:addons`
|
||||||
|
|
||||||
|
**Chromium reste utilisable** pour les techs qui préfèrent rester sur Chrome/Edge ou ceux dont le profil Firefox n'est pas configuré pour le SSO Canton. Mais ils devront être notifiés manuellement à chaque nouvelle version.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## Premier lancement
|
## Premier lancement
|
||||||
|
|
||||||
À l'ouverture de l'extension, la fenêtre Planification affiche le **planning du jour** des 8 techniciens DGNSI configurés. Si une session EasyVista est ouverte dans un autre onglet, les données arrivent en quelques secondes.
|
À l'ouverture de l'extension, la fenêtre Planification affiche le **planning du jour** des techniciens DGNSI cochés dans Paramètres → Équipe (vide au 1er install — voir [Premier lancement (v2026.5.41+)](#premier-lancement-v202654-1)). Si une session EasyVista est ouverte dans un autre onglet, les données arrivent en quelques secondes.
|
||||||
|
|
||||||
Si aucune session n'est détectée :
|
Si aucune session n'est détectée :
|
||||||
- Un message **"Session EasyVista expirée"** apparaît
|
- Un message **"Session EasyVista expirée"** apparaît
|
||||||
@@ -253,7 +325,7 @@ Procédure :
|
|||||||
2. Clique sur la pastille des initiales en haut à gauche de l'extension → **⚙ Paramètres → Équipe**.
|
2. Clique sur la pastille des initiales en haut à gauche de l'extension → **⚙ Paramètres → Équipe**.
|
||||||
3. Le sélecteur "Groupe EasyVista" se peuple automatiquement (SI-CSS / SI-EXT / …). Choisis le tien.
|
3. Le sélecteur "Groupe EasyVista" se peuple automatiquement (SI-CSS / SI-EXT / …). Choisis le tien.
|
||||||
4. Le tableau des techniciens du groupe se peuple automatiquement aussi. Coche ceux qui doivent apparaître dans la planification.
|
4. Le tableau des techniciens du groupe se peuple automatiquement aussi. Coche ceux qui doivent apparaître dans la planification.
|
||||||
5. (Optionnel) Si l'un d'eux est absent récurrent un jour de la semaine (ex: Pillonel Olivier le vendredi), coche le jour dans la colonne "Absences récurrentes".
|
5. (Optionnel) Si l'un d'eux est absent récurrent un jour de la semaine (ex: tous les vendredis), coche le jour dans la colonne "Absences récurrentes".
|
||||||
6. Clique **💾 Enregistrer**. Le planning se met à jour immédiatement.
|
6. Clique **💾 Enregistrer**. Le planning se met à jour immédiatement.
|
||||||
|
|
||||||
Tes choix sont **persistés dans `chrome.storage.local`** et survivent aux mises à jour d'extension — pas besoin de reconfigurer à chaque nouvelle version.
|
Tes choix sont **persistés dans `chrome.storage.local`** et survivent aux mises à jour d'extension — pas besoin de reconfigurer à chaque nouvelle version.
|
||||||
|
|||||||
Reference in New Issue
Block a user