Documentación · Guía del Frontend
PDF Datasheet
Este documento cubre la función de PDF datasheet (exposé del vehículo) del plugin ADP Car Market Hub WordPress: cómo acceden a ella los visitantes, qué contiene y cómo se configura.
Cuándo utilizar este documento
Lea este documento si va a activar la función de PDF datasheet por primera vez, si va a configurar su diseño de marca y contenido, o si va a solucionar problemas con el enlace de descarga o el resultado renderizado.
Descripción general
La función de PDF datasheet proporciona una página de resumen del vehículo optimizada para la impresión que los visitantes pueden abrir en su navegador y guardar o imprimir como PDF utilizando el cuadro de diálogo de impresión integrado del navegador. No es un archivo PDF generado en el servidor; en su lugar, es una página HTML independiente renderizada por el plugin específicamente para su impresión.
Cuando un visitante hace clic en el botón "Descargar PDF" en la página de detalles de un vehículo, el navegador navega a una URL especial. El plugin intercepta la solicitud, renderiza una página HTML independiente completa (sin el encabezado y pie de página del tema de WordPress) y finaliza la ejecución. El visitante puede entonces utilizar la función del navegador Archivo → Imprimir → Guardar como PDF para guardar el documento.
Requisitos o prerrequisitos
- La función de PDF datasheet debe estar activada en los ajustes del plugin (
FEATURE_PDF_DATASHEET). Está activada por defecto. - El vehículo debe estar publicado. Los borradores y las entradas privadas devuelven un error 404 desde el endpoint de la ficha técnica.
- Los enlaces permanentes amigables deben estar activados en WordPress para que la variable de consulta utilizada por la URL de la ficha técnica se procese correctamente.
Instrucciones paso a paso
Activar la función de PDF datasheet
- En la administración de WordPress, abra los ajustes del plugin.
- Localice el interruptor de la función PDF Datasheet y confirme que está activado.
- Diríjase a la sección PDF Manager para configurar la imagen de marca y los campos de contenido.
- Guarde los ajustes.
El botón "Descargar PDF" aparecerá en todas las páginas de detalles de vehículos publicadas.
Acceder al PDF datasheet como visitante
- Abra la página de detalles de un vehículo.
- Haga clic en el botón Descargar PDF o exposé.
- El navegador navegará a la página de la ficha técnica. Esta página no tiene encabezado ni pie de página del sitio; está diseñada específicamente para imprimir.
- Utilice la función de impresión del navegador (Ctrl+P o Cmd+P, o bien Archivo → Imprimir) y elija Guardar como PDF como destino.
- Ajuste la configuración de impresión si es necesario (tamaño del papel, márgenes) y guarde el archivo.
Acceder directamente a la URL de la ficha técnica
La ficha técnica está disponible en:
https://yoursite.com/?as24ci_pdf={post_id}donde {post_id} es el ID numérico de la entrada de WordPress del vehículo. Esta URL es accesible para cualquier visitante sin autenticación, siempre que el vehículo esté publicado.
Referencia de configuración
Interruptor de la función
| Ajuste | Clave de opción | Por defecto | Descripción |
|---|---|---|---|
| Activar PDF datasheet | as24ci_feature_pdf_datasheet | Activado (1) | Muestra u oculta el botón "Descargar PDF" en las páginas de detalles de vehículos |
Ajustes de PDF Manager
El PDF Manager controla la imagen de marca, el diseño y el contenido de la ficha técnica renderizada. Los ajustes se guardan como una única opción de array serializado (as24ci_pdf_manager_settings).
Imagen de marca:
| Ajuste | Por defecto | Descripción |
|---|---|---|
| Logotipo | Ninguno | Suba una imagen de logotipo para que aparezca en el encabezado |
| Mostrar empresa | Activado | Incluye el nombre de la empresa del vendedor |
| Mostrar dirección | Activado | Incluye la dirección del vendedor |
| Mostrar teléfono | Activado | Incluye el número de teléfono del vendedor |
| Mostrar email | Activado | Incluye la dirección de correo electrónico del vendedor |
| Mostrar sitio web | Desactivado | Incluye la URL del sitio web del vendedor |
| Color primario | #0073aa | Color principal utilizado para encabezados y acentos |
| Color de acento | #1a1a1a | Color secundario |
Diseño:
| Ajuste | Por defecto | Descripción |
|---|---|---|
| Formato del papel | A4 | Tamaño del papel para el diseño de impresión |
| Número de imágenes | 1 | Cuántas imágenes del vehículo se deben incluir en la ficha técnica |
| Mostrar galería | Activado | Si se debe mostrar la sección de la galería de imágenes |
| Mostrar caja de precio | Activado | Si se debe mostrar la sección del precio |
| Mostrar contacto | Activado | Si se debe mostrar la sección de información de contacto del vendedor |
Código QR:
| Ajuste | Por defecto | Descripción |
|---|---|---|
| Mostrar QR | Desactivado | Incluye un código QR que enlaza de vuelta a la página de detalles del vehículo en el sitio web |
El código QR se genera utilizando un servicio público de terceros (api.qrserver.com). Este servicio se invoca en el momento en que se carga la página de la ficha técnica. Si su política de privacidad no permite llamadas a servicios externos para los visitantes, esta opción debe permanecer desactivada, o bien se puede reemplazar la URL de la imagen QR mediante el filtro as24ci_pdf_qr_image_url.
Campos de contenido:
Los siguientes campos se pueden activar o desactivar individualmente en el PDF Manager:
| Clave del campo | Etiqueta |
|---|---|
title | Título del vehículo |
price | Precio |
mileage | Kilometraje |
first_reg | Primera matriculación |
fuel_type | Tipo de combustible |
transmission | Transmisión |
power | Potencia |
body_type | Tipo de carrocería |
exterior_color | Color exterior |
doors | Puertas |
seats | Asientos |
emission_class | Clase de emisión |
co2 | Valores de CO₂ |
consumption | Consumo de energía |
equipment | Lista de equipamiento |
description | Descripción del vehículo |
location | Ubicación |
contact | Información de contacto |
Todos los campos están activados por defecto. Desactivar un campo lo elimina de la ficha técnica renderizada para todos los vehículos.
Aviso legal:
Se puede añadir un texto de aviso legal personalizado. Este texto aparece en el pie de página de la ficha técnica. Utilice este campo para los descargos de responsabilidad legales obligatorios, notas al pie sobre precios o condiciones de uso.
Notas operativas
- El endpoint de la ficha técnica se activa mediante la variable de consulta
as24ci_pdf. El plugin registra esta variable en WordPress a través del filtroquery_varse intercepta la solicitud entemplate_redirect. - La página renderizada es un documento HTML independiente completo. No utiliza
wp_head()niwp_footer(). Todos los estilos están integrados en línea (inlined) dentro de la página. - La información del vendedor que se muestra en la ficha técnica se lee de los campos de metadatos de usuario del autor de la entrada (
as24ci_seller_display_name,as24ci_seller_email,as24ci_seller_phone,as24ci_seller_address). Si estos campos están vacíos, se utilizan el nombre de visualización y el correo electrónico del usuario de WordPress como alternativa. - Visitar la URL de la ficha técnica con un ID de entrada no válido devuelve un error HTTP 400. Visitarla con un ID válido de un vehículo no publicado devuelve un error HTTP 404.
- Los plugins de caché de página pueden almacenar en caché la URL de la ficha técnica. Para evitar esto, configure su plugin de caché para excluir las URL que contengan el parámetro de consulta
as24ci_pdf.
Resolución de problemas
El botón "Descargar PDF" no aparece en las páginas de vehículos.
- Confirme que la función de PDF datasheet está activada en los ajustes del plugin.
- Compruebe el Layout Manager para asegurarse de que el elemento de descarga de PDF está activo para la zona de la página de vehículo individual.
La URL de la ficha técnica devuelve un error 404.
- Verifique que el vehículo esté publicado. Los borradores, las entradas privadas y los vehículos eliminados devuelven un error 404.
- Compruebe que el tipo de entrada coincida con el tipo de entrada personalizado del plugin (
as24ci_car).
La URL de la ficha técnica devuelve un error 400.
- El ID de la entrada en la URL no es válido o es cero. Verifique que la URL se esté generando correctamente.
La ficha técnica se renderiza sin logotipo ni imagen de marca.
- En el PDF Manager, confirme que se ha seleccionado y guardado una imagen de logotipo.
- Si el logotipo no aparece, verifique que el ID de adjunto guardado en los ajustes del PDF Manager apunte a una imagen subida válida.
El código QR no aparece en la ficha técnica.
- Confirme que la opción de código QR está activada en el PDF Manager.
- Se llama al servicio de QR (
api.qrserver.com) cuando se carga la página. Si su hosting bloquea las solicitudes HTTP salientes o el servicio no está disponible temporalmente, es posible que la imagen no se cargue. - Puede reemplazar la URL de la imagen QR utilizando el filtro
as24ci_pdf_qr_image_url. Devuelva una cadena vacía desde el filtro para suprimir el código QR por completo.
La ficha técnica se está almacenando en caché de forma incorrecta por un plugin de caché.
- Añada el parámetro de consulta
as24ci_pdfa la lista de URL o parámetros excluidos de su plugin de caché.