L'application mobile LaraClassifier est une application native iOS et Android pour votre site LaraClassifier. Vos visiteurs consultent, recherchent, publient et gèrent des petites annonces depuis leur téléphone, avec les mêmes annonces, les mêmes comptes et les mêmes messages que sur le site.
L'application n'a pas de serveur à elle : tout passe par l'API REST de votre site LaraClassifier. Une annonce publiée depuis l'application apparaît sur le site, un message envoyé depuis le site apparaît dans l'application, et votre panneau d'administration pilote les deux.
Points forts
- Votre propre marque : le nom de l'application, ses identifiants dans les stores, ses couleurs, son icône et son écran de lancement se règlent dans un seul fichier,
brand.json. - 18 langues : anglais, allemand, arabe, bengali, chinois, espagnol, français, géorgien, hébreu, hindi, italien, japonais, portugais, roumain, russe, thaï, turc et ukrainien, avec une mise en page de droite à gauche pour l'arabe et l'hébreu.
- Un compte complet : publier et modifier des annonces avec photos et champs personnalisés, les mettre hors ligne, discuter avec les acheteurs, enregistrer des annonces, gérer les alertes de recherche et le profil.
- Modes clair et sombre, selon le réglage du téléphone ou le choix de l'utilisateur, et des écrans adaptés aux tablettes.
Pour connecter l'application à votre site, la personnaliser à votre marque et la publier dans les stores, lisez Publier l'application mobile sur Google Play et l'App Store.
Prérequis
Votre site
- LaraClassifier 19.1.13 ou plus récent. L'application utilise des points d'accès de l'API et des correctifs apparus dans cette version : mettez d'abord votre site à jour.
- HTTPS avec un certificat valide : iOS et Android bloquent les connexions HTTP simples dans les applications publiées.
- Le jeton d'API de votre site : la valeur
APP_API_TOKENdu fichier/.envde votre installation LaraClassifier. - Les réglages Mobile App de votre panneau d'administration (Panneau d'administration → Settings → Mobile App), utilisés pour les notifications push, la connexion Google et les liens vers l'application.
Votre ordinateur (pour construire l'application)
- Node.js 22.13 ou plus récent (la version LTS actuelle est conseillée) avec npm, sous Windows, macOS ou Linux.
- Un compte Expo gratuit (expo.dev). Les applications sont compilées dans le cloud par Expo (EAS Build) : ni Xcode ni Android Studio ne sont nécessaires.
Pour publier
- Un compte Google Play Console (frais d'inscription uniques) pour Android.
- Une adhésion à l'Apple Developer Program (abonnement annuel) pour iOS.
Contenu du package
| Fichier ou dossier | Contenu |
|---|---|
brand.json | Le nom de l'application, ses identifiants dans les stores, sa version, ses couleurs et ses fichiers d'icône. C'est le seul fichier à modifier pour mettre l'application à vos couleurs. |
.env.example | Modèle des réglages de connexion (adresse et jeton de l'API de votre site), à copier dans .env.local. |
assets/brand/ | Icône de l'application, icône adaptative Android, image de lancement et favicon d'exemple, à remplacer par les vôtres. |
src/ | Le code source de l'application (TypeScript, React Native, Expo), avec ses textes en 18 langues dans src/i18n/locales/. |
app.config.ts, eas.json | Configuration de compilation, générée à partir de brand.json. En temps normal, vous n'avez pas à les modifier. |
docs/ | La documentation complète de l'application, à ouvrir dans votre navigateur. |
L'essayer sur votre téléphone
En quelques minutes, vous pouvez lancer l'application sur votre propre téléphone, connectée à votre site :
- Décompressez le package et ouvrez un terminal dans le dossier de l'application.
- Installez les dépendances avec
npm install. - Copiez
.env.examplevers.env.localet indiquez l'adresse et le jeton de l'API de votre site :EXPO_PUBLIC_API_URL=https://www.your-website.com/api EXPO_PUBLIC_API_TOKEN=your-app-api-token - Démarrez l'application avec
npx expo start. - Installez Expo Go sur votre téléphone (App Store ou Google Play), connectez-vous avec votre compte Expo et scannez le QR code affiché dans le terminal.
localhost ou domaine local), votre téléphone ne peut pas l'atteindre directement : voyez la partie « Tester avec un site installé sur votre ordinateur » de l'article sur la publication.
Navigation et recherche
Cinq onglets se trouvent en bas de l'écran : Accueil, Recherche, Vendre (le bouton central), Messages et Compte. Consulter et rechercher des annonces ne nécessite pas de compte.
Accueil
- Sélecteur de pays (en haut à gauche) : les annonces, les villes et les prix suivent le pays choisi, parmi les pays activés dans votre panneau d'administration.
- Barre de recherche : ouvre l'onglet Recherche.
- Catégories : les catégories principales de votre site, avec les icônes définies dans le panneau d'administration. Tout affiche la liste complète avec les sous-catégories.
- À la une : les annonces premium (mises en avant).
- Nouvelles annonces : les dernières annonces, chargées page par page au fil du défilement. Tirez vers le bas pour actualiser.
Recherche et filtres
Les résultats s'actualisent pendant la saisie. Filtres disponibles :
- Catégorie et sous-catégorie.
- Lieu : une ville du pays choisi, retrouvée par son nom.
- Prix : minimum et maximum.
- Tri : pertinence, plus récentes, prix croissant ou prix décroissant.
L'icône en forme de cœur sur chaque résultat enregistre l'annonce (l'utilisateur est invité à se connecter si besoin).
Page d'une annonce
- Carrousel de photos, prix, mention Négociable, titre, ville, date et nombre de vues.
- Les champs personnalisés de l'annonce (tels que configurés par catégorie dans le panneau d'administration) et sa description.
- Le vendeur, avec un lien vers toutes ses annonces, et un conseil de sécurité.
- Écrire au vendeur ouvre un formulaire avec des réponses rapides (les visiteurs non connectés indiquent leur nom et leur e-mail). Appeler s'affiche quand le vendeur n'a pas masqué son numéro.
- Partage, enregistrement et annonces similaires, ainsi que Signaler et Bloquer le vendeur.
- Sur ses propres annonces, l'utilisateur voit à la place Modifier l'annonce et Gérer.
Connexion et compte
- Se connecter ou créer un compte avec une adresse e-mail, ou avec un numéro de téléphone si votre site le permet (option phone as authentication field des réglages SMS).
- Continuer avec Google et Continuer avec Facebook s'affichent quand ces fournisseurs sont activés sur votre site et configurés dans l'application.
- Mot de passe oublié : les comptes e-mail reçoivent un lien de réinitialisation (qui ouvre votre site) ; les comptes téléphone reçoivent un code par SMS et choisissent leur nouveau mot de passe dans l'application.
- Vérification : si votre site exige un e-mail ou un téléphone confirmé, l'application affiche l'étape suivante (un code à saisir pour un téléphone, un lien à ouvrir pour un e-mail) avec un bouton renvoyer. Les visiteurs qui publient une annonce sans compte passent par la même étape.
- Vérification en deux étapes : les utilisateurs qui l'ont activée sur leur compte saisissent le code reçu après leur mot de passe.
- La création d'un compte impose d'accepter les conditions d'utilisation et la politique de confidentialité, qui ouvrent les pages de type Terms et Privacy de votre site. La section À propos de l'onglet Compte renvoie vers ces mêmes pages.
- L'onglet Compte affiche les statistiques de l'utilisateur (annonces en ligne, nombre total de vues, messages non lus) et donne accès à toutes les pages du compte.
- Modifier le profil : nom, e-mail, téléphone, photo, et option pour masquer le numéro sur les annonces. Changer le mot de passe demande le mot de passe actuel.
- Supprimer mon compte : supprime définitivement le compte après confirmation (exigé par l'App Store et Google Play).
- Se connecter dans l'application déconnecte l'utilisateur de l'application sur ses autres appareils. Sa session sur le site n'est pas touchée.
Notifications et liens
- Notifications push : nouveaux messages, annonce approuvée ou expirée, paiements et modifications du compte, une fois le push activé dans Panneau d'administration → Settings → Mobile App. Toucher une notification ouvre la conversation ou l'annonce. Les utilisateurs choisissent les types de notifications reçues dans les préférences de leur compte sur le site, comme pour les e-mails.
- Liens vers votre site : un lien vers l'une de vos annonces (partagé par e-mail, messagerie ou réseau social) s'ouvre directement dans l'application quand elle est installée.
Ces deux fonctions demandent quelques réglages de votre part : voir Application mobile : notifications push, connexion sociale et liens vers l'application.
Publier une annonce
Le bouton central Vendre ouvre un formulaire en 3 étapes :
- Photos et titre : photos de la galerie du téléphone (la première sert de couverture), titre, catégorie, et type de vendeur (particulier ou professionnel) si votre site l'affiche. Les photos sont redimensionnées et compressées sur le téléphone pour respecter la taille maximale des images de votre site.
- Détails : prix, Ouvert aux offres, description, et champs personnalisés de la catégorie choisie.
- Lieu et contact : ville, nom, e-mail et téléphone facultatif. Les visiteurs sans compte acceptent aussi les conditions d'utilisation.
Quand votre site refuse une valeur (un titre trop court, par exemple), l'erreur s'affiche à côté du champ et le formulaire revient à l'étape concernée. Selon vos réglages, la nouvelle annonce est publiée immédiatement ou après validation. Les visiteurs sans compte peuvent publier si votre site l'autorise.
Gérer ses annonces
Compte → Mes annonces comporte trois onglets : En ligne, En validation et Archivées. Le bouton … de chaque annonce propose ces actions :
| Action | Disponible pour | Résultat |
|---|---|---|
| Voir l'annonce | Toutes | Ouvre la page de l'annonce. |
| Modifier | Toutes | Le formulaire de publication avec tous ses champs préremplis. Les photos ajoutées ou retirées sont enregistrées immédiatement. |
| Mettre hors ligne | En ligne | Masque l'annonce, qui passe dans Archivées. |
| Remettre en ligne | Archivées | Publie à nouveau l'annonce. |
| Promouvoir | En ligne, En validation (Android uniquement) | Ouvre la page de promotion de votre site, utilisateur déjà connecté, pour choisir une offre premium et payer avec vos add-ons de paiement. |
| Supprimer | Toutes | Supprime définitivement l'annonce, après confirmation. |
Annonces enregistrées
L'icône en forme de cœur enregistre une annonce. Compte → Annonces enregistrées (ou le cœur en haut de l'onglet Accueil) affiche les annonces enregistrées du pays choisi ; toucher à nouveau le cœur en retire une. Les annonces enregistrées sont partagées avec le site.
Messages
- L'onglet Messages liste les conversations, avec les filtres Tous, Non lus et Importants. Les conversations non lues portent un point bleu.
- Une conversation affiche ses messages et un champ de réponse. Tant qu'elle est ouverte, les nouveaux messages sont récupérés toutes les 15 secondes.
- Un appui long sur une conversation (ou le bouton ⋮ à l'intérieur) la marque comme lue, non lue ou importante, ou la supprime.
Les utilisateurs sont prévenus des nouveaux messages par notification push (si elle est activée) et par e-mail, selon la configuration de votre site.
Alertes de recherche
Compte → Alertes de recherche liste les recherches que l'utilisateur a enregistrées sur le site. En toucher une lance la recherche dans l'application ; l'icône de corbeille la supprime.
Signalement et blocage
L'App Store et Google Play exigent ces outils dans les applications qui publient du contenu créé par les utilisateurs :
- Signaler (page d'une annonce) : l'utilisateur choisit un motif (les types de signalement de votre panneau d'administration), ajoute des précisions et envoie le signalement à votre site, qui vous prévient comme pour un signalement fait sur le site.
- Bloquer le vendeur (page d'une annonce) et Bloquer cet utilisateur (options d'une conversation) : les annonces, annonces enregistrées et conversations de l'utilisateur bloqué sont masquées pour la personne qui l'a bloqué. Compte → Utilisateurs bloqués les liste, avec un bouton Débloquer.
Langue, pays et apparence
- Langue (Compte → Préférences) : Comme l'appareil par défaut, ou toute langue activée sur votre site. Les textes de l'application et le contenu envoyé par votre site (noms des catégories, messages) changent tous les deux. Pour l'arabe et l'hébreu, la mise en page passe de droite à gauche après le redémarrage de l'application.
- Pays : change les annonces, les villes et les prix affichés.
- Apparence : comme l'appareil, clair ou sombre.
Une langue activée sur votre site mais non traduite dans l'application affiche les textes de l'application en anglais, et le contenu de votre site dans cette langue.
Réglages du panneau d'administration utilisés par l'application
L'application suit les réglages de votre panneau d'administration. Les modifier ne demande jamais de mise à jour de l'application :
| Réglage du panneau d'administration | Effet dans l'application |
|---|---|
| Pays, villes, catégories, icônes des catégories, champs personnalisés | Sélecteurs de pays et de ville, listes de catégories, champs du formulaire et détails des annonces. |
| Langues et leurs traductions | Langues proposées dans l'écran Langue ; catégories et messages traduits. |
| Formulaire d'annonce : nombre de photos, affichage du type d'annonce, longueur du titre et de la description | Nombre de photos par annonce, champ Vendu par, validation du formulaire. |
| Formulaire d'annonce : publication par les visiteurs sans compte | Le bouton Vendre demande ou non aux visiteurs de se connecter. |
| Validation / vérification des annonces | Les nouvelles annonces passent ou non par En validation avant d'être en ligne. |
| Sécurité : longueur du mot de passe | Indications sur le mot de passe dans les écrans d'inscription et de changement de mot de passe. |
| Upload : taille maximale des images | Les photos sont compressées sur le téléphone pour la respecter. |
| Types de signalement | Motifs proposés dans le formulaire de signalement. |
| Pages de type Terms et Privacy | Liées depuis le formulaire d'inscription et la section À propos de l'onglet Compte. |
| Offres premium et add-ons de paiement | Les annonces mises en avant apparaissent dans À la une. Sur Android, Promouvoir ouvre la page de paiement de votre site. Sur iOS, les utilisateurs promeuvent leurs annonces depuis le site, car Apple impose son propre système d'achat intégré pour les services numériques vendus dans les applications iOS. |
| SMS : téléphone comme identifiant de connexion | Choix entre e-mail et téléphone dans les écrans de connexion et d'inscription. |
| Connexion sociale : Google, Facebook | Boutons de connexion sociale (avec les identifiants client de l'application). |
| Mobile App : notifications push, liens vers l'application | Notifications push ; liens qui s'ouvrent dans l'application. |
FAQ
L'application affiche « Setup required ».
EXPO_PUBLIC_API_URL ou EXPO_PUBLIC_API_TOKEN manque dans .env.local. Ajoutez-le et relancez l'application avec npx expo start --clear.
L'application affiche « Chargement impossible » ou « Impossible de joindre le serveur ».
Les causes habituelles sont une mauvaise adresse d'API, un mauvais jeton d'API ou un problème de certificat. Voir Dépannage de l'application mobile.
Les catégories ou les villes sont vides dans certaines langues.
Votre site renvoie la traduction de la langue demandée par l'application et, à défaut, celle de la langue FALLBACK_LOCALE_FOR_DB définie dans son fichier /.env. Réglez-la sur la langue de vos données de catégories et de villes (en général en).
Mes utilisateurs peuvent-ils se connecter avec Google, Facebook ou un numéro de téléphone ?
Oui (depuis la version 1.1 de l'application), quand ces options sont activées sur votre site. Google et Facebook demandent aussi les identifiants client de l'application, comme expliqué dans Application mobile : notifications push, connexion sociale et liens vers l'application.
Les utilisateurs peuvent-ils acheter des offres premium dans l'application ?
Sur Android, oui : Promouvoir ouvre la page de paiement de votre site avec l'utilisateur connecté, et fonctionne avec vos add-ons de paiement. Sur iOS, non : Apple impose ses achats intégrés pour les services numériques, les utilisateurs iOS promeuvent donc leurs annonces depuis le site.
Dois-je publier une mise à jour de l'application quand je modifie mon site ?
Non. Catégories, pays, langues, champs personnalisés, réglages et contenus sont lus sur votre site pendant que l'application tourne. Vous ne recompilez l'application que pour changer son nom, son icône ou ses couleurs, ou pour installer une nouvelle version de l'application.
Support
Avant d'ouvrir un ticket, consultez Dépannage de l'application mobile. Contactez-nous ensuite via le Centre d'aide en indiquant votre code d'achat, votre version de LaraClassifier, la version de l'application, la plateforme (iOS ou Android) et les étapes pour reproduire le problème.
Le support couvre l'application telle qu'elle est livrée. Les personnalisations, la création des comptes sur les stores et les refus de validation causés par votre contenu ou votre fiche sur les stores ne sont pas couverts.