Problèmes de PDF Datasheet

Ce document couvre les problèmes liés à la fonctionnalité de fiche technique du véhicule optimisée pour l'impression de l'extension ADP Car Market Hub, y compris l'accès, le rendu, les données manquantes, les images, les réglages et la génération de codes QR.

Quand utiliser ce document

Lisez ce document lorsque :

• L'URL de la fiche technique (?as24ci_pdf={post_id}) renvoie une erreur 404 ou une page blanche.
• La page de la fiche technique s'ouvre mais certains champs, images ou sections sont manquants.
• Le bouton ou le lien « Imprimer la fiche technique » n'apparaît pas sur les pages de détails du véhicule.
• Les réglages du PDF Manager ne sont pas appliqués à la fiche technique générée.
• Le code QR est manquant ou affiche une image d'erreur.

Aperçu

La fonctionnalité PDF Datasheet génère une page HTML autonome et optimisée pour l'impression pour chaque véhicule. La page n'est pas un véritable fichier PDF — c'est un document HTML stylisé avec du CSS d'impression que le visiteur (ou l'automatisation du navigateur) convertit en PDF à l'aide de la fonction Imprimer → Enregistrer au format PDF du navigateur. Aucune bibliothèque PDF PHP n'est requise.

La fiche technique est accessible via une variable de requête ajoutée à l'URL d'accueil du site :

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

Où {post_id} est l'ID numérique de la publication WordPress du véhicule. La page n'est générée que pour les publications as24ci_car publiées. Les brouillons, les publications mises à la corbeille ou les publications de tout autre type renvoient une erreur 404.

La fonctionnalité est désactivée par défaut. Elle doit être explicitement activée dans les réglages de l'extension avant de pouvoir répondre à toute requête.

Configuration requise

• L'extension doit être active.
• L'option PDF Datasheet doit être activée dans les réglages de l'extension (l'interrupteur principal se trouve sur l'onglet Design & Styles ; la configuration au niveau du modèle se trouve sur l'onglet PDF Manager).
• Les permaliens WordPress doivent être fonctionnels (simples ou personnalisés).
• La publication du véhicule doit être au statut publish.
• Le navigateur du visiteur doit prendre en charge les feuilles de style d'impression CSS pour produire un PDF bien formaté lors de l'impression.

Étapes de diagnostic

Étape 1 : Confirmer que la fonctionnalité est activée

La fonctionnalité PDF Datasheet est désactivée par défaut sur les nouvelles installations.

1. Allez dans l'administration de l'extension et ouvrez les réglages Features ou Design & Styles.
2. Recherchez l'interrupteur PDF Datasheet.
3. Activez-le et enregistrez.
4. Après l'activation, videz le cache des permaliens WordPress en allant dans Réglages → Permaliens et en cliquant sur Enregistrer les modifications.

Étape 2 : Vérifier l'ID et le statut de la publication du véhicule

Le format de l'URL est ?as24ci_pdf={post_id}. Si vous utilisez un mauvais ID de publication, ou si le véhicule n'est pas publié, vous recevrez une erreur :

• Un ID de publication invalide (non numérique ou négatif) renvoie une erreur HTTP 400 (« ID de véhicule invalide »).
• Une publication qui n'existe pas, qui n'est pas de type as24ci_car ou qui n'est pas publiée renvoie une erreur HTTP 404 (« Véhicule non trouvé ou non publié »).

Pour trouver l'ID de publication correct :

1. Allez sur l'écran de modification du véhicule dans l'administration WordPress.
2. L'ID de la publication apparaît dans l'URL : ?post=12345.
3. Testez l'URL de la fiche technique : https://your-site.com/?as24ci_pdf=12345.

Étape 3 : Vérifier que la variable de requête est enregistrée

La fiche technique utilise la variable de requête WordPress as24ci_pdf. Si une autre extension ou un thème désenregistre ou entre en conflit avec les variables de requête personnalisées, la fiche technique peut ne pas se déclencher.

1. Après avoir activé la fonctionnalité, videz les permaliens (Réglages → Permaliens → Enregistrer les modifications).
2. Si l'URL ne fonctionne toujours pas, vérifiez si une extension de sécurité ou de mise en cache ne supprime pas les paramètres de requête inconnus des requêtes.

Étape 4 : Diagnostiquer les champs ou sections manquants

Les réglages du PDF Manager (stockés dans l'option as24ci_pdf_manager_settings) contrôlent quels champs et sections apparaissent sur la fiche technique. Si des champs sont manquants :

1. Allez dans l'onglet d'administration PDF Manager.
2. Passez en revue les cases à cocher Content fields. Tout champ qui n'est pas coché n'apparaîtra pas sur la fiche technique.
3. Passez en revue la section Layout pour les options telles que Show Gallery, Show Price Box et Show Contact Information.
4. Enregistrez les réglages et rechargez la fiche technique.

Si un champ est activé dans le PDF Manager mais n'apparaît toujours pas, il se peut que le véhicule n'ait pas de données pour ce champ. Par exemple, si le véhicule a été importé sans prix, le champ du prix ne s'affichera pas même s'il est activé.

Étape 5 : Diagnostiquer les images manquantes

La fiche technique utilise les images de deux champs méta :

• _as24ci_image_ids — images importées depuis l'API.
• _as24ci_manual_image_ids — images téléversées manuellement.

La fiche technique affiche un maximum de 5 images, quel que soit le réglage Image Count dans le PDF Manager. Si des images sont manquantes :

1. Confirmez que les images ont été importées. Allez sur l'écran de modification du véhicule dans WordPress et vérifiez la boîte méta Médias ou la section de la galerie d'images.
2. Confirmez que l'option Show Gallery est activée dans les réglages du PDF Manager.
3. Si le véhicule a une image mise en avant définie mais pas d'images importées, la fiche technique utilisera l'image mise en avant comme solution de secours.
4. Vérifiez que les entrées de la médiathèque WordPress pour les images ne sont pas supprimées ou corrompues.

Étape 6 : Vérifier le code QR

Le code QR est facultatif et est désactivé par défaut. Lorsqu'il est activé, la fiche technique utilise l'API publique de code QR à l'adresse https://api.qrserver.com/v1/create-qr-code/ pour générer une image. Il s'agit d'un service externe sans exigence d'authentification.

Si le code QR n'apparaît pas :

1. Confirmez que l'option Show QR Code est activée dans les réglages du PDF Manager.
2. Confirmez que l'URL publiée du véhicule ne contient pas autoscout24. dans l'hôte — l'extension supprime intentionnellement le code QR lorsque l'URL du véhicule correspond au domaine AutoScout24.
3. Confirmez que le serveur dispose d'un accès Internet sortant vers api.qrserver.com sur le port 443. Dans les environnements d'hébergement restreints, cette requête peut être bloquée.
4. L'URL de l'image du code QR peut être remplacée à l'aide du filtre as24ci_pdf_qr_image_url. Si une personnalisation supprime l'image (en renvoyant une chaîne vide), vérifiez votre thème actif et vos extensions pour ce filtre.

Étape 7 : Vérifier les informations du vendeur

Les coordonnées de contact du vendeur sur la fiche technique sont lues à partir des champs méta de l'utilisateur auteur de la publication :

Si les informations de contact sont manquantes :

1. Allez dans Comptes dans l'administration WordPress et ouvrez le profil de l'auteur de la publication.
2. Vérifiez si les champs du profil du vendeur sont renseignés.
3. Si la section des champs du profil du vendeur n'est pas visible, confirmez que la classe Seller_Profile_Fields est active (contrôlée par l'initialisation de l'extension).

Référence de configuration — Réglages du PDF Manager

Les réglages du PDF Manager sont stockés dans l'option as24ci_pdf_manager_settings sous forme de tableau sérialisé. Ils sont gérés dans l'onglet d'administration PDF Manager.

Branding

Layout

QR code

Content fields

Les champs suivants peuvent être affichés ou masqués individuellement. Tous sont activés par défaut.

Mentions légales

Un champ de texte libre ajouté au bas de la fiche technique. Accepte le texte brut. Utile pour les clauses de non-responsabilité légales ou les conditions générales de vente standard.

Notes opérationnelles

• La page de la fiche technique est générée sous forme de document HTML autonome. Elle n'utilise pas l'en-tête ou le pied de page du thème WordPress. Le CSS du thème, les barres latérales et les éléments de navigation ne s'appliquent pas.
• Les données du véhicule sont lues à partir de la table de base de données personnalisée {prefix}as24_vehicles avec un recours aux métadonnées de publication WordPress. Si la table personnalisée n'existe pas (par exemple sur une installation corrompue ou migrée), certains champs peuvent utiliser les valeurs des métadonnées de publication.
• Le champ de description utilise l'extrait de la publication si un extrait est défini ; sinon, il utilise les 150 premiers mots du contenu de la publication.
• L'URL de la fiche technique utilise une variable de requête (et non une règle de réécriture), elle fonctionne donc à la fois sur les structures de permaliens personnalisés et simples (?p=).
• Il n'y a pas d'exigence d'authentification pour voir la fiche technique. Tout visiteur disposant de l'URL peut y accéder pour n'importe quel véhicule publié. Si une restriction d'accès est requise, elle doit être implémentée au niveau de l'hébergement ou du CDN.

Dépannage

Documents connexes

• Erreurs d'importation d'images
• Problèmes d'affichage sur le frontend
• Erreurs d'autorisation