Fiche technique PDF

Ce document couvre la fonctionnalité de fiche technique PDF (exposé du véhicule) de l'extension ADP Car Market Hub WordPress : comment les visiteurs y accèdent, ce qu'elle contient et comment elle est configurée.

Quand utiliser ce document

Lisez ce document si vous activez la fonctionnalité de fiche technique PDF pour la première fois, si vous configurez son image de marque et son contenu, ou si vous résolvez des problèmes liés au lien de téléchargement ou au rendu final.

Aperçu

La fonctionnalité de fiche technique PDF fournit une page de résumé du véhicule optimisée pour l'impression que les visiteurs peuvent ouvrir dans leur navigateur et enregistrer ou imprimer au format PDF à l'aide de la boîte de dialogue d'impression intégrée du navigateur. Il ne s'agit pas d'un fichier PDF généré par le serveur ; il s'agit plutôt d'une page HTML autonome générée par l'extension spécifiquement pour l'impression.

Lorsqu'un visiteur clique sur le bouton « Télécharger le PDF » sur une page de détails de véhicule, le navigateur navigue vers une URL spéciale. L'extension intercepte la requête, génère une page HTML autonome complète (sans l'en-tête et le pied de page du thème WordPress) et s'arrête. Le visiteur peut ensuite utiliser la fonction Fichier → Imprimer → Enregistrer au format PDF de son navigateur pour enregistrer le document.

Configuration requise ou prérequis

• La fonctionnalité de fiche technique PDF doit être activée dans les réglages de l'extension (FEATURE_PDF_DATASHEET). Elle est activée par défaut.
• Le véhicule doit être publié. Les brouillons et les articles privés renvoient une erreur 404 depuis le point de terminaison de la fiche technique.
• Les permaliens personnalisés doivent être activés dans WordPress pour que la variable de requête utilisée par l'URL de la fiche technique soit traitée correctement.

Instructions étape par étape

Activer la fonctionnalité de fiche technique PDF

1. Dans l'administration WordPress, ouvrez les réglages de l'extension.
2. Localisez le commutateur de la fonctionnalité Fiche technique PDF et confirmez qu'il est activé.
3. Accédez à la section PDF Manager pour configurer l'image de marque et les champs de contenu.
4. Enregistrez les réglages.

Le bouton « Télécharger le PDF » apparaîtra sur toutes les pages de détails de véhicules publiées.

Accéder à la fiche technique PDF en tant que visiteur

1. Ouvrez une page de détails de véhicule.
2. Cliquez sur le bouton Télécharger le PDF ou exposé.
3. Le navigateur navigue vers la page de la fiche technique. Cette page ne comporte ni en-tête ni pied de page de site — elle est stylisée spécifiquement pour l'impression.
4. Utilisez la fonction d'impression du navigateur (Ctrl+P ou Cmd+P, ou Fichier → Imprimer) et choisissez Enregistrer au format PDF comme destination.
5. Ajustez les paramètres d'impression si nécessaire (taille du papier, marges) et enregistrez le fichier.

Accéder directement à l'URL de la fiche technique

La fiche technique est disponible à l'adresse :

https://yoursite.com/?as24ci_pdf={post_id}

où {post_id} est l'ID d'article numérique WordPress du véhicule. Cette URL est accessible à tout visiteur sans authentification, tant que le véhicule est publié.

Référence de configuration

Commutateur de fonctionnalité

Réglages du PDF Manager

Le PDF Manager contrôle l'image de marque, la mise en page et le contenu de la fiche technique générée. Les réglages sont stockés sous forme d'une option unique de tableau sérialisé (as24ci_pdf_manager_settings).

Image de marque :

Mise en page :

Code QR :

Le code QR est généré à l'aide d'un service tiers public (api.qrserver.com). Ce service est appelé au moment du chargement de la page de la fiche technique. Si votre politique de confidentialité n'autorise pas les appels de services externes pour les visiteurs, cette option doit rester désactivée, ou l'URL de l'image QR peut être remplacée via le filtre as24ci_pdf_qr_image_url.

Champs de contenu :

Les champs suivants peuvent être activés ou désactivés individuellement dans le PDF Manager :

Tous les champs sont activés par défaut. La désactivation d'un champ le supprime de la fiche technique générée pour tous les véhicules.

Mentions légales :

Un texte de mentions légales personnalisé peut être ajouté. Ce texte apparaît dans le pied de page de la fiche technique. Utilisez ce champ pour les clauses de non-responsabilité légales requises, les notes de bas de page sur les prix ou les conditions d'utilisation.

Notes opérationnelles

• Le point de terminaison de la fiche technique est déclenché par la variable de requête as24ci_pdf. L'extension enregistre cette variable auprès de WordPress via le filtre query_vars et intercepte la requête dans template_redirect.
• La page générée est un document HTML autonome complet. Elle n'utilise pas wp_head() ni wp_footer(). Tous les styles sont intégrés (inlined) dans la page.
• Les informations du vendeur affichées sur la fiche technique sont lues à partir des champs de métadonnées utilisateur de l'auteur de l'article (as24ci_seller_display_name, as24ci_seller_email, as24ci_seller_phone, as24ci_seller_address). Si ces champs sont vides, le nom d'affichage et l'e-mail de l'utilisateur WordPress sont utilisés comme solution de repli.
• Accéder à l'URL de la fiche technique avec un ID d'article non valide renvoie une erreur HTTP 400. Accéder avec un ID valide pour un véhicule non publié renvoie une erreur HTTP 404.
• Les extensions de mise en cache de pages peuvent mettre en cache l'URL de la fiche technique. Pour éviter cela, configurez votre extension de mise en cache pour exclure les URL contenant le paramètre de requête as24ci_pdf.

Dépannage

Le bouton « Télécharger le PDF » n'apparaît pas sur les pages de véhicules.

• Confirmez que la fonctionnalité de fiche technique PDF est activée dans les réglages de l'extension.
• Vérifiez le Layout Manager pour vous assurer que l'élément de téléchargement PDF est actif pour la zone de la page de véhicule unique.

L'URL de la fiche technique renvoie une erreur 404.

• Vérifiez que le véhicule est publié. Les brouillons, les articles privés et les véhicules supprimés renvoient une erreur 404.
• Vérifiez que le type d'article correspond au type d'article personnalisé de l'extension (as24ci_car).

L'URL de la fiche technique renvoie une erreur 400.

• L'ID d'article dans l'URL est invalide ou égal à zéro. Vérifiez que l'URL est générée correctement.

La fiche technique s'affiche sans logo ni image de marque.

• Dans le PDF Manager, confirmez qu'une image de logo a été sélectionnée et enregistrée.
• Si le logo n'apparaît pas, vérifiez que l'ID de pièce jointe stocké dans les réglages du PDF Manager pointe vers une image téléversée valide.

Le code QR n'apparaît pas sur la fiche technique.

• Confirmez que l'option de code QR est activée dans le PDF Manager.
• Le service de QR code (api.qrserver.com) est appelé lors du chargement de la page. Si votre hébergement bloque les requêtes HTTP sortantes ou si le service est temporairement indisponible, l'image peut ne pas se charger.
• Vous pouvez remplacer l'URL de l'image du code QR en utilisant le filtre as24ci_pdf_qr_image_url. Renvoyez une chaîne vide depuis le filtre pour masquer complètement le code QR.

La fiche technique est incorrectement mise en cache par une extension de cache.

• Ajoutez le paramètre de requête as24ci_pdf à la liste des URL ou paramètres exclus de votre extension de mise en cache.

Documents connexes

• Pages de détails des véhicules
• Emplacement et horaires d'ouverture