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. Lütfen Ü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

Dosya İndir ; [Üye Olmadan Linkleri Göremezsiniz. Lütfen Üye Olmak için TIKLAYIN...]

Güncelleme Tarihi: 2025

Keyifli Forumlar