Problemas con la ficha técnica en PDF

Este documento cubre los problemas con la función de ficha técnica de vehículos optimizada para impresión del plugin ADP Car Market Hub, incluyendo el acceso, el renderizado, la falta de datos, las imágenes, los ajustes y la generación de códigos QR.

Cuándo usar este documento

Lea este documento cuando:

• La URL de la ficha técnica (?as24ci_pdf={post_id}) devuelva un error 404 o una página en blanco.
• La página de la ficha técnica se abra pero falten algunos campos, imágenes o secciones.
• El botón o enlace "Imprimir ficha técnica" no aparezca en las páginas de detalles del vehículo.
• Los ajustes del PDF Manager no se estén aplicando a la ficha técnica renderizada.
• El código QR no aparezca o muestre una imagen de error.

Descripción general

La función PDF Datasheet renderiza una página HTML independiente y optimizada para impresión para cada vehículo. La página no es un archivo PDF real; es un documento HTML con estilos CSS de impresión que el visitante (o la automatización del navegador) convierte a PDF utilizando la función Imprimir → Guardar como PDF del navegador. No se requiere ninguna biblioteca PDF de PHP.

Se accede a la ficha técnica a través de una variable de consulta añadida a la URL de inicio del sitio:

https://your-site.com/?as24ci_pdf={post_id}

Donde {post_id} es el ID de entrada numérico de WordPress del vehículo. La página solo se renderiza para entradas as24ci_car publicadas. Los borradores, las entradas en la papelera o las entradas de cualquier otro tipo devuelven un error 404.

La función está desactivada por defecto. Debe activarse explícitamente en los ajustes del plugin antes de que responda a cualquier solicitud.

Requisitos

• El plugin debe estar activo.
• El interruptor de la función PDF Datasheet debe estar activado en los ajustes del plugin (el interruptor principal se encuentra en la pestaña Design & Styles; la configuración a nivel de plantilla está en la pestaña PDF Manager).
• Los enlaces permanentes de WordPress deben ser funcionales (simples o bonitos).
• La entrada del vehículo debe estar en estado publish.
• El navegador del visitante debe ser compatible con hojas de estilo CSS de impresión para generar un PDF con el formato adecuado al imprimir.

Pasos de diagnóstico

Paso 1: Confirmar que la función está activada

La función PDF Datasheet está desactivada por defecto en las nuevas instalaciones.

1. Vaya a la administración del plugin y abra los ajustes de Features o Design & Styles.
2. Busque el interruptor PDF Datasheet.
3. Actívelo y guarde los cambios.
4. Después de activarlo, vacíe la caché de enlaces permanentes de WordPress yendo a Ajustes → Enlaces permanentes y haciendo clic en Guardar cambios.

Paso 2: Verificar el ID y el estado de la entrada del vehículo

El formato de la URL es ?as24ci_pdf={post_id}. Si utiliza un ID de entrada incorrecto, o si el vehículo no está publicado, recibirá un error:

• Un ID de entrada no válido (no numérico o negativo) devuelve un HTTP 400 ("ID de vehículo no válido").
• Una entrada que no existe, que no es del tipo as24ci_car o que no está publicada devuelve un HTTP 404 ("Vehículo no encontrado o no publicado").

Para encontrar el ID de entrada correcto:

1. Vaya a la pantalla de edición del vehículo en la administración de WordPress.
2. El ID de la entrada aparece en la URL: ?post=12345.
3. Pruebe la URL de la ficha técnica: https://your-site.com/?as24ci_pdf=12345.

Paso 3: Comprobar que la variable de consulta está registrada

La ficha técnica utiliza la variable de consulta as24ci_pdf de WordPress. Si otro plugin o tema anula el registro o entra en conflicto con las variables de consulta personalizadas, es posible que la ficha técnica no se active.

1. Después de activar la función, actualice los enlaces permanentes (Ajustes → Enlaces permanentes → Guardar cambios).
2. Si la URL sigue sin funcionar, compruebe si algún plugin de seguridad o de caché está eliminando parámetros de consulta desconocidos de las solicitudes.

Paso 4: Diagnosticar campos o secciones ausentes

Los ajustes de PDF Manager (almacenados en la opción as24ci_pdf_manager_settings) controlan qué campos y secciones aparecen en la ficha técnica. Si faltan campos:

1. Vaya a la pestaña de administración PDF Manager.
2. Revise las casillas de verificación de Content fields. Cualquier campo que esté desmarcado no aparecerá en la ficha técnica.
3. Revise la sección Layout para ver los interruptores como Show Gallery, Show Price Box y Show Contact Information.
4. Guarde los ajustes y vuelva a cargar la ficha técnica.

Si un campo está activado en PDF Manager pero sigue sin aparecer, es posible que el vehículo no tenga datos para ese campo. Por ejemplo, si el vehículo se importó sin precio, el campo del precio no se renderizará aunque esté activado.

Paso 5: Diagnosticar imágenes ausentes

La ficha técnica utiliza imágenes de dos campos meta:

• _as24ci_image_ids — imágenes importadas desde la API.
• _as24ci_manual_image_ids — imágenes subidas manualmente.

La ficha técnica muestra un máximo de 5 imágenes, independientemente del ajuste Image Count en PDF Manager. Si faltan imágenes:

1. Confirme que las imágenes se hayan importado. Vaya a la pantalla de edición del vehículo en WordPress y compruebe la sección de la galería de imágenes o la caja meta de medios.
2. Confirme que el interruptor Show Gallery esté activado en los ajustes de PDF Manager.
3. Si el vehículo tiene una imagen destacada establecida pero no tiene imágenes importadas, la ficha técnica utilizará la imagen destacada como alternativa.
4. Compruebe que las entradas de la biblioteca de medios de WordPress para las imágenes no estén eliminadas o dañadas.

Paso 6: Comprobar el código QR

El código QR es opcional y está desactivado por defecto. Cuando está activado, la ficha técnica utiliza la API pública de códigos QR en https://api.qrserver.com/v1/create-qr-code/ para generar una imagen. Este es un servicio externo que no requiere autenticación.

Si el código QR no aparece:

1. Confirme que el interruptor Show QR Code esté activado en los ajustes de PDF Manager.
2. Confirme que la URL publicada del vehículo no contenga autoscout24. en el host; el plugin suprime intencionadamente el código QR cuando la URL del vehículo se resuelve en el dominio AutoScout24.
3. Confirme que el servidor tenga acceso saliente a internet a api.qrserver.com en el puerto 443. En entornos de hosting restringidos, esta solicitud puede estar bloqueada.
4. La URL de la imagen del código QR se puede reemplazar utilizando el filtro as24ci_pdf_qr_image_url. Si una personalización está suprimiendo la imagen (devolviendo una cadena vacía), compruebe su tema activo y sus plugins para buscar este filtro.

Paso 7: Comprobar la información del vendedor

La información de contacto del vendedor en la ficha técnica se lee de los campos meta de usuario del autor de la entrada:

Si falta la información de contacto:

1. Vaya a Usuarios en la administración de WordPress y abra el perfil del autor de la entrada.
2. Compruebe si los campos del perfil del vendedor están rellenados.
3. Si la sección de campos del perfil del vendedor no está visible, confirme que la clase Seller_Profile_Fields esté activa (controlada por el inicio del plugin).

Referencia de configuración — Ajustes de PDF Manager

Los ajustes de PDF Manager se almacenan en la opción as24ci_pdf_manager_settings como un array serializado. Se gestionan en la pestaña de administración PDF Manager.

Branding (Identidad de marca)

Layout (Diseño)

QR code (Código QR)

Content fields (Campos de contenido)

Los siguientes campos se pueden mostrar u ocultar individualmente. Todos están activados por defecto.

Legal notice (Aviso legal)

Un campo de texto libre que se añade al final de la ficha técnica. Admite texto plano. Útil para descargos de responsabilidad legal o condiciones estándar de venta.

Notas de funcionamiento

• La página de la ficha técnica se renderiza como un documento HTML independiente. No utiliza la cabecera ni el pie de página del tema de WordPress. No se aplican el CSS del tema, las barras laterales ni los elementos de navegación.
• Los datos del vehículo se leen de la tabla de base de datos personalizada {prefix}as24_vehicles con una alternativa a los metadatos de entrada de WordPress. Si la tabla personalizada no existe (por ejemplo, en una instalación dañada o migrada), algunos campos pueden recurrir a los valores de los metadatos de la entrada.
• El campo de descripción utiliza el extracto de la entrada si hay uno establecido; de lo contrario, utiliza las primeras 150 palabras del contenido de la entrada.
• La URL de la ficha técnica utiliza una variable de consulta (no una regla de reescritura), por lo que funciona tanto en estructuras de enlaces permanentes bonitos como simples (?p=).
• No se requiere autenticación para ver la ficha técnica. Cualquier visitante con la URL puede acceder a ella para cualquier vehículo publicado. Si se requiere restringir el acceso, debe implementarse a nivel de hosting o CDN.

Resolución de problemas

Documentos relacionados

• Errores de importación de imágenes
• Problemas de visualización en el frontend
• Errores de permisos