Adaptation Readme à la situation actuelle

This commit is contained in:
Jean-Christophe Engel 2024-06-08 20:52:29 +02:00
parent 128e538431
commit f93bb57906

View File

@ -1,35 +1,17 @@
# Plugin Facturation pour Paheko (ex Garradin)
Plugin de facturation pour le logiciel de gestion d'association Paheko ( https://paheko.eu/ - https://fossil.kd2.org/paheko ).
Plugin de facturation pour le logiciel de gestion d'association Paheko
( https://paheko.eu/ - https://fossil.kd2.org/paheko ).
Source :
- version historique : https://gitlab.com/noizette/garradin-plugin-facturation
- version compatible paheko 1.3.x : https://git.roflcopter.fr/lesanges/facturation
- version historique non compatible paheko 1.3.x : https://gitlab.com/noizette/garradin-plugin-facturation
## Installation:
Vous pouvez télécharger l'archive .tar.gz depuis la page des [releases](https://git.roflcopter.fr/lesanges/paheko-plugin-facturation/releases), supprimer le numéro de version du nom de l'archive puis la placer dans le dossier plugins de Paheko.
### Anciennes versions (<0.6)
Normalement, les plugins de Paheko doivent seulement être laissé sous forme d'archive .tar.gz dans le dossier plugins, or pour la génération des PDF, la librairie mPDF a besoin d'écrire des fichiers temporaires.
Il faut pour cela faire :
tar xvf paheko-plugin-facturation-v0.5.0.tar.gz
mv paheko-plugin-facturation-v0.5.0 facturation
rm paheko-plugin-facturation-v0.5.0.tar.gz
chown -R www-data:www-data facturation/
chmod -R g+w facturation/
Supprimer l'archive permet à Paheko de ne pas la lire à la place du dossier.
*Note : www-data correspond dans la plupart des cas à l'utlisateur d'Apache, si vous utilisez un autre serveur web, il faudra probablement adapter.*
## Migration vers Garradin 1.0 (obsolète)
Lorsque vous tentez de mettre à jour une installation de Garradin avec le plugin facturation vers Garradin 1.0, l'upgrade est bloquée par le plugin.
Pour remédier à cela et parvenir à faire la mise à jour, il faut dans un premier temps installer la version 0.4 du plugin sur votre installation Garradin 0.9.8, se rendre sur la page principale du plugin (menu > Facturation), vous pouvez ensuite mettre à jour Garradin vers la 1.0.
## Installation :
Vous pouvez télécharger l'archive .tar.gz depuis la page des
[releases](https://git.roflcopter.fr/lesanges/paheko-plugin-facturation/releases),
supprimer le numéro de version du nom de l'archive puis la placer dans
le dossier plugins de Paheko.
## Fonctionnalités :
- Créer et gérer une base de client·es
@ -45,12 +27,22 @@ Pour remédier à cela et parvenir à faire la mise à jour, il faut dans un pre
- Vérifier le code postal : si coché, lors d'ajout ou de modification de client, le plugin vérifiera que le code postal entré est bien formaté (par rapport aux codes postaux français seulement)
- Noms de client·es uniques : si coché, lors d'ajout ou de modicifation de client·e, le nom du/de la client·e ne pourra pas être le même que celui d'un·e client·e déjà existant
- Informations relatives au cerfa pour les reçus fiscaux
- Image qui set de signature sur le cerfa
- Image qui sert de signature sur le cerfa
Note : pour le moment, les actions sur la liste des clients à cocher ne fonctionnent pas. Pour supprimer un client, le faire depuis sa fiche.
Note : pour le moment, les actions sur la liste des clients à cocher
ne fonctionnent pas. Pour supprimer un client, le faire depuis sa
fiche.
## Futur :
- Ajout des champs Référence, Prix unitaire, Quantité sur les documents
## Futur de ce plugin :
Un nouveau plugin est en cours de développement par BohwaZ, donc il
n'est pas pertinent d'ajouter de nouvelles fonctionnalités à celui-ci.
Par contre, si des bugs sont signalés sur la liste
hebergement@paheko.cloud, je peux tenter de les corriger, à condition
que ça n'impacte pas trop la structure du plugin.
## Futur improbable (obsolète) :
- Ajout des champs Référence, Prix unitaire, Quantité sur les documents
- Actions sur liste de client·es (exporter, supprimer)
- Afficher/filtrer les documents par statuts réglé/archivé
- Changer statut depuis la liste des documents
@ -59,13 +51,10 @@ Note : pour le moment, les actions sur la liste des clients à cocher ne fonctio
- Gestion TVA ?
- Un devis ne devrait pas pouvoir être réglé
- Quid si un·e membre de l'asso est supprimé·e alors que des documents lui sont adressés ?
## Futur improbable :
- Opérations de paiements dans la compta liés à une facture
- Gestion de produits
Le plugin nécessite l'extension PHP mbstring.
Le plugin nécessite l'extension PHP mbstring.
## Inclus les bibliothèques suivantes :