Preguntas frecuentes para desarrolladores

Esta página recopila preguntas frecuentes orientadas a la integración. No enumera intencionadamente nombres de clases internas, nombres de tablas, claves de opciones, nombres de hooks, rutas REST, identificadores de capacidades o detalles específicos del pipeline de lanzamiento; estos son detalles de implementación interna.

General

¿Qué es este 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 en el frontend (archivo, vehículo individual, comparación, favoritos, filtro de búsqueda) además de un área de administración para la configuración, importaciones y gestión de leads.

¿Cuáles son los requisitos de versión?

Las versiones requeridas de WordPress y PHP para el plugin se declaran en la cabecera del plugin y en el composer.json del proyecto. Consulte esos valores para conocer las versiones mínimas soportadas actualmente.

¿Dónde almacena el plugin sus datos?

Los listados de vehículos y los leads utilizan el almacenamiento de contenido estándar de WordPress. La configuración utiliza las opciones de WordPress. El plugin también gestiona cierto almacenamiento específico del plugin cuando es necesario para su propia funcionalidad. No se admite el acceso directo a la base de datos para el almacenamiento gestionado por el plugin.

¿Tiene el plugin dependencias en tiempo de ejecución?

No se requieren dependencias adicionales en tiempo de ejecución más allá de WordPress y PHP en las versiones mínimas documentadas. No hay ningún paso de compilación de JavaScript en el paquete distribuido.

Integración

¿Cómo inserto el catálogo en una página?

Utilice los shortcodes documentados.

¿Cómo cambio el aspecto de una página de vehículo?

Sobrescriba las plantillas integradas desde su tema. Consulte la Guía de sobrescritura de plantillas.

¿Cómo reenvío los leads a mi CRM?

Utilice la configuración de webhooks salientes del plugin en la interfaz de usuario de administración en lugar de engancharse a eventos internos. Verifique el webhook configurado con la versión actual del plugin al conectarlo.

¿Cómo activo las importaciones desde un programador externo?

Configure la propia automatización del plugin desde la interfaz de usuario de administración; esta incluye la superficie soportada y documentada para este caso. No dependa de nombres de hooks internos o endpoints no documentados.

¿Puedo leer los datos de analítica del plugin o de Market Insights desde fuera del plugin?

No. Los informes se exponen a través de la interfaz de usuario de administración del plugin; el almacenamiento interno y los endpoints no forman parte de un contrato público.

Soporte

¿Cómo informo de un error?

Utilice el canal de contribución del proyecto descrito en las Directrices de contribución. Para la información del entorno, prefiera la exportación de diagnóstico disponible en la interfaz de usuario de administración del plugin en lugar de copiar archivos de registro (logs) sin procesar.

Superficies de integración pública soportadas

Al integrarse 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 como se describe en la Guía de sobrescritura de plantillas.
• 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 capacidades y nonces, y la infraestructura de lanzamiento / actualización se tratan como detalles de implementación. Pueden cambiar entre lanzamientos 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 como superficie pública soportada anteriormente 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 lanzamientos. 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.