Configuration

Le panneau d'administration centralise tous les paramètres de NGZ Ads. Accédez-y via Administration → Paramètres (/admin/settings).

Paramètres généraux

Après avoir modifié l'URL de base, videz le cache de votre navigateur pour que les liens internes se mettent à jour.

Paramètres internationaux

Langues

Les visiteurs peuvent changer de langue via le sélecteur dans la barre de navigation (drapeau + code langue). Le choix est mémorisé en session.

Pour ajouter une langue, créez le fichier de traduction correspondant dans includes/lang/ (ex : de.php pour l'allemand) en dupliquant en.php, puis ajoutez de à la liste des langues supportées.

Fuseau horaire

Sélectionnez le fuseau horaire dans la liste déroulante (ex : Europe/Paris, America/New_York, UTC). Il est utilisé pour :

• L'affichage des dates de publication et d'expiration des annonces
• Les horodatages dans les logs et les notifications e-mail

La liste complète des identifiants de fuseaux est disponible sur php.net/timezones.

Locale (format des nombres et des dates)

La locale détermine le format d'affichage des prix et des dates. Exemples :

La locale est distincte de la langue de l'interface : vous pouvez afficher l'interface en anglais avec des nombres formatés à la française.

Devises

NGZ Ads supporte plusieurs devises. La configuration se fait en deux endroits :

1. Liste des devises autorisées (onglet Currencies) — définit les devises que les utilisateurs peuvent choisir lors du dépôt d'une annonce. Chaque entrée contient :

Utilisez les boutons + Add Currency et Supprimer pour gérer la liste.

2. Devise par défaut (onglet General) — devise sélectionnée par défaut dans le formulaire de dépôt d'annonce. Doit être présente dans la liste des devises autorisées.

Option « Prix en centimes » — si activée, les utilisateurs peuvent saisir des prix décimaux (ex : 9,99 €). Si désactivée, seuls les entiers sont acceptés.

Slugs d'URL

NGZ Ads génère des URLs propres dont les segments sont traduisibles. Par exemple :

• Français : /annonces/, /annonce/123/mon-titre
• Anglais : /ads/, /ad/123/my-title

Les slugs sont configurables dans l'onglet URL Slugs pour chaque langue supportée :

Modifiez les slugs avec précaution sur un site en production : les URLs existantes (indexées par Google, partagées) ne seront plus valides.

Annonces et pagination

Image de remplacement (no-image)

Lorsqu'une annonce n'a pas de photo, le site affiche une image de remplacement. Vous pouvez utiliser l'image par défaut ou la remplacer par la vôtre.

Via l'interface d'administration

1. Rendez-vous dans Administration → Paramètres → Images
2. Dans la section No-Image Placeholder, cliquez sur Téléverser une image personnalisée
3. Sélectionnez un fichier JPEG, PNG, GIF ou WebP (max 5 Mo) — il sera redimensionné à 800×600 px si nécessaire
4. Cliquez sur Enregistrer les paramètres

Pour revenir à l'image par défaut, cliquez sur Remettre par défaut puis enregistrez.

Remplacement manuel

Remplacez directement le fichier sur le serveur :

assets/img/no-image.png

Le fichier doit s'appeler exactement no-image.png. Toute image JPEG, PNG ou WebP est acceptée tant qu'elle porte ce nom.

Priorité de résolution

Le site cherche l'image dans cet ordre :

1. Image personnalisée uploadée via l'admin → uploads/no-image/<fichier>
2. Image par défaut → assets/img/no-image.png

Si l'image uploadée est supprimée ou introuvable, le fallback sur assets/img/no-image.png est automatique.

Configuration e-mail (SMTP)

NGZ Ads peut envoyer des e-mails pour les notifications de messages, les inscriptions et les alertes d'administration.

Pour Gmail, générez un mot de passe d'application depuis les paramètres de sécurité de votre compte Google (la connexion directe avec le mot de passe principal est bloquée).

Utilisez le bouton Envoyer un e-mail de test (ou l'onglet Email Test du wizard) pour vérifier la configuration avant de mettre le site en production.

Tags d'annonces

Les tags sont des indicateurs optionnels (jusqu'à 3) que l'utilisateur peut cocher lors du dépôt d'une annonce. Un tag activé apparaît en badge sur la fiche annonce et dans les listes.

Pour chaque tag :

1. Activé — cochez pour rendre le tag disponible sur le formulaire de dépôt
2. Icône — nom d'une icône Bootstrap Icons (ex : patch-check-fill, shield-check, award-fill)
3. Libellé — saisissez le nom du tag dans chaque langue supportée

Les icônes disponibles sont listées sur icons.getbootstrap.com.

Thèmes

NGZ Ads propose plusieurs thèmes visuels. Pour changer le thème actif :

1. Rendez-vous dans Administration → Paramètres → Apparence
2. Cliquez sur Activer sous le thème désiré
3. Le changement est immédiat

Les thèmes disponibles sont détectés automatiquement depuis le dossier themes/. Chaque thème hérite des templates du thème Core et ne fournit que ses propres fichiers CSS.

Contact et messagerie

Voir la section Messagerie et contact pour le détail du fonctionnement côté utilisateur.

Mode maintenance

Activez le mode maintenance depuis Administration → Paramètres → Avancé. Pendant la maintenance :

• Les visiteurs voient une page d'information personnalisable
• Les administrateurs continuent d'accéder au site normalement (via la liste d'IP autorisées)

Pensez à désactiver le mode maintenance dès que vos opérations sont terminées.

Mode démo

Le mode démo permet de faire visiter le site (y compris le panneau d'administration) sans risquer la moindre modification. Il existe sous deux formes complémentaires, activables indépendamment l'une de l'autre.

Compte utilisateur "démo"

Un rôle utilisateur dédié, en lecture seule intégrale :

• Accès à l'intégralité du site public et du panneau d'administration
• Aucune création, modification ou suppression possible (annonces, utilisateurs, pages, paramètres…)
• Les identifiants secrets (SMTP, OAuth, clé de cron…) sont masqués, y compris en consultation
• Une bannière "Mode démo — lecture seule" s'affiche en haut de l'écran pour ce compte

Ce compte se crée depuis l'assistant d'installation (onglet Compte démo) ou via le script sql/demo-account.sql sur une installation existante — voir le chapitre Installation.

Bannière "Mode démo" du site entier

Indépendamment du compte démo, vous pouvez afficher une bannière personnalisable en haut de chaque page (site public et administration), visible par tous les visiteurs, pour signaler par exemple que le contenu du site est régulièrement réinitialisé.

Réglages disponibles dans Administration → Paramètres → Maintenance :

Cette bannière est purement informative : elle ne restreint rien par elle-même. Combinez-la avec le compte démo ci-dessus pour un site de démonstration public complet et sans risque.

Annonces "démo" (protégées)

Un administrateur peut marquer n'importe quelle annonce comme "annonce démo" depuis le formulaire de dépôt/édition ou la liste des annonces en administration. Une annonce démo :

• N'expire jamais automatiquement
• Ne peut être modifiée, supprimée ou re-catégorisée que par un véritable administrateur — ni par son propriétaire, ni par un modérateur

Pratique pour conserver des annonces d'exemple stables sur un site de démonstration public.

Sécurité

Changez la clé secrète par défaut (change_this_to_a_random_secret_key_in_production) avant toute mise en production.