Descripción general para desarrolladores

Este documento es la página de orientación para desarrolladores e integradores que trabajan con ADP Car Market Hub. Se mantiene deliberadamente a un nivel general. Los detalles de implementación interna, las API privadas, los aspectos internos del almacenamiento y la infraestructura de lanzamiento sensible a la seguridad se mantienen por separado y no forman parte de la documentación pública.

Cuándo utilizar este documento

Lea este documento si es:

• Un implementador de sitios que necesita orientación antes de personalizar plantillas o ajustes para un concesionario específico.
• Un integrador que conecta el plugin a un CRM, herramienta de marketing o programador externo a través de las superficies de integración soportadas y documentadas del plugin.
• Un evaluador que analiza el plugin a un nivel general antes de recomendarlo.

Los usuarios finales (personal del concesionario que configura el plugin desde la administración de WordPress) deben comenzar en su lugar con las secciones de la documentación orientadas al usuario, en particular el manual del usuario y la referencia del administrador.

Qué es el plugin

ADP Car Market Hub es un plugin de WordPress que importa y sincroniza listados de vehículos desde un mercado de origen (upstream) hacia WordPress, y expone:

• Un catálogo público de vehículos (archivo, página de vehículo individual, página de comparación, favoritos, filtro de búsqueda).
• Un área de administración para la configuración, importaciones y gestión de leads.
• Un pequeño conjunto de shortcodes documentados y plantillas que los integradores pueden sobrescribir en el tema.

El plugin requiere las versiones de WordPress y PHP declaradas en la cabecera de su plugin. Se entrega con traducciones integradas para los idiomas soportados y proporciona una ruta limpia de activación, desactivación y desinstalación.

Cómo navegar por esta sección

• Para la configuración del entorno, consulte Local Development Setup.
• Para las convenciones de código, consulte Coding Standards.
• Para las superficies de integración soportadas, consulte Shortcodes For Developers y Template System And Overrides.
• Para las contribuciones de traducción, consulte Internationalization For Developers.
• Para el proceso de contribución, consulte Contribution Guidelines.

Otras páginas de esta sección proporcionan un resumen seguro para el público de áreas (arquitectura, almacenamiento, REST/AJAX, cron, seguridad, lanzamientos, analítica, Market Insights, etc.) cuyos detalles internos no se publican deliberadamente.

Superficies de integración pública soportadas

Al realizar integraciones con el plugin, prefiera estas superficies estables:

• La interfaz de usuario de ajustes de administración del plugin.
• Los shortcodes documentados.
• Las sobrescrituras de plantillas a nivel de tema tal como se describen en Template System And Overrides.
• La Descripción general para desarrolladores general para orientarse.

Los nombres de clases internas, las claves de opciones, las tablas de la base de datos, los endpoints REST y AJAX, los nombres de hooks de cron, los identificadores de capabilities y nonces, y la infraestructura de lanzamientos / actualizaciones se tratan como detalles de implementación. Pueden cambiar entre versiones sin previo aviso y no forman parte del contrato de integración público.

Política de estabilidad y cambios

Cualquier elemento que no figure en la lista anterior como superficie pública soportada se considera un detalle de implementación interna. Las API internas, el diseño del almacenamiento y la implementación de seguridad pueden cambiar entre versiones. No dependa de ellos desde código de terceros, temas o sistemas externos. No se admiten escrituras directas en la base de datos.

Aviso de documentación pública. Esta página proporciona únicamente una descripción general de la integración a alto nivel. Los detalles de implementación interna, las API privadas, los aspectos internos del almacenamiento y la infraestructura de lanzamiento sensible a la seguridad se mantienen por separado y no forman parte de la documentación pública. Las superficies de integración soportadas son los shortcodes documentados, las sobrescrituras de plantillas, la interfaz de usuario de ajustes y cualquier punto de extensión publicado explícitamente en esta sección.