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+.
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é)
- Téléchargez
instantquote-pro-1.0.0.zip. - Dans WordPress, ouvrez Extensions → Ajouter une extension → Téléverser une extension.
- Sélectionnez le fichier ZIP, cliquez sur Installer maintenant puis sur Activer.
- 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.
- Créez une page ou allez dans InstantQuote → Calculateurs → Nouveau calculateur.
- Cliquez sur le bouton + (Inserteur), ouvrez l'onglet Compositions (Patterns) → catégorie InstantQuote Pro.
- 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
fieldIddu 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)
- Sélectionnez le bloc parent Calculateur InstantQuote.
- Dans Apparence & Mode, passez Mode d'affichage sur Multi-étapes (Wizard).
- Regroupez vos champs dans des blocs Étape InstantQuote (
instantquote/step). - 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
- Créez un produit WooCommerce simple (ex: « Prestation sur-mesure », prix de base
0ou indicatif) et notez son ID produit. - Dans le bloc parent Calculateur InstantQuote → panneau Devis, Webhook & WooCommerce, saisissez cet ID Produit WooCommerce.
- Dans le bloc Récapitulatif & Total, choisissez le mode d'action Ajout au panier WooCommerce.
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é,Perduet 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