feat: add PayPal donation

README.adoc

@@ -23,6 +23,9 @@ kaubuntu.re est une interface web responsive qui permet de consulter et recherch
 - 🌐 Mode hors ligne avec cache intelligent
 - 📡 Détection automatique d'état de connexion
 - 📊 Analytics intégré avec Plausible (respectueux de la vie privée)
+- 📰 *Intégration WordPress* : Affichage des articles depuis un site WordPress via REST API
+- 💝 *Système de dons* : Interface PayPal Me configurable pour collecter des dons
+- ⏰ *Système de countdown* : Page de lancement configurable avec compte à rebours multi-fuseaux
 
 == 🛠️ Technologies utilisées
 
@@ -154,6 +157,71 @@ cp mentions-legales.php.sample mentions-legales.php
 
 Ces fichiers sont listés dans le `.gitignore` afin que vos modifications ne soient pas suivies par Git, ce qui vous permet de personnaliser votre instance sans affecter le code source principal.
 
+== 💝 Système de dons
+
+kaubuntu.re intègre un système de dons configurable qui permet de collecter des contributions via PayPal Me.
+
+=== ✨ Fonctionnalités
+
+- 💳 *PayPal Me intégré* : Redirection sécurisée vers votre compte PayPal
+- 🎯 *Montants prédéfinis* : Boutons rapides avec montants suggérés
+- ✍️ *Montant personnalisé* : Champ libre pour des dons de montant libre
+- 🔒 *Sécurisé* : Validation stricte des URLs et protection XSS
+- 📱 *Responsive* : Interface optimisée mobile et desktop
+- 🎨 *Intégré* : Design cohérent avec la charte graphique du site
+- ♿ *Accessible* : Conforme aux standards d'accessibilité
+
+=== ⚙️ Configuration
+
+Pour activer le système de dons, ajoutez dans votre `config.local.php` :
+
+[source,php]
+----
+// Activer le système de dons
+define('DONATIONS_ENABLED', true);
+
+// URL PayPal Me (sans le montant)
+define('PAYPAL_ME_URL', 'https://www.paypal.com/paypalme/votre-compte');
+
+// Montants suggérés (optionnel)
+define('DONATION_AMOUNTS', [5, 10, 20, 50, 100]);
+
+// Devise (optionnel, EUR par défaut)
+define('DONATION_CURRENCY', 'EUR');
+----
+
+=== 📄 Personnalisation
+
+. Copiez le fichier sample pour créer votre page de dons :
++
+[source,bash]
+----
+cp dons.sample.php dons.php
+----
+
+. Personnalisez le contenu en remplaçant les placeholders :
+  * `[VOTRE ORGANISATION]` par le nom de votre organisation
+  * `[VOTRE CAUSE]` par votre cause/mission
+  * `[OBJECTIF X]` par vos objectifs spécifiques
+
+=== 🎯 Interface utilisateur
+
+Une fois activé, le système de dons ajoute :
+
+- 💝 *Icône cœur rouge* dans le header (sans cadre)
+- 📋 *Lien "Soutenir"* dans la sidebar
+- 📄 *Page dédiée* accessible via `/dons.php`
+
+=== 🔒 Sécurité
+
+Le système intègre plusieurs protections :
+
+- ✅ *Validation URL PayPal* : Seules les URLs PayPal Me valides sont acceptées
+- ✅ *Protection XSS* : Échappement de toutes les sorties utilisateur
+- ✅ *Validation montants* : Contrôle des montants min/max
+- ✅ *Headers sécurisés* : CSP et autres headers de sécurité
+- ✅ *Ouverture sécurisée* : Liens avec `noopener noreferrer`
+
 == 🛡️ Configuration de sécurité Apache
 
 Le fichier `conf/.htaccess.sample` fourni inclut des règles de sécurité importantes pour protéger votre installation :