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:

Note: Ce repository contient de nombreux autres modules Open Source pour Dolibarr ERP CRM (1 sous-répertoire de htdocs = 1 module).