Documentation — SightSEO

Installation

L'installation d'SightSEO se fait en 3 étapes simples :

Étape 1 : Créer un compte

Rendez-vous sur sightseo.com/register et créez votre compte gratuit. Vous recevrez immédiatement 25 crédits offerts et votre première clé de licence.

Étape 2 : Installer le plugin

Téléchargez le fichier sightseo.zip depuis votre dashboard. Puis dans WordPress :

        // Via l'interface WordPress

        Extensions → Ajouter → Téléverser une extension

        → Sélectionnez sightseo.zip → Installer → Activer

        // Ou via WP-CLI

        $ wp plugin install sightseo.zip --activate

Étape 3 : Entrer votre clé de licence

Dans WordPress, allez dans SightSEO → Réglages et collez votre clé de licence. Cliquez sur « Vérifier » pour confirmer la connexion.

✓ C'est prêt ! Toutes les nouvelles images auront automatiquement un texte alternatif.

Configuration

Voici les options disponibles dans les réglages du plugin :

Option	Description	Défaut
`Génération auto`	Générer le texte alt à chaque upload	Activé
`Écraser existant`	Remplacer les textes alt existants	Désactivé
`Langue`	Langue par défaut pour la génération	Français
`Qualité IA`	Standard (rapide) ou Premium (détaillé)	Standard
`Longueur max`	Nombre de caractères maximum	250
`Mots clés SEO`	Intégrer les focus keywords du plugin SEO	Activé
`Nom produit WC`	Inclure le nom du produit WooCommerce	Activé

Première génération

Après configuration, uploadez simplement une image dans votre bibliothèque de médias WordPress. En quelques secondes, le texte alternatif sera automatiquement généré et appliqué.

Vous pouvez également utiliser le bouton Générer avec l'IA qui apparaît dans le panneau de détails de chaque image de la bibliothèque.

Génération automatique

Lorsque l'option « Génération automatique » est activée, chaque image téléchargée passe par ce processus :

Vérification du format (JPG, PNG, WebP, SVG, AVIF)
Vérification du texte alt existant (sauf si « Écraser » est activé)
Collecte du contexte : langue, produit WooCommerce, mot clé SEO
Envoi à l'API SightSEO pour analyse par vision IA
Application du texte alt aux métadonnées de l'image

💡 La génération est asynchrone et ne bloque pas le processus d'upload.

Intégration SEO

SightSEO détecte automatiquement votre plugin SEO et extrait le focus keyword de la page ou du produit parent. Plugins supportés :

Yoast SEO — champ _yoast_wpseo_focuskw
Rank Math — champ rank_math_focus_keyword
All in One SEO — API v4 ou champ legacy
SEOPress — champ _seopress_analysis_target_kw
The SEO Framework — champ _genesis_keywords
SmartCrawl — champ _wds_focus-keywords
Squirrly SEO — champ _sq_fp_keyword

WooCommerce

Pour les images associées à des produits WooCommerce, le nom du produit est automatiquement intégré au texte alternatif. Le système détecte les images via :

Image à la une du produit (thumbnail)
Galerie d'images du produit
Image attachée au produit (parent post)

Multilingue

Avec WPML ou Polylang installés, la langue de chaque image est détectée automatiquement et le texte alt est généré dans la bonne langue. Plus de 130 langues sont supportées.

Prompt personnalisé

Vous pouvez écrire vos propres instructions dans le champ « Invite IA personnalisée » des réglages. Par exemple :

        "Ton professionnel et sobre. Mentionne toujours la marque si visible sur le produit. N'utilise jamais de termes techniques. Maximum 120 caractères."
      

Actions groupées

Pour traiter vos images existantes, utilisez la page SightSEO → Génération groupée. Vous pouvez filtrer :

Sans texte alt — images sans description
Toutes — toutes les images de la bibliothèque
Générées par IA — images déjà traitées par SightSEO

WP-CLI

Commandes disponibles :

        # Générer pour les images sans texte alt

        $ wp sightseo generate --missing

        # Générer pour une image spécifique

        $ wp sightseo generate --id=1234

        # Forcer la régénération de toutes les images

        $ wp sightseo generate --all --force

        # Spécifier une langue

        $ wp sightseo generate --all --lang=en

        # Voir les statistiques

        $ wp sightseo stats

        # Mode dry-run (prévisualisation sans modification)

        $ wp sightseo generate --missing --dry-run

API Reference

L'API SightSEO est accessible via HTTPS. Authentification par clé de licence.

        // Endpoint principal

        POST https://api.sightseo.com/api/v1/generate

        // Headers requis

        X-License-Key: sseo_votre_cle

        Content-Type: multipart/form-data

        // Paramètres

        image: [fichier] — Image à analyser

        language: "fr" — Code langue

        product_name: "Nom produit" — Optionnel

        seo_keyword: "mot clé" — Optionnel

        custom_prompt: "instructions" — Optionnel

        quality: "standard" — standard | premium

Dépannage

Problèmes courants et solutions :

« Clé de licence invalide »

Vérifiez que la clé est correctement copiée depuis votre dashboard. Les clés commencent par sseo_.

« Crédits épuisés »

Votre solde de crédits est à zéro. Passez à un plan supérieur ou attendez le renouvellement de votre cycle.

« Erreur de génération »

Vérifiez que l'image fait moins de 20 Mo et est dans un format supporté. Consultez les logs dans wp-content/debug.log si WP_DEBUG est activé.

Besoin d'aide ? Contactez notre support

Guide de démarrage.