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

Installation et configuration de base de WooCommerce

Bien que l’installation de WooCommerce soit simple, une configuration initiale correcte est essentielle pour construire un site e-commerce stable. Tout d’abord, vous devez disposer d’un environnement serveur exécutant PHP 7.4 ou une version ultérieure, et sur lequel WordPress est déjà installé. Accédez à la page “ Plugins ” > “Installer des plugins ” depuis l’administration de WordPress, recherchez “ WooCommerce ” et suivez les instructions pour l’installer et l’activer. Une fois activé, le système lance automatiquement un guide de configuration qui vous aide à mettre en place les paramètres de base de votre boutique.

Dans la boîte de dialogue de configuration, vous devez successivement effectuer les étapes suivantes : définir l’emplacement du magasin, la monnaie et les unités de mesure ; configurer les méthodes de paiement (telles que PayPal, Stripe ou virement bancaire) ; régler les règles de calcul des frais de livraison (livraison gratuite, frais de livraison fixes, ou tarifs en temps réel en fonction du poids ou de l’adresse) ; et il est recommandé d’installer des extensions essentielles, comme WooCommerce Payments ou des plugins de localisation. Une fois la boîte de dialogue terminée, vous accédez à la page de configuration principale de WooCommerce. Il existe plusieurs sections clés qui nécessitent une configuration minutieuse : dans les options “ Générales ”, vous pouvez définir les lieux de vente et le calcul des taux d’impôt ; dans les options “ Produits ”, vous pouvez définir les unités de mesure, les commentaires des produits et la gestion des stocks ; la page de paiement permet de configurer tous les gateways de paiement et les processus de règlement ; les options “ Livraison ” servent à gérer les zones de livraison, les méthodes de livraison et l’emballage des produits.

Une étape souvent négligée mais cruciale est la configuration des liens permanents. Dans les “ Paramètres ” > “ Liens permanents ” de WordPress, veillez à ne pas utiliser la structure “ Simple ”. Il est recommandé d’utiliser la structure “ Nom de l’article ” ou une structure personnalisée, car cela est bénéfique pour l’optimisation du SEO des pages de produits. De même, dans la page des paramètres avancés de WooCommerce, vous devez associer chaque type de page (comme le panier d’achat, la page de paiement, mon compte, etc.) aux pages WordPress correspondantes. Ces pages ont été créées automatiquement lors de l’installation du plugin.

Lectures recommandées Guide de développement personnalisé pour WooCommerce : Un tutoriel pratique complet, de l'initiation à l'avancement。

Paramétrage des informations de base du magasin

Les paramètres de base de votre magasin sont principalement configurés dans l’éditeur de thèmes de WordPress ainsi que dans les réglages standard de WooCommerce. Vous devez vous assurer que l’adresse du magasin, l’adresse e-mail du service client et les numéros de téléphone sont corrects, car ces informations apparaîtront dans les notifications de commande, les factures et en bas de page. De plus, dans les “ Réglages généraux ” → “ Options monnaies ”, vous pouvez définir le format de la monnaie, par exemple le yuan (¥123,00) ou le dollar ($123,00).

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

Intégration des passerelles de paiement et de livraison

Les passerelles de paiement sont la vie même des entreprises e-commerce. WooCommerce intègre de nombreuses méthodes de paiement préinstallées. WC_Gateway_BACS(Virement bancaire)WC_Gateway_CHEQUE(Paiement par chèque) et WC_Gateway_COD(Paiement à la livraison). Pour activer des passerelles avancées telles que Stripe ou PayPal, il est généralement nécessaire d’installer des plugins supplémentaires et de configurer les clés API correspondantes. Par exemple, pour configurer Stripe, vous devez saisir la clé publique et la clé secrète sur la page de paramétrage appropriée.

Les paramètres de livraison sont tout aussi importants. Vous pouvez créer des règles de frais de livraison distinctes pour différents pays ou régions dans la section “ Zones de livraison ”. Par exemple, créez une zone pour la Chine continentale et ajoutez des options telles que “ Livraison gratuite ”, “ Tarif fixe ” ou “ Retrait sur place ”. En utilisant ces paramètres, vous pourrez adapter les frais de livraison en fonction des besoins de vos clients. woocommerce_shipping_init Les développeurs peuvent même créer des classes de méthodes de livraison entièrement personnalisées.

Fonctions clés et gestion des données

WooCommerce intègre toutes les données relatives aux activités commerciales dans les types d’articles et les catégories personnalisés de WordPress. Les produits sont stockés sous la forme de… product Les types d’articles correspondent aux types de produits, tandis que les commandes correspondent aux demandes d’achat effectuées par les clients. shop_order Type d’article. Comprendre ce modèle de données est une condition préalable à tout développement personnalisé avancé.

La gestion des produits est l’élément essentiel parmi tous. WooCommerce prend en charge quatre types de produits :simpleProduits simples.grouped(Produits groupés)external(Produits externes/associés) et variable(Produits variables) Les produits variables vous permettent de définir différentes attributs (comme la couleur, la taille) pour le même article, ainsi que les prix, les stocks et les codes SKU (Stock Keeping Units) correspondants. Lors de la modification des produits en back-office, vous utiliserez une série de champs de métadonnées pour gérer les codes SKU, les prix, l'état des stocks, les informations de livraison et la galerie d'images associées à l'article.

Lectures recommandées Qu’est-ce que WooCommerce et quelle est sa structure de base ?。

L’interface de gestion des commandes offre une vue d’ensemble complète des ventes. Chaque commande contient une abondance de métadonnées. shop_order Les posts contiennent des informations sur les clients, les produits achetés, les prix, l'état du paiement ainsi que l'historique des remarques relatives aux commandes. La gestion de l'état des commandes est essentielle ; les états par défaut incluent : pending(En attente du paiement)processing(En traitement…)on-hold(Pause) Et completed(Téléchargement terminé.) Vous pouvez maintenant l'utiliser. wc_get_order_statuses La fonction récupère tous les états et les affiche via… woocommerce_register_shop_order_post_statuses Enregistrement d'un état personnalisé pour le filtre.

Gestion des types et des attributs de produits

Les attributs des produits sont un outil puissant pour organiser des catalogues de produits complexes. Vous pouvez créer des attributs globaux tels que “ Couleur ” ou “ Taille ” dans la section “ Produits ” > “ Attributs ”. Ensuite, lors de la modification de produits variables, vous pouvez utiliser ces attributs pour créer des “ combinaisons d’attributs ” et définir des données de variantes distinctes pour chaque combinaison (par exemple, “ Rouge – Grand ”. Au niveau du code, cela peut être réalisé en… WC_Product_Variable Les classes et leurs… get_available_variations() Des méthodes permettent d’obtenir et de manipuler toutes les informations relatives aux variantes.

Traitement des données des commandes et des clients

WooCommerce est utilisé pour gérer des boutiques en ligne. WC_Order Une classe est utilisée pour encapsuler les données des commandes. Grâce à cette classe, il est possible de créer ou de mettre à jour des commandes de manière programmée. Par exemple, le code suivant montre comment créer une nouvelle commande et y ajouter des produits :

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

// 创建一个新订单对象
$order = wc_create_order();

// 通过商品ID获取商品对象并添加到订单中
$product = wc_get_product(123);
$order->add_product($product, 2); // 数量为2

// 设置客户地址
$order->set_address(array(
    'first_name' => '张',
    'last_name'  => '三',
    'email'      => '[email protected]',
    'phone'      => '13800138000',
), 'billing');

// 计算总额并保存
$order->calculate_totals();
$order->save();

Les données des clients sont liées aux utilisateurs de WordPress.WP_UserUne liaison approfondie. WooCommerce utilise… wc_get_customer_order_count et wc_get_customer_total_spent Des fonctions telles que celles-ci étendent les capacités de l'utilisateur.

Intégration des thèmes et surcouvrement des modèles

L’intégration de WooCommerce avec le thème utilisé détermine l’expérience utilisateur de la boutique en ligne. Le système utilise un puissant système de templates, et tous les fichiers affichés sur la page d’accueil (comme la liste des produits, la page d’un produit individuel, le panier d’achat) se trouvent dans le répertoire des plugins. /templates/ Dans le dossier correspondant. Afin de personnaliser ces modèles sans modifier les fichiers de plugins principaux, vous devez les remplacer par vos propres versions dans votre thème.

La méthode correcte est de créer, dans le répertoire dédié au thème de votre événement, un fichier nommé… woocommerce Dans ce dossier, copiez les fichiers de template WooCommerce que vous souhaitez modifier depuis le répertoire des plugins, puis effectuez les modifications sur ces copies. Par exemple, pour modifier la structure d’une page de produit individuelle, vous devez copier les fichiers correspondants depuis le répertoire des plugins et les placer dans ce nouveau dossier. plugins/woocommerce/templates/single-product.php Arriver themes/your-theme/woocommerce/single-product.phpWooCommerce charge en priorité les fichiers de template présents dans le thème utilisé.

Lectures recommandées Guide ultime pour créer un site avec WooCommerce : Construire votre empire e-commerce à partir de zéro。

En plus de couvrir tout le fichier, vous pouvez également utiliser des « Action Hooks » et des « Filter Hooks » pour insérer ou modifier du contenu à des emplacements spécifiques. Par exemple,woocommerce_before_single_product_summary L’élément « crochet » s’active avant les informations résumées du produit, ce qui en fait l’emplacement idéal pour ajouter des bannières publicitaires personnalisées.

Structure des fichiers de modèles personnalisés

Les fichiers de template de WooCommerce présentent une structure hiérarchique claire. Prenons l’exemple du cycle des produits (product loop) pour illustrer ce point.archive-product.php Il s’agit d’un modèle pour la page d’accueil d’un magasin ; ce modèle effectuera des appels (des fonctionnalités ou des actions) spécifiques lors de l’utilisation de la page. content-product.php Ces fichiers sont utilisés pour rendre chaque produit visible sur la page. En les modifiant, vous pouvez complètement changer la manière dont les produits sont affichés dans la liste : par exemple, en changeant le format de présentation (grille ou liste) ou en ajoutant des badges personnalisés.

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

Utiliser des hooks pour étendre les fonctionnalités

Les “ hooks ” constituent l’ossature des extensions pour WooCommerce. Les hooks d’actions vous permettent d’exécuter du code, par exemple pour ajouter une boîte d’information personnalisée après le tableau du panier d’achat.

add_action('woocommerce_after_cart_table', 'my_custom_cart_message');
function my_custom_cart_message() {
    echo '<div class="custom-notice">Livraison gratuite pour tout achat de plus de 500 yuans !</div>';
}

Les hooks des filtres vous permettent de “modifier” les données. Par exemple, en utilisant… woocommerce_add_to_cart_fragments Les filtres peuvent mettre à jour dynamiquement le contenu du panier de shopping miniature :

add_filter('woocommerce_add_to_cart_fragments', 'update_mini_cart_count');
function update_mini_cart_count($fragments) {
    $fragments['div.cart-count'] = '<div class="cart-count">' . WC()-&gt;cart-&gt;get_cart_contents_count() . '</div>';
    return $fragments;
}

Pratiques avancées de personnalisation et de développement

Lorsque les fonctionnalités intégrées et les outils disponibles ne suffisent pas à répondre aux besoins, il est nécessaire de procéder à des développements personnalisés plus approfondis. Cela implique la création de types de produits personnalisés, la mise en place de passerelles de paiement ou de livraison spécifiques, ainsi que l’intégration avec des systèmes externes via des API REST.

Pour créer des types de produits personnalisés, il est nécessaire d’effectuer des extensions. WC_Product Pour créer une nouvelle classe, vous devez d’abord définir une classe qui hérite de celle existante, puis enregistrer ce nouveau type de produit. Par exemple, créez une classe de produit nommée “ Réservation ” :

class WC_Product_Booking extends WC_Product {
    public function __construct($product) {
        parent::__construct($product);
        $this->product_type = 'booking';
    }
    // 在这里添加自定义方法和属性，如 get_booking_dates()
}
// 将新类注册到工厂
add_filter('woocommerce_product_class', 'register_booking_product_class', 10, 2);
function register_booking_product_class($classname, $product_type) {
    if ($product_type == 'booking') {
        $classname = 'WC_Product_Booking';
    }
    return $classname;
}

L’API REST de WooCommerce offre des interfaces puissantes pour les applications mobiles ou les systèmes de gestion externes. Vous pouvez utiliser cette API pour gérer presque tous les types de données, tels que les produits, les commandes et les clients. Pour accéder à l’API, il vous faut d’abord l’activer dans les paramètres de votre site WordPress, en allant à “ WooCommerce ” > “ Paramètres ” > “ Avancé ” > “ API obsolète ”, puis créer une clé d’API (Consumer Key et Consumer Secret). Vous pourrez ensuite effectuer des appels en utilisant des points de terminaison (endpoints) similaires à ceux décrits ci-dessous.GET /wp-json/wc/v3/products Obtenir la liste des produits.

Développer un gateway personnalisé

Un portail de paiement personnalisé est une extension qui… WC_Payment_Gateway Vous avez une classe PHP. Vous devez définir dans cette classe l’ID du gateway, son titre, sa description, les champs de paiement, et mettre en œuvre les fonctionnalités nécessaires. process_payment Les méthodes permettent d'implémenter la logique de paiement. Une fois le développement terminé, il est nécessaire de… woocommerce_payment_gateways Le filtre l’ajoute à la liste des gateways disponibles.

Intégration API avec des services externes

WooCommerce offre une grande variété de hooks (des fonctions programmables) permettant de se connecter à des systèmes ERP, CRM ou de logistique. Par exemple, lorsque l'état d'une commande est modifié en “ Terminée ”, un hook est déclenché. woocommerce_order_status_completed Hook d’action. Vous pouvez y associer une fonction pour envoyer les données de la commande vers votre système de gestion des stocks.

add_action('woocommerce_order_status_completed', 'sync_order_to_erp');
function sync_order_to_erp($order_id) {
    $order = wc_get_order($order_id);
    $data = array(
        'order_id' => $order->get_id(),
        'total'    => $order->get_total(),
        // ... 准备其他数据
    );
    // 使用 wp_remote_post 将 $data 发送到外部 API
}

résumés

WooCommerce n’est pas seulement un plugin, mais aussi un framework de développement e-commerce complet et hautement extensible. De l’installation et de la configuration simples à un développement personnalisé avancé, il offre aux développeurs d’innombrables possibilités grâce à un système de templates clair, une abondance de fonctionnalités d’interfaçage (Actions & Filters) et un modèle de données orienté objet. La clé pour créer avec succès un magasin WooCommerce réside dans les points suivants : une configuration de base solide pour assurer le fonctionnement stable du magasin ; une compréhension approfondie de ses modèles de données produits et commandes ; une maîtrise des templates et des fonctionnalités d’interfaçage pour personnaliser l’aspect visuel du site ; ainsi que la capacité d’intégrer des éléments personnalisés (classes, gateways, API) afin de répondre aux besoins spécifiques de l’entreprise. En suivant ces bonnes pratiques, vous pourrez créer un magasin en ligne puissant, efficace et entièrement adapté à la logique de votre activité commerciale.

FAQ Foire aux questions

Comment modifier le texte de la bouton “ Ajouter au panier ” ?

Vous pouvez utiliser le woocommerce_product_add_to_cart_text Filtre ou… woocommerce_product_single_add_to_cart_text Des filtres sont utilisés pour modifier le texte des boutons. Par exemple, le code suivant change le texte des boutons sur la page d’un produit individuel en “ Acheter maintenant ” :

add_filter('woocommerce_product_single_add_to_cart_text', 'change_single_add_to_cart_text');
function change_single_add_to_cart_text() {
    return '立即购买';
}

Pour la page d’archivage (liste des produits), veuillez utiliser… woocommerce_product_add_to_cart_text Il faut utiliser un filtre et déterminer le type de produit à l’intérieur de la fonction.

Comment ajouter des champs personnalisés pour une catégorie de produits spécifique ?

Vous devez utiliser à la fois les hooks de classification des produits de WooCommerce et l’API des métadonnées de termes de WordPress. Pour commencer, utilisez… product_cat_add_form_fields et product_cat_edit_form_fields Les actions affichent les champs sur la page d’ajout/édit de la classification. Ensuite, on utilise… created_term et edit_term Faites une action pour enregistrer la valeur du champ. term_metaEnfin, vous pouvez utiliser ces fonctionnalités dans les fichiers de modèle. get_term_meta Obtenir et afficher cette valeur.

Pourquoi les modifications que j’ai apportées à mon modèle personnalisé n’ont-elles pas pris effet ?

Veuillez suivre les étapes suivantes pour effectuer le diagnostic : Tout d’abord, assurez-vous que vous avez copié le fichier de modèle dans le bon chemin de thème.your-theme/woocommerce/ Le répertoire doit être créé dans la bonne position, et sa structure doit correspondre à celle du modèle de plugin d’origine. Ensuite, effacez tous les caches, y compris les caches du navigateur, les caches d’objets de WordPress ainsi que tout cache côté serveur (comme OPcache). Enfin, vérifiez votre thème. functions.php La compatibilité avec WooCommerce a-t-elle été déclarée correctement ?add_theme_support('woocommerce');Si le problème persiste, essayez de passer temporairement au thème par défaut (par exemple, Storefront) pour exclure d’éventuels problèmes de compatibilité entre les thèmes.

Comment créer un produit variable dans WooCommerce de manière programmée ?

Vous devez utiliser WC_Product_Variable Classe. Les étapes de base sont les suivantes : créer un objet produit et définir ses attributs de base ; créer et ajouter des attributs globaux (tels que la couleur) ; créer des combinaisons spécifiques pour ces attributs (c’est-à-dire des variantes) ; enfin, créer des objets indépendants pour chaque variante. WC_Product_Variation Il s’agit d’un processus en plusieurs étapes qui consiste à définir des attributs spécifiques pour l’objet, tels que son prix et son stock, puis à l’associer au produit principal. wp_set_object_terms, set_attributes, et save et d’autres méthodes.