WordPress Borsa Verileri Eklentisi

Trunçgil Finans API verilerini çekip header ticker ve tablo embedleri oluşturan WordPress eklentisi. Döviz kurları, altın fiyatları ve diğer finansal enstrümanları sitenizde görüntüleyin.

🚀 Özellikler

📊 Veri Kaynağı

• ✅ Trunçgil Finans API: Trunçgil Finans API'sinden anlık finansal veriler
• ✅ Çoklu API Versiyonları: v1, v2, v3 ve v4 API desteği
• ✅ Otomatik Fallback: v4 başarısız olursa otomatik olarak v3'e geçiş
• ✅ Cache Sistemi: Performans için önbellekleme (ayarlanabilir TTL)
• ✅ Backup Cache: Hata durumunda eski cache'i göstererek site çökmesini önler

🎨 Görüntüleme Özellikleri

• ✅ Header Ticker: Sayfa üstünde kayan borsa ticker'ı
• ✅ Tablo Görünümü: Gruplandırılmış finansal enstrüman tabloları
• ✅ Otomatik Gruplama: Döviz, Değerli Madenler, Kripto vb. otomatik gruplama
• ✅ Renk Özelleştirme: Arka plan, yazı ve vurgu renkleri özelleştirilebilir
• ✅ Responsive Tasarım: Mobil uyumlu arayüz
• ✅ Değişim Göstergeleri: Artış/azalış için renkli göstergeler

💱 Desteklenen Enstrümanlar

Dövizler

• USD (Dolar)
• EUR (Euro)
• GBP (İngiliz Sterlini)
• CHF (İsviçre Frangı)
• CAD (Kanada Doları)
• AUD (Avustralya Doları)
• SAR (Suudi Arabistan Riyali)
• JPY (Japon Yeni)
• KWD (Kuveyt Dinarı)
• NOK (Norveç Kronu)
• DKK (Danimarka Kronu)
• SEK (İsveç Kronu)
• BGN (Bulgar Levası)
• RUB (Ruble)
• IRR (İran Riyali)
• PLN (Zloty)
• CNY (Çin Yuanı)

Değerli Madenler

• ONS (Ons Altın)
• Gram Altın
• Gram Has Altın
• Çeyrek Altın
• Yarım Altın
• Tam Altın
• Cumhuriyet Altını
• Ata Altın
• 14 Ayar Altın
• 18 Ayar Altın
• 22 Ayar Bilezik
• İkibuçuk Altın
• Beşli Altın
• Gremse Altın
• Reşat Altın
• Hamit Altın
• Gümüş
• Gram Platin
• Gram Paladyum

Diğer

• Kripto paralar (v4 API ile)
• Emtia fiyatları

⚙️ Özelleştirme

• ✅ Enstrüman Seçimi: Ticker ve tablo için özel enstrüman seçimi
• ✅ Ticker Hızı: Kayan ticker hızını ayarlama (15-300 saniye)
• ✅ Başlık Özelleştirme: Ticker başlığını özelleştirme
• ✅ Cache Yönetimi: Önbellek süresini ayarlama (minimum 30 saniye)

📋 Gereksinimler

• WordPress 5.0 veya üzeri
• PHP 7.4 veya üzeri
• cURL desteği (WordPress wp_remote_get için)
• İnternet bağlantısı (API çağrıları için)

🔧 Kurulum

1. Eklentiyi Yükleyin

1. Bu repository'yi klonlayın veya ZIP olarak indirin
2. borsa-verileri klasörünü WordPress'in wp-content/plugins/ klasörüne kopyalayın
3. WordPress admin paneline giriş yapın
4. Eklentiler > Yüklü Eklentiler sayfasına gidin
5. Borsa Verileri eklentisini aktifleştirin

2. Ayarları Yapılandırın

Ayarlar > Borsa Verileri sayfasından:

1. API Versiyonu: v3 önerilir (v4 genişletilmiş set + kripto)
2. Önbellek Süresi: API çağrıları arasındaki bekleme süresi (saniye)
3. Header Ticker: Aktifleştirmek için checkbox'ı işaretleyin
4. Ticker Enstrümanları: Virgülle ayırın (örn: USD, EUR, Gram Altın, Çeyrek Altın)
5. Tablo Enstrümanları: Virgülle ayırın (boşsa tüm enstrümanlar gösterilir)
6. Başlık: Ticker başlığını özelleştirin
7. Renkler: Arka plan, yazı ve vurgu renklerini ayarlayın
8. Ticker Hızı: Kayan ticker hızını ayarlayın (saniye)

📖 Kullanım

Shortcode Kullanımı

Header Ticker

[borsa_ticker]

Parametreler:

• title: Ticker başlığı (varsayılan: ayarlardan alınır)

Örnek:

[borsa_ticker title="Canlı Piyasa Verileri"]

Tablo Görünümü

[borsa_tablosu]

Tablo, enstrümanları otomatik olarak gruplara ayırır:

• Döviz: Tüm döviz kurları
• Değerli Madenler: Altın, gümüş, platin, paladyum
• Kripto: Kripto paralar (v4 API ile)

Otomatik Header Ticker

Ayarlardan "Header Ticker" seçeneğini aktifleştirdiğinizde, ticker otomatik olarak sayfa footer'ına eklenir. Bu özellik için temanızın wp_footer() veya wp_body_open() hook'larını çağırması gerekir.

Elementor Kullanıcıları: Shortcode'u doğrudan widget içine ekleyebilirsiniz.

Enstrüman İsimlendirme

• Dövizler için: Kod kullanın (örn: USD, EUR, GBP)
• Altın ve değerli madenler için: İsim kullanın (örn: Gram Altın, Çeyrek Altın, Gümüş)

Desteklenen Formatlar:

• Kodlar: USD, EUR, GRA, ONS, GPL, PAL
• İsimler: Gram Altın, Çeyrek Altın, Dolar, Euro
• Slug'lar: gram-altin, ceyrek-altin (otomatik dönüştürülür)

🎨 Özelleştirme

CSS Özelleştirme

Eklenti kendi CSS dosyalarını yükler. Özelleştirmek için:

1. Tema'nızın style.css dosyasına özel CSS ekleyin
2. Veya child theme kullanın

CSS Sınıfları:

• .bv-ticker: Ticker container
• .bv-ticker__item: Ticker öğesi
• .bv-ticker__price: Fiyat gösterimi
• .bv-ticker__change: Değişim göstergesi
• .bv-table-wrap: Tablo wrapper
• .bv-table: Tablo
• .bv-change--up: Artış göstergesi (yeşil)
• .bv-change--down: Azalış göstergesi (kırmızı)
• .bv-change--flat: Değişim yok (gri)

CSS Değişkenleri:

.bv-ticker {
    --bv-bg: #0033A1;      /* Arka plan rengi */
    --bv-text: #ffffff;    /* Yazı rengi */
    --bv-accent: #6dd400;  /* Vurgu rengi */
    --bv-speed: 60s;       /* Ticker hızı */
}

JavaScript Hook'ları

Eklenti, JavaScript hook'ları sağlar:

// Ticker yüklendiğinde
jQuery(document).on('bv:ticker:loaded', function(e, data) {
    console.log('Ticker yüklendi', data);
});

// Tablo yüklendiğinde
jQuery(document).on('bv:table:loaded', function(e, data) {
    console.log('Tablo yüklendi', data);
});

📁 Klasör Yapısı

borsa-verileri/
├── assets/                          # CSS ve JS dosyaları
│   ├── css/
│   │   ├── admin.css                # Admin panel stilleri
│   │   └── borsa-verileri.css       # Frontend stilleri
│   └── js/
│       └── borsa-verileri.js         # Frontend JavaScript
├── includes/                         # PHP sınıfları
│   ├── class-borsa-verileri-api.php # API işlemleri
│   ├── class-borsa-verileri-settings.php # Ayarlar sayfası
│   └── class-borsa-verileri-render.php   # Render işlemleri
├── borsa-verileri.php                # Ana eklenti dosyası
└── README.md                         # Bu dosya

🔒 Güvenlik

• ✅ Nonce kontrolü ile CSRF koruması
• ✅ Veri sanitizasyonu ve doğrulama
• ✅ XSS koruması (WordPress sanitize fonksiyonları)
• ✅ Capability kontrolü (admin işlemleri için)
• ✅ SSL doğrulaması (API çağrıları için)

🌐 Çoklu Dil Desteği

Eklenti çoklu dil desteği için hazırlanmıştır. Text domain: borsa-verileri

Dil dosyalarını languages/ klasörüne ekleyin veya Loco Translate gibi bir eklenti kullanın.

🐛 Sorun Giderme

Ticker Görünmüyor

1. Ayarlardan "Header Ticker" seçeneğinin aktif olduğunu kontrol edin
2. Tema'nızın wp_footer() hook'unu çağırdığından emin olun
3. JavaScript hatalarını kontrol edin (tarayıcı konsolu)
4. Shortcode'u manuel olarak eklemeyi deneyin: [borsa_ticker]

Veriler Güncellenmiyor

1. Cache süresini kontrol edin (ayarlardan)
2. API versiyonunu kontrol edin
3. İnternet bağlantısını kontrol edin
4. Sunucu loglarını kontrol edin

Tablo Boş Görünüyor

1. Tablo enstrümanlarının doğru formatta olduğunu kontrol edin
2. API versiyonunu kontrol edin (v4 daha fazla enstrüman içerir)
3. Cache'i temizleyin
4. Ayarlardan tablo enstrümanlarını boş bırakarak tüm enstrümanları görmeyi deneyin

API Bağlantı Hatası

1. İnternet bağlantısını kontrol edin
2. API endpoint'lerinin erişilebilir olduğunu kontrol edin
3. Sunucu firewall ayarlarını kontrol edin
4. Eklenti otomatik olarak backup cache'i gösterir, bu normaldir

Renkler Uygulanmıyor

1. CSS dosyalarının yüklendiğinden emin olun
2. Tema CSS'inin eklenti CSS'ini override etmediğini kontrol edin
3. Tarayıcı cache'ini temizleyin

📝 API Versiyonları

v1

• TCMB verisi
• Temel döviz seti

v2

• Türkçe karakter içermeyen isimler
• Boşluksuz format

v3 (Önerilen)

• Serbest piyasa verileri
• Anlık % değişim bilgisi
• Geniş enstrüman yelpazesi

v4

• Genişletilmiş enstrüman seti
• Kripto para desteği
• Daha fazla altın türevi

📝 Changelog

1.0.0

• İlk sürüm
• Trunçgil Finans API entegrasyonu
• Header ticker desteği
• Tablo görünümü
• Otomatik gruplama
• Renk özelleştirme
• Cache sistemi
• Otomatik fallback mekanizması

👤 Yazar

Ahmet Burak Çaylak

• Website: https://www.burakcaylak.com/

📄 Lisans

Bu proje özel bir projedir.

🤝 Katkıda Bulunma

Katkılarınızı bekliyoruz! Lütfen pull request göndermeden önce:

1. Fork edin
2. Feature branch oluşturun (git checkout -b feature/amazing-feature)
3. Değişikliklerinizi commit edin (git commit -m 'Add amazing feature')
4. Branch'inizi push edin (git push origin feature/amazing-feature)
5. Pull Request açın

📞 Destek

Sorularınız için issue açabilirsiniz.

🔗 İlgili Kaynaklar

• WordPress Plugin Handbook
• Trunçgil Finans API
• WordPress Transients API

💡 Kullanım Örnekleri

Örnek 1: Basit Ticker

[borsa_ticker]

Örnek 2: Özel Başlıklı Ticker

[borsa_ticker title="Canlı Borsa Verileri"]

Örnek 3: Tablo Görünümü

[borsa_tablosu]

Örnek 4: Widget İçinde Kullanım (Elementor)

1. Elementor editöründe bir widget ekleyin
2. "Shortcode" widget'ını seçin
3. [borsa_ticker] veya [borsa_tablosu] yazın

Örnek 5: Tema Dosyasında Kullanım

<?php
if (shortcode_exists('borsa_ticker')) {
    echo do_shortcode('[borsa_ticker]');
}
?>