Projet

Général

Profil

Paste
Télécharger (2,63 ko) Statistiques
| Branche: | Révision:

root / drupal7 / sites / all / modules / views_pdf / README.txt @ ba09eb79

1 85ad3d82 Assos Assos
With the Views PDF module you can output a view as a PDF document. Each field of
2
the view can be placed on the PDF page directly in the administration interface. 
3
Therefore a new display called "PDF" is added.
4
5
There are already some PDF solutions such as Print. But these solutions use the 
6
HTML output and converts this to PDF. The disadvantages of such an integration 
7
are:
8
    * No control over page flow (e.g. page break).
9
    * Little or no control over page header and footer.
10
    * You need HTML skills to change the layout.
11
    * The rendering is slow and need a lot of memory, because it need to render 
12
      the HTML.
13
    * Complex tables make troubles.
14
    * Vector graphics can not be implemented, therefore the printing of the doc-
15
      ument can be problematic.
16
    * You are limited by HTML's capabilities.
17
18
19
20
Installation instructions:
21
--------------------------
22
   1. Download the module or checkout the module.
23
   2. Upload the module to your Drupal instance.
24
   3. Download the required libraries. Download TCPDF and FPDI. Copy the files 
25
      to the lib directory in the module directory. The path must be so: 
26
      "sites/all/libraries/tcpdf/tcpdf.php" respectively "sites/all/libraries/fpdi/fpdi.php".
27
      If you are using the Libraries API then put them into the libraries folder.
28
   4. Check under reports if you setup everything correct.
29
   5. Setup a view with a PDF display.
30
   6. Use it.
31
32
Basic Usage
33
-----------
34
   1. Setup a new view or use an existing view. How to do this see in the 
35
      documentation of the Views module.
36
   2. In the view add the display "PDF Page".
37
   3. Select the new added display.
38
   4. Select the Style. You can use PDF unformatted to place the fields in no 
39
      structured way on the PDF. Use PDF table to place the fields in table with 
40
      a table header.
41
   5. In the settings of the style you can setup per field settings. Such as the
42
      position, the size of the field, the font and so on. Important: Switch to 
43
      the PDF Page display in the default display this options does not appear.
44
   6. Under PDF Page Setting you can setup the size of the page.
45
   7. Under PDF Font Settings you can setup the default fonts for the PDF.
46
   8. Under PDF Template Settings you can setup a background PDF.
47
   9. To add a page break, you can add a PDF page break field. When this field 
48
      is rendered new page is added. Reorder the fields if necessary.
49
  10. You can find also a page number field. You can use it to print the current
50
      page number. Important for positioning the field in the header or footer, 
51
      you need to set the relative position in the field settings to 
52
      "In header / footer".