=== Article IA à valider par mail ===
Contributors: laurentperez
Tags: ia, seo, articles, blog, e-mail
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

L'IA rédige des articles de blog pensés pour le référencement (SEO). Vous les recevez par e-mail : « OK » pour publier, ou dites ce qu'il faut changer.

== Description ==

« Article IA à valider par mail » rédige un article de blog pensé pour le référencement, à la fréquence choisie (de tous les jours à tous les mois) et l'envoie par e-mail. Le destinataire n'a jamais besoin de se connecter à WordPress : il répond simplement à l'e-mail.

* « OK » : l'article est publié, et il reçoit le lien.
* Une demande (« raccourcis l'introduction », « change la photo »), ou son propre texte corrigé : l'IA met l'article à jour et renvoie la nouvelle version.
* Une question : l'IA lui répond, sans rien publier.

La réponse par e-mail demande une boîte mail réservée à cet usage (par exemple blog@votre-domaine.fr), que le plugin relève toutes les 5 minutes. Sans cette boîte, les boutons « Publier » et « Demander une modification » de l'e-mail font la même chose depuis une page du site.

Tout se règle depuis le menu « Article IA » de l'administration :

* **Connexion IA** : clé API, test de connexion, choix du modèle.
* **Contenu** : présentation de l'activité, consignes de rédaction, sujets à traiter, ton, longueur, catégories, tags, auteur.
* **Image à la une** : photo choisie selon le sujet dans une banque d'images gratuite (Pixabay ou Pexels), image fixe de la médiathèque, ou pas d'image.
* **Planification** : fréquence, heure d'envoi, article à la demande.
* **Validation par e-mail** : destinataires, nombre de modifications par article, publication automatique sans réponse, boîte mail des réponses.
* **Journal** : articles rédigés et derniers événements.

Tant qu'un article n'est pas validé, il reste en brouillon.

= Service externe =

Ce plugin envoie des données au service d'IA choisi pour rédiger les articles. Avec Claude, il s'agit de l'API d'Anthropic (https://api.anthropic.com). Sont transmis : le nom et l'adresse du site, la présentation de l'activité, les consignes, les catégories et tags proposés, les titres des derniers articles du site, et, lors d'une correction, le texte de l'article et la demande de modification. Rien n'est envoyé tant qu'aucune clé API n'est enregistrée.

Conditions d'utilisation : https://www.anthropic.com/legal/commercial-terms
Politique de confidentialité : https://www.anthropic.com/legal/privacy

Chaque article est facturé par le fournisseur d'IA sur le compte lié à la clé API.

Si l'image à la une est réglée sur une banque d'images, le plugin interroge aussi l'API de cette banque — Pixabay (https://pixabay.com/api/) ou Pexels (https://api.pexels.com) : seuls quelques mots-clés décrivant la photo recherchée sont transmis, puis la photo retenue est téléchargée depuis pixabay.com ou images.pexels.com et copiée dans la médiathèque. La clé est gratuite. En mode abonnement, c'est le service qui interroge la banque d'images ; le site ne fait que télécharger la photo.

Si la réponse par e-mail est activée, le plugin se connecte au serveur de messagerie que vous indiquez (protocole IMAP) pour y lire les réponses, et le texte de ces réponses est transmis au service d'IA avec l'article concerné. Les autres messages de la boîte ne sont ni lus ni modifiés.

En mode abonnement (fichier de configuration avec « service_url »), le plugin s'adresse au service du fournisseur à la place des services ci-dessus : il lui transmet les mêmes données, l'adresse du site et, si vous demandez l'essai gratuit, l'adresse e-mail que vous indiquez.

Pixabay — conditions d'utilisation de l'API : https://pixabay.com/api/docs/ ; licence des photos : https://pixabay.com/service/license-summary/
Pexels — conditions d'utilisation de l'API : https://www.pexels.com/api/documentation/ ; licence des photos : https://www.pexels.com/license/

== Installation ==

1. Dans WordPress, ouvrez Extensions > Ajouter > Téléverser une extension, puis choisissez le fichier .zip.
2. Activez l'extension.
3. Ouvrez le menu « Article IA », collez votre clé API dans l'onglet « Connexion IA » et cliquez sur « Tester la connexion ».
4. Remplissez l'onglet « Contenu », enregistrez, puis utilisez « Rédiger et envoyer un article maintenant » dans l'onglet « Planification » pour faire un essai.
5. Quand le résultat vous convient, cochez « Envoi automatique ».

== Frequently Asked Questions ==

= Faut-il modifier wp-config.php ? =

Non. Tout se règle depuis l'administration. La clé API est chiffrée dans la base de données du site.

= L'article n'arrive pas par e-mail =

L'envoi passe par les e-mails de WordPress. Si le site n'envoie pas correctement ses e-mails (formulaires de contact, réinitialisation de mot de passe), installez une extension SMTP. En attendant, l'article reste disponible en brouillon dans Articles.

= L'article n'est pas parti à l'heure prévue =

Les tâches planifiées de WordPress se déclenchent lors des visites du site. Sur un site peu fréquenté, l'envoi peut être retardé : demandez à votre hébergeur d'appeler wp-cron.php toutes les heures.

= Pourquoi faut-il cliquer deux fois pour publier ? =

Beaucoup de messageries ouvrent automatiquement les liens des e-mails pour les analyser. Si le lien de l'e-mail publiait directement, des articles partiraient en ligne sans accord. Le bouton de l'e-mail ouvre donc une page où l'on confirme la publication.

= Comment activer la réponse par e-mail ? =

Créez une boîte mail chez l'hébergeur du site (par exemple blog@votre-domaine.fr). Dans l'onglet « Validation par e-mail », cochez « Réponse par e-mail », indiquez l'adresse, le serveur IMAP (souvent mail.votre-domaine.fr, port 993, SSL/TLS), l'identifiant et le mot de passe, puis cliquez sur « Tester la connexion ». Utilisez une boîte réservée à cet usage plutôt qu'une boîte personnelle.

= Qui peut publier en répondant ? =

Toute personne qui a reçu l'e-mail. Chaque version de l'article porte une référence secrète dans l'objet du message (ART-…) : la réponse doit la conserver. Répondre à un ancien e-mail ne publie rien. Les messages d'absence automatiques sont ignorés.

= La réponse n'est pas prise en compte tout de suite =

Les réponses sont relevées toutes les 5 minutes, à condition que les tâches planifiées de WordPress tournent : sur un site peu visité, demandez à l'hébergeur d'appeler wp-cron.php toutes les 5 minutes. Le bouton « Relever les réponses maintenant » permet de vérifier.

= Le plugin fonctionne-t-il sur un multisite ? =

Oui. Chaque site du réseau a ses propres réglages, ses clés, sa boîte mail et son calendrier, que le plugin soit activé site par site ou pour tout le réseau. Les tâches planifiées sont propres à chaque site : si l'hébergeur appelle wp-cron.php, il doit le faire à l'adresse de chaque site concerné.

= Peut-on fournir soi-même l'IA et la boîte mail à ses clients ? =

Oui, avec le fichier de configuration décrit dans service-config-sample.php. En mode abonnement, le site s'adresse à votre propre service (fourni à part, à installer sur votre serveur) avec un code d'abonnement : il ne contient aucune clé. En mode local, réservé aux serveurs que vous gérez, la clé et la boîte mail sont écrites dans le fichier. Dans les deux cas, les réglages correspondants disparaissent de l'administration du site.

= Comment fonctionne l'essai gratuit ? =

En mode abonnement, si le fournisseur du service le propose, l'onglet « Abonnement » affiche un encart « Essayez gratuitement ». Vous indiquez votre adresse e-mail, et le site reçoit un code d'essai : un article offert, à faire modifier ou publier par e-mail comme avec un abonnement. Un seul essai par site. L'adresse e-mail et l'adresse du site sont transmises au fournisseur du service. Pour accorder l'essai, le service vérifie que la demande vient bien du site : celui-ci doit être accessible en ligne.

= Comment s'abonner depuis le site ? =

En mode abonnement, si le fournisseur du service propose le paiement en ligne, l'onglet « Abonnement » affiche ses formules et leur prix. Vous en choisissez une, vous payez sur une page de paiement sécurisée, puis vous revenez sur votre site, qui est activé aussitôt. Le bouton « Gérer mon abonnement » donne accès aux factures, au moyen de paiement et à la résiliation. Le plugin ne voit ni ne conserve aucune donnée bancaire.

= Peut-on utiliser une autre IA que Claude ? =

Pas dans cette version. Le code est prévu pour accueillir d'autres fournisseurs (filtre `artia_providers`).

= D'où viennent les images ? =

D'une banque d'images gratuite (Pixabay ou Pexels), si vous l'activez dans l'onglet « Image à la une ». L'IA ne fabrique pas d'image : elle propose des mots-clés, et la photo correspondante est copiée dans votre médiathèque avec le nom du photographe en légende. Le destinataire peut demander une autre photo depuis l'e-mail.

== Changelog ==

= 1.0.2 =
* Cartouche du logo : adresse du site dans un bandeau de la couleur du vendeur.

= 1.0.1 =
* Logo du vendeur posé sur la ligne des onglets, à côté du titre et des messages : il ne recouvre plus les tableaux.

= 1.0.0 =
* Première version stable.
* Captures du mode d'emploi et de la fiche de l'extension refaites avec l'interface actuelle (formules Découverte à Intensif, nouvel en-tête).

= 0.11.11 =
* En-tête : logo du vendeur à droite, au niveau des onglets ; étapes numérotées et message d'état aux couleurs du vendeur.

= 0.11.10 =
* En-tête : le logo du vendeur reste en haut à droite, les messages ne passent plus dessous.

= 0.11.9 =
* Fiche « Afficher les détails » plus complète : fonctionnement, contenu inclus, formules, questions fréquentes ; lien direct vers la page du plugin.

= 0.11.8 =
* Cartes des formules : contour de la couleur du vendeur, formule en cours sur fond clair ; texte en blanc sur les étiquettes de couleur.

= 0.11.7 =
* Page de réglages plus large ; les formules tiennent sur une seule ligne.

= 0.11.6 =
* Onglet Abonnement : le changement de formule se fait dans les mêmes cartes que le choix de départ (prix bien visible, calendrier des envois).
* Logo du vendeur plus net, avec un peu d'air au-dessus et au-dessous.
* Abonnement : le nombre de modifications par article est celui de la formule (de 3 à 5), affiché sur chaque carte. 3 par défaut.

= 0.11.5 =
* L'article automatique part à l'heure choisie (avant, il pouvait attendre jusqu'à une heure de plus la tâche horaire de WordPress).

= 0.11.4 =
* Onglet Contenu, deux cases « Visibilité », décochées par défaut : montrer ses derniers articles en exemple sur la page du service (avec un lien vers le site), et une petite mention en bas des articles (lien nofollow vers le service).
* Onglet Contenu, case « IA européenne » : les articles sont rédigés par Mistral AI (France) au lieu de Claude. Proposée quand le service a une clé Mistral.
* Liens vers les conditions générales de vente et la politique de confidentialité du vendeur, sous les formules et en bas de l'écran. Rappel : service réservé aux professionnels.

= 0.11.3 =
* En bas de l'écran de réglages : version installée et résultat de la dernière recherche de mise à jour (disponible, à jour, ou raison de l'échec), avec un lien « Vérifier maintenant ».

= 0.11.2 =
* Changement pour une formule plus chère : si la banque demande une confirmation (3D Secure), le client est envoyé sur la page de paiement sécurisée ; la nouvelle formule s'applique une fois la différence payée.

= 0.11.1 =
* Adresse e-mail du vendeur : dans l'encadré en bas de page (« Une question ? ») et pour changer ou arrêter une formule réglée directement avec lui.

= 0.11.0 =
* Maillage interne : l'IA connaît les pages (menus d'abord) et les articles publiés du site, et place 1 à 3 liens utiles. Les liens inventés ou vers d'autres sites sont retirés.
* Style : l'IA s'inspire du ton des articles écrits par le propriétaire du site.
* Abonnement payé en ligne : changer de formule, arrêter ou reprendre directement depuis l'onglet « Abonnement », sans passer par l'espace de paiement.
* Essai et formule offerte : explication claire de ce qui se passe à la fin, et de qui contacter.

= 0.10.2 =
* Nouvel onglet « Mode d'emploi » : les réglages et la validation par e-mail expliqués pas à pas, avec des captures.
* Icône, bannière et captures dans la fiche « Afficher les détails » des mises à jour.

= 0.10.1 =
* Version par abonnement : l'extension fonctionne uniquement avec le service.
* Logo du vendeur plus grand et mieux cadré sur la page de réglages, la page de validation et l'e-mail (réglage « logo_trim » pour rogner le blanc autour du dessin).

= 0.10.0 =
* Nouveau nom : « Article IA à valider par mail » (menu « Article IA »). Rien ne change dans vos réglages ni dans vos articles.

= 0.9.0 =
* Habillage du vendeur : son logo et ses couleurs sur la page de réglages, dans l'e-mail de validation et sur la page de validation (clé « brand » du fichier de configuration).

= 0.8.0 =
* Formules d'abonnement plus lisibles : calendrier des envois sur un mois, prix par article, formule conseillée.
* Page de réglages rhabillée : sections en cadres, onglets plus clairs, rappel du fonctionnement en trois temps.

= 0.7.0 =
* Image à la une : banque d'images Pixabay, en plus de Pexels. En mode abonnement, la banque d'images est celle du service.
* Rythmes d'envoi : 1, 2 ou 3 articles par mois, 1 ou 2 par semaine. En mode abonnement, le rythme est celui de la formule.
* Mises à jour en un clic depuis le serveur du vendeur.
* Mode abonnement : plus aucun réglage de boîte mail ni de clé de banque d'images affiché sur le site.

= 0.6.0 =
* Abonnement en ligne : choix de la formule et paiement depuis l'onglet « Abonnement », gestion de l'abonnement (factures, carte, résiliation).
* Articles de 1 200 mots par défaut, et consignes de rédaction pensées pour le référencement.

= 0.5.0 =
* Essai gratuit en mode abonnement : un article offert, sans code, depuis l'onglet « Abonnement ».

= 0.4.0 =
* Mode abonnement : IA, images et réponses par e-mail fournies par le service du vendeur, avec un simple code d'abonnement.
* Mode local : clé et boîte mail dans un fichier de configuration, pour les serveurs que l'on gère soi-même.
* Une même boîte mail peut servir à plusieurs sites (identifiant de site dans la référence).

= 0.3.1 =
* Multisite : auteur par défaut sur un site sans administrateur, désactivation et désinstallation sur tout le réseau.
* Correction d'un avertissement de traduction chargée trop tôt.

= 0.3.0 =
* Réponse par e-mail : « OK » pour publier, demande de modification, texte corrigé ou question, lus par l'IA dans une boîte mail dédiée.

= 0.2.0 =
* Image à la une : banque d'images Pexels, image fixe ou aucune.

= 0.1.0 =
* Première version.
