Guía de instalación

Esta guía describe cómo instalar y activar el plugin ADP Car Market Hub WordPress en un sitio de WordPress, y cómo verificar que la instalación se ha realizado correctamente antes de proceder con cualquier otra configuración.

No cubre las credenciales de la API ni la configuración de la importación; esos temas se tratan en Primera configuración, Configuración de Credenciales de la API y Prueba de conexión.

Cuándo utilizar este documento

Utilice este documento si está:

• Instalando ADP Car Market Hub en un nuevo sitio de WordPress por primera vez.
• Reinstalando el plugin en un sitio existente (por ejemplo, después de una migración de servidor o una reconstrucción limpia).
• Validando que una instalación realizada por un tercero (agencia, proveedor de hosting, departamento de TI interno) se completó correctamente.
• Preparando un procedimiento de instalación documentado para la entrega a un cliente.

El público objetivo es un administrador de WordPress con acceso completo al panel de administración y, en caso de utilizar la instalación por SFTP, con credenciales del sistema de archivos para el servidor de destino.

Antes de empezar

Confirme lo siguiente antes de comenzar la instalación. La mayoría de los problemas que surgen durante la instalación se deben a que alguno de estos requisitos previos no se cumple por completo.

• Paquete del plugin. Un archivo ZIP firmado del plugin ADP Car Market Hub proporcionado por AD Promotion o su canal de distribución. No cambie el nombre del archivo ni lo descomprima y vuelva a comprimir.
• Clave de licencia. Su clave de licencia de ADP Car Market Hub, proporcionada por AD Promotion. El plugin se instala y activa sin ella, pero todas las pestañas de administración excepto Settings permanecerán bloqueadas tras una pantalla de "Licencia requerida" hasta que se active la licencia. La activación de la licencia se trata en Primera configuración.
• Entorno de WordPress. Una instalación de WordPress en funcionamiento que cumpla con los requisitos mínimos del plugin:
• WordPress 6.2 o superior (Requires at least: 6.2 en la cabecera del plugin).
• PHP 8.1 o superior (Requires PHP: 8.1 en la cabecera del plugin y composer.json).
• Una base de datos compatible con WordPress (MySQL o MariaDB).
• Extensiones de PHP openssl, curl, mbstring, json, y una de gd o imagick.
• Un directorio de subidas con permisos de escritura (wp-content/uploads/). Consulte Technical System Requirements para conocer todos los detalles.
• Conectividad HTTPS saliente. El servidor web debe poder comunicarse con el host de la API de AutoScout24 que configurará más adelante. Consulte API, Network and SSL Requirements.
• Cuenta de administrador. Se requiere un usuario de WordPress con la capacidad manage_options (normalmente el rol administrator) para instalar, activar y configurar el plugin.
• Copia de seguridad. Una copia de seguridad reciente y restaurable del sitio de WordPress, incluyendo la base de datos y wp-content/. Las instalaciones en producción siempre deben contar con una copia de seguridad reciente antes de instalar o activar cualquier plugin.
• Entorno de pruebas o staging (recomendado). Para sitios en producción, se recomienda encarecidamente instalar y validar el plugin primero en una copia de staging y luego trasladar la configuración a producción. Consulte Staging to Live Migration.
• Lista de comprobación previa a la instalación. Siga los pasos de la Pre-Installation Checklist para confirmar que el hosting, PHP, la base de datos y la red están listos.

Instrucciones paso a paso

Existen dos vías de instalación admitidas:

• Opción A — Subida de archivo ZIP a través del panel de administración de WordPress (recomendado para la mayoría de los entornos).
• Opción B — Subida manual por SFTP (recomendado cuando el panel de administración de WordPress no permite la subida de plugins, cuando el entorno de hosting impone sistemas de archivos de solo lectura para el usuario administrador, o al realizar la instalación como parte de un pipeline de despliegue).

Utilice una vía u otra; no ejecute ambas al mismo tiempo.

Opción A — Instalar a través del panel de administración de WordPress (subida de ZIP)

1. Inicie sesión en WordPress como administrador.
2. En el menú de administración de la izquierda, abra Plugins → Añadir nuevo.
3. Haga clic en Subir plugin en la parte superior de la página.
4. Haga clic en Seleccionar archivo y elija el archivo ZIP de ADP Car Market Hub.
5. Haga clic en Instalar ahora y espere a que WordPress suba y descomprima el archivo.
6. Cuando finalice la subida, haga clic en Activar plugin.

Si la subida falla debido a un error de tamaño o de memoria, esto suele deberse a un límite del lado del servidor (upload_max_filesize, post_max_size, memory_limit o una restricción del firewall de la aplicación web). Resuelva este límite con su proveedor de hosting o utilice la Opción B.

Opción B — Instalar manualmente a través de SFTP

1. Descomprima el archivo ZIP de ADP Car Market Hub en su ordenador local. Debería obtener una única carpeta llamada adp-car-market-hub/ que contiene los archivos del plugin.
2. Conéctese al servidor de WordPress utilizando SFTP (o SSH) con una cuenta que tenga permisos de escritura en wp-content/plugins/.
3. Suba la carpeta adp-car-market-hub/ completa dentro de wp-content/plugins/ de modo que la ruta final sea wp-content/plugins/adp-car-market-hub/.
4. Verifique que wp-content/plugins/adp-car-market-hub/adp-car-market-hub.php existe en el servidor. WordPress identifica el plugin mediante este archivo principal.
5. Inicie sesión en WordPress como administrador.
6. Abra Plugins → Plugins instalados, localice ADP Car Market Hub en la lista y haga clic en Activar.

No cambie los permisos de los archivos del plugin manualmente a menos que su proveedor de hosting lo requiera explícitamente. El plugin no necesita acceso de escritura en su propio directorio.

Comprobaciones de activación

Después de hacer clic en Activar, WordPress debería mostrar un aviso de éxito y ADP Car Market Hub debería aparecer en la lista de plugins activos.

Si la activación se bloquea, WordPress mostrará un mensaje describiendo el motivo. Las causas más comunes son:

• El sitio no cumple con las versiones mínimas de WordPress o PHP requeridas por el plugin.
• Falta una extensión de PHP requerida.
• Aún existe en el disco una instalación anterior e incompleta del plugin.
• Los permisos de archivo en wp-content/plugins/ impiden que WordPress finalice la activación.

Resuelva el problema subyacente e intente la activación de nuevo. El plugin no modifica temas ni otros plugins durante la activación.

Comprobaciones posteriores a la activación

Realice estas comprobaciones inmediatamente después de una activación correcta. Confirman que el plugin se ha cargado correctamente y está listo para su configuración.

1. Menú de administración. Confirme que una nueva entrada de menú de nivel superior Car Market Hub es visible en la barra lateral de administración de WordPress (el nombre visible del plugin en el menú está abreviado; el archivo del plugin en sí está registrado como ADP Car Market Hub). Pase el cursor sobre la entrada para ver los elementos de submenú disponibles, incluyendo Dashboard, Settings, Car Importer, Import & Limits, Tools, System & Help, Logs y otros.
2. Enlaces de acción del plugin. En Plugins → Plugins instalados, la fila de ADP Car Market Hub ahora debería mostrar un enlace de License activation y un enlace de Settings, además de Desactivar. License activation abre la página de Settings anclada a la tarjeta de License Activation; Settings abre la página de Settings del plugin.
3. Carga de la página de Settings. Abra Car Market Hub → Settings. La página debería cargarse sin avisos de PHP, errores fatales ni advertencias de recursos faltantes. La tarjeta License Activation debería aparecer en la parte superior de la página, y los campos API Base URL, Seller ID, Client ID, Client Secret y Default currency deberían estar visibles y vacíos (en una instalación limpia). En una instalación limpia, las demás pestañas del plugin muestran una pantalla de "Licencia requerida" hasta que se activa una licencia.
4. System & Help. Abra Car Market Hub → System & Help. La página debería mostrar las comprobaciones del entorno (PHP, JSON, OpenSSL, cURL, GD/Imagick, subidas) con indicadores de estado tipo semáforo. Una instalación limpia que cumpla con los requisitos no debería mostrar indicadores rojos; cualquier extensión faltante o directorio sin permisos de escritura se marcará aquí. Corrija cualquier problema antes de continuar.
5. Sin errores fatales en los registros. Confirme que el registro de depuración de WordPress (si está habilitado) y el registro de errores de su hosting no muestran errores fatales relacionados con el plugin. El plugin mantiene su propio archivo de registro en wp-content/uploads/as24ci-logs/, que se creará automáticamente en el primer uso.

Si alguna de estas comprobaciones falla, no proceda con los pasos de configuración. Resuelva el problema primero o restaure la copia de seguridad más reciente.

Aviso del asistente de primera configuración

Después de la primera activación del plugin, aparece un aviso de administración titulado Welcome to ADP Car Market Hub en la parte superior de cada página de administración de WordPress. El aviso ofrece dos botones:

• Start Setup Wizard abre el First Setup Wizard, un flujo de siete pasos (licencia, modo, perfil de concesionario, AutoScout24, páginas, características, finalizar). La activación de la licencia es el primer paso obligatorio; los pasos restantes son opcionales.
• Skip for now descarta el aviso. Se puede seguir accediendo al asistente desde el Dashboard y desde Car Market Hub → Tools.

El aviso no es un redireccionamiento forzado. Solo aparece cuando se acaba de registrar la marca de tiempo de la primera activación y el asistente aún no se ha completado ni omitido. Las actualizaciones del plugin que no requieran una activación limpia no muestran el aviso en las instalaciones existentes. El asistente es opcional pero recomendado; todo lo que ofrece también se puede configurar manualmente a través de las pestañas de administración habituales.

Notas de configuración

Este documento cubre únicamente la instalación. Los siguientes puntos se aplican específicamente a la etapa de instalación/activación:

• Slug y carpeta del plugin. El nombre de carpeta esperado es adp-car-market-hub. No se admite cambiar el nombre de la carpeta, ya que afectará a la capacidad de WordPress para gestionar las actualizaciones.
• Custom post type y taxonomías. Al activarse, el plugin registra el custom post type as24ci_car y un conjunto de taxonomías de vehículos. Estos son elementos técnicos y no requieren configuración manual.
• Tablas personalizadas de la base de datos. El plugin crea sus propias tablas de base de datos al activarse a través de dbDelta() (por ejemplo, para eventos de analítica y alertas de búsquedas guardadas). No se requiere ninguna acción SQL manual.
• Capacidad y rol personalizados. El plugin aprovisiona su propia capacidad y un rol delegado utilizado para la gestión diaria. La instalación y configuración iniciales deben seguir siendo realizadas por un administrador completo de WordPress. Consulte Access Control and Capabilities.
• Sin importación de datos al activar. La activación no importa ningún vehículo ni se conecta con AutoScout24. Las importaciones comienzan únicamente después de configurar las credenciales y activar una importación.

Notas operativas

• Actualizaciones. Las futuras actualizaciones del plugin deben aplicarse a través del mismo canal utilizado para la instalación (subida de un nuevo ZIP desde el panel de administración o reemplazo de la carpeta del plugin por SFTP). Mantenga el slug y el nombre de la carpeta del plugin sin cambios para que se conserven los ajustes, los vehículos y los leads. Realice siempre una copia de seguridad limpia antes de actualizar en producción.
• Desactivación. Al desactivar el plugin se deshabilitan sus funciones, pero se mantienen los vehículos importados, las opciones, los leads y los datos de analítica en la base de datos. El plugin elimina sus datos únicamente al desinstalarse, y solo cuando la opción de limpieza correspondiente está habilitada. Consulte Uninstall and Data Cleanup.
• Multisitio. ADP Car Market Hub está diseñado para activarse en el sitio individual que debe mostrar el inventario de vehículos, no en toda la red. Confirme con su administrador de hosting o de red antes de realizar la instalación en un entorno multisitio.
• Disciplina en producción. Las instalaciones en producción deben seguir un procedimiento de lanzamiento documentado: copia de seguridad → instalar en staging → validar → instalar en producción → volver a verificar. Consulte Staging to Live Migration.

---

Resolución de problemas

Si el problema persiste después de estas comprobaciones, recopile el diagnóstico descrito en la Lista de comprobación de información de soporte antes de ponerse en contacto con el soporte técnico.

Documentos relacionados

• Lista de comprobación previa a la instalación
• Requisitos técnicos del sistema
• Requisitos de API, red y SSL
• Primera configuración
• Configuración de Credenciales de la API
• Prueba de conexión
• Lista de comprobación para la puesta en marcha
• Migración de Staging a producción