⚠️ Important : Vous devez activer au moins une passerelle d'abonnement (Stripe ou PayPal) dans Prepaid Booking for Listeo pour que les abonnements fonctionnent.

❌ Le problème avec Listeo par défaut

• Paiements uniques pour les packages d'annonces
• Revenus imprévisibles et non récurrents
• Nécessite WooCommerce Subscriptions (199$/an)
• Pas de gestion automatisée des renouvellements

✅ La solution avec ce plugin

• 💰 Revenus récurrents - Abonnements mensuels ou annuels automatiques
• 💳 Stripe + PayPal natif - Sans WooCommerce Subscriptions (économisez 199$/an)
• 🔄 100% automatisé - Webhooks sécurisés pour les renouvellements et annulations
• 📊 Commission par forfait - Taux de commission personnalisé pour chaque plan
• 💵 Paiement en espèces - Option de paiement cash pour les réservations

🎯 Avantages clés

1 📦 Créer le produit WooCommerce

1. Allez dans Produits → Ajouter un produit
2. Donnez un nom (ex: "Forfait Premium Mensuel")
3. Type de produit : Listing Package ou Listing Package Subscription
4. Définissez le prix mensuel (ex: 29€)
5. Définissez le prix annuel (ex: 290€ - avec réduction)

2 📋 Configurer les options Listeo

3 🔄 Synchroniser avec Stripe/PayPal

1. Allez dans Subscription for Listeo → Packages
2. Cliquez sur "Configurer Abonnement" pour le forfait
3. Le système crée automatiquement les produits et prix Stripe/PayPal
4. Vérifiez les statuts de synchronisation ✅

✅ Important : Durée des annonces

La durée des annonces est automatiquement gérée par l'abonnement. Les annonces restent actives tant que l'abonnement est actif et sont suspendues si l'abonnement expire ou est annulé.

💰 Commission personnalisée par forfait

Définissez un taux de commission spécifique pour chaque forfait, qui remplacera la commission globale de Listeo.

💵 Option paiement en espèces

Permettez aux clients de payer en espèces lors de leur visite. Aucune commande WooCommerce n'est créée.

• Le client choisit "Payer en espèces" sur la page de confirmation
• La réservation est créée directement sans passer par WooCommerce
• Message personnalisable pour expliquer le fonctionnement

💰 Configuration Acompte (Dépôt) NOUVEAU

Permettez aux vendeurs de personnaliser le pourcentage d'acompte sur leurs annonces. Cette fonctionnalité nécessite Prepaid Booking for Listeo.

• Les vendeurs avec ce package verront le bouton 💰 "Acompte" sur leur page Mes Annonces
• Ils pourront définir un pourcentage d'acompte personnalisé pour chaque annonce
• Les vendeurs sans cette option dans leur package utiliseront le pourcentage global défini par l'admin

⏰ Période d'essai gratuite

Attirez de nouveaux vendeurs avec une période d'essai gratuite avant la première facturation.

• Définissez le nombre de jours d'essai (ex: 14 jours)
• Le client a accès complet pendant l'essai
• Facturation automatique à la fin de l'essai

📸 Snapshot forfait (protection des abonnés)

Les paramètres du forfait sont figés au moment de l'achat. Si vous modifiez un forfait ultérieurement, les abonnés existants gardent leurs conditions d'origine.

💳 Stripe Billing

Lors de la synchronisation, le système crée automatiquement :

• Product - Produit Stripe lié au forfait
• Price (mensuel) - Prix récurrent mensuel
• Price (annuel) - Prix récurrent annuel

🅿️ PayPal Subscriptions

Lors de la synchronisation, le système crée automatiquement :

• Product - Produit PayPal lié au forfait
• Plan (mensuel) - Plan d'abonnement mensuel
• Plan (annuel) - Plan d'abonnement annuel

⚠️ Important : Webhooks

Les webhooks sont essentiels pour le bon fonctionnement des abonnements. Consultez la section 8 pour le guide de configuration complet.

👨‍💼 Côté administrateur

👤 Côté vendeur

⚠️ Comportement lors d'un downgrade

Si un vendeur downgrade vers un forfait avec moins d'annonces autorisées, les annonces excédentaires sont suspendues (pas supprimées). Elles peuvent être réactivées si le vendeur upgrade à nouveau.

🛡️ Exclure les administrateurs de la désactivation NOUVEAU

Une option dans Paramètres → Annonces & Abonnements permet d'exclure les administrateurs de la suspension automatique des annonces.

➕ Création manuelle d'abonnements

L'administrateur peut créer des abonnements manuellement sans passer par un système de paiement. Utile pour :

• Offrir des abonnements gratuits ou promotionnels
• Migrer des vendeurs existants vers SFL
• Créer des abonnements en masse pour tous les vendeurs

🔄 Import depuis WooCommerce Subscriptions

Migrez vos abonnements WooCommerce Subscriptions vers SFL. Le système récupère :

📧 Notification d'expiration automatique

Les vendeurs avec un abonnement importé ou manuel reçoivent automatiquement un email de rappel avant l'expiration :

• Délai : 7 jours avant expiration (configurable)
• Contenu : Date d'expiration, lien pour renouveler, avertissement sur la suspension des annonces
• Anti-doublon : Un seul email envoyé par abonnement

❓ Le bouton "Configurer Abonnement" est désactivé

Vérifiez que vous avez activé au moins une passerelle d'abonnement (Stripe ou PayPal) dans les paramètres de Prepaid Booking for Listeo.

❓ Les forfaits ne s'affichent pas côté vendeur

Les forfaits doivent être synchronisés avec Stripe et/ou PayPal pour apparaître. Allez dans Packages et cliquez sur "Configurer Abonnement" pour chaque forfait.

❓ Les paiements récurrents ne fonctionnent pas

• Vérifiez que les webhooks Stripe/PayPal sont configurés
• Vérifiez les logs de webhook dans Stripe Dashboard
• Assurez-vous que votre site est en HTTPS

❓ Puis-je changer le prix d'un forfait existant ?

Oui, mais les abonnés existants gardent leur prix d'origine grâce au système de snapshot. Le nouveau prix s'applique uniquement aux nouveaux abonnés.

❓ Comment désactiver le plugin temporairement ?

Décochez "Activer le système d'abonnement" dans Paramètres. Listeo reviendra à son fonctionnement par défaut, et les abonnements existants resteront dans la base de données.

⚠️ Pourquoi les webhooks sont essentiels

Les webhooks permettent à Stripe et PayPal d'envoyer des notifications en temps réel à votre site. Sans eux, le plugin ne peut pas être informé des événements importants.

💳 Configurer le webhook Stripe

🅿️ Configurer le webhook PayPal

🔄 Système de secours automatique

Si aucun webhook n'est configuré, le plugin active automatiquement un système de synchronisation par cron (toutes les heures) pour vérifier le statut des abonnements auprès de Stripe/PayPal.

⚠️ Plugin requis : Invoice & TVA for Listeo

Pour activer la génération de factures, vous devez installer et activer le plugin Invoice & TVA for Listeo. Sans ce plugin, un message invitera les utilisateurs à l'obtenir.

💡 Comportement sans le plugin Invoice & TVA

Si le plugin Invoice & TVA for Listeo n'est pas installé ou activé, un clic sur le bouton "Facture" affichera une popup informative expliquant les fonctionnalités du plugin et proposant un lien pour l'obtenir.

🔧 Configurer le webhook 2Checkout

🔄 Renouvellement WiPay - Comment ça marche

v1.2.0 - 13/10/2026 NEW

• 🏪 Passerelles Vendeur (LPP) - Option "Allow custom gateways" dans les packages
• 💳 Contrôle Accès Vendeur - Les vendeurs avec ce package peuvent configurer leurs propres clés API
• 💰 Contrôle Acompte - Option pour désactiver les acomptes par package vendeur
• 🔗 Intégration LPP v1.7 - Communication bidirectionnelle avec Prepaid Booking
• 🛡️ Vérification Abonnement - LPP vérifie l'abonnement avant d'autoriser les passerelles vendeur

v1.1.1 - 03/01/2025

• ✅ Annulation WiPay - Même logique que Stripe/PayPal
• ✅ Affichage passerelles - 2Checkout et WiPay dans la liste packages
• ✅ Metabox synchronisation - Affiche 2Checkout et WiPay
• ✅ Badges gateway admin - Couleurs distinctes pour chaque passerelle
• ✅ Liens rapides - Accès aux dashboards 2Checkout et WiPay
• ✅ Bouton modifier paiement - Support 2Checkout

v1.1.0 - 03/01/2025 NOUVELLES PASSERELLES

• 🌴 Intégration WiPay (Caraïbes) - Trinidad, Jamaïque, Barbade (renouvellement manuel)
• 🌐 Intégration 2Checkout (International) - 200+ pays, renouvellement automatique
• 🔄 Synchronisation 2Checkout - Création automatique des produits et prix
• 🔔 Webhooks 2Checkout IPN - Gestion des événements de paiement
• 🔘 Bouton de renouvellement WiPay - Affiché 7 jours avant expiration
• 💳 Nouveaux boutons checkout - WiPay et 2Checkout sur la page de paiement

v1.0.0 - 26/12/2024 VERSION INITIALE

• 🎉 Première version du plugin
• 💳 Intégration Stripe Billing native - Abonnements sans WooCommerce Subscriptions
• 🅿️ Intégration PayPal Subscriptions native - Support complet PayPal
• 🔄 Synchronisation automatique - Produits et prix Stripe/PayPal
• 📊 Dashboard admin complet - Statistiques MRR, ARR, churn
• 👤 Interface vendeur - Page "Mon Abonnement" intégrée
• 💰 Commission par forfait - Taux personnalisé pour chaque plan
• 💵 Paiement en espèces - Option cash pour les réservations
• ⏰ Période d'essai - Jours gratuits avant facturation
• 📸 Snapshot forfait - Protection des paramètres à l'achat
• 🔄 Changement de forfait - Upgrade/downgrade depuis le dashboard
• 💳 Modification paiement - Changer de carte via Stripe Portal
• 📖 Documentation complète - Guide d'utilisation intégré

🌍 Langues incluses par défaut

➕ Comment ajouter une nouvelle langue avec Loco Translate

📁 Structure des fichiers de traduction

languages/
├── subscription-for-listeo.pot      ← Template (source pour nouvelles traductions)
├── subscription-for-listeo-fr_FR.po ← Français (fichier éditable)
├── subscription-for-listeo-fr_FR.mo ← Français (compilé)
├── subscription-for-listeo-en_US.po ← Anglais (fichier éditable)
└── subscription-for-listeo-en_US.mo ← Anglais (compilé)

📍 Emplacements de stockage des traductions

Le plugin recherche les traductions dans l'ordre suivant :

1. wp-content/languages/plugins/ - Emplacement recommandé par Loco (préservé lors des mises à jour)
2. wp-content/plugins/subscription-for-listeo/languages/ - Dossier du plugin (inclus dans le package)

✨ Détection automatique des langues

Les nouvelles langues créées avec Loco Translate sont automatiquement détectées et apparaissent dans le sélecteur de langue des paramètres du plugin. Aucune configuration supplémentaire n'est nécessaire.