WooCommerce Eklenti Geliştirme Temelleri ve Uygulama Kılavuzu

Neden WooCommerce eklentileri geliştirmeye ihtiyaç var?

WooCommerce, WordPress ekosistemindeki en güçlü e-ticaret eklentilerinden biridir ve temel özellikleriyle çevrimiçi mağaza işletmeciliğinin temel ihtiyaçlarını karşılar; ürün yönetimi, alışveriş sepeti, ödeme ve ödeme işlemleri gibi. Ancak her işletmenin iş modeli, ürün özellikleri ve işleyiş süreçleri kendine özgüdür. Standart özellikler, özelleştirilmiş ürün ayarları, karmaşık kargo hesaplama kuralları, belirli kurumsal kaynak planlama (ERP) sistemleriyle entegrasyon veya özel üye seviye sistemleri gibi ihtiyaçları genellikle karşılayamaz. Bu durumlarda, özel WooCommerce eklentileri geliştirmek kaçınılmaz hale gelir.

Geliştiriciler, genişletmeler (ekstralar) oluşturarak belirli iş mantıklarını bağımsız modüller haline getirebilir ve WooCommerce’ın çekirdek kodunu değiştirmeden mağaza işlevlerini sorunsuz bir şekilde geliştirebilir veya değiştirebilirler. Bu yaklaşım, genişletmelerin uyumluluğunu ve sürdürülebilirliğini sağlar ve sonraki güncellemeler ile yükseltmeler için kolaylık sunar. İster belirli sektörlere (rezervasyon hizmetleri, dijital indirmeler, abonelik sistemleri) çözümler sunmak isterse, ister kullanıcı deneyimini iyileştirmek (gelişmiş arama özellikleri, kişiselleştirilmiş öneriler) istesin, özel genişletmeler işletmelerin farklılaşmasını ve teknolojik özerkliğini sağlamanın ana yoludur.

WooCommerce e-ticaret platformu için genişletme (ek özellikler) geliştirme ortamı kurmak

Kod yazmaya başlamadan önce, stabil ve üretim ortamına yakın bir yerel geliştirme ortamına sahip olmak şarttır. Bu, sadece geliştirme verimliliğini artırmakla kalmaz, aynı zamanda çevrimiçi sunucularda yapılan deneylerin beraberinde getirebileceği riskleri de önler.

Tavsiye edilen okuma WooCommerce'i detaylı olarak analiz edin: Temel yapılandırmadan verimli işletmeye kadar kapsamlı bir rehber.。

Yerel Geliştirme Ortamı Ayarları

Yerel sunucu entegrasyon ortamlarının kullanılmasını öneririz; örneğin Local by Flywheel, Laragon veya XAMPP. Bu araçlar, PHP, MySQL ve Apache veya Nginx gibi web sunucularını yerel bilgisayarda hızlı bir şekilde yapılandırmanıza olanak tanır. Kullandığınız PHP sürümünün hedef WordPress ve WooCommerce sürümleriyle uyumlu olduğundan emin olmanız gerekir; genellikle PHP 7.4 veya daha yüksek sürümlerinin kullanılması önerilir. Ayrıca, PHP ve WordPress geliştirme için iyi destek sunan Visual Studio Code veya PhpStorm gibi bir kod editörü de yerel olarak yüklemeniz gerekir.

UltaHost WordPress Sunucusu

30 gün iade garantisi, sınırsız bant genişliği ve veritabanı kullanımı, ücretsiz DDoS koruması; 3 yıllık abonelikte indirim (50%).

Sayfaya erişin.

WordPress ve WooCommerce’u Kurma

Yerel sunucu ortamınızda öncelikle yepyeni bir WordPress kurun. En yeni sürümü WordPress.org’dan indirmenizi öneririz. Kurulum tamamlandıktan sonra, WordPress yönetim panelinin “Eklentiler” > “Eklenti Yükle” sayfasına gidin, arama yapın ve istediğiniz eklentiyi yükleyin. WooCommerceWooCommerce ayar yönlendiricisini kullanarak temel yapılandırmaları tamamlayın, bir test ürünü oluşturun ve ödeme ile kargo ayarlarını yapın; böylece sonraki genişletme geliştirmeleri için gerçekçi bir test ortamı sağlamış olursunuz. Ayrıca, WordPress’in hata ayıklama modunu etkinleştirmenizi öneririz. wp-config.php Dosyada, WP_DEBUG Sabit, olarak ayarlandı. trueBu, geliştirme sürecinde hataları hızlı bir şekilde tespit etmeye yardımcı olur.

İlk WooCommerce eklentinizi oluşturun.

WooCommerce eklentisi, esasen bir WordPress eklentisidir. Bir eklenti oluşturmanın ilk adımı, doğru dosya yapısını oluşturmak ve eklenti bilgilerini belirtmektir.

Eklenti Temel Dosya Yapısı

WordPress kurulum dizininizin altındaki wp-content/plugins Dosya içinde, örneğin, yeni bir klasör oluşturun. my-first-woocommerce-extensionBu klasör içinde, genellikle eklentinin adıyla adlandırılan ana eklenti dosyasını oluşturun. my-first-woocommerce-extension.phpBu, eklentinin giriş noktasıdır ve standart WordPress eklenti başlık yorumlarını içermelidir.

<?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
 */

Basit bir işlev bağlantısı ekleyin.

Genişlememizin yalnızca WooCommerce etkinleştirildiğinde çalışmasını ve işlevlerin güvenli bir şekilde eklenebilmesini sağlamak için Eylem Kancası (Action Hook) veya Filtre Kancası (Filter Hook) kullanmamız gerekiyor. Aşağıda, tek bir ürün sayfasının başlığının ardına özel bir metin ekleyen bir örnek bulunmaktadır. Kullanılan yöntem şu şekildedir: woocommerce_single_product_summary Bu eylem hook’u.

Tavsiye edilen okuma WooCommerce nedir ve temel bileşenleri nelerdir?。

// 防止文件被直接访问
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">Bu, özel bir eklenti aracılığıyla eklenen bir metindir!</p>';
    }
}

Yukarıdaki kodu ana eklenti dosyanıza kaydedin, ardından WordPress arayüzüne girip bu eklentiyi etkinleştirin. Herhangi bir ürün sayfasına gittiğinizde, ürün başlığının yakınında eklenen özel paragrafı görmelisiniz. Bu basit örnek, WooCommerce’un renderleme sürecine nasıl müdahale edileceğini göstermektedir.

Derinlemesine İnceleme: Eylem ve Filtre Hook’larını Kullanmak

WooCommerce’in genişletilebilirliği, büyük ve esnek kancalama (hook) sistemine büyük ölçüde bağlıdır. Kancaları anlamak ve ustaca kullanmak, ileri düzey geliştirme yapmanın temelidir.

Yaygın Eylem Kancaları Örnekleri

Eylem kancaları, belirli bir zamanda kendi kodunuzu “çalıştırmanıza” olanak tanır. Örneğin, bir siparişin durumu “Tamamlandı”ya dönüştüğünde, dış bir sisteme veri gönderen bir işlemi tetiklemek isteyebilirsiniz. Bu, eylem kancaları aracılığıyla kolayca gerçekleştirilebilir. woocommerce_order_status_completed Kancanın (hook) uygulanması.

hosting.com Paylaşımlı Barındırma

AMD EPYC CPU'lar, NVMe SSD depolama ve LiteSpeed ile yüksek performans, 7/24, 7x7 uzman şirket içi destek, SSL, kaba kuvvet, kötü amaçlı yazılım ve DDoS koruması dahil gelişmiş güvenlik önlemleri, 73%'ye kadar tasarruf

Sayfaya erişin.

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。" );
}

Başka bir yaygın senaryo, ödeme sayfasına özel alanlar eklemektir. Bunu yapmak için şu yöntemler kullanılabilir: woocommerce_after_order_notes Eylem kancaları (Action Hooks).

Yaygın kullanılan filtre kancaları örnekleri

Filtre hook’ları, mevcut verileri “değiştirmenize” olanak tanır. Örneğin, tüm ürün fiyatlarına sabit bir tutar eklemek veya kargo hesaplama sonuçlarını değiştirmek isteyebilirsiniz. Alışveriş sepetindeki belirli bir ürünün fiyatını değiştirmek için bunları kullanabilirsiniz. woocommerce_product_get_price Filtreler.

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

Ödeme bilgilerini değiştirmek, başka bir filtre mekanizmasının tipik bir uygulamasıdır. woocommerce_checkout_fields Filtreler, alanları kolayca ekleyebilir, kaldırabilir veya yeniden sıralayabilirsiniz.

Tavsiye edilen okuma WooCommerce’ü Derinlemesine Analiz Etme: Sıfırdan Yüksek Performanslı E-Ticaret Siteleri Oluşturmak İçin Kapsamlı Bir Rehber。

Genişletilmiş Uygulama Örneği: Özel Ürün Seçenekleri Kartları Oluşturma

Daha kapsamlı ve pratik bir örnek sunmak için, ürün sayfalarına “Özellikler” adında özel bir sekme ekleyen bir özellik oluşturacağız.

Yeni bir ürün seçeneği kartı kaydedin.

Öncelikle, kullanmamız gereken şeyler… woocommerce_product_tabs Filtreler, mevcut ürün seçenekleri kartlarına (örneğin “Açıklama”, “Değerlendirmeler”) kendi kartlarımızı eklememizi sağlar.

InterServer Paylaşımlı Barındırma

Paylaşımlı hosting aylık $2.50 USD, ilk ay $0.1 USD promosyon kodu tryinterserver, 461 bulut uygulaması komut dosyası, tek tıklamayla yükleme.

Sayfaya erişin.

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

Tab içeriğinin görüntülenmesini sağlayan fonksiyonun tanımı

Bundan sonra, yukarıdaki geri çağırma fonksiyonunu tanımlamamız gerekiyor. display_custom_specification_tab_contentBu, ilgili seçenek kartındaki HTML içeriğini çıkarmak için kullanılır. Bu örnekte, basitçe sabitlenmiş bir metin gösteriyoruz; ancak gerçek projelerde, ürünün özel alanlarından (kullanılarak) içerik alabilirsiniz. Advanced Custom Fields Veriler, eklentiler aracılığıyla veya doğrudan gönderi meta bilgilerinden dinamik olarak elde edilir.

function display_custom_specification_tab_content() {
    // 这里可以编写从数据库获取数据的逻辑
    echo '<h2>Ürün Detaylı Özellikleri</h2>'echo '<p>Burada ürünün ayrıntılı teknik özellikleri, malzemeleri, boyutları ve diğer bilgiler yer almaktadır. Geliştiriciler, içeriği dinamik olarak göstermek için özelleştirilmiş alanlara bağlantılar ekleyebilirler.</p>'echo '<ul>'echo '<li>Malzeme: Yüksek kaliteli alüminyum alaşım</li>'echo '<li>Boyutlar: 30 cm x 20 cm x 10 cm</li>'echo '<li>Ağırlık: 1,5 kg</li>'echo '</ul>';
}

Bu kodu ana eklenti dosyanıza ekleyin, değişiklikleri kaydedin ve ardından bir ürün sayfasını yenileyin. “Açıklama” sekmesinin yanında yeni bir “Özellikler” sekmesi görünecektir. Bu pratik örnek, WooCommerce’un veri yapısını değiştirmek için filtre kancalarını (filter hooks) ve görünümü oluşturmak için geri çağırma fonksiyonlarını (callback functions) kapsamlı bir şekilde kullanmaktadır ve birçok genişletme özelliğinin tipik bir yapılandırma modelidir.

Özetle.

WooCommerce eklentisi geliştirmek, genel bir e-ticaret platformunu özelleştirilmiş bir iş çözümüne dönüştürmenin güçlü bir yoludur. Öncelikle, özel eklentiler geliştirmenin gerekliliğini anlayarak profesyonel bir yerel geliştirme ortamı oluşturduk ve ardından yapısal olarak standart bir temel eklenti oluşturduk. WooCommerce’un eylem (action) ve filtre (filter) sistemini derinlemesine inceleyerek, kritik işlem adımlarında işlevleri eklemek veya değiştirmenin temel yöntemlerini öğrendik. Son pratik uygulamamız olan özel ürün seçeneklerinin oluşturulması, eklentinin geliştirme sürecinin tamamını – eklentilerin kullanımından ön uç içeriğinin renderlanmasına kadar – bütünleştirdi. Her zaman temel dosyaları doğrudan değiştirmek yerine eklentileri kullanma ilkesini unutmayın; bu, eklentinizin iyi bir uyumluluğa ve sürdürülebilirliğe sahip olmasını sağlayacak ve WooCommerce ile birlikte sorunsuz bir şekilde yükseltilebilmesini mümkün kılacaktır.

Sıkça Sorulan Sorular.

Bir işlevin eylem kancası mı yoksa filtre kancası mı kullanılması gerektiğine nasıl karar verilir?

Basit bir değerlendirme yöntemi şudur: Eğer kodunuzun belirli bir zamanda “bir şey yapması” gerekiyorsa (örneğin e-posta göndermek, günlük kaydı tutmak, HTML çıktısı oluşturmak), genellikle eylem kancaları (action hooks) kullanılır.add_actionEğer kodunuzda “mevcut bir değeri değiştirmeniz” gerekiyorsa (örneğin fiyatı değiştirmek, kargo ücretini ayarlamak, metin içeriğini düzenlemek gibi), o zaman filtre kancalarını (filter hooks) kullanmalısınız.add_filterEsasen, bir filtre, döndürülmesi gereken bir değer gerektiren özel bir tür davranıştır.

Eklentimin birden fazla WooCommerce sürümüyle uyumlu olması gerekiyor; bu durumda nelere dikkat etmeliyim?

Öncelikli kural, artık kullanılmayan fonksiyonları ve yöntemleri kullanmaktan kaçınmaktır. Geliştirme sırasında, kullandığınız WooCommerce sürümünün en düşük desteklediği sürüme karşılık gelen resmi geliştirici dokümanlarına başvurun. Bazı fonksiyonların veya sınıfların mevcut olup olmadığını kontrol etmek için koşullu ifadeler kullanın. Örneğin, bir fonksiyonu çağırmadan önce… wc_get_order Daha önce, fonksiyonun mevcut olup olmadığını kontrol edebilirsiniz. Eğer mevcut değilse, daha eski bir sürümü kullanmaya geri dönebilirsiniz. get_order WordPress ve WooCommerce’ün sürüm sabitlerini (version constants) özellik kontrolü için aktif olarak kullanın.

Geliştirme sürecinde kodu nasıl verimli bir şekilde hata ayıklarız?

WordPress’ın hata ayıklama modunu etkinleştirmek ilk adımdır. wp-config.php Ayarlar bölümünde… define( 'WP_DEBUG', true );Kullanmak error_log() Bu fonksiyon, değişken bilgilerini sunucunun hata günlüğüne kaydeder; bu da mantık akışını takip etmek için çok faydalıdır. Ayrıca, Query Monitor gibi geliştirici eklentileri de kurabilirsiniz. Bu eklentiler, çalıştırılan işlemleri, veritabanı sorgularını, PHP hatalarını ve uyarılarını gerçek zamanlı olarak gösterir ve WooCommerce eklentilerinin geliştirilmesinde çok güçlü bir araçtır.

Geliştirdiğim eklentiyi WooCommerce resmi eklenti mağazasına gönderebilir miyim?

Tabii ki, ancak süreç ve gereklilikler oldukça katıdır. Eklemenizin WordPress ve WooCommerce’un kodlama standartlarına uygun olması gerekmektedir; yüksek kaliteli ve hatalı olmayan kod sunmanız, aynı zamanda iyi bir uluslararasılaştırma desteğine sahip olmanız beklenir. Ayrıca, eklemenizi WooCommerce.com üzerinden göndermeniz gerekmektedir. Ekibin, eklemenin güvenliğini, kod kalitesini ve işlevselliğini inceleyecektir. Bireysel geliştiriciler veya küçük ekipler için de WordPress.org eklenti dizini veya CodeCanyon gibi üçüncü parti pazarlarda eklemeyi yayınlama seçeneği mevcuttur.