Accueil / Documentation

Documentation

De l'installation à la première catégorie traitée, en un quart d'heure.

Prérequis

  • WordPress 6.2 ou plus récent, WooCommerce 7.0 ou plus récent, PHP 7.4 ou plus récent.
  • Une clé API pour la rédaction : Anthropic (recommandé) ou OpenAI.
  • Une clé API pour la recherche web : Tavily, Serper.dev, SerpAPI ou Brave Search.
  • Optionnel : l'outil pdftotext sur le serveur, utile seulement si vous utilisez OpenAI avec des PDF (avec Anthropic, les PDF sont lus directement).

Installation

  1. Dans l'administration WordPress, ouvrez Extensions > Ajouter, cherchez « Fichewise », installez et activez. Vous pouvez aussi télécharger l'archive depuis WordPress.org.
  2. Un menu Fichewise apparaît dans la barre latérale. La table du journal est créée à l'activation.
  3. L'extension déclare sa compatibilité avec le stockage des commandes haute performance (HPOS) de WooCommerce.

Clés API

Dans Fichewise > Réglages, choisissez le fournisseur d'IA et le moteur de recherche, collez les clés, puis cliquez sur Tester à côté de chacun.

ServiceOù créer la cléRemarque
Anthropicconsole.anthropic.com, API KeysModèle par défaut : Claude Sonnet, bon rapport qualité et coût.
OpenAIplatform.openai.com, API keysLes PDF passent par pdftotext.
Tavilytavily.com1 000 recherches gratuites par mois, contenu des pages inclus.
Serper.devserper.devVraie SERP Google avec « Autres questions posées » et Shopping. Recommandé pour l'analyse concurrentielle.

Pour ne pas stocker les clés en base, définissez-les dans wp-config.php :

define( 'WEA_ANTHROPIC_API_KEY', 'sk-ant-...' );
define( 'WEA_TAVILY_API_KEY', 'tvly-...' );

Profil boutique

Ouvrez Fichewise > Profil boutique et cliquez sur Analyser la boutique. L'analyse lit une douzaine de vos descriptions les plus abouties et produit un profil éditorial : positionnement, cible, ton de voix, règles de style, vocabulaire, expressions à éviter. Elle prend moins d'une minute et ne se refait que si vous le demandez.

Pour imposer votre propre ton, renseignez « Ton de voix imposé » et « Consignes supplémentaires » dans les réglages. Ils priment sur l'analyse.

Première fiche

  1. Ouvrez un produit qui a un EAN ou une marque connue.
  2. Dans le panneau latéral Fichewise, cliquez sur Enrichir maintenant.
  3. Comptez une à trois minutes : recherche, lecture des sources, analyse concurrentielle, rédaction, relecture. Vous êtes ensuite redirigé vers l'écran de revue.

Sur un hébergement mutualisé, une exécution de plus de deux minutes peut être interrompue par le serveur. Utilisez alors En file : le traitement passe en arrière-plan, étape par étape.

Écran de revue

L'écran de revue présente chaque champ proposé à côté du contenu actuel, avec un aperçu du HTML et des compteurs de caractères pour le title et la meta description. À droite, les sources lues avec leur score, les conflits à trancher et le résumé de l'analyse concurrentielle.

  • Choisir, sur un conflit, retient une valeur et la marque comme validée par vous.
  • Régénérer la rédaction relance l'écriture avec les mêmes données, par exemple après avoir tranché un conflit.
  • Tout recommencer refait la recherche, la concurrence et la rédaction.
  • Publier écrit la fiche sur le produit. Une sauvegarde est faite avant, Restaurer l'original la remet en place.

Documents fournisseur

Sous l'éditeur de chaque produit, le bloc Documents fournisseur accepte :

  • des fichiers de la médiathèque : PDF, images, textes ;
  • des adresses de documents en ligne, une par ligne ;
  • des notes du vendeur : origine, particularités, ce qu'il ne faut pas dire.

Sur la page de modification d'une catégorie, vous pouvez rattacher un catalogue fournisseur : il sert à tous les produits de la catégorie et de ses sous-catégories, et l'IA y repère la ligne du bon produit. Les images principales et deux images de galerie sont analysées automatiquement.

Traitement en masse

Depuis le Tableau de bord, choisissez un périmètre (produits sans description, une catégorie, les produits en erreur, tout le catalogue), une limite, puis Mettre en file. Le traitement s'exécute en arrière-plan avec Action Scheduler, déjà présent avec WooCommerce. La liste Produits se met à jour seule et les fiches terminées arrivent dans Revue.

L'action groupée « Fichewise : enrichir » est aussi disponible dans la liste native des produits WooCommerce.

Produits introuvables

Quand aucune source ni aucun document n'est exploitable, Fichewise passe en mode dégradé au lieu d'échouer : la fiche est rédigée à partir des seules données de la boutique, l'analyse concurrentielle porte sur la catégorie, aucune caractéristique n'est ajoutée, le score est plafonné à 55 et un bandeau indique ce qu'il faudrait fournir. Ajoutez un document ou une photo d'étiquette, puis relancez.

SEO et données structurées

Le title, la meta description et le mot-clé principal sont écrits dans les champs de Rank Math, Yoast SEO, All in One SEO ou SEOPress, selon celui qui est actif. Sans plugin SEO, Fichewise produit lui-même ces balises.

Sur les produits publiés, la FAQ génère un bloc FAQPage et le schema Product de WooCommerce est complété : marque, GTIN, référence fabricant et propriétés additionnelles.

Shopping, Amazon, langues

Dans les réglages, cochez les canaux Google Shopping et Amazon : chaque produit reçoit alors un titre, une description et des attributs aux normes du canal. Les langues supplémentaires produisent des versions traduites de la fiche. Tout s'exporte en CSV ou JSON depuis Fichewise > Exports.

WP-CLI et API REST

wp wea profile                         # analyser la boutique
wp wea enrich --ids=12,15 --sync       # enrichir immédiatement
wp wea enrich --category=vins-rouges   # mettre une catégorie en file
wp wea enrich --missing --limit=50     # produits sans description
wp wea publish                         # publier tout ce qui est à valider
wp wea rollback --ids=12               # restaurer
wp wea export google_shopping --file=gs.csv
wp action-scheduler run --group=fichewise

L'API REST est exposée sous /wp-json/wea/v1/ pour les utilisateurs ayant la capacité manage_woocommerce : POST /enrich, GET /status/{id}, GET /dossier/{id}, POST /publish/{id}, POST /rollback/{id}, GET /stats, GET /export/{canal}.

Réglages utiles

  • Domaines de confiance : sites fabricants ou grossistes qui reçoivent la fiabilité maximale.
  • Domaines exclus : réseaux sociaux par défaut, ajoutez vos concurrents directs si vous ne voulez pas qu'ils servent de source.
  • Confiance minimale d'un attribut : en dessous, l'attribut n'est pas affirmé dans le texte (0,6 par défaut).
  • Champs remplacés : titre, descriptions, attributs, méta SEO, étiquettes, texte alternatif, GTIN, chacun activable séparément.

Une question qui n'est pas traitée ici ? Écrivez-nous.