Documentation

Version du CMS : Beta 1.0
Dernière mise à jour : Mai 2026
Prérequis : PHP 8.0+, MySQL 5.7+

Installation

Prérequis

• Extension PHP : PDO, JSON, cURL, GD
• PHP 8.0 ou supérieur
• MySQL 5.7 ou MariaDB 10.2
• Serveur Apache avec mod_rewrite

1. Télécharger les fichiers dans le répertoire racine du serveur
2. Créer la base de données

Gestion du site

Soumission (item_add.php)

1. L’utilisateur remplit le formulaire
2. Vérification captcha
3. Contrôle anti-doublon
4. En attente de validation (si validation manuelle)

Le webmaster peut vérifier via une page https://www.boussole-fr.com/test-url.php la présence dans l’annuaire

Validation

Automatique : Les sites sont directement visibles

Manuelle : L’admin valide depuis admin/sites_pending.php

Mise en avant

• Champ featured en base
• Les sites mis en avant apparaissent en tête de catégorie

Ajout

Modification

Dans les pages sites validés et non validés et sur le front, vous avez accès au formulaire d’édition du site

Suppression

Gestion des catégories

Hiérarchie

Sous-catégories (niveaux illimités

Catégories parentes (niveau 1)

Sur la page catégories

Ajout

Modification
Changement du nom et du slug (attention à la redirection en 301 à faire pour le SEO)

Suppression

Gestion des utilisateurs

Types de comptes

Rôle	Description
Utilisateur	Laisse des avis
Webmaster	Soumet des sites, gère ses fiches
Administrateur	Accès complet à toutes les fonctionnalités

Inscription

1. L’utilisateur remplit le formulaire register.php
2. Un email de confirmation est envoyé
3. L’utilisateur clique sur le lien pour activer son compte
4. Connexion via login.php

Espace utilisateur (account.php)

• Voir et modifier ses sites
• Consulter les avis reçus
• Répondre aux avis
• Signaler des avis abusifs
• Voir ses favoris

Espace webmaster (account.php)

• Voir et modifier ses sites
• Consulter les avis reçus
• Répondre aux avis
• Signaler des avis abusifs
• Voir ses favoris

Gestion des avis

Dépôt d’avis (avis.php)

1. L’utilisateur doit être connecté
2. Note de 1 à 5 étoiles
3. Commentaire (max 1000 caractères)
4. Preuve de contact (optionnelle)
5. Date de commande (optionnelle)

Réponse aux avis

Le propriétaire peut répondre publiquement aux avis depuis son espace utilisateur.

Revendication de fiches

Processus

1. Visiteur non connecté : Redirection vers l’inscription
2. Utilisateur connecté : Remplit le formulaire de revendication
3. Administrateur : Valide ou refuse la demande dans admin/claims.php
4. Validation : Le site est associé à l’utilisateur

Preuves acceptées

• Email professionnel (domaine correspondant)
• Facture
• Code HTML placé sur le site
• Tout document prouvant la propriété

Pages de contenu statiques

Fichiers concernés

• admin/pages.php – Page contenu
• admin/page_edit.php – Édition de page

Création d’une page

1. Définir un slug (ex: cgu, mentions-legales)
2. Choisir la langue
3. Remplir titre et contenu (éditeur WYSIWYG)
4. Sauvegarder

Pages intégrées par défaut

• FAQ (faq.php)
• Mentions légales (legal.php)
• Conditions d’utilisation (cgu.php)

SEO et optimisation

URLs SEO

• Catégories : /categorie/sous-categorie/
• Fiches : /site/nom-du-site/
• Pagination : /categorie/page-2/

Sitemap XML (sitemap.php)

• Génération automatique
• Inclut toutes les fiches et catégories
• Utilisé par Google Search Console et Bing Tool

Sitemap HTML (sitemap-user.php)

• Version lisible par les humains
• Liste toutes les catégories et sous-catégories

Fichier robots.txt

Fil d’Ariane

• Affiché sur les fiches et catégories
• Généré automatiquement

Administration

Accès

• URL : https://votre-site.com/admin/
• Email et mot de passe définis en base

Dashboard (admin/index.php)

• Statistiques (sites, catégories, utilisateurs)
• Notifications (sites en attente, avis à modérer)
• Dernières activités
• Liens rapides

Menu d’administration

Menu	Description
Dashboard	Vue d’ensemble
Sites	Liste des sites validés
En attente	Sites à valider
Corbeille	Sites hors ligne
Catégories	Gestion des catégories
Avis clients	Modération des avis
Revendications	Demandes de propriété
Utilisateurs	Gestion des comptes
Pages	Pages statiques
Import CSV	Import massif
Options	Configuration

Import CSV

Format attendu :

Colonnes optionnelles : ville, cp, telephone, adresse, facebook, twitter, instagram, linkedin, youtube, horaires, lien_avis, lien_rdv

Import CSV échoue

Vérifier le séparateur (;) et l’encodage UTF-8

Nettoyer les doublons

— Vérifier les slugs en double
SELECT slug, COUNT() FROM site GROUP BY slug HAVING COUNT() > 1;

— Corriger les slugs
UPDATE site SET slug = CONCAT(slug, ‘-‘, id) WHERE id IN (…);

Personnalisation

Thèmes

Options disponibles

Option	Valeurs	Description
theme	classic, two-col-left, two-col-right, three-col	Disposition
color_bg	#ffffff	Couleur de fond
color_text	#333333	Couleur du texte
color_accent	#3498db	Couleur des liens/boutons

Traductions