=== Advanced PDF Invoice Builder ===
Contributors: natsenack
Tags: invoice, pdf, woocommerce, generator, template
Requires at least: 6.9
Tested up to: 7.0
Requires PHP: 8.2
Stable tag: 1.0.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
WC requires at least: 9.9
WC tested up to: 10.0

💼 Constructeur professionnel de factures et documents PDF pour WordPress — éditeur visuel drag-and-drop avec intégration WooCommerce.

== Description ==

Advanced PDF Invoice Builder vous permet de **créer, personnaliser et générer des factures ou documents PDF** directement depuis votre zone d'administration WordPress. Créez vos propres modèles avec un **canvas drag-and-drop en direct** et associez-les automatiquement aux commandes WooCommerce.

**Parfait pour :**
* Les boutiques e-commerce ayant besoin de factures PDF personnalisées
* Les entreprises de services générant des devis et documents
* Tous ceux qui ont besoin de PDF professionnels sans coder

---

== 🎁 Fonctionnalités Gratuites (ÉDITION DE BASE) ==

**Éditeur de Canvas**
* Éditeur visuel de modèles PDF drag-and-drop (React 18, aperçu en temps réel)
* Éléments drag-and-drop — texte, image, ligne, rectangle
* Contrôle complet des éléments — position, taille, rotation, couleurs, polices

**Génération PDF**
* Moteur de rendu haute performance basé sur Puppeteer
* Intégration WooCommerce complète — génération automatique par statut, envoi par e-mail au client

**Modèles de Documents**
* **2 types de documents :** Facture & Devis
* **3 modèles de texte dynamique** pour les champs courants
* **3 modèles de mentions** (conditions, mentions légales, etc.)

**Options d'Export**
* **3 paramètres DPI :** 72, 96, 150 DPI
* **Format :** PDF uniquement
* **Taille de page :** A4 portrait uniquement

**Localisation**
* **Traductions française (fr_FR) et anglaise** incluses
* Support RTL (`/languages`)
* Code source complet inclus (TypeScript + PHP, GPL v2)

**Limites**
* Jusqu'à **1 modèle personnalisé** enregistré en base de données

---

== 🚀 Édition Pro (MODULE PREMIUM) ==

*Disponible séparément sur [hub.threeaxe.fr](https://hub.threeaxe.fr)*

**Tout ce qui est dans GRATUIT, PLUS :**

**Types de Documents Étendus**
* **6 types de documents :** Facture, Devis, Bon de commande, Avoir, Bon de livraison, Contrat
* **36 modèles de texte dynamique avancés** (vs 3 en GRATUIT)
* **21 modèles de mentions avancés** (vs 3 en GRATUIT)

**Export Avancé**
* **Export PNG & JPG** en plus du PDF
* **6 paramètres DPI :** 72, 96, 150, 300, 600 DPI
* **4 formats de page + paysage :** A3, Lettre, Légal, A4 + tous en orientation paysage
* Export de fond transparent

**Fonctionnalités Canvas**
* Navigation grille et accrochage
* Guides et outils d'alignement
* Multi-sélection d'éléments
* Raccourcis clavier
* Personnalisation de thème
* Ordonnancement et manipulation des calques
* Système complet de verrouillage d'éléments

**Gestion des Modèles**
* **Modèles personnalisés illimités** (vs 1 en GRATUIT)
* **Galerie de 3 modèles prédéfinis premium**
* Définir le modèle par défaut par type de document

**Support**
* Support prioritaire & mises à jour

---

== Installation ==

1. Téléchargez et décompressez le plugin dans le répertoire `/wp-content/plugins/`.
2. Activez le plugin via le menu "Extensions" dans WordPress.
3. Allez à **"PDF Builder"** dans le menu d'administration principal pour configurer vos paramètres.
4. Créez votre premier modèle et personnalisez-le !

== Démarrage Rapide ==

1. Naviguez jusqu'à **PDF Builder → Templates** dans votre admin WordPress
2. Cliquez sur **"Créer un nouveau modèle"**
3. Utilisez l'éditeur drag-and-drop pour concevoir votre modèle
4. Enregistrez et testez avec une commande WooCommerce
5. Activez la génération automatique dans les paramètres

== Code Source ==

Ce plugin contient des fichiers JavaScript et CSS minifiés/compilés. Le code source complet non minifié est inclus dans le paquet du plugin, comme l'exigent les directives WordPress.org.

**Dépôt Source :**
* **GitHub :** https://github.com/natsenack/advanced-pdf-invoice-builder
* **Outil de build :** webpack 5
* **Commande de build :** `npm install && npm run build:free`

**Assets compilés mappés aux sources :**

* `assets/js/pdf-builder-react.min.js` ← `src/js/react/` (TypeScript/JSX)
* `assets/js/vendors.min.js` ← bundle de fournisseurs webpack (React, ReactDOM, etc.)
* `assets/js/notifications.min.js` ← `src/js/admin/notifications.js`
* `assets/js/settings-tabs.min.js` ← `src/js/admin/settings-tabs.js`
* `assets/js/canvas-settings.min.js` ← `src/js/admin/canvas-settings.js`
* `assets/css/pdf-builder-react.min.css` ← `src/css/pdf-builder-react.css`
* `assets/css/pdf-builder-admin-css.min.css` ← `src/css/pdf-builder-admin.css`

**Bibliothèque Tierce :**
* `assets/js/html2canvas.min.js` — [html2canvas v1.4.1](https://github.com/niklasvh/html2canvas) (Licence MIT)

---

== Confidentialité & Données ==

✅ **Ce plugin privilégie la confidentialité :**

**Retours de Désactivation (Optionnel)**
* Collectés **uniquement** quand vous cliquez sur "Envoyer et désactiver"
* Anonymes — inclut raison, commentaire optionnel, URL site, version, date/heure
* Pas de mots de passe, pas de données personnelles, pas de suivi sans consentement
* Vous pouvez toujours ignorer la boîte de dialogue ou utiliser "Ignorer et désactiver"

---

== Questions Fréquemment Posées ==

= Quelles versions de WordPress sont supportées ? =

Advanced PDF Invoice Builder nécessite **WordPress 6.9 ou version ultérieure**.

= Est-ce compatible avec WooCommerce ? =

**Oui !** Le plugin offre une intégration native WooCommerce pour la génération automatique de PDF de commandes. Nécessite **WooCommerce 9.9+**.

= Quels formats PDF sont supportés ? =

Le plugin génère des fichiers PDF standard compatibles avec tous les lecteurs PDF modernes (Adobe Reader, Preview, Chrome, Firefox, Edge, etc.).

= Puis-je utiliser des polices personnalisées ? =

Oui ! Le plugin utilise des piles de polices locales/système pour un rendu fiable. Aucune Google Fonts ni dépendances externes.

= Comment fonctionne la génération PDF ? =

Les modèles sont rendus côté serveur avec Puppeteer sur notre service PDF sécurisé (pdf.threeaxe.fr). Toute communication est HTTPS.

= Qu'en est-il de l'édition Pro ? =

L'**édition Pro** est vendue séparément et ajoute 6 types de documents, des fonctionnalités canvas avancées, modèles illimités et export image. Apprenez-en plus sur [hub.threeaxe.fr](https://hub.threeaxe.fr).

---

== Services Externes ==

Ce plugin se connecte à des services tiers pour la génération PDF et la validation de licence. **Tous sont optionnels et nécessitent une configuration explicite.**

**En utilisant ce plugin, vous acceptez leurs conditions de service et politiques de confidentialité.**

= 📄 Service de Génération PDF (pdf.threeaxe.fr) =
* **Objectif :** Rend les modèles en PDF/PNG/JPG
* **Quand utilisé :** Quand vous générez un PDF depuis WooCommerce ou l'éditeur admin
* **Données envoyées :** HTML de modèle, polices, couleurs, données de commande (si de WooCommerce)
* **URL du service :** https://pdf.threeaxe.fr
* **Confidentialité :** https://hub.threeaxe.fr/privacy-policy/
* **Conditions :** https://hub.threeaxe.fr/conditions-dutilisation

= 🔑 Serveur de Validation de Licence (hub.threeaxe.fr) =
* **Objectif :** Activer, désactiver et vérifier les licences Pro
* **Quand utilisé :** (1) Quand vous gérez manuellement les clés de licence ; (2) Une fois par jour sur pages admin (Pro uniquement)
* **Données envoyées :** Clé de licence, URL site, nom du plugin
* **URL du service :** https://hub.threeaxe.fr
* **Confidentialité :** https://hub.threeaxe.fr/privacy-policy/
* **Conditions :** https://hub.threeaxe.fr/conditions-dutilisation

= 📦 Mises à Jour WordPress.org (api.wordpress.org) =
* **Objectif :** Vérifier les mises à jour des plugins
* **Quand utilisé :** Automatiquement via le système de mises à jour WordPress
* **Données envoyées :** Aucune (mécanisme standard WordPress)
* **URL du service :** https://api.wordpress.org

= ☁️ Intégrations Cloud Optionnelles (opt-in) =

Les suivantes sont **entièrement optionnelles et désactivées par défaut :**

* **Google Drive** — Exporter les PDF vers Google Drive
* **Dropbox** — Exporter les PDF vers Dropbox
* **Microsoft OneDrive** — Exporter les PDF vers OneDrive
* **Slack** — Envoyer des notifications PDF aux canaux Slack
* **HubSpot** — Joindre les PDF aux contacts CRM
* **Salesforce** — Joindre les PDF aux enregistrements Salesforce

*Aucune de ces options ne nécessite de configuration sauf si vous l'activez explicitement. Aucune donnée ne quitte votre site sans votre consentement.*

---

== Liens de l'Auteur ==

Ce plugin inclut des liens de navigation vers les pages appartenant à l'auteur :

* **Produit & Mise à Niveau :** https://hub.threeaxe.fr
* **Tickets de Support :** https://hub.threeaxe.fr/index.php/ticket/
* **Dépôt GitHub :** https://github.com/natsenack/advanced-pdf-invoice-builder

*Ces liens sont purement informatifs et n'envoient pas automatiquement les données du site.*

---

== Changelog ==

= 1.0.3 =
* **Fix :** Système de snap à la grille — chemin d'état corrigé pour accrochage correct au drag
* **Fix :** Ordonnancement des calques dans le menu contextuel — Avancer/Reculer fonctionnent maintenant
* **Fix :** État verrouillé/déverrouillé — toggle persiste et marque le modèle comme modifié
* **Fix :** Limite de modèle dans l'édition GRATUIT (1 modèle) — flux de création ne continue plus après insertion
* **Security :** Vérifier la propriété de l'utilisateur avant mises à jour
* **Improvement :** Bloquer l'accès à l'éditeur en mode "new" quand la limite est atteinte
* **Code quality :** Corrections PHPCS pour conformité WordPress.org (commentaires, indentation, whitespace)

= 1.0.2 =
* **Fix :** Système de traduction (i18n) réparé — fichiers corrompus nettoyés
* **Improvement :** Dossier de langue réorganisé avec modèle POT régénéré (738 chaînes)
* **Improvement :** 26 traductions françaises maintenant disponibles (locale fr_FR)
* **New :** Documentation du statut de traduction incluse

= 1.0.0 =
* Première version publique — plugin divisé en éditions GRATUIT et PRO
* Plugin soumis à WordPress.org

---

== Support ==

📧 **Besoin d'aide ?**

* Visitez notre [portail de support](https://hub.threeaxe.fr/index.php/ticket/)
* Consultez la [documentation GitHub](https://github.com/natsenack/advanced-pdf-invoice-builder)
* Signalez les bogues sur GitHub Issues

🚀 **Vous voulez upgrader ?**

Visitez [hub.threeaxe.fr](https://hub.threeaxe.fr) pour en savoir plus sur l'édition Pro et les fonctionnalités premium.

---

**Fait avec ❤️ par Threeaxe**
