Web Yükleyici Kılavuzu

FeedbackPulse SaaS güzel, tarayıcı tabanlı bir yükleyiciyle birlikte gelir. Komut satırı gerekmez (başlangıçtaki dosya yükleme ve composer install sonrasında).

Yükleyiciye Erişim

Şu adrese gidin:

https://yourdomain.com/install

Yükleyiciyi göremiyorsanız? Şunları kontrol edin:

Web sunucunuzun public/ dizinine işaret ettiğinden

Apache mod_rewrite'ın etkin olduğundan (veya Nginx'in doğru try_files ayarına sahip olduğundan)

storage/installed.lock dosyasının OLMADĞINDAN (bu dosya ilk kurulumdan sonra yükleyiciyi engeller)

Adım 1: Karşılama ve Lisans

İlk ekran sizi karşılar ve Envato/CodeCanyon satın alma kodunuzu ister.

Satın alma kodunuzu nerede bulabilirsiniz:

CodeCanyon adresine giriş yapın
İndirmeler → FeedbackPulse SaaS'ı bulun
İndir → Lisans belgesi ve satın alma kodu'na tıklayın
Satın alma kodu şöyle görünür: a1b2c3d4-e5f6-7890-abcd-ef1234567890

Ne yapar:

Lisansınızı Envato API ile doğrular
Meşru bir kopyaya sahip olduğunuzu teyit eder
Yükleyicinin geri kalanının kilidini açar

Adım 2: Gereksinim Kontrolü

Yükleyici sunucunuzu otomatik olarak tarar ve şunları kontrol eder:

PHP Sürümü

PHP 8.4 veya üzeri gereklidir
Mevcut PHP sürümünüzü gösterir

Bağımlılıklar

vendor/autoload.php'nin var olduğunu kontrol eder (Composer bağımlılıkları kurulu veya yüklenmiş olmalıdır)

PHP Uzantıları

Şunlar kontrol edilir:

pdo_mysql — Veritabanı bağlantısı
mbstring — Dize işleme
openssl — Şifreleme
tokenizer — Kod ayrıştırma
xml — XML işleme
ctype — Karakter doğrulama
json — JSON işleme
bcmath — Matematik işlemleri
fileinfo — Dosya türü tespiti
curl — API çağrıları

Dizin İzinleri

storage/ — Yazılabilir olmalıdır
bootstrap/cache/ — Yazılabilir olmalıdır

Sonuç Görüntüleme

Yeşil onay işaretleri = gereksinim karşılandı
Kırmızı çarpılar = gereksinim KARŞILANMADI (devam etmeden önce düzeltilmeli)

Başarısız kontrolleri düzeltme:

# Eksik PHP uzantılarını yükleyin (Ubuntu)
sudo apt install php8.4-mysql php8.4-mbstring php8.4-xml php8.4-bcmath php8.4-curl php8.4-gd php8.4-zip

# İzinleri düzeltin
sudo chmod -R 775 storage bootstrap/cache
sudo chown -R www-data:www-data storage bootstrap/cache

# PHP'yi yeniden başlatın
sudo systemctl restart php8.4-fpm

Adım 3: Veritabanı Yapılandırması

MySQL/MariaDB bağlantı bilgilerinizi girin:

Alan	Örnek	Notlar
Veritabanı Sunucusu	`127.0.0.1`	Güvenilirlik için `localhost` yerine `127.0.0.1` kullanın
Veritabanı Portu	`3306`	Varsayılan MySQL portu
Veritabanı Adı	`feedbackpulse`	Önceden oluşturulmuş olmalıdır!
Veritabanı Kullanıcı Adı	`feedbackpulse_user`	Veritabanında tam ayrıcalıklı
Veritabanı Şifresi	`your_secure_password`	Kullanıcının şifresi

Bu Adımdan Önce

Önce veritabanını oluşturmanız gerekir:

-- MySQL'e giriş yapın
mysql -u root -p

-- Veritabanı oluşturun
CREATE DATABASE feedbackpulse CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- Özel kullanıcı oluşturun (önerilir)
CREATE USER 'feedbackpulse_user'@'localhost' IDENTIFIED BY 'your_secure_password';
GRANT ALL PRIVILEGES ON feedbackpulse.* TO 'feedbackpulse_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

"Veritabanını Kur"a Tıkladığınızda Ne Olur

Yükleyici bağlantıyı test eder
Veritabanı kimlik bilgilerinizi .env dosyasına kaydeder
Tüm veritabanı geçişlerini çalıştırır (~30 tablo oluşturur)
Varsayılan verileri ekler:
- 3 varsayılan abonelik planı (Başlangıç, Büyüme, Pro)
- Varsayılan platform ayarları
Başarı mesajı gösterir

Not: Oturum ve önbellek sürücüleri kurulum sırasında kararlılık için file olarak kalır. Tamamlama adımında otomatik olarak database'e geçirilir.

Bu adım sunucunuza bağlı olarak 10-30 saniye sürebilir.

Adım 4: Yönetici Hesabı

Süper yönetici hesabınızı oluşturun:

Alan	Örnek	Notlar
Tam Ad	Ahmet Yılmaz	Görünen adınız
E-posta Adresi	[email protected]	Giriş ve bildirimler için kullanılır
Şifre	(güçlü şifre)	Minimum 8 karakter. Güçlü bir şifre kullanın!
Şifreyi Onayla	(eşleşmeli)	Eşleşmeli

Ne Olur

role = superadmin ile kullanıcı hesabınız oluşturulur
Bu otomatik olarak oluşturulan tek süper yönetici hesabıdır
/login adresinde giriş yapmak ve /admin/dashboard'a erişmek için kullanacaksınız

Güvenlik ipucu: Benzersiz, güçlü bir şifre kullanın. Ayarlar'dan daha sonra 2FA'yı etkinleştirebilirsiniz.

Adım 5: E-posta Yapılandırması

İşlemsel e-postalar göndermek için SMTP yapılandırın:

Alan	Örnek	Notlar
SMTP Sunucusu	`smtp.gmail.com`	E-posta sağlayıcınızın SMTP sunucusu
SMTP Portu	`587`	TLS için 587, SSL için 465
SMTP Kullanıcı Adı	`[email protected]`	Genellikle e-posta adresiniz
SMTP Şifresi	`your_app_password`	Uygulamaya özel şifre önerilir
Şifreleme	`tls`	TLS (önerilen) veya SSL
Gönderen Adresi	`[email protected]`	Giden e-postalardaki "gönderen" adresi
Gönderen Adı	`FeedbackPulse`	Giden e-postalardaki "gönderen" adı

Yaygın SMTP Sağlayıcıları

Sağlayıcı	Sunucu	Port	Şifreleme	Notlar
Gmail	`smtp.gmail.com`	587	TLS	Uygulama Şifresi gerektirir (normal şifre değil)
Mailgun	`smtp.mailgun.org`	587	TLS	İşlemsel e-posta için idealdir
Amazon SES	`email-smtp.{region}.amazonaws.com`	587	TLS	Ölçekte maliyet etkin
SendGrid	`smtp.sendgrid.net`	587	TLS	Kullanıcı adı olarak `apikey` kullanın
Postmark	`smtp.postmarkapp.com`	587	TLS	En iyi teslim edilebilirlik
Mailtrap	`sandbox.smtp.mailtrap.io`	587	TLS	Yalnızca test için!

Şimdi e-posta yapılandıramıyor musunuz? Bu adımı atlayabilir ve daha sonra Admin → Ayarlar → E-posta bölümünden yapılandırabilirsiniz. Platform e-posta olmadan çalışır, ancak davetler, özetler ve şifre sıfırlama gibi özellikler işlev görmez.

Adım 6: Kurulum Tamamlandı!

Şunları içeren bir başarı sayfası göreceksiniz:

Veritabanı yapılandırıldı ve geçirildi
Yönetici hesabı oluşturuldu
E-posta yapılandırıldı
installed.lock dosyası oluşturuldu
Oturum ve önbellek sürücüleri database'e geçirildi
Web tabanlı cron için CRON_TOKEN otomatik oluşturuldu
Paylaşımlı barındırma bildirimi (sembolik bağlantı oluşturulamadıysa)

Cron İşi Talimatları (tamamlama sayfasında gösterilir)

Tamamlama sayfası kopyala-yapıştır komutlarıyla iki cron kurulum seçeneği gösterir:

CLI Komutu — VPS/özel sunucular için:

* * * * * cd /path/to/project && php artisan schedule:run >> /dev/null 2>&1

URL/wget — paylaşımlı barındırma için (otomatik oluşturulan CRON_TOKEN ile):
```
wget -q -O /dev/null "https://yourdomain.com/cron/run?token=YOUR_CRON_TOKEN"
```

Bunları kaydedin! Sayfadan ayrılmadan önce tamamlama sayfasından cron komutunu kopyalayın. CRON_TOKEN'ınızı .env dosyasında da bulabilirsiniz.

`installed.lock` Dosyası

Yükleyici, herhangi birinin yükleyiciyi yeniden çalıştırmasını önlemek için storage/installed.lock dosyasını oluşturur. Bu bir güvenlik önlemidir.

Yükleyiciyi yeniden çalıştırmak için (örn. yeni kurulum), bu dosyayı silin:
rm storage/installed.lock
Ardından /install adresini tekrar ziyaret edin.

Kurulum Sonrası Kontrol Listesi

Yükleyici tamamlandıktan sonra:

Cron işini kurun — tamamlama sayfasında gösterilen talimatları kullanarak (bkz. Cron İşleri ve Kuyruk İşçileri)
Süper yönetici kimlik bilgilerinizle https://yourdomain.com/login adresinde giriş yapın
Admin → Planlar — abonelik planlarını inceleyin ve özelleştirin
Admin → Ayarlar → Ödemeler — Stripe/PayPal'ı bağlayın
Admin → Ayarlar → E-posta — test e-postası gönderin
Admin → Açılış Sayfası — genel ana sayfanızı özelleştirin
SSL kurun (bkz. SSL Sertifikaları)
İsteğe bağlı olarak joker karakter DNS kurun (bkz. Joker Karakter DNS Kurulumu)

Sonraki Adımlar

Apache Yapılandırması veya Nginx Yapılandırması
Ortam Değişkenleri — .env dosyanızı ince ayarlayın
Cron İşleri ve Kuyruk İşçileri — otomatik görevleri kurun

Yükleyiciye Erişim​

Adım 1: Karşılama ve Lisans​

Adım 2: Gereksinim Kontrolü​

PHP Sürümü​

Bağımlılıklar​

PHP Uzantıları​

Dizin İzinleri​

Sonuç Görüntüleme​

Adım 3: Veritabanı Yapılandırması​

Bu Adımdan Önce​

"Veritabanını Kur"a Tıkladığınızda Ne Olur​

Adım 4: Yönetici Hesabı​

Ne Olur​

Adım 5: E-posta Yapılandırması​

Yaygın SMTP Sağlayıcıları​

Adım 6: Kurulum Tamamlandı!​

Cron İşi Talimatları (tamamlama sayfasında gösterilir)​

installed.lock Dosyası​

Kurulum Sonrası Kontrol Listesi​

Sonraki Adımlar​