Guida definitiva ai plugin per WooCommerce con analisi dettagliata del codice: dalla installazione allo sviluppo personalizzato

Installazione e configurazione di base di WooCommerce

Il processo di installazione di WooCommerce è semplice, ma una corretta configurazione iniziale rappresenta la base per costruire un sito e-commerce stabile. Prima di tutto, è necessario disporre di un ambiente server che esegua PHP 7.4 o una versione più recente e che abbia WordPress installato. Attraverso la pagina “Aggiungi plugin” presente nell’interfaccia di WordPress, cercate “WooCommerce” e cliccate su “Installa e attiva”. Dopo l’attivazione, il sistema avvierà automaticamente una “guida alle impostazioni” che vi aiuterà a completare le configurazioni di base del vostro negozio online.

Nella guida di configurazione, è necessario completare successivamente i seguenti passaggi: impostare la posizione del negozio, la valuta e le unità di misura; configurare i metodi di pagamento (ad esempio PayPal, Stripe o bonifico bancario); definire le regole per il calcolo delle spese di spedizione (ad esempio consegna gratuita, spese di spedizione fissa o tariffe in tempo reale in base al peso o all’indirizzo); inoltre, si consiglia di installare alcune estensioni essenziali, come WooCommerce Payments o plugin di localizzazione. Dopo aver completato la guida, si accederà alla pagina delle impostazioni principali di WooCommerce. Qui ci sono alcune sezioni chiave da configurare con attenzione: nelle impostazioni “Generali” è possibile definire i luoghi di vendita e i calcoli delle tasse; nelle impostazioni “Prodotti” è possibile definire le unità di misura, le recensioni dei prodotti e la gestione degli stock; la pagina di “Pagamento” è il luogo in cui configurare tutti i gateway di pagamento e i processi di pagamento; le impostazioni “Spedizione” servono per gestire le aree di spedizione, i metodi di spedizione e l’imballaggio.

Un passaggio spesso trascurato ma di fondamentale importanza è la configurazione dei link permanenti. In WordPress, andate su “Impostazioni” > “Link permanenti” e assicuratevi di non utilizzare la struttura “Pura”. Si consiglia di utilizzare la struttura “Nome dell’articolo” o una struttura personalizzata, poiché ciò migliora l’SEO delle pagine dei prodotti. Inoltre, nella scheda di impostazioni “Avanzate” di WooCommerce, è necessario assegnare alle varie pagine (come il carrello, il processo di pagamento, il mio account, ecc.) le corrispondenti pagine di WordPress; queste pagine vengono create automaticamente all’installazione del plugin.

Si consiglia di leggere Guida allo sviluppo personalizzato di WooCommerce: un corso pratico completo, dall’introduzione all’avanzamento。

Impostazioni delle informazioni di base del negozio

Le impostazioni di base del negozio si trovano principalmente nell’editor personalizzabile di WordPress e nelle impostazioni di base di WooCommerce. È necessario assicurarsi che l’indirizzo del negozio, l’indirizzo email del servizio clienti e i numeri di telefono siano corretti; queste informazioni appariranno nelle notifiche degli ordini, nelle fatture e nella parte inferiore della pagina (footer). Inoltre, nelle “Impostazioni di base” → “Opzioni valuta”, è possibile impostare il formato della valuta, ad esempio Cinese Yuan (¥123.00) o Dollaro Statunitense ($123.00).

UltaHost – Hosting per siti WordPress

Garanzia di rimborso entro 30 giorni, larghezza di banda illimitata e accesso ai database, protezione gratuita contro gli attacchi DDoS; sconto del 50% per l’acquisto di un piano valido per 3 anni (da 3 a 4 TB di spazio di archiviazione).

pagina di accesso

Integrazione dei gateway di pagamento e di consegna

I gateway di pagamento rappresentano la vita vitale per gli e-commerce. WooCommerce include al proprio interno diversi metodi di pagamento, come… WC_Gateway_BACSTrasferimento bancarioWC_Gateway_CHEQUE(Pagamento con assegno) e WC_Gateway_COD(Pagamento alla consegna). Per abilitare gateway avanzati come Stripe o PayPal, di solito è necessario installare plugin aggiuntivi e configurare le chiavi API. Ad esempio, per configurare Stripe, è necessario inserire la chiave pubblica e la chiave privata disponibili sulla pagina delle impostazioni relative.

Le impostazioni di consegna sono altrettanto importanti. È possibile creare regole di tariffa separate per diversi paesi o regioni all’interno della sezione “Area di consegna”. Ad esempio, è possibile definire un’area per la Cina continentale e aggiungere opzioni come “Consegna gratuita”, “Tarifa fissa” e “Raccolta in loco”. Utilizzando queste funzionalità, si può personalizzare il processo di consegna in base alle esigenze dei clienti di ciascuna area. woocommerce_shipping_init Gli sviluppatori possono anche creare classi per i metodi di consegna completamente personalizzabili.

Funzionalità principali e gestione dei dati

WooCommerce integra tutti i dati relativi alle attività di e-commerce all’interno dei tipi di articoli personalizzati e della classificazione di WordPress. I prodotti vengono memorizzati come… product I tipi di articoli, mentre gli ordini corrispondono… shop_order Tipo di articolo. Comprendere questo modello di dati è una premessa per lo sviluppo personalizzato di livello avanzato.

La gestione dei prodotti è davvero fondamentale. WooCommerce supporta quattro tipi di prodotti:simpleProdotti semplici.grouped(Prodotti raggruppati)external(Prodotti esterni/ correlati) e variable(Prodotti variabili): I prodotti variabili consentono di impostare diversi attributi (ad esempio, colore, dimensione) per lo stesso articolo, nonché i relativi prezzi, quantità in magazzino e codici SKU (Stock Keeping Unit). Durante la modifica dei prodotti in backend, si utilizza una serie di riquadri per i metadati, che servono a gestire i codici SKU, i prezzi, lo stato delle scorte, le informazioni di spedizione e la galleria di immagini relative all’articolo.

Si consiglia di leggere Cos’è WooCommerce e qual è la sua architettura di base?。

Il backend di gestione degli ordini fornisce una panoramica completa delle vendite. Ogni ordine contiene un’ampia quantità di metadati. shop_order I post registrano informazioni sui clienti, i prodotti acquistati, i prezzi, lo stato del pagamento e la storia delle note relative agli ordini. La gestione dello stato è di fondamentale importanza; gli stati predefiniti includono: pending“In attesa di pagamento”.processing“In corso di elaborazione…”on-hold(Pausa) E completed(Completato). Puoi utilizzarlo. wc_get_order_statuses La funzione recupera tutti gli stati e li elabora tramite… woocommerce_register_shop_order_post_statuses Registrazione dello stato personalizzato per i filtri.

Gestione dei tipi di prodotto e delle loro proprietà

Gli attributi dei prodotti rappresentano uno strumento efficace per organizzare cataloghi di prodotti complessi. È possibile creare attributi globali, come “Colore” o “Dimensione”, nella sezione “Prodotti” > “Attributi”. Successivamente, durante la modifica di prodotti variabili, questi attributi vengono utilizzati per creare “combinazioni di attributi”, e per ogni combinazione (ad esempio “Rosso-Maggiore”) vengono impostati dati specifici per le varianti del prodotto. A livello di codice, questo processo può essere implementato in diversi modi, a seconda del linguaggio di programmazione e dell’ambiente tecnologico utilizzato. WC_Product_Variable Classi e i loro… get_available_variations() Metodi per ottenere e manipolare tutte le informazioni relative alle varianti.

Trattamento dei dati relativi agli ordini e ai clienti

WooCommerce è un software open source per la gestione di negozi online. WC_Order Una classe viene utilizzata per incapsulare i dati dell’ordine. Attraverso questa classe, è possibile creare o aggiornare gli ordini in modo programmatico. Ad esempio, il codice seguente mostra come creare un nuovo ordine e aggiungere dei prodotti:

hosting.com Hosting condiviso

Prestazioni elevate con CPU AMD EPYC, storage SSD NVMe e LiteSpeed, supporto interno di esperti 24 ore su 24, 7 giorni su 7, misure di sicurezza avanzate, tra cui SSL, brute force, malware e protezione DDoS, risparmi fino a 73%

pagina di accesso

// 创建一个新订单对象
$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();

I dati dei clienti sono associati agli utenti di WordPress.WP_User) Legame profondo. WooCommerce tramite wc_get_customer_order_count 和 wc_get_customer_total_spent Funzioni come queste estendono le capacità degli utenti.

Integrazione dei temi e copertura dei template

L’ grado di integrazione tra WooCommerce e i temi utilizzati determina l’esperienza utente sul front end del negozio online. WooCommerce dispone di un potente sistema di templati: tutti i file relativi all’aspetto visivo del sito (come le liste di prodotti, le pagine dei singoli articoli e il carrello degli acquisti) si trovano all’interno della directory dei plugin. /templates/ Si trovano all’interno della cartella. Per personalizzare questi template senza modificare i file dei plugin principali, è necessario sovrascriverli nel proprio tema.

Il metodo corretto è: all’interno della directory dedicata ai temi delle vostre attività, creare un file con il nome… woocommerce Dopo aver creato la nuova cartella, copiate i file del template WooCommerce che desiderate modificare dal directory dei plugin nella nuova cartella e apportate le modifiche direttamente su questa copia. Ad esempio, per modificare la struttura di una singola pagina del prodotto, è necessario copiare i file relativi a quella pagina e lavorarci sopra. plugins/woocommerce/templates/single-product.php 到 themes/your-theme/woocommerce/single-product.phpWooCommerce caricherà in priorità i file di template presenti nel tema utilizzato.

Si consiglia di leggere La guida definitiva a WooCommerce per creare un sito web: costruisci il tuo impero e-commerce da zero.。

Oltre a coprire l’intero file, è anche possibile utilizzare gli Action Hooks e i Filter Hooks per inserire o modificare contenuti in posizioni specifiche. Ad esempio,woocommerce_before_single_product_summary Il “hook” viene attivato prima delle informazioni di riassunto del prodotto, rendendolo il punto ideale per inserire annunci pubblicitari personalizzati in forma di banner.

Struttura del file del modello personalizzato

I file di template di WooCommerce presentano una struttura gerarchica ben definita. Prendiamo ad esempio il ciclo dei prodotti (product loop) come caso di studio.archive-product.php Si tratta di un template per la pagina principale di un negozio; esso verrà utilizzato per generare il contenuto visivo della pagina stessa. content-product.php Questi file vengono utilizzati per rendere visibile ogni singolo prodotto nell’elenco. Sovrascrivendoli, è possibile modificare completamente il modo in cui i prodotti vengono visualizzati: ad esempio, cambiare il layout in griglia o in lista, oppure aggiungere emblemi personalizzati.

Hosting condiviso InterServer

Hosting condiviso $2,50 USD al mese, primo mese $0,1 USD codice promozionale tryinterserver, 461 script di applicazioni cloud, installazione con un clic.

pagina di accesso

Utilizzare gli “hook” per l’estensione delle funzionalità.

Gli “hook” rappresentano l’ossatura fondamentale degli estensioni per WooCommerce. Gli action hook vi permettono di eseguire codice, ad esempio per aggiungere una finestra di informazioni personalizzata dopo la tabella del carrello degli acquisti.

add_action('woocommerce_after_cart_table', 'my_custom_cart_message');
function my_custom_cart_message() {
    echo '<div class="custom-notice">Spedizione gratuita per acquisti superiori a 500 euro!</div>';
}

Gli hook dei filtri vi permettono di “modificare” i dati. Ad esempio, utilizzandoli… woocommerce_add_to_cart_fragments I filtri possono aggiornare dinamicamente il contenuto del carrello della spesa in miniatura:

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;
}

Pratiche avanzate di personalizzazione e sviluppo

Quando le funzionalità integrate e gli strumenti disponibili non sono in grado di soddisfare le esigenze, diventa necessario procedere con uno sviluppo personalizzato più approfondito. Ciò include la creazione di tipi di prodotti personalizzati, la scrittura di gateway dedicati per i pagamenti o la consegna, nonché l’integrazione con sistemi esterni tramite API REST.

Per creare tipi di prodotti personalizzati, è necessario effettuare delle estensioni. WC_Product Classi. Prima di tutto, è necessario definire una nuova classe che erediti da una classe esistente e registrare questo tipo di prodotto. Ad esempio, creare una classe di prodotto chiamata “Prenotazione”:

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;
}

Il WooCommerce REST API offre interfacce potenti per applicazioni mobili o sistemi di gestione esterni. È possibile utilizzare questo API per gestire quasi tutti i dati, come prodotti, ordini e clienti. Per accedere all’API, è necessario prima abilitarlo nelle impostazioni di WooCommerce (in “WooCommerce” > “Impostazioni” > “Avanzate” > “API obsolete”) e creare una chiave API (Consumer Key e Consumer Secret). Successivamente, è possibile effettuare chiamate utilizzando endpoint simili a quelli elencati di seguito:GET /wp-json/wc/v3/products Per ottenere l’elenco dei prodotti.

Sviluppare un gateway personalizzato

Un gateway di pagamento personalizzato è un'estensione di WC_Payment_Gateway Si tratta di una classe PHP. È necessario definire all’interno di questa classe l’ID del gateway, il titolo, la descrizione, i campi relativi ai pagamenti, e implementare le funzionalità necessarie. process_payment Questo metodo viene utilizzato per implementare la logica di pagamento. Una volta completato lo sviluppo, è necessario procedere con… woocommerce_payment_gateways Il filtro lo aggiunge all’elenco dei gateway disponibili.

Integrazione API con servizi esterni

WooCommerce offre una vasta gamma di funzionalità (chiamate “hook”) per integrarsi con sistemi ERP, CRM o sistemi di logistica. Ad esempio, quando lo stato di un ordine cambia in “Completato”, viene attivato un determinato meccanismo di notifica o di azione. woocommerce_order_status_completed “Action Hook”: È possibile collegare una funzione a questo hook per inviare i dati dell’ordine al proprio sistema di gestione degli stock.

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
}

Riassumendo

WooCommerce non è semplicemente un plugin, ma un framework per lo sviluppo di e-commerce completo e altamente estensibile. Dalla semplice installazione e configurazione fino allo sviluppo personalizzato avanzato, offre agli sviluppatori infinite possibilità grazie a un sistema di template chiaro, un’ampia gamma di “hook” (Actions & Filters) e un modello di dati orientato agli oggetti. La chiave per creare con successo un negozio online con WooCommerce è: una configurazione di base solida che garantisca il corretto funzionamento del negozio; una comprensione approfondita dei modelli di dati relativi ai prodotti e agli ordini; un utilizzo esperto dei template e degli hook per la personalizzazione dell’interfaccia utente; nonché la capacità di integrare funzionalità personalizzate tramite classi, gateway e API per soddisfare esigenze aziendali specifiche. Seguendo queste best practice, sarà possibile creare un negozio online potente, efficiente e perfettamente in linea con la logica aziendale.

FAQ - Domande frequenti

Come modificare il testo del pulsante “Aggiungi al carrello”?

Puoi usare woocommerce_product_add_to_cart_text Filtro o… woocommerce_product_single_add_to_cart_text Utilizzando dei filtri è possibile modificare il testo dei pulsanti. Ad esempio, il codice seguente cambia il testo dei pulsanti sulla pagina di un singolo prodotto in “Acquista ora”:

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

Per la pagina di archiviazione (elenco dei prodotti), utilizzare… woocommerce_product_add_to_cart_text È necessario utilizzare un filtro e, all’interno della funzione, determinare il tipo di prodotto.

Come aggiungere campi personalizzati per una categoria di prodotti specifica?

È necessario utilizzare in combinazione gli hook per la classificazione dei prodotti di WooCommerce e l’API per i metadati dei termini di WordPress. Per iniziare, utilizzate… product_cat_add_form_fields 和 product_cat_edit_form_fields Gli elementi di azione vengono visualizzati nei campi di output della pagina di aggiunta/modifica delle categorie. Successivamente, vengono utilizzati… created_term 和 edit_term Eseguite l’azione per salvare i valori dei campi… term_metaInfine, è possibile utilizzare questi elementi all’interno dei file di template. get_term_meta Per ottenere e visualizzare questo valore…

Perché le modifiche apportate al mio template personalizzato non sono state applicate?

Per risolvere il problema, segui questi passaggi: innanzitutto, assicurati di aver copiato il file del template nella directory corretta del tema.your-theme/woocommerce/ Innanzitutto, assicuratevi che il file venga caricato correttamente e che la struttura del directory sia identica a quella del template del plugin originale. In secondo luogo, cancellate tutti i cache: quelli del browser, i cache degli oggetti di WordPress e qualsiasi cache lato server (ad esempio, OPcache). Infine, verificate il vostro tema. functions.php È stato dichiarato correttamente il supporto per WooCommerce?add_theme_support('woocommerce');Se il problema persiste, prova a passare temporaneamente al tema predefinito (ad esempio, Storefront) per escludere eventuali problemi di compatibilità tra i temi utilizzati.

Come creare un prodotto variabile in WooCommerce in modo programmatico?

Devi utilizzare… WC_Product_Variable Classi. I passaggi fondamentali sono i seguenti: creare un oggetto prodotto e impostare le sue proprietà di base; creare e aggiungere proprietà globali (ad esempio, i colori); creare combinazioni specifiche di queste proprietà (ovvero varianti); infine, creare oggetti indipendenti per ciascuna variante. WC_Product_Variation Gli oggetti vengono configurati con attributi specifici, come il prezzo e le scorte, e vengono associati al prodotto principale. Questo è un processo a più fasi che di solito comporta: wp_set_object_terms, set_attributes, E… save Metodi come…