Module NumberWords FR
Informations
| Module name | Number to Words |
| Editor / Editeur | DoliCloud - www.dolicloud.com |
| Download or buy page / Page achat ou téléchargement | www.dolistore.com |
| Status / Statut / Estado | Stable |
| Prerequisites / Prérequis | Dolibarr min version 5.0 |
| Last update date / Date mise à jour fiche / Fecha última actualización | 2023-09-25 |
| Note / Nota |
Fonctionnalité
Avec ce module, Dolibarr est capable de traduire des numériques ou montants en chaine de textes ("110 dollars" devient "cent dix dollars")
Installation
- Télécharger le fichier archive du module (.zip) depuis le site web www.dolistore.com ou le récupérer par tout autre manière.
- Placer le répertoire du module dans le répertoire custom de Dolibarr:
- Pour cela, aller dans Accueil - Configuration - Modules - Déployer/installer une app/module externe
- Téléverser le fichier. Note: Si cela échoue, vous pouvez manuellement dézipper le fichier dans le répertoire custom via la ligne de commande: aller dans le répertoire *custom* et décompressez le zip avec la commande: unzip fichiermodule.zip
- Le module est opérationnel et peut être activé.
Configuration
Pour utiliser ce module, il vous faut d'abord l'activer. Pour cela, après s'être connecté avec un compte administrateur, aller sur la page "Accueil - Configuration - Modules".
Choisissez l'onglet dans lequel apparaît le module puis cliquez sur "Activer".
Le module est alors activé.
Si un pictogramme 
apparaît sur la vignette ou à la fin de la ligne du module, cliquez dessus pour accéder à la page de paramétrage spécifique à ce module.
Puis voir "Utilisation"
Utilisation
Si vous êtes utilisateur final
L'activation du module ne suffit pas pour faire apparaître les montant en lettre. Il vous faut aussi indiquer où faire apparaître le montant en texte et lequel. Pour cela, allez dans la zone "Mention complémentaire..." que l'on trouve dans les espaces de configurations des modules Factures, Commandes, Propositions commerciales... (menu Accueil - Configuration - Modules - Module Facture ou Commandes, ou Proposition puis clique sur Configurer), et ajoutez dans cette zone de texte une des chaines suivantes:
- __AMOUNT_TEXT__
- __AMOUNT_EXCL_TAX_TEXT__
- __AMOUNT_VAT_TEXT__
- __AMOUNT_MULTICURRENCY_TEXT__
- __AMOUNT_MULTICURRENCY_EXCL_TAX_TEXT__
- __AMOUNT_MULTICURRENCY_VAT_TEXT__
Le mot clé sera remplacée par le montant TTC, HT ou de TVA, en texte clair de caractères alphabétiques.
Exemple: Si dans la zone Mention complémentaire..., vous indiquez
Montant à facturer: __AMOUNT_EXCL_TAX_TEXT__
Alors lors de la génération du PDF d'une facture de 110 euros HT, vous trouverez dans le bas de la facture le texte
Montant à facturer: cent dix euros
Pour un remplacement dans les modèles ODT, les mots clés à insérer dans le modèle ODT sont
- {__AMOUNT_TEXT__}
- {__AMOUNT_EXCL_TAX_TEXT__}
- {__AMOUNT_VAT_TEXT__}
- {__AMOUNT_MULTICURRENCY_TEXT__}
- {__AMOUNT_MULTICURRENCY_EXCL_TAX_TEXT__}
- {__AMOUNT_MULTICURRENCY_VAT_TEXT__}
Si vous êtes développeur
Vous pouvez aussi utiliser, n'importe où dans le code, la méthode
$langs->getLabelFromNumber($mynumber,0|1)
pour obtenir la chaine en texte d'un numérique (si le 2eme paramètre est 0) ou d'un montant (si le 2eme paramètre est 1).
Développement
Le développement de ce module n'est pas inclus dans le repository GIT standard de Dolibarr mais dans un repository dédié de modules gérés par DoliCloud sur la plateforme Git de GitHub:
- GIT Repository: git clone https://github.com/DoliCloud/DoliMods.git
Note: Ce repository contient de nombreux autres modules Open Source pour Dolibarr ERP CRM (1 sous-répertoire de htdocs = 1 module).