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
|
||||
|
||||
- [Installation et navigateurs](#installation-et-navigateurs)
|
||||
- [Premier lancement](#premier-lancement)
|
||||
- [La topbar (vue classique)](#la-topbar-vue-classique)
|
||||
- [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
|
||||
|
||||
À 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 :
|
||||
- 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**.
|
||||
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.
|
||||
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.
|
||||
|
||||
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