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 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 : Source :
- version historique : https://gitlab.com/noizette/garradin-plugin-facturation
- version compatible paheko 1.3.x : https://git.roflcopter.fr/lesanges/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: ## 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. Vous pouvez télécharger l'archive .tar.gz depuis la page des
[releases](https://git.roflcopter.fr/lesanges/paheko-plugin-facturation/releases),
### Anciennes versions (<0.6) supprimer le numéro de version du nom de l'archive puis la placer dans
le dossier plugins de Paheko.
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.
## Fonctionnalités : ## Fonctionnalités :
- Créer et gérer une base de client·es - Créer et gérer une base de client·es
@ -45,11 +27,21 @@ 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) - 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 - 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 - 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 : ## 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 - Ajout des champs Référence, Prix unitaire, Quantité sur les documents
- Actions sur liste de client·es (exporter, supprimer) - Actions sur liste de client·es (exporter, supprimer)
- Afficher/filtrer les documents par statuts réglé/archivé - Afficher/filtrer les documents par statuts réglé/archivé
@ -59,12 +51,9 @@ Note : pour le moment, les actions sur la liste des clients à cocher ne fonctio
- Gestion TVA ? - Gestion TVA ?
- Un devis ne devrait pas pouvoir être réglé - 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 ? - 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 - Opérations de paiements dans la compta liés à une facture
- Gestion de produits - Gestion de produits
Le plugin nécessite l'extension PHP mbstring. Le plugin nécessite l'extension PHP mbstring.
## Inclus les bibliothèques suivantes : ## Inclus les bibliothèques suivantes :