| 1 |
$Id: README.txt,v 1.1.2.2 2008/02/06 17:24:16 jrbeeman Exp $
|
| 2 |
|
| 3 |
DESCRIPTION
|
| 4 |
------------------------------------------------
|
| 5 |
The dompdf module allows other modules to utilize the dompdf library, written
|
| 6 |
by Benj Carson, and maintained at http://www.digitaljunkies.ca/dompdf. The
|
| 7 |
module is currently just a *very* lightweight implementation, containing just
|
| 8 |
one method that allows other modules to stream a PDF to the browser.
|
| 9 |
|
| 10 |
|
| 11 |
REQUIREMENTS
|
| 12 |
------------------------------------------------
|
| 13 |
Due to the requirements in the dompdf library, this module requires:
|
| 14 |
http://www.digitaljunkies.ca/dompdf/install.php#requirements
|
| 15 |
|
| 16 |
|
| 17 |
IMPORTANT SECURITY NOTICE
|
| 18 |
------------------------------------------------
|
| 19 |
dompdf version 0.5.1 and lower has a major security flaw in a file that is
|
| 20 |
*not* used by this module. Be sure to follow the final steps of the
|
| 21 |
installation instructions below to avoid leaving your site in an insecure
|
| 22 |
state.
|
| 23 |
|
| 24 |
|
| 25 |
INSTALLATION
|
| 26 |
------------------------------------------------
|
| 27 |
Download dompdf library from http://www.digitaljunkies.ca/dompdf and unpack
|
| 28 |
its contents to the this module's dompdf folder, so that dompdf_config.inc.php
|
| 29 |
is located at /path/to/drupal/sites/all/modules/dompdf/dompdf/dompdf_config.inc.php
|
| 30 |
|
| 31 |
***IMPORTANT SECURITY NOTICE***
|
| 32 |
If you are using dompdf version 0.5.1 or lower, remove the file dompdf.php
|
| 33 |
from the dompdf library folder. This file contains a major security flaw,
|
| 34 |
as noted in http://drupal.org/node/218334
|
| 35 |
|
| 36 |
Ensure that /path/to/drupal/.../modules/dompdf/dompdf/lib/fonts is writable as
|
| 37 |
required by the dompdf library (see INSTALL in dompdf library).
|
| 38 |
|
| 39 |
As of Drupal 6, the dompdf module integrates with Views Bonus Exports (part
|
| 40 |
of the Views Bonus Pack http://drupal.org/project/views_bonus) to provide PDF
|
| 41 |
exports.
|
| 42 |
|
| 43 |
Enable this module and use a module that takes advantage of it!
|
| 44 |
|
| 45 |
USAGE WITH VIEWS 2
|
| 46 |
------------------------------------------------
|
| 47 |
Add a "feed" display to a view and select the "PDF" style in the basic
|
| 48 |
settings. In the Feed Settings, choose a path for the export to PDF URL and
|
| 49 |
attach the feed to another display. The display you attach to will now how a
|
| 50 |
PDF feed icon linking to your PDF export.
|
| 51 |
|
| 52 |
MODULES KNOWN TO HAVE DOMPDF SUPPORT
|
| 53 |
------------------------------------------------
|
| 54 |
Signup Status
|