InvoicePlane és un sistema web autoallotjat de programari lliure escrit en el llenguatge de programació PHP i requereix una base de dades SQL. L'aplicació proporciona una gestió similar a un CRM per als teus clients. Pots introduir dades de contacte, notes o afegir camps personalitzats.

És una aplicació força sòlida per administrar tot el teu cicle de facturació, com ara pressupostos, factures i pagaments. És força personalitzable per adaptar-la a les necessitats, ja que està desenvolupada en PHP.

Pots utilitzar formats de quantitat, plantilles de correu electrònic i PDF configurant-ho des del mateix tauler web. A més, accepta pagaments en línia mitjançant PayPal per pagar les factures.

Aquí et deixem alguns enllaços sobre Invoice Plane:

• Documentació
• Repositori GitHub
• Fòrum de suport/ajuda

Prerequisits

• Un servidor Ubuntu 20.04 LTS amb un usuari root o amb permisos per poder executar sudo su.
• Un registre DNS de tipus A amb l'adreça IP pública del servidor per obtenir un certificat.

Instal·lació

En aquest article t'expliquem com instal·lar InvoicePlane, però instal·lant prèviament NGINX amb PHP, MariaDB i obtenint un certificat Let's Encrypt amb Certbot. Accedeix al servidor amb un client SSH i segueix els passos següents.

Primer, actualitza el repositori i instal·la les actualitzacions:

# apt update && apt upgrade

Després, instal·la NGINX, MySQL, PHP (alguns paquets són opcionals) i Certbot:

# apt install nginx mariadb-server php-cli php-fpm php-common php-curl php-dompdf php-gd php-zip php-apcu php-yaml php-xdebug php-mbstring php-gd php-xml php-json php-mysql certbot python3-certbot-nginx

Pots comprovar la instal·lació de PHP verificant-ne la versió:

# php -v

Després, accedeix al directori temporal i descarrega InvoicePlane del web oficial (pots verificar l'última versió a https://www.invoiceplane.org/downloads):

# cd /tmp && wget https://www.invoiceplane.org/download/v1.5.11

Descomprimeix el fitxer descarregat:

# apt install -y unzip && unzip v1.5.11 -d /var/www/html/

Crea un usuari i una base de dades per a InvoicePlane seguint els passos següents. Primer inicia i habilita MariaDB:

# systemctl start mariadb && systemctl enable mariadb

Posteriorment, configura MySQL:

# mysql_secure_installation

I accedeix a MariaDB per crear l'usuari i la base de dades:

# mysql -u root

Crea la base de dades i l'usuari i atorga-hi permisos:

MariaDB .. > create database invoicedb;
MariaDB .. > create user 'invoiceuser'@'localhost' identified by 'password';
MariaDB .. > grant all privileges on invoicedb.* to 'invoiceuser'@'localhost';
MariaDB .. > flush privileges;
MariaDB .. > quit;

Un cop hagis acabat, copia el fitxer d'exemple de configuració per configurar InvoicePlane:

# cp /var/www/html/ipconfig.php.example /var/www/html/ipconfig.php

Edita'l i afegeix el registre o domini que utilitzaràs com a URL:

# nano /var/www/html/ipconfig.php

Has d'editar la línia IP_URL per afegir-lo:

IP_URL=https://invoiceplane.ejemplo.com

Canvia el propietari i el grup de tot el directori web de manera recursiva:

# chown -R www-data:www-data /var/www/html/

Modifica també els permisos:

# chmod -R 755 /var/www/html/

Edita el fitxer del lloc:

# nano /etc/nginx/sites-available/default

Canvia el server_name del fitxer pel registre del subdomini o domini:

server_name invoiceplane.ejemplo.com;

Afegeix index.php a la línia index:

index index.php;

Substitueix la línia try_files per:

try_files $uri $uri/ /index.php?$args;

Descomenta també les línies per a l'ús de PHP i denega l'accés a .htaccess (no utilitzat per NGINX). Ha de quedar així:

# passa els scripts PHP al servidor FastCGI
location ~ \.php$ {
                  # include snippets/fastcgi-php.conf;
                  include fastcgi.conf;
                  # fastcgi_index index.php;
                  # Amb php-fpm (o altres sòcols unix):
                  fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
                  # Amb php-cgi (o altres sòcols tcp):
                  # fastcgi_pass 127.0.0.1:9000;
                  fastcgi_param HTTPS on;
}
  # denega l'accés als fitxers .htaccess, si l'arrel de documents d'Apache
  # coincideix amb la de nginx
  #
  location ~ /\.ht {
                   deny all;
}

Desa els canvis i surt de l'editor de fitxers. Posteriorment, verifica la configuració modificada amb:

# nginx -t

Si no apareixen errors, reinicia el servei web per tornar a carregar els canvis:

# systemctl restart nginx.service

Finalment, obtén el certificat amb Certbot amb redirect:

# certbot --nginx --redirect -d invoiceplane.ejemplo.com

Amb aquesta última acció, podràs accedir directament a l'assistent d'InvoicePlane per finalitzar la instal·lació des d'un navegador mitjançant l'URL assignat:

Fes clic a Setup i selecciona l'idioma desitjat per a InvoicePlane:

Fes clic a continuar i verifica que compleixis tots els requisits:

Si compleixes els requisits, podràs continuar amb la instal·lació i indicar la base de dades creada anteriorment:

Prova la connexió:

Fes clic als botons de continuar per crear les taules i els registres. Posteriorment, un cop hagis acabat amb la base de dades, hauràs de crear un usuari i afegir la informació de facturació:

Un cop completat, apareixerà el missatge següent:

Tal com indica l'advertiment, per precaució desactiva la configuració executant l'ordre següent:

# sed -i 's/DISABLE_SETUP=false/DISABLE_SETUP=true/g' /var/www/html/ipconfig.php

A continuació, fes clic al botó d'iniciar sessió i introdueix el correu i la contrasenya creats per accedir al Dashboard d'InvoicePlane:

Enhorabona! Has completat la instal·lació i la configuració del sistema de facturació Invoice Plane en un servidor Ubuntu 20.04 LTS.

Ara pots implementar fàcilment Invoice Plane en un entorn de producció per a la teva facturació.