Module NumberWords FR

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search

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 2022-06-24
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 à 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

vous pouvez ajouter les chaines suivantes

  • __AMOUNT_TEXT__
  • __AMOUNT_WO_TAX_TEXT__
  • __AMOUNT_VAT_TEXT__
  • __AMOUNT_CURRENCY_TEXT__
  • __AMOUNT_CURRENCY_WO_TAX_TEXT__
  • __AMOUNT_CURRENCY_VAT_TEXT__

dans le champ "Mention complémentaire..." dans les espaces de configurations des modules Factures, Commandes, Propositions commerciales... Le mot clé sera remplacée par le montant TTC, HT ou de TVA, en texte clair de caractères alphabétiques.

Pour un remplacement dans les modèles ODT, les mots clés à insérer dans le modèle ODT sont

  • {__AMOUNT_TEXT__}
  • {__AMOUNT_WO_TAX_TEXT__}
  • {__AMOUNT_VAT_TEXT__}
  • {__AMOUNT_CURRENCY_TEXT__}
  • {__AMOUNT_CURRENCY_WO_TAX_TEXT__}
  • {__AMOUNT_CURRENCY_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).