This package contains source for an HTML to PDF converter for MODx Evolution, which is available at the MODx Website
Currently it is not planned to create a copy for MODx Revolution.
The source is licensed under the GNU Lesser General Public License, version 2.1 as published at http://www.gnu.org/licenses/lgpl-2.1.html
This MODx snippet uses TCPDF, available at http://www.tcpdf.org/, to create the PDF Files from the content of a web document, published with MODx. TCPDF is part of the package.
The main goal is to create highly configurable PDF documents. This is possible with parameters that one can use in the snippet tag and through the usage of chunks. All chunks make use of the placeholders as defined in other MODx snippets.
###Installation###
For the installation you need to upload the TCPDF in the directory:
assets/lib/tcpdf/
The snippet classes should be located at:
assets/snippets/htmlToPDF/
Create a new snippet with the source of snippet.hmtlToPDF.php and call the snippet within your templates, probably at the top of the template. For the snippet call you can add several chunks as templates. Examples are in the assets/snippets/htmlToPDF/chunks/ directory.
###Example Snippet Call###
Here is an example for a call to htmlToPDF:
[!htmlToPDF?
&author=``Stefanie Janine Stoelting``
&tvKeywords=``documentTags``
&headerLogo=``logo.png``
&chunkContentFooter=``pdf-contentfooter``
&chunkStandardHeader=``pdf-header-text``
&chunkStyle=``pdf-style``
!]
###Default Properties###
The snippet default properties are only needed, if you want to set TCPDF, htmlToPDF, or the document output to other paths, as defined by default. If you need to change this information, go the "Properties" tab on the htmlToPDF snippet and add the following parameters to the field "Default Properties" and afterwards insert your paths: &basePath=The base path for TCPDF and htmlToPDF;string; &htmlToPdfPath=The path to the classes of htmlToPDF;string; &tcpdfPath=The path to TCPDF;string; &outputPdfPath=The path, where the PDF documents are stored. You need to give read, delete, and create rights to that folder (777).;string;
###Parameters### The following parameters are available:
| Name | Description | Possible Values | Default |
|---|---|---|---|
| isPDF | Is added to the document URI, to identify PDF calls. | true | |
| languageCode | The PDF document language code. | EN, DE,... | EN |
| setDateFormat | The date format string for all dates. | Y-m-d, d.m.Y | Y-m-d |
| marginLeft | The left margin of the document. | number in mm | 10 |
| marginRight | The right margin of the document. | number in mm | 10 |
| marginTop | The top margin of the document. | number in mm | 30 |
| marginBottom | The top margin of the document. | number in mm | 25 |
| marginHeader | The header margin of the document. | number in mm | 5 |
| marginFooter | The footer margin of the document. | number in mm | 10 |
| headerFontType | The header font type for standard headers. | Font | helvetica |
| headerFontSize | The font size for standard headers. | number | 16 |
| headerFontBold | Whether the header font is bold, or not. | Number 0 or 1 | 1 |
| headerLogo | The logo for standard headers, the logo has to be in the folder assets/lib/tcpdf/images/ to be found byTCPDF. | GIF, JPG, PNG | |
| footerPositionFromBottom | The footer position from the bottom. | number in mm | 15 |
| footerFontType | The footer font type for standard footers. | Font | helvetica |
| footerFontItalic | Whether the header font is italic, or not for standard footers. | Number 0 or 1 | 1 |
| footerFontSize | The font size for standard footers. | number | 8 |
| contentFontType | The content font type for standard content. | Font | times |
| contentFontSize | The font size for standard content. | number | 10 |
| longTitleAboveContent | Whether the documents long title should be in the document above the content, or not, only for standard content. | Number 0 or 1 | 1 |
| stripCSSFromContent | Strip in-line CSS, or not, only for standard content. | Number 0 or 1 | 1 |
| rewritePDF | If a PDF document exists, the document is not rewritten every time, when the PDF document is requested. This is a cache function for PDF documents. | Number 0 or 1 | 1 |
| author | Author for PDF document properties. | string | |
| tvKeywords | A template variable for keywords for the PDF document properties. Keywords are comma separated, you may reuse keywords for tag clouds. | Template Variable | |
| chunkHeader | Chunk for customized headers | Chunk | |
| chunkContentFooter | Chunk for customized text placed under the content. For example for a link to the current document on the website inside the PDF document. Only used with standard content. | Chunk | |
| chunkStyle | A chunk for CSS styles in the PDF document. | Chunk | |
| chunkContent | A chunk for individual arrangement of the content in the document. | Chunk | |
| fontMonoSpaced | The Monospaced font. | Font | courier |
| imageScaleRatio | The scale ratio for images. | number | 1.25 |
| footerChunk | The footer chunk name. | Chunk | Page %1s / %2s |
| basePath | The base path for TCPDF and htmlToPDF. | string | MODX_BASE_PATH |
| htmlToPdfPath | The path to the classes of htmlToPDF. | string | assets/snippets/htmlToPDF/| |
| tcpdfPath | The path to TCPDF. | string | assets/lib/tcpdf/ |
| outputPdfPath | The path, where the PDF documents are stored. You need to give read, delete, and create rights to that folder (777). | string | assets/pdf/ |
| headerImageHeight | Sets the height for a logo in the header of the PDF document in mm. | int | 20 |