Plugin Dependencies

Définition : Plugin Dependencies désigne la déclaration des extensions nécessaires au fonctionnement d’un plugin WordPress. Le champ Requires Plugins de son en-tête permet au système de présenter et contrôler certaines dépendances déclarées.

Terminologie

Terme officiel : Plugin Dependencies

Autres appellations : Dépendances d’extensions, Requires Plugins

À quoi cela sert

Elle avertit qu’une fonctionnalité dépend d’une autre extension, par exemple un connecteur s’appuyant sur un moteur e-commerce. Cette déclaration aide l’administrateur à identifier les prérequis au lieu de découvrir une erreur au moment de l’utilisation.

Comment cela fonctionne

Le champ Requires Plugins accepte une liste de slugs de plugins hébergés sur WordPress.org, séparés par des virgules. L’interface WordPress gère les relations prises en charge ; le code du plugin doit néanmoins vérifier que les API attendues sont disponibles.

Dans quel contexte l’utiliser

À utiliser dans un plugin complémentaire dépendant réellement d’une autre extension publique. Ne pas déclarer une dépendance purement facultative comme obligatoire.

Exemple concret

Une extension d’export suppose qu’un plugin de catalogue WordPress.org est installé. Elle annonce ce prérequis dans son en-tête et vérifie séparément l’API avant usage.

Exemple de code commenté

<?php
/**
 * Plugin Name: ATOOLPHA Connecteur (exemple)
 * Version: 1.0.0
 * Requires Plugins: woocommerce
 */
add_action( 'plugins_loaded', function () {
    // Exemple défensif : vérifier l’API réellement utilisée.
    if ( ! class_exists( 'WooCommerce' ) ) {
        return; // Aucune intégration si la dépendance manque.
    }
    // Charger ici les fonctions spécifiques au connecteur.
} );

Explication pas à pas de l’exemple

Le champ de l’en-tête annonce une dépendance WooCommerce. Au chargement des plugins, le callback vérifie que la classe choisie existe ; si ce n’est pas le cas, il n’appelle aucune API dépendante. La vérification est une défense supplémentaire, pas un remplacement du champ.

Résultat attendu

WordPress peut signaler la dépendance dans son interface, et l’exemple de connecteur n’essaie pas d’utiliser un composant absent.

Précautions et limites

Fonctionnalité disponible depuis WordPress 6.5. Requires Plugins utilise des slugs WordPress.org, pas des chemins de fichiers ; contrôler séparément les besoins de version et les dépendances non prises en charge.

À ne pas confondre

Déclaration de dépendance et détection à l’exécution sont complémentaires. Ni l’une ni l’autre ne constituent une gestion de paquets PHP comparable à Composer.