halal.txt : référencer son site dans l'annuaire Halal, de A à Z
Ce guide s'adresse aux commerçants et aux responsables de sites qui veulent apparaître dans l'annuaire Halal d'Intisab lil-Islam. Le principe : vous déposez un petit fichier texte, halal.txt, à la racine de votre site. Il décrit votre activité, votre adresse, votre certification et les pays que vous servez. Vous nous donnez l'adresse de votre site, un agent le visite, et s'il correspond à votre déclaration il entre dans l'annuaire, sans formulaire et sans attente.
Comptez dix minutes. Il faut seulement pouvoir déposer un fichier sur votre site.
En bref
- A. Écrivez votre fichier halal.txt à partir du modèle.
- B. Déposez-le à la racine de votre site, en https.
- C. Vérifiez qu'il s'affiche dans votre navigateur.
- D. Déclarez votre site sur intisablilislam.com.
- E. L'agent visite votre site et rend sa décision.
- F. Votre fiche est contrôlée toutes les 24 heures ; vous la modifiez en modifiant le fichier.
A. Écrire le fichier
Ouvrez un éditeur de texte simple (Bloc-notes sous Windows, TextEdit en « texte brut » sous Mac, ou l'éditeur de votre hébergeur). N'utilisez pas Word : le fichier doit être du texte brut, enregistré en UTF-8, et s'appeler exactement halal.txt, en minuscules.
Une information par ligne, sous la forme « Champ: valeur ». Les lignes qui commencent par # sont des commentaires, ignorés. Copiez ce modèle et remplacez les valeurs par les vôtres :
# halal.txt — à déposer à la racine de votre site : https://votre-site.example/halal.txt
# Une ligne par information, « Champ: valeur ». Les lignes qui commencent par # sont ignorées.
# Référencement : https://intisablilislam.com/halal-txt/
Name: Boucherie Al-Baraka
Description: Boucherie traditionnelle, viande et volaille certifiées, livraison à domicile.
Category: Boucherie
# Catégories : Alimentation, Boucherie, Restaurant, Commerce, Mode, Cosmétique, Santé, Éducation, Finance, Voyage, Technologie, Services, Autre
# Où vous trouver (sert à vous proposer aux personnes proches de chez vous).
# Seul le pays est obligatoire : un site sans boutique peut omettre la ville, l'adresse et la position.
Country: FR
City: Nancy
Postal-Code: 54000
Address: 12 rue de la République
Latitude: 48.6921
Longitude: 6.1844
# Qui vous servez
Languages: fr, ar
Delivery: FR, BE, LU
# « Delivery » : codes des pays livrés, ou « local » si vous ne livrez pas, ou « monde »
# Votre certification (laissez vide si vous n'en avez pas : ne déclarez rien que vous ne puissiez prouver)
Certifier: AVS
Certificate: https://votre-site.example/certificat-halal.pdf
Products: bœuf, agneau, volaille, charcuterie
Contact: [email protected]
Phone: +33 3 00 00 00 00
Opening-Hours: mardi-dimanche 9h-19h
Vous pouvez aussi télécharger ce modèle depuis la fenêtre « Référencer mon site Halal » du site, lien « Télécharger un modèle à remplir ».
Les champs
| Champ | Obligatoire | Ce qu'il faut écrire |
|---|---|---|
| Name | oui | Le nom de votre commerce ou de votre site (100 caractères au plus). |
| Description | oui | Une ou deux phrases qui disent ce que vous faites (300 caractères au plus). |
| Category | oui | Une seule, parmi : Alimentation, Boucherie, Restaurant, Commerce, Mode, Cosmétique, Santé, Éducation, Finance, Voyage, Technologie, Services, Autre. |
| Country | oui | Le code de votre pays, sur deux lettres : FR, BE, CH, CA, MA, DZ, TN, SN… |
| City | non | Votre ville. À omettre si vous n'avez pas de boutique. |
| Address, Postal-Code, Region | non | L'adresse de votre point de vente. |
| Latitude, Longitude | non | Votre position en degrés décimaux, par exemple 48.6921 et 6.1844. Les deux vont ensemble. Elles servent à vous proposer aux personnes proches de chez vous. |
| Languages | non | Les langues dans lesquelles vous servez vos clients, séparées par des virgules : fr, ar, en… |
| Delivery | non | Les pays que vous livrez (FR, BE, LU…), ou « local » si vous ne livrez pas, ou « monde ». |
| Certifier | non | Le nom de l'organisme qui vous certifie. |
| Certificate | non | Le numéro de votre certificat, ou l'adresse https où on peut le voir. |
| Products | non | Vos produits ou services, séparés par des virgules. C'est sur eux que porte la recherche. |
| Contact, Phone, Opening-Hours | non | Pour vous joindre. |
Pour trouver votre latitude et votre longitude : sur une carte en ligne, faites un clic droit sur votre boutique ; les deux nombres s'affichent. Écrivez-les avec un point, pas une virgule.
Ne déclarez que ce que vous pouvez prouver. Si vous nommez un certificateur, il doit être visible sur votre site (logo, numéro, page dédiée). Un certificateur déclaré mais introuvable sur le site entraîne un refus. Si vous n'êtes pas certifié, laissez ces deux lignes de côté : vous pouvez être référencé sans elles.
B. Déposer le fichier sur votre site
Le fichier doit répondre à l'adresse https://votre-site.com/halal.txt. Si vous ne pouvez pas écrire à la racine, l'adresse https://votre-site.com/.well-known/halal.txt est acceptée aussi.
- Hébergement classique (OVH, o2switch, Hostinger, Infomaniak…) : avec le gestionnaire de fichiers de votre hébergeur ou un logiciel FTP, déposez halal.txt dans le dossier où se trouve la page d'accueil de votre site (souvent « www » ou « public_html »).
- WordPress : même dossier, celui qui contient wp-config.php. Une extension de gestion de fichiers fait l'affaire si vous n'avez pas d'accès FTP. La médiathèque ne convient pas : elle range les fichiers dans un sous-dossier.
- Site fait à la main ou par un développeur : placez le fichier dans le dossier des fichiers publics, à côté de robots.txt.
- Shopify, Wix, Squarespace et plates-formes fermées : elles ne permettent en général pas de déposer un fichier à la racine. Dans ce cas, utilisez le formulaire classique de la même fenêtre : votre site sera examiné à la main.
C. Vérifier que le fichier s'affiche
Ouvrez https://votre-site.com/halal.txt dans votre navigateur. Vous devez voir le texte de votre fichier, tel que vous l'avez écrit. Si vous voyez votre page d'accueil, une page d'erreur ou un téléchargement illisible, le fichier n'est pas au bon endroit ou n'est pas du texte brut.
Exemple réel : ce site a son propre fichier, que vous pouvez regarder.
- Le halal.txt de intisablilislam.com un fichier réel, sans boutique : pas de ville ni de position
D. Déclarer votre site
- Allez sur intisablilislam.com et cliquez sur « Référencer mon site Halal » (sous la barre de recherche, ou en bas de page).
- Dans le cadre « Référencement automatique avec halal.txt », saisissez l'adresse de votre site, par exemple https://votre-site.com.
- Cliquez sur « Vérifier mon fichier ». Vous n'avez rien d'autre à remplir : tout vient du fichier.
Si le fichier est lu et valide, le message « Fichier lu et valide. L'agent visite votre site » s'affiche. Sinon, le message dit précisément ce qu'il faut corriger (voir le tableau plus bas).
E. La vérification par l'agent
Un agent visite votre site dans les minutes qui suivent. Il lit vos pages et vérifie qu'elles correspondent à ce que le fichier déclare : la même activité, les mêmes produits, le certificateur nommé s'il y en a un. Il rend l'une de ces décisions :
- Approuvé : votre site est dans l'annuaire et peut être proposé aux visiteurs.
- Refusé : la raison est donnée. Corrigez votre site ou votre fichier, puis déclarez-le de nouveau.
- En attente : l'agent n'a pas pu répondre. Rien n'est validé par défaut ; le contrôle suivant le relance automatiquement.
Pour connaître l'état de votre fiche à tout moment, refaites l'étape D : la réponse vous donne la décision en cours.
F. Ensuite : contrôles et mises à jour
- Toutes les 24 heures, nous relisons votre fichier. S'il ne répond pas trois jours de suite, votre site n'est plus proposé. Il revient de lui-même dès qu'il répond à nouveau : vous n'avez rien à redemander.
- Tous les 7 jours, l'agent revisite votre site.
- Pour modifier votre fiche (nouvelle adresse, nouveaux produits, nouvel horaire), modifiez simplement halal.txt sur votre site. Le changement est pris au contrôle suivant, et l'agent revérifie.
- Pour vous retirer, supprimez le fichier de votre site.
Comment vous êtes proposé aux visiteurs
Quand une personne cherche un produit, les sites sont classés pour elle : les plus proches d'abord si elle a partagé sa position et que vous avez indiqué la vôtre, puis ceux qui livrent son pays, puis ceux qui parlent sa langue. Remplir Latitude, Longitude, Delivery et Languages vous rend donc plus visible. La position du visiteur n'est pas enregistrée.
Les messages d'erreur et leur remède
| Message | Cause | Remède |
|---|---|---|
| Aucun fichier halal.txt trouvé à la racine du site. | Le fichier n'est pas à l'adresse attendue, ou porte un autre nom. | Vérifiez l'étape C. Le nom est halal.txt, en minuscules. |
| L'adresse halal.txt rend une page web, pas un fichier texte. | Votre site renvoie sa page d'accueil ou une page d'erreur à cette adresse. | Le fichier n'est pas au bon endroit : déposez-le à la racine. |
| L'adresse doit être en https, sans port ni identifiant. | Votre site n'est pas en https, ou l'adresse contient un port. | Activez le https chez votre hébergeur, et donnez l'adresse simple du site. |
| Le fichier redirige vers un autre site. | L'adresse renvoie vers un autre nom de domaine. | Déclarez l'adresse définitive de votre site, celle où le fichier se trouve vraiment. |
| Le fichier halal.txt est trop gros (16 Ko au plus). | Le fichier dépasse 16 Ko. | Gardez l'essentiel : un fichier normal fait moins de 2 Ko. |
| halal.txt à corriger : champ obligatoire absent… | Il manque Name, Description, Category ou Country. | Ajoutez la ligne manquante. |
| Category inconnue | La catégorie n'est pas dans la liste. | Choisissez-en une de la liste, écrite telle quelle. |
| Country : code de pays à deux lettres attendu | Vous avez écrit le nom du pays. | Écrivez FR et non France. |
| Latitude / Longitude : nombres décimaux attendus | Format de position non reconnu, ou une seule des deux lignes. | Deux lignes, des nombres avec un point : 48.6921 et 6.1844. |
| Ce nom de domaine ne mène pas à un site public. | L'adresse n'existe pas sur Internet ou mène à un réseau privé. | Vérifiez l'orthographe de votre nom de domaine. |
| Le site ne répond pas | Votre site était injoignable au moment de l'essai. | Réessayez un peu plus tard. |
| Trop d'essais. Réessayez dans une heure. | Plus de six déclarations en une heure. | Corrigez tranquillement votre fichier, puis réessayez. |
Les règles techniques
- Le fichier est lu en https uniquement, sur le port habituel.
- Il doit être du texte brut ; 16 Ko au plus.
- Une redirection n'est suivie que vers le même site (par exemple de votre-site.com vers www.votre-site.com).
- Notre robot s'annonce sous le nom IntisabAnnuaire. Si votre site bloque les robots inconnus, autorisez-le pour l'adresse /halal.txt.
- Les champs inconnus sont ignorés : une faute de frappe dans un nom de champ fait perdre la ligne, sans erreur.
Ce que l'annuaire affirme, et ce qu'il n'affirme pas
Une fiche dit : ce site se déclare Halal, il nomme tel certificateur, et son contenu correspond à sa déclaration. L'annuaire ne certifie aucun produit lui-même et ne remplace pas un organisme de certification. Le visiteur est invité à vérifier le certificat auprès de l'organisme nommé.
Questions fréquentes
Est-ce payant ?
Non.
Faut-il être certifié ?
Non. Sans certificat, laissez les lignes Certifier et Certificate de côté. Votre site doit en revanche correspondre clairement à ce que vous déclarez.
Combien de temps pour apparaître ?
Quelques minutes après la déclaration quand l'agent répond. S'il ne répond pas, la fiche reste en attente jusqu'au contrôle suivant.
Puis-je déclarer plusieurs boutiques ?
Un fichier décrit un site et une adresse. Pour plusieurs boutiques, indiquez la principale et citez les autres dans Description.
Mon site a été refusé à tort.
Lisez la raison donnée, corrigez ce qui prête à confusion sur votre site ou dans le fichier, puis déclarez-le de nouveau.