Revision 76bdcd04
Added by Assos Assos almost 6 years ago
drupal7/sites/all/modules/print/INSTALL.txt | ||
---|---|---|
11 | 11 |
-------- |
12 | 12 |
|
13 | 13 |
The print_pdf module requires the use of an external PDF generation tool. |
14 |
The currently supported tools are dompdf, TCPDF and wkhtmltopdf. Please |
|
15 |
note that any errors/bugs in those tools need to be reported and fixed by |
|
16 |
their maintainers. DO NOT report bugs in those tools in the print module's |
|
17 |
issue queue at Drupal.org. |
|
14 |
Please note that any errors/bugs in those tools need to be reported and |
|
15 |
fixed by their maintainers. DO NOT report bugs in those tools in the print |
|
16 |
module's issue queue at drupal.org. |
|
18 | 17 |
|
19 | 18 |
supported paths: |
20 | 19 |
* print module lib directory (usually sites/all/modules/print/lib) |
21 | 20 |
* libraries directory (sites/all/libraries) |
22 | 21 |
|
23 |
dompdf support: |
|
24 |
The dompdf tool produces results that are more faithful to the HTML |
|
25 |
printer-friendly page. Good support of CSS 2.1 and partially CSS3. |
|
26 |
|
|
27 |
1. Download dompdf from http://code.google.com/p/dompdf/downloads/list |
|
28 |
2. Extract the contents of the downloaded package into one of the |
|
29 |
supported paths. |
|
30 |
3. Check if dompdf_config.inc.php fits your installation. In 99% of cases, |
|
31 |
no changes are necessary, so just try to use it and only edit anything if |
|
32 |
the PDF generation fails. |
|
33 |
4. Grant write access to the lib/fonts directory to your webserver user. |
|
34 |
5. If you're using dompdf-0.5.1, delete the dompdf.php file as it contains |
|
35 |
a security vulnerability |
|
36 |
6. If you're using dompdf-0.6 or later, you can try to enable the Unicode |
|
37 |
support, but you'll need to add some Unicode fonts. See |
|
38 |
http://groups.google.com/group/dompdf/browse_thread/thread/9f7bc0162b04d5cf |
|
39 |
for further info on this. |
|
40 |
7. Check http://code.google.com/p/dompdf/ for further information. |
|
41 |
|
|
42 |
TCPDF support: |
|
43 |
TCPDF's support for CSS is considerably worse than the other tools. |
|
44 |
Unicode is supported (use of Unicode fonts result in HUGE files). Page |
|
45 |
header and footer are supported. This module requires TCPDF >= 5.9.012. |
|
46 |
|
|
47 |
1. Download TCPDF from http://sourceforge.net/projects/tcpdf/ |
|
48 |
2. Extract the contents of the downloaded package into one of the |
|
49 |
supported paths. There is no need to modify the config/tcpdf_config.php |
|
50 |
file, as the module self-configures TCPDF. |
|
51 |
3. Grant write access to the cache and images directories to your |
|
52 |
webserver user. |
|
53 |
4. Check http://tcpdf.sourceforge.net/ for further information. |
|
54 |
|
|
55 |
wkhtmltopdf support: |
|
56 |
wkhtmltopdf is a webkit-based tool that actually is a browser in order to |
|
57 |
generate the PDF. Resource hungry: expect to need some 30Mb+ of RAM and |
|
58 |
some seconds of CPU power. The static binaries may need additional |
|
59 |
libraries in your site, which may present problems in shared hosting |
|
60 |
environments. The best, if you can run it. |
|
61 |
|
|
62 |
1. Download wkhtmltopdf from |
|
63 |
http://code.google.com/p/wkhtmltopdf/downloads/list. You can choose to |
|
64 |
download the source and compile it or simply download the static binary, |
|
65 |
which doesn't require you to compile anything. Note that the compiled |
|
66 |
version may require a running X server (static uses patched libs that can |
|
67 |
work without one). |
|
68 |
2. Place the wkhtmltopdf executable into one of the supported paths. |
|
69 |
(usually sites/all/modules/print/lib). You can also place a symbolic link |
|
70 |
to the executable. |
|
71 |
3. Check http://code.google.com/p/wkhtmltopdf/ for further information. |
|
72 |
|
|
73 | 22 |
UPDATE |
74 | 23 |
------ |
75 | 24 |
|
Also available in: Unified diff
Weekly update of contrib modules