Podręcznik poświęcony podstawom rozwoju rozszerzeń dla platformy WooCommerce oraz praktycznym poradom dotyczącym ich implementacji

Dlaczego potrzeba rozwinąć rozszerzenie WooCommerce?

WooCommerce, jako najpotężniejszy plugin do sprzedaży online w ekosystemie WordPress, obejmuje już podstawowe wymagania działania sklepów internetowych – zarządzanie produktami, koszyki zakupów, proces płatności itd. Jednak każdy biznes ma swoje unikalne wymagania, związane z modelem działania, właściwościami produktów oraz procedurami obsługi klientów. Standardowe funkcje często nie są w stanie spełnić potrzeb, takich jak konfiguracja produktów na indywidualne wymagania, złożone zasady obliczania kosztów transportu, integracja z systemami planowania zasobów (ERP) czy tworzenie unikalnych programów lojalnościowych dla klientów. W takich przypadkach rozwoj własnych rozszerzeń dla WooCommerce staje się koniecznością.

Dzięki tworzeniu rozszerzeń programiści mogą zapakować określoną logikę biznesową w niezależne moduły, które umożliwiają bezproblemowe rozszerzenie lub modyfikację funkcji sklepu bez konieczności edycji kodu podstawowego WooCommerce. Taki podejście gwarantuje kompatybilność i łatwość konserwacji rozszerzeń, a także ułatwia ich aktualizację i upgrade. Rozszerzenia dostosowane do specyfiki danej branży (np. usługi rezerwacji, digitalnych downloadów, abonamentów) lub usprawniające użytkownicze doświadczenie (np. rozwinięte funkcje wyszukiwania, personalizowane rekomendacje) stanowią kluczowy element do osiągnięcia różnicacji na rynku i uzyskania większej kontroli nad technologiami.

Utworzenie środowiska do rozwoju rozszerzeń dla WooCommerce

Przed rozpoczęciem pisania kodu niezbędne jest posiadanie stabilnego i przybliżonego do środowiska produkcyjnego środowiska rozwoju lokalnego. To nie tylko poprawia efektywność pracy, ale także zmniejsza ryzyko, związane z eksperymentami na serwerach online.

Polecamy lekturę. Szczegółowa analiza WooCommerce: kompletny przewodnik od podstawowej konfiguracji do efektywnej obsługi.。

Konfiguracja lokalnego środowiska deweloperskiego.

Zaleca się korzystać z lokalnych środowisk integracyjnych, takich jak Local by Flywheel, Laragon lub XAMPP. Te narzędzia umożliwiają szybkie konfigurowanie PHP, MySQL oraz serwerów internetowych (np. Apache lub Nginx) na komputerze lokalnym. Upewnij się, że wersja PHP jest kompatybilna z twoimi wersjami WordPress i WooCommerce; zwykle zaleca się używać PHP 7.4 lub wyższych wersji. Ponadto konieczne jest instalowanie edytora kodu na miejscu, np. Visual Studio Code lub PhpStorm, które oferują dobrą obsługę przy rozwoju aplikacji w języku PHP i na platformie WordPress.

UltaHost – hostingu dla stron WordPress

Gwarancja zwrotu pieniędzy w ciągu 30 dni, nieograniczony przepustowość sieci i dostęp do bazy danych, bezpłatna ochrona przed atakami typu DDoS. Promocja: 50% przy zakupie na 3 lata.

strona dostępu

Instalowanie WordPressa i WooCommercea

W twoim lokalnym środowisku serwerowym najpierw zainstaluj nową wersję WordPress. Zaleca się pobranie najnowszej wersji z witryny WordPress.org. Po zakończeniu instalacji wejdź do panelu administracyjnego WordPress i przejdź na stronę “Dodatki” > “Instalowanie dodatków”. Tam wyszukaj i zainstaluj odpowiedni dodatek. WooCommerceZgodnie z instrukcją konfiguracji w WooCommerce ustawisz podstawowe parametry, stworzysz produkt do testów, a także nastawisz metody płatności i koszty dostawy, aby stworzyć realistyczne środowisko do dalszego rozwoju. Ponadto zaleca się włączyć tryb debugowania w WordPress. wp-config.php W pliku znajduje się… WP_DEBUG Konstanta ustawiona jest na… trueTo pomaga szybko wykrywać błędy podczas procesu rozwoju.

Stworzenie twojego pierwszego dodatku dla platformy WooCommerce

Rozszerzenie dla WooCommerce w istocie jest pluginem do WordPress. Pierwszym krokiem w tworzeniu takiego pluginu jest ustalenie poprawnej struktury plików oraz podanie informacji o samym pluginie.

Struktura podstawowych plików wtyczek

W katalogu instalacji WordPressu. wp-content/plugins W folderze utwórz nowy folder, na przykład nazwany „nowy_folder”. my-first-woocommerce-extensionW tym folderze utwórz plik głównego pluginu, zwykle nazwanego według nazwy pluginu. my-first-woocommerce-extension.phpTo punkt wejścia do pluginu; musi zawierać standardowe komentarze typu „header” stosowane w pluginach WordPress.

<?php
/**
 * Plugin Name: My First WooCommerce Extension
 * Plugin URI:  https://yourwebsite.com/
 * Description: 一个简单的 WooCommerce 扩展示例，用于演示开发基础。
 * Version:     1.0.0
 * Author:      Your Name
 * License:     GPL v2 or later
 * Text Domain: my-first-wc-ext
 */

Dodaj prosty mechanizm hookowania funkcji.

Aby upewnić się, że nasze rozszerzenia będą uruchamiane tylko w momencie aktywacji platformy WooCommerce, a dodawane funkcje będą bezpieczne, musimy użyć „hooków działań” (Action Hooks) lub „hooków filtrów” (Filter Hooks). Poniżej jest przykład kodu, który dodaje tekst dostosowany po tytule strony produktu. woocommerce_single_product_summary Ten aktywny hook.

Polecamy lekturę. Co to jest WooCommerce i jakie są jego kluczowe elementy?。

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

// 检查 WooCommerce 是否激活
if ( in_array( 'woocommerce/woocommerce.php', apply_filters( 'active_plugins', get_option( 'active_plugins' ) ) ) ) {

add_action( 'woocommerce_single_product_summary', 'my_custom_product_message', 6 );

function my_custom_product_message() {
        echo '<p class="my-custom-text">To tekst dodany za pomocą własnej rozszerzalności.</p>';
    }
}

Zapisz powyższy kod do swojego głównego pliku wtyczki, a potem włącz tę wtyczkę w panelu administracyjnym WordPress. Odwiedź dowolną stronę produktu i powinienś zauważyć dodany tekst kustomny w pobliżu nagłówka produktu. Ten prosty przykład pokazuje, jak interweniować w proces renderowania witryny w WooCommerce za pomocą hooków.

Dokładniej: wykorzystanie hooków akcji i filtrów

Rozszerzalność platformy WooCommerce w dużej mierze zależy od jej rozwiniętego i elastycznego systemu hooków. Zrozumienie i biegłe korzystanie z hooków stanowi podstawę dla realizacji zaawansowanych rozwiązań programowych.

Przykłady hooków do często używanych działań

Aktywnie działające “haki” (ang. action hooks) umożliwiają wykonywanie własnego kodu w określonych momencach. Na przykład chcesz, aby w momencie, gdy stan zamówienia zmieni się na “Zakończone”, została uruchomiona operacja wysyłania danych do zewnętrznego systemu. To można zrealizować za pomocą… woocommerce_order_status_completed Implementacja „haka”.

hosting.com Hosting współdzielony

Wysoka wydajność dzięki procesorom AMD EPYC, pamięci masowej NVMe SSD i LiteSpeed, wewnętrzne wsparcie ekspertów 24/7, zaawansowane środki bezpieczeństwa, w tym SSL, brute force, ochrona przed złośliwym oprogramowaniem i DDoS, oszczędność do 73%

strona dostępu

add_action( 'woocommerce_order_status_completed', 'send_order_to_erp' );

function send_order_to_erp( $order_id ) {
    $order = wc_get_order( $order_id );
    // 编写你的逻辑，例如获取订单数据并调用外部 API
    // error_log( "订单 #{$order_id} 已完成，准备同步至ERP。" );
}

Kolejnym częstym scenariem jest dodawanie pola dostosowanego na stronie dokonania płatności. Można to zrobić za pomocą… woocommerce_after_order_notes Aktywny hook.

Przykłady często używanych hooków filtrów

Filtry typu “hook” umożliwiają modyfikację już istniejących danych. Na przykład chcesz dodać stałą dopłatę do cen wszystkich produktów lub zmienić wynik obliczeń kosztów transportu. Można też zmienić cenę konkretnego produktu w koszyku zakupów. woocommerce_product_get_price Filtry.

add_filter( 'woocommerce_product_get_price', 'increase_price_by_ten', 10, 2 );

function increase_price_by_ten( $price, $product ) {
    // 只对特定产品ID为 99 的产品生效
    if ( 99 === $product->get_id() ) {
        $price = $price + 10;
    }
    return $price;
}

Modyfikacja pola stosowanego przy dokonaniu płatności to typowe zastosowanie drugiego hooka filtrów. woocommerce_checkout_fields Filtry można łatwo dodawać, usuwać lub przemieszczać pomiędzy poszczególnymi polami.

Polecamy lekturę. Szczegółowa analiza WooCommerce: kompletny przewodnik po tworzeniu wysokowydajnej witryny e-commerce od podstaw.。

Rozszerzone ćwiczenie praktyczne: tworzenie własnych kart produktów

Aby zapewnić bardziej kompletny przykład z praktycznego zastosowania, stworzymy funkcję, która umożliwi dodanie do strony produktu osobistej karty z nazwą “Specyfikacje”.

Zarejestruj nową kartę produktu.

Najpierw musimy użyć… woocommerce_product_tabs Można użyć filtrów, aby dodać własne karty do już istniejącej listy kart produktów (np. “Opis”, “Opinie”).

Hosting współdzielony InterServer

Hosting współdzielony $2.50 USD miesięcznie, pierwszy miesiąc $0.1 USD kod promocyjny tryinterserver, 461 skryptów aplikacji w chmurze, instalacja jednym kliknięciem.

strona dostępu

add_filter( 'woocommerce_product_tabs', 'add_custom_specification_tab' );
function add_custom_specification_tab( $tabs ) {
    // 添加新选项卡
    $tabs['specification_tab'] = array(
        'title'    => __( '规格参数', 'my-first-wc-ext' ),
        'priority' => 50,
        'callback' => 'display_custom_specification_tab_content'
    );
    return $tabs;
}

Definicja funkcji do wyświetlania zawartości kartek

Następnie musimy definiować powyżej wspomnianą funkcję obsługiwania wywołań (callback function). display_custom_specification_tab_contentTen element jest używany do wyświetlania zawartości HTML w danej karcie. W tym przykładzie wyświetliliśmy prosty tekst, ustawiony bezpośrednio w kodzie, ale w rzeczywistych projektach można uzyskać ten tekst z dowolnych polów dostosowanych produktu (zawartych w bazie danych lub innych źródłach danych). Advanced Custom Fields Dane są dynamicznie pobierane z wtyczek lub z metadanych postów wtyczonych (lub wtyczonych w sposób standardowy).

function display_custom_specification_tab_content() {
    // 这里可以编写从数据库获取数据的逻辑
    echo '<h2>Dokładne specyfikacje produktu</h2>'echo '<p>Oto szczegółowe techniczne specyfikacje produktu, informacje o materiałach, rozmiarach itd. Programiści mogą dodawać własne pola, aby dynamicznie wyświetlać odpowiednie dane.</p>'echo '<ul>'echo '<li>Materiał: wysokiej jakości stop aluminiumu</li>'echo '<li>Rozmiary: 30 cm x 20 cm x 10 cm</li>'echo '<li>Waga: 1,5 kg</li>'echo '</ul>';
}

Dodaj ten kod do swojego głównego pliku rozszerzenia, zapisz go i odśwież stronę produktu. Powinno pojawić się nowe okno z nazwą “Specyfikacje” obok kartki “Opis”. Ten przykład pokazuje, jak w praktyce można wykorzystać „hooki filtrów” do modyfikacji struktury danych w WooCommerce oraz funkcje wywoływane po odwołaniu („callback functions”) do generowania treści wyświetlanych na stronie. Jest to typowy sposób budowy rozszerzeń dla tego systemu.

Podsumowanie.

Rozwoj rozszerzeń dla platformy WooCommerce to potężny proces, który umożliwia przekształcenie standardowej platformy handlowej w dostosowaną do potrzeb klienta rozwiązanie biznesowe. Zaczęliśmy od zrozumienia konieczności tworzenia własnych rozszerzeń, po czym przygotowaliśmy profesjonalne środowisko lokalnego do rozwoju i stopniowo stworzyliśmy bazowy moduł o standardowej strukturze. Głębokie badanie systemu akcji i hooków w WooCommerce umożliwiło nam opanowanie kluczowych metod wprowadzania lub modyfikowania funkcji w kluczowych punktach procesu. Ostatnie ćwiczenie – tworzenie własnych kart produktów – umożliwiło nam połączenie wszystkich etapów rozwoju, od używania hooków do renderowania treści na stronie klienta. Pamiętaj, że zawsze warto preferować hooki zamiast bezpośrednich modyfikacji core files – to zapewni dobrą kompatybilność i łatwość utrzymania rozszerzenia, a także umożliwi jego bezproblemowe aktualizowanie wraz z rozwojem platformy WooCommerce.

FAQ – najczęściej zadawane pytania.

Jak decydować, czy dla danej funkcji należy użyć aktywnego hooka (action hook), czy filtra (filter hook)?

Prostym sposobem na to jest: jeśli twój kod musi wykonać jakąś akcję w określonym momencie czasu (na przykład wysłać e-mail, zarejestrować informację do logów, wyświetlić treść w formacie HTML), to zwykle używa się aktywnych hooków (ang. action hooks).add_actionJeśli twój kod wymaga modyfikacji jakiegoś istniejącego wartości (na przykład zmiany ceny, korekcji kosztów transportu lub edycji tekstu), wtedy należy użyć hooków filtrów.add_filterW istocie filtr jest rodzajem specjalnego zachowania, które wymaga powrotu wartości.

Moje rozszerzenie musi być kompatybilne z kilkoma wersjami WooCommerce. Na co należy zwrócić uwagę?

Podstawowym zasadą jest unikanie używania funkcji i metod, które zostały wykreślone z oficjalnej dokumentacji. Podczas rozwoju sprawdź dokumentację dla najniższej wersji WooCommerce, którą używasz. Wykorzystuj warunkowe sprawdzenia, aby sprawdzić, czy dane funkcje lub klasy są dostępne. Na przykład, przed ich wywołaniem… wc_get_order Wcześniej można sprawdzić, czy funkcja w ogóle istnieje. Jeśli nie, należy wrócić do użycia starszej wersji tej funkcji. get_order Zadbaj o aktywną używkę konstant wersji WordPress i WooCommerce w celu sprawdzania dostępnych funkcji.

Jak efektywnie debugować kod podczas procesu rozwoju?

Pierwszym krokiem jest włączenie trybu debugowania w WordPress. wp-config.php Ustawienia w aplikacji mobilnej define( 'WP_DEBUG', true );„Użyj”. error_log() Funkcja umożliwia zapisy informacji o zmiennej do logów błędów na serwerze, co jest bardzo przydatne przy śledzeniu toku wykonywania programu. Ponadto można zainstalować dodatki dla programistów, np. Query Monitor, które w czasie rzeczywistym wyświetlają informacje o wykonywanych procedurach, zapytaniach do bazy danych, błędach i ostrzeżeniach w PHP. To doskonałe narzędzie pomocne przy rozwijaniu rozszerzeń dla platformy WooCommerce.

Moja rozszerzona funkcjonalność może zostać złożona do oficjalnego sklepu rozszerzeń WooCommerce?

Możliwe, ale proces i wymagania są dość surowe. Twoja rozszerzona funkcjonalność musi spełniać standardy kodowania WordPress i WooCommerce; musisz zapewnić wysoką jakość kodu bez błędów oraz dobrą obsługę w różnych językach (internacjonalizację). Ponadto konieczne jest złożenie wniosku na stronie WooCommerce.com, gdzie zespół sprawdzi bezpieczeństwo rozszerzenia, jakość kodu oraz jego funkcjonalność. Osobom rozwojowym lub małym zespołom również jest dostępna opcja publikacji rozszerzeń w katalogu pluginów na WordPress.org lub na stronach rynków third-party, np. CodeCanyon.