Kurulum

Bu rehber, MüşavirFlow eklentisinin mevcut bir WordPress kurulumuna güvenli şekilde yüklenmesi için hazırlanmıştır. Kurulum sırasında yalnız dosya kopyalama yapılmaz; aktivasyon sonrasında veritabanı migration'ları, roller, varsayılan veriler, sayfalar ve zamanlanmış görevler de devreye girer.

Öneri: Canlı sitede kurulum veya güncelleme yapmadan önce dosya ve veritabanı yedeği alın. Mevcut müşteri verisi, sirkü arşivi, aboneler ve e-posta logları veritabanında tutulduğu için yedekleme yalnız dosya kopyasıyla sınırlı olmamalıdır.

Adım 1 — Kurulum paketini hazırlayın

musavir-flow.zip dosyasını temin edin. ZIP dosyasını bilgisayarınızda açtığınızda kök dizinde musavir-flow/ klasörü bulunmalıdır.

Doğru klasör yapısı şu şekilde olmalıdır:

musavir-flow/
├── musavir-flow.php
├── admin/
├── includes/
├── public/
├── migrations/
├── assets/
└── vendor/

ZIP açıldığında dosyalar doğrudan dağılmış halde görünüyorsa veya iç içe musavir-flow/musavir-flow/ yapısı oluşmuşsa paketi sunucuya yüklemeden önce klasör yapısını düzeltin.

Adım 2 — FTP ile yükleyin (önerilen yöntem)

FTP hedefi: /wp-content/plugins/musavir-flow/

FTP istemcisi veya hosting dosya yöneticisiyle musavir-flow/ klasörünü wp-content/plugins/ altına yükleyin. Hedefteki klasör adı tam olarak musavir-flow olmalıdır.

Bu yöntem önerilir; çünkü bazı WordPress admin yükleme ekranları ZIP içeriğini yanlış açarak alt klasör yapısını bozabilir. MüşavirFlow; admin görünümleri, migration dosyaları, PDF motoru, asset dosyaları ve servis sağlayıcı sınıflarıyla birlikte klasör yapısına duyarlı çalışır.

Adım 3 — WordPress admin panelinden etkinleştirin

WordPress yönetim paneline giriş yapın.
Eklentiler ekranını açın.
Listede MüşavirFlow satırını bulun.
Etkinleştir bağlantısına tıklayın.

Aktivasyon sırasında ne olur?

Etkinleştirme işlemi MüşavirFlow'un çalışma ortamını hazırlar. Bu aşamada sistem otomatik olarak şu işlemleri yapar:

Minimum WordPress, PHP ve OpenSSL gereksinimlerini kontrol eder.
Gerekli veritabanı tablolarını ve kolonlarını migration sistemi üzerinden oluşturur veya günceller.
Sirkü, vergi takvimi, pratik bilgiler, e-posta, abone listeleri, bildirim, kaynak operasyonları ve AI logları için gerekli şema hazırlıklarını yapar.
Pratik Bilgiler ve hesaplama araçları için başlangıç verilerini ve parametre tablolarını hazırlar.
E-posta şablonlarını ve varsayılan abone listelerini oluşturur.
Gerekli MüşavirFlow rol ve yetkilerini senkronize eder.
vergi-takvimi ve pratik-bilgiler gibi frontend sayfalarını oluşturur veya senkronize eder.
Vergi hatırlatmaları, e-posta kuyruğu, RG Otopilot, GİB Takipçisi ve ilgili zamanlanmış görevler için cron hazırlıklarını yapar.

Adım 4 — Aktivasyonu doğrulayın

Eklenti etkinleştiğinde WordPress admin sol menüsünde MüşavirFlow başlığı görünür. Bu menüye tıkladığınızda Ghost Admin paneli açılır.

İlk kontrol için şu ekranları açın:

Dashboard: Genel sistem durumu ve hızlı bağlantılar görünmelidir.
Ayarlar: Genel ayarlar, PDF, e-posta, AI ve Kaynak Operasyonları sekmeleri erişilebilir olmalıdır.
Sirküler: Yeni sirkü formu açılmalıdır.
E-Posta Merkezi: Aboneler, listeler, gönderim, şablonlar, kuyruk ve log sekmeleri görünmelidir.
Pratik Bilgiler: Konu listesi ve hesaplama araçları erişilebilir olmalıdır.
Resmi Gazete / GİB / Mevzuat: Kaynak operasyonları ekranları açılmalıdır.

Alternatif: WordPress admin üzerinden yükleme

Eklentiler → Yeni Ekle → Eklenti Yükle ekranından musavir-flow.zip dosyasını yükleyebilirsiniz. Bu yöntem küçük kurulumlarda çalışabilir; ancak bazı hosting ortamlarında ZIP dosyası yanlış klasör seviyesine açılabilir.

Admin paneliyle yükleme sonrası CSS/JS dosyaları 404 veriyor, Ghost Admin boş açılıyor veya eklenti dosya bulunamadı hatası gösteriyorsa FTP yöntemiyle temiz kurulum yapın.

İlk kurulumdan sonra önerilen kontroller

Kalıcı bağlantıları kaydedin: WordPress → Ayarlar → Kalıcı Bağlantılar ekranında mevcut yapıyı kaydedin.
Firma bilgilerini girin: MüşavirFlow → Ayarlar → Genel alanında firma adı, logo, iletişim ve PDF bilgilerini tamamlayın.
Mail Transport'u doğrulayın: Dry run, bağlantı testi ve gerçek test maili adımlarını çalıştırın.
AI kullanılacaksa sağlayıcıyı yapılandırın: AI Merkezi'nde provider seçin, API anahtarını kaydedin ve bağlantıyı test edin.
Kaynak Operasyonları ayarlarını kontrol edin: RG Otopilot, GİB Takipçisi ve Mevzuat Takibi ayarlarını çalışma ritminize göre düzenleyin.
İlk sirkü taslağını oluşturun: Yeni sirkü formunu, PDF üretimini ve frontend görünümünü test edin.
Frontend sayfalarını kontrol edin: /vergi-takvimi/ ve /pratik-bilgiler/ sayfalarının açıldığını doğrulayın.

Kurulum başarısız olursa

PHP sürümünün 8.1 veya üzeri olduğunu kontrol edin.
wp-content/plugins/musavir-flow/ içinde musavir-flow.php dosyasının bulunduğunu doğrulayın.
Hosting hata loglarında fatal error olup olmadığını kontrol edin.
Dosya izinlerinin plugin ve uploads klasörlerinde okuma/yazma işlemlerine izin verdiğinden emin olun.
Önbellek eklentilerini geçici olarak kapatıp Ghost Admin'i yeniden açın.

Dokümantasyon