23-02-2021, 17:02
Dans Creme 2.2 l'export des documents de facturation a été nettement amélioré. Auparavant l'export générait forcément du PDF, et se faisait uniquement via Latex ; or ce dernier est plutôt pénible à installer (sous Windows notamment ; mais même sous Linux avoir tous les paquets nécessaires pour nos documents n'était pas forcément trivial), et pour les gens qui voulaient personnaliser le rendu de leur facture ce n'est pas le langage le plus facile/répandu.
Un système de backend a été développé, ainsi que plusieurs backends s'appuyant sur des bibliothèques différentes (voir BILLING_EXPORTERS dans settings.py) :
- xhtml2pdf: ce backend est celui par défaut. La bibliothèque "xhtml2pdf" s'installe facilement sur les différents OS, l'écriture des patrons se fait dans un sous-ensemble de HTML plutôt sympathique (même si la mise en page se fait principalement à coup de tableaux, ça reste acceptable dans ce cas de figure) et le rendu est assez joli.
- latex: il s'agit globalement du code utilisé dans les versions précédentes de Creme (mais être sous la forme d'un backend permet de plus facilement personnaliser son comportement). Ce backend n'est pas proposé/installé de base (pour les raisons exposées plus haut), mais reste disponible (par exemple pour les utilisateurs qui étaient satisfaits du rendu dans les versions précédentes de Creme) en mettant 'creme.billing.exporters.latex.LatexExportEngine' dans la variable BILLING_EXPORTERS de votre fichier 'local_settings.py' .
- weasyprint: cette bibliothèque de rendu PDF utilise un sous-ensemble de HTML meilleur que celui de xhtml2pdf. Mais si elle s'installe facilement sous Linux, c'est plus compliqué sous Windows notamment. Aussi elle n'est pas proposée de base ; si elle vous intéresse ajoutez 'creme.billing.exporters.weasyprint.WeasyprintExportEngine' dans la variable BILLING_EXPORTERS de votre local_settings.py (la bibliothèque Python "weasyprint" doit être installé dans votre virtual env) .
Un autre backend est proposé par défaut: XLS. Comme sont nom l'indique, il ne génère pas des fichiers PDFs mais des fichiers XLS, et est destiné aux gens qui voudraient faire du publi-postage.
Dans la configuration du module facturation, un nouveau bloc est apparu est permet de configurer l'export pour les différents type de documents (facture, devis...) :
![[Image: creme22_FR_billing_export01.png]](http://img.hybird.org/creme/img/creme22/creme22_FR_billing_export01.png)
Les backends proposés sont ceux qui sont déclarés dans BILLING_EXPORTERS ; et chaque backend (sauf celui XLS) peut poposer des patrons diiférents, qui correspondent à des styles différents (couleur, police, agencement) et à des pays/langues diférents ; en effet les mentions légales peuvent changer d'un pays à un autre. Pour le moment ne sont disponible qu'un style et pour la France (mais de nouveaux styles/pays pourraient faire l'objet de contribution externes intéressante *wink wink*). Voici à quoi ressemble une facture exportée en 2.2 par défaut :
![[Image: creme22_FR_billing_export02.png]](http://img.hybird.org/creme/img/creme22/creme22_FR_billing_export02.png)
Un système de backend a été développé, ainsi que plusieurs backends s'appuyant sur des bibliothèques différentes (voir BILLING_EXPORTERS dans settings.py) :
- xhtml2pdf: ce backend est celui par défaut. La bibliothèque "xhtml2pdf" s'installe facilement sur les différents OS, l'écriture des patrons se fait dans un sous-ensemble de HTML plutôt sympathique (même si la mise en page se fait principalement à coup de tableaux, ça reste acceptable dans ce cas de figure) et le rendu est assez joli.
- latex: il s'agit globalement du code utilisé dans les versions précédentes de Creme (mais être sous la forme d'un backend permet de plus facilement personnaliser son comportement). Ce backend n'est pas proposé/installé de base (pour les raisons exposées plus haut), mais reste disponible (par exemple pour les utilisateurs qui étaient satisfaits du rendu dans les versions précédentes de Creme) en mettant 'creme.billing.exporters.latex.LatexExportEngine' dans la variable BILLING_EXPORTERS de votre fichier 'local_settings.py' .
- weasyprint: cette bibliothèque de rendu PDF utilise un sous-ensemble de HTML meilleur que celui de xhtml2pdf. Mais si elle s'installe facilement sous Linux, c'est plus compliqué sous Windows notamment. Aussi elle n'est pas proposée de base ; si elle vous intéresse ajoutez 'creme.billing.exporters.weasyprint.WeasyprintExportEngine' dans la variable BILLING_EXPORTERS de votre local_settings.py (la bibliothèque Python "weasyprint" doit être installé dans votre virtual env) .
Un autre backend est proposé par défaut: XLS. Comme sont nom l'indique, il ne génère pas des fichiers PDFs mais des fichiers XLS, et est destiné aux gens qui voudraient faire du publi-postage.
Dans la configuration du module facturation, un nouveau bloc est apparu est permet de configurer l'export pour les différents type de documents (facture, devis...) :
Les backends proposés sont ceux qui sont déclarés dans BILLING_EXPORTERS ; et chaque backend (sauf celui XLS) peut poposer des patrons diiférents, qui correspondent à des styles différents (couleur, police, agencement) et à des pays/langues diférents ; en effet les mentions légales peuvent changer d'un pays à un autre. Pour le moment ne sont disponible qu'un style et pour la France (mais de nouveaux styles/pays pourraient faire l'objet de contribution externes intéressante *wink wink*). Voici à quoi ressemble une facture exportée en 2.2 par défaut :