Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/elemirs/woocommerce-custom-image-upload/archive/refs/heads/main.zipWooCommerce için özel görsel yükleme eklentisi. Müşteriler sepete ürün eklerken örnek görsel yükleyebilir.
Özellikler
- ✅ Sepete ekle butonuna basınca modal açılır
- ✅ Modal içinde görsel yükleme alanı
- ✅ Drag & drop ile görsel yükleme
- ✅ Dosya seçici ile görsel yükleme
- ✅ Görsel önizleme
- ✅ Sepette yüklenen görselin gösterilmesi
- ✅ Siparişte yüklenen görselin gösterilmesi
- ✅ Responsive tasarım
- ✅ WordPress admin panelinde sipariş detaylarında görsel görüntüleme
Kurulum
Manuel Kurulum
- Bu klasörü WordPress sitenizin
wp-content/plugins/dizinine kopyalayın - WordPress admin panelinde "Eklentiler" sayfasına gidin
- "WooCommerce Custom Image Upload" eklentisini aktifleştirin
Gereksinimler
- WordPress 5.8 veya üzeri
- WooCommerce 5.0 veya üzeri
- PHP 7.4 veya üzeri
Kullanım
- Eklentiyi aktifleştirdikten sonra herhangi bir ürün sayfasına gidin
- "Sepete Ekle" butonuna tıklayın
- Açılan modal'da örnek görsel yükleyin
- "Sepete Ekle" butonuna tıklayın
- Sepette ve siparişte yüklenen görsel görüntülenecektir
Dosya Yapısı
woocommerce-custom-image-upload/
├── assets/
│ ├── css/
│ │ └── style.css # Modal ve görsel yükleme stilleri
│ └── js/
│ └── script.js # Modal ve AJAX işlemleri
├── woocommerce-custom-image-upload.php # Ana eklenti dosyası
└── README.md # Dokümantasyon
Özelleştirme
CSS Özelleştirme
assets/css/style.css dosyasını düzenleyerek modal ve görsel gösterimini özelleştirebilirsiniz.
Modal Metinlerini Değiştirme
Ana eklenti dosyasındaki (woocommerce-custom-image-upload.php) text domain ile çeviri yapabilirsiniz.
Maksimum Dosya Boyutu
Varsayılan olarak 5MB'dır. Ana eklenti dosyasında handle_image_upload() fonksiyonunda değiştirebilirsiniz:
if ($file['size'] > 5 * 1024 * 1024) { // 5MB
İzin Verilen Dosya Tipleri
Varsayılan olarak JPEG, JPG, PNG ve GIF'tir. Ana eklenti dosyasında handle_image_upload() fonksiyonunda değiştirebilirsiniz:
$allowed_types = array('image/jpeg', 'image/jpg', 'image/png', 'image/gif');
Teknik Detaylar
AJAX İşlemleri
- Görsel Yükleme:
upload_product_imageaction'ı ile görsel sunucuya yüklenir - Sepete Ekleme: WooCommerce'in kendi AJAX endpoint'i kullanılır
Hooks ve Filters
woocommerce_add_cart_item_data- Sepete özel veri eklemewoocommerce_get_item_data- Sepette özel veriyi göstermewoocommerce_checkout_create_order_line_item- Siparişe özel veri kaydetmewoocommerce_order_item_meta_end- Sipariş detaylarında özel veriyi gösterme
Güvenlik
- AJAX isteklerinde nonce kontrolü
- Dosya tipi ve boyut validasyonu
- Sanitize edilen veriler
- WordPress'in kendi dosya yükleme fonksiyonları kullanılır
Sorun Giderme
Modal Açılmıyor
- Tarayıcı konsolunda JavaScript hataları kontrol edin
- WooCommerce'in aktif olduğundan emin olun
- Tema ile çakışma olabilir, başka bir tema ile test edin
Görsel Yüklenmiyor
- WordPress'te dosya yükleme izinlerini kontrol edin
wp-content/uploads/klasörünün yazılabilir olduğundan emin olun- Sunucu PHP upload limitlerini kontrol edin
Sepette Görsel Görünmüyor
- Tarayıcı önbelleğini temizleyin
- WooCommerce önbellek eklentileri varsa temizleyin
Lisans
Bu eklenti GPL v2 veya sonraki sürümleri ile lisanslanmıştır.
Destek
Sorunlar veya öneriler için GitHub repository'sinde issue açabilirsiniz.
Changelog
1.0.0
- İlk sürüm
- Modal ile görsel yükleme özelliği
- Sepet ve sipariş entegrasyonu
- Drag & drop desteği
- Responsive tasarım