Aperçu pour les développeurs

Ce document est la page d'orientation pour les développeurs et les intégrateurs qui travaillent avec ADP Car Market Hub. Il reste délibérément à un niveau élevé. Les détails d'implémentation interne, 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.

Quand utiliser ce document

Lisez ce document si vous êtes :

• Un intégrateur de site qui a besoin d'orientation avant de personnaliser des modèles ou des réglages pour une concession spécifique.
• Un intégrateur connectant l'extension à un CRM, un outil marketing ou un planificateur externe via les surfaces prises en charge et documentées de l'extension.
• Un évaluateur analysant l'extension à un niveau élevé avant de la recommander.

Les utilisateurs finaux (le personnel de la concession configurant l'extension depuis l'administration WordPress) doivent plutôt commencer par les sections de la documentation destinées aux utilisateurs, en particulier le manuel de l'utilisateur et la référence de l'administrateur.

Qu'est-ce que l'extension

ADP Car Market Hub est une extension WordPress qui importe et synchronise les annonces de véhicules depuis un marché en amont vers WordPress, et expose :

• Un catalogue de véhicules public (archive, page de véhicule unique, page de comparaison, favoris, filtre de recherche).
• Une zone d'administration pour la configuration, les importations et la gestion des leads.
• Un ensemble restreint de shortcodes documentés et de modèles surchargeables par le thème sur lesquels les intégrateurs peuvent s'appuyer.

L'extension nécessite les versions de WordPress et de PHP déclarées dans son en-tête d'extension. Elle est livrée avec des traductions intégrées pour les langues prises en charge et fournit un processus propre d'activation, de désactivation et de désinstallation.

Comment naviguer dans cette section

• Pour la configuration de l'environnement, voir Configuration du développement local.
• Pour les conventions de codage, voir Normes de codage.
• Pour les surfaces d'intégration prises en charge, voir Shortcodes pour les développeurs et Système de modèles et surcharges.
• Pour les contributions aux traductions, voir Internationalisation pour les développeurs.
• Pour le processus de contribution, voir Directives de contribution.

D'autres pages de cette section fournissent un résumé public et sécurisé des domaines (architecture, stockage, REST/AJAX, cron, sécurité, publication, analyses, Market Insights, etc.) dont les détails internes ne sont délibérément pas publiés.

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 pour les développeurs général pour l'orientation.

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 cron, les identifiants de capacités 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 sur la documentation publique. Cette page fournit uniquement un aperçu de l'intégration à un niveau élevé. Les détails d'implémentation interne, 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.