VMDestek — Kurulum Rehberi

Sistem Gereksinimleri

PHP

7.4 veya üzeri

MySQL / MariaDB

5.7+ / 10.3+

Web Sunucusu

Apache veya Nginx

Gerekli PHP Eklentileri

PDO + pdo_mysql — Veritabanı bağlantısı
cURL — Güncelleme kontrolü ve dış API iletişimi
json — API yanıtları
mbstring — Türkçe karakter desteği
fileinfo — Dosya yükleme doğrulaması

Kurulum Adımları

1

Dosyaları Yükleyin

ZIP dosyasını indirin ve tüm dosyaları web sunucunuza (public_html veya htdocs klasörü) yükleyin. Alt klasöre de kurabilirsiniz, örneğin: public_html/destek/

2

Kurulum Sihirbazını Açın

Tarayıcınızda aşağıdaki adresi ziyaret edin:

https://siteadresiniz.com/install.php

3

Veritabanı Bilgilerini Girin

MySQL veritabanı bilgilerinizi girin. Sihirbaz tabloları otomatik oluşturacaktır.

Alan	Açıklama	Örnek
Sunucu	MySQL sunucu adresi	`localhost`
Veritabanı	Veritabanı adı	`livesupport`
Kullanıcı	MySQL kullanıcı adı	`root`
Şifre	MySQL şifresi	`•••••`

4

Admin Hesabı Oluşturun

İlk admin hesabınızı oluşturun. Bu hesapla admin panele giriş yapacaksınız.

5

Kurulumu Tamamlayın

Kurulum tamamlandığında install.php güvenlik için otomatik olarak kilitlenir. Admin panele yönlendirilirsiniz.

https://siteadresiniz.com/admin/login.php

Kurulum sihirbazı veritabanı tablolarını, varsayılan ayarları ve config dosyasını otomatik oluşturur. Manuel müdahale gerekmez.

Web Sitesine Ekleme

Tek Satır Entegrasyon

Web sitenizin </body> etiketinden hemen önce aşağıdaki kodu ekleyin:

                    HTML
                    <script src="https://siteadresiniz.com/embed.js"></script>
                

Bu kod otomatik olarak:

Sağ alt köşeye sohbet butonu ekler
3 saniye sonra karşılama baloncuğu gösterir
Butona tıklandığında chat widget'ı açılır
Online/offline durumuna göre farklı form gösterir

Embed kodunu admin paneldeki Ayarlar → Entegrasyon sekmesinden de kopyalayabilirsiniz.

Admin Panel Kullanımı

Giriş

https://siteadresiniz.com/admin/

Kurulumda oluşturduğunuz kullanıcı adı ve şifre ile giriş yapın.

Bölüm	Açıklama
Dashboard	Aktif sohbetler, bekleyen ve kapanan konuşmalar, anlık ziyaretçiler
Ayarlar → Görünüm	Widget renkleri, gradient, şirket adı, logo
Ayarlar → Mesajlar	Karşılama mesajı, çevrimdışı mesajı, dil seçimi
Ayarlar → Hazır Yanıtlar	Sık kullanılan cevap şablonları (`/` kısayolları)
Ayarlar → Entegrasyon	Embed kodu (JS ve iframe)
Ayarlar → Kullanıcılar	Admin/operatör ekleme ve yönetimi
Ayarlar → Güncelleme	GitHub'dan otomatik güncelleme kontrolü

Güncelleme

Otomatik Güncelleme

VMDestek, GitHub üzerinden otomatik güncelleme desteği sunar:

Admin panelinde Ayarlar → Güncelleme sekmesine gidin
Güncelleme Kontrol Et butonuna tıklayın
Yeni sürüm varsa Güncelle butonuyla uygulayın

Güncelleme sırasında config.php, install.lock ve uploads/ klasörü korunur. Ayarlarınız ve yüklenen dosyalar etkilenmez.

Proje Yapısı

                Dosya Yapısı
                VMDestek/
                ├── admin/ ← Admin panel
                │ ├── index.php ← Dashboard
                │ ├── settings.php ← Ayarlar
                │ ├── login.php ← Giriş sayfası
                │ ├── js/app.js ← Admin JS
                │ └── css/style.css ← Admin CSS
                ├── api/ ← API endpoint'leri
                │ ├── admin.php ← Admin API
                │ ├── chat.php ← Widget chat API
                │ ├── visitor.php ← Ziyaretçi takibi
                │ └── update.php ← Güncelleme API
                ├── uploads/chat/ ← Sohbet görselleri
                ├── lang/ ← Dil dosyaları (TR/EN/AR)
                ├── embed.js ← Widget kodu (sitelere eklenir)
                ├── config.php ← Veritabanı ayarları
                ├── db.php ← PDO bağlantı sınıfı
                ├── install.php ← Kurulum sihirbazı
                ├── database.sql ← Veritabanı şeması
                └── version.json ← Sürüm bilgisi
            

Sorun Giderme

Sık Karşılaşılan Sorunlar

Sorun	Çözüm
Kurulum sayfası açılmıyor	PHP'nin çalıştığından ve dosyaların doğru dizine yüklendiğinden emin olun
Veritabanı bağlantı hatası	MySQL bilgilerini kontrol edin. Veritabanının oluşturulmuş olduğundan emin olun
Widget görünmüyor	`embed.js` URL'sinin doğru olduğunu ve CORS ayarlarının açık olduğunu kontrol edin
Resim yüklenemiyor	`uploads/chat/` klasörüne yazma izni verin: `chmod 755`
Türkçe karakterler bozuk	Veritabanı charset'inin `utf8mb4` olduğundan emin olun
Güncelleme çalışmıyor	Sunucunun GitHub'a erişebildiğini ve cURL eklentisinin aktif olduğunu kontrol edin

Güvenlik: Kurulum tamamlandıktan sonra install.php dosyasının kilitlendiğinden emin olun. Dosya otomatik kilitlenir ancak manuel kontrol önerilir.

Destek & İletişim

Kaynak Kod & Sorun Bildirimi

GitHub üzerinden kaynak koda erişebilir, sorun bildirebilir ve katkıda bulunabilirsiniz:
github.com/Sem-h/VMDestek

Geliştirici

Semih AKBAŞ — semihakbas.com.tr