You are here

INSTALL.txt in Printer, email and PDF versions 5.3

INSTALLATION
------------

Decompress the print-n.x-n.n.tar.gz file into your Drupal modules
directory (usually sites/all/modules, see http://drupal.org/node/176044 for
more information).

Enable the print module: Administer > Site building > Modules
  (admin/build/modules)

PDF TOOL
--------

The print_pdf module requires the use of an external PDF generation tool.
The currently supported tools are dompdf and TCPDF. Please note that any
errors/bugs in those tools need to be reported and fixed by their
maintainers. DO NOT report bugs in those tools in the print module's issue
queue at Drupal.org.

dompdf support:
  The dompdf tool produces results that are more faithful to the HTML
  printer-friendly page.

  1. Download dompdf from http://sourceforge.net/projects/dompdf/
  2. Extract the contents of the downloaded package into the print module
  directory (usually sites/all/modules/print)
  3. Check if dompdf_config.inc.php fits your installation. In 99% of cases,
  no changes are necessary, so just try to use it and only edit anything if
  the PDF generation fails.
  4. Grant write access to the lib/fonts directory to your webserver user.
  5. If you're using dompdf-0.5.1, delete the dompdf.php file as it contains
  a security vulnerability
  6. Check http://www.digitaljunkies.ca/dompdf/ for further information.

TCPDF support:
  TCPDF seems to be more actively developed than dompdf, but it's support
  for CSS is considerably worse. This module requires TCPDF >= 4.0.000.

  1. Download TCPDF from http://sourceforge.net/projects/tcpdf/
  2. Extract the contents of the downloaded package into the print module
  directory (usually sites/all/modules/print). There is no need to modify
  the config/tcpdf_config.php file, as the module self-configures TCPDF.
  3. Check http://tcpdf.sourceforge.net/ for further information.

UPDATE
------

When updating from a previous version, just remove the print directory and
follow the instructions above. Make sure that you backup any costumization
to the print.tpl.php and print.css files.

ROBOTS
------

Even though it is possible to set per-page robots settings, the following
can be placed in your robots.txt file after the User-agent line to prevent
search engines from even asking for the page:

Disallow: /print/

Also, for updates from older versions (<=4.7.x-1.0 and <=5.x-1.2) which used
node/nnn/print instead of print/nnn, the following lines can prevent
requests from Google for the obsolete print URLs:

Disallow: /*/print$

Note that pattern matching in robots.txt is a Google extension (see
http://www.google.com/support/webmasters/bin/answer.py?answer=40367 for more
information).

File

INSTALL.txt
View source
  1. INSTALLATION
  2. ------------
  3. Decompress the print-n.x-n.n.tar.gz file into your Drupal modules
  4. directory (usually sites/all/modules, see http://drupal.org/node/176044 for
  5. more information).
  6. Enable the print module: Administer > Site building > Modules
  7. (admin/build/modules)
  8. PDF TOOL
  9. --------
  10. The print_pdf module requires the use of an external PDF generation tool.
  11. The currently supported tools are dompdf and TCPDF. Please note that any
  12. errors/bugs in those tools need to be reported and fixed by their
  13. maintainers. DO NOT report bugs in those tools in the print module's issue
  14. queue at Drupal.org.
  15. dompdf support:
  16. The dompdf tool produces results that are more faithful to the HTML
  17. printer-friendly page.
  18. 1. Download dompdf from http://sourceforge.net/projects/dompdf/
  19. 2. Extract the contents of the downloaded package into the print module
  20. directory (usually sites/all/modules/print)
  21. 3. Check if dompdf_config.inc.php fits your installation. In 99% of cases,
  22. no changes are necessary, so just try to use it and only edit anything if
  23. the PDF generation fails.
  24. 4. Grant write access to the lib/fonts directory to your webserver user.
  25. 5. If you're using dompdf-0.5.1, delete the dompdf.php file as it contains
  26. a security vulnerability
  27. 6. Check http://www.digitaljunkies.ca/dompdf/ for further information.
  28. TCPDF support:
  29. TCPDF seems to be more actively developed than dompdf, but it's support
  30. for CSS is considerably worse. This module requires TCPDF >= 4.0.000.
  31. 1. Download TCPDF from http://sourceforge.net/projects/tcpdf/
  32. 2. Extract the contents of the downloaded package into the print module
  33. directory (usually sites/all/modules/print). There is no need to modify
  34. the config/tcpdf_config.php file, as the module self-configures TCPDF.
  35. 3. Check http://tcpdf.sourceforge.net/ for further information.
  36. UPDATE
  37. ------
  38. When updating from a previous version, just remove the print directory and
  39. follow the instructions above. Make sure that you backup any costumization
  40. to the print.tpl.php and print.css files.
  41. ROBOTS
  42. ------
  43. Even though it is possible to set per-page robots settings, the following
  44. can be placed in your robots.txt file after the User-agent line to prevent
  45. search engines from even asking for the page:
  46. Disallow: /print/
  47. Also, for updates from older versions (<=4.7.x-1.0 and <=5.x-1.2) which used
  48. node/nnn/print instead of print/nnn, the following lines can prevent
  49. requests from Google for the obsolete print URLs:
  50. Disallow: /*/print$
  51. Note that pattern matching in robots.txt is a Google extension (see
  52. http://www.google.com/support/webmasters/bin/answer.py?answer=40367 for more
  53. information).