You are here

Home » API reference » Commerce Billy 7

README.txt in Commerce Billy 7

Same filename in this branch
  1. 7 README.txt
  2. 7 modules/commerce_billy_pdf/README.txt
Commerce Billy PDF
******************
Enables PDF donwload of invoiced and canceled orders.

Installation DOMPDF
*******************

1. Download dompdf with Composer

  composer require dompdf/dompdf

  Make sure that Composer's autoload file is included somewhere (for example
  with Composer manager).

2. Add dompdf fonts to public dir:

dompdf needs write access to its font directory.
Copy "dompdf/lib/fonts" to your public files directory:
  public://fonts (example: sites/default/files/fonts)

To check if everything is at the right place, you should find
  public://fonts/Courier.afm (for example at
  sites/default/files/fonts/Courier.afm).

Installation WKHTMLTOPDF
***********************
As alternative PDF converater WKHTMLTOPDF can be used:

1. Set variable 'commerce_billy_pdf_converter' to 'wkhtmltopdf'

2. Install WOKHTMLTOPDF - PHP Wrapper
libraries[phpwkhtmltopdf][download][type] = "get"
libraries[phpwkhtmltopdf][download][url] = "https://github.com/mikehaertl/phpwkhtmltopdf/archive/2.0.1.tar.gz"
libraries[phpwkhtmltopdf][directory_name] = "phpwkhtmltopdf"
libraries[phpwkhtmltopdf][destination] = "libraries"

Administration
**************
Got to: Store > Configuration > Billy invoice settings > PDF settings
        (/admin/commerce/config/billy-invoice/pdf)


Troubles
********
- Invoice links returns "Error generating PDF invoice. Please contact the
  website administrator." :
    Check your watchdog which contains information about the exception. Usually
    fonts are not correctly installed.

Credits
*******
Matthias Hutterer (mh86)
Klaus Purer (klausi)

File

modules/commerce_billy_pdf/README.txt
View source 
  1. Commerce Billy PDF

  2. ******************

  3. Enables PDF donwload of invoiced and canceled orders.

  4. 

  5. Installation DOMPDF

  6. *******************

  7. 

  8. 1. Download dompdf with Composer

  9. 

  10.   composer require dompdf/dompdf

  11. 

  12.   Make sure that Composer's autoload file is included somewhere (for example

  13.   with Composer manager).

  14. 

  15. 2. Add dompdf fonts to public dir:

  16. 

  17. dompdf needs write access to its font directory.

  18. Copy "dompdf/lib/fonts" to your public files directory:

  19.   public://fonts (example: sites/default/files/fonts)

  20. 

  21. To check if everything is at the right place, you should find

  22.   public://fonts/Courier.afm (for example at

  23.   sites/default/files/fonts/Courier.afm).

  24. 

  25. Installation WKHTMLTOPDF

  26. ***********************

  27. As alternative PDF converater WKHTMLTOPDF can be used:

  28. 

  29. 1. Set variable 'commerce_billy_pdf_converter' to 'wkhtmltopdf'

  30. 

  31. 2. Install WOKHTMLTOPDF - PHP Wrapper

  32. libraries[phpwkhtmltopdf][download][type] = "get"

  33. libraries[phpwkhtmltopdf][download][url] = "https://github.com/mikehaertl/phpwkhtmltopdf/archive/2.0.1.tar.gz"

  34. libraries[phpwkhtmltopdf][directory_name] = "phpwkhtmltopdf"

  35. libraries[phpwkhtmltopdf][destination] = "libraries"

  36. 

  37. Administration

  38. **************

  39. Got to: Store > Configuration > Billy invoice settings > PDF settings

  40.         (/admin/commerce/config/billy-invoice/pdf)

  41. 

  42. 

  43. Troubles

  44. ********

  45. - Invoice links returns "Error generating PDF invoice. Please contact the

  46.   website administrator." :

  47.     Check your watchdog which contains information about the exception. Usually

  48.     fonts are not correctly installed.

  49. 

  50. Credits

  51. *******

  52. Matthias Hutterer (mh86)

  53. Klaus Purer (klausi)