DigitalPaye — Online Donations releases

=== Digitalpaye — Don en ligne === Contributors: digitalpaye Tags: donation, donations, payment, mobile money, orange money, mtn money, moov money, digitalpaye, africa Requires at least: 5.8 Tested up to: 6.8 Requires PHP: 7.4 Stable tag: 1.0.1 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html

== Description ==

Digitalpaye — Don en ligne est un plugin WordPress permettant de collecter des dons en ligne via Mobile Money en Côte d'Ivoire.

Le plugin intègre les paiements Orange Money, MTN Mobile Money et Moov Money (Flooz) grâce à l'API Digitalpaye.

Il permet aux associations, ONG, entreprises et créateurs de recevoir des dons sécurisés directement depuis leur site WordPress.

Fonctionnalités principales :

• Paiements Mobile Money via Digitalpaye
• Support Orange Money, MTN Mobile Money et Moov Money
• Formulaire de don personnalisable
• Montants prédéfinis ou montant libre
• Option de don anonyme
• Objectif de collecte avec progression
• Liste des donateurs récents
• Confirmation par e-mail
• Tableau de bord administrateur
• Vérification automatique des transactions
• Webhooks sécurisés
• Mode Sandbox et production

== Prérequis ==

• WordPress 5.8 ou supérieur
• PHP 7.4 ou supérieur
• Compte marchand Digitalpaye actif
• Clé API Digitalpaye
• Secret API Digitalpaye
• HTTPS recommandé

== Installation ==

1. Téléchargez le fichier ZIP du plugin.
2. Dans votre administration WordPress, allez dans : Extensions > Ajouter > Téléverser une extension.
3. Sélectionnez le fichier ZIP.
4. Activez l'extension : Digitalpaye — Don en ligne.
5. Allez dans : Digitalpaye Don > Paramètres.
6. Configurez vos identifiants API Digitalpaye.

== Configuration ==

Après activation du plugin, configurez :

• Clé API : Votre clé publique fournie par Digitalpaye.

• Secret API : Votre clé privée permettant l'authentification auprès de l'API.

• Secret Webhook : Permet de vérifier les notifications de paiement entrantes.

• Mode Sandbox : Permet de tester les paiements avant la mise en production.

• Email administrateur : Adresse recevant les notifications de dons.

L'URL webhook à configurer dans votre tableau de bord Digitalpaye :

https://votre-site.com/wp-admin/admin-ajax.php?action=dp_don_webhook

== Utilisation ==

Ajoutez un formulaire de don dans une page ou un article avec le shortcode :

[digitalpaye_don]

Exemple avec paramètres personnalisés :

[digitalpaye_don title="Soutenez notre projet" subtitle="Votre aide fait la différence" amounts="1000,5000,10000" default_amount="5000" cause="education" objectif="500000" button_text="Faire un don"]

== Shortcodes ==

= Formulaire de don =

[digitalpaye_don]

= Objectif de collecte =

[dp_don_objectif cause="education" objectif="500000" titre="Objectif de collecte"]

= Liste des donateurs récents =

[dp_don_recents cause="education" limite="5"]

== Fonctionnement technique ==

Le plugin communique avec l'API Digitalpaye pour :

1. Authentifier le marchand.
2. Créer une transaction de collecte.
3. Vérifier le statut du paiement.
4. Recevoir les notifications via webhook.

Les transactions sont enregistrées dans une table WordPress dédiée :

{prefix}_dp_donations

== Sécurité ==

Le plugin applique les bonnes pratiques WordPress :

• Protection des requêtes AJAX avec nonce.
• Validation et nettoyage des données utilisateurs.
• Protection contre les requêtes non autorisées.
• Vérification HMAC des webhooks.
• Protection des clés API.
• Utilisation des fonctions natives WordPress.

== Structure du plugin ==

digitalpaye-donations/

├── digitalpaye-donations.php ├── includes/ │ ├── class-dp-don-api.php │ ├── class-dp-don-db.php │ ├── class-dp-don-admin.php │ └── class-dp-don-form.php ├── assets/ │ ├── css/ │ ├── js/ │ └── images/ └── readme.txt

== Frequently Asked Questions ==

= Quels moyens de paiement sont supportés ? =

Le plugin supporte Orange Money, MTN Mobile Money et Moov Money via Digitalpaye.

= Est-ce compatible avec tous les thèmes WordPress ? =

Oui. Le formulaire utilise un shortcode compatible avec la majorité des thèmes WordPress.

= Le mode test est-il disponible ? =

Oui. Le plugin propose un mode Sandbox pour tester l'intégration.

= Ai-je besoin d'un compte Digitalpaye ? =

Oui. Un compte marchand Digitalpaye est nécessaire pour recevoir des paiements.

== Changelog ==

= 1.0.0 =

• Première version publique.
• Intégration de l'API Digitalpaye.
• Support Orange Money, MTN Mobile Money et Moov Money.
• Ajout des formulaires de dons.
• Ajout du tableau de bord administrateur.
• Ajout du système webhook.
• Ajout des notifications email.

== Upgrade Notice ==

= 1.0.0 = Première version officielle de Digitalpaye — Don en ligne.

== License ==

This plugin is licensed under the GPLv2 or later.

License URI: https://www.gnu.org/licenses/gpl-2.0.html

== Credits ==

Developed by Digitalpaye Inc.

Website: https://digitalpaye.com

Plugin repository: https://github.com/Digitalpaye-Inc/Digitalpaye-wordpress-donate