XenForo Kurulumu

XenForo Kurulumu​

XenForo, özellikle topluluk siteleri ve forum projeleri için kullanılan güçlü bir forum yazılımıdır. Kendi sunucunuza veya hosting hesabınıza kurularak tamamen size ait bir forum sistemi oluşturabilirsiniz.

Kurulum sırasında özellikle:

• Hosting veya sunucu gereksinimleri
• Veritabanı oluşturma
• XenForo dosyalarının doğru dizine yüklenmesi
• Kurulum ekranındaki veritabanı bilgilerinin doğru girilmesi

önemlidir.

XenForo'nun güncel 2.3 serisi için PHP 7.2 veya üzeri gerekir ve PHP 8.3 önerilir. MySQL 5.7 veya daha yeni sürümler desteklenir. MariaDB ve Percona gibi uyumlu veritabanları da kullanılabilir.

XenForo Nedir?​

XenForo, PHP ve MySQL tabanlı bir forum yazılımıdır.

Bu sistem ile:

• Forum kategorileri
• Kullanıcı profilleri
• Özel mesajlar
• Üyelik grupları
• Yetkilendirme sistemi
• Eklentiler
• Temalar
• Bildirimler

gibi birçok özellik kullanılabilir.

XenForo kendi hosting veya sunucunuza kurulabilen lisanslı bir yazılımdır.

XenForo Kurulumu İçin Neler Gerekir?​

Kuruluma başlamadan önce temel olarak:

• XenForo lisansı
• Hosting veya sunucu
• Domain
• MySQL veya MariaDB veritabanı
• FTP veya Dosya Yöneticisi erişimi

gereklidir.

XenForo'nun resmi kurulum yönteminde Customer Area üzerinden indirilen dosyaların sunucuya yüklenmesi ve ardından tarayıcı üzerinden kurulum ekranının çalıştırılması gerekir.

XenForo Dosyaları Nereden İndirilir?​

XenForo satın alındıktan sonra müşteri hesabına giriş yapılır.

Buradan kullanılacak site bilgileri tanımlanarak XenForo paketi indirilebilir.

Yeni kurulum yapılıyorsa indirme sırasında yalnızca yükseltme dosyalarını içeren paket seçilmemelidir.

Yeni kurulum için tam kurulum paketi indirilmelidir.

XenForo Dosyalarının İçerisinde Ne Bulunur?​

İndirilen ZIP dosyası açıldığında:

upload

isimli bir klasör görülür.

Sunucuya yüklenmesi gereken klasör doğrudan upload klasörünün kendisi değildir.

Bu klasörün:

içerisindeki dosya ve klasörler

sunucuya yüklenmelidir.

Örneğin yükleme tamamlandıktan sonra XenForo dizininde:

admin.php

ve

css.php

gibi dosyaları doğrudan görebilmelisiniz.

XenForo Ana Domainde Nasıl Kurulur?​

Forumun:

siteadi.com

adresinden açılmasını istiyorsanız XenForo dosyalarını domainin web root dizinine yüklemelisiniz.

cPanel kullanan sistemlerde bu dizin çoğunlukla:

public_html

olur.

Yani upload klasörünün içerisindeki dosyalar doğrudan public_html içerisine yüklenebilir.

XenForo Alt Dizine Nasıl Kurulur?​

Forumun:

siteadi.com/forum

şeklinde çalışmasını istiyorsanız public_html içerisinde:

forum

isimli bir klasör oluşturabilirsiniz.

Daha sonra upload klasörünün içerisindeki XenForo dosyaları:

public_html/forum

içerisine yüklenir.

Bu durumda forum adresiniz:

Ziyaretçiler için gizlenmiş link,görmek için Giriş yap veya üye ol.

olur.

XenForo'nun resmi dokümantasyonu da alt dizin kurulumu için benzer şekilde web root altında ayrı bir klasör oluşturulmasını önerir.

Veritabanı Neden Gereklidir?​

XenForo kullanıcıları, mesajları, forum kategorilerini ve diğer birçok bilgiyi veritabanında saklar.

Bu nedenle kurulumdan önce boş bir veritabanı oluşturulmalıdır.

Genellikle:

• MySQL
• MariaDB

kullanılır.

cPanel Üzerinden Veritabanı Nasıl Oluşturulur?​

cPanel kullanan hostinglerde:

MySQL Databases

veya

MySQL Database Wizard

bölümüne girilebilir.

Buradan:

1. Yeni veritabanı oluşturulur.
2. Yeni veritabanı kullanıcısı oluşturulur.
3. Kullanıcı veritabanına eklenir.
4. Kullanıcıya gerekli yetkiler verilir.

Kurulum sırasında kullanılacağı için:

• Veritabanı adı
• Veritabanı kullanıcı adı
• Veritabanı şifresi

kaydedilmelidir.

Veritabanı Sunucusu Ne Olmalı?​

Çoğu klasik hosting hesabında:

localhost

kullanılır.

Ancak bazı hosting firmaları farklı bir MySQL sunucu adresi kullanabilir.

Bu nedenle veritabanına bağlanılamıyorsa hosting sağlayıcısının verdiği MySQL Host bilgisi kontrol edilmelidir.

XenForo veritabanı yapılandırmasında varsayılan host değeri localhost, varsayılan MySQL portu ise 3306 olarak kullanılır.

Kurulum Ekranı Nasıl Açılır?​

Dosyalar sunucuya yüklendikten sonra tarayıcıdan XenForo kurulum dizinine girilir.

Ana domaine kurulduysa:

Ziyaretçiler için gizlenmiş link,görmek için Giriş yap veya üye ol.

Alt klasöre kurulduysa:

Ziyaretçiler için gizlenmiş link,görmek için Giriş yap veya üye ol.

adresine gidilebilir.

Doğru yükleme yapıldıysa XenForo kurulum ekranı açılır.

Kurulum Ekranı Açılmıyorsa Ne Yapılmalı?​

Öncelikle dosyaların doğru dizinde olduğundan emin olunmalıdır.

Örneğin yanlışlıkla:

public_html/upload/admin.php

şeklinde yükleme yapıldıysa XenForo bir alt klasörde kalmış olabilir.

Ana domaine kurulum için yapı:

public_html/admin.php

şeklinde olmalıdır.

Yani upload klasörünün kendisi değil içerisindeki dosyalar yüklenmelidir.

Dosya İzinleri Neden Önemlidir?​

XenForo bazı klasörlere veri yazmak zorundadır.

Özellikle:

data

ve

internal_data

klasörlerinin web sunucusu tarafından yazılabilir olması gerekir.

Sunucu yapılandırmasına göre kurulum ekranı bu klasörlerin yazılabilir olmadığını söyleyebilir.

Bu durumda klasör izinlerinin düzenlenmesi gerekir.

CHMOD Nedir?​

CHMOD, Linux sunucularda dosya ve klasör izinlerini belirlemek için kullanılan sistemdir.

XenForo kurulumunda gerekli olduğunda:

data

ve

internal_data

klasörleri yazılabilir hale getirilmelidir.

Resmi kurulum dokümantasyonu gerekli olduğu sistemlerde bu klasörler için 0777 iznini örnek olarak belirtmektedir.

Ancak hosting yapılandırması izin veriyorsa daha sınırlı izinlerle çalıştırmak güvenlik açısından tercih edilebilir.

Veritabanı Bilgileri Nasıl Girilir?​

Kurulum ekranında XenForo veritabanı bağlantı bilgilerini ister.

Genellikle:

Database host: localhost
Database port: 3306
Database name: oluşturduğunuz veritabanı
Database username: oluşturduğunuz kullanıcı
Database password: belirlediğiniz şifre

şeklinde doldurulur.

XenForo bu bilgileri kullanarak veritabanına bağlanır.

config.php Nedir?​

XenForo'nun veritabanı bağlantı bilgileri:

src/config.php

dosyasında saklanır.

Kurulum sistemi çoğu hosting ortamında bu dosyayı otomatik oluşturabilir.

Ancak dosya otomatik oluşturulamazsa XenForo yapılandırma dosyasını indirmenizi isteyebilir.

Bu durumda indirilen:

config.php

dosyası:

src

klasörüne yüklenmelidir.

config.php Dosyasında Neler Bulunur?​

Temel olarak:

• MySQL sunucu adresi
• Port
• Veritabanı kullanıcı adı
• Veritabanı şifresi
• Veritabanı adı

bulunur.

Örneğin XenForo yapılandırması şu alanları kullanır:

host
port
username
password
dbname

Bu dosyanın yanlış düzenlenmesi forumun veritabanına bağlanamamasına neden olabilir.

Kurulum Ne Kadar Sürer?​

Veritabanı bağlantısı doğrulandıktan sonra XenForo gerekli tabloları otomatik olarak oluşturur.

Sunucu performansına göre bu işlem kısa bir süre içerisinde tamamlanabilir.

Kurulum sırasında sayfayı gereksiz şekilde kapatmamak veya yenilememek daha sağlıklıdır.

Yönetici Hesabı Oluşturma​

Kurulumun ilerleyen aşamalarında ilk yönetici hesabı oluşturulur.

Burada:

• Kullanıcı adı
• E-posta adresi
• Şifre

belirlenir.

Bu hesap XenForo Admin Control Panel'e giriş yapmak için kullanılacaktır.

Güçlü ve başka sitelerde kullanılmayan bir şifre tercih edilmelidir.

Forum Adı Nasıl Belirlenir?​

Kurulum sırasında forumun adı da belirlenebilir.

Örneğin:

Teknoloji Forumu

veya

Oyun Topluluğu

gibi bir başlık kullanılabilir.

Bu bilgiler daha sonra yönetim panelinden değiştirilebilir.

XenForo Yönetim Paneline Nasıl Girilir?​

Kurulum tamamlandıktan sonra yönetim paneline:

Ziyaretçiler için gizlenmiş link,görmek için Giriş yap veya üye ol.

adresinden ulaşılabilir.

XenForo resmi dokümantasyonunda da Admin Control Panel için site adresine /admin.php eklenmesi belirtilmektedir.

Buradan forumun bütün temel ayarları yönetilebilir.

Admin Panelde Neler Yapılabilir?​

Yönetim panelinden:

• Forum kategorileri oluşturulabilir
• Kullanıcı grupları düzenlenebilir
• Yetkiler ayarlanabilir
• Eklentiler kurulabilir
• Temalar yönetilebilir
• Spam ayarları yapılabilir
• E-posta ayarları düzenlenebilir
• API anahtarları oluşturulabilir

XenForo'nun yönetim sistemi forumun büyük bölümünü kod düzenlemeden yönetmeye imkan verir.

Forum Kategorisi Nasıl Oluşturulur?​

Kurulumdan sonra ilk yapılacak işlemlerden biri forum bölümlerini oluşturmaktır.

Örneğin:

Genel

• Genel Sohbet
• Tanışma

Teknoloji

• Donanım
• Yazılım
• İnternet

Oyun

• League of Legends
• Metin2

gibi bir yapı oluşturulabilir.

Forum bölümleri yönetim panelindeki Node sistemi üzerinden düzenlenebilir.

HTTPS Kullanılmalı mı?​

Evet.

Forum giriş bilgileri ve kullanıcı hesapları içerdiği için HTTPS kullanılması önemlidir.

Domain üzerinde geçerli bir SSL sertifikası bulunmalıdır.

Hosting hesabınız destekliyorsa Let's Encrypt veya AutoSSL gibi sistemlerle ücretsiz SSL kullanılabilir.

SSL Kurulumdan Önce mi Yapılmalı?​

Mümkünse evet.

Forum baştan:

https://

üzerinden kurulursa daha sonra URL değişikliğiyle uğraşmak gerekmez.

Özellikle:

• Cookie
• Redirect
• Görsel bağlantıları

açısından HTTPS'i en baştan kullanmak daha temiz bir kurulum sağlar.

PHP Sürümü Nasıl Olmalı?​

XenForo 2.3 için minimum:

PHP 7.2

gereklidir.

Ancak XenForo güncel 2.3 sürümleri için:

PHP 8.3

önerilmektedir.

Yeni kurulum yapılıyorsa sunucunun ve kullanılan eklentilerin uyumlu olması şartıyla güncel ve desteklenen PHP sürümlerinden biri tercih edilmelidir.

MySQL Sürümü Nasıl Olmalı?​

XenForo 2.3 için minimum:

MySQL 5.7

gereklidir.

MariaDB ve Percona gibi MySQL uyumlu sistemler de desteklenmektedir.

Yeni sunucularda güncel MariaDB veya MySQL sürümü kullanmak daha mantıklıdır.

XenForo Cloud ile Manuel Kurulum Aynı mı?​

Hayır.

XenForo Cloud kullanıyorsanız manuel FTP ve veritabanı kurulumu yapmanız gerekmez.

Cloud hizmetinde kurulum ve güncelleme işlemleri XenForo tarafından yönetilir.

Manuel kurulum adımları XenForo'nun self-hosted lisansını kendi hosting veya sunucusunda kullanacak kişiler içindir.

XenForo Eklentisi Nasıl Kurulur?​

XenForo kurulduktan sonra özellikleri eklentilerle genişletilebilir.

Desteklenen sunucu yapılandırmalarında Admin Panel içerisinden ZIP dosyası yükleyerek eklenti kurulabilir.

Manuel yöntemde ise eklenti paketindeki:

upload

klasörünün içeriği XenForo'nun kurulu olduğu dizine yüklenir.

Daha sonra Admin Panel üzerinden eklenti kurulumu tamamlanır.

XenForo Tema Kurulumu​

Tema veya style dosyaları genellikle yönetim panelinden içe aktarılabilir.

Ancak kullanılan temaya göre ek dosyaların sunucuya yüklenmesi gerekebilir.

Tema kurulurken XenForo sürümüyle uyumluluk mutlaka kontrol edilmelidir.

Eski sürüm için hazırlanmış tema yeni XenForo sürümünde görsel veya işlevsel sorun oluşturabilir.

XenForo Güncelleme ile Kurulum Aynı mı?​

Hayır.

Daha önce XenForo kurulmuş bir forumu yeni sürüme geçirmek istiyorsanız:

Install

değil,

Upgrade

işlemi yapılmalıdır.

Mevcut forum üzerine sıfır kurulum yapmak veri kaybına neden olabilir.

Güncellemeden Önce Yedek Alınmalı mı?​

Evet.

XenForo güncellemesi veya büyük değişikliklerden önce:

• Veritabanı
• data klasörü
• internal_data klasörü
• XenForo dosyaları

yedeklenmelidir.

Özellikle veritabanı ve kullanıcı yüklemeleri forumun en önemli verileridir.

Dosyalar Eksik Yüklendiyse Ne Olur?​

FTP bağlantısı kesilmiş veya bazı dosyalar yüklenmemişse:

• Beyaz ekran
• 500 hatası
• Eksik dosya hatası
• Kurulum ekranının açılmaması

gibi problemler görülebilir.

Bu durumda XenForo paketindeki dosyalar yeniden kontrol edilmeli ve eksik olanlar yüklenmelidir.

500 Internal Server Error Alınıyorsa​

500 hatasının birçok nedeni olabilir.

Örneğin:

• Yanlış PHP sürümü
• Eksik PHP eklentisi
• Dosya izinleri
• Hatalı .htaccess
• Eksik XenForo dosyaları

soruna neden olabilir.

Hosting error log kayıtları incelenerek gerçek hata tespit edilmelidir.

Veritabanına Bağlanamıyor Hatası​

Bu hata genellikle yanlış:

• Database Host
• Database Name
• Username
• Password

bilgilerinden kaynaklanır.

Özellikle cPanel sistemlerinde veritabanı ve kullanıcı adının başına cPanel kullanıcı adı otomatik eklenebilir.

Örneğin oluşturduğunuz veritabanı:

forum

olmasına rağmen gerçek adı:

kullanici_forum

olabilir.

Kurulum ekranına tam isim girilmelidir.

data ve internal_data Hatası​

Kurulum ekranında bu klasörlerin yazılabilir olmadığı belirtiliyorsa izinlerin düzenlenmesi gerekir.

Ancak klasörleri gereksiz yere tüm dünyaya yazılabilir bırakmak yerine hosting yapısına uygun izin kullanılmalıdır.

Kurulum ekranı hatayı göstermiyorsa manuel olarak izin değiştirmek genellikle gerekli değildir.

XenForo Kurulumunda En Sık Yapılan Hatalar​

upload Klasörünü Olduğu Gibi Yüklemek​

Bu durumda forum yanlışlıkla:

siteadi.com/upload/

altında açılabilir.

upload klasörünün içerisindeki dosyalar yüklenmelidir.

Veritabanı Kullanıcısına Yetki Vermemek​

Veritabanı oluşturmak tek başına yeterli değildir.

Oluşturulan kullanıcı veritabanına atanmalı ve gerekli yetkileri almalıdır.

Yanlış PHP Sürümü Kullanmak​

Uyumsuz PHP sürümü kurulum hatalarına neden olabilir.

HTTP ile Kurup Sonradan HTTPS'e Geçmek​

Sonradan yapılabilir ancak baştan HTTPS kullanmak daha temizdir.

Mevcut Site Dosyalarının Üzerine Kurulum Yapmak​

XenForo kurulacak dizinde başka bir web sitesi varsa dosyalar birbirine karışabilir.

Kurulum için boş veya uygun bir dizin kullanılmalıdır.

Başlangıç Seviyesi İçin​

İlk kez XenForo kuracak kullanıcı için en kolay yöntem cPanel hosting kullanmaktır.

Temel işlem sırası:

1. Domaini hosting hesabına bağlayın.
2. SSL sertifikasını aktif edin.
3. MySQL veritabanı ve kullanıcı oluşturun.
4. XenForo paketini indirin.
5. upload klasörünün içerisindeki dosyaları public_html içerisine yükleyin.
6. siteadi.com/install/ adresini açın.
7. Veritabanı bilgilerini girin.
8. Yönetici hesabını oluşturun.
9. Kurulumu tamamlayın.

Bu işlemler tamamlandıktan sonra forum kullanılmaya başlanabilir.

Orta Seviye İçin​

Kurulum tamamlandıktan sonra:

• SEO URL ayarları
• SMTP e-posta sistemi
• Kullanıcı grupları
• Spam koruması
• Cron görevleri
• Cache sistemi
• Yedekleme

gibi ayarlar yapılandırılabilir.

Özellikle gerçek kullanıcıların kayıt olacağı forumlarda e-posta ve güvenlik ayarları ihmal edilmemelidir.

İleri Seviye İçin​

VPS veya fiziksel sunucu üzerinde XenForo kuruluyorsa daha gelişmiş optimizasyon yapılabilir.

Örneğin:

• PHP-FPM
• OPcache
• Redis
• Nginx
• MariaDB optimizasyonu
• CDN
• Object Cache

kullanılabilir.

Büyük forumlarda veritabanı ve cache performansı özellikle önem kazanır.

Sonuç​

XenForo kurulumu temel olarak dosyaların sunucuya yüklenmesi, boş bir veritabanı oluşturulması ve web tabanlı kurulum ekranının tamamlanmasından oluşur.

Yeni bir kurulum için en temel sıra:

XenForo dosyalarını indir → upload içeriğini sunucuya yükle → veritabanı oluştur → /install/ adresini aç → veritabanı bilgilerini gir → yönetici hesabını oluştur

şeklindedir.

Kurulum sırasında özellikle dosyaların doğru dizine yüklenmesine, veritabanı bilgilerinin doğru girilmesine ve data ile internal_data klasörlerinin yazılabilir olmasına dikkat edilmelidir.

Kurulum tamamlandıktan sonra yönetim paneline:

siteadi.com/admin.php

adresinden ulaşılabilir ve forum kategorileri, kullanıcı grupları, temalar, eklentiler ve diğer sistem ayarları yapılandırılabilir.