# Guide d'utilisation - Internal Link Visualizer

## 📊 Vue d'ensemble du tableau de bord

Le tableau de bord **Internal Link Visualizer** se trouve dans **Outils > Link Visualizer** et permet de visualiser les liens internes et externes de votre site WordPress sous forme de graphe interactif.

---

## 🎛️ Sections du tableau de bord

### 1. **Statistics (Statistiques)**
Affiche en temps réel les métriques de votre site :
- **Total Links** : Nombre total de liens détectés
- **Internal Links** : Liens pointant vers votre site
- **External Links** : Liens vers des sites externes  
- **Posts with Links** : Nombre de posts/pages contenant des liens
- **Last scan** : Date et heure du dernier scan

### 2. **Actions (Boutons principaux)**

#### 🔍 **Scan Content**
- **Fonction** : Analyse tout le contenu (posts, pages, termes) pour extraire les liens
- **Processus** : Scan par lots de 50 éléments avec barre de progression
- **Résultat** : Remplit la table `wp_ilv_links` avec tous les liens trouvés
- **Auto-génération** : Lance automatiquement la génération des sitemaps après scan

#### 🗺️ **Generate Sitemaps** 
- **Fonction** : Crée les graphes de liens à partir des données scannées
- **Types générés** :
  - Sitemap interne (liens entre vos contenus)
  - Sitemap externe (liens vers autres sites)
  - Sitemap combiné (tous les liens)
- **Résultat** : Sauvegarde dans `wp_ilv_sitemaps` avec compression

#### 🔄 **Refresh View**
- **Fonction** : Recharge les données du graphe affiché
- **Usage** : Après modification des paramètres d'affichage

### 3. **Display Settings (Paramètres d'affichage)**

#### ☑️ **Show External Links**
- **Activé** : Affiche les liens vers sites externes (domaines)
- **Désactivé** : Masque les liens externes du graphe

#### ☑️ **Only Main Cluster** 
- **Activé** : Affiche uniquement le cluster principal (nœuds les plus connectés)
- **Désactivé** : Affiche tous les nœuds isolés et clusters

#### ☑️ **Show Labels**
- **Activé** : Affiche les titres des posts/pages sur les nœuds
- **Désactivé** : Affiche uniquement les nœuds colorés

#### 🎚️ **Grouping Strength (0-2)**
- **0** : Nœuds très dispersés, liens faibles
- **1.2** : Équilibre optimal (valeur par défaut)
- **2** : Nœuds très groupés, liens forts
- **Effet** : Contrôle la force d'attraction entre nœuds connectés

#### 📋 **Sitemap Type**
- **All Links** : Graphe complet (interne + externe)
- **Internal Links** : Tous les liens internes (bidirectionnel)
- **Internal Outbound** : Liens sortants (pages qui émettent des liens)
- **Internal Inbound** : Liens entrants (pages qui reçoivent des liens)
- **External Links Only** : Uniquement liens externes

#### 🎯 **Analyse directionnelle des liens internes**

**Internal Outbound (Liens sortants) :**
- **Focus** : Pages sources qui émettent des liens
- **Usage SEO** : Identifier les pages "hub" qui distribuent l'autorité
- **Métriques** : Pages avec beaucoup de liens sortants = distributeurs de jus de lien
- **Cas d'usage** : Optimiser les pages piliers, détecter les cul-de-sac

**Internal Inbound (Liens entrants) :**
- **Focus** : Pages cibles qui reçoivent des liens
- **Usage SEO** : Identifier les pages d'autorité les plus référencées
- **Métriques** : Pages avec beaucoup de liens entrants = pages importantes
- **Cas d'usage** : Trouver les contenus phares, détecter les pages orphelines

### 4. **Layout Controls (Contrôles d'animation)**

#### ▶️ **Play**
- **Fonction** : Lance l'animation Force Atlas 2
- **Effet** : Les nœuds se repositionnent dynamiquement
- **Performance** : Utilise un Web Worker pour éviter de bloquer l'interface

#### ⏸️ **Pause** 
- **Fonction** : Met en pause l'animation
- **Usage** : Pour examiner le graphe statique

#### 🔄 **Reset Layout**
- **Fonction** : Repositionne aléatoirement tous les nœuds
- **Usage** : Si le graphe est mal organisé

### 5. **Visual Sitemap (Zone de graphe)**

#### 🎨 **Rendu Canvas**
- **Technologie** : Canvas HTML5 haute performance
- **Interactions** :
  - **Zoom** : Molette de souris
  - **Pan** : Clic-glisser pour déplacer la vue
  - **Sélection** : Clic sur nœud pour voir détails

#### 🎯 **Types de nœuds**
- **Posts** : Cercles bleus (#3498db)
- **Pages** : Cercles verts (#2ecc71)  
- **Termes** : Cercles orange (#f39c12)
- **Domaines externes** : Cercles rouges (#e74c3c)
- **Produits** : Cercles violets (#9b59b6)

#### 📏 **Taille des nœuds**
- **Calcul** : Basé sur le nombre de liens entrants + sortants
- **Taille** : Entre 10px (peu de liens) et 50px (très connecté)

#### 🔗 **Arêtes (liens)**
- **Épaisseur** : Proportionnelle au nombre de liens entre 2 nœuds
- **Couleur** : Grise avec transparence

---

## 🔄 Flux de travail recommandé

1. **Premier usage** : Cliquez "Scan Content" (génère automatiquement les sitemaps)
2. **Exploration** : Utilisez zoom/pan pour naviguer dans le graphe
3. **Filtrage** : Ajustez les paramètres d'affichage selon vos besoins
4. **Animation** : Cliquez "Play" pour voir l'organisation dynamique
5. **Analyse** : Cliquez sur les nœuds pour voir les détails des liens

## 🛠️ Dépannage

- **Graphe vide** : Vérifiez que le scan a trouvé des liens
- **Pas de liens** : Assurez-vous d'avoir du contenu avec des liens internes
- **Performance lente** : Réduisez la taille du graphe avec "Only Main Cluster"
- **Debug** : Consultez Outils > ILV Debug pour diagnostics avancés

## 🎯 Cas d'usage

- **SEO** : Identifier les pages mal liées
- **Navigation** : Optimiser le maillage interne
- **Architecture** : Visualiser la structure du site
- **Audit** : Détecter les liens cassés ou orphelins
