Guide pratique pour le développement de plugins WooCommerce : créer des fonctionnalités e-commerce personnalisées à partir de zéro.

Installation de l'environnement de développement pour les plugins WooCommerce

Pour commencer le développement de plugins pour WooCommerce, il est nécessaire de créer d’abord un environnement de développement local professionnel. Il est recommandé d’utiliser…Local by FlywheelOuXAMPPInstallez également les environnements d’intégration nécessaires, ainsi que les versions les plus récentes de WordPress et WooCommerce. Assurez-vous que…wp-config.phpDans le fichier…WP_DEBUGSet totrueAfin de pouvoir détecter les erreurs et les avertissements pendant le processus de développement.

La création de la structure de base d’un plugin commence généralement par un fichier principal. Ce fichier sert de point d’entrée pour le plugin et doit contenir les informations de tête standard nécessaires à son identification par WordPress. Le nom du fichier principal du plugin doit être unique, par exemple…my-custom-woocommerce.phpVoici un exemple de structure de base pour un fichier de plugin.

<?php
/**
 * Plugin Name: My Custom WooCommerce Features
 * Description: 为WooCommerce添加自定义电商功能。
 * Version: 1.0.0
 * Author: Your Name
 */

if ( ! defined( 'ABSPATH' ) ) {
    exit; // 防止直接访问
}

Dans la structure de base, il est également nécessaire de comprendre le mécanisme de chargement des dépendances de WooCommerce. Le code de votre plugin doit être adapté en conséquence.plugins_loadedOuinitL’exécution a lieu après l’application du crochet, afin de s’assurer que les classes fondamentales de WooCommerce ont été chargées. Vous pouvez le faire en…class_exists( 'WooCommerce' )Vérifiez si WooCommerce est activé ; c’est la première étape vers une bonne compatibilité.

Lectures recommandées Analyse approfondie du développement de plugins pour WordPress : construire des fonctionnalités personnalisées à partir de zéro。

Développement des fonctionnalités clés : utilisation des hooks et des filtres

La force de WooCommerce réside dans son extensibilité, qui est principalement assurée par les hooks d’action (Action Hooks) et les hooks de filtre (Filter Hooks). Les hooks d’action vous permettent d’exécuter du code personnalisé à des moments précis, tandis que les hooks de filtre vous permettent de modifier les données transmises.

Hébergement WordPress par UltraHost

Garantie de remboursement dans les 30 jours, bande passante illimitée et base de données, protection gratuite contre les attaques DDoS. Avantage de 501 TP4T pour les achats sur 3 ans.

page d'accès

Comment ajouter des champs de paiement personnalisés ?

Une demande fréquente consiste à ajouter des champs supplémentaires à la page de paiement. Cela peut être réalisé en…woocommerce_checkout_fieldsCela est réalisé à l’aide de filtres. Le code suivant montre comment ajouter un champ simple intitulé “ Numéro de taxe d’entreprise ” dans la zone d’information des factures.

add_filter( 'woocommerce_checkout_fields', 'my_custom_checkout_fields' );
function my_custom_checkout_fields( $fields ) {
    $fields['billing']['billing_vat_number'] = array(
        'label'     => __('税号 / VAT Number', 'woocommerce'),
        'placeholder'   => _x('请输入您的公司税号', 'placeholder', 'woocommerce'),
        'required'  => false, // 根据需求设置为 true 或 false
        'class'     => array('form-row-wide'),
        'clear'     => true
    );
    return $fields;
}

Après avoir ajouté les champs, vous devez également les utiliser.woocommerce_checkout_update_order_metaL’action permet de sauvegarder les valeurs des champs dans les métadonnées de la commande, et ensuite de les utiliser…woocommerce_admin_order_data_after_billing_addressetwoocommerce_order_details_after_customer_detailsLes crochets doivent afficher cette valeur sur les pages des commandes, tant en frontend qu'en backend.

Modifier la logique de calcul des prix des produits

Un autre scénario clé consiste à ajuster les prix des produits en fonction de règles personnalisées. Par exemple, offrir des réductions supplémentaires à des utilisateurs ayant des rôles spécifiques. Cela peut être réalisé en…woocommerce_product_get_priceCela est réalisé à l’aide d’un filtre qui est appelé à chaque fois que le prix est récupéré, ce qui permet une tarification dynamique.

add_filter( 'woocommerce_product_get_price', 'custom_role_based_discount', 10, 2 );
function custom_role_based_discount( $price, $product ) {
    if ( is_user_logged_in() && current_user_can( 'wholesale_customer' ) ) {
        // 为批发客户提供15%的折扣
        $price = $price * 0.85;
    }
    return $price;
}

Créer une interface de gestion personnalisée et des options de configuration.

Afin de rendre les fonctionnalités de votre plugin configurables, il est généralement nécessaire de créer une page de paramétrage claire et facile à utiliser. WordPress offre des outils pour cela.Settings APIAjoutez de manière standardisée des pages de configuration, des zones et des champs.

Lectures recommandées Guide ultime des plugins pour WooCommerce et analyse détaillée du code : de l’installation à le développement personnalisé。

Ajouter une nouvelle page de paramètres dans les réglages de WooCommerce

La meilleure pratique consiste à intégrer les paramètres de votre plugin dans la structure de configuration existante de WooCommerce. Vous pouvez utiliser…woocommerce_get_settings_pagesPour ajouter une nouvelle classe de page de paramétrage, commencez par créer une classe qui hérite d’une classe existante.WC_Settings_PageLa classe…

add_filter( 'woocommerce_get_settings_pages', 'add_my_custom_settings_page' );
function add_my_custom_settings_page( $settings ) {
    $settings[] = include plugin_dir_path( __FILE__ ) . 'includes/class-wc-settings-my-plugin.php';
    return $settings;
}

Ensuite, dansclass-wc-settings-my-plugin.phpCette classe est définie dans le fichier ; il suffit de la réécrire (de la modifier).get_settings()Une méthode pour retourner votre array de champs de configuration.

class WC_Settings_My_Plugin extends WC_Settings_Page {
    public function __construct() {
        $this->id = ‘my-plugin’;
        $this->label = __(‘我的插件’, ‘my-text-domain’);
        parent::__construct();
    }

public function get_settings() {
        return array(
            array(
                ‘title’ => __(‘基本配置’, ‘my-text-domain’),
                ‘type’  => ‘title’,
                ‘id’    => ‘my_plugin_options’
            ),
            array(
                ‘title’   => __(‘启用功能’, ‘my-text-domain’),
                ‘desc’    => __(‘启用自定义折扣功能’),
                ‘id’      => ‘my_plugin_enable_discount’,
                ‘default’ => ‘no’,
                ‘type’    => ‘checkbox’
            ),
            // ... 更多设置字段
        );
    }
}

Sauver et valider les données des paramètres de configuration

Par l’intermédiaire de…Settings APIetWC_Settings_PageLes paramètres ajoutés à une classe sont automatiquement gérés par le noyau de WooCommerce pour leur sauvegarde et leur validation. Cependant, vous pouvez toujours les modifier ou les personnaliser si le besoin se fait sentir.woocommerce_admin_settings_sanitize_option_{option_id}Les filtres effectuent un nettoyage et une vérification supplémentaires des valeurs des champs spécifiques, afin d’assurer l’exactitude et la sécurité des données saisies.

hosting.com Hébergement partagé

Hautes performances avec les CPU AMD EPYC, stockage SSD NVMe et LiteSpeed, support interne expert 24h/24 et 7j/7, mesures de sécurité avancées, notamment SSL, protection contre la force brute, les logiciels malveillants et le DDoS, économies pouvant aller jusqu'à 73%.

page d'accès

Fonctions avancées et tableaux de données personnalisés

Lorsqu’un plugin a besoin de stocker des données complexes ou de grandes quantités de données relationnelles, l’utilisation des tables de données personnalisées de WordPress peut s’avérer plus avantageuse que de dépendre des mécanismes intégrés au système.wp_postmetaLa table devient plus efficace. Cela se produit généralement lorsque le plugin est activé.

Créer une table de données lorsque le plugin est activé.

Vous devez utiliser…register_activation_hookLes « hooks » permettent de définir les fonctions qui s’exécutent lorsque le plugin est activé. À l’intérieur de ces fonctions, il est possible d’utiliser…$wpdbObjets et…dbDelta()Des fonctions sont disponibles pour créer ou mettre à jour la structure de vos tables de manière sûre.dbDelta()Les fonctions exigent que les instructions SQL soient formulées de manière très stricte.

register_activation_hook( __FILE__, ‘my_plugin_create_tables’ );
function my_plugin_create_tables() {
    global $wpdb;
    $charset_collate = $wpdb->get_charset_collate();
    $table_name = $wpdb->prefix . ‘my_plugin_subscriptions’;

$sql = “CREATE TABLE $table_name (
        id bigint(20) NOT NULL AUTO_INCREMENT,
        user_id bigint(20) NOT NULL,
        product_id bigint(20) NOT NULL,
        status varchar(20) DEFAULT ‘active’ NOT NULL,
        created_at datetime DEFAULT CURRENT_TIMESTAMP NOT NULL,
        PRIMARY KEY (id),
        KEY user_id (user_id),
        KEY product_id (product_id)
    ) $charset_collate;”;

require_once( ABSPATH . ‘wp-admin/includes/upgrade.php’ );
    dbDelta( $sql );
}

Intégrer des données personnalisées dans les requêtes de WooCommerce

Après avoir créé des tables personnalisées, vous pourriez avoir besoin d’intégrer ces données au système de recherche des commandes ou des produits de WooCommerce. Par exemple, vous pourriez ajouter une colonne dans la liste des produits pour afficher le nombre d’utilisateurs abonnés. Vous pouvez utiliser…manage_edit-product_columnsetmanage_product_posts_custom_columnLes filtres et les actions, combinés avec vos propres requêtes de base de données, permettent de réaliser cette fonctionnalité. Cela montre comment intégrer des données externes de manière fluide dans le flux de travail par défaut de WooCommerce.

Lectures recommandées Guide complet de la création d'un site Web avec WooCommerce : comment créer un site de commerce électronique à forte conversion à partir de zéro.。

résumés

Développer un plugin personnalisé pour WooCommerce est un projet systématique qui implique plusieurs étapes : la mise en place d’un environnement de développement, l’utilisation des hooks, la création d’une interface de gestion, ainsi que le traitement des données personnalisées le cas échéant. L’essentiel réside dans une compréhension approfondie du système de hooks de WooCommerce, qui vous permet d’insérer de la logique personnalisée à presque tous les stades du fonctionnement du site. Respecter les normes de codage de WordPress et de WooCommerce est crucial pour créer un code structuré, sécurisé et efficace, ce qui assure la stabilité à long terme du plugin, facilite son entretien et garantit sa compatibilité avec les futures versions de WooCommerce. En suivant les conseils présentés ci-dessus, vous serez en mesure de développer des fonctionnalités avancées pour vos sites e-commerce, adaptées à vos besoins commerciaux spécifiques.

FAQ Foire aux questions

Quelles connaissances préalables sont nécessaires pour développer un plugin WooCommerce pour ### ?
Il est essentiel de maîtriser les bases du langage de programmation PHP ainsi que les concepts de programmation orientée objet. De plus, une compréhension claire des mécanismes fondamentaux de WordPress, tels que les hooks, les filtres (Filters) et les actions (Actions), est indispensable. Connaître les langages HTML, CSS et JavaScript de base vous aidera à développer des fonctionnalités d’interaction utilisateur sur le côté client. Une familiarité avec les structures de données de base de WooCommerce, comme les commandes, les produits, les coupons et les utilisateurs, facilitera le processus de développement.

Hébergement partagé InterServer

Hébergement mutualisé $2.50 USD par mois, premier mois $0.1 USD code promo tryinterserver, 461 scripts cloud apps, installation en un clic.

page d'accès

Comment garantir que mon plugin personnalisé soit compatible avec les futures versions de WooCommerce ?

Respecter les normes de développement officielles et les meilleures pratiques est une condition essentielle. Evitez de modifier directement les fichiers du noyau de WooCommerce et étendez ses fonctionnalités uniquement à travers les hooks fournis par l’entreprise. N’utilisez pas de fonctions ou de méthodes déclarées obsolètes (deprecated) dans votre code, et suivez de près les journaux d’actualisation de WooCommerce. Indiquez dans votre plugin la dernière version de WooCommerce pour laquelle les tests ont été effectués. Testez votre plugin de manière approfondie, en particulier avant et après la publication de mises à jour majeures de WooCommerce.

Puis-je accéder à toutes les API sans avoir acheté l’extension WooCommerce ?

Oui, l’API REST principale de WooCommerce est activée par défaut après l’installation. Elle fournit des points d’accès (CRUD) complets pour les modèles de données clés tels que les commandes, les produits et les clients. Vous pouvez utiliser ces API pour effectuer des opérations de lecture et d’écriture. Cependant, certaines fonctionnalités spécifiques ou des points d’accès personnalisés fournis par des extensions payantes (comme des services d’abonnement ou des systèmes de membres) peuvent ne pas être accessibles via l’API tant que l’extension correspondante n’a pas été activée. Les autorisations pour utiliser l’API principale sont gérées par le système de rôles et de droits d’utilisateur de WordPress.

Quels outils sont utiles pour déboguer des plugins WooCommerce ?

Tout d’abord, assurez-vous d’activer le mode de débogage de WordPress. Cela se fait généralement en allant dans les options du site web de WordPress, puis en sélectionnant l’option correspondante.wp-config.phpConfiguration dans…define(‘WP_DEBUG’, true);Cela affichera les erreurs et les avertissements à l’écran ou les enregistrera dans les journaux (logs). Utilisez les outils de développement de votre navigateur (F12) pour examiner et déboguer le JavaScript du côté client ainsi que les requêtes AJAX. Pour suivre la logique du code, vous pouvez installer des plugins de surveillance des requêtes, comme “Query Monitor”, qui vous aident à analyser les requêtes à la base de données, l’exécution des fonctions et les points de congestion de performance. Pour les processus de transaction complexes, il est également essentiel de consulter les fichiers de journal de WooCommerce (accessibles depuis l’administration de WordPress, sous “État” > “Journaux”).