Een FacturaScripts-project creëren en draaien op ServBay

FacturaScripts is een krachtige en flexibele open-source ERP (Enterprise Resource Planning) en CRM (Customer Relationship Management) oplossing, ideaal voor kleine en middelgrote bedrijven en freelancers. Dankzij de gebruiksvriendelijke lokale webontwikkelomgeving van ServBay kun je moeiteloos FacturaScripts-projecten aanmaken, testen en uitvoeren op macOS, zonder ingewikkelde configuraties.

Deze handleiding leidt je stap voor stap door het volledige proces van het lokaal installeren en configureren van FacturaScripts met ServBay.

Overzicht van FacturaScripts

FacturaScripts is open-source ERP- en CRM-software ontwikkeld op basis van PHP en het Bootstrap-framework. Het helpt bedrijven bij het beheren van hun kernprocessen, waaronder:

• Facturering en beheer van facturen
• Boekhouding
• Voorraadbeheer
• Klanten- en leveranciersbeheer
• Projectbeheer
• En meer functionaliteiten via modules en plug-ins...

Als een actief open-source project beschikt FacturaScripts over een sterke community en kun je de functionaliteit uitbreiden en aanpassen via plug-ins, zodat het aan diverse zakelijke behoeften voldoet.

Belangrijkste kenmerken en voordelen van FacturaScripts

• Open-source en gratis: Geen dure licentiekosten; vrij te gebruiken, aan te passen en te distribueren.
• Volledig functioneel: Dekt de meeste kernfunctionaliteiten voor dagelijks gebruik in het MKB en biedt een alles-in-één oplossing.
• Gebruiksvriendelijk: Intuïtieve en overzichtelijke interface met een geringe leercurve.
• Zeer uitbreidbaar: Uitgebreide plug-inmarkt en open API, zodat je eenvoudig nieuwe functies toevoegt of integreert met andere diensten.
• Platformonafhankelijke toegang: Webgebaseerd, je gebruikt het op elk apparaat met een moderne browser.
• Actieve community: Je krijgt wereldwijd ondersteuning van ontwikkelaars bij vragen of problemen.
• Meertalige ondersteuning: Ondersteunt diverse talen zodat gebruikers uit verschillende regio’s eenvoudig kunnen werken.

Voordelen van het draaien van FacturaScripts op ServBay

ServBay is speciaal ontworpen voor ontwikkelaars als lokale webontwikkelomgeving en vormt het ideale platform voor PHP-toepassingen zoals FacturaScripts. Het integreert alle benodigde componenten, waaronder Apache/Nginx-webserver, meerdere PHP-versies, MySQL/MariaDB/PostgreSQL-databases en tools zoals Redis — allemaal eenvoudig te beheren via een intuïtieve GUI.

De voordelen en stappen van het lokaal draaien van FacturaScripts op ServBay zijn onder andere:

• Geïntegreerde omgeving: ServBay is vooraf voorzien van alle essentiële componenten voor FacturaScripts (webserver, PHP, databases), waardoor je geen losse installaties hoeft te doen.
• Versiebeheer: Wissel eenvoudig tussen verschillende PHP-versies voor compatibiliteit met FacturaScripts of voor testen.
• Databasemanagement: Ingebouwde tools zoals phpMyAdmin of Adminer maken het aanmaken en beheren van databases en gebruikers eenvoudig.
• Vereenvoudigde siteconfiguratie: Maak snel lokale sites aan, koppel domeinen, stel de root map, webserver en PHP-versie in via de GUI.
• Automatisch hostsbeheer: ServBay beheert automatisch het lokale hosts-bestand, zodat je eenvoudig via een zelfgekozen domeinnaam (bijvoorbeeld facturascripts.servbay.demo) je lokale site bereikt.
• SSL-ondersteuning: Configureer SSL/HTTPS voor je lokale sites via een ingebouwde User CA of publieke ACME-services, zodat je test met een productieachtige beveiliging.

De belangrijkste stappen voor het draaien van FacturaScripts op ServBay zijn als volgt:

1. Download de broncode van FacturaScripts.
2. Maak een projectmap aan in de root van je ServBay-websites.
3. Maak de benodigde MySQL-database en gebruiker aan.
4. Configureer de webserver (Apache/Nginx) in ServBay voor de projectmap.
5. Controleer en activeer benodigde PHP-extensies.
6. Doorloop de online installatie van FacturaScripts via de browser met het lokale domein.

Vereisten

Zorg ervoor dat je aan de volgende voorwaarden voldoet voordat je begint:

• ServBay is succesvol geïnstalleerd en draaiende op macOS. Download de nieuwste versie via de officiële ServBay-site.
• De belangrijkste softwarepakketten (zoals Apache/Nginx, de benodigde PHP-versie en MySQL of MariaDB) zijn gestart en werken binnen ServBay.
• Je hebt basiskennis over webontwikkeling en databases.

Het FacturaScripts-project aanmaken (op basis van een Zip-download)

Dit is een van de snelste en meest gebruikte methoden voor een lokale installatie van FacturaScripts.

1. FacturaScripts downloaden:

   • Ga naar de downloadpagina van FacturaScripts https://facturascripts.com/descargar.
   • Download het nieuwste stabiele .zip-pakket op je Mac.

2. Projectmap aanmaken:

   • Open Finder en navigeer naar de hoofdmap die ServBay gebruikt voor lokale websites. Standaard (en aangeraden) is dit /Applications/ServBay/www/.
   • Maak hierin een nieuwe map aan voor je FacturaScripts-project, bijvoorbeeld facturascripts_project.
   • Voorbeeld pad: /Applications/ServBay/www/facturascripts_project

3. Bestanden uitpakken:

   • Zoek het gedownloade .zip-bestand van FacturaScripts en dubbelklik om het uit te pakken.
   • Kopieer of verplaats alle uitgepakte bestanden en mappen (zoals index.php, Core, Dinamic, Plugins, enz.) naar de zojuist aangemaakte map (/Applications/ServBay/www/facturascripts_project).

Initiële configuratie (MySQL-database instellen)

FacturaScripts gebruikt een database voor opslag van bedrijfsdata, gebruikers, instellingen, enzovoort. We gebruiken hier MySQL of MariaDB, beheerd door ServBay.

1. Controleer of het databasepakket draait:

   • Open ServBay.
   • Kies links het menu “Pakketten” en selecteer “MySQL” of “MariaDB” (afhankelijk van je keuze).
   • Controleer of het pakket actief is. Zo niet, zet het aan via de schakelknop.

2. Database en gebruiker aanmaken:

   • Je kunt de ingebouwde databasebeheerder van ServBay gebruiken (zoals phpMyAdmin, die standaard meegeleverd wordt) of het via de terminal regelen. Voor beginners is phpMyAdmin het meest gebruiksvriendelijk.
   • Via phpMyAdmin (aanbevolen):
     • Ga in ServBay naar het onderdeel “Database” en klik op het phpMyAdmin-icoon naast je gekozen databasepakket. ServBay opent nu phpMyAdmin in de browser.
     • Log in met de standaardgebruiker root en het wachtwoord dat je tijdens de initiële ServBay-setup instelde. Ben je het rootwachtwoord kwijt, dan kun je het in ServBay resetten via het databasepakket.
     • Klik bovenaan op het tabblad 'Databases'.
     • Voer een naam in voor de database, bijvoorbeeld facturascripts_servbay_db.
     • Selecteer een geschikte tekenset en collatie, bij voorkeur utf8mb4_general_ci of utf8mb4_unicode_ci voor maximale compatibiliteit en emoji-ondersteuning.
     • Klik op 'Aanmaken'.
     • Nieuwe databasegebruiker aanmaken (optioneel maar aanbevolen): Gebruik NIET de rootgebruiker voor de FacturaScripts database. Maak een aparte user aan met beperkte rechten.
       • Ga terug naar de homepage in phpMyAdmin en klik op het tabblad 'Gebruikersaccounts'.
       • Klik op 'Gebruiker toevoegen'.
       • Voer een naam in, zoals facturascripts_servbay_user.
       • Stel het hostadres in op localhost of 127.0.0.1 zodat deze gebruiker alleen lokaal verbinding kan maken.
       • Genereer of kies een sterk wachtwoord. Bewaar dit wachtwoord op een veilige plek.
       • Onderaan kun je kiezen om hem rechten te geven op de juiste database. De snelste optie is “Database aanmaken met dezelfde naam en alle rechten toekennen”, maar kies liever “Rechten voor een specifieke database” en wijs hem daar alle noodzakelijke rechten toe op de zojuist gemaakte database (facturascripts_servbay_db).
       • Klik onderaan op 'Uitvoeren' om op te slaan.

3. Noteer je databasegegevens: Je hebt deze straks nodig bij de FacturaScripts-installatie:

   • Databasenaam (bijv. facturascripts_servbay_db)
   • Gebruikersnaam (bijv. facturascripts_servbay_user)
   • Wachtwoord van deze gebruiker
   • Databasehost (meestal localhost of 127.0.0.1)
   • Databasepoort (standaard voor MySQL/MariaDB is 3306, controleer via het ServBay-pakketoverzicht wat het daadwerkelijke poortnummer is)

Webserver configureren (Apache of Nginx)

Nu gaan we instellen hoe de webserver in ServBay je FacturaScripts-project moet aanbieden. Zowel Apache als Nginx worden volledig ondersteund.

1. Controleer of de webserver draait:

   • Ga in ServBay naar het “Pakketten”-overzicht en kijk of Apache of Nginx actief is.

2. Website toevoegen:

   • Kies in het menu aan de linkerkant ‘Websites’ (Sites).
   • Klik op de “+” bovenaan de lijst om een nieuwe site toe te voegen.
   • Vul in het pop-upvenster het volgende in:
     • Naam: Bijvoorbeeld FacturaScripts Demo Site.
     • Domeinnaam: Je gewenste lokale domein, aangeraden is facturascripts.servbay.demo (de .servbay.demo-conventie wordt door ServBay aanbevolen voor lokale ontwikkeldomeinen).
     • Website type: Selecteer PHP (dynamische PHP-webapp).
     • Rootmap: Klik op ‘Bladeren’ en selecteer de map waar je FacturaScripts hebt uitgepakt (/Applications/ServBay/www/facturascripts_project). Let op: sommige frameworks eisen een submap als rootmap (zoals public of web), maar bij FacturaScripts wijst de root doorgaans direct naar de hoofdmap. Check voor de zekerheid de FacturaScripts-documentatie.
     • PHP-versie: Selecteer een versie die compatibel is met je FacturaScripts-release. Kijk in de FacturaScripts-handleiding welke versie aangeraden wordt, bijvoorbeeld PHP 8.1, 8.2 of nieuwer. ServBay biedt verschillende PHP-versies die je makkelijk kunt wisselen.
     • Overige instellingen: Deze kun je meestal op standaard laten staan. ServBay ondersteunt daarnaast SSL/HTTPS (met User CA of ACME-certificaten), CORS, enzovoorts.

3. Configuratie opslaan & hostsbestand bijwerken:

   • Klik onderaan op 'Toevoegen' of 'Opslaan' zodra alles is ingevuld.
   • ServBay configureert automatisch een virtual host/server block voor de geselecteerde webserver. Je krijgt een melding dat ServBay adminrechten nodig heeft om het systeem hosts-bestand aan te passen, zodat facturascripts.servbay.demo naar 127.0.0.1 verwijst. Je hoeft dus zelf het hosts-bestand niet te bewerken.

4. Controleer en activeer PHP-extensies:

   • FacturaScripts vereist bepaalde PHP-extensies voor correcte werking, zoals pdo_mysql, gd (beeldbewerking), intl (internationaal gebruik), zip (in- en uitpakken), xml, curl (webverzoeken) enzovoorts. Standaard zijn de belangrijkste extensies in ServBay actief, maar als de FacturaScripts-installatie klaagt over ontbrekende extensies, moet je deze inschakelen.
   • PHP-extensies inschakelen in ServBay:
     • Ga in ServBay naar 'Talen' ('Languages') > 'PHP'.
     • Selecteer de PHP-versie waarmee je de site (facturascripts.servbay.demo) draait.
     • In het detailoverzicht klik je op 'Extensies'.
     • Hier zie je de lijst van geïnstalleerde en actieve extensies. Vink de extensies aan die nodig zijn (zoals opcache), en sla vervolgens op.
     • In sommige gevallen is een herstart van de PHP-service vereist. Dit doe je via dezelfde pagina in ServBay, bij de PHP-versie op het herstart-icoon klikken.

Voorbeeld van siteconfiguratie in ServBay

Website bezoeken en FacturaScripts installeren

Je ServBay-omgeving is nu klaar voor FacturaScripts. Tijd om de installatie daadwerkelijk uit te voeren!

1. Open je webbrowser: Start je favoriete browser (Chrome, Firefox, Safari, enz.).

2. Navigeer naar het adres: Typ het ingestelde lokale domein in de adresbalk, bijvoorbeeld http://facturascripts.servbay.demo. Heb je SSL geconfigureerd via ServBay, dan kun je ook https://facturascripts.servbay.demo gebruiken. Druk op Enter.

3. De FacturaScripts-installatiewizard:

   • Werkt alles, dan zie je nu een welkomstpagina of installatiewizard van FacturaScripts.
   • Taalkeuze: Kies eerst in welke taal je de interface wilt gebruiken.
   • Systeemcontrole: De wizard controleert nu je server (PHP-versie, vereiste extensies, bestandsrechten, enz.). Bij een juiste ServBay-configuratie zie je overal ‘groen’. Zie je rode of gele waarschuwingen, controleer dan je PHP-versie, extensies en bestandsrechten in ServBay. De projectmap /Applications/ServBay/www/facturascripts_project moet voor de webservergebruiker schrijfbaar zijn.
   • Databaseconfiguratie: Tijd om je genoteerde databasegegevens in te vullen:
     • Type database: MySQL
     • Host: localhost of 127.0.0.1
     • Poort: 3306 (of de poort die ServBay toont)
     • Databasenaam: facturascripts_servbay_db
     • Gebruikersnaam: facturascripts_servbay_user
     • Wachtwoord: Het zojuist ingestelde wachtwoord
     • Prefix: Standaardwaarde fs_ is prima, maar kun je aanpassen
   • Adminaccount: Stel de beheerdersnaam, wachtwoord en e-mailadres in voor het FacturaScripts-dashboard. Kies een sterk wachtwoord en onthoud deze gegevens, je hebt ze nodig voor de backend-login.
   • Installatie: Controleer je gegevens en klik op ‘Installeren’. FacturaScripts maakt nu alle noodzakelijke tabellen en schrijft de config-bestanden.

4. Installatie voltooid:

   • Na succesvolle installatie kan FacturaScripts je vragen de install-map in het project te verwijderen, voor extra beveiliging. Volg deze aanwijzing op.
   • Je hebt nu toegang via http://facturascripts.servbay.demo (of de HTTPS-variant) tot het inlogscherm, waar je met je adminaccount kunt beginnen!

Veelgestelde vragen (FAQ)

• Vraag: Er ontbreekt een PHP-extensie volgens de FacturaScripts-installatiewizard, wat nu?
  • Antwoord: Ga in ServBay naar ‘Talen’ > ‘PHP’, selecteer de juiste PHP-versie, klik op ‘Extensies’, activeer de benodigde extensie (zoals opcache) en sla op. Herstart indien nodig de PHP-service.
• Vraag: Ik krijg “Forbidden” of een blanco pagina bij bezoek aan facturascripts.servbay.demo.
  • Antwoord: Controleer of de webserver (Apache/Nginx) en PHP dienst actief zijn. Controleer of de juiste rootmap is ingesteld. Zie je een blanco pagina, dan is het waarschijnlijk een PHP-fout; check de error logs van de webserver en PHP. “Forbidden” betekent meestal onjuiste bestandsrechten — zorg dat de webserver gebruiker lees- én schrijfrechten heeft op de projectbestanden en bijvoorbeeld de map Dinamic.
• Vraag: Databaseverbinding faalt bij FacturaScripts-installatie.
  • Antwoord: Controleer of MySQL/MariaDB draait en op de juiste poort luistert (3306). Kijk of de ingevulde host, poort, databasenaam, gebruikersnaam en wachtwoord exact kloppen met wat je in ServBay ingesteld hebt.

Samenvatting

Met ServBay wordt het installeren en draaien van FacturaScripts op macOS zeer eenvoudig. ServBay bundelt alle benodigde afhankelijkheden (webserver, PHP, database) en vereenvoudigt het configuratieproces dankzij de overzichtelijke interface. Volg bovenstaande stappen en je hebt binnen enkele minuten een lokale ontwikkel- of testomgeving voor FacturaScripts, zodat je je rechtstreeks kunt richten op bedrijfsbeheer en de krachtige functies van het systeem. De flexibiliteit en het gemak van ServBay maken lokale ontwikkeling vele malen efficiënter.