Gold Pricing — Dokümantasyon
WooCommerce mağazandaki altın ürünleri, anlık has altın fiyatına göre dakikada bir kendiliğinden fiyatlanır. Her ürünün gramajı ve kârı tanımlanır; gerisini eklenti yapar.
Kurulum
- Eklenti .zip dosyasını indirin.
- WordPress yönetici paneli → Eklentiler → Yeni Ekle → Eklenti Yükle.
- .zip dosyasını seçip Şimdi Yükle → Etkinleştir.
- Sol menüde altinapps görünür. Eklenti kendi güncellemelerini otomatik kontrol eder.
Gereksinim: WordPress 6.x + WooCommerce (HPOS / Custom Order Tables uyumlu).
Lisans
Eklenti, fiyatları altinapps lisanslı API'den çeker. Panel · WooCommerce sayfasından lisans anahtarınızı alın (ücretsiz lisans için [email protected]).
- İlk 14 gün Pro tazeliğinde başlar (kart bilgisi alınmaz); sonra Free'ye düşer.
- Anahtarı altinapps → Ayarlar sayfasındaki Lisans anahtarı alanına yapıştırın, kaydedin.
Ayarlar
WordPress: altinapps → Ayarlar
| Lisans anahtarı | Panelden aldığınız anahtar (Bearer). Zorunlu. |
| API adresi | https://api.altinapps.com (varsayılan, değiştirmeyin). |
| Ürün | woo-gold (varsayılan). |
Kaydedince eklenti bağlantıyı test eder ve fiyatları bir kez çeker. "Ayarlar kaydedildi ve fiyatlar güncellendi" mesajını görmelisiniz.
Ürün fiyatlama
Her ürün (veya varyasyon) için ürün düzenleme ekranında altinapps alanlarını doldurun:
| Otomatik fiyatlama | Açık olan ürünler her senkronda yeniden fiyatlanır. Kapalıysa elle yönetilir. |
| Gramaj (has karşılığı) | Ürünün has altın karşılığı, gram. Örn. 18 ayar 10 gr ≈ 7.5 gram-has. |
| Kâr tipi & değeri | İşçilik/kâr (aşağıdaki tipler). |
Fiyat formülü
fiyat = gramaj × (anlık has altın TL/gram) + kâr
Kâr tipleri
sabit_tlHas altın bedeline sabit TL kâr eklenir (örn. +250 ₺).yuzdeYüzde kâr (örn. %3 → bedel × 1.03).gram_hasGram-has bazlı kâr (örn. +0.05 gram-has işçilik).Senkronizasyon
- Eklenti, WooCommerce Action Scheduler ile dakikada bir çalışır.
- Otomatik fiyatlamalı ürünler için yeni fiyat hesaplanır, eskisiyle karşılaştırılır, değiştiyse güncellenir.
- Çok ürünlü mağazalar için işlem 500'lük partiler halinde yapılır (timeout güvenliği).
- Fiyat akışı kesintisinde (stale veri) son geçerli fiyat korunur; eklenti zararına fiyat yazmaz.
Not: WP-Cron'un tetiklenmesi için sitede düzenli trafik ya da gerçek bir sistem cron'u olmalı.
Toplu düzenleme (CSV)
Yüzlerce ürünü tek tek düzenlemek yerine, CSV ile dışa aktarıp düzenleyip içe aktarın. Kolonlar:
id, sku, name, type, parent_id, gramaj, kar_tip, kar_deger
kar_tip: sabit_tl | yuzde | gram_has
KDV / Vergi
Eklenti, WooCommerce'in "fiyatlar KDV dahil/hariç" ayarına uyar. Has altın KDV'siz vergilendiriliyorsa, otomatik fiyatlı ürünlerin Vergi sınıfını doğru ayarlamayı unutmayın — aksi halde WooCommerce hesaplanan fiyata vergi ekleyebilir.
Sorun giderme
Ayarlar sayfasında lisansın "Geçerli" göründüğünü, ürünlerde "Otomatik fiyatlama" açık ve gramajın dolu olduğunu kontrol edin. Senkron WooCommerce Action Scheduler ile çalışır; WP-Cron tetikleniyor olmalı (siteye trafik veya gerçek cron).
Anahtarı boşluksuz kopyaladığınızdan ve doğru ürün (woo-gold) lisansı olduğundan emin olun. Domain whitelist gerekiyorsa siteyi panelden ekleyin. Ücretsiz lisans: [email protected].
Yalnızca "Otomatik fiyatlama = Evet" ve geçerli gramaj girilmiş ürünler güncellenir. Diğerleri elle yönetilir.
Fiyat = gramaj × has altın (anlık) + kâr. Kâr tipi (sabit_tl / yüzde / gram_has) ve değerini kontrol edin. KDV ayarınız da etkiler (aşağıya bakın).
Yardım
E-posta: [email protected] · Ürün sayfası: altinapps.com/woo-gold · Kendi sisteminize veri mi lazım? REST API dokümanı