Intisab lil-Islam

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. É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

ChampObligatoireCe qu'il faut écrire
NameouiLe nom de votre commerce ou de votre site (100 caractères au plus).
DescriptionouiUne ou deux phrases qui disent ce que vous faites (300 caractères au plus).
CategoryouiUne seule, parmi : Alimentation, Boucherie, Restaurant, Commerce, Mode, Cosmétique, Santé, Éducation, Finance, Voyage, Technologie, Services, Autre.
CountryouiLe code de votre pays, sur deux lettres : FR, BE, CH, CA, MA, DZ, TN, SN…
CitynonVotre ville. À omettre si vous n'avez pas de boutique.
Address, Postal-Code, RegionnonL'adresse de votre point de vente.
Latitude, LongitudenonVotre 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.
LanguagesnonLes langues dans lesquelles vous servez vos clients, séparées par des virgules : fr, ar, en…
DeliverynonLes pays que vous livrez (FR, BE, LU…), ou « local » si vous ne livrez pas, ou « monde ».
CertifiernonLe nom de l'organisme qui vous certifie.
CertificatenonLe numéro de votre certificat, ou l'adresse https où on peut le voir.
ProductsnonVos produits ou services, séparés par des virgules. C'est sur eux que porte la recherche.
Contact, Phone, Opening-HoursnonPour 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.

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.

D. Déclarer votre site

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 :

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

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

MessageCauseRemè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 inconnueLa catégorie n'est pas dans la liste.Choisissez-en une de la liste, écrite telle quelle.
Country : code de pays à deux lettres attenduVous avez écrit le nom du pays.Écrivez FR et non France.
Latitude / Longitude : nombres décimaux attendusFormat 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 pasVotre 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

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.

Référencer mon site