Ticketix, kurulum ZIP paketinden yeni ve boş bir klasöre kurulur. Tarayıcı tabanlı kurulum, yapılandırmayı ve ilk yönetici hesabını oluşturur.
Başlamadan önce
- Sunucu gereksinimlerini kontrol edin.
- Ticketix kurulum ZIP dosyası bilgisayarınızda bulunsun. Dosyayı lisans e-postanızdaki bağlantıdan indirin. Yeni bir kurulum için güncelleme ZIP dosyasını kullanmayın ve kurulum paketini mevcut bir kurulumun üzerine yüklemeyin.
- Boş bir MySQL veritabanı (
utf8mb4) ve bu veritabanı üzerinde tam yetkiye sahip bir veritabanı kullanıcısı oluşturun. - Herkese açık adresi belirleyin, örneğin
https://support.example.comveyahttps://support.example.com/ticketix, ve adresin HTTPS üzerinden çalıştığından emin olun. - Telefonunuza bir kimlik doğrulama uygulaması yükleyin. İlk girişinizde buna ihtiyacınız olacak.
Dosyaları yükleyin
- Kurulum ZIP dosyasını, seçtiğiniz adresin web klasörüne çıkarın.
- Web sunucusu kullanıcısının uygulama klasörüne ve
storageklasörüne yazabildiğinden emin olun. - Nginx kullanıyorsanız gereksinimler bölümünde açıklanan erişim kurallarını ekleyin. Apache'de bunu birlikte gelen
.htaccessdosyası yapar.
Kurulumu çalıştırın
- Kurulum sayfasını herkese açık adreste açın, örneğin
https://support.example.com/setup.php. Sayfayı nihai adreste açın: kurulum bu adresiapp_urlolarak kaydeder. - Alanları doldurun:
| Alan | Ne girilir |
|---|---|
| Uygulama Adı | Arayüzde ve e-postalarda gösterilen ad |
| Varsayılan Dil | English, Türkçe veya العربية |
| Depolama Kökü | Depolama klasörü; barındırma hizmetiniz başka bir yol gerektirmiyorsa önerilen storage klasörünü koruyun |
| Destek E-postası | Müşterilerin gördüğü adres ve varsayılan gönderen |
| Posta Sunucusu Ana Bilgisayarı | Posta sunucunuzun ana bilgisayar adı |
| Sunucu, Bağlantı noktası, Veritabanı adı, Veritabanı kullanıcısı, Veritabanı parolası | Veritabanı (MySQL) altındaki MySQL bilgileriniz |
| Karakter Seti, Karşılaştırma | Değiştirmek için bir nedeniniz yoksa utf8mb4 ve utf8mb4_unicode_ci değerlerini koruyun |
| Yönetici Adı, Yönetici E-postası, Yönetici parolası | İlk yönetici hesabı; parola en az 8 karakter olmalıdır |
- Install Ticketix düğmesine tıklayın. Kurulum veritabanı bağlantısını test eder,
config.phpdosyasını yazar, tabloları ve yönetici hesabını oluşturur. - Installation completed. You can now log in. iletisini gördüğünüzde Admin Login düğmesine tıklayın.
Ticketix kurulduktan sonra setup.php dosyasını açmak sizi yalnızca oturum açma sayfasına götürür. Kurulum ekranı, kurulumdan sonra setup.php dosyasının kaldırılmasını önerir. Ticketix 2.0.2 sürümünden itibaren güncelleme ZIP dosyası setup.php içermez; bu nedenle kaldırılan setup.php bir güncellemeyle geri gelmez.
config.php dosyası ve app_url
Kurulum, kalıcı config.php dosyasını config.sample.php şablonundan oluşturur. Bu dosya veritabanı bilgilerini, Ticketix'in oluşturduğu gizli anahtarları (zamanlanmış görev, sağlık denetimi ve gelen posta için) ve şu ayarları içerir:
| Ayar | Varsayılan | Ne işe yarar |
|---|---|---|
app_url | Kurulumu açtığınız adres | E-postalardaki bağlantılarda kullanılan herkese açık adres; zamanlanmış görevin gönderdiği e-postalardaki bağlantılar da dahil |
storage_root | storage klasörü | Ekler, günlükler, oturumlar, lisans dosyaları ve ai-secret.key |
auto_close_days | 7 | Beklemede veya Yanıtlandı durumundaki taleplerin otomatik olarak kapanacağı gün sayısı |
invite_expiry_hours | 72 | Müşteri davet bağlantısının ne kadar süre geçerli kalacağı |
app_url, varsa alt klasör dahil olmak üzere sonunda eğik çizgi olmadan tam herkese açık adrestir:
'app_url' => 'https://support.example.com/ticketix',
Ticketix'i daha sonra başka bir adrese taşırsanız config.php içindeki app_url değerini değiştirin. Doğru bir app_url olmadan, zamanlanmış görevin gönderdiği e-postalardaki bağlantılar (örneğin gelen postadan oluşturulan bir talebin onayı) açılamaz.
Önemli:
config.phpdosyasını asla herkese açık hâle getirmeyin ve güncellemeler sırasında asla değiştirmeyin. Bu dosyayıstorageklasörüyle birlikte yedekleyin.
İlk kez oturum açın
Yöneticiler ve temsilciler iki faktörlü kimlik doğrulama kullanmak zorundadır. Bunu ilk oturum açışınızda ayarlarsınız:
- Personel oturum açma sayfasını
/admin/adresinde açın (örneğinhttps://support.example.com/admin/). Sayfanın adı Staff sign-in şeklindedir. - Email or display name alanına yönetici e-postasını, Parola alanına parolayı girin ve Sign in düğmesine tıklayın.
- Ticketix Set up two-factor authentication ekranını açar. Kimlik doğrulayıcı uygulamanızı açın, bir hesap ekleyin ve QR kodunu tarayın. Tarayamıyorsanız Cannot scan? Enter the setup key bağlantısını açın ve anahtarı uygulamaya yazın.
- Six-digit code from the app ve Current password alanlarını doldurun, ardından Turn on two-factor authentication düğmesine tıklayın.
- Ticketix Save your backup codes ekranını gösterir: on adet tek kullanımlık kod. Bunları parola yöneticinizde saklayın. Yalnızca bir kez gösterilirler.
Kurulum kodu on dakika geçerlidir. Süresi dolarsa Create a new setup code düğmesine tıklayın ve yeni QR kodunu tarayın.
Bundan sonra her oturum açışta, paroladan sonra kimlik doğrulayıcı uygulamanızdan bir kod istenir. Bkz. İki faktörlü kimlik doğrulama ve parola sıfırlama.
Kurulumdan sonra
- Uygulama klasörüne yazma erişimini PHP'nin çalıştığı kullanıcıyla sınırlayın. Güncellemeler ekranından yapılan güncellemeler, PHP'nin uygulama dosyalarına yazabilmesini gerektirir; PHP bunlara yazamıyorsa güncellemeyi güncelleme ZIP dosyasıyla elle yapın.
storageklasörü yazılabilir kalmalıdır. Bkz. Ticketix'i güncelleme. config.phpdosyasını vestorageklasörünü düzenli olarak erişimi kısıtlı bir yere yedekleyin.storage/ai-secret.key, kayıtlı AI sağlayıcı anahtarlarını ve iki faktörlü kimlik doğrulamanın kimlik doğrulayıcı gizli anahtarlarını korur.