Problèmes d'affichage sur le frontend

Ce document couvre les problèmes liés à la manière dont les annonces de véhicules sont affichées sur les pages publiques d'un site WordPress utilisant l'extension ADP Car Market Hub. Il traite des pages d'archive, des pages de détails de véhicules individuels, des conflits de thèmes, des problèmes de permaliens et des problèmes de chargement des ressources.

Quand utiliser ce document

Lisez ce document lorsque :

• La page d'archive des véhicules (/cars/ ou le slug configuré) n'affiche aucune annonce, renvoie une erreur 404 ou est introuvable.
• Les pages de détails de véhicules individuels ne s'affichent pas ou manquent de mise en page et de style.
• Les filtres sur la page d'archive ne fonctionnent pas ou ne renvoient pas les résultats attendus.
• Le CSS ou le JavaScript de l'extension ne se charge pas sur les pages du frontend.
• Le thème actif surcharge ou entre en conflit avec les modèles de l'extension.
• La pagination sur l'archive ou sur une page d'annonces intégrée par code court ne fonctionne pas.

Aperçu

L'extension enregistre un type de publication personnalisé (as24ci_car) avec le slug d'archive cars et fournit deux fichiers de modèle :

• templates/archive-as24ci_car.php — utilisé pour la page d'archive des véhicules.
• templates/single-as24ci_car.php — utilisé pour les pages de détails de véhicules individuels.

WordPress résout les modèles en utilisant la hiérarchie standard des modèles. L'extension se greffe sur les filtres single_template et archive_template. Elle vérifie d'abord si le thème actif fournit une surcharge personnalisée (single-as24ci_car.php ou archive-as24ci_car.php dans le répertoire du thème), et utilise le propre modèle de l'extension comme solution de repli. Cela signifie qu'un thème peut contrôler entièrement la mise en page s'il fournit un fichier de modèle correspondant.

Le CSS et le JavaScript sont mis en file d'attente automatiquement en détectant le type de page actuel. Sur les pages où un code court est utilisé pour intégrer l'archive, les ressources sont détectées via has_shortcode() par rapport au contenu de la publication de la page.

Prérequis

• Au moins une publication de véhicule existe et est publiée.
• Les permaliens sont configurés sur une option autre que « Simple » (pour que le routage de l'archive fonctionne correctement). Allez dans Réglages → Permaliens et choisissez n'importe quelle option autre que le réglage par défaut « Simple », puis cliquez sur Enregistrer les modifications.
• L'extension est active et aucune erreur fatale PHP n'est présente (vérifiez Outils → État de santé du site ou le journal des erreurs PHP).

Étapes de diagnostic

Étape 1 : Régénérer les permaliens

La plupart des erreurs 404 d'archive sont causées par des règles de permaliens obsolètes. C'est la première chose à essayer chaque fois que l'archive des véhicules ou les pages individuelles renvoient une erreur 404.

1. Allez dans Réglages → Permaliens dans l'administration de WordPress.
2. Cliquez sur Enregistrer les modifications sans modifier aucun réglage. Cela reconstruit les règles de réécriture.
3. Visitez l'URL de l'archive des véhicules (généralement /cars/) et confirmez qu'elle se charge.

Étape 2 : Confirmer l'URL de l'archive des véhicules

L'extension enregistre le CPT avec le slug d'archive cars. L'URL de l'archive est généralement :

https://your-site.example.com/cars/

Si WordPress est installé dans un sous-répertoire, ou si la structure des permaliens utilise un préfixe, l'URL de l'archive le reflétera. Utilisez get_post_type_archive_link('as24ci_car') (via WP-CLI ou un extrait de code de test) pour confirmer l'URL exacte.

Étape 3 : Vérifier si l'archive du CPT est activée

Le type de publication personnalisé est enregistré avec has_archive = true. Si WordPress ne redirige pas vers l'archive, confirmez que :

1. Les permaliens ne sont pas configurés sur « Simple ». Les permaliens simples désactivent le routage de l'archive du CPT.
2. Aucun plugin de mise en cache ne sert une réponse 404 obsolète pour l'URL de l'archive. Videz le cache après avoir régénéré les permaliens.
3. Aucune règle .htaccess ou configuration de serveur ne bloque l'URL de l'archive.

Étape 4 : Vérifier les conflits de thèmes

Si le modèle d'archive ou le modèle individuel s'affiche de manière incorrecte, un conflit de thème peut en être responsable :

1. Basculez temporairement vers un thème WordPress par défaut (tel que Twenty Twenty-Four) et visitez l'archive des véhicules ainsi qu'une page de véhicule individuel.
2. Si les pages s'affichent correctement avec le thème par défaut, votre thème actif est à l'origine du conflit.
3. Causes courantes : le thème actif fournit son propre modèle archive-as24ci_car.php ou single-as24ci_car.php qui est obsolète ou incompatible ; le thème génère une structure HTML incorrecte autour du contenu ; le propre CSS du thème entre en conflit avec les styles de l'extension.

Étape 5 : Vérifier que le CSS et le JavaScript se chargent

Si l'archive des véhicules ou la page individuelle affiche un contenu sans style ou des éléments interactifs non fonctionnels (menus déroulants de filtres, galerie, visionneuse) :

1. Ouvrez la page dans un navigateur et affichez le code source de la page ou utilisez les outils de développement du navigateur (onglet Réseau).
2. Confirmez que les feuilles de style de l'extension sont présentes : - Sur les pages d'archive : as24ci-archive.css - Sur les pages de véhicules individuels : as24ci-single.css
3. Si celles-ci sont manquantes : - Confirmez que la page est correctement reconnue comme l'archive du CPT ou comme une publication CPT individuelle. - Si vous utilisez un code court pour intégrer l'archive sur une page standard, confirmez que le code court [as24ci_archive] se trouve dans le contenu de la publication de la page (et non dans un widget, une partie de modèle ou un champ personnalisé traité en dehors de the_content). Les ressources sont détectées en lisant le contenu de la publication avec has_shortcode(). - Si une extension de performance ou de minification concatène ou diffère les scripts, elle peut interférer avec le JavaScript de l'extension. Testez en désactivant cette extension.
4. Confirmez qu'aucun autre plugin ou thème n'appelle wp_dequeue_style ou wp_dequeue_script pour les ressources de l'extension.

Étape 6 : Vérifier le comportement des filtres de l'archive

L'archive des véhicules prend en charge les paramètres de filtrage transmis via la chaîne de requête URL (par exemple, ?make=volkswagen&fuel_type=diesel). Si les filtres ne fonctionnent pas :

1. Confirmez que les widgets de filtrage sont affichés (ils sont générés par le modèle d'archive).
2. Confirmez que le filtre spécifique est activé dans les réglages de Filtre ou du Gestionnaire de mise en page de l'extension. Les filtres désactivés n'apparaîtront pas et leurs paramètres GET seront ignorés.
3. Confirmez qu'aucune couche de mise en cache ne sert une version mise en cache de la page d'archive indépendamment des paramètres de requête. La plupart des extensions de mise en cache doivent être configurées pour exclure de la mise en cache les pages contenant des chaînes de requête.

Étape 7 : Enquêter sur les problèmes de pagination

Si la pagination sur la page d'archive ne fonctionne pas (cliquer sur la page 2 renvoie les mêmes résultats) :

1. Confirmez que la structure des permaliens n'est pas « Simple ».
2. Sur les pages d'archive intégrées par code court, la pagination utilise les paramètres de requête ?paged=2 (ou ?page=2). Confirmez qu'aucune redirection ne supprime ces paramètres.
3. Sur l'URL réelle de l'archive du CPT, WordPress gère la pagination de manière native. Régénérez les permaliens si elle est cassée.

Étape 8 : Vérifier les erreurs PHP

Une erreur fatale ou un avertissement PHP peut interrompre silencieusement la génération de la page ou provoquer un affichage partiel :

1. Activez temporairement le mode de débogage de WordPress en ajoutant ceci à wp-config.php : ``php define( 'WP_DEBUG', true ); define( 'WP_DEBUG_LOG', true ); define( 'WP_DEBUG_DISPLAY', false ); ``
2. Visitez la page problématique et vérifiez wp-content/debug.log pour y trouver des erreurs.
3. Désactivez à nouveau le mode de débogage après votre enquête.

Référence de configuration

Notes opérationnelles

• Les fichiers de modèle de l'extension sont situés dans le répertoire templates/ de l'extension. Ne modifiez pas ces fichiers directement, car les mises à jour écraseront vos modifications. Pour personnaliser les modèles, copiez-les dans le répertoire de votre thème actif et modifiez la copie à cet endroit.
• Le modèle d'archive résout les valeurs de filtre en utilisant les taxonomies de WordPress (as24ci_brand, as24ci_model, as24ci_fuel_type, etc.) et une table de base de données personnalisée (wp_as24_vehicles) pour les champs numériques tels que le prix et le kilométrage.
• Si la page d'archive est intégrée à l'aide du code court [as24ci_archive] sur une page WordPress standard, la page ne doit pas avoir sa propre boucle de requête ou un contenu qui interfère avec la variable globale $wp_query. Le code court remplace temporairement $wp_query pendant le rendu et le restaure ensuite.
• Le CSS dynamique (réglages de design tels que les couleurs) est généré en ligne dans la balise <head> via une action wp_head avec une priorité de 99.

Dépannage

Documents connexes

• Aperçu du dépannage
• Problèmes de codes courts
• Erreurs d'importation d'images
• Erreurs d'autorisation