Getting Started — InstantQuote Pro

Installez et publiez votre premier calculateur de prix WordPress en moins de 2 minutes. Prérequis : WordPress 6.7+ et PHP 8.1+.

Archive prête à installer : Télécharger instantquote-pro-1.0.0.zip (117 Ko) — inclut déjà les blocs compilés et l'autoloader PSR-4 intégré (aucun Composer requis).

Option A — Via l'administration WordPress (recommandé)

  1. Téléchargez instantquote-pro-1.0.0.zip.
  2. Dans WordPress, ouvrez Extensions → Ajouter une extension → Téléverser une extension.
  3. Sélectionnez le fichier ZIP, cliquez sur Installer maintenant puis sur Activer.
  4. Un menu InstantQuote apparaît dans votre barre latérale (Devis + Bibliothèque de Calculateurs).

Option B — Via WP-CLI

wp plugin install instantquote-pro-1.0.0.zip --activate

2. Créer son 1er calculateur (en 1 clic avec les modèles)

InstantQuote Pro embarque 3 Block Patterns prêts à l'emploi dans l'inserteur Gutenberg :

  • Devis Site Web / Agence (Multi-étapes) — cartes visuelles, slider pages avec remise -10%, pack SEO conditionnel, checkboxes modules et TVA 20 %.
  • Devis Artisan / Rénovation (m²) — surface m², remise volume automatique dès 80 m², minimum de facturation MAX(450, ...) et TVA réduite 10 %.
  • Calculateur Abonnement / SaaS — thème dark, sièges utilisateurs, réduction annuelle -20 % et CTA redirection Calendly avec prix dans l'URL.
  1. Créez une page ou allez dans InstantQuote → Calculateurs → Nouveau calculateur.
  2. Cliquez sur le bouton + (Inserteur), ouvrez l'onglet Compositions (Patterns) → catégorie InstantQuote Pro.
  3. Cliquez sur l'un des 3 modèles : tout le calculateur et sa formule sont immédiatement prêts à personnaliser.

3. Guide du Moteur de Formules

Le moteur AST est strictement identique côté navigateur (JS) et côté serveur (PHP), avec zéro eval() et validation en direct dans l'éditeur Gutenberg dès que vous tapez un fieldId.

Catégorie Syntaxe supportée Exemple
Arithmétique + - * / ^ () (surface * 45) + 120
Comparateurs > < >= <= == != surface >= 80
Condition métier IF(condition, si_vrai, si_faux) IF(pages > 10, pages * 90, pages * 110)
Plancher / Plafond MIN(a, b, ...) · MAX(a, b, ...) MAX(450, surface * 35)
Arrondi commercial ROUND(valeur, decimales) ROUND(total * 0.8, 2)

Exemples prêts à copier

// Remise volume -10% dès 11 pages + options
ROUND(type_site + IF(nb_pages > 10, nb_pages * 120 * 0.9, nb_pages * 120) + pack_seo + modules, 2)

// Minimum chantier 450 € + tarif dégressif dès 80 m²
ROUND(MAX(450, IF(surface >= 80, surface * prestation * 0.92, surface * prestation)) + evacuation, 2)

// Abonnement SaaS avec 5 sièges inclus et -20% en annuel
ROUND((plan_base + MAX(0, seats - 5) * 14) * IF(billing_annual == 1, 0.8, 1), 2)

4. Logique Conditionnelle

Chaque bloc de champ (Slider, Numérique, Toggle, Select/Cartes, Checkboxes) dispose d'un panneau Logique conditionnelle dans sa colonne d'inspecteur :

  • Activez Afficher ce champ sous condition.
  • Choisissez la relation ET (AND) ou OU (OR) et ajoutez une ou plusieurs règles sur n'importe quel autre fieldId du calculateur.
  • Calcul automatique : lorsqu'un champ est masqué, sa valeur effective passe automatiquement à 0 (côté client ET côté serveur) et il est retiré du récapitulatif.

5. Mode Multi-étapes (Wizard)

  1. Sélectionnez le bloc parent Calculateur InstantQuote.
  2. Dans Apparence & Mode, passez Mode d'affichage sur Multi-étapes (Wizard).
  3. Regroupez vos champs dans des blocs Étape InstantQuote (instantquote/step).
  4. La barre de progression, les pastilles cliquables et les boutons ← Précédent / Suivant → sont générés et pilotés automatiquement par l'Interactivity API.

6. Utiliser dans Elementor, Divi & Bricks

InstantQuote Pro fonctionne sur 100 % des constructeurs de pages grâce à la bibliothèque de calculateurs réutilisables :

Étape 1 — Créez votre calculateur réutilisable

Allez dans InstantQuote → Calculateurs (Shortcodes) → Nouveau calculateur, construisez-le visuellement et publiez-le. Un shortcode prêt à copier apparaît dans la liste.

Étape 2A — Dans Elementor (Widget natif)

Dans l'éditeur Elementor, cherchez le widget Calculateur InstantQuote (catégorie InstantQuote Pro), glissez-le sur votre page et sélectionnez votre calculateur dans la liste déroulante. Vous pouvez même surcharger son thème (modern, minimal, bordered, dark) et sa largeur maximale.

Étape 2B — Dans Divi, Bricks, Beaver Builder ou Classic Editor

[instantquote id="123"]
[instantquote id="123" theme="dark"]

7. Intégration WooCommerce native

  1. Créez un produit WooCommerce simple (ex: « Prestation sur-mesure », prix de base 0 ou indicatif) et notez son ID produit.
  2. Dans le bloc parent Calculateur InstantQuote → panneau Devis, Webhook & WooCommerce, saisissez cet ID Produit WooCommerce.
  3. Dans le bloc Récapitulatif & Total, choisissez le mode d'action Ajout au panier WooCommerce.
Anti-manipulation DevTools : lors du clic sur « Ajouter au panier », le navigateur n'envoie que les sélections brutes. Le serveur recalcule le tarif en PHP à partir de la formule stockée en base, signe le prix en HMAC-SHA256 et attache le détail des options au panier, au checkout et aux emails de commande.

8. Back-Office Devis, PDF, Export CSV & Webhooks

  • Suivi commercial : tous les devis arrivent dans InstantQuote → Tous les devis avec les statuts Nouveau, Contacté, Signé, Perdu et des notes internes.
  • PDF / Impression : chaque devis dispose d'une vue imprimable propre (admin + lien signé par token unique envoyé au client par email + pièce jointe HTML).
  • Export CSV : bouton en un clic dans la barre de filtres (UTF-8 BOM + protection anti-injection Excel).
  • Webhooks (Zapier, Make, n8n, Slack) : renseignez votre URL dans les réglages du bloc Calculateur pour recevoir ce payload JSON asynchrone à chaque nouveau devis :
{
  "event": "quote.created",
  "quoteId": 42,
  "reference": "IQ-20261121-4821",
  "status": "new",
  "lead": {
    "name": "Camille Laurent",
    "email": "camille@entreprise.fr",
    "phone": "06 12 34 56 78",
    "message": "Lancement souhaité le mois prochain."
  },
  "pricing": {
    "subtotal": 2470,
    "taxAmount": 494,
    "total": 2964,
    "currency": "€",
    "formattedTotal": "2 964,00 €"
  },
  "items": [
    { "fieldId": "type_site", "label": "Type de site souhaité", "displayValue": "Site Vitrine", "numericValue": 1200 },
    { "fieldId": "nb_pages", "label": "Nombre de pages estimé", "displayValue": "6 pages", "numericValue": 6 }
  ],
  "printUrl": "https://votre-site.fr/?iq_print_quote=42&iq_token=..."
}

9. Développement & Build local

Pour modifier les blocs ou compiler le plugin depuis le dépôt source instantquote-pro :

cd instantquote-pro
npm install
npm run build      # Compile les 8 blocs API v3 + viewScriptModule Interactivity API
npm run start      # Mode watch en développement
npm test           # Exécute les tests unitaires JS (node:test) + PHP