QR Menü ve Online Sipariş Scripti Kurulum ve Kullanım Kılavuzu

Bu yazılım nedir?#

Restoran, kafe ve otel işletmeleri için temassız QR menü, masadan sipariş ve paket servis sistemi. Masaya yapıştırılan karekod menüyü açar, misafir masadan ya da adresinden sipariş verir, sipariş mutfak ekranına düşer.

Sunucu gereksinimleri#

Aşağıdakiler yazılımın çalışması için gereken asgari koşullardır. Neredeyse tüm paylaşımlı hosting paketleri bunları zaten karşılar.

• PHP 8.0 veya üzeri (cPanel → "Select PHP Version" menüsünden seçin)
• MySQL / MariaDB veritabanı
• Şu PHP eklentileri açık olmalı: pdo_mysql, mbstring, openssl, gd, curl
• Apache mod_rewrite (cPanel'de standarttır)
• Kök dizin ve storage/ klasörü için yazma izni
• Geçerli bir missweb.com lisans anahtarı (müşteri panelinizden alınır)

PHP sürümünü cPanel'de “Select PHP Version” menüsünden değiştirebilirsiniz. Eklentilerden biri kapalıysa aynı ekrandan açabilir ya da hosting firmanızdan açmasını isteyebilirsiniz.

Adım adım kurulum#

Kurulum tarayıcıdan çalışan bir sihirbazla yapılır: veritabanı bilgilerini, yönetici hesabınızı ve lisans anahtarınızı girersiniz; şema, örnek içerik ve lisans etkinleştirmesi otomatik tamamlanır.

1. Dosyaları yükleyin. ZIP içindeki dosyaları public_html/ klasörüne çıkarın. Pakette gelen .htaccess gerekli yönlendirmeyi yapar.
   Daha güvenli yöntem: dosyaları public_html dışına yükleyip cPanel → Domains'ten alan adının kök dizinini .../public klasörüne ayarlamak.
2. Veritabanı oluşturun. cPanel → MySQL® Databases: bir veritabanı, bir kullanıcı açın ve kullanıcıyı veritabanına tüm yetkilerle ekleyin. Üç bilgiyi not alın.
3. Sihirbazı çalıştırın. Tarayıcıdan https://alanadınız.com/install.php adresine gidin; veritabanı bilgilerini, yönetici hesabınızı ve lisans anahtarınızı girin. Kurulumu Tamamla deyin.
4. install.php dosyasını silin. Sihirbaz ikinci kez çalışmaz ama dosyayı sunucudan kaldırmak en güvenlisidir. .env dosyasının iznini 600 yapın: içinde veritabanı şifreniz vardır.
5. Panele girin. https://alanadınız.com/admin/login adresinden kurulumda belirlediğiniz hesapla oturum açın.

Sunucuya SSH erişiminiz varsa şema ve örnek içeriği komut satırından da kurabilirsiniz: php bin/console fresh. Sihirbaz bunu zaten yaptığı için normal kurulumda gerekmez.

Lisans ve alan adı#

Lisans anahtarınızı müşteri panelinizden alırsınız. Biçimi SH-XXXX-XXXX-XXXX-XXXX şeklindedir.

• Lisans alan adına bağlanır. Anahtar, ilk kurulumda hangi alan adında çalıştırılırsa o alan adına otomatik bağlanır.
• Alan adı değiştirebilirsiniz. Müşteri panelinizden ya da destek üzerinden alan adı değişikliği yapılabilir.
• Panelden durum görürsünüz. Yönetim → Lisans ekranı lisansın durumunu, bağlı alan adını ve destek bitiş tarihini gösterir; “yenile” ile sunucuya yeniden sorar.
• Süresiz kullanım. Yazılımı kullanma hakkı süresizdir; yıllık yenilenen şey güncelleme ve destek hakkıdır.

İlk yarım saat#

Kurulumdan hemen sonra şu sırayı izlerseniz site yayına hazır hâle gelir. Sıra önemlidir: içerik girmeden önce kimlik ve iletişim bilgilerini tanımlayın.

1. Ayarlar → İşletme adı, logo, iletişim
2. Kategoriler ve Ürünler
3. Bölgeler ve Masalar & QR
4. Ayarlar → Paket Servis (kullanacaksanız)
5. Slider ve Galeri
6. Örnek (demo) içeriği gözden geçirin: kullanacaklarınızı düzenleyin, gerisini silin.

Yönetim paneli haritası#

Yönetim paneli 4 grupta 29 ekrandan oluşur. Aşağıdaki liste panelin sol menüsünün birebir karşılığıdır: kurulumdan sonra göreceğiniz şey budur.

Menü yetkiye duyarlıdır: bir role kapalı olan ekran o kullanıcının menüsünde hiç görünmez. Yukarıdaki liste tam yetkili yöneticinin gördüğüdür.

Günlük kullanım#

Yazılımın günlük akışı aşağıdaki gibidir. Adımlar sırayla ilerler; ilk kurulumda da bu sırayı izlemek en hızlısıdır.

1. 1
   Menüyü kurun

   Kategoriler ve Ürünler: kategori sırası menüdeki sırayı belirler. Ürün fotoğrafı ve fiyatı menüde doğrudan görünür.

2. 2
   Bölge ve masaları tanımlayın

   Bölgeler ekranıyla salon, teras, bahçe gibi alanları açar, Masalar & QR ekranından masaları bölgelere bağlarsınız. Her masa için benzersiz bir adres (/masa/{kod}) ve karekod üretilir; karekodu masaya yapıştırın.

3. 3
   Paket servisi açın

   Ayarlar → Paket Servis: teslimat ücreti, minimum sepet tutarı ve ücretsiz teslimat sınırı. Açıldığında ziyaretçi karekod olmadan /paket-siparis sayfasından sipariş verebilir; adres ve telefon zorunlu olur.

4. 4
   Mutfağı ekrana bağlayın

   Mutfak Ekranı siparişleri “yeni / hazırlanıyor / hazır” sütunlarında canlı gösterir; kendini periyodik yeniler ve bekleme eşiğini aşan siparişi kırmızıya çevirir. Tablet ya da tam ekran bir monitörde açılmak üzere tasarlanmıştır.

5. 5
   Ölçün

   Satış Raporları ciro, sipariş sayısı, ortalama sepet, en çok satan ürünler, kategori ve masa/bölge kırılımı ile saat bazında yoğunluğu verir.

Ziyaretçinin gördüğü sayfalar#

Ziyaretçinin göreceği sayfalar ve adresleri. Bu adresler sabittir; menüyü değiştirmek adresleri değiştirmez.

Bu sayfaların tamamını canlı demoda gezebilirsiniz; demo, satın aldığınızda kurulacak yazılımın kendisidir.

İçerik ve SEO#

Kurumsal içerik ekranları bütün missweb.com yazılımlarında aynıdır: Sayfalar, Blog, Menüler, SSS, Referanslar, Ekip, Galeri ve Medya.

• Sayfalar: Hakkımızda, politikalar gibi statik içerikler. Her sayfanın kendi başlık/açıklama (SEO) alanı vardır.
• Menüler: üst menünün sırası buradan yönetilir. Yeni bir sayfa eklemek menüyü kendiliğinden değiştirmez; menüye siz eklersiniz.
• Medya: yüklediğiniz tüm görsellerin ortak kütüphanesi; her yükleme alanından buraya erişebilirsiniz.
• Hızlı İndeksleme: yeni ve güncellenen adresleri arama motorlarına IndexNow protokolüyle bildirir. Kurulum sınamasını bir kez çalıştırıp anahtarınızı doğrulayın.
• Site haritası: /sitemap.xml otomatik üretilir; Google Search Console'a bu adresi tanıtın.

E-posta bildirimleri#

Bildirim e-postaları (form bildirimi, durum değişikliği) sunucunun kendi posta işleviyle gönderilir; ayrı bir SMTP ekranı yoktur. Metinleri Yönetim → E-posta Şablonları ekranından düzenlersiniz.

• Gönderen adresi Ayarlar ekranındaki firma e-postasıdır; alan adınıza ait bir adres kullanın (gmail gibi bir adres gönderen olarak kullanılırsa postalar engellenir).
• Alan adınızın SPF kaydı yoksa postalar spam'e düşebilir: hosting firmanızdan kayıtları eklemesini isteyin.
• Kurulumdan sonra bir deneme formu doldurup postanın ulaştığını doğrulayın.

Kullanıcılar ve roller#

Panele birden çok kişi erişecekse her birine kendi hesabını açın; hesap paylaşmayın. Kim ne yaptı sorusunun cevabı buna bağlıdır.

• Kullanıcılar: hesap açma, şifre sıfırlama, hesabı devre dışı bırakma.
• Roller: her rol hangi ekranlara erişeceğini belirler; yetkisi olmayan ekran menüde hiç görünmez.
• Aktivite Kayıtları: hangi kullanıcının neyi ne zaman değiştirdiğini gösterir. Bir kaydın kaybolduğunu düşündüğünüzde ilk bakılacak yer burasıdır.

Görünüm ve özel kod#

Yönetim → Görünüm ekranı Özel CSS, Özel JavaScript ve Head/Footer kodu alanlarını içerir. Etiketleri (<style>, <script>) yazmanıza gerek yoktur; alanlar bunları kendisi ekler.

• Head kodu: Google Analytics, Search Console doğrulaması, piksel kodları.
• Özel CSS: renk, boşluk ve köşe ayarları. Tema dosyasını elle düzenlemeyin; güncellemede değişir ve değişiklikleriniz kaybolur. Özel CSS bir ayardır, güncellemelerden etkilenmez.
• Dikkat: display:none ile bölüm gizlemek içeriği sayfada bırakır (arama motorları ve ekran okuyucular okumaya devam eder). Bir bölümü kapatmak istiyorsanız ilgili ekrandan pasife alın.

Yedekleme#

Yönetim → Yedekleme ekranı veritabanınızın tam bir kopyasını .sql dosyası olarak indirir. Ekran ayrıca tablo ve kayıt sayılarını gösterir.

• İki parça vardır: veritabanı ve public/uploads/ klasörü (görseller). Yalnız veritabanını yedeklemek yetmez.
• Büyük değişiklikten önce yedek alın: toplu silme, içe aktarma ve güncelleme öncesi.
• Yedeği sunucu dışında saklayın. Sunucu kaybedilirse üzerindeki yedek de kaybolur.

Güncelleme#

Yönetim → Güncellemeler ekranı yeni sürüm olup olmadığını lisans sunucusuna sorar. Varsa tek tıkla indirilir, dosyalar değiştirilir ve veritabanı göçleri çalışır.

1. Önce yedek alın. Güncelleme dosyaları değiştirir; geri dönüş yolunuz yedektir.
2. Güncelle deyin. Paket indirilir, sağlaması (SHA-256) doğrulanır, site kısa süre bakıma alınır ve dosyalar değiştirilir.
3. Kontrol edin. Vitrini ve paneli açıp birkaç ekranı gezin.

• Ayarlarınız korunur: özel CSS, e-posta şablonları, içerik ve ayarlar veritabanındadır.
• Dosyada yaptığınız elle değişiklikler kaybolur. Özelleştirmeyi panel alanlarından yapın.
• Güncelleme hakkınızın süresi Lisans ekranında yazar; süre dolduğunda yazılım çalışmaya devam eder, yalnız yeni sürümleri alamazsınız.

Sorun giderme#

Sık sorulan sorular#

Destek#