FacturaScripts Projesi Oluşturma ve Çalıştırma

FacturaScripts, orta ve küçük ölçekli işletmeler ve serbest çalışanlar için son derece uygun, güçlü ve esnek bir açık kaynak ERP ve CRM çözümüdür. ServBay tarafından sağlanan elverişli yerel geliştirme ortamıyla, FacturaScripts projelerini macOS sisteminizde kolayca oluşturabilir, test edebilir ve çalıştırabilirsiniz.

Bu kılavuz, ServBay kullanarak FacturaScripts'i kurma ve yapılandırma sürecinin tamamını size gösterecektir.

FacturaScripts Nedir?

FacturaScripts, PHP ve Bootstrap çerçevesine dayanan açık kaynak bir kurumsal kaynak planlama (ERP) ve müşteri ilişkileri yönetimi (CRM) yazılımıdır. İşletmelerin temel iş süreçlerini yönetmelerine yardımcı olmak amacıyla tasarlanmıştır ve şu alanları içermektedir:

• Fatura düzenleme ve yönetimi
• Muhasebe
• Stok kontrolü
• Müşteri ve tedarikçi yönetimi
• Proje yönetimi
• Daha fazlası...

Açık kaynak bir proje olarak, aktif bir topluluk desteğine sahip olup, kullanıcıların eklentiler aracılığıyla işlevselliği genişletmesine ve özelleştirmesine olanak tanır.

FacturaScripts'in Ana Özellikleri ve Avantajları

• Açık Kaynak Ücretsiz: Yüksek lisans ücretleri ödemeden, özgürce kullanabilir ve değiştirebilirsiniz.
• Kapsamlı Fonksiyonlar: Küçük ve orta ölçekli işletmelerin günlük operasyonları için gerekli olan çoğu temel özelliği kapsar.
• Kullanımı Kolay: Arayüzü görece sezgisel olup, öğrenme eğrisi düşüktür.
• Yüksek Derecede Ölçeklenebilir: Zengin bir eklenti pazarı ile yeni işlevler eklemek veya diğer hizmetlerle entegre olmak kolaydır.
• Çoklu Platform Desteği: Web tabanlıdır ve modern tarayıcıyı destekleyen herhangi bir cihazdan erişilebilir.
• Aktif Topluluk: Sorunlarınız olduğunda topluluktan yardım alabilirsiniz.
• Çok Dilli Destek: Farklı bölgelerdeki kullanıcılar için çeşitli dillerde destek sunar.

ServBay Kullanarak FacturaScripts Projesi Oluşturma ve Çalıştırma

ServBay, PHP uygulamalarını (FacturaScripts gibi) çalıştırmak için ideal bir yerel ortam sağlar. Nginx/Apache, çeşitli PHP sürümleri, MySQL/MariaDB/PostgreSQL gibi yaygın servisleri entegre eder ve yönetim için grafik arayüz sunar.

ServBay üzerinde FacturaScripts’i çalıştırmanın ana adımları şunlardır:

1. FacturaScripts kaynak kodunu indirin.
2. ServBay tarafından yönetilen dizinde bir proje klasörü oluşturun.
3. FacturaScripts için gerekli MySQL veritabanını ve kullanıcıyı oluşturun.
4. ServBay aracılığıyla Apache Web sunucusunu proje dizinine yönlendirin.
5. Tarayıcı üzerinden erişim sağlayarak FacturaScripts kurulum sihirbazını tamamlayın.

FacturaScripts Projesi Oluşturma (Zip Yazılım Paketi İle)

Bu, en yaygın yerel kurulum yöntemlerinden biridir.

1. FacturaScripts'i İndirin:

   • FacturaScripts resmi web sitesine gidin (https://facturascripts.com/).
   • İndirme alanına gidin, en son kararlı .zip yazılım paketini bulun ve indirin.

2. Proje Dizini Oluşturun:

   • Finder'ı açın, ServBay'in web dosyalarını saklamak için kullandığı dizine girin. Varsayılan olarak, bunu /Applications/ServBay/www/ dizininde öneriyoruz.
   • Bu dizinde FacturaScripts projesini saklamak için facturascripts_project adında yeni bir klasör oluşturun.
   • Tam yol örneği: /Applications/ServBay/www/facturascripts_project

3. Dosyayı Çıkarın:

   • İndirdiğiniz FacturaScripts .zip dosyasını yeni oluşturduğunuz facturascripts_project klasörüne çıkarın.
   • Çıkarıldıktan sonra, facturascripts_project klasörü içinde index.php, config.php (kurulum sonrası oluşturulabilir), Core, Dinamic, Plugins gibi dosya ve dizinler bulunmalıdır.

Başlangıç Yapılandırması (MySQL Veritabanı Yapılandırması vb.)

FacturaScripts, tüm verileri saklamak için bir veritabanına ihtiyaç duyar. Biz ServBay tarafından yönetilen MySQL hizmetini kullanacağız.

1. MySQL Hizmetinin Çalıştığından Emin Olun:

   • ServBay uygulamasını açın.
   • Sol menüden "Hizmetler" - "MySQL" seçimini yapın.
   • MySQL (veya MariaDB) hizmetinin başlatıldığından emin olun. Eğer başlatılmamışsa, yanındaki anahtar düğmesine tıklayarak başlatın.

2. Veritabanı Oluşturun:

   • Veritabanını ServBay’in yerleşik veritabanı yönetim araçları (phpMyAdmin gibi) kullanarak ya da komut satırı aracılığıyla oluşturabilirsiniz.
   • phpMyAdmin Kullanarak (Önerilen):
     • ServBay arayüzünde “Veritabanları” - “MySQL” kısmında, sağ üst köşedeki phpMyAdmin'e tıklayın.
     • phpMyAdmin'e giriş yapın (genellikle root kullanıcısı ve ServBay'de ayarladığınız şifreyi kullanarak).
     • "Veritabanları" sekmesine tıklayın.
     • "Veritabanı Oluştur" alanında, veritabanı adını (örneğin facturascripts_db) girin.
     • Uygun karakter setini seçin, utf8mb4_general_ci veya utf8mb4_unicode_ci önerilmektedir.
     • "Oluştur" tuşuna basın.
   • Veritabanı Kullanıcısı Oluşturun (isteğe bağlı fakat önerilen): Güvenlik nedenleriyle, FacturaScripts için özel bir veritabanı kullanıcısı oluşturulması önerilmektedir; root kullanıcısı yerine.
     • phpMyAdmin'de ana sayfaya geri dönün, "Kullanıcı Hesapları" sekmesine tıklayın.
     • "Kullanıcı Hesabı Ekle" seçeneğine tıklayın.
     • Kullanıcı adınızı (örneğin facturascripts_user) girin.
     • Ana bilgisayar adını localhost seçin.
     • Güçlü bir şifre oluşturun veya girin ve bu şifreyi mutlaka not edin.
     • “Kullanıcı adıyla aynı olan veritabanı oluştur ve tüm yetkileri ver” seçeneğini işaretleyin veya "Veritabanları" kısmına manuel olarak giderek yeni kullanıcıya facturascripts_db veritabanında tüm yetkileri verin (ALL PRIVILEGES).
     • Sayfanın altındaki "Yürüt" butonuna tıklayın.

3. Veritabanı Bilgilerini Kaydedin: Oluşturduğunuz bilgileri not edin:

   • Veritabanı Adı (facturascripts_db)
   • Veritabanı Kullanıcı Adı (facturascripts_user)
   • Veritabanı Kullanıcı Şifresi (belirlediğiniz şifre)
   • Veritabanı Ana Bilgisayarı (genellikle localhost veya 127.0.0.1)
   • Veritabanı Portu (MySQL'in varsayılanı 3306'dır, ServBay hizmet listesinden doğrulayabilirsiniz)

Bu bilgiler, FacturaScripts kurulum sürecinde kullanılacaktır.

Web Sunucusunu Yapılandırma (Apache Tabanlı)

Şimdi ServBay'e, Apache ile FacturaScripts projemizi nasıl sunacağını söylememiz gerekiyor.

1. Apache Hizmetinin Çalıştığından Emin Olun:

   • ServBay'in "Hizmetler" arayüzünde, Apache hizmetinin başlatıldığından emin olun.

2. Ana Bilgisayar Ekleme:

   • ServBay sol menüsünde "Web Siteleri" seçeneğini seçin.
   • Sağ taraftaki "+" butonuna tıklayın.
   • Açılan yapılandırma penceresinde aşağıdaki bilgileri doldurun:
     • Ad (Name): Bu ana bilgisayar yapılandırmasına açıklayıcı bir ad verin, örneğin FacturaScripts Demo.
     • Alan Adı (Domain): Yerel FacturaScripts sitesine erişmek için kullanmak istediğiniz alan adını girin. Önerdiğimiz değer: facturascripts.demo.
     • Web Sitesi Türü (Website Type): PHP seçin, bu dinamik bir PHP web sitesi olduğunu belirtir.
     • Kök Dizin (Root Directory): "Gözat" veya "Seç" butonuna tıklayarak, daha önce oluşturup FacturaScripts dosyalarını çıkardığınız dizine gidin (/Applications/ServBay/www/facturascripts_project).
     • Web Sunucusu (Web Server): Apache seçin ve kullanmak istediğiniz Apache sürümünü belirtin.
     • PHP Sürümü (PHP Version): İndirdiğiniz FacturaScripts sürümü ile uyumlu bir PHP sürümü seçin (FacturaScripts'in sistem gereksinimlerini kontrol edin, genellikle yeni ve stabil sürümler önerilmektedir, örneğin PHP 8.1 veya 8.2).
     • Diğer Ayarlar: Genellikle varsayılan ayarları koruyabilirsiniz, özel bir ihtiyacınız yoksa.

3. Yapılandırmayı Kaydedin:

   • "Ekle" butonuna tıklayın.
   • ServBay, Apache sanal ana bilgisayarını otomatik olarak yapılandıracak ve facturascripts.demo adresini yerel IP'ye (127.0.0.1) yönlendirmek için sistemin hosts dosyasını değiştirmek üzere yönetici izni isteyebilir. Bu işlemi onaylayın.

4. PHP Eklentilerini Kontrol Edin:

   • FacturaScripts'in düzgün çalışması için belirli PHP eklentilerine ihtiyacı olabilir (örneğin pdo_mysql, gd, intl, zip vb.).
   • ServBay içinde yüklü PHP eklentilerini yönetebilirsiniz. Genellikle ServBay'in varsayılan olarak yüklediği eklentiler yeterlidir, ancak kurulum sırasında eksik eklenti hatası alırsanız, ServBay'in PHP yapılandırma bölümünde bunları etkinleştirebilirsiniz.

Web Sitesine Erişim

Artık her şey hazır, FacturaScripts'in çevrimiçi kurulum sürecine başlayabiliriz.

1. Tarayıcıyı Açın: Sık kullandığınız web tarayıcısını (Chrome, Firefox, Safari gibi) açın.

2. Adresi Girin: Adres çubuğuna https://facturascripts.demo yazın ve Enter'a basın.

3. FacturaScripts Kurulum Sihirbazı:

   • Her şey doğru yapılandırıldıysa, FacturaScripts'in kurulum arayüzünü görmelisiniz.
   • Dil Seçimi: Kullanmak istediğiniz dili seçin.
   • Sistem Kontrolü: Kurulum programı, sunucu ortamınızı (PHP sürümü, gerekli eklentiler, dizin izinleri vb.) kontrol eder. Eğer ServBay doğru yapılandırılmışsa, burada yeşil tikler görünmelidir. Sorun çıkarsa, tavsiyelere göre ServBay'deki PHP yapılandırmasını veya dosya izinlerini kontrol edin.
   • Veritabanı Yapılandırması: Bu kritik bir adımdır. Önceden oluşturup not ettiğiniz veritabanı bilgilerini girmeniz gerekir:
     • Veritabanı Türü: MySQL seçin.
     • Ana Bilgisayar: localhost veya 127.0.0.1.
     • Port: 3306 (veya ServBay'de gördüğünüz MySQL portu).
     • Veritabanı Adı: facturascripts_db.
     • Kullanıcı Adı: facturascripts_user.
     • Şifre: facturascripts_user için belirlediğiniz şifre.
     • Tablo Ön Eki: Varsayılan değer olan fs_ kullanılabilir.
   • Yönetici Hesabı: FacturaScripts'in yönetici kullanıcı adı, şifre ve e-posta adresini ayarlayın. Bu bilgileri mutlaka not edin, çünkü bunlar yönetici paneline giriş bilgilerinizdir.
   • Kurulum: Kurulum butonuna tıkladığınızda, FacturaScripts veritabanı tablolarını oluşturacak ve yapılandırma dosyasını yazacaktır.

4. Kurulum Tamamlandı:

   • Kurulum başarıyla tamamlandığında, genellikle install dizininin silinmesi gerektiğine dair bir uyarı alacaksınız (varsa, güvenlik için).
   • Artık http://facturascripts.demo adresinden FacturaScripts giriş sayfanıza erişim sağlayabilirsiniz. Şimdi yeni ayarladığınız yönetici hesabınızla giriş yaparak FacturaScripts'i keşfetmeye ve kullanmaya başlayabilirsiniz!

---

Tebrikler! ServBay kullanarak yerel macOS ortamınızda başarıyla bir FacturaScripts projesi oluşturup çalıştırdınız. ServBay, yerel sunucu ortamının yapılandırılmasını ve yönetilmesini kolaylaştırarak, FacturaScripts'in geliştirilmesine ve kullanılmasına daha fazla odaklanmanıza olanak tanır.