Module NumberWords FR

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search

Informations

Module name Number to Words
Editor / Editeur NLTechno - www.nltechno.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 2019-08-16
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 n'importe quel champ "Texte libre pour les PDF" dans les espaces de configurations des modules factures, commandes, propals... La chaine 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 NLTechno sur la plateforme Git de Framasoft:

Notons que c'est un repository privé, aussi il vous faut créer un compte et postuler au projet depuis le site https://git.framasoft.org pour pouvoir cloner les sources par GIT.