Documentation · Référence de l'administrateur
Référence des réglages
Ce document est une référence pour l'écran Settings (Réglages) de l'extension ADP Car Market Hub (Car Market Hub → Settings). Il explique chaque carte de la page, ce que contrôle chaque champ, et comment les valeurs sont validées et stockées.
Quand utiliser ce document
Utilisez cette référence lorsque vous configurez l'extension pour la première fois, lorsque vous devez vérifier le rôle d'une option spécifique, ou lors du dépannage d'un comportement qui dépend d'un réglage.
Aperçu
L'écran des réglages est organisé sous forme de pile verticale de cartes. Chaque carte possède son propre bouton Save Settings (Enregistrer les réglages), mais la validation de l'une d'entre elles enregistre l'ensemble de la page. La page est divisée en sections suivantes :
- Licence et activation (affichée en haut de la page)
- Connexion API & Réglages généraux
- Pages par défaut & Shortcodes
- SEO & Intégrations
- Fonctionnalités Frontend
- Fonctionnalités d'administration
- Zone de danger
Configuration requise ou prérequis
- Accès à Car Market Hub → Settings (nécessite la capacité de gestion de l'extension).
- Pour la connexion API : des identifiants valides fournis par votre fournisseur de données (AutoScout24 ou un point de terminaison d'intégration compatible). Ceux-ci ne sont pas fournis par l'extension et doivent être obtenus séparément.
- Pour les pages par défaut : l'autorisation de créer des pages WordPress.
Instructions étape par étape
- Ouvrez Car Market Hub → Settings.
- Remplissez la carte API Connection & General Settings avec l'URL, le Seller ID et les identifiants fournis par votre prestataire, puis choisissez la devise par défaut.
- Enregistrez et confirmez qu'il n'y a pas d'erreurs de validation en haut de l'écran.
- Activez éventuellement l'option Create default pages on save pour que l'extension crée automatiquement les pages Véhicules, Comparateur et Favoris. Sinon, intégrez manuellement les shortcodes correspondants sur les pages de votre choix.
- Passez en revue les cartes SEO & Integrations, Frontend Features et Admin Features et activez les fonctionnalités dont vous avez besoin.
- N'activez les éléments de la Danger Zone qu'après avoir lu attentivement les avertissements et créé une sauvegarde si nécessaire.
Référence de configuration
Licence et Activation
La carte License est la première carte de la page des réglages. ADP Car Market Hub est un produit sous licence : la licence déverrouille les zones premium (telles que l'AI Assistant, le Content Studio et Market Insights) et permet les mises à jour et le support. La clé de licence est fournie par AD Promotion.
Fonctionnement de la licence, étape par étape :
- Activer la licence. Collez la clé fournie par AD Promotion dans le champ License key et cliquez sur Activate. L'extension contacte le service de licence, valide la clé par rapport au domaine de ce site et la stocke de manière masquée. Si vous saisissez à nouveau une clé, le bouton affiche Re-activate.
- Vérifier le statut à tout moment. Cliquez sur Check license now pour demander l'état le plus récent au service de licence. La carte actualise alors le Status (par exemple Active, Inactive, Suspended ou Expired), l'offre, les dates d'expiration/support et les fonctionnalités incluses. Ce même statut de licence est également affiché sous forme de tuile KPI sur le Dashboard et l'écran de Support, afin que vous puissiez le voir sans ouvrir les réglages.
- Voir quelles fonctions sont déverrouillées. Lorsque la licence est active, la carte affiche une ligne Included features listant les zones premium couvertes par votre licence (par exemple AI Assistant, Content Studio, Market Insights). Chaque écran premium reflète également cela directement : si une zone est incluse, elle affiche ses commandes normales, et si elle ne l'est pas, elle affiche à la place une carte « non inclus dans cette licence ».
- Réactiver ou supprimer. Utilisez Re-activate après un changement d'offre pour récupérer les nouveaux droits, ou Remove license pour effacer la clé stockée de ce site (les zones premium se verrouillent alors à nouveau).
La majeure partie de ce processus s'exécute de manière autonome en arrière-plan : l'extension vérifie périodiquement la licence et maintient le statut à jour, de sorte que la vérification manuelle via Check license now sert principalement à confirmer un changement immédiatement.
| Élément | Notes |
|---|---|
| License key | Saisissez la clé fournie par AD Promotion et cliquez sur Activate (ou Re-activate). La clé est stockée masquée et liée au domaine de ce site ; la clé complète n'est plus jamais affichée. |
| Status | L'état actuel de la licence, par exemple Active, Inactive, Suspended ou Expired. |
| Check license now | Vérifie à nouveau la licence auprès du service de licence et actualise le statut, l'offre et les fonctionnalités incluses. Disponible dès qu'une clé est stockée. |
| Remove license | Supprime la clé stockée de ce site. Les fonctionnalités premium qui dépendent de la licence sont à nouveau verrouillées. |
Lorsqu'une clé est active, la carte affiche également des détails en lecture seule : Plan, Expires, Support until, Domain, Last checked, Reported version, la limite d'importation et la liste des Included features. Ce même statut de licence est également présenté sous forme de KPI sur le Dashboard et l'écran de Support.
Les zones premium qui ne font pas partie de votre licence affichent une carte « non inclus dans cette licence » sur leur propre page au lieu des commandes normales (voir la Référence de l'Assistant IA, la Référence du Content Studio et la Référence des analyses de marché). Rien n'est cassé dans cet état — contactez le support de ADP Car Market Hub pour activer la zone.
API Connection & General Settings
| Champ | Type | Notes |
|---|---|---|
| API Base URL | URL | URL complète incluant https://. Validée côté serveur ; les barres obliques de fin sont supprimées. Les URL invalides sont rejetées et la valeur précédente est conservée. |
| Seller ID | Texte | Un ou plusieurs Seller ID séparés par des virgules, des espaces ou des points-virgules. Seuls les lettres, chiffres, tirets du bas et tirets sont conservés après nettoyage. |
| Client ID | Texte | Identifiant client de type OAuth fourni par votre prestataire. |
| Client Secret | Champ mot de passe | Stocké sous forme de texte d'option brut dans la base de données ; traitez le champ en conséquence. La saisie est masquée pour éviter les regards indiscrets. |
| Default currency | Sélection | Choisissez l'un des codes ISO 4217 pris en charge : BGN, CHF, CZK, DKK, EUR, GBP, HUF, NOK, PLN, RON, RUB, SEK, TRY, UAH. Les valeurs inconnues reviennent par défaut à EUR. |
Lorsque les identifiants changent, l'extension efface son jeton d'accès mis en cache ainsi que le statut de connexion API mis en cache afin que le prochain chargement de page reflète la nouvelle configuration.
Default Pages & Shortcodes
| Champ | Type | Notes |
|---|---|---|
| Create default pages on save | Case à cocher | Si cochée et enregistrée, les pages manquantes Cars, Compare Cars et Favorites sont créées. Les pages existantes ne sont pas écrasées. |
La carte liste également des shortcodes prêts à être copiés :
[as24ci_archive]— liste des véhicules.[as24ci_compare]— page de comparaison.[as24ci_favorites]— page des favoris / liste d'envies.[as24ci_archive make="BMW" price_max="40000" order_by="price" order="asc"]— exemple de liste pré-filtrée.
Paramètres [as24ci_archive] pris en charge tels que documentés dans l'administration : make, model, price_min, price_max, fuel, body, order_by (price / mileage / date), order (asc / desc), per_page (12 / 24 / 48 / 72 / all).
SEO & Integrations
| Champ | Par défaut | Notes |
|---|---|---|
| Schema.org & Open Graph | Activé | Génère des données structurées JSON-LD et des balises méta Open Graph / Twitter Card sur les pages de véhicules individuels. |
| XML Sitemap integration | Activé | Ajoute les publications de véhicules aux plans de site natifs de WordPress avec les dates lastmod correctes. Le libellé d'administration indique la compatibilité avec Yoast SEO et Rank Math. |
| REST API | Désactivé | Lorsqu'elle est activée, enregistre GET /wp-json/as24ci/v1/vehicles et GET /wp-json/as24ci/v1/vehicles/{id} pour un accès externe. |
Frontend Features
| Champ | Par défaut | Notes |
|---|---|---|
| Favorites / Wishlist | Activé | Ajoute des icônes de favoris sur l'archive et la barre latérale flottante sur les pages individuelles. La page des favoris peut être intégrée avec [as24ci_favorites]. L'implémentation est basée sur localStorage. |
| Vehicle Compare | Activé | Ajoute des boutons de comparaison sur l'archive et les pages individuelles. Les véhicules sélectionnés peuvent être affichés via [as24ci_compare]. |
| Financing Calculator | Désactivé | Lorsqu'il est activé, le calculateur peut être placé via le Layout Manager dans Single Vehicle – Sidebar, Single Vehicle Main Content, ou Single Vehicle – Bottom Section. |
| Annual interest rate (%) | 3.9 | Plage autorisée 0–50, pas de 0,1. |
| Loan term (months) | 48 | Valeurs autorisées : 12, 24, 36, 48, 60, 72, 84. |
| Down payment (%) | 20 | Plage autorisée 0–100. |
Les valeurs de financement sont des valeurs par défaut pré-remplies dans le calculateur sur le frontend ; les visiteurs peuvent les ajuster si le modèle du calculateur le permet.
Admin Features
| Champ | Par défaut | Notes |
|---|---|---|
| Dashboard widget | Activé | Affiche le widget d'aperçu des statistiques de véhicules sur le tableau de bord WordPress. |
| Bulk actions | Activé | Ajoute les actions groupées Mettre en brouillon, Publier et Supprimer avec les images au tableau de la liste des véhicules. |
| Vehicle export | Activé | Active l'exportation CSV / JSON des données de véhicules dans l'onglet Outils. |
Danger Zone
| Champ | Par défaut | Notes |
|---|---|---|
| Delete imported cars and imported images when the plugin is deleted | Désactivé | Lorsqu'il est activé, la désinstallation de l'extension supprime les entrées du type de publication personnalisé Cars ainsi que leurs pièces jointes importées. Les pages créées par l'extension ne sont pas supprimées automatiquement. |
Notes opérationnelles
- Chaque carte possède son propre bouton de validation, mais chaque validation soumet l'intégralité du formulaire. L'enregistrement de n'importe quelle carte conserve tous les champs de la page.
- Les identifiants API sont stockés dans la table des options de WordPress. Toute personne disposant d'un accès à la base de données ou à l'exportation d'administration peut les lire ; protégez le site en conséquence.
- L'activation du calculateur de financement ne le place pas automatiquement sur la page — l'emplacement est contrôlé dans le Layout Manager.
- L'activation de la REST API contrôle uniquement les points de terminaison publics des véhicules. Les points de terminaison AJAX internes d'administration utilisés par l'extension ne sont pas affectés par cette option.
- L'action « Create default pages on save » s'exécute uniquement lorsque la case est cochée au moment où vous enregistrez. La décocher plus tard ne supprime pas les pages précédemment créées.
Dépannage
- Erreur « The API Base URL is not a valid URL ». La valeur n'a pas passé la validation
FILTER_VALIDATE_URL. Saisissez l'URL complète incluant le protocole (https://) et sans caractères superflus. La valeur précédente est conservée jusqu'à ce qu'une URL valide soit fournie. - Les importations renvoient des erreurs 401 / 403 après l'enregistrement des identifiants. Vérifiez le Client ID, le Client Secret et le Seller ID auprès de votre fournisseur. Le cache des jetons est vidé lors de l'enregistrement, de sorte que la requête suivante utilise les nouvelles valeurs.
- Les pages par défaut n'ont pas été créées. L'option n'agit qu'au moment de l'enregistrement. Assurez-vous que la case est cochée lorsque vous cliquez sur Enregistrer, et que l'utilisateur WordPress a l'autorisation de créer des pages.
- La devise ne change pas sur le frontend. Le champ stocke une valeur par défaut. Les devises par véhicule provenant du fournisseur de données peuvent remplacer l'affichage selon les modèles actifs. Vérifiez ce comportement dans la version actuelle de l'extension avant la publication.
- Le calculateur de financement est activé mais invisible. Ajoutez le bloc Financing Calculator à l'une des zones Single Vehicle dans le Référence du gestionnaire de mise en page. L'écran des réglages n'avertit pas de l'emplacement ; il affiche seulement une description statique qui renvoie vers le Layout Manager. Pour éviter que le calculateur n'apparaisse deux fois, veillez à ne l'ajouter qu'à une seule zone Single Vehicle.