Blog

🤝 Contribuer à QuiHébergeLesMails
QuiHébergeLesMails recense déjà des dizaines d'hébergeurs, mais il en manque forcément ! Que vous soyez développeur aguerri ou novice curieux, ajouter un hébergeur à la liste est simple et rapide. Voici comment participer à ce projet open source en quelques minutes.
Première contribution open source ? Parfait, c'est l'occasion d'apprendre ! 🎓
📋 Ce dont vous avez besoin
- Un compte GitLab (gratuit)
- Le nom et le logo de l'hébergeur à ajouter
- 10 à 15 minutes de votre temps
🚀 Les grandes étapes
1. Préparer les fichiers
Le logo :
- Format : PNG ou SVG
- Taille recommandée : environ 200x200px
- À placer dans le dossier : /static/logos/
- Nommage du type : logo_nomdelhebergeur.png
Le code JSON : Ajoutez une entrée dans le fichier data/host_keywords.json en suivant ce modèle :
"identifiant": {
"name": "Nom de l'hébergeur - Pays 🇫🇷",
"logo": "/static/logos/logo_nomdelhebergeur.png"
},Exemple concret :
"zoho": {
"name": "Zoho - Entreprise américaine 🇺🇸",
"logo": "/static/logos/logo_zoho.png"
},Note : Gardez la virgule après `}` sauf si c'est le dernier hébergeur du fichier.
2. Faire votre contribution sur GitLab
Quelques termes à connaître :
- Fork / Bifurcation : faire une copie du projet sur votre compte pour travailler dessus
- Merge Request (MR) / Requêtes de fusion : proposer vos modifications au projet principal
- Issue / Tickets : signaler un problème ou poser une question
Les étapes :
1. Se rendre à la page : https://gitlab.com/jp.louvel/qui-heberge-les-mails
2. Forkez le projet : cliquez sur le bouton "Fork" en haut à droite et suivre les instructions
3. Ajoutez le logo dans /static/logos/ (vous pouvez le faire directement depuis l'interface web)
4. Modifiez le fichier data/host_keywords.json en ajoutant les 4 lignes correspondant à hébergeur (Modifier > Modifier le fichier unique). Classer les hébergeurs par pays.
5. Créez une Merge Request avec un titre clair comme "Ajout de l'hébergeur [Nom]"
3. Validation de l'ajout
Nous vérifierons que l'hébergeur existe et que les fichiers sont bons, puis on merge. Vous recevrez une notification.
❓ Besoin d'aide ?
- Première contribution ? C'est normal d'être perdu, posez vos questions en créant une issue !
- Problème technique ? Ouvrez une issue, on vous aide
✅ Critères d'acceptation
- L'hébergeur doit être actif et accessible au public
- Le logo doit être de bonne qualité
- Pas de spam ou faux hébergeurs
Merci de participer à un web plus transparent ! 🎉
