Difference between revisions of "Module NumberWords"

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search
Line 11: Line 11:
  
 
= Setup =
 
= Setup =
See "Usage"
+
{{ActivationModuleEn}}
 +
 
 +
Then see "Usage"
  
 
= Usage =
 
= Usage =

Revision as of 16:46, 13 January 2010

Features

With this module, Dolibarr is able to translate decimal number or amount into full text strings ("110 dollars" will give "one hundred and ten dollars")

Install

From the application

  • Download the archive file of module (.zip file)
  • Go on menu Home -> Setup -> Modules -> Deploy external module and submit the file.
  • Module is then visible into list of available modules (Home -> Setup -> Modules) and can be activated.

Manually

  • Download the archive file of module (.zip file)
  • Put the file into the root directory of Dolibarr.
  • Uncompress the archive file, for example with command
unzip modulefile.zip
  • Module is then visible into list of available modules (Home -> Setup -> Modules) and can be activated.

Setup

To use this module, you must first enable it using an administrator account, via the menu option "Home - Setup - Modules".

Choose the tab where the module is listed. Then click on "Activate".

The module is now activated.

If a cog icon appears Cog circle.svg on module thumb or at end of the line of the module, click on it to access the setup page specific to the module.

Then see "Usage"

Usage

  • If you are an end user: add the string __TOTAL_TTC_WORDS__, __TOTAL_HT_WORDS__, __TOTAL_VAT_WORDS__ in any "free text for PDF" area in setup of invoices, orders, proposals... This string will be replaced with the amount with tax, without tax or for vat in full clear alphabetic text.
  • If you are a developper: You can also use, anywhere in the code, the method
$langs->getLabelFromNumber($mynumber,0|1)

to get full text string of a number or amount.

Development

Development of this module is not included inside standard CVS repository of Dolibarr but into the complementary modules area. So source code is hosted into following CVS repository:

  • CVS Repository: :ext:savannahlogin@cvs.savannah.nongnu.org:/cvsroot/dolibarr
  • CVS Module: dolibarrmod

To have a view on changes done on this repository, see page http://www.nltechno.com/stats/dolibarr/cvschangelogbuilder_dolibarrmod.html