ResimYolu Eklentisi Kurulum Rehberi (vBulletin 3.8.x)
GENEL BİLGİLER
Bu dokümanda, vBulletin 3.8.x forum yazılımı için ResimYolu resim yükleme eklentisinin kurulum ve yapılandırması anlatılmaktadır.
Eklenti, ResimYolu.com API'sini kullanarak kullanıcıların foruma resim yüklemesini sağlar.
SİSTEM GEREKSİNİMLERİ
vBulletin 3.8.x veya üzeri
PHP 5.6+ önerilir
CURL kütüphanesi etkin
GD Library (resim işleme için)
ResimYolu.Com API anahtarı
Yazma izni olan upload klasörü
KURULUM ADIM ADIM
ADIM 1: DOSYALARI HAZIRLAYIN
Kuruluma başlamadan önce iki dosyaya ihtiyacınız vardır:
resimyolu.xml - Eklenti tanım dosyası
upload.php - Resim yükleme işlemini yapan PHP dosyası
jquery-1.1.3.1.pack.
js -
JS islemlerinin dosyası
Bu dosyaları bilgisayarınıza indirin (zip) içersinde mevcut ve hazır tutun.
ADIM 2: zip dosyasında bulunan dosyaları yükleyin
FTP veya dosya yöneticisi ile forum kök dizinine bağlanın
public_html , clientscript dosyasını forum kök dizinine yükleyin
Dosya içindekilerin izinlerini 644 veya 755 olarak ayarlayın
upload klasörünün varlığını kontrol edin (varsa devam edin, yoksa oluşturun)
ADIM 3: EKLENTIYI YÜKLEYIN
vBulletin Admin Paneline giriş yapın (admincp/index.php)
Sol menüden "Plugins & Products" seçeneğini bulun
"Manage Products" veya "Eklentileri Yönet" tıklayın
"Add/Import Product" veya "Eklenti Ekle/İçe Aktar" butonuna tıklayın
"Choose File" ile resimyolu.xml dosyasını seçin
"Import" veya "İçe Aktar" butonuna tıklayın
-
Kurulum başarılı olursa, aşağıdaki mesajı göreceksiniz:
"Resim Yolu Eklentisi v1.0.0 kuruldu!
ÖNEMLİ: Template düzenlemeleri için AdminCP > Styles & Templates > Style Manager > Edit Templates bölümüne gidin."
ADIM 4: API ANAHTARINI AYARLAYIN
Admin Panelinde "Settings" veya "Ayarlar" bölümüne gidin
"Options" veya "Seçenekler" tıklayın
"Cyb - Resim Yolu - Ayarlar" grubunu bulun
Aşağıdaki ayarları yapılandırın:
AYAR 1: Eklentiyi Aktif Et
Değer: Evet
Açıklama: Eklentiyi açmak veya kapatmak için kullanılır
AYAR 2: API Anahtarı
Değer: ResimYolu.com'dan alınan API anahtarınız
Açıklama: ResimYolu.com hesabınızdan API anahtarını alıp buraya yapıştırın
Örnek: sk_live_abcdef123456789
Dikkat ; upload.php içersindeki
API-KEY-GIRIN kısmını ve
forumadresi.com kısmını değiştirin.
AYAR 3: API URL
Değer:
[Üye Olmadan Linkleri Göremezsiniz. Üye Olmak için TIKLAYIN...]
Açıklama: Değiştirmeyin, ResimYolu API endpoint'i
AYAR 4: Maksimum Dosya Boyutu (MB)
Değer: 10
Açıklama: Kullanıcıların yükleyebileceği maksimum dosya boyutu 5 (MB)
AYAR 5: İzin Verilen Dosya Tipleri
Değer: image/jpeg,image/png,image/gif,image/webp
Açıklama: Yüklenebilecek resim formatları (MIME type)
AYAR 6: Hızlı Cevapta Göster
Değer: Evet
Açıklama: Hızlı cevap (Quick Reply) alanında resim yükleme aracını göster
AYAR 7: Gelişmiş Cevapta Göster
Değer: Evet
Açıklama: Gelişmiş cevap sayfasında resim yükleme aracını göster
AYAR 8: Yeni Konuda Göster
Değer: Evet
Açıklama: Yeni konu oluşturma sayfasında resim yükleme aracını göster
Tüm ayarları yaptıktan sonra "Save" veya "Kaydet" butonuna tıklayın.
ADIM 5: TEMPLATE DÜZENLEMELERI
Bu adım çok önemlidir. Eklentinin çalışması için template dosyalarına kod eklemeniz gerekir.
TEMPLATE 1: NEWTHREAD (Yeni Konu Oluşturma)
Admin Panelinde "Styles & Templates" bölümüne gidin
"Style Manager" tıklayın
Kullanılan stil seçin
"Edit Templates" tıklayın
"NEWTHREAD" template'ini bulun
Düzenle butonuna tıklayın
Template içinde "<textarea name="message"" satırını bulun
Bu satırın Üstüne aşağıdaki kodu ekleyin:
$resimyolu_upload_form
Kaydet butonuna tıklayın
TEMPLATE 2: NEWREPLY (Cevap Yazma)
Aynı şekilde "NEWREPLY" template'ini bulun
Düzenle butonuna tıklayın
"<textarea name="message"" satırını bulun
Bu satırın Üstüne aşağıdaki kodu ekleyin:
$resimyolu_upload_form
Kaydet butonuna tıklayın
TEMPLATE 3: SHOWTHREAD (Konuyu Görüntüle)
"SHOWTHREAD" template'ini bulun
Düzenle butonuna tıklayın
Aşağıdaki satırı bulun:
<div id="$editorid" class="vBulletin_editor">$messagearea</div>
Bu satırın Üstüne aşağıdaki kodu ekleyin:
$resimyolu_upload_form
Kaydet butonuna tıklayın
KURULUM SONRASI KONTROLLER
Kurulum tamamlandıktan sonra aşağıdaki kontrolleri yapın:
KONTROL 1: Klasör İzinleri
upload klasörü yazılabilir olmalıdır (755 veya 777)
upload/temp klasörü oluşturulmuş olmalıdır
upload/error.log ve upload/debug.log yazılabilir olmalıdır
KONTROL 2: Veritabanı Tabloları
Kurulum sırasında iki tablo oluşturulmuş olmalıdır:
resimyolu_log (resim yükleme kayıtları)
resimyolu_stats (istatistikler)
KONTROL 3: Forumda Test
Yeni konu oluşturma sayfasına gidin
Resim yükleme aracının görünüp görünmediğini kontrol edin
Bir resim yükleyerek test edin
KONTROL 4: Hata Günlüğü
Sorun yaşanırsa upload/debug.log dosyasını kontrol edin
Hataları bu dosyadan takip edebilirsiniz
DESTEKLENEN DOSYA FORMATLARI
Eklenti aşağıdaki resim formatlarını desteklemektedir:
JPG/JPEG (.jpg, .jpeg)
PNG (.png)
GIF (.gif)
WebP (.webp)
YÜKLEME ÖZELLİKLERİ ÖZELLIK 1: Bilgisayardan Yükleme
Sürükle ve bırak (Drag & Drop) desteği
Tıkla ve dosya seç
Çoklu dosya yükleme
ÖZELLIK 2: URL'den Yükleme
İnternet'teki bir resmin URL'sini yapıştırıp yükleme
Otomatik indirme ve yükleme
ÖZELLIK 3: Resim Boyutlandırma
Yükleme sırasında resim boyutlandırma seçeneği
Maksimum genişlik/yükseklik ayarı
ÖZELLIK 4: İlerleme Göstergesi
Yükleme ilerlemesini görsel olarak gösterir
Dosya boyutu ve yükleme hızını gösterir
SORUN GİDERME SORUN 1: "API Anahtarı Eksik" Hatası
Çözüm:
Admin Panelinde API Anahtarı ayarını kontrol edin
ResimYolu.com'dan geçerli bir API anahtarı alın
Ayarı kaydedin ve sayfayı yenileyin
SORUN 2: "Dosya Boyutu Çok Büyük" Hatası Çözüm:
Maksimum Dosya Boyutu ayarını artırın
PHP.ini dosyasında upload_max_filesize ve post_max_size ayarlarını kontrol edin
Sunucu yöneticisine başvurun
SORUN 3: Resim Yükleme Aracı Görünmüyor Çözüm:
Eklentinin aktif olup olmadığını kontrol edin
Template düzenlemelerinin yapılıp yapılmadığını kontrol edin
Tarayıcı önbelleğini temizleyin
Admin Panelinde "Rebuild Template Cache" yapın
SORUN 4: "CURL Hatası" Mesajı Çözüm:
Sunucuda CURL kütüphanesinin yüklü olup olmadığını kontrol edin
Sunucu yöneticisine başvurun
upload/debug.log dosyasını kontrol edin
SORUN 5: Resim Yüklendikten Sonra Forumda Görünmüyor Çözüm:
ResimYolu.com API anahtarının geçerli olup olmadığını kontrol edin
API URL'nin doğru olup olmadığını kontrol edin
upload/debug.log dosyasını kontrol edin
Sunucu yöneticisine başvurun
KALDIRMA (UNINSTALL)
Eklentiyi kaldırmak için:
Admin Panelinde "Plugins & Products" > "Manage Products" gidin
"Resim Yolu Eklentisi" bulun
"Uninstall" butonuna tıklayın
Onay mesajında "Evet" seçin
Kurulum sırasında oluşturulan tablolar otomatik olarak silinecektir.
Ve sonrasinda public_html içersinden upload.php silin tamamen silinmiş olacaktır.
GÜVENLIK NOTLARI
upload.php dosyasının izinlerini doğru ayarlayın (644 veya 755)
upload klasörünün içindeki dosyaları düzenli olarak temizleyin
API anahtarınızı kimseyle paylaşmayın
Düzenli olarak debug.log dosyasını kontrol edin
Sunucu yöneticisine güvenlik güncellemeleri hakkında sorun
DESTEK VE İLETİŞİM
Sorun yaşanırsa:
upload/debug.log dosyasını kontrol edin
Hata mesajını not edin
ResimYolu.com destek sayfasına gidin
SÜRÜM BİLGİSİ
Eklenti Adı: Resim Yolu Eklentisi - ResimYolu - Netguc
Sürüm: 1.0.0
Uyumlu Sürümler: vBulletin 3.8.x
API: ResimYolu.com API v1
Bilgilendirme ;
Sistem ücretsiz olarak dağıtılmaktadır bu sebeple destek sağlamıyorum,
Ancak sorun olur ise konu altından yazabilir ve topluluktan yardım alabilirsiniz.
Testler yapılarak şuanda çalışır vaziyet de sizlere sunulmuştur.
ResimYolu.Com ' da şuan maximum dosya boyutu 5 MB olarak ayarlıdır.
Resimleri yüklerken dosya boyut sorunu yaşamayacağınızı düşünmekteyim.
Dipnot ; Resimyolu.Com ' da güncelleme olmadıkça versionda yenilik yapılmayacaktır.
Sistemde güncelleme oldukça eklenti ve dosyalar güncellenecek ve yenilenecektir.
Özel düzenleme ve istekler yapılmayacaktır.
Saygılarımla
Güncelleme Tarihi: 2025
Keyifli Forumlar