FAQ du développeur

Cette page rassemble les questions fréquemment posées et orientées vers l'intégration. Elle n'énumère volontairement pas les noms de classes internes, les noms de tables, les clés d'options, les noms de hooks, les routes REST, les identifiants de droits (capabilities) ou les spécificités du pipeline de publication — ceux-ci étant des détails d'implémentation internes.

Général

Qu'est-ce que cette extension ?

ADP Car Market Hub est une extension WordPress qui importe et synchronise les annonces de véhicules depuis une place de marché en amont vers WordPress, et propose un catalogue côté front-end (archive, véhicule unique, comparaison, favoris, filtre de recherche) ainsi qu'une zone d'administration pour la configuration, les importations et la gestion des leads.

Quelles sont les versions requises ?

Les versions requises de WordPress et PHP pour l'extension sont déclarées dans l'en-tête de l'extension et dans le fichier composer.json du projet. Consultez ces valeurs pour connaître les versions minimales actuellement prises en charge.

Où l'extension stocke-t-elle ses données ?

Les annonces de véhicules et les leads utilisent le stockage de contenu standard de WordPress. La configuration utilise les options de WordPress. L'extension gère également un stockage spécifique à l'extension lorsque cela est nécessaire pour ses propres fonctionnalités. L'accès direct à la base de données pour le stockage géré par l'extension n'est pas pris en charge.

L'extension a-t-elle des dépendances d'exécution ?

Aucune dépendance d'exécution supplémentaire n'est requise au-delà de WordPress et de PHP dans les versions minimales documentées. Il n'y a pas d'étape de build JavaScript dans le package publié.

Intégration

Comment intégrer le catalogue dans une page ?

Utilisez les shortcodes documentés.

Comment modifier l'apparence d'une page de véhicule ?

Surchargez les modèles (templates) intégrés depuis votre thème. Voir Système de modèles et surcharges.

Comment transférer les leads vers mon CRM ?

Utilisez la configuration des webhooks sortants de l'extension dans l'interface d'administration plutôt que de vous brancher sur des événements internes. Vérifiez le webhook configuré par rapport à la version actuelle de l'extension lorsque vous le mettez en place.

Comment déclencher des importations depuis un planificateur externe ?

Configurez la propre automatisation de l'extension depuis l'interface d'administration ; elle inclut l'interface prise en charge et documentée pour ce cas de figure. Ne dépendez pas de noms de hooks internes ou de points de terminaison non documentés.

Puis-je lire les données d'analyse de l'extension ou de Market Insights depuis l'extérieur de l'extension ?

Non. Les rapports sont exposés via l'interface d'administration de l'extension ; le stockage interne et les points de terminaison ne constituent pas un contrat public.

Support

Comment signaler un bug ?

Utilisez le canal de contribution du projet décrit dans les Directives de contribution. Pour les informations sur l'environnement, préférez l'export de diagnostic disponible depuis l'interface d'administration de l'extension plutôt que de copier des fichiers de journaux bruts.

Surfaces d'intégration publiques prises en charge

Lors de l'intégration avec l'extension, privilégiez ces surfaces stables :

• L'interface utilisateur des réglages d'administration de l'extension.
• Les shortcodes documentés.
• Les surcharges de modèles au niveau du thème comme décrit dans Système de modèles et surcharges.
• L' Aperçu général pour les développeurs pour vous orienter.

Les noms de classes internes, les clés d'options, les tables de base de données, les points de terminaison REST et AJAX, les noms de hooks de cron, les identifiants de droits (capabilities) et de nonces, ainsi que l'infrastructure de publication / mise à jour sont traités comme des détails d'implémentation. Ils peuvent changer d'une version à l'autre sans préavis et ne font pas partie du contrat d'intégration public.

Politique de stabilité et de modification

Tout ce qui n'est pas répertorié comme une surface publique prise en charge ci-dessus est considéré comme un détail d'implémentation interne. Les API internes, la structure de stockage et l'implémentation de la sécurité peuvent changer d'une version à l'autre. Ne dépendez pas d'eux à partir de codes tiers, de thèmes ou de systèmes externes. Les écritures directes dans la base de données ne sont pas prises en charge.

Avis de documentation publique. Cette page fournit uniquement un aperçu de haut niveau de l'intégration. Les détails d'implémentation internes, les API privées, les structures de stockage internes et l'infrastructure de publication sensible à la sécurité sont gérés séparément et ne font pas partie de la documentation publique. Les surfaces d'intégration prises en charge sont les shortcodes documentés, les surcharges de modèles, l'interface utilisateur des réglages et tous les points d'extension explicitement publiés dans cette section.