> For the complete documentation index, see [llms.txt](https://nanoxi.gitbook.io/starterkitv4/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nanoxi.gitbook.io/starterkitv4/depannage.md).

# Dépannage / FAQ

Cette page rassemble les problèmes les plus fréquents que rencontrent les utilisateurs du back-office, avec des solutions concrètes. Si votre question n'y figure pas, contactez le support via [le formulaire dédié](https://nanoxi.zendesk.com/hc/fr/requests/new).

## Connexion

### J'ai oublié mon mot de passe

Sur l'écran de connexion, cliquez sur « Mot de passe oublié ». Vous recevrez un e-mail avec un lien de réinitialisation valable un temps limité. Si vous ne recevez rien, vérifiez vos courriers indésirables et l'adresse e-mail liée à votre compte. En dernier recours, contactez un administrateur du site, qui peut réinitialiser le mot de passe depuis l'interface des utilisateurs.

### J'ai perdu accès à mon application d'authentification

C'est le cas typique d'un changement de téléphone sans transfert préalable de l'application TOTP. Comme aucun code de secours n'est généré lors de l'activation, vous ne pourrez plus vous connecter par vous-même.

Contactez un administrateur du site. Il pourra désactiver la double authentification sur votre compte, ce qui vous permettra de vous reconnecter avec votre seul mot de passe. Vous devrez ensuite la réactiver avec votre nouvel appareil. Plus de détails sur la page [Double authentification](/starterkitv4/bienvenue/mon-profil/double-authentification.md).

### La page de connexion ne charge pas

Vérifiez que vous accédez bien à l'URL correcte. Le back-office est généralement accessible à l'adresse `https://votresite.ch/umbraco`. Si l'URL est correcte mais que la page ne s'affiche pas, il s'agit probablement d'un problème côté serveur. Contactez le support.

## Modifications et publication

### Mes modifications n'apparaissent pas sur le site public

C'est le cas le plus fréquent. Plusieurs causes possibles :

* **Vous avez sauvegardé sans publier.** Le bouton « Sauver » enregistre vos modifications mais ne les rend pas visibles. Pour qu'elles apparaissent en ligne, utilisez « Sauver et publier ».
* **La page est encore dépubliée.** Une page créée n'est pas publiée par défaut. Vérifiez son état dans la liste des pages.
* **Le cache du navigateur affiche encore l'ancienne version.** Forcez le rechargement de la page avec `Ctrl+F5` (ou `Cmd+Shift+R` sur Mac).
* **Le cache du site lui-même n'a pas été vidé.** Sur des modifications de structure (menu, pied de page, paramètres globaux), il peut être nécessaire d'attendre quelques minutes ou de vider le cache côté serveur. Contactez votre administrateur en cas de doute.

### Une page que j'avais publiée n'est plus visible

Vérifiez d'abord son état dans le back-office. Si elle apparaît comme « dépubliée », c'est probablement une dépublication accidentelle ou une publication programmée arrivée à expiration. Republiez-la depuis la page concernée.

Si elle apparaît comme publiée mais reste invisible, vérifiez qu'elle n'est pas cachée du menu via l'option « Cacher la page » dans l'onglet Paramètres. Une page peut être publiée mais retirée de la navigation.

### Je ne retrouve pas une ancienne version de ma page

Toutes les versions ne sont pas conservées indéfiniment sur le StarterKit. La politique de rétention est la suivante :

* Toutes les versions des sept derniers jours sont conservées.
* Au-delà, une seule version par jour est gardée, pendant quatre-vingt-dix jours.
* Après quatre-vingt-dix jours, les versions anciennes sont supprimées automatiquement.

Si la version que vous cherchez date de moins de trois mois, ouvrez l'onglet « Info » de la page puis « Version antérieure ». Sinon, elle n'est probablement plus récupérable. Plus de détails sur la page [Gestion des modifications](/starterkitv4/structure/gestion-des-modifications.md).

### J'ai supprimé une page par erreur

Tant qu'elle est dans la corbeille, elle peut être restaurée. Développez la corbeille à la racine de l'arborescence, faites un clic droit sur l'élément et choisissez « Récupérer ». La page sera replacée à son emplacement d'origine en mode non publié. Voir la page [Récupération d'éléments supprimés](/starterkitv4/structure/recuperation-delements-supprimes.md).

Si vous avez vidé la corbeille, contactez votre administrateur, qui peut potentiellement restaurer depuis une sauvegarde si elle a été faite récemment.

## Contenu et widgets

### Mon image ne s'affiche pas

Trois causes habituelles :

* **Format non supporté.** Les widgets Image n'acceptent que WEBP, JPEG et PNG. Convertissez votre image dans l'un de ces formats.
* **Image trop lourde.** Au-delà de quelques mégaoctets, certaines images peuvent ne pas se charger correctement. Compressez-les avec un outil comme [Squoosh](https://squoosh.app) avant de les téléverser.
* **Image supprimée de la médiathèque.** Si vous avez supprimé l'image après l'avoir insérée, le lien est rompu. Téléversez à nouveau l'image et reliez-la au widget.

### Mon widget ne s'affiche pas correctement

Vérifiez que vous l'avez placé dans un emplacement autorisé. Certains widgets ne peuvent être ajoutés qu'à la racine d'une page (Hero, par exemple), d'autres uniquement à l'intérieur d'une colonne. Chaque page de widget précise les emplacements autorisés.

Si l'emplacement est correct, vérifiez que le widget contient bien tous les champs obligatoires. Un widget sauvegardé sans données peut s'afficher de manière incomplète sur la page publique.

### Le rendu sur mobile est différent de ce que je vois en édition

L'édition du back-office se fait sur un canevas large qui ne reflète pas exactement le rendu mobile. Utilisez systématiquement le bouton « Prévisualiser » en bas à droite avant de publier, et ouvrez la prévisualisation sur votre téléphone ou réduisez la fenêtre du navigateur pour voir le rendu adapté.

## Formulaires

### Je ne reçois pas les e-mails de notification des formulaires

Vérifiez d'abord que l'adresse e-mail configurée dans le workflow d'envoi est correcte, et regardez dans vos courriers indésirables. Si rien n'arrive, le problème est probablement côté serveur d'envoi. Contactez votre administrateur ou le support.

### Les entrées d'un formulaire ne sont pas conservées

Si vous avez décoché « Store records » dans les paramètres du formulaire, les entrées ne sont pas enregistrées en base de données et ne sont visibles qu'à travers les e-mails envoyés par les workflows. Voir la page [Création, paramétrage](/starterkitv4/formulaires/creation-parametrage.md).

Si vous avez configuré une période de rétention via « Data retention », les entrées sont automatiquement supprimées après cette durée pour respecter les règles de protection des données.

## Médias

### Une image que je viens d'ajouter à la médiathèque ne se trouve pas

La médiathèque est organisée en dossiers. Vérifiez que vous regardez dans le bon dossier. Vous pouvez aussi utiliser la recherche en haut de la médiathèque pour la retrouver par son nom.

### Je veux remplacer une image utilisée sur plusieurs pages

Plutôt que de téléverser une nouvelle image et de la relier manuellement partout, ouvrez l'image existante dans la médiathèque et utilisez la fonction de remplacement du fichier. Toutes les pages qui pointaient vers cette image afficheront la nouvelle version automatiquement.

## Autres questions

### Comment chercher rapidement dans le back-office

Utilisez le raccourci clavier `Ctrl+Espace` (ou `Cmd+Espace` sur Mac). Une barre de recherche apparaît et permet de retrouver n'importe quelle page, média ou utilisateur par son nom.

### Je vois une notification « Restart required »

Cela signifie qu'une modification de configuration nécessite un redémarrage du serveur pour être prise en compte. Si vous êtes administrateur, vous pouvez le faire depuis la section Settings. Sinon, contactez votre administrateur.

### Mon navigateur affiche « Non sécurisé » sur le site

Le certificat HTTPS de votre site est probablement expiré ou mal configuré. Contactez votre hébergeur ou votre développeur pour le renouveler. Évitez de naviguer sur le back-office tant que le problème n'est pas résolu.
