E-Ticaret Scripti Kurulum ve Kullanım Kılavuzu

Bu yazılım nedir?#

Komisyonsuz, kendi sunucunuzda çalışan tam donanımlı bir mağaza yazılımı. Katalog, sipariş, ödeme, kargo, fatura, bayilik ve çok şubeli stok tek panelde toplanır; vitrinin görünümü temalarla değişir.

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 (8.1–8.3 önerilir)
• MySQL 5.7+ veya MariaDB 10.3+
• PHP eklentileri: pdo_mysql, mbstring, openssl, gd (veya imagick), curl
• Kök dizin ve storage/ klasörü için yazma izni
• 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 → Genel: mağaza adı, logo, para birimi, iletişim bilgileri
2. Ayarlar → E-posta (SMTP): gönderim hesabı ve test gönderimi
3. Ayarlar → Ödeme Yöntemleri ve Kargo Entegrasyonu
4. Katalog → Kategoriler ve Ürünler
5. Görünüm → Temalar: vitrin görünümü
6. Örnek (demo) içeriği gözden geçirin: kullanacaklarınızı düzenleyin, gerisini silin.

Yönetim paneli haritası#

Yönetim paneli 12 grupta 61 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
   Kataloğu kurun

   Kategorileri ağaç olarak açın, sonra ürünleri girin. Ürün formu iki kolondur: solda içerik, sağda yapışkan yayın kutusu. Varyant, beden tablosu, video ve SEO alanları aynı formdadır.

2. 2
   Ödeme ve kargoyu bağlayın

   Ayarlar → Ödeme Yöntemleri’nden PayTR, Shopier veya iyzico anahtarlarınızı girin; Kargo Entegrasyonu’ndan MNG, Aras, Sürat ya da manuel kargoyu açın. İkisi de tanımlı değilse sipariş alınamaz.

3. 3
   Siparişleri işleyin

   Siparişler ekranı hızlı görünümlerle açılır (bekleyen, hazırlanıyor, kargoda). Satırdan durum değiştirebilir, kargo takip numarası girebilir, iç not düşebilir, kısmi iade yapabilirsiniz. Her işlem Denetim Kaydı’na yazılır.

4. 4
   Faturayı kesin

   Faturalar ekranı faturasız siparişleri ayrı listeler. e-Fatura entegrasyonu tanımlıysa kesim otomatik yapılabilir; değilse PDF fatura üretilir.

5. 5
   Ölçün

   Raporlar ekranı 28 panelde ciro, sipariş, ürün, müşteri ve kanal kırılımını gösterir; pano ise günlük “bekleyen işler” listesini 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.

Temalar#

Mağazanın görünümü temalarla değişir. Tema yalnızca renk, köşe yarıçapı, gölge ve tipografi değerlerini yeniden tanımlar; sepet, ödeme, sipariş ve ayarlar aynı kalır. Kurulumla VELORA gelir, diğerleri mağaza başına süresiz hak olarak satılır ve tek tıkla yayına alınır: dosya indirmek gerekmez.

Temaları karşılaştırın

Şeritten bir tema seçin: kartın içeriği: kimlik, palet, ölçülmüş kontrast değerleri, tipografi, biçim katmanı, başlık ve vitrin yapısı, ana sayfa bölüm sırası: seçtiğiniz temaya göre değişir.

Temayı yayına alma

1. Önizleyin. Görünüm → Temalar ekranında Önizle düğmesi vitrini ?tema=<anahtar> ile açar. Bu görünümü yalnız oturumu açık yöneticiler görür; ziyaretçiler eski temayı görmeye devam eder ve önizleme sayfaları noindex'tir.
2. Uygulayın. Aynı ekranda “Bu temayı uygula” deyin. Vitrin anında değişir; varlık sürümü kendiliğinden yükselir, ek önbellek temizliği gerekmez.
3. Kurgulayın. Yönet düğmesi temanın kendi ekranını açar: odak kategori, ana sayfa bölümlerinin sırası ve görünürlüğü, temaya özel slayt seti ve içerik metinleri.
4. Geri dönün. İstediğinizde başka bir temaya ya da VELORA'ya dönebilirsiniz; hakkınız düşmez, o temanın kurgusu saklı kalır.

Özel CSS ile ince ayar

Görünüm → Özel Kod → Özel CSS alanından belirteçleri yeniden tanımlayarak temayı markanıza çekebilirsiniz. Tek tek kuralları ezmek yerine belirteci değiştirmek doğru yoldur. Kuralı tema kapsamına almak için gövde seçicisini kullanın: böylece başka bir temaya geçtiğinizde kural kendiliğinden devre dışı kalır.

body[data-tema="gold"] {
  --accent: #0f766e;      /* markanızın ana rengi */
  --on-accent: #ffffff;   /* vurgu zemininin ÜSTÜNDEKİ yazı: birlikte değişmeli */
  --card-r: 18px;         /* kart köşe yarıçapı */
  --section-pad: 56px;    /* bölümler arası boşluk */
}

Kapsam v5.83.1 ile geldi. Daha eski bir sürümdeyseniz gövdede data-tema henüz yoktur; kuralları :root { … } içinde kapsamsız yazın ve tema değiştirdiğinizde gözden geçirin. Vurgu rengini değiştirirken --on-accent değerini de gözden geçirin: hedef en az 4,5:1 kontrasttır.

İç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.

Zamanlanmış görevler#

Bazı işler arka planda, belirli aralıklarla çalışır. cPanel → Cron Jobs ekranından aşağıdaki komutları ekleyin. Kurmazsanız yazılım çalışır; yalnız bu otomatik işler gerçekleşmez.

0 3 * * * /usr/local/bin/php /home/KULLANICI/public_html/bin/backup-run.php >/dev/null 2>&1

PHP yolunu ve site dizinini kendi hosting hesabınıza göre değiştirin. cPanel'de doğru PHP yolunu Cron Jobs sayfasının kendisi ya da hosting desteğiniz söyler.

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#