---
title: "Administration -- Avancé"
weight: 23
description: "Marqueurs personnalisés, champs extra, ordre des colonnes et outils de maintenance one-shot."
---

# Administration -- Avancé

Cet onglet (`admin/advanced.php`) regroupe les réglages techniques et les outils de maintenance. À utiliser avec précaution sur les actions destructives.

## Section " Marqueurs personnalisés "

Capmail propose 4 marqueurs synchronisés avec les keywords IMAP `$Label1` à `$Label4` (compatibles Thunderbird et la plupart des webmails). Chaque marqueur a un libellé configurable.

| Constante | Défaut suggéré |
|-----------|----------------|
| `CAPMAIL_CapmailUserFlag1` | Important |
| `CAPMAIL_CapmailUserFlag2` | À traiter |
| `CAPMAIL_CapmailUserFlag3` | En attente |
| `CAPMAIL_CapmailUserFlag4` | Pour info |

Les marqueurs 5 à 8 existent en interne mais sont locaux à Capmail (pas synchronisés IMAP).

## Section " Champs supplémentaires "

Permet d'afficher jusqu'à 8 champs additionnels du tiers dans la barre latérale de la prévisualisation. Pratique pour voir d'un coup d'œil le code client, le téléphone, ou n'importe quel champ extra du tiers.

Pour chaque slot 1 à 8 :

- **Champ** (`CAPMAIL_fk_extra1` à `_fk_extra8`) -- sélectionne quel champ tiers afficher (téléphone, code client, ou n'importe quel champ extra de la fiche tiers).
- **Libellé** (`CAPMAIL_fk_extra1_label` à `_fk_extra8_label`) -- texte affiché à gauche de la valeur.

Les champs sont affichés dans l'ordre 1 -> 8.

## Section " Ordre des colonnes (mode liste classique) "

Définit l'ordre des colonnes dans la vue liste classique (`postinmessage_list.php`). Pour chaque colonne visible, choisissez sa position (0 = première, 1 = deuxième, etc.).

Constantes : `CAPMAIL_COLD_ORDER_{nom_colonne}`.

Ne s'applique pas au Lead Mode, qui a son propre rendu fixe.

## Outils de maintenance

Tous les outils sont accessibles via des boutons en bas de page. Plusieurs proposent un mode **" Aperçu "** (dry-run) qui affiche ce qui serait fait sans rien modifier.

### Recalculer les dates

Reparcourt tous les fichiers EML stockés et reconstruit le champ `date_mail` à partir du header `Date:` du message. Utile après une migration ou si certaines dates sont incorrectes.

### Corriger les références PROV

Valide les `PostInMessage` bloqués avec une référence provisoire (`PROV...`) en leur assignant une vraie référence via le module de numérotation. Cas typique : import interrompu.

### Purger les emails orphelins

Supprime les emails Dolibarr qui n'existent plus côté serveur IMAP. Pour chaque email avec un `message_int`, le serveur IMAP est interrogé : si l'UID a disparu, l'email est supprimé localement.

**Attention** : action destructive. Sauvegarde recommandée avant exécution.

### Re-lier les tiers

Re-applique l'algorithme de rattachement automatique sur tous les emails sans tiers lié (`fk_soc IS NULL`). Utile après l'import en masse de nouveaux tiers ou contacts.

### Nettoyer les liens dossier orphelins

Supprime les entrées de la table de liaison `capmail_imap_folder_message` qui pointent vers des emails inexistants. Maintenance préventive, sans risque.

### Nettoyer les dossiers IMAP obsolètes

Compare la liste des dossiers connus de Capmail avec ceux réellement présents sur le serveur IMAP. Supprime les entrées locales qui ne correspondent plus à un dossier serveur (ex. dossier renommé directement via webmail). Les emails sont préservés.

### Réparer les dossiers au préfixe dupliqué

Certains serveurs, quand on leur demande de créer un dossier dont le chemin contient déjà le préfixe de la boîte, créent un dossier au préfixe **doublé** : `INBOX.INBOX.Sent` au lieu de `INBOX.Sent`. Ces dossiers sont invisibles dans la plupart des webmails et accumulent du courrier que personne ne lit.

Cet outil les détecte, déplace leurs messages vers le chemin correct, supprime le dossier vidé, puis corrige les références locales (suivi de synchronisation, liaisons dossier-email, et la configuration de la boîte mail elle-même).

**Le dossier n'est supprimé qu'une fois ses messages effectivement déplacés** : si un déplacement échoue, le dossier est conservé et l'erreur est signalée. Un bouton de simulation permet de voir ce qui serait fait avant d'agir.

### Re-archiver

Pour chaque email marqué `STATUS_ARCHIVE` localement mais qui n'a pas de liaison vers un dossier d'archive serveur, rejoue le déplacement IMAP. Utile pour rattraper les archivages échoués (panne IMAP temporaire).

### Purger les emails dupliqués

Détecte les doublons stricts (même `message_id` + même boîte + même direction in/out) et garde le plus complet (avec tiers/contact/projet liés). Mode dry-run disponible.

**Attention** : action destructive sur la table principale. Toujours faire un dry-run d'abord.

### Resynchroniser tous les dossiers

Réinitialise les compteurs `last_sync_uid` et relance un fetch complet `SINCE` la date choisie pour tous les dossiers visibles de toutes les boîtes actives. Long sur les grosses boîtes mais permet de rattraper des emails manqués.