Documentation · System Requirements

Configuration requise pour WordPress

Introduction

ADP Car Market Hub est un plugin WordPress natif. Il n'intègre pas son propre CMS, constructeur de page ou framework front-end — à la place, il s'appuie sur les mécanismes WordPress standards (custom post types, taxonomies, bibliothèque de médias, REST API, WP-Cron, rôles/capacités et nonces).

Ce document décrit tout ce que ADP Car Market Hub attend de l'installation WordPress sur laquelle il s'exécute : versions WordPress prises en charge, autorisations d'administrateur requises, comportement des permaliens, utilisation de la bibliothèque de médias, dépendance au cron et considérations de compatibilité connues.

Quand utiliser ce document

Utilisez ce document lorsque vous :

  • Devez confirmer qu'un site WordPress existant peut héberger le plugin.
  • Configurez les rôles et capacités des utilisateurs pour l'équipe d'une concession.
  • Planifiez les réglages de permaliens, de médias ou de cache pour un nouveau site.
  • Auditez la compatibilité des plugins avant d'installer des extensions supplémentaires aux côtés de ADP Car Market Hub.

Aperçu

ADP Car Market Hub s'intègre à WordPress de la manière suivante :

  • Enregistre un custom post type as24ci_car avec sa propre carte de capacités (as24ci_car / as24ci_cars) et 15 taxonomies de véhicules.
  • Enregistre une capacité personnalisée manage_as24_imports et un rôle « AS24 Editor » pour la gestion déléguée ; les administrateurs conservent toujours un accès complet.
  • Stocke les images des véhicules sous forme de pièces jointes WordPress standards dans la bibliothèque de médias.
  • Ajoute une page d'administration (le menu « ADP Car Market Hub ») avec plusieurs onglets (Réglages, Automatisation, Mapping, Assistant IA, Santé, Outils, etc.).
  • Utilise WP-Cron pour les importations planifiées et expose un point de terminaison REST sécurisé par jeton à l'adresse /as24ci/v1/cron-import pour les déclencheurs externes.
  • Ajoute des shortcodes (archive de véhicules, comparaison, favoris, etc.) et des surcharges de modèles sous templates/ afin que les thèmes puissent personnaliser le front-end.
  • Lit les modèles du thème actif et la hiérarchie standard single-{post-type}.php / archive-{post-type}.php.

Configuration requise

Version de WordPress

  • Minimum : WordPress 6.2 (Requires at least: 6.2 dans l'en-tête du plugin et readme.txt).
  • Testé jusqu'à : WordPress 6.9 (Tested up to: 6.9 dans readme.txt).
  • Recommandé : Exécutez toujours la dernière version stable de WordPress sur une branche prise en charge et gardez les mises à jour de sécurité de WordPress activées.

Multisite

Le plugin est conçu et testé pour des installations WordPress sur un seul site. L'activation réseau sur un Multisite n'est pas un cas d'utilisation documenté ; installez-le et activez-le plutôt sur des sites individuels.

Autorisations d'administrateur

Deux couches d'autorisation distinctes sont impliquées :

  • L'installation et la configuration globale nécessitent manage_options (c'est-à-dire un administrateur). Le plugin utilise current_user_can( 'manage_options' ) pour restreindre les migrations de capacités et les outils dangereux.
  • La gestion quotidienne du plugin est contrôlée par la capacité personnalisée manage_as24_imports. Lors de l'activation, le plugin attribue cette capacité (ainsi que l'ensemble des capacités CPT as24ci_car / as24ci_cars) au rôle d'administrateur et au rôle dédié « AS24 Editor » qu'il crée. Le rôle standard « Éditeur » de WordPress ne reçoit pas ces capacités par conception.
  • Toutes les actions POST d'administration, les gestionnaires AJAX et les widgets du tableau de bord vérifient à nouveau la capacité et valident un nonce WordPress. Les sites sécurisés (rôles personnalisés, plugins de gestion des rôles, politiques d'administration restreintes) doivent donc accorder manage_as24_imports à tout utilisateur devant être capable de lancer des importations ou de modifier les réglages du plugin.

Permaliens

  • Les permaliens personnalisés (pretty permalinks) doivent être activés. Tout réglage autre que « Simple » convient (Date et titre, Mois et titre, Titre de la publication, Structure personnalisée).
  • Le custom post type as24ci_car est enregistré avec des règles de réécriture. Après avoir activé le plugin ou modifié ses options liées aux slugs, visitez Réglages → Permaliens et cliquez une fois sur Enregistrer les modifications pour vider les règles de réécriture.
  • Le point de terminaison REST sécurisé par jeton /as24ci/v1/cron-import est également enregistré via l'API REST standard de WordPress et fonctionnera dès que l'API REST elle-même sera accessible.

Bibliothèque de médias

  • Les images des véhicules sont importées en tant que pièces jointes WordPress standards et stockées dans wp-content/uploads/ selon la structure habituelle année/mois.
  • Le plugin respecte les réglages de gestion des images de WordPress : tailles des miniatures, tailles intermédiaires, éditeur d'images (GD ou Imagick) et chemins de téléversement.
  • La conversion WebP facultative utilise la même bibliothèque d'images (GD ou Imagick) que celle configurée pour WordPress.
  • Un réglage Nombre max d'images par véhicule limite le nombre de pièces jointes créées par voiture. Le plugin déduplique les images par URL source afin que les réimportations ne créent pas de doublons.
  • La suppression d'un véhicule via le plugin (ou via la synchronisation complète) supprime également les pièces jointes associées pour garder la bibliothèque de médias propre.
  • La prévention du hot-linking, les plugins de déchargement CDN (par exemple, le déplacement des téléversements vers S3) et les optimiseurs d'images sont compatibles tant qu'ils se connectent au cycle de vie standard des pièces jointes de WordPress.

Dépendance au cron

  • Les importations planifiées reposent sur WP-Cron. Le plugin enregistre un intervalle supplémentaire (toutes les 6 heures) et un intervalle personnalisé configurable (minimum 15 minutes) en plus des valeurs par défaut de WordPress.
  • Les sites ayant un trafic faible ou imprévisible doivent désactiver le cron par défaut au chargement des pages et déclencher WP-Cron depuis un véritable cron système (OS), ou appeler le point de terminaison REST sécurisé par jeton /as24ci/v1/cron-import depuis un planificateur externe.
  • Un verrou d'importation interne (transitoire, TTL de 40 minutes) empêche le chevauchement de deux exécutions de cron. Cela sécurise les déclenchements externes « toutes les 5 minutes ».
  • Les autres plugins basés sur le cron (Action Scheduler, WooCommerce, plugins de sauvegarde) coexistent sans conflit ; le plugin utilise ses propres noms de hooks dédiés sous le préfixe as24ci_.

Considérations de compatibilité des plugins

  • Plugins SEO : L'Assistant IA écrit les méta-titres et méta-descriptions dans les formats attendus par Yoast SEO et Rank Math.
  • Plugins de mise en cache : Les caches de page sont compatibles. Excluez les pages d'administration de WordPress et la route REST /as24ci/v1/cron-import de la mise en cache. Les caches d'objets (Redis, Memcached) sont pris en charge via l'API de cache standard de WordPress.
  • Plugins de sécurité / WAF : Autorisez le trafic HTTPS sortant vers AutoScout24 (et vers le point de terminaison géré de Google Gemini lorsque les fonctionnalités d'IA sont activées) et ne bloquez pas les requêtes POST vers les pages d'administration du plugin ou vers son point de terminaison REST. Le jeton cron doit être inclus dans la requête comme documenté dans l'onglet Importations et limites.
  • Constructeurs de pages / thèmes basés sur des blocs : Les pages de véhicule unique et d'archive s'affichent via les modèles et shortcodes standards de WordPress, de sorte que tout thème — classique ou basé sur des blocs — qui respecte la hiérarchie des modèles fonctionnera.
  • Plugins de traduction : Le plugin est entièrement internationalisé sous le domaine de texte adp-car-market-hub (languages/). Les plugins de traduction qui fonctionnent sur les chaînes de caractères standards de WordPress fonctionnent comme prévu.

Configuration de production recommandée

  • Dernière version stable de WordPress avec les mises à jour mineures automatiques activées.
  • Permaliens personnalisés définis sur Titre de la publication ou Structure personnalisée.
  • Compte administrateur dédié à la maintenance du plugin, plus un ou plusieurs utilisateurs « AS24 Editor » pour le travail quotidien.
  • Un véritable cron au niveau du système d'exploitation déclenchant wp-cron.php (ou le point de terminaison REST du cron) toutes les 5 à 15 minutes, avec DISABLE_WP_CRON défini sur true.
  • Un thème offrant un support natif pour les modèles de custom post types, ou un thème enfant qui surcharge les modèles du plugin selon les besoins.
  • Cache d'objets (Redis ou Memcached) sur les sites à fort trafic pour accélérer les onglets d'administration qui agrègent les données d'analyse ou de leads.

Notes opérationnelles

  • Videz à nouveau les règles de réécriture (Réglages → Permaliens → Enregistrer) après chaque mise à jour du plugin qui modifie la structure des URL ou après une migration entre environnements.
  • Le plugin écrit uniquement dans ses propres clés d'options (as24ci_*), ses propres tables personnalisées, les tables standards posts/postmeta/term de WordPress pour as24ci_car, et dans la bibliothèque de médias de WordPress. La suppression du plugin via uninstall.php nettoie ses propres données.
  • Le rôle personnalisé « AS24 Editor » et la capacité manage_as24_imports sont gérés via Plugin::ensure_roles_and_caps() lors de l'activation et lors des mises à niveau de version des capacités ; les relecteurs utilisant des plugins de gestion de rôles ne doivent pas les supprimer tant que le plugin est actif.
  • Le rendu front-end respecte le thème actif. Pour personnaliser en profondeur les modèles de véhicules, copiez les fichiers du répertoire templates/ du plugin dans votre thème enfant.

Dépannage

  • Erreur 404 sur l'archive des véhicules ou sur les pages uniques : Visitez Réglages → Permaliens et cliquez sur Enregistrer. Confirmez que les permaliens ne sont pas définis sur « Simple ».
  • Le menu d'administration n'est pas visible pour un utilisateur non-administrateur : Vérifiez que le rôle de l'utilisateur possède la capacité manage_as24_imports.
  • Les boutons d'importation renvoient « autorisation refusée » ou des erreurs de nonce : Rechargez la page d'administration (les nonces expirent après 24 h) et confirmez que l'utilisateur détient manage_as24_imports.
  • Les importations planifiées ne s'exécutent jamais : Confirmez que WP-Cron est accessible, ou passez à un déclencheur de cron externe (wp-cron.php ou le point de terminaison REST avec le jeton configuré).
  • Des images sont manquantes dans la bibliothèque de médias : Vérifiez le réglage Nombre max d'images par véhicule, l'espace disque disponible et l'état de la file d'attente des images dans l'onglet Importations et limites.
  • Le point de terminaison REST renvoie une erreur 401 : Assurez-vous que la requête inclut le jeton cron configuré et qu'aucun plugin de sécurité ne supprime les paramètres de requête ou d'en-tête.

Documents connexes