Creare e Eseguire un Progetto FacturaScripts

FacturaScripts è una potente e flessibile soluzione ERP e CRM open-source, ideale per piccole e medie imprese e liberi professionisti. Grazie all'ambiente di sviluppo locale fornito da ServBay, è possibile creare, testare ed eseguire facilmente progetti FacturaScripts su un sistema macOS.

Questa guida ti guiderà attraverso l'intero processo di installazione e configurazione di FacturaScripts utilizzando ServBay.

Cos'è FacturaScripts?

FacturaScripts è un software open-source di pianificazione delle risorse aziendali (ERP) e gestione delle relazioni con i clienti (CRM) sviluppato con PHP e il framework Bootstrap. È progettato per aiutare le aziende a gestire i loro processi aziendali fondamentali, tra cui:

• Emissione e gestione delle fatture
• Contabilità
• Controllo delle scorte
• Gestione clienti e fornitori
• Gestione progetti
• E molto altro...

Come progetto open-source, gode di un attivo supporto della comunità e consente agli utenti di estendere e personalizzare le funzionalità tramite plugin.

Caratteristiche e Vantaggi Principali di FacturaScripts

• Open-source e gratuito: Utilizzo e modifica senza dover pagare costose licenze.
• Funzionalità complete: Copre la maggior parte delle funzionalità necessarie per le operazioni quotidiane delle piccole e medie imprese.
• Facile da usare: Interfaccia relativamente intuitiva, con una curva di apprendimento dolce.
• Altamente scalabile: Dispone di un ricco mercato di plugin per aggiungere facilmente nuove funzionalità o integrare altri servizi.
• Cross-platform: Basato su web, accessibile da qualsiasi dispositivo che supporti browser moderni.
• Comunità attiva: Aiuto disponibile dalla comunità in caso di problemi.
• Supporto multilingue: Supporta diverse lingue, facilitando l'uso per utenti di diverse aree geografiche.

Creare e Eseguire un Progetto FacturaScripts Utilizzando ServBay

ServBay fornisce un ambiente ideale per eseguire applicazioni PHP (come FacturaScripts) in locale. Integra Nginx/Apache, diverse versioni di PHP e servizi comuni come MySQL/MariaDB/PostgreSQL, offrendo un'interfaccia grafica per la gestione.

I passaggi principali per eseguire FacturaScripts tramite ServBay includono:

1. Scarica il codice sorgente di FacturaScripts.
2. Crea una cartella di progetto nella directory gestita da ServBay.
3. Crea il database MySQL e l'utente richiesti da FacturaScripts.
4. Configura il server web Apache tramite ServBay per puntare alla directory del progetto.
5. Accedi tramite il browser e completa la procedura guidata d'installazione di FacturaScripts.

Creare un Progetto FacturaScripts (basato sul pacchetto zip scaricato)

Questo è uno dei metodi più comuni per installarlo in locale.

1. Scarica FacturaScripts:

   • Visita il sito ufficiale di FacturaScripts (https://facturascripts.com/).
   • Naviga verso l'area download, trova l'ultima versione stabile del pacchetto .zip e scaricalo.

2. Crea la directory di progetto:

   • Apri Finder e naviga nella directory dove ServBay memorizza i file del sito. Per impostazione predefinita, ti consigliamo di posizionarlo in /Applications/ServBay/www/.
   • Crea una nuova cartella in questa directory per memorizzare il progetto FacturaScripts, ad esempio chiamandola facturascripts_project.
   • Esempio di percorso completo: /Applications/ServBay/www/facturascripts_project

3. Estrai i file:

   • Estrai il file .zip di FacturaScripts scaricato nella cartella facturascripts_project appena creata.
   • Dopo l'estrazione, la cartella facturascripts_project dovrebbe contenere file e directory come index.php, config.php (potrebbe essere generato dopo l'installazione), Core, Dinamic, Plugins, ecc.

Configurazione Iniziale (Configurazione del database MySQL, ecc.)

FacturaScripts necessita di un database per memorizzare tutti i dati. Useremo il servizio MySQL gestito da ServBay.

1. Verifica che il servizio MySQL sia in esecuzione:

   • Apri l'applicazione ServBay.
   • Nel menu a sinistra, seleziona "Servizi" > "MySQL".
   • Assicurati che il servizio MySQL (o MariaDB) sia avviato. Se non è avviato, clicca il pulsante di attivazione accanto per avviarlo.

2. Crea il database:

   • Puoi usare lo strumento di gestione del database incorporato in ServBay (come phpMyAdmin) o creare il database tramite la linea di comando.
   • Utilizzare phpMyAdmin (consigliato):
     • Nella interfaccia di ServBay, trova "Database" > "MySQL", e clicca su phpMyAdmin in alto a destra.
     • Accedi a phpMyAdmin (di solito con l'utente root e la password impostata in ServBay).
     • Clicca sulla scheda "Database".
     • Nella sezione "Crea database", inserisci il nome del database, ad esempio facturascripts_db.
     • Scegli un set di caratteri appropriato, si consiglia utf8mb4_general_ci o utf8mb4_unicode_ci.
     • Clicca su "Crea".
   • Crea un utente database (opzionale ma consigliato): Per motivi di sicurezza, è consigliato creare un utente dedicato per FacturaScripts, piuttosto che utilizzare l'utente root.
     • Nella pagina principale di phpMyAdmin, clicca sulla scheda "Account utente".
     • Clicca su "Aggiungi account utente".
     • Inserisci il nome utente (ad esempio facturascripts_user).
     • Seleziona localhost come nome host.
     • Genera o inserisci una password complessa e ricordati di annotarla.
     • Seleziona "Creare un database con lo stesso nome dell'utente e concedere tutti i privilegi" o vai manualmente nella sezione "Database" per concedere all'utente appena creato tutti i privilegi sul database facturascripts_db (ALL PRIVILEGES).
     • Clicca su "Esegui" in fondo alla pagina.

3. Annota le informazioni del database: Memorizza quanto creato:

   • Nome del database (facturascripts_db)
   • Nome utente del database (facturascripts_user)
   • Password dell'utente del database (la password che hai impostato)
   • Host del database (di solito localhost o 127.0.0.1)
   • Porta del database (la porta predefinita di MySQL è 3306, verificabile nella lista dei servizi di ServBay)

Queste informazioni verranno utilizzate durante l'installazione di FacturaScripts.

Configurazione del Server Web (basato su Apache)

Ora dobbiamo indicare a ServBay come servire il nostro progetto FacturaScripts tramite Apache.

1. Assicurati che il servizio Apache sia in esecuzione:

   • Nella schermata "Servizi" di ServBay, verifica che il servizio Apache sia avviato.

2. Aggiungi il host:

   • Nel menu a sinistra di ServBay, seleziona "Siti".
   • Clicca sul pulsante "+" a destra.
   • Nella finestra di configurazione che appare, compila le seguenti informazioni:
     • Nome: Dai a questa configurazione un nome descrittivo, ad esempio FacturaScripts Demo.
     • Dominio: Inserisci il dominio che desideri utilizzare per accedere al sito locale di FacturaScripts. Per semplicità, utilizziamo facturascripts.demo.
     • Tipo di sito web: Seleziona PHP, indicando che si tratta di un sito dinamico PHP.
     • Directory principale: Clicca su "Sfoglia" o "Seleziona", naviga e seleziona la directory in cui hai precedentemente creato e estratto i file di FacturaScripts (/Applications/ServBay/www/facturascripts_project).
     • Server web: Seleziona Apache e la versione di Apache che desideri utilizzare.
     • Versione PHP: Scegli una versione di PHP compatibile con la versione di FacturaScripts che hai scaricato (verifica i requisiti di sistema di FacturaScripts, normalmente si consiglia una versione stabile più recente, come PHP 8.1 o 8.2).
     • Ulteriori impostazioni: Di solito, puoi mantenere le impostazioni predefinite, a meno che tu non abbia esigenze specifiche.

3. Salva la configurazione:

   • Clicca sul pulsante "Aggiungi".
   • ServBay configurerà automaticamente l'host virtuale di Apache e potrebbe chiederti di avere i diritti di amministratore per modificare il file hosts di sistema, affinché facturascripts.demo punti all'IP locale (127.0.0.1). Consenti tale operazione.

4. Controlla le estensioni PHP:

   • FacturaScripts potrebbe richiedere specifiche estensioni PHP per funzionare correttamente (ad esempio pdo_mysql, gd, intl, zip, ecc.).
   • In ServBay, puoi gestire le estensioni PHP installate. Di solito, le estensioni predefinite installate in ServBay sono sufficienti, ma se durante l'installazione viene indicato che mancano delle estensioni, puoi abilitarle nella sezione di configurazione PHP di ServBay.

Accedere al Sito

Ora che tutto è pronto, puoi iniziare il processo di installazione online di FacturaScripts.

1. Apri il browser: Avvia il browser web che utilizzi di solito (come Chrome, Firefox, Safari).

2. Inserisci l'indirizzo: Nella barra degli indirizzi, digita https://facturascripts.demo e premi Invio.

3. Procedura guidata di installazione di FacturaScripts:

   • Se tutto è configurato correttamente, dovresti vedere la schermata di installazione di FacturaScripts.
   • Selezione della lingua: Scegli la lingua che desideri utilizzare.
   • Controllo del sistema: Il programma di installazione verificherà se l'ambiente del tuo server (versione PHP, estensioni necessarie, permessi delle directory, ecc.) soddisfa i requisiti. Se la configurazione di ServBay è corretta, dovresti vedere dei segni di spunta verdi su tutte le voci. Se ci sono problemi, controlla la configurazione PHP o i permessi dei file in ServBay.
   • Configurazione del database: Questo è un passaggio cruciale. Devi inserire le informazioni del database che hai creato e annotato in precedenza:
     • Tipo di database: Seleziona MySQL.
     • Host: localhost o 127.0.0.1.
     • Porta: 3306 (o la porta MySQL che vedi in ServBay).
     • Nome del database: facturascripts_db.
     • Nome utente: facturascripts_user.
     • Password: La password che hai impostato per facturascripts_user.
     • Prefisso delle tabelle: Puoi mantenere il valore predefinito fs_.
   • Account amminstratore: Imposta nome utente, password e indirizzo email per l'amministratore di FacturaScripts. Assicurati di ricordare queste informazioni, poiché ti serviranno per accedere al backend.
   • Installazione: Clicca sul pulsante di installazione e FacturaScripts creerà le tabelle del database e scriverà il file di configurazione.

4. Installazione completata:

   • Dopo un'installazione riuscita, di solito ti verrà suggerito di eliminare la directory install (se presente e con richiesta, per motivi di sicurezza).
   • Ora dovresti essere in grado di accedere alla pagina di accesso di FacturaScripts tramite http://facturascripts.demo. Utilizza l'account amministratore appena creato per accedere e inizia a esplorare e usare FacturaScripts!

---

Congratulazioni! Hai creato e eseguito con successo un progetto FacturaScripts in locale su macOS utilizzando ServBay. ServBay semplifica la configurazione e la gestione dell'ambiente del server locale, permettendoti di concentrarti maggiormente sullo sviluppo e sull'uso di FacturaScripts.