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	External module - www.dolistore.com
Status / Statut / Estado	Stable
Prerequisites / Prérequis	Dolibarr min version: See on Dolistore Dolibarr max version: See on Dolistore
Last update date / Date mise à jour fiche / Fecha última actualización	2020-11-17
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

vous pouvez ajouter les chaines suivantes

__AMOUNT_TEXT__
__AMOUNT_EXCL_TAX_TEXT__
__AMOUNT_VAT_TEXT__
__AMOUNT_MULTICURRENCY_TEXT__
__AMOUNT_MULTICURRENCY_EXCL_TAX_TEXT__
__AMOUNT_MULTICURRENCY_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_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).